CrownyDoc 오피스 정본 수렴 선언 (v1.0)
문서 날짜: 2026-07-13 상태: 구축 중 (최종 검증 대기) 승인 범위: 정본 선언(웹=트랙①, 엔진=crowny-word)과 React SPA·오피스네이티브 동결은 2026-07-13 오피스 탑재계획 승인에 포함. 비즈니스 미니앱·Tauri 방침은 이 작업의 제안(사장님 승인 대기) — 승인 전 강제 규칙 아님. 목적: 오피스 자산 트랙을 정본·참조·동결로 명확히 정의하고, 향후 개발 규칙을 세운다.
문제 진단 (2026-06-22 이전)
CrownyDoc 오피스는 3개 사일로로 분산되어 있었다:
| # | 트랙 | 위치 | 상태 | 문제 |
|---|---|---|---|---|
| 1 | 웹 스위트 (정적) | 한선씨/정적/ | 67 JS 모듈 | 레거시·유지보수 부담 커지는 중 |
| 2 | React SPA | src/ | TypeScript 19파일+ | 셀-시냅스 모델·AI 추천 동봉, 다른 문맥 |
| 3 | 한선씨 동반 | 한선씨/{시트/슬라이드/편집기/협업} | 각 15-20 .한선 파일 | 정본 불명확·동기화 누락 |
정본 수렴 선언
정본 1: 웹 스위트 (트랙 ① 정본화)
위치: /Users/ef/CrownyDoc/한선씨/정적/
진입점: docs.crowny.org/office
역할: 경량 브라우저 기반 워드/시트/슬라이드, 비즈니스 템플릿 14+개.
포맷: HTML(단순 구조) + vanilla JavaScript
이 트랙이 정본인 이유:
- 사용자가 매일 접근하는 라이브 경로
- 67개 모듈이 이미 완성되어 있음 (autosave·단축키·가져오기·내보내기·최근문서)
- 새 사용자 기능은 여기에만 추가
- 신규 유지보수 commit은 이곳을 기준으로
- 웹 스위트에 기능 추가 (
.js작성) - 동일 로직의
.한선동반 파일 작성 (크라우니코드 헌법) - TypeScript 변환 필요하면 별도 협업 (트랙 2 유지보수자 담당)
정본 2: 한선씨 엔진 (신규 정본 = crowny-word)
위치: /Users/ef/crowny-word/
역할: 순수 한선씨로 구현한 도메인별 엔진 모음.
규모: 65 도메인 + 1639 함수 (2026-07-12 실측)
포맷: 한선씨 RPN 정통 (.rpn.한선 파일) + 고수준 동반 (.한선)
이 정본이 추가된 이유:
- 웹 스위트의
.한선동반이 이미 존재 (시트 15개·슬라이드 14개·편집기 18개 등) - 하지만 위치가 산발적 (
한선씨/정적/,한선씨/시트/,한선씨/편집기/등) - crowny-word는 한선씨 로직의 중앙 저장소로 기능
- 신규 한선씨 알고리즘 개발은 여기서 시작 → 웹 스위트로 포팅
crowny-word/도구/에서 신규.한선파일 개발- 컴파일+검증 (hanseonc_high + CROWNY_STRICT=1)
- 학습DB 등록 (crownycode-learn.sh)
- 필요시 웹 스위트 JS로 포팅 (또는 WASM)
참조 1: React SPA 플랫폼 (트랙 ②, 동결)
위치: /Users/ef/CrownyDoc/src/
진입점: docs.crowny.org/app (레거시, 비노출)
역할: 셀-시냅스 문서 모델 (고급 기능 시스템용)
상태: 동결 (maintenance 모드)
왜 동결인가:
- 웹 스위트(트랙 ①)가 사용자 일상 기능 커버함
- React SPA는 개념 실험용 플랫폼으로 남김
- CDF v2.0.0 모델 유지, 신규 셀 타입 추가는 검토 후
- 이미 완성된 AI 추천 패널(DocumentDNA, SmartTemplate) 보존
- 셀-시냅스 모델이 웹 스위트에 병합될 때
- 또는 CrownyAI 통합 단계 (별도 로드맵)
참조 2: 비즈니스 미니앱 (트랙 ④, 동결)
위치: /Users/ef/CrownyDoc/{견적서,제안서,도면}/
진입점: docs.crowny.org/{견적서,제안서,도면}
역할: A4 인쇄용 양식 엔진 (견적·제안·도면)
상태: 동결 (운영 모드)
왜 동결인가:
- 사용자가 매주 사용하는 생산 시스템
- 안정성 > 신기능 추가
- 긴급 버그픽스만 수용
- 웹 스위트(트랙 ①)로 수렴 (통합 편집기)
- 미니앱은 "내보내기" 대상으로만 역할
참조 3: 오피스네이티브 CoreText 프로토타입 (동결)
위치: /Users/ef/CrownyDoc/한선씨/오피스네이티브/ (40파일, 2026-06-22~24)
역할: CoreText+두벌식 IME 네이티브 셸 데모(워드/시트/플랜/마인드맵 7앱) — 미배포
상태: 동결 (참조용) — 마인드맵 웹 탭(2026-07-13)의 로직 이식원으로 활용됨. 네이티브 편집 경험은 crowny-word 워드벡터앱 트랙(Phase 3, 사장님 결정 대기)이 승계.
미할당: Tauri 데스크탑 (트랙 ⑤)
위치: /Users/ef/CrownyDoc/src-tauri/
상태: 미배포
방침: 정본 선정 시점에 재평가 (현재 미포함)
유지보수 규칙 (강제)
✅ 신규 기능은 웹 스위트(트랙 ①)에만 추가
bash# 신규 기능 체크리스트
□ 기능 로직을 웹 스위트 JS로 작성 (한선씨/정적/*.js)
□ 동일 로직의 .한선 동반 파일 작성 (크라우니코드 헌법)
□ crowny-word에서도 해당 엔진 구현 검토 (또는 참조)
□ INVENTORY.md 갱신 (신규 라우트·기능 기재)
□ 테스트: 웹 스위트 라이브에서 검증 후 commit
✅ 중복 구현 금지
작업 시작 전:
bash# 1단계: 기존 기능 확인
grep -r "키워드" /Users/ef/CrownyDoc/한선씨/정적/
grep -r "키워드" /Users/ef/crowny-word/
grep -r "키워드" /Users/ef/CrownyDoc/INVENTORY.md
# 2단계: 크라우니코드 패턴 확인
~/.claude/scripts/crownycode-learn.sh search "키워드"
# 3단계: 확정 후 진행
✅ 한선씨 우선
규칙:
- 모든 신규 로직은 한선씨로 먼저 작성
- JavaScript는 포팅 계층 (한선씨 로직 래핑)
- 의존성: JS → 한선씨 (역방향 금지)
- 기능명세 → 한선씨 RPN 작성 (
crowny-word/도구/기능명.rpn.한선) - 컴파일 검증
- JS 래퍼 작성 (
한선씨/정적/기능명.js) - 웹 스위트 통합 (index.html 스크립트 로드)
✅ 트랙 ②·④ 변경 금지
INVENTORY.md 연동 규칙
이 파일 수렴 선언 이후의 INVENTORY.md는 정본 선언을 기준으로 운영:
| 항목 | 정책 |
|---|---|
| 신규 라우트 | 웹 스위트(트랙 ①)에만 추가 |
| 신규 템플릿 | 한선씨/정적/doc-templates.js 정본화 (React는 동기화만) |
| 신규 라이브러리 | crowny-word/도구/ 우선 (또는 CrownyOS/crownyc/libs/) |
| 신규 셀 타입 | React 동결 상태이므로 변경 불가 (요청시 웹 스위트 대체 설계) |
| 3트랙 동기화 | 웹 스위트 ← 크라우니코드 학습 ← crowny-word (단방향) |
오늘(2026-07-13) 추가 항목 (구축 중)
이 Workflow가 추가/진행 중인 기능들. 아직 완료 전.
1. DOCX/XLSX 쓰기 지원
상태: 구축 중 대상: 웹 스위트(트랙 ①) 계획:
- 시트 → .xlsx 직접 내보내기
- 워드 → .docx 직접 내보내기
- 한선씨 엔진 지원 (crowny-word)
2. 마인드맵·플랜 탭
상태: 구축 중 대상: 웹 스위트(트랙 ①) 계획:
- 새 문서 타입: 마인드맵 (계층형 노드)
- 새 문서 타입: 플랜 (간트 차트 기반)
- doc-templates.js에 새 템플릿 카테고리 추가
3. 학습층 (Learning Ribbon)
상태: 구축 중 대상: 웹 스위트(트랙 ①) 계획:
- 사용자가 배운 기능 히스토리 추적
- 기능 팁·튜토리얼 동적 표시
- 크라우니코드 학습DB와 연동
4. CrownyAI 3카드 탑재
상태: 구축 중 대상: 웹 스위트(트랙 ①) 계획:
- CrownyAI 브라우저에 office 제목 카드 탑재
- 크라우니AI에서 웹 스위트 직접 링크
- UI 통합 및 인증 연동
예상 완료
위 4개 항목 모두 이 Workflow 후 별도 세션에서 최종 검증 필요. 각 항목별 컴파일 통과·라이브 E2E 검증 전까지 완료 단정 금지.
마이그레이션 가이드 (세션용)
기존 작업을 웹 스위트(트랙 ①)로 수렴할 때
- React SPA(트랙 ②) 기능을 웹 스위트로 옮기려면:
- 비즈니스 미니앱(트랙 ④)을 웹 스위트로 옮기려면:
- 한선씨 엔진(crowny-word)을 웹 스위트와 통합하려면:
예상 Q&A
Q. 왜 웹 스위트가 정본이면 한선씨 엔진도 정본이 아닌가? A. 웹 스위트는 사용자 경험·인터페이스 정본, 한선씨 엔진은 로직·알고리즘 정본. 둘 다 필요하지만 계층이 다름. 웹 스위트가 사용자 진입점이므로 우선.
Q. React SPA를 다시 활성화하려면? A. 이 선언 이후 별도 보고 필요. 트랙 ①과의 기능 중복 제거·데이터 모델 통일·UI 재설계 후 재검토.
Q. 비즈니스 미니앱은 정말 안 건드리나? A. 버그픽스·보안 패치만 수용. 신기능은 웹 스위트 통합 문맥에서 재설계 후 제안.
Q. 크라우니코드 학습DB에 뭘 등록하나?
A. 웹 스위트 신규 기능의 .한선 동반 파일 모두. 예: 시트_열검색, 워드_자동고침, 슬라이드_전환효과 등.
관련 문서
| 문서 | 위치 | 용도 |
|---|---|---|
| INVENTORY.md | /Users/ef/CrownyDoc/INVENTORY.md | 매 작업 후 갱신 (트랙·라우트·기능 목록) |
| USER-GUIDE.md | 웹 스위트 내 /help | 사용자 가이드 |
| CLAUDE.md | /Users/ef/CrownyDoc/CLAUDE.md | 세션용 가이드 (이미 존재) |
| 설계서 | /Users/ef/crowny-word/설계서.md | 한선씨 엔진 아키텍처 |
버전 이력
| 버전 | 날짜 | 주요 내용 |
|---|---|---|
| v1.0 | 2026-07-13 | 첫 선언: 정본 ②개(웹 스위트+한선씨 엔진), 참조 ②개(React+미니앱), 미할당 ①개(Tauri) |
이 선언은 모든 세션이 따라야 하는 강제 규칙이다. 의문 사항은 사장님(kps)에 보고 후 변경.