1차년도 산출물을 운영 안정화하면서, 2차년도 핵심 IF 10종을 4명이 분담하여 9월 말까지 마무리한다.
2026-05-01 ~ 2026-09-30
수석 1 + 사원 3 (Backend·Frontend 분담)
IF-04 ~ IF-13 (P0~P2 우선순위)
API P95 ≤ 250ms 동시 달성
| 지표 | 목표 | 비고 |
|---|---|---|
| 모델 개발-배포 리드타임 | 80h | 반자동화 기준 |
| 재학습-배포 자동화율 | 0% | H2M 승인 기반 (CT는 2단계) |
| API 응답시간 P95 | 250ms | k6 부하 테스트 검증 |
| API 가용성 | 99.5% | 월간 평균 (Prometheus) |
각 사원의 책임 영역을 시각화. 수석은 모든 모듈에 걸쳐 리뷰/통합 부담을 진다.
사원이 막히지 않는 환경 + 수석이 병목이 되지 않는 흐름. 각자 18~22주 분량의 자기 모듈을 책임진다.
| 인터페이스 | 수석 | 사원 A | 사원 B | 사원 C | 비고 |
|---|---|---|---|---|---|
| IF-04 모델 배포 | A | R | C | I | Docker SDK + Rolling |
| IF-05 추론 서빙 | A | C | R | C | Rate Limit, 멱등성 |
| IF-06 교차 이벤트 | R(설계) | I | R(구현) | I | Webhook + DLQ |
| IF-07 추론 로그 | A | C | R | I | 마스킹, 90일 |
| IF-08 Ground Truth | A | I | R | I | request_id 매칭 |
| IF-10 모니터링 메트릭 | A | I | R(BE) | R(FE) | Prometheus + UI |
| IF-11 알림/경보 | A | R | C | C(UI) | 그룹화 5분 |
| IF-12 승인/반려 (H2M) | A | R(BE) | I | R(UI) | RBAC 게이트 |
| IF-13 모델 롤백 | A | R | I | C(UI) | 자동/수동, 60초 |
| IF-09 드리프트 (설계) | R | I | C | I | 2단계 1차 본격 |
R=Responsible · A=Accountable · C=Consulted · I=Informed
5~9월 구현 대상. 화살표는 호출 방향이 아닌 데이터 흐름.
| 유형 | 대상 IF | 형식 | 특이사항 |
|---|---|---|---|
| REST/JSON | IF-05·08·12 | HTTP/1.1 + JSON | JWT, X-Request-ID, 표준 에러 코드 10종 |
| Webhook | IF-06·09·11 | HTTP POST + JSON | 재시도 3회 (1s/2s/4s) → DLQ 적재 |
| Internal API | IF-04·13 | FastAPI 내부 | DB 트랜잭션 + 감사 로그 |
| Prometheus Exposition | IF-10 | text/plain | 운영 6종 + 모델 성능 6종 |
| Log Stream | IF-07 | 구조화 JSON | VIN/IP/part_sn 마스킹, 90일 |
| MLflow REST | IF-03 운영 | MLflow API v3 | 외부 서버 (자체 호스팅 X) |
2차년도 신규/고도화 화면 5종. 권한별 동작과 반응형/접근성 가이드는 상세 문서 참조.
DataOps 수신 데이터셋 목록·상세, 검증 결과, 매니페스트, 검증 이력.
KPI · 모델 성능 · PSI · 추론량 · 리소스. 30초 폴링 + 모델/기간 필터.
필터 · ack · resolve · Toast. CRITICAL은 사이드바 배지 + 강조.
Staging vs Production 비교. 코멘트 (H2H) + 승인 다이얼로그 (H2M).
배포 목록 · Steps timeline · 헬스 · 수동 롤백 (60초 SLA).
Dashboard · Experiments · Model Registry · Pipelines · API Services · Settings · Login.
9월 말까지 골든 패스 E2E 1회 통과 (데이터 → 학습 → 등록 → 승인 → 배포 → 추론 → 로그 → GT → 모니터링 → 알림 → 롤백).
개발자 PC · docker compose · 단위 테스트
사내 공용 · 통합 테스트 · FE↔BE 연동
외부 협력사와 IF 정합성 검증
현장 환경 · 1단계 후반
단위 70%, 통합 20%, E2E 7%, 성능/보안 3%. 신규 코드 라인 커버 ≥ 85%.
pytest --cov, 분기 ≥ 75%
IT-01 ~ IT-08 자동화
Playwright Journey-A~F
k6 SCN-01~04 (P95/가용성/롤백)
| 단계 | 검증 | 차단 조건 |
|---|---|---|
| Pre-PR | ruff · pytest · vitest | 실패 시 머지 차단 |
| PR | + 통합 테스트 + 마이그레이션 dry-run | 실패 시 머지 차단 |
| Pre-prod | k6 SCN-01~04 | P95 / 가용성 미달 시 차단 |
| 보안 (M2/M4/M5) | bandit · semgrep · OWASP ZAP | CRITICAL/HIGH 결함 차단 |
1차년도에 확정한 스택을 운영/고도화. 2단계를 위한 K8s/AutoML은 학습/PoC 단계.
uv (CLAUDE.md 규약)가능성 × 영향 점수. 25=CRITICAL, 12~19=HIGH, 6~11=MEDIUM. 매주 월요일 Weekly Sync에서 점검.
deployments · serving · monitoring · alerts · approvals · events
datasets(NEW) · monitoring · alerts · compare · deployments(NEW)
단위·통합·E2E + 부하 + 보안 리포트
본 plans/2nd 디렉토리 + 인터페이스 정의서 v1.0 + Runbook 10종
5월 종료 + 6/7/8/9월 진척 + 5~9월 통합
단일 모듈 + 통합 + E2E 녹화 + 인수 리허설 + 최종 데모
Docker Compose · GitHub Actions · Prometheus · Grafana 5종
P95 ≤ 250ms · 가용성 ≥ 99.5% 검증 리포트
결정은 텍스트로, 약속은 캘린더로. 사원이 막히지 않는 안전망.
| Daily Standup | 매일 09:30 (15분, Slack 스레드) |
| Weekly Sync | 월 14:00 (60분, 화상 + 회의록) |
| Code Review Hour | 금 16:00 (60분, 누적 PR + 학습 발표) |
| Bi-weekly 외부협력 | 격주 화 14:00 (120분, 임픽스/아이티엘) |
| Monthly 진척 보고 | 월말 금 (60분, 외부 PM) |
200~400 lines 권장 · 800 lines 초과 시 분할
일반 1 영업일 · Hotfix ≤ 1h · Draft 4 영업시간
Conventional Commits (feat/fix/docs/refactor/...)
본 페이지는 통합 요약입니다. 상세 가이드는 각 마크다운을 참고하세요.
| # | 문서 | 내용 |
|---|---|---|
| 00 | overview.md | 전체 개요 · 기간 · 목표 · 산출물 |
| 01 | schedule.md | 주차별 상세 일정 · 마일스톤 · 작업량 |
| 02 | team_allocation.md | 인력 배치 · R&R · RACI · 백업 |
| 03 | screen_definition.md | 화면 정의서 · 권한별 가시성 · 반응형 |
| 04 | screen_flow.md | 사용자 흐름 6종 (Journey-A~F) |
| 05 | protocol.md | 프로토콜 (REST/Webhook/Internal/Prometheus) |
| 06 | collaboration.md | Git · PR · 코드 리뷰 · 회의 운영 |
| 07 | integration.md | 모듈 · 외부 시스템 통합 · E2E |
| 08 | testing.md | 테스트 전략 · 부하 · 보안 |
| 09 | tech_stack.md | 전체 기술 스택 · 환경 변수 |
| 10 | risk_management.md | Top 10 리스크 · Postmortem · Runbook |
| 11 | deliverables.md | 산출물 정의 · DoD · Sign-off |
| 12 | communication.md | 채널 · 회의 · 의사결정 · 안전망 |