19
문서 규격 · 설계 연구
Structured Document
에디터가 달라도 같은 문서를 읽고 검증할 수 있도록 문서 구조를 정의하는 설계 작업입니다.
INC-004 설계 완료 / 코어 구현 전
- 기간
- 2026 — 현재
- 역할
- 문서 계약 설계
PROJECT / DECISION RECORD
문제에서 구현까지
- 01문제
문서 의미가 특정 편집기의 내부 형식에 묶이면 저장·렌더링·백엔드 소비 방식이 제한됩니다.
- 02설계 선택
Document V1 JSON Schema와 유효·무효 fixture, 언어 간 적합성 설계를 기준으로 합니다.
- 03구현·진행
문서 계약·JSON Schema·conformance 설계만 포함하며 편집기/렌더러는 아직 없습니다.
문제
19문서 의미가 특정 편집기의 내부 형식에 묶이면 저장·렌더링·백엔드 소비 방식이 제한됩니다.
제약
- Lexical과 React는 선택적 어댑터이며 문서의 표준 의미를 소유하지 않습니다.
- 문서의 의미를 Lexical이나 React 컴포넌트 내부 상태에 종속시키지 않습니다.
- 스키마 검증과 실제 편집·렌더링 기능을 완료 상태로 혼동하지 않습니다.
설계와 결정
- Document V1 JSON Schema와 유효·무효 fixture, 언어 간 적합성 설계를 기준으로 합니다.
- Document V1을 독립 JSON Schema와 유효·무효 fixture로 정의했습니다.
- 편집기와 프런트엔드는 문서 계약의 선택적 어댑터로 두었습니다.
구현
- 문서 계약·JSON Schema·conformance 설계만 포함하며 편집기/렌더러는 아직 없습니다.
- 문서 ID와 데이터 규격, 언어 간 적합성 검토 순서를 문서화했습니다.
- INC-004 아키텍처 단계의 결과물만 있으며 실행 코어·에디터·렌더러는 구현됐다고 주장하지 않습니다.
검증과 근거
소스 근거직접 확인
README의 INC-004 상태, document-v1 JSON Schema, 유효·무효 fixture를 확인했습니다.
결과와 현재 상태
Document V1 스키마와 적합성 검증 방식을 설계했습니다. 실행 코어·에디터·렌더러는 구현 전입니다.
현재 상태INC-004 설계 완료 / 코어 구현 전