3.7 KiB
3.7 KiB
관리자 번역 후보 설계 검토
이 문서는 2026-11-17 설계 검토 이력이다. DR-03의 OFF 호환 모드와 flag 전환 정책은 2026-11-18 PRD DEC-11/P7로 대체됐다. 현재는 기동 시 자동 등록하며, 새 writer 작업 생성 전에 세 테이블·언어 포함 unique index 준비, 구 writer/in-flight 종료, 구 index 제거가 필요하다. 아래 과거 판정은 보존한다.
범위와 판정
- 일자: 2026-11-17.
- 대상: PRD, API 계약, 구현 계획.
- 독립 검토: Oracle 한 차례, 문서와 관련 기존 코드 읽기만 수행.
- 판정: 아래 지적 보정 후 설계 산출물 수용 가능. 제품 구현 완료 또는 사용자 구현 승인을 의미하지 않는다.
지적 및 반영
| ID | 중요도 | 확인한 문제 | 보정 내용 |
|---|---|---|---|
| DR-01 | 높음 | 비활성 포함·한 번 적용 후 종료를 인터뷰 확정으로 잘못 기록 | 후속 인터뷰에서 활성 콘텐츠만 포함, 한 번 적용 후 종료를 직접 확인했다. PRD DEC-09/10으로 정정했다. 자유 번역문 입력 제외는 요청 범위 제안으로 구분했다. |
| DR-02 | 높음 | API apply 설명이 source 검증 후 잠금을 획득 | request → Series → CONTENT 잠금 후 최신 source·membership·override·payload를 재조회·검증하도록 통일했다. |
| DR-03 | 높음 | source-language-aware lookup과 구 unique index가 혼재하면 insert 충돌 | 새 코드의 disabled 호환 모드는 exact-language 조회 후 legacy-key exists 확인으로 기존 mismatch skip을 보존한다. 구 writer 제거와 구 index 삭제 후에만 enabled=true로 활성화한다. 호환 모드도 단일 row legacy 조회를 하지 않는다. |
| DR-04 | 중간 | 취소의 실제 전송/dispatch 승인 기준 및 network 대기 설명 충돌 | DB 취소 commit 이후 새 승인·게시 금지로 통일했다. 이미 승인된 호출은 in-flight이고, 취소 응답은 network 종료를 기다리지 않는다. |
| DR-05 | 중간 | grouping/segment/candidate 배열 대응 및 preview 계약 부족 | GroupingResponse/TitleTemplate/TitleSegment, code-point index, shared/residual valueIndex, input/output cardinality, receipt 타입을 정의했다. |
| DR-06 | 중간 | PREPARING의 durable 실행·재시작·취소가 불명확 | 요청과 활성 member IDs를 먼저 저장하고 동일 poller가 preparation lease/fence를 claim한다. 복구 1회, snapshot 게시 전 취소·source 검증, 반복 만료의 명시 실패를 정의했다. |
| DR-07 | 중간 | replay 우선순위 및 frozen provider version 검사가 누락 | 저장된 generation revision/apply operation replay를 최신 revision 거부보다 먼저 확인하고 provider ID/version 변경은 명시 실패로 처리한다. |
추가 정합성 보정
- CONTENT materializer는 유효한 관리자 override가 있으면 해당 필드의 shared memory가 없어도 승인 값을 사용할 수 있도록 순서를 명시했다.
- API의 잘못된 계획 anchor, source snapshot/현재 값 구분, 삭제·비활성화 후 자격 검증을 보완했다.
- 위 수정은 문서만 변경했다. 신규 endpoint, DDL, source, test는 구현하지 않았다.
검증 범위
- 부모 에이전트가 세 문서를 읽고 요구사항·API·계획을 대조했다.
- 공백 검사와 최종 변경 파일 확인 결과는 구현 계획의 문서 검증 기록에 남긴다.
- 실행하지 않음: 애플리케이션/테스트/빌드, 운영 DB·MySQL 잠금 검증, 실제 AWS·파파고 호출, 프론트엔드 QA.
- 남은 항목: 사용자 기술 설계 검토와 별도 구현 승인. 실제 제목 분석 정확도·처리량·provider timeout은 계획의 focused 검증에서 확인한다.