init: resume 작성 하네스 설계

2026-07-24 13:55:11 +09:00
parent eb1141a767
commit f22cf5aff2
113 changed files with 21992 additions and 1 deletions
@@ -0,0 +1,29 @@
+# ADR 0001: 근거 기반 Resume IR을 정본으로 사용
+
+- 상태: 채택
+- 날짜: 2026-07-17
+
+## 결정
+
+렌더된 문서가 아니라, 모든 문장에 근거 ID가 연결된 `ResumeDraft`
+도메인 모델을 이력서 내용의 정본으로 사용합니다. JSON과 YAML은 이
+정본의 교환·저장을 위한 직렬화 형식이지 최종 문서 렌더러가 아닙니다.
+후보자 입력 사실은 별도 `CandidateProfile`로 보존하며 생성기가 수정하지
+못합니다.
+
+## 이유
+
+단일 프롬프트로 문서를 바로 생성하면 사실 추적, 부분 수정, 출력 포맷 전환, 회귀 검증이 어렵습니다. 중간 표현을 사용하면 같은 내용으로 민간형·블라인드형·ATS형을 렌더할 수 있고, 근거 없는 문장을 하드 게이트로 차단할 수 있습니다.
+
+## 결과
+
+- 모든 문장 생성 API는 `evidence_ids`를 반환해야 합니다.
+- 렌더러는 콘텐츠를 추가하거나 재작성할 수 없습니다.
+- 현재 코어는 초안 fingerprint와 후보자·전체 평가 컨텍스트·평가 정책
+  fingerprint로 품질 보고서의 적용 대상을 결합합니다.
+- fingerprint는 서명이 아니므로 다중 사용자 배포의 품질 보고서는 별도의
+  서명된 attestation과 신뢰 저장소가 필요합니다.
+- 입력·프롬프트·모델·검사기·템플릿 버전 감사 로그는 배포 계층이
+  구현해야 할 후속 요구사항입니다.
+- 현재 최종 렌더러는 Markdown뿐입니다. 향후 PDF/DOCX/HWPX는 파생
+  산출물로 만들고, 다시 파싱해 정본으로 쓰지 않습니다.