Skip to content

[FEAT] AI-05·07 판정 계층 2종 (L3.5 확정 게이트 · L5 관점 다변화) #9

Description

@dlxodus02

📊 우선순위

  • P0 : 서비스 핵심 동작
  • P1 : 운영 및 확장 기능

생성 계층(L1.5·L2·L3)과 성격이 다르다. 이쪽은 이미 만들어진 것을 통과시킬지 말지 정한다. 게이트가 없으면 합의되지 않은 논의가 그대로 배정으로 나간다.

🎯 완료 조건

  • AI-05 POST /internal/layers/l3-5/gate — 확정/논의 게이트
  • AI-07 POST /internal/layers/l5/verify — 관점 다변화 검증
  • 모델이 답하지 않은 항목이 '통과'가 되지 않는다 (누락 = DISCUSSED)
  • L5 는 다수결이 아니라 불일치 감지 — 불일치는 덮지 않고 검토로 보낸다

💻 상세 작업 내용

  • app/layers/l3_5.py · l5.py · 대응 스키마·프롬프트
  • app/routers/internal.py — 501 → 구현
  • pyproject.toml · uv.lock — 테스트 의존성 추가

🚨 검증 및 예외 처리 — 설계의 핵심

L3.5 · 누락이 통과가 되지 않는다

모델이 판정을 돌려주지 않은 항목  →  DISCUSSED

반대로 두면(누락 = CONFIRMED) 응답이 잘리거나 항목 하나를 건너뛴 것만으로 합의되지 않은 일이 배정으로 나간다. 게이트에서 가장 비싼 실패다.

  • 요청 항목 수만큼, 요청 순서대로 반환
  • itemKey 를 요청 항목의 enum 으로 박아 없는 항목에 대한 판정이 나올 수 없게 함
  • 알 수 없는 판정값도 DISCUSSED 로 떨어진다
  • test_응답이_통째로_비어도_확정이_생기지_않는다

'버린다'가 항목 삭제가 아니라 DISCUSSED 로 남기는 것인 이유는 V5.8 주석과 같다 — "이 안건은 담당자가 안 정해졌다"고 짚어주는 것 자체가 결과물이고, 게이트를 조일지 풀지 판단할 근거다.

L5 · 관점 다변화

같은 모델에 같은 프롬프트를 N번 돌리면 틀릴 때도 똑같이 틀린다. 100% 일치가 오답에 최고 신뢰도를 준다. 그래서 관점을 바꿔 묻고(EXTRACT_NARROW vs VERIFY) 불일치는 덮지 않고 needs_review 로 보낸다.

  • tests/test_l3_5_gate.py · test_l5_verify.py

🔗 참고

  • API 명세: BACKEND 리포 docs/A-캡처파이프라인-API명세.md — AI-05·07
  • 선행: AI-02·03·04 (공통 포맷터를 그 PR 이 들고 있어 스택으로 쌓임)

Activity

  1. self-assigned this
    on Aug 5, 2026
  2. dlxodus02 commented on Aug 5, 2026

    @dlxodus02
    ContributorAuthor

    다시 엽니다 — 이 이슈의 코드가 develop 에 없습니다.

    PR #5 가 develop 이 아니라 feat/ai-layers-l1_5-l2-l3(#4 의 브랜치)로 머지됐고, #4 는 squash 로 develop 에 들어갔습니다. squash 는 히스토리를 새로 쓰므로 그 위에 쌓였던 #5 의 커밋이 develop 과 연결이 끊겼습니다. PR 은 MERGED, 이슈는 CLOSED 로 보이는데 app/layers/l3_5.py · l5.py 는 develop 에 없습니다(404).

    feat/ai-l3_5-l5-restore 브랜치로 develop 기준 3-way 머지해 복구합니다. 새 PR 을 이 이슈에 연결하겠습니다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Type

No type

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions