← 전체 프로젝트
19

문서 규격 · 설계 연구

Structured Document

에디터가 달라도 같은 문서를 읽고 검증할 수 있도록 문서 구조를 정의하는 설계 작업입니다.

INC-004 설계 완료 / 코어 구현 전
기간
2026 — 현재
역할
문서 계약 설계

PROJECT / DECISION RECORD

문제에서 구현까지

  1. 01문제

    문서 의미가 특정 편집기의 내부 형식에 묶이면 저장·렌더링·백엔드 소비 방식이 제한됩니다.

  2. 02설계 선택

    Document V1 JSON Schema와 유효·무효 fixture, 언어 간 적합성 설계를 기준으로 합니다.

  3. 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 설계 완료 / 코어 구현 전