Skip to content

Commit de4d2d1

Browse files
authored
[CHORE] AI-11 이 문서에서 빠져 있던 것 + AI-09·AI-10 주석이 현실과 어긋나던 것
[CHORE] AI-11 이 문서에서 빠져 있던 것 + AI-09·AI-10 주석이 현실과 어긋나던 것
2 parents 1c385ba + 0a53cb4 commit de4d2d1

2 files changed

Lines changed: 15 additions & 5 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Spring(BACKEND 리포)이 이 서버를 부르는 **단방향**이다.
2525

2626
전부 `X-Internal-Token` 헤더 필수. 미구현 계층은 **501** 로 거절한다(200 + 빈 결과로 두면
2727
Spring 이 "계층 정상 완료, 산출물 없음"으로 기록해 미구현이 품질 문제로 위장된다).
28-
지금은 열 개가 다 붙어 있어 501 을 내는 경로가 없다.
28+
지금은 열한 개가 다 붙어 있어 501 을 내는 경로가 없다.
2929

3030
| ID | 경로 | 상태 |
3131
|---|---|---|
@@ -39,6 +39,7 @@ Spring 이 "계층 정상 완료, 산출물 없음"으로 기록해 미구현이
3939
| **AI-08** | `POST /internal/vector/upsert` | **구현됨** |
4040
| **AI-09** | `POST /internal/similar` | **구현됨** |
4141
| **AI-10** | `GET /internal/health` | **구현됨** |
42+
| **AI-11** | `POST /internal/layers/overview/summarize-meeting` | **구현됨** |
4243

4344
AI-10 이 돌려주는 `implemented` 목록과 실제 라우팅이 어긋나지 않는지 테스트가 검증한다
4445
(`test_internal_auth.py`). 계층을 붙이고 목록을 잊으면 워커가 미구현 계층을 부른다.

‎app/routers/internal.py‎

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -132,10 +132,18 @@ async def summarize_meeting(
132132
return await overview.summarize_meeting(request, runner)
133133

134134

135-
# ── AI-10 · 헬스체크 — 워커 백오프 판단용 ──────────────────────────────────────
136-
# 인프라 liveness(/health, 무인증)와 구분한다. 이쪽은 "계층을 받을 준비가 됐는지"이므로
137-
# 토큰을 요구하고 모델 설정 여부까지 본다 — 키가 없는 채로 살아 있으면 워커가
138-
# 계속 태우다 전부 실패한다.
135+
# ── AI-10 · 헬스체크 — 운영 점검·구현 목록 노출용 ─────────────────────────────
136+
# 인프라 liveness(/health, 무인증)와 구분한다. 이쪽은 "계층을 받을 준비가 됐는지"라
137+
# 토큰을 요구하고 모델 설정 여부까지 본다 — status: UP 만으로는 **떠 있지만 일은 못 하는**
138+
# 서버(키 없음·dryRun·계층 덜 배포됨)를 구분할 수 없다.
139+
#
140+
# ⚠ Spring 소비처 없음(의도) — 2026-08-16 전수 대조로 확인했다. 예전 주석은 '워커 백오프
141+
# 판단용'이라 적었으나 그렇게 부르는 코드는 없었다. 지금 이 응답은 사람이 배포를 확인할 때
142+
# 읽는다. 소비처를 지어내지 않으려고 그 문구를 걷어낸다.
143+
#
144+
# 응답 필드는 줄이지 않는다 — 언젠가 기계가 읽는다면 geminiConfigured·dryRun·implemented 가
145+
# 판단의 핵심이 된다. 다만 그 자리는 매 주기 백오프가 아니라 **기동·배포 게이트**가 맞다고
146+
# 본다(주기마다 왕복이 붙고, 체크와 호출 사이 틈에서 조용히 일을 건너뛰는 실패가 생긴다).
139147
@router.get("/health")
140148
async def internal_health(settings: Settings = Depends(get_settings)) -> dict:
141149
return {
@@ -187,6 +195,7 @@ async def vector_upsert(
187195
# 계층은 이 엔드포인트를 거치지 않고 few_shot.lookup 을 직접 부른다(같은 프로세스 안이라
188196
# 왕복시킬 이유가 없다). 이 엔드포인트는 **같은 조회를 밖에서 확인할 수 있게** 열어 둔다 —
189197
# few-shot 이 이상할 때 계층 전체를 돌리지 않고 검색만 떼어 볼 수 있어야 한다.
198+
# ⚠ Spring 소비처 없음(의도) — 2026-08-16 전수 대조로 확인했다. 고아로 보인다고 지우지 마라.
190199
@router.post("/similar", response_model=SimilarResponse)
191200
async def similar(
192201
request: SimilarRequest,

0 commit comments

Comments
 (0)