Admin Console Navigation & Route Map
1. 목적
- 2단(Tiered) 내비게이션 정책을 문서화해 정보 구조, 역할 기반 접근, Next.js 라우트 구조를 일관되게 유지
- 메뉴 변경이 다른 모듈에 미치는 영향을 명확히 하기 위해 Tier1 ↔ Tier2 ↔ Route ↔ 설계 문서를 매핑
2. Tier 1 카테고리
| Tier 1 | 설명 | 대표 페르소나 |
|---|---|---|
Operations | MAO/CTA 운영, 실험, 관측 | Prompt Architect, Clinical Ops PM |
Support | 사용자 케이스/세션/알림 지원 | Support Specialist |
Platform | Feature Flag, Integrations, 환경 상태 | Ops Engineer |
Security | IAM, Roles, Audit, 정책 | Compliance/IAM Admin |
System | 로그, 진단, 설정, Admin 환경 관리 | Ops Engineer |
Tier 1 항목은 최대 5개로 유지하여 스크롤 없는 내비게이션을 목표로 한다.
3. Tier 2 메뉴 및 라우트 맵
| Tier 1 | Tier 2 | Next.js 경로 (apps/dha-sleep-web/app/(admin)/...) | 설명 | 관련 문서 |
|---|---|---|---|---|
| Operations | Dashboard | /operations | KPI 개요, Alert Feed, 최근 배포 | overview.md |
| Operations | Agent Ops | /operations/agent | Prompt Library, Deployments, Guardrails | mao/prompt-ops.md |
| Operations | LLM Models | /operations/agent/models | LLM Provider/Model 프로필·폴백 정책 | mao/prompt-ops.md |
| Operations | CTA Ops | /operations/cta | CTA 템플릿/타게팅/승인 | admin-console/cta/ (예정) |
| Operations | Experiments | /operations/experiments | Routing A/B, KPI Gates, Canary 설정 | mao/prompt-ops.md |
| Operations | Observability | /operations/observability | Routing/CTA KPI, TimeMachine 타임라인 | mao/prompt-ops.md |
| Support | Cases | /support/cases | 사용자 케이스, SLA 상태 | admin-console/support/ (예정) |
| Support | Sessions | /support/sessions | 세션 리플레이, CTA 로그 | admin-console/support/ (예정) |
| Support | Notifications | /support/notifications | 알림 재전송, 상태 모니터링 | admin-console/support/ (예정) |
| Support | Account Flags | /support/accounts | 계정 플래그, Override | admin-console/support/ (예정) |
| Platform | Feature Flags | /platform/feature-flags | 릴리즈 플래그, 점진 롤아웃 | admin-console/config/ (예정) |
| Platform | Integrations | /platform/integrations | Prompt/CTA/TimeMachine 연결 구성 | admin-console/config/ (예정) |
| Platform | Environment | /platform/environment | 환경 상태, 버전, Incident 메모 | admin-console/config/ (예정) |
| Security | IAM | /security/iam | 역할/권한, 사용자 관리 | admin-console/config/iam.md (예정) |
| Security | Audit | /security/audit | Audit Trail, Export | admin-console/config/iam.md (예정) |
| Security | Access Reports | /security/access | Access review, 정책 서명 | admin-console/config/iam.md (예정) |
| System | Logs | /system/logs | 앱/클라이언트 로그 뷰어 | admin-console/config/ (예정) |
| System | Diagnostics | /system/diagnostics | 헬스체크, Latency, 토큰 비용 | admin-console/config/ (예정) |
| System | Settings | /system/settings | 콘솔 자체 설정, 테마, 실험 토글 | admin-console/config/ (예정) |
4. 라우팅 가이드
- Tier 1은
/app/(admin)/[tier]/layout.tsx로 공통 레이아웃을 제공하고, Tier 2는 해당 하위에 중첩 라우트로 구성 - 각 Tier 2 화면은
page.tsx+ 필요시 클라이언트 컴포넌트로 구성하며, 공통 헤더에 Breadcrumb(Operations / Agent Ops)을 표시 - Nav 데이터는
libs/shared/admin-nav에 JSON 구조로 정의하고, Tiltle/Scope/Icon을 포함해 Role 기반 필터링 가능하도록 한다
5. 권한 매핑
| Tier 2 | 최소 권한 Scope |
|---|---|
| Agent Ops | prompt.read (View), prompt.write (Edit) |
| LLM Models | prompt.model (Provider/Model 관리) |
| CTA Ops | cta.read, cta.write, cta.approve |
| Experiments | experiment.read, experiment.write |
| Observability | observability.read |
| Support Cases/Sessions | support.read, support.write |
| Feature Flags | config.flag.write |
| Integrations | config.integration.write |
| Environment | config.env.read |
| IAM/Audit/Access | iam.manage, audit.read |
| Logs/Diagnostics | system.logs, system.diagnostics |
6. 향후 업데이트 프로세스
- 신규 모듈 추가 시
overview.md의 Capability Map과 본 파일의 Tier 2 테이블을 동시 갱신 - 라우트 변경 시
/app/(admin)구조와libs/shared/admin-nav를 업데이트하고, 이 문서에 반영 - QA 단계에서 메뉴/라우트 일치 여부를 테스트 케이스로 추가(Cypress navigation spec)
본 문서는 Admin Console 2단 내비게이션의 0.1 버전이며, 실제 구현이 진행되는 순서에 맞춰 Tier 2 항목과 권한 스코프를 보강한다.