대사(Reconciliation) 런북

정합성 엔진(financial_integrity, 마이그레이션 017/021/022)이 D1 불변조건을 평가해 finding + 지문 dedup 예외를 기록해요. 금전 자동수정은 없어요 — 상태 표면화 되돌리기(stale lease 해제)만 자동이고 나머지는 운영자 행동 전까지 needs_review/예외로 남아요.

스캔 실행

POST /api/v1/admin/reconciliation/run        # 시작/재개 {run_id?}
GET  /api/v1/admin/reconciliation/reports
GET  /api/v1/admin/reconciliation/report/:id

• run 상태: running(커서 재개) · completed · degraded(check ERROR/INCOMPLETE 존재 — 부분 커버리지를 completed로 위장하지 않아요) · failed.
• 5분 cron 순서: outbox dispatch → 정산 스위프 → recon run 1회 → 감사 보강.
• yp integrity status|report|verify(devpay-cli)는 이 엔드포인트의 읽기 전용 래퍼예요.

finding → 예외 흐름

1. 새 지문 → OPEN 예외 + 이벤트.
2. 재관측 → occurrence_count+1(새 행 아님); REVERIFYING/종단 후 재관측 → REOPENED.
3. REVERIFYING 중 지문 부재 + 산출 check 완주 → RESOLVED.

분류 절차

GET /api/v1/admin/financial-integrity/summary
GET /api/v1/admin/financial-integrity/exceptions?status=OPEN
POST .../exceptions/:id/transition {to_status:"TRIAGED", reason:"..."}

• auto_fixed finding — 후속 효과 확인 후 진행, 오탐 확정 시에만 CLOSED_AS_FALSE_POSITIVE.
• needs_review finding — financial-integrity의 복구 op 또는 수동 수정 후 REMEDIATING → REVERIFYING, 재실행 또는 RUN_RECON_VERIFY.
• 알림 스텁: 연속 3회 failed/degraded run → alert:recon_failures 감사 증적(외부 알림은 PLANNED — admin 엔드포인트의 audit_evidence를 확인하세요).

Fail-closed 보장

• 행 부재/쿼리 오류는 절대 '정상'이 아니에요 — check ERROR, run degraded.
• INCOMPLETE check는 remaining>0을 보고해요 — 부분 스캔을 조용히 통과시키지 않아요.