agentic-domain-document 0.6.0

package/src/database/migrations/0001_document_base.sql

@@ -0,0 +1,753 @@
+PRAGMA foreign_keys = ON;
+
+-- 코드 그룹을 정의한다.
+CREATE TABLE IF NOT EXISTS document_code_groups (
+  -- 코드 그룹 식별자
+  code_group_code VARCHAR(64) PRIMARY KEY,
+
+  -- 코드 그룹 한글명
+  code_group_name VARCHAR(128) NOT NULL,
+
+  -- 코드 그룹 설명
+  description TEXT,
+
+  -- 표시 정렬 순서
+  sort_order INTEGER NOT NULL DEFAULT 0,
+
+  -- 활성 여부. 1은 활성, 0은 비활성
+  is_active INTEGER NOT NULL DEFAULT 1
+    CHECK (is_active IN (0, 1)),
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 코드 그룹별 코드 값을 정의한다.
+CREATE TABLE IF NOT EXISTS document_codes (
+  -- 코드 그룹 식별자
+  code_group_code VARCHAR(64) NOT NULL,
+
+  -- 코드 값. lower_snake_case를 사용한다.
+  code VARCHAR(128) NOT NULL,
+
+  -- 코드 한글명
+  code_name VARCHAR(128) NOT NULL,
+
+  -- 코드 설명
+  description TEXT,
+
+  -- 표시 정렬 순서
+  sort_order INTEGER NOT NULL DEFAULT 0,
+
+  -- 활성 여부. 1은 활성, 0은 비활성
+  is_active INTEGER NOT NULL DEFAULT 1
+    CHECK (is_active IN (0, 1)),
+
+  -- 확장 메타데이터
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  PRIMARY KEY (code_group_code, code),
+
+  FOREIGN KEY (code_group_code)
+    REFERENCES document_code_groups (code_group_code)
+    ON DELETE CASCADE
+);
+
+-- 문서 유형별 node level 해석 정책을 정의한다.
+CREATE TABLE IF NOT EXISTS document_node_taxonomies (
+  -- taxonomy 식별자
+  taxonomy_id CHAR(36) PRIMARY KEY
+    CHECK (length(taxonomy_id) = 36),
+
+  -- taxonomy 코드
+  taxonomy_code VARCHAR(128) NOT NULL UNIQUE,
+
+  -- taxonomy 이름
+  taxonomy_name VARCHAR(128) NOT NULL,
+
+  -- 문서 유형 코드
+  document_type_code VARCHAR(128) NOT NULL,
+
+  -- 기본 TOC 포함 level
+  default_toc_level_limit INTEGER NOT NULL DEFAULT 3
+    CHECK (default_toc_level_limit >= 1),
+
+  -- 설명
+  description TEXT,
+
+  -- 활성 여부
+  is_active INTEGER NOT NULL DEFAULT 1
+    CHECK (is_active IN (0, 1)),
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+-- taxonomy별 node level 라벨, 번호 정책, counter scope를 정의한다.
+CREATE TABLE IF NOT EXISTS document_node_taxonomy_levels (
+  -- taxonomy level 식별자
+  taxonomy_level_id CHAR(36) PRIMARY KEY
+    CHECK (length(taxonomy_level_id) = 36),
+
+  -- taxonomy 식별자
+  taxonomy_id CHAR(36) NOT NULL
+    CHECK (length(taxonomy_id) = 36),
+
+  -- node level
+  node_level INTEGER NOT NULL
+    CHECK (node_level >= 1),
+
+  -- node label 코드
+  node_label_code VARCHAR(128) NOT NULL,
+
+  -- 번호 정책 코드
+  numbering_policy_code VARCHAR(64) NOT NULL,
+
+  -- 번호 카운터 범위 코드
+  counter_scope_code VARCHAR(64) NOT NULL,
+
+  -- 표시 정렬 순서
+  sort_order INTEGER NOT NULL DEFAULT 0,
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (taxonomy_id)
+    REFERENCES document_node_taxonomies (taxonomy_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (taxonomy_id, node_level)
+);
+
+-- 문서 단위 메타데이터, 작성자, taxonomy, 상태를 관리한다.
+CREATE TABLE IF NOT EXISTS document_documents (
+  -- 문서 식별자
+  document_id CHAR(36) PRIMARY KEY
+    CHECK (length(document_id) = 36),
+
+  -- 문서 유형 코드
+  document_type_code VARCHAR(128) NOT NULL,
+
+  -- 적용 taxonomy 식별자
+  taxonomy_id CHAR(36) NOT NULL
+    CHECK (length(taxonomy_id) = 36),
+
+  -- 문서 제목
+  title VARCHAR(512) NOT NULL,
+
+  -- 파생 원본 문서 식별자
+  source_document_id CHAR(36)
+    CHECK (source_document_id IS NULL OR length(source_document_id) = 36),
+
+  -- 표시 버전
+  version_label VARCHAR(64),
+
+  -- 작성자 유형
+  author_type_code VARCHAR(32) NOT NULL DEFAULT 'user'
+    CHECK (author_type_code IN ('user', 'agent', 'system')),
+
+  -- 작성자 식별자
+  author_id VARCHAR(128),
+
+  -- 작성자 표시명
+  author_name VARCHAR(128),
+
+  -- 문서 상태
+  status_code VARCHAR(32) NOT NULL DEFAULT 'draft'
+    CHECK (status_code IN ('draft', 'in_review', 'approved', 'published', 'archived')),
+
+  -- TOC로 취급할 level limit
+  toc_level_limit INTEGER NOT NULL DEFAULT 3
+    CHECK (toc_level_limit >= 1),
+
+  -- published 상태 전환 시각
+  published_at DATETIME,
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 확장 메타데이터
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+
+  FOREIGN KEY (taxonomy_id)
+    REFERENCES document_node_taxonomies (taxonomy_id),
+
+  FOREIGN KEY (source_document_id)
+    REFERENCES document_documents (document_id)
+    ON DELETE SET NULL
+);
+
+-- 문서의 계층 node tree를 관리한다.
+CREATE TABLE IF NOT EXISTS document_nodes (
+  -- 노드 식별자
+  node_id CHAR(36) PRIMARY KEY
+    CHECK (length(node_id) = 36),
+
+  -- 소속 문서 식별자
+  document_id CHAR(36) NOT NULL
+    CHECK (length(document_id) = 36),
+
+  -- 상위 노드 식별자
+  parent_node_id CHAR(36)
+    CHECK (parent_node_id IS NULL OR length(parent_node_id) = 36),
+
+  -- node level
+  node_level INTEGER NOT NULL
+    CHECK (node_level >= 1),
+
+  -- 노드 역할 코드
+  node_role_code VARCHAR(64) NOT NULL DEFAULT 'body',
+
+  -- 노드 제목
+  title VARCHAR(512) NOT NULL,
+
+  -- TOC 표시 정책
+  toc_visibility VARCHAR(16) NOT NULL DEFAULT 'inherit'
+    CHECK (toc_visibility IN ('inherit', 'include', 'exclude')),
+
+  -- 번호 정책 코드
+  numbering_policy_code VARCHAR(64) NOT NULL DEFAULT 'inherit',
+
+  -- 수동 번호 override
+  numbering_override VARCHAR(64),
+
+  -- 형제 노드 내 정렬 순서
+  sort_order INTEGER NOT NULL DEFAULT 0,
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 확장 메타데이터
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+
+  FOREIGN KEY (document_id)
+    REFERENCES document_documents (document_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (parent_node_id)
+    REFERENCES document_nodes (node_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (document_id, parent_node_id, sort_order)
+);
+
+-- 특정 document node에 붙는 block collection을 관리한다.
+CREATE TABLE IF NOT EXISTS document_contents (
+  -- content 식별자
+  content_id CHAR(36) PRIMARY KEY
+    CHECK (length(content_id) = 36),
+
+  -- 소속 문서 식별자
+  document_id CHAR(36) NOT NULL
+    CHECK (length(document_id) = 36),
+
+  -- 소속 노드 식별자
+  node_id CHAR(36) NOT NULL
+    CHECK (length(node_id) = 36),
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 확장 메타데이터
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+
+  FOREIGN KEY (document_id)
+    REFERENCES document_documents (document_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (node_id)
+    REFERENCES document_nodes (node_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (node_id)
+);
+
+-- 문서 본문 표현 block을 관리한다.
+CREATE TABLE IF NOT EXISTS document_blocks (
+  -- block 식별자
+  block_id CHAR(36) PRIMARY KEY
+    CHECK (length(block_id) = 36),
+
+  -- 소속 content 식별자
+  content_id CHAR(36) NOT NULL
+    CHECK (length(content_id) = 36),
+
+  -- block 유형 코드
+  block_type_code VARCHAR(32) NOT NULL,
+
+  -- content 안에서의 순서
+  sort_order INTEGER NOT NULL DEFAULT 0,
+
+  -- 텍스트 중심 block 본문
+  content_text TEXT,
+
+  -- 구조형 block payload
+  content_json JSON
+    CHECK (content_json IS NULL OR json_valid(content_json)),
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 확장 메타데이터
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+
+  FOREIGN KEY (content_id)
+    REFERENCES document_contents (content_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (content_id, sort_order),
+
+  CHECK (content_text IS NOT NULL OR content_json IS NOT NULL)
+);
+
+-- 문서 본문 밖의 note annotation을 관리한다.
+CREATE TABLE IF NOT EXISTS document_annotations (
+  -- annotation 식별자
+  annotation_id CHAR(36) PRIMARY KEY
+    CHECK (length(annotation_id) = 36),
+
+  -- 소속 문서 식별자
+  document_id CHAR(36) NOT NULL
+    CHECK (length(document_id) = 36),
+
+  -- annotation 대상 유형
+  target_type_code VARCHAR(32) NOT NULL
+    CHECK (target_type_code IN ('document', 'node', 'content', 'block')),
+
+  -- annotation 대상 식별자
+  target_id CHAR(36) NOT NULL
+    CHECK (length(target_id) = 36),
+
+  -- annotation 유형
+  annotation_type_code VARCHAR(32) NOT NULL DEFAULT 'note'
+    CHECK (annotation_type_code = 'note'),
+
+  -- annotation 상태
+  status_code VARCHAR(32) NOT NULL DEFAULT 'open'
+    CHECK (status_code IN ('open', 'resolved')),
+
+  -- note 내용
+  note_text TEXT NOT NULL,
+
+  -- 작성자 유형
+  author_type_code VARCHAR(32) NOT NULL DEFAULT 'user'
+    CHECK (author_type_code IN ('user', 'agent', 'system')),
+
+  -- 작성자 식별자
+  author_id VARCHAR(128),
+
+  -- 작성자 표시명
+  author_name VARCHAR(128),
+
+  -- 해결 시각
+  resolved_at DATETIME,
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 확장 메타데이터
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+
+  FOREIGN KEY (document_id)
+    REFERENCES document_documents (document_id)
+    ON DELETE CASCADE
+);
+
+-- 하나 이상의 변경 이벤트를 묶는 의미 있는 변경 단위를 관리한다.
+CREATE TABLE IF NOT EXISTS document_revisions (
+  -- revision 식별자
+  revision_id CHAR(36) PRIMARY KEY
+    CHECK (length(revision_id) = 36),
+
+  -- 소속 문서 식별자
+  document_id CHAR(36) NOT NULL
+    CHECK (length(document_id) = 36),
+
+  -- 문서별 revision 순번
+  revision_no INTEGER NOT NULL
+    CHECK (revision_no >= 1),
+
+  -- revision 제목
+  revision_title VARCHAR(256) NOT NULL,
+
+  -- revision 사유
+  revision_reason TEXT,
+
+  -- revision 생성 당시 문서 상태
+  document_status_code VARCHAR(32) NOT NULL
+    CHECK (document_status_code IN ('in_review', 'approved', 'published', 'archived')),
+
+  -- revision 생성자 유형
+  created_by_type_code VARCHAR(32) NOT NULL DEFAULT 'user'
+    CHECK (created_by_type_code IN ('user', 'agent', 'system')),
+
+  -- revision 생성자 식별자
+  created_by_id VARCHAR(128),
+
+  -- revision 생성자 표시명
+  created_by_name VARCHAR(128),
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- revision 요약/확장 메타데이터
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+
+  FOREIGN KEY (document_id)
+    REFERENCES document_documents (document_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (document_id, revision_no)
+);
+
+-- revision에 속하는 로그성 변경 이벤트를 관리한다.
+CREATE TABLE IF NOT EXISTS document_change_events (
+  -- event 식별자
+  event_id CHAR(36) PRIMARY KEY
+    CHECK (length(event_id) = 36),
+
+  -- 소속 revision 식별자
+  revision_id CHAR(36) NOT NULL
+    CHECK (length(revision_id) = 36),
+
+  -- 소속 문서 식별자
+  document_id CHAR(36) NOT NULL
+    CHECK (length(document_id) = 36),
+
+  -- revision 안에서의 event 순서
+  sequence_no INTEGER NOT NULL
+    CHECK (sequence_no >= 1),
+
+  -- 변경 대상 유형
+  target_type_code VARCHAR(32) NOT NULL
+    CHECK (target_type_code IN ('document', 'node', 'content', 'block', 'annotation')),
+
+  -- 변경 대상 식별자
+  target_id CHAR(36) NOT NULL
+    CHECK (length(target_id) = 36),
+
+  -- 변경 유형
+  change_type_code VARCHAR(64) NOT NULL
+    CHECK (change_type_code IN (
+      'created',
+      'updated',
+      'deleted',
+      'status_changed',
+      'reordered',
+      'annotated',
+      'version_created',
+      'new_draft_created'
+    )),
+
+  -- 개별 변경 사유
+  change_reason TEXT,
+
+  -- 변경자 유형
+  changed_by_type_code VARCHAR(32) NOT NULL DEFAULT 'user'
+    CHECK (changed_by_type_code IN ('user', 'agent', 'system')),
+
+  -- 변경자 식별자
+  changed_by_id VARCHAR(128),
+
+  -- 변경자 표시명
+  changed_by_name VARCHAR(128),
+
+  -- 변경 시각
+  changed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- before/after preview 등 이벤트 메타데이터
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+
+  FOREIGN KEY (revision_id)
+    REFERENCES document_revisions (revision_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (document_id)
+    REFERENCES document_documents (document_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (revision_id, sequence_no)
+);
+
+-- 검토/승인/배포 기준본 snapshot을 관리한다.
+CREATE TABLE IF NOT EXISTS document_versions (
+  -- version 식별자
+  version_id CHAR(36) PRIMARY KEY
+    CHECK (length(version_id) = 36),
+
+  -- 소속 문서 식별자
+  document_id CHAR(36) NOT NULL
+    CHECK (length(document_id) = 36),
+
+  -- 기준 revision 식별자
+  revision_id CHAR(36) NOT NULL
+    CHECK (length(revision_id) = 36),
+
+  -- 문서별 version 순번
+  version_no INTEGER NOT NULL
+    CHECK (version_no >= 1),
+
+  -- 표시 버전
+  version_label VARCHAR(64),
+
+  -- snapshot 유형
+  snapshot_type_code VARCHAR(32) NOT NULL
+    CHECK (snapshot_type_code IN ('review', 'approval', 'publication', 'manual')),
+
+  -- snapshot 당시 문서 상태
+  document_status_code VARCHAR(32) NOT NULL
+    CHECK (document_status_code IN ('in_review', 'approved', 'published', 'archived')),
+
+  -- 작은 snapshot 또는 manifest
+  snapshot_json JSON
+    CHECK (snapshot_json IS NULL OR json_valid(snapshot_json)),
+
+  -- snapshot checksum
+  checksum CHAR(64)
+    CHECK (checksum IS NULL OR length(checksum) = 64),
+
+  -- 생성자 유형
+  created_by_type_code VARCHAR(32) NOT NULL DEFAULT 'user'
+    CHECK (created_by_type_code IN ('user', 'agent', 'system')),
+
+  -- 생성자 식별자
+  created_by_id VARCHAR(128),
+
+  -- 생성자 표시명
+  created_by_name VARCHAR(128),
+
+  -- 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (document_id)
+    REFERENCES document_documents (document_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (revision_id)
+    REFERENCES document_revisions (revision_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (document_id, version_no)
+);
+
+CREATE INDEX IF NOT EXISTS idx_document_documents_type_status
+  ON document_documents (document_type_code, status_code);
+
+CREATE INDEX IF NOT EXISTS idx_document_documents_taxonomy
+  ON document_documents (taxonomy_id);
+
+CREATE INDEX IF NOT EXISTS idx_document_documents_source
+  ON document_documents (source_document_id);
+
+CREATE INDEX IF NOT EXISTS idx_document_nodes_document_parent_order
+  ON document_nodes (document_id, parent_node_id, sort_order);
+
+CREATE INDEX IF NOT EXISTS idx_document_nodes_document_level_order
+  ON document_nodes (document_id, node_level, sort_order);
+
+CREATE INDEX IF NOT EXISTS idx_document_contents_document
+  ON document_contents (document_id);
+
+CREATE INDEX IF NOT EXISTS idx_document_blocks_content_order
+  ON document_blocks (content_id, sort_order);
+
+CREATE INDEX IF NOT EXISTS idx_document_annotations_target
+  ON document_annotations (document_id, target_type_code, target_id);
+
+CREATE INDEX IF NOT EXISTS idx_document_annotations_status
+  ON document_annotations (document_id, status_code);
+
+CREATE INDEX IF NOT EXISTS idx_document_revisions_status
+  ON document_revisions (document_id, document_status_code);
+
+CREATE INDEX IF NOT EXISTS idx_document_revisions_created_at
+  ON document_revisions (document_id, created_at);
+
+CREATE INDEX IF NOT EXISTS idx_document_change_events_target
+  ON document_change_events (document_id, target_type_code, target_id);
+
+CREATE INDEX IF NOT EXISTS idx_document_change_events_changed_at
+  ON document_change_events (document_id, changed_at);
+
+CREATE INDEX IF NOT EXISTS idx_document_versions_revision
+  ON document_versions (revision_id);
+
+CREATE INDEX IF NOT EXISTS idx_document_versions_type
+  ON document_versions (document_id, snapshot_type_code);
+
+INSERT INTO document_code_groups (code_group_code, code_group_name, description, sort_order)
+VALUES
+  ('document_type', '문서 유형', '기본 문서, 아키텍처 명세서 등 문서 유형을 구분한다.', 10),
+  ('node_label', '노드 라벨', '문서 node level의 표시 의미를 정의한다.', 20),
+  ('node_role', '노드 역할', 'front matter, body, appendix 등 문서 내 node 역할을 정의한다.', 30),
+  ('toc_visibility', '목차 표시 정책', 'node의 TOC 포함, 제외, 상속 정책을 정의한다.', 40),
+  ('numbering_policy', '번호 정책', '문서 node와 caption 번호 정책을 정의한다.', 50),
+  ('counter_scope', '번호 카운터 범위', '번호 카운터가 문서 전체 또는 parent 기준인지 정의한다.', 60),
+  ('block_type', '블록 유형', '문서 본문 block 유형을 정의한다.', 70),
+  ('document_status', '문서 상태', '문서 작성, 검토, 승인, 배포, 보관 상태를 정의한다.', 80),
+  ('annotation_type', 'Annotation 유형', '본문 밖 부가 annotation 유형을 정의한다.', 90),
+  ('annotation_status', 'Annotation 상태', 'annotation 처리 상태를 정의한다.', 100),
+  ('actor_type', '행위자 유형', 'user, agent, system 행위자 유형을 정의한다.', 110),
+  ('revision_target_type', '변경 대상 유형', 'change event 대상 유형을 정의한다.', 120),
+  ('revision_change_type', '변경 유형', 'change event 유형을 정의한다.', 130),
+  ('snapshot_type', 'Snapshot 유형', 'version snapshot 유형을 정의한다.', 140)
+ON CONFLICT(code_group_code) DO UPDATE SET
+  code_group_name = excluded.code_group_name,
+  description = excluded.description,
+  sort_order = excluded.sort_order,
+  updated_at = CURRENT_TIMESTAMP;
+
+INSERT INTO document_codes (code_group_code, code, code_name, description, sort_order, metadata_json)
+VALUES
+  ('document_type', 'default', '기본 문서', '일반 문서 기본 유형이다.', 10, NULL),
+  ('document_type', 'architecture_specification', '아키텍처 명세서', '대형 아키텍처 명세서 문서 유형이다.', 20, NULL),
+  ('node_label', 'part', '부', 'Part level label이다.', 10, '{"display_label":"Part"}'),
+  ('node_label', 'chapter', '장', 'Chapter level label이다.', 20, '{"display_label":"Chapter"}'),
+  ('node_label', 'section', '절', 'Section level label이다.', 30, '{"display_label":"Section"}'),
+  ('node_label', 'subsection', '항', 'Subsection level label이다.', 40, '{"display_label":"Subsection"}'),
+  ('node_label', 'heading', '제목', 'Heading level label이다.', 50, '{"display_label":"Heading"}'),
+  ('node_label', 'subheading', '하위 제목', 'Subheading level label이다.', 60, '{"display_label":"Subheading"}'),
+  ('node_label', 'detail', '세부', 'Detail level label이다.', 70, '{"display_label":"Detail"}'),
+  ('node_role', 'front_matter', '전면부', '문서 개요, 변경 이력, 용어 정의 등 전면부 node다.', 10, NULL),
+  ('node_role', 'body', '본문', '문서 본문 node다.', 20, NULL),
+  ('node_role', 'appendix', '부록', '문서 부록 node다.', 30, NULL),
+  ('node_role', 'back_matter', '후면부', '참고문헌 등 후면부 node다.', 40, NULL),
+  ('toc_visibility', 'inherit', '상속', '기본 TOC 정책을 상속한다.', 10, NULL),
+  ('toc_visibility', 'include', '포함', 'TOC에 포함한다.', 20, NULL),
+  ('toc_visibility', 'exclude', '제외', 'TOC에서 제외한다.', 30, NULL),
+  ('numbering_policy', 'inherit', '상속', '상위 또는 taxonomy 번호 정책을 상속한다.', 10, NULL),
+  ('numbering_policy', 'none', '없음', '번호를 부여하지 않는다.', 20, NULL),
+  ('numbering_policy', 'decimal', '십진수', '1, 2, 3 형태의 번호를 사용한다.', 30, NULL),
+  ('numbering_policy', 'roman_upper', '대문자 로마자', 'I, II, III 형태의 번호를 사용한다.', 40, NULL),
+  ('numbering_policy', 'alpha_upper', '대문자 알파벳', 'A, B, C 형태의 번호를 사용한다.', 50, NULL),
+  ('numbering_policy', 'custom', '사용자 정의', '사용자 정의 번호를 사용한다.', 60, NULL),
+  ('counter_scope', 'document', '문서 기준', '문서 전체 기준으로 번호를 계산한다.', 10, NULL),
+  ('counter_scope', 'parent', '상위 기준', '상위 node 기준으로 번호를 계산한다.', 20, NULL),
+  ('block_type', 'paragraph', '문단', '일반 문단 block이다.', 10, NULL),
+  ('block_type', 'quote', '인용', '인용문 block이다.', 20, NULL),
+  ('block_type', 'table', '표', '표 block이다.', 30, NULL),
+  ('block_type', 'figure', '그림', '그림 또는 이미지 block이다.', 40, NULL),
+  ('block_type', 'diagram', '다이어그램', '다이어그램 block이다.', 50, NULL),
+  ('block_type', 'list', '목록', '목록 block이다.', 60, NULL),
+  ('block_type', 'code', '코드', '코드 block이다.', 70, NULL),
+  ('block_type', 'callout', '콜아웃', '강조/참고 block이다.', 80, NULL),
+  ('document_status', 'draft', '작성 중', '작성 중인 draft 상태다.', 10, NULL),
+  ('document_status', 'in_review', '검토 중', '검토 기준본 이후 검토 중 상태다.', 20, NULL),
+  ('document_status', 'approved', '승인 완료', '승인 완료 상태다.', 30, NULL),
+  ('document_status', 'published', '배포 완료', '배포 완료 상태다.', 40, NULL),
+  ('document_status', 'archived', '보관', '보관 상태다.', 50, NULL),
+  ('annotation_type', 'note', '노트', '본문 밖 부가 note다.', 10, NULL),
+  ('annotation_status', 'open', '열림', '처리되지 않은 annotation이다.', 10, NULL),
+  ('annotation_status', 'resolved', '해결', '해결된 annotation이다.', 20, NULL),
+  ('actor_type', 'user', '사용자', '사람 사용자다.', 10, NULL),
+  ('actor_type', 'agent', 'Agent', 'AI agent다.', 20, NULL),
+  ('actor_type', 'system', '시스템', '시스템 처리 주체다.', 30, NULL),
+  ('revision_target_type', 'document', '문서', '문서를 대상으로 한다.', 10, NULL),
+  ('revision_target_type', 'node', '노드', '문서 node를 대상으로 한다.', 20, NULL),
+  ('revision_target_type', 'content', 'Content', 'content를 대상으로 한다.', 30, NULL),
+  ('revision_target_type', 'block', 'Block', 'block을 대상으로 한다.', 40, NULL),
+  ('revision_target_type', 'annotation', 'Annotation', 'annotation을 대상으로 한다.', 50, NULL),
+  ('revision_change_type', 'created', '생성', '대상이 생성되었다.', 10, NULL),
+  ('revision_change_type', 'updated', '수정', '대상이 수정되었다.', 20, NULL),
+  ('revision_change_type', 'deleted', '삭제', '대상이 삭제되었다.', 30, NULL),
+  ('revision_change_type', 'status_changed', '상태 변경', '상태가 변경되었다.', 40, NULL),
+  ('revision_change_type', 'reordered', '순서 변경', '순서가 변경되었다.', 50, NULL),
+  ('revision_change_type', 'annotated', 'Annotation', 'annotation이 추가 또는 처리되었다.', 60, NULL),
+  ('revision_change_type', 'version_created', 'Version 생성', 'version snapshot이 생성되었다.', 70, NULL),
+  ('revision_change_type', 'new_draft_created', '새 Draft 생성', '기준 문서에서 새 draft가 파생되었다.', 80, NULL),
+  ('snapshot_type', 'review', '검토 기준본', '검토 요청 시점의 기준본이다.', 10, NULL),
+  ('snapshot_type', 'approval', '승인 기준본', '승인 시점의 기준본이다.', 20, NULL),
+  ('snapshot_type', 'publication', '배포 기준본', '배포 시점의 기준본이다.', 30, NULL),
+  ('snapshot_type', 'manual', '수동 기준본', '사용자가 수동 생성한 기준본이다.', 40, NULL)
+ON CONFLICT(code_group_code, code) DO UPDATE SET
+  code_name = excluded.code_name,
+  description = excluded.description,
+  sort_order = excluded.sort_order,
+  metadata_json = excluded.metadata_json,
+  updated_at = CURRENT_TIMESTAMP;
+
+INSERT INTO document_node_taxonomies (
+  taxonomy_id,
+  taxonomy_code,
+  taxonomy_name,
+  document_type_code,
+  default_toc_level_limit,
+  description
+)
+VALUES
+  ('11111111-1111-4111-8111-111111111111', 'default', '기본 문서 구조', 'default', 3, 'Chapter, Section, Subsection 중심의 기본 문서 구조다.'),
+  ('22222222-2222-4222-8222-222222222222', 'architecture_specification', '아키텍처 명세서 문서 구조', 'architecture_specification', 4, 'Part, Chapter, Section, Subsection 중심의 아키텍처 명세서 구조다.')
+ON CONFLICT(taxonomy_code) DO UPDATE SET
+  taxonomy_name = excluded.taxonomy_name,
+  document_type_code = excluded.document_type_code,
+  default_toc_level_limit = excluded.default_toc_level_limit,
+  description = excluded.description,
+  updated_at = CURRENT_TIMESTAMP;
+
+INSERT INTO document_node_taxonomy_levels (
+  taxonomy_level_id,
+  taxonomy_id,
+  node_level,
+  node_label_code,
+  numbering_policy_code,
+  counter_scope_code,
+  sort_order
+)
+VALUES
+  ('11111111-1111-4111-8111-111111111101', '11111111-1111-4111-8111-111111111111', 1, 'chapter', 'decimal', 'document', 10),
+  ('11111111-1111-4111-8111-111111111102', '11111111-1111-4111-8111-111111111111', 2, 'section', 'inherit', 'parent', 20),
+  ('11111111-1111-4111-8111-111111111103', '11111111-1111-4111-8111-111111111111', 3, 'subsection', 'inherit', 'parent', 30),
+  ('11111111-1111-4111-8111-111111111104', '11111111-1111-4111-8111-111111111111', 4, 'heading', 'inherit', 'parent', 40),
+  ('11111111-1111-4111-8111-111111111105', '11111111-1111-4111-8111-111111111111', 5, 'subheading', 'inherit', 'parent', 50),
+  ('11111111-1111-4111-8111-111111111106', '11111111-1111-4111-8111-111111111111', 6, 'detail', 'inherit', 'parent', 60),
+  ('22222222-2222-4222-8222-222222222201', '22222222-2222-4222-8222-222222222222', 1, 'part', 'roman_upper', 'document', 10),
+  ('22222222-2222-4222-8222-222222222202', '22222222-2222-4222-8222-222222222222', 2, 'chapter', 'decimal', 'document', 20),
+  ('22222222-2222-4222-8222-222222222203', '22222222-2222-4222-8222-222222222222', 3, 'section', 'inherit', 'parent', 30),
+  ('22222222-2222-4222-8222-222222222204', '22222222-2222-4222-8222-222222222222', 4, 'subsection', 'inherit', 'parent', 40),
+  ('22222222-2222-4222-8222-222222222205', '22222222-2222-4222-8222-222222222222', 5, 'heading', 'inherit', 'parent', 50),
+  ('22222222-2222-4222-8222-222222222206', '22222222-2222-4222-8222-222222222222', 6, 'subheading', 'inherit', 'parent', 60),
+  ('22222222-2222-4222-8222-222222222207', '22222222-2222-4222-8222-222222222222', 7, 'detail', 'inherit', 'parent', 70)
+ON CONFLICT(taxonomy_id, node_level) DO UPDATE SET
+  node_label_code = excluded.node_label_code,
+  numbering_policy_code = excluded.numbering_policy_code,
+  counter_scope_code = excluded.counter_scope_code,
+  sort_order = excluded.sort_order,
+  updated_at = CURRENT_TIMESTAMP;