Files
sodalive-backend-spring-boot/docs/20261117_관리자번역후보선택/reviews/design-review.md
T

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 검증에서 확인한다.