운영 문서와 상태판 동기화

This commit is contained in:
Yun Chan 2026-06-28 20:13:36 +09:00
parent 3a9f70a97b
commit eb77d7ec7c
10 changed files with 369 additions and 145 deletions

View file

@ -741,7 +741,7 @@ COUNSELING PRACTICE · 4주차 ← kicker
핵심: **운영 신뢰성 + 감사.** 학습 내용엔 개입 안 하고 시스템·사용·교수활동 감사에 집중. 무채 슬레이트로 가장 차분.
- **정보구조:** `/admin`은 운영 홈으로 고정한다. 사용자 CRUD는 `/admin/users`, 역할·그룹·권한 정책은 `/admin/access`, 사용자 문제·불만·장애 접수는 `/admin/tickets`로 분리한다. 설정은 계속 `/settings`다.
- **증거 원칙:** 운영 티켓은 `app.support_ticket`, 헬스 샘플 이력은 `app.admin_health_event`에 저장된 실제 행만 표시한다. 상시 모니터링 데몬이 없는 현재 단계에서는 "SLA 업타임"처럼 표현하지 않고 "최근 헬스 샘플 정상률/중단 기록"으로 표시한다. 세분 그룹 CRUD처럼 저장소/API가 없는 항목은 빈 상태 또는 정책 초안으로 남기며, 운영 수치처럼 보이는 목업 숫자는 금지한다.
- **증거 원칙:** 운영 티켓은 `app.support_ticket`, 헬스 샘플 이력은 raw `app.admin_health_event`와 daily `app.admin_health_daily_rollup`에 저장된 실제 행만 표시한다. 티켓 중복 표시는 저장된 `fingerprint`/`parent_ticket_id` 기반 힌트와 관리자 수동 연결만 보여주며, 자동 병합이나 자동 수정처럼 보이게 만들지 않는다. 관리자 화면 조회와 synthetic sampler가 샘플을 적재할 수 있지만, "SLA 업타임"처럼 표현하지 않고 "최근 헬스 샘플 정상률/중단 기록"으로 표시한다. 세분 그룹 CRUD처럼 저장소/API가 없는 항목은 빈 상태 또는 정책 초안으로 남기며, 운영 수치처럼 보이는 목업 숫자는 금지한다.
- **운영 KPI 5:** 사용자/강좌/세션주/가동%/API오류. mono 32px. 오류 0 초과 시 해당 KPI만 `--warn-solid`, 임계 초과 `--crit-solid`. 정상 땐 전부 무채 — "조용한 게 정상".
- **세션 추이 = 단일 라인차트**(막대 아님). 피크 1점만 라벨.
- **음성·AI 사용 + 비용:** OpenAI 음성 분/평가 토큰/추정 비용/예산 대비 게이지(80% 넘으면 `--warn-solid`). 운영비 가시화(윤찬 graphify 비용 통제 문화).