개발팀용개발기획문서
개발 착수에 필요한 문서 6종입니다. 사이트에서 바로 읽거나 마크다운으로 내려받을 수 있습니다 — 저장소 접근이 없어도 받아 가실 수 있습니다. 여섯 종 모두 초안이 나와 있고, 열려 있는 결정은 각 문서 끝에 목록으로 모아 두었습니다.
문서 6종
01기능정의서초안
무엇을 만드나 — 범위와 제외, 대상 데이터, 업무 규칙, 동기화 규칙과 안전장치
02인터페이스 정의서초안
어떻게 주고받나 — 엔드포인트, 요청·응답, 오류 코드, 재시도 규약
03데이터 매핑 사양초안
5240 필드가 캘린더 이벤트의 무엇이 되나 — 제목 규칙, 마스킹 치환, 이벤트 식별 표식
04비기능정의서초안
성능·보안·안전성·운영·확장성 — 이 연동은 여기가 승부처다
05테스트 시나리오초안
무엇을 확인해야 끝났다고 하나 — 위험 기반으로 쓴다
06테스트 자동화 전략초안
무엇을 어느 계층에서 자동화하나 — 대조 로직은 순수 함수로 떼어 단위 테스트로 덮는다
함께 내려받을 것
이 둘은 사람이 따로 쓴 문서가 아니라 화면 내용을 그대로 뽑은 것입니다. 같은 내용을 두 곳에 적어 두면 반드시 어긋나므로, 화면을 고치면 내려받는 문서가 따라오게 했습니다.
개발팀 인계작성됨화면에서 생성
무엇을 가져가고 무엇을 보기만 하나 — 넘기는 것의 성격, 만들 것, 먼저 할 세 가지
킥오프 — 결정과 이유작성됨화면에서 생성
무엇을 왜 그렇게 정했나 — 규칙을 바꾸려면 여기 적힌 이유부터 반박해야 한다