랜덤 굿즈를 뽑은 직후 원하지 않는 아이템을 바로 올리고, 원하는 아이템을 가진 사람과 직접 만나 교환하는 현장 교환 앱
JECT 5기 1팀의 기획 문서 저장소입니다. 2026-10-31부터 이 저장소가 원본입니다. 개발자가 AI에 바로 연결해 읽을 수 있게 md로 둡니다.
- 팀: PM · PD · FE · BE
- MVP 배포: 1차 11월 말 스토어 배포 · 2차 12/18 MVP 완성 (JECT 배포 마감 12/18)
- 디자인 · 화면: 피그마 (와이어프레임_PM · 프로토타입_PM · 주요 플로우_PD · 플로우차트 · IA). 링크는 팀 노션에 있습니다.
공개 저장소입니다. 연락처, 사용자 조사 응답자 정보, 팀원 실명은 올리지 않습니다. 사람은 파트명(PM · PD · FE · BE)으로만 적습니다.
- MVP v0.9: 1차(11/27 스토어 심사)와 2차(12/18)에 무엇을 만드는지, 우선순위 P0 · P1 · P2
- 피그마 와이어프레임 "진행 방식" 페이지: 개발 순서 · 디자인 변경 원칙 · 질문 창구
- 피그마 "1차 · 11/27 스토어 심사" 페이지: 1차에 만들 화면
- 기능 명세서: 맡은 영역 파일(A~H)을 열어 기능 ID별로 진입 → 동작 → 조건 → 예외 → 결과를 본다. 표의 "배포 · 우선순위"와 "1차에서 빠지는 부분"을 먼저 확인
- 여러 기능에 걸친 규칙 · 숫자는 정책서
- 화면의 기능 ID(정리 카드 맨 위)를 이 저장소 검색창에 넣으면 관련 문서가 모두 나온다
- 문서는 PM만 고친다. 수정 요청은 디스코드(큰 변경) · 피그마 주석(화면 코멘트)으로
- 바뀐 내용은 CHANGELOG 맨 위에 쌓인다
- AI 도구에 연결할 때는 이 저장소를 내려받아(clone) 폴더째 읽히면 된다
| 문서 | 답하는 질문 | 주로 보는 사람 | 위치 |
|---|---|---|---|
| MVP | 이번 버전에 무엇을 넣고 뺄지, 왜 | 전원 | docs/01_mvp/mvp-v0.9.md |
| 요구사항 정의서 | 무엇을 만들지 (REQ-ID · 우선순위 · MVP 여부) | 전원 | docs/02_requirements/requirements.md |
| 기능 명세서 | 화면에서 어떻게 동작하는지 (진입 → 동작 → 조건 → 예외 → 결과) | FE · PD | docs/03_functional-spec/ (영역별 파일, H = 관리자 페이지) |
| 정책서 | 여러 기능에 걸치는 규칙 · 기준값 | BE · 운영 | docs/04_policy/policy.md |
| 이용약관 | 사용자와의 법적 약속 | 사용자 | docs/05_terms/terms.md (초안 · 개인정보 처리방침은 작성 전) |
| 변경 요약 | 버전마다 무엇이 바뀌었는지 | 전원 | CHANGELOG.md |
2026-10-31부터 원본은 이 저장소입니다 (기능 명세 v0.5.2부터). 노션의 기획 문서는 v0.5.1까지이며 더 고치지 않습니다. 두 곳이 다르면 이 저장소가 맞습니다.
문서끼리는 ID로 잇습니다. 검색창에 ID를 넣으면 관련 문서가 모두 나옵니다.
요구사항 REQ-E-04 → 기능 E-04-1 → 정책 P-07-04
(영역-번호) (요구사항-세부) (정책 장-번호)
- 요구사항은 "기능 명세 ID"로 기능을, 기능은 "정책 ID"로 정책을 가리킵니다. 요구사항에서 정책으로 바로 잇지 않습니다(번호가 바뀌면 고칠 곳이 늘어남).
- 화면 번호(예:
2-02j,3-01)는 피그마 와이어프레임의 화면 이름과 같습니다.
| 표시 | 뜻 |
|---|---|
| 확정 | 정해졌고 개발해도 됨 |
| [논의] | 팀에서 정해야 함 |
| [개발 확인] | 개발에서 가능 여부 · 방식 답을 받아야 함 |
| [제안] | 근거가 부족한 초안. 확인되면 표시를 지움 |
배포 표시: P0 기능에는 1차(11월 말 스토어 배포) / 2차(12/18 MVP 완성)를 붙입니다. 삭제한 요구사항 · 기능은 번호를 다시 매기지 않고 MVP "삭제"로 남깁니다.
회의나 결정이 나오면 이 저장소에서 위 문서부터 한 번씩만 고칩니다.
MVP → 요구사항 → 기능 명세 → 정책 → 이용약관 → 와이어프레임 · 플로우차트 · IA → 팀 공지
- MVP는 버전마다 새 파일(
mvp-v0.8.md)로 만들고, 나머지 문서는 같은 파일을 고칩니다. - 고친 뒤 이어진 ID끼리 상태 · MVP 포함 여부가 맞는지 확인합니다.
- 바뀐 것만 남깁니다. "현재안 유지"로 끝난 안건은 적지 않습니다.
- 근거는 사람 이름 없이 "날짜 · 파트 · 한 줄 이유"로 적습니다. 예:
10/16 정기회의 · FE: 반경 고정보다 줌이 자연스러움 - 줄 단위 변경은 커밋 기록(History)에 남고, 팀이 읽을 요약은 CHANGELOG.md에 모읍니다.
docs(문서): 무엇을 바꿨는지 (근거)
예시
docs(mvp): v0.6 약속 요청 자동 거절 추가 (10/18 PM)docs(기능): E-02-1 지도에서 보기 → 앱 안 지도 (10/18 PM)docs(정책): P-07-04 자동 거절 알림 추가
- 문서 내용에 대한 질문은 해당 줄에 GitHub Issue를 열거나 팀 노션 안건 페이지에 댓글로 남겨 주시기 바랍니다.
- 개발 확인 · PD 확인 안건은 팀 노션 안건 페이지에서 항목별 댓글로 받습니다.