마스터 기획서가 "무엇을·왜"라면, 이 문서는 "어떻게·정확히"입니다.
화면 명세 · 상태 플로우 · DB · API · 원챗 연동 시퀀스까지 — 풀스택 설계.
마스터 기획서와 개발 설계서는 역할이 다릅니다 — 둘 다 필요합니다
| 구분 | 마스터 기획서 (/master) | 개발 설계서 (/dev · 이 문서) |
|---|---|---|
| 답하는 질문 | 왜 · 무엇을 · 누구를 위해 | 어떻게 · 정확히 무엇을 |
| 독자 | 경영·투자·지자체·합의 당사자 | 개발자·디자이너·QA |
| 내용 | 비전·12시스템·전략·수익 | 화면명세·DB·API·시퀀스·예외처리 |
| 비유 | "어떤 집에 살고 싶다" | "건축 도면 + 배관·전기 시방서" |
p24 원챗 · p25 DB · p26 API)의 검증된 자산
(MariaDB 18테이블, /api/v1/*, 원챗 SSO 아키텍처)을 버리지 않고 재활용·정밀화합니다.
처음부터 다시 그리지 않습니다.
각 기능설계는 아래 7단계를 빠짐없이 거칩니다. 이것이 "기획서"와 "설계도"의 차이입니다.
| 계층 | 산출물 | 개발자가 얻는 것 |
|---|---|---|
| ① UI | 화면 명세 (Screen Spec) | 레이아웃·요소·입력·상태별 표시 |
| ② Flow | 상태/플로우 다이어그램 | 화면·상태 전이 조건과 예외 경로 |
| ③ Data | DB 스키마 (DDL) | 테이블·컬럼·관계·인덱스 |
| ④ API | 엔드포인트 명세 | 요청/응답 JSON·인증·에러코드 |
| ⑤ Seq | 연동 시퀀스 (원챗·DeepSeek) | 서버 간 호출 순서·실패 처리 |
| ⑥ Comp | 컴포넌트/모듈 구조 | 프론트·백엔드 파일 단위 |
| ⑦ Test | 검수 체크리스트 | 정상/예외 시나리오 = 개발 완료 판정 기준 |
공통 기반 1장 + 풀스택 기능설계 12종 (12대 시스템)
시스템 구성도, 기술 스택, 폴더 구조, 공통 API/인증/에러 규약. 모든 기능설계의 전제.
실벗·원챗·DeepSeek 3자 연동의 핵심. STT→LLM→TTS→아바타 풀스택 설계.
생명 직결 + 3주체 알림. 감지→확인→에스컬레이션 상태머신 풀스택 설계.
모든 시스템의 관문. 카드형 홈·위젯·알림 집약 화면 풀스택 설계.
복약 알림·기록·건강표. 알림→복약확인→미복약 에스컬레이션 설계.
가족 초대·권한·공유범위. 함께보기·안부 피드 풀스택 설계.
감정기록·자서전 집필. 말벗 대화→기억 보관 풀스택 설계.
두뇌게임·콘텐츠·모임. 재미와 사회관계 풀스택 설계.
일자리 매칭·지원·교육. 구인→지원→매칭 풀스택 설계.
돌봄·복지 연계·행정 연동. B2G 대시보드·리포팅 풀스택 설계.
보이스피싱·사기방지·신고. 경고→차단→신고 풀스택 설계.
키오스크·대행서비스·링크풀이. 어려운 디지털 대행 풀스택 설계.
다국어·현지화·국가확장. i18n·지역설정 풀스택 설계.