Stage 5 완료 — 정리·문서·검증

개요

v3 마스터 플랜의 마지막 단계. 6단계 한 달+ 로드맵의 마무리.

작업

1. 사용자 가이드 (USER-GUIDE.md)

모든 사용자가 첫 접속 시 읽도록 단일 가이드 작성.

• "어디서 시작하나" 표 (7개 진입점 매핑)
• 신규 문서 35종 카테고리 분류
• 도면 편집기 단축키 (OmniGraffle 호환)
• 연결선 작성 흐름 + BOM → 견적서 자동 변환
• .cdf v2.0.0 데이터 모델 요약
• API 빠른 참조 (견적서·제안서·도면·문서)
• 5트랙 구조 요약

2. 골든 워크플로우 검증 스크립트 (tests/v3-golden-workflow.sh)

실행 가능한 자동 검증:

• 진입점 라우트 10/10 (200 OK)
• API 라우트 3/3 (200 OK)
• 정적 파일·doc-templates 35종 등록
• 광주은광교회 LED 견적·제안·도면 저장→로드 사이클
• 도면 → 견적서 자동 변환
• 한선씨 RPN 정통 4종 컴파일+실행
• TypeScript .cdf v2 인터페이스 컴파일
• 외부 의존성 0 (CDN/jsdelivr/웹폰트)

최종 결과: 통과 29 · 경고 0 · 실패 0

3. INVENTORY.md 최종 갱신

• v3 진행 표 전 단계 완료 표시
• Stage 0/1/2/3/4/5 결과 누적 기록
• 진입점 표에 /신규 우선 추가

4. 영속화 4총사 점검

• ~/.claude/projects/-Users-ef/memory/project_crowny_doc.md (자동 로드)
• CrownyDoc/INVENTORY.md (마스터 카탈로그)
• CrownyDoc/CLAUDE.md (🛑 가드)
• CrownyDoc/USER-GUIDE.md (사용자용)
• CrownyDoc/projects/2026-05-27-crownydoc-v3-마스터플랜.md (로드맵)

v3 통합 결과

영역	Before	After
진입점	7개 분기, 어디로 갈지 모름	/신규 단일 통합 갤러리 + 6개 직접 진입
비즈니스 템플릿	트랙 1: 14개, 트랙 2: 5개 (비대칭)	트랙 1 갤러리에 35개 통합 (business-app 4 신규)
데이터 모델	5트랙 분리, 호환 X	.cdf v2.0.0 공통 모델 (셀 14·시냅스 6·bizMeta)
블록다이어그램	0% (OmniGraffle 미대체)	/도면 편집기 1911줄 (연결선·정렬·스마트가이드)
트랙 간 변환	불가	Stage 3 어댑터 (트랙1↔트랙2) + Stage 4 (트랙4→CDF v2)
매번 처음부터	자동메모리·인벤토리 없음	영속화 4총사 (메모리·INVENTORY·CLAUDE 가드·USER-GUIDE)

누적 산출물 (이번 v3 1차 작업)

Stage	신규 파일	수정 파일
0	cdf-v2-spec.md, cdf-v2.rpn.한선	cell.ts/한선, synapse.ts/한선, cdfFormat.ts, phase.ts, smartTemplate.ts, FocusLens.tsx, PasteDialog.tsx, documentOrchestra.ts
1a	(4 비즈앱 템플릿)	doc-templates.js
1b	신규문서.html	server-docs.js, 홈.html
2	(도형라이브러리.js 진행중)	도면편집기.html (1195→1911)
3	cdf-adapter.js, v2adapter.ts, 한선씨 동반 2종	(server 패치 사양만)
4	legacy-merge.js/한선, 견적→cdf·제안→cdf·도면→cdf 3종 RPN	—
5	USER-GUIDE.md, tests/v3-golden-workflow.sh, 작업문서 6종	INVENTORY.md (Stage 5 갱신)

검증 골든 워크플로우 결과

═══════════════════════════════════════════
  CrownyDoc v3 골든 워크플로우 검증
═══════════════════════════════════════════
1. 진입점 라우트 10/10 ✓
2. API 라우트 3/3 ✓
3. 정적 파일·신규 갤러리 ✓
4. 견적서 저장→로드 ✓
5. 제안서 저장 ✓
6. 도면 저장 + 도면→견적 변환 ✓
7. 한선씨 RPN 정통 4/4 ✓
8. TypeScript v2 컴파일 ✓
9. 외부 의존성 0건 4/4 ✓

결과: 통과 29 · 경고 0 · 실패 0

잔여 (v3 이후 후속)

• 도면 도형 라이브러리 80+개 확장 (Stage 2 에이전트 진행 중 — 별도 보고)
• 견적서 폴더의 사양서/제안서 변종 HTML 10개 정리 (트랙 4 내부 중복)
• 한선씨 정적 Office 63 JS 중 1 미동반 (1개만 보완하면 100%)
• 443/80 인스턴스 코드 동기화 (운영 이슈)
• v4 후보: Tauri 데스크탑 + 오프라인 동기화

정성적 평가

이번 v3 1차 작업으로:

• "또 못 찾는" 반복 차단 — 자동메모리 + INVENTORY + CLAUDE 가드
• 단일 진입점 — /신규 갤러리에서 35종 모두 보임
• 블록다이어그램(OmniGraffle) 대체 — 1단계 완료 (1911줄)
• 공통 데이터 모델 — .cdf v2 (트랙 1·2·3·4 호환)
• 양방향 변환 — 트랙 4 미니앱 ↔ 셀-시냅스 (Stage 3·4)
• 자동 검증 — tests/v3-golden-workflow.sh 29/29

다음 사용자 작업 지시 대기.