@soddong/agentic-domain-artifact 0.7.0

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

@@ -0,0 +1,345 @@
+PRAGMA foreign_keys = ON;
+
+-- artifact 패키지의 migration 적용 이력을 관리한다.
+CREATE TABLE IF NOT EXISTS artifact_schema_migrations (
+  migration_id VARCHAR(128) PRIMARY KEY,
+  migration_name VARCHAR(256) NOT NULL,
+  applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 코드 그룹을 정의한다.
+CREATE TABLE IF NOT EXISTS artifact_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,
+  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 artifact_codes (
+  code_group_code VARCHAR(64) NOT NULL,
+  code VARCHAR(128) NOT NULL,
+  code_name VARCHAR(128) NOT NULL,
+  description TEXT,
+  sort_order INTEGER NOT NULL DEFAULT 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 artifact_code_groups (code_group_code)
+    ON DELETE CASCADE
+);
+
+-- 실제 산출물 instance를 관리한다.
+CREATE TABLE IF NOT EXISTS artifact_instances (
+  artifact_instance_id CHAR(36) PRIMARY KEY
+    CHECK (length(artifact_instance_id) = 36),
+  artifact_code VARCHAR(128) NOT NULL,
+  artifact_name VARCHAR(256) NOT NULL,
+  artifact_version VARCHAR(64) NOT NULL DEFAULT '0.1.0',
+  artifact_standard_code VARCHAR(128) NOT NULL,
+  artifact_standard_version VARCHAR(64) NOT NULL,
+  artifact_status_code VARCHAR(64) NOT NULL DEFAULT 'draft'
+    CHECK (artifact_status_code IN ('draft', 'in_review', 'approved', 'published', 'archived', 'deprecated')),
+  methodology_activity_id CHAR(36)
+    CHECK (methodology_activity_id IS NULL OR length(methodology_activity_id) = 36),
+  owner_role_code VARCHAR(128),
+  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)),
+
+  UNIQUE (artifact_code, artifact_version)
+);
+
+-- 실제 산출물 안의 본문, 부록 등 component instance를 관리한다.
+CREATE TABLE IF NOT EXISTS artifact_component_instances (
+  artifact_component_instance_id CHAR(36) PRIMARY KEY
+    CHECK (length(artifact_component_instance_id) = 36),
+  artifact_instance_id CHAR(36) NOT NULL
+    CHECK (length(artifact_instance_id) = 36),
+  artifact_component_code VARCHAR(128) NOT NULL,
+  artifact_component_role_code VARCHAR(64),
+  component_instance_name VARCHAR(256) NOT NULL,
+  component_status_code VARCHAR(64) NOT NULL DEFAULT 'draft'
+    CHECK (component_status_code IN ('draft', 'in_review', 'approved', 'published', 'archived', 'deprecated')),
+  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 (artifact_instance_id)
+    REFERENCES artifact_instances (artifact_instance_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (artifact_instance_id, artifact_component_code)
+);
+
+-- 산출물 instance 또는 component instance와 document/file/resource를 연결한다.
+CREATE TABLE IF NOT EXISTS artifact_resource_links (
+  artifact_resource_link_id CHAR(36) PRIMARY KEY
+    CHECK (length(artifact_resource_link_id) = 36),
+  artifact_instance_id CHAR(36) NOT NULL
+    CHECK (length(artifact_instance_id) = 36),
+  artifact_component_instance_id CHAR(36)
+    CHECK (artifact_component_instance_id IS NULL OR length(artifact_component_instance_id) = 36),
+  resource_type_code VARCHAR(64) NOT NULL
+    CHECK (resource_type_code IN ('DOCUMENT_ID', 'FILE_PATH', 'URL', 'AGENT_RESOURCE_REF')),
+  resource_ref VARCHAR(1024) NOT NULL,
+  resource_role_code VARCHAR(64) NOT NULL DEFAULT 'CONTENT'
+    CHECK (resource_role_code IN ('CONTENT', 'RENDERED_OUTPUT', 'SOURCE', 'REFERENCE', 'ATTACHMENT')),
+  is_primary INTEGER NOT NULL DEFAULT 0
+    CHECK (is_primary IN (0, 1)),
+  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 (artifact_instance_id)
+    REFERENCES artifact_instances (artifact_instance_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (artifact_component_instance_id)
+    REFERENCES artifact_component_instances (artifact_component_instance_id)
+    ON DELETE CASCADE
+);
+
+-- 실제 산출물 instance와 방법론, 산출물 표준, 외부 실행 결과 간 trace를 관리한다.
+CREATE TABLE IF NOT EXISTS artifact_trace_links (
+  artifact_trace_link_id CHAR(36) PRIMARY KEY
+    CHECK (length(artifact_trace_link_id) = 36),
+  artifact_instance_id CHAR(36) NOT NULL
+    CHECK (length(artifact_instance_id) = 36),
+  artifact_component_instance_id CHAR(36)
+    CHECK (artifact_component_instance_id IS NULL OR length(artifact_component_instance_id) = 36),
+  source_type_code VARCHAR(128) NOT NULL,
+  source_ref_id VARCHAR(256) NOT NULL,
+  trace_type_code VARCHAR(64) NOT NULL
+    CHECK (trace_type_code IN ('produced_by', 'refined_by', 'reviewed_by', 'consolidated_by', 'derived_from', 'references')),
+  artifact_standard_code VARCHAR(128),
+  artifact_standard_version VARCHAR(64),
+  artifact_component_code VARCHAR(128),
+  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 (artifact_instance_id)
+    REFERENCES artifact_instances (artifact_instance_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (artifact_component_instance_id)
+    REFERENCES artifact_component_instances (artifact_component_instance_id)
+    ON DELETE CASCADE,
+
+  CHECK (
+    (artifact_standard_code IS NULL AND artifact_standard_version IS NULL)
+    OR (artifact_standard_code IS NOT NULL AND artifact_standard_version IS NOT NULL)
+  )
+);
+
+-- validation 실행 결과의 외부 참조를 관리한다.
+CREATE TABLE IF NOT EXISTS artifact_validation_result_refs (
+  artifact_validation_result_ref_id CHAR(36) PRIMARY KEY
+    CHECK (length(artifact_validation_result_ref_id) = 36),
+  artifact_instance_id CHAR(36) NOT NULL
+    CHECK (length(artifact_instance_id) = 36),
+  artifact_component_instance_id CHAR(36)
+    CHECK (artifact_component_instance_id IS NULL OR length(artifact_component_instance_id) = 36),
+  validation_provider_id VARCHAR(256) NOT NULL,
+  validation_profile_id VARCHAR(256) NOT NULL,
+  validation_result_ref VARCHAR(1024) NOT NULL,
+  validation_status_code VARCHAR(64) NOT NULL
+    CHECK (validation_status_code IN ('valid', 'invalid', 'warning', 'not_run')),
+  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 (artifact_instance_id)
+    REFERENCES artifact_instances (artifact_instance_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (artifact_component_instance_id)
+    REFERENCES artifact_component_instances (artifact_component_instance_id)
+    ON DELETE CASCADE
+);
+
+-- 산출물 instance 또는 component에 대한 검토 결정 외부 참조를 관리한다.
+CREATE TABLE IF NOT EXISTS artifact_review_decision_refs (
+  artifact_review_decision_ref_id CHAR(36) PRIMARY KEY
+    CHECK (length(artifact_review_decision_ref_id) = 36),
+  artifact_instance_id CHAR(36) NOT NULL
+    CHECK (length(artifact_instance_id) = 36),
+  artifact_component_instance_id CHAR(36)
+    CHECK (artifact_component_instance_id IS NULL OR length(artifact_component_instance_id) = 36),
+  review_scope_code VARCHAR(64) NOT NULL
+    CHECK (review_scope_code IN ('artifact_instance', 'artifact_component', 'stage', 'activity')),
+  decision_code VARCHAR(64) NOT NULL
+    CHECK (decision_code IN ('approved', 'changes_requested', 'rejected', 'deferred')),
+  reviewer_ref VARCHAR(256),
+  decision_reason TEXT,
+  decision_result_ref VARCHAR(1024) NOT NULL,
+  decided_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  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 (artifact_instance_id)
+    REFERENCES artifact_instances (artifact_instance_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (artifact_component_instance_id)
+    REFERENCES artifact_component_instances (artifact_component_instance_id)
+    ON DELETE CASCADE
+);
+
+-- 산출물 instance 또는 component의 상태 전이 이력을 관리한다.
+CREATE TABLE IF NOT EXISTS artifact_status_events (
+  artifact_status_event_id CHAR(36) PRIMARY KEY
+    CHECK (length(artifact_status_event_id) = 36),
+  artifact_instance_id CHAR(36) NOT NULL
+    CHECK (length(artifact_instance_id) = 36),
+  artifact_component_instance_id CHAR(36)
+    CHECK (artifact_component_instance_id IS NULL OR length(artifact_component_instance_id) = 36),
+  status_scope_code VARCHAR(64) NOT NULL
+    CHECK (status_scope_code IN ('artifact_instance', 'artifact_component')),
+  from_status_code VARCHAR(64) NOT NULL
+    CHECK (from_status_code IN ('draft', 'in_review', 'approved', 'published', 'archived', 'deprecated')),
+  to_status_code VARCHAR(64) NOT NULL
+    CHECK (to_status_code IN ('draft', 'in_review', 'approved', 'published', 'archived', 'deprecated')),
+  transition_reason TEXT,
+  actor_ref VARCHAR(256),
+  artifact_review_decision_ref_id CHAR(36)
+    CHECK (artifact_review_decision_ref_id IS NULL OR length(artifact_review_decision_ref_id) = 36),
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+
+  FOREIGN KEY (artifact_instance_id)
+    REFERENCES artifact_instances (artifact_instance_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (artifact_component_instance_id)
+    REFERENCES artifact_component_instances (artifact_component_instance_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (artifact_review_decision_ref_id)
+    REFERENCES artifact_review_decision_refs (artifact_review_decision_ref_id)
+    ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_instances_standard
+  ON artifact_instances (artifact_standard_code, artifact_standard_version);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_instances_status
+  ON artifact_instances (artifact_status_code);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_component_instances_artifact
+  ON artifact_component_instances (artifact_instance_id);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_resource_links_artifact
+  ON artifact_resource_links (artifact_instance_id);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_resource_links_component
+  ON artifact_resource_links (artifact_component_instance_id);
+
+CREATE UNIQUE INDEX IF NOT EXISTS ux_artifact_resource_links_primary_artifact
+  ON artifact_resource_links (artifact_instance_id, resource_role_code)
+  WHERE artifact_component_instance_id IS NULL AND is_primary = 1;
+
+CREATE UNIQUE INDEX IF NOT EXISTS ux_artifact_resource_links_primary_component
+  ON artifact_resource_links (artifact_component_instance_id, resource_role_code)
+  WHERE artifact_component_instance_id IS NOT NULL AND is_primary = 1;
+
+CREATE INDEX IF NOT EXISTS idx_artifact_trace_links_artifact
+  ON artifact_trace_links (artifact_instance_id);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_trace_links_source
+  ON artifact_trace_links (source_type_code, source_ref_id);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_validation_result_refs_artifact
+  ON artifact_validation_result_refs (artifact_instance_id);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_review_decision_refs_artifact
+  ON artifact_review_decision_refs (artifact_instance_id, decision_code, decided_at);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_review_decision_refs_component
+  ON artifact_review_decision_refs (artifact_component_instance_id, decision_code, decided_at);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_status_events_artifact
+  ON artifact_status_events (artifact_instance_id, created_at);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_status_events_component
+  ON artifact_status_events (artifact_component_instance_id, created_at);
+
+INSERT OR IGNORE INTO artifact_schema_migrations (migration_id, migration_name)
+VALUES ('0001_artifact_base', 'artifact base schema');
+
+INSERT OR IGNORE INTO artifact_code_groups (code_group_code, code_group_name, description, sort_order)
+VALUES
+  ('artifact_status_code', 'Artifact 상태 코드', '실제 산출물 instance lifecycle 상태를 정의한다.', 10),
+  ('artifact_component_status_code', 'Artifact Component 상태 코드', '실제 산출물 component instance 상태를 정의한다.', 20),
+  ('resource_type_code', 'Resource 유형 코드', '산출물과 연결되는 resource 유형을 정의한다.', 30),
+  ('resource_role_code', 'Resource 역할 코드', '산출물 resource link의 역할을 정의한다.', 40),
+  ('trace_type_code', 'Trace 유형 코드', '산출물 trace 관계 유형을 정의한다.', 50),
+  ('validation_status_code', 'Validation 상태 코드', 'validation result reference 상태를 정의한다.', 60),
+  ('review_scope_code', 'Review Scope 코드', '검토 결정이 적용되는 산출물 범위를 정의한다.', 70),
+  ('review_decision_code', 'Review Decision 코드', '검토 결정 결과를 정의한다.', 80),
+  ('status_scope_code', 'Status Scope 코드', '상태 전이가 적용되는 산출물 범위를 정의한다.', 90);
+
+INSERT OR IGNORE INTO artifact_codes (code_group_code, code, code_name, description, sort_order)
+VALUES
+  ('artifact_status_code', 'draft', '초안', '작성 중인 산출물이다.', 10),
+  ('artifact_status_code', 'in_review', '검토 중', '검토 중인 산출물이다.', 20),
+  ('artifact_status_code', 'approved', '승인', '승인된 산출물이다.', 30),
+  ('artifact_status_code', 'published', '게시', '게시된 산출물이다.', 40),
+  ('artifact_status_code', 'archived', '보관', '보관된 산출물이다.', 50),
+  ('artifact_status_code', 'deprecated', '폐기 예정', '후속 버전으로 대체 예정인 산출물이다.', 60),
+  ('artifact_component_status_code', 'draft', '초안', '작성 중인 component다.', 10),
+  ('artifact_component_status_code', 'in_review', '검토 중', '검토 중인 component다.', 20),
+  ('artifact_component_status_code', 'approved', '승인', '승인된 component다.', 30),
+  ('artifact_component_status_code', 'published', '게시', '게시된 component다.', 40),
+  ('artifact_component_status_code', 'archived', '보관', '보관된 component다.', 50),
+  ('artifact_component_status_code', 'deprecated', '폐기 예정', '후속 버전으로 대체 예정인 component다.', 60),
+  ('resource_type_code', 'DOCUMENT_ID', 'Document ID', 'agentic-domain-document document_id 참조다.', 10),
+  ('resource_type_code', 'FILE_PATH', 'File Path', '파일 경로 참조다.', 20),
+  ('resource_type_code', 'URL', 'URL', '외부 URL 참조다.', 30),
+  ('resource_type_code', 'AGENT_RESOURCE_REF', 'Agent Resource Ref', 'agent resource reference 참조다.', 40),
+  ('resource_role_code', 'CONTENT', '본문', '작성 본문 resource다.', 10),
+  ('resource_role_code', 'RENDERED_OUTPUT', '렌더링 결과', '렌더링된 결과 resource다.', 20),
+  ('resource_role_code', 'SOURCE', '원천', '작성 원천 resource다.', 30),
+  ('resource_role_code', 'REFERENCE', '참조', '참고 resource다.', 40),
+  ('resource_role_code', 'ATTACHMENT', '첨부', '첨부 resource다.', 50),
+  ('trace_type_code', 'produced_by', '생산됨', 'source에 의해 산출물이 생산되었다.', 10),
+  ('trace_type_code', 'refined_by', '정제됨', 'source에 의해 산출물이 정제되었다.', 20),
+  ('trace_type_code', 'reviewed_by', '검토됨', 'source에 의해 산출물이 검토되었다.', 30),
+  ('trace_type_code', 'consolidated_by', '종합됨', 'source에 의해 산출물이 종합되었다.', 40),
+  ('trace_type_code', 'derived_from', '도출됨', 'source에서 산출물이 도출되었다.', 50),
+  ('trace_type_code', 'references', '참조함', 'source 또는 target을 참조한다.', 60),
+  ('validation_status_code', 'valid', '유효', 'validation 결과가 유효하다.', 10),
+  ('validation_status_code', 'invalid', '유효하지 않음', 'validation 결과가 유효하지 않다.', 20),
+  ('validation_status_code', 'warning', '경고', 'validation 경고가 있다.', 30),
+  ('validation_status_code', 'not_run', '미실행', 'validation이 실행되지 않았다.', 40),
+  ('review_scope_code', 'artifact_instance', '산출물 Instance', '검토 결정이 산출물 instance 전체에 적용된다.', 10),
+  ('review_scope_code', 'artifact_component', '산출물 Component', '검토 결정이 산출물 component에 적용된다.', 20),
+  ('review_scope_code', 'stage', 'Stage', '검토 결정이 방법론 stage 결과에 적용된다.', 30),
+  ('review_scope_code', 'activity', 'Activity', '검토 결정이 방법론 activity 결과에 적용된다.', 40),
+  ('review_decision_code', 'approved', '승인', '검토 결과가 승인되었다.', 10),
+  ('review_decision_code', 'changes_requested', '보완 요청', '검토 결과 보완이 필요하다.', 20),
+  ('review_decision_code', 'rejected', '반려', '검토 결과가 반려되었다.', 30),
+  ('review_decision_code', 'deferred', '보류', '검토 결정이 보류되었다.', 40),
+  ('status_scope_code', 'artifact_instance', '산출물 Instance', '상태 전이가 산출물 instance 전체에 적용된다.', 10),
+  ('status_scope_code', 'artifact_component', '산출물 Component', '상태 전이가 산출물 component에 적용된다.', 20);