기획 문서 정합성 검증

개요

FanPulse 기획 문서들(화면 정의서, DB 정의서, 프로젝트 기획서, API 계약서) 간의 정합성을 검증합니다.

검증 워크플로우

1. 문서 로드 → 2. 검증 수행 → 3. 불일치 리포트 생성

검증 항목

1. 화면 ↔ DB 정합성

화면에서 필요한 데이터가 DB에 정의되어 있는지 확인

검증 방법:

1. doc/화면_정의서.md 또는 doc/mvp/mvp_화면_정의서.md에서 화면 ID, 기능 목록 추출
2. doc/데이터베이스_정의서.md 또는 doc/mvp/mvp_데이터베이스_정의서.md에서 테이블별 활용 화면 주석 추출
3. 화면 기능 키워드 → 필요 테이블 매핑 확인

2. 기획서 ↔ 화면 정합성

프로젝트 기획서의 핵심 기능이 화면으로 구현되었는지 확인

검증 방법:

1. doc/프로젝트_기획서.md 또는 doc/mvp/mvp_기획서.md에서 핵심 기능 목록 추출
2. doc/mvp/mvp_PRD.md에서 기능 요구사항 추출
3. doc/mvp/mvp_user_journey.md에서 사용자 여정 추출
4. doc/화면_정의서.md에서 화면별 주요 기능 추출
5. 기능 ↔ 화면 매핑 확인

3. API ↔ 화면/DB 정합성

API가 화면 기능을 지원하고 DB와 일관성 있는지 확인

검증 방법:

1. doc/mvp/mvp_API_명세서.md에서 API 엔드포인트 추출
2. 화면 기능 → 필요 API 매핑 확인

4. DDD ↔ 구현 문서 정합성

DDD 설계와 구현 문서 간 일관성 확인

검증 방법:

1. doc/ddd/bounded-contexts/에서 컨텍스트별 책임 추출
2. doc/ddd/ubiquitous-language.md에서 용어 정의 추출
3. doc/ddd/domain-model.md와 DB 스키마 비교
4. doc/ddd/context-map.md와 API 통합 방식 비교

5. IA ↔ 화면 정합성

정보 구조(IA)와 실제 화면 구조 일치 확인

검증 방법:

1. doc/mvp/mvp_IA.md에서 정보 구조 추출
2. 화면 정의서와 구조 비교

6. 용어 일관성

문서 간 동일 개념에 대한 용어 통일 확인

실행 방법

/validate-docs

또는 특정 검증만 수행:

/validate-docs --check screen-db
/validate-docs --check plan-screen
/validate-docs --check api
/validate-docs --check ddd
/validate-docs --check ia
/validate-docs --check terminology

리포트 형식

# 문서 정합성 검증 리포트

## 요약
- 총 검증 항목: N개
- 통과: N개
- 불일치: N개
- 경고: N개

## 불일치 상세

### [심각도] 카테고리
- 문서1: 내용
- 문서2: 내용
- 권장 조치: ...

주요 매핑 규칙

화면-DB 매핑 규칙은 references/validation_rules.md 참조

문서 위치

전체 프로젝트 문서

MVP 문서

DDD 문서