resume-haness/docs/structured-records.md

구조화 레코드 계약

EvidenceItem.content는 다양한 원자료를 수용하기 위한 원자적 사실 문장입니다. 회사·직무·기간 같은 핵심 이력을 자유 문장에만 보관하면 정렬, 날짜 검증, 양식 변환이 불안정해지므로 CandidateProfile.records에 다음 타입을 선택적으로 병행 저장합니다.

타입	필수 구조	의미
CareerRecord	회사, 직무, 기간, 고용형태, 근거 ID	금전적 보수를 받은 경력 (paid=true)
ExperienceRecord	역할, 기간, 경험 유형, 근거 ID	프로젝트·봉사 등 무급 경험 (paid=false)
EducationRecord	학교, 학위, 기간, 상태, 근거 ID	학력·교육 이력
CertificationRecord	자격명, 발급기관, 취득일, 근거 ID	자격·인증 이력

EmploymentType은 채용공고와 경력 레코드가 함께 쓰는 enum입니다. 정규직, 시간제, 기간제, 계약직, 인턴, 프리랜서, 파견직, 기타를 구분합니다.

불변 조건

• 모든 레코드는 하나 이상의 기존 EvidenceItem.evidence_id를 참조합니다.
• 회사·직무·학교·학위·자격명·발급기관·날짜 같은 핵심 값은 연결된 근거의 content, keywords, metrics, date_range 정보에서 확인되어야 합니다.
• 레코드 ID는 프로필 전체에서 유일하며 하나의 근거 ID는 한 레코드만 소유합니다.
• 경력은 career, 학력은 education, 자격은 certification 범주의 근거만 참조합니다. 무급 경험은 프로젝트·봉사·활동 계열 근거만 참조합니다.
• 완료된 기간은 종료일이 필수입니다. 시작일 이후의 종료일만 허용하고, 진행 중인 기간은 종료일을 함께 둘 수 없습니다.
• 재학 상태는 진행 중 기간과 일치해야 하며 자격 만료일은 취득일보다 빠를 수 없습니다.
• 입력 순서에 의존하지 않고 *_chronological()이 최신순 정본 뷰를 제공합니다.

날짜는 연, 연월, 연월일 정밀도를 그대로 보존합니다. 입력에 없는 일자를 임의로 만들지 않으며 한국식 표기는 각각 YYYY, YYYY.MM, YYYY.MM.DD입니다.

개인정보·출력 경계

구조화 레코드는 현재 로컬 intake 및 검증 계층입니다. LLM에 전달되는 candidate_facts whitelist나 Markdown 렌더러에 자동으로 추가되지 않습니다. 따라서 학교명이나 회사명이 public_blind 필터, 기밀 근거 차단, 글자 수 제한, ResumeDraft.fingerprint()를 우회할 수 없습니다.

향후 구조화 레코드를 초안에 자동 반영하는 materializer는 다음 순서를 지켜야 합니다.

1. 민감·기밀 근거 제외 및 공고별 블라인드 필드 제거
2. 허용된 근거 ID를 가진 DraftClaim 생성
3. ContentPlan 및 공고 제약과의 참조 무결성 검사
4. 결정적 validator와 독립 품질 평가 수행
5. 승인된 ResumeDraft fingerprint에 품질 보고서를 결합한 뒤 렌더

레코드에서 곧바로 Markdown/DOCX 행을 만드는 공개 API는 정본 불변 조건을 깨뜨리므로 제공하지 않습니다.