docs: split local vs operational completion boundaries

This commit is contained in:
happybell80 2026-03-04 00:37:13 +09:00
parent 2f4984dd68
commit cdcf792dc9
2 changed files with 39 additions and 1 deletions

View File

@ -47,7 +47,26 @@
- 감정 분류기 모델 재학습
- 인프라 토폴로지 변경
## 3-1. 자기개선 루프 계획과의 운영 원칙 (설계 병행, 실행 분리)
## 3-1) 로컬 개발자 실행 경계 (필수)
### 로컬 개발자가 할 수 있는 것
- 프롬프트 DB 스키마/Repository/Service/API 구현
- `/api/message` 경로의 프롬프트 버전 선택/이벤트 자동 기록 코드 구현
- 단위 테스트/로컬 통합 테스트 작성 및 실행
- 실험 게이트/승격 조건 로직 문서화 및 코드 반영
### 로컬 개발자가 할 수 없는 것 (운영 확인 필요)
- 23 게이트웨이 프록시 경로/메서드 운영 반영 확정
- 운영 DB 실적재/지표 집계 기반 자동 승격 최종 판정
- 실사용 트래픽 기준 품질/안전/비용 게이트 충족 판정
- 운영 경유 폐루프 E2E 최종 승인
### 완료 판정 규칙
- 로컬 완료: 코드/테스트/문서 기준 충족
- 운영 완료: 서버 반영 + 운영 경유 E2E + 지표 검증 완료
- 운영 증거 없이는 "프롬프트 DB화 완료"로 보고하지 않는다
## 3-2. 자기개선 루프 계획과의 운영 원칙 (설계 병행, 실행 분리)
- 설계는 병행:
- 프롬프트 DB화와 자기개선 루프 DB를 `run_id` 기준으로 함께 설계한다.
- 실행은 분리:

View File

@ -11,6 +11,25 @@
- 기존 자산(`intent_review_queue`, `ir_deck_feedback`, `conversation_log`)을 재사용한다.
- 부족한 영역(정책 버전/반성 기록)을 신규 테이블로 보완한다.
## 1-1) 로컬 개발자 실행 경계 (필수)
### 로컬 개발자가 할 수 있는 것
- `rb8001`, `robeing-gateway`, `robeing-monitor` 코드 수정
- 단위 테스트/통합 테스트(로컬) 작성 및 실행
- DDL/API 스펙 문서화, 마이그레이션 SQL 초안 작성
- `run_id` 전파 로직, `/api/message` 자동 적재 로직 구현
### 로컬 개발자가 할 수 없는 것 (운영 확인 필요)
- 23/24 서버 배포 반영 및 실서비스 재시작 확인
- 게이트웨이(23) 실제 프록시 규칙 반영 여부 최종 확정
- 운영 DB 실제 적재량/운영 지표 기준선 확정
- 운영 경유 E2E(`gateway -> rb8001 -> monitor`) 최종 판정
### 완료 판정 규칙
- 로컬 완료: 코드/테스트/문서 기준 충족
- 운영 완료: 서버 반영 + 운영 E2E 증거(로그/응답/DB 적재) 확인
- 운영 증거 없이는 "전체 완료"로 보고하지 않는다
## 2) 구현 대상 (핵심)
### A. 정책 버전 테이블 추가