diff --git a/README.md b/README.md
index a2cdaa3c..7e117632 100644
--- a/README.md
+++ b/README.md
@@ -1,155 +1,222 @@
-# Bifröst
+
+
+
-> **DB만 연결하면 데이터 파이프라인은 클릭 몇 번 또는 자연어로, 장애는 AI 에이전트가 진단까지.**
-> CDC·EDA 데이터 파이프라인을 셀프서비스로 구축·운영하는 AIOps 플랫폼.
+Bifrost
----
+데이터베이스를 등록하면 CDC/EDA 파이프라인을 구성하고, 운영 중 발생하는 장애 신호를 evidence 기반 AI Agent가 진단하는 DataOps/AIOps 플랫폼
-## 개요
+
+
+
+
+
+
+
-**Bifröst**는 사용자가 소스·싱크 데이터베이스만 등록하면, UI 클릭 또는 자연어 채팅으로 **CDC(Change Data Capture)** 및 **EDA(Event-Driven Architecture)** 파이프라인을 생성·운영할 수 있는 플랫폼입니다.
+문서 · 로컬 실행
-파이프라인을 만들면 플랫폼이 Kubernetes 위에 **Kafka(Strimzi)·Debezium·Kafka Connect**를 자동 프로비저닝합니다. 운영 중에는 **AI 에이전트**가 파이프라인을 모니터링하고, 장애를 감지해 **근거 기반 RCA(Root Cause Analysis)**를 수행하며, 자연어로 상태 조회와 조치를 지원합니다(변경 조치는 운영자 승인 후 실행).
+
+
+
+ 운영 콘솔 — 파이프라인 상태와 AI Agent 인시던트 패널
+
+
+Kafka, Debezium, Kafka Connect, Kubernetes를 직접 다루지 않고도 데이터베이스 중심으로 스트리밍 파이프라인을 만들고 운영할 수 있게 하는 것이 목표입니다. 사용자는 Workspace에 Source/Sink DB를 등록하고 테이블 단위로 CDC(direct)·EDA(fan-out) 파이프라인을 생성하며, lag·connector failure·schema mismatch 같은 운영 신호를 콘솔과 AI Agent로 확인합니다.
+
+핵심적으로 구현한 것은 다음 세 가지입니다.
+
+- **Strimzi 기반 connector provisioning** — UI/API 입력을 Fabric8로 `KafkaConnector` CR로 만들고 status watcher로 lifecycle을 추적
+- **`/internal/ops` mutation governance** — 운영 변경을 policy·approval·idempotency·audit 경계 하나로 강제
+- **evidence 기반 RCA** — root cause catalog + evidence matrix + verifier loop로 LLM 진단의 환각을 억제
+
+## 이 프로젝트에서 다룬 문제
+
+운영 자동화에 LLM을 붙일 때 가장 큰 위험은 **AI가 인프라를 직접, 검증 없이 바꾸는 것**입니다. Bifrost는 이를 구조로 제한합니다.
+
+- **AI는 운영 리소스를 직접 변경하지 않는다.** FastAPI Agent는 read-only tool과 root cause catalog로 RCA를 수행하고 근거(evidence)를 매트릭스로 제시하며, verifier로 자기 검증한 뒤 불확실하면 단정하지 않고 unknown/evidence gap으로 보류하거나 추가 evidence를 요구합니다. RCA·remediation 단계는 *조치 후보*까지만 만듭니다.
+- **모든 mutation은 단일 경계를 통과한다.** connector restart/pause/resume, consumer group restart 같은 변경은 Spring `/internal/ops`에서 idempotency·policy·evidence·audit 경계를 거쳐 실행됩니다. AI 서비스는 이 경계 밖으로 운영 리소스를 만질 수 없습니다.
+- **위험 조치는 사람이 승인한다(HITL).** `PolicyGuard` 판정에 따라 위험 조치는 approval·change ticket 대상이 되고, platform mutation gate(`/internal/ops`) 기준으로 낮은 위험 조치(예: resume)는 자동 허용됩니다.
+
+이 경계 덕분에 "AI가 장애를 진단한다"와 "AI가 운영을 직접 바꾼다"를 분리할 수 있습니다.
## 핵심 기능
-- **셀프서비스 파이프라인** — DB 등록 → CDC(source→sink) / EDA(fan-out) 파이프라인을 UI·자연어로 생성. Strimzi Kafka·Debezium·JDBC Sink Connector 자동 구성.
-- **AI 장애 대응(RCA)** — 8계층·35 근본원인 카탈로그 + evidence matrix 기반 진단, confidence 스코어링·캘리브레이션, 근거 부족 시 기권(`UNKNOWN_WITH_EVIDENCE_GAP`).
-- **자연어 운영** — 채팅으로 파이프라인·메트릭·로그·인시던트를 조회하고 조치. planner가 read-only 도구로 라우팅하며, 변경 조치는 HITL(Human-in-the-Loop) 승인을 거칩니다.
-- **실시간 관측성** — 파이프라인 상태·consumer lag·인시던트를 실시간 대시보드로 추적.
-- **멀티테넌시** — 프로젝트(테넌트)별 DB·파이프라인·인시던트 격리.
+| 영역 | 내용 |
+| --- | --- |
+| 인증·Workspace | 이메일/비밀번호 로그인, JWT, Workspace 생성·멤버·설정, Workspace 단위 Kafka principal secret reference 조회 |
+| Database Registry | PostgreSQL/MariaDB 연결 테스트·등록, schema 탐색, CDC source/sink readiness 점검, DB metrics |
+| Pipeline | UI wizard·API로 CDC(direct)·EDA(fan-out) 생성, 테이블 단위 Debezium source / JDBC sink, pause·resume·delete lifecycle |
+| Provisioning | Fabric8 + Strimzi `KafkaConnector` CR 생성, status watcher, topic/connector naming 규칙, `timestamptz` custom converter 포함 Connect 이미지 |
+| Monitoring | pipeline·connector·task 상태, consumer lag, topic messages, CDC sync 근사치, cluster overview, SSE event stream |
+| AI Agent | 자연어 질의, incident RCA workflow, 35종 root cause catalog, evidence matrix, verifier loop, HITL approval·action |
+| Governance | `/internal/ops` 경계, mutation allowlist, `PolicyGuard`, approval·change ticket·idempotency·audit |
+
+## 화면
+
+
+
+ |
+ |
+
+
+evidence 기반 RCA — confidence와 근거가 부족하면 UNKNOWN_WITH_EVIDENCE_GAP으로 보류하고 추가 evidence를 요구 |
+조치 후보 — 위험도(낮음·중간)와 승인 상태, 근거 리포트를 함께 제시하고 실행은 /internal/ops 경계를 통과 |
+
+
## 아키텍처
-```
- Browser
- │ /api
- ▼
-┌──────────────┐ /api/v1/agent ┌──────────────────────┐
-│ frontend │ ─────────────────────────▶ │ ai-service │
-│ React/Vite │ │ FastAPI (8082) │
-│ (5173) │ │ RCA 에이전트 · LLM │
-└──────┬───────┘ │ pgvector 지식베이스 │
- │ /api └───────────┬──────────┘
- ▼ │ /internal/ops
-┌──────────────────────────┐ ◀──────────────────────────┘
-│ operations-backend │
-│ Spring Boot (8080) │ 인증 · datasource/pipeline 도메인 · K8s/Kafka 자동화
-└──────────────┬────────────┘
- │ provisioning
- ▼
-┌────────────────────────────────────────────────────────────┐
-│ Kubernetes (EKS) · Strimzi Kafka · Kafka Connect │
-│ Debezium(source) → Kafka Topic → JDBC Connect(sink) │
-└────────────────────────────────────────────────────────────┘
+```mermaid
+flowchart TB
+ User[Browser] --> FE[Frontend
React + Vite]
+ FE -->|auth · workspaces · databases · pipelines · monitoring| OPS[Operations Backend
Spring Boot]
+ FE -->|agent query · SSE| AI[AI Service
FastAPI Agent]
+ AI -->|/internal/ops only| OPS
+
+ subgraph ControlPlane[Control Plane]
+ OPS --> META[(metadb
PostgreSQL)]
+ AI --> AGENTDB[(agentdb
PostgreSQL + pgvector)]
+ AI --> LLM[LLM Provider
optional]
+ end
+
+ subgraph Runtime[Data / Runtime Plane]
+ OPS --> K8S[Fabric8 / Kubernetes API]
+ OPS --> STRIMZI[Strimzi KafkaConnector CR]
+ OPS --> CONNECT[Kafka Connect REST]
+ OPS --> KAFKA[Kafka AdminClient]
+ OPS --> OBS[Prometheus / Loki / Tempo]
+ STRIMZI --> CONNECT
+ CONNECT --> TOPIC[Kafka Topic]
+ SOURCE[(Source DB)] --> CONNECT
+ CONNECT --> SINK[(Sink DB · CDC direct)]
+ TOPIC --> CONSUMER[External Consumer · EDA fan-out]
+ end
```
-- **operations-backend** (Spring Boot 모놀리스) — 플랫폼 API, 인증, datasource·pipeline 도메인, K8s/Kafka 자동화. 에이전트 전용 내부 API `/internal/ops/**`는 외부에 노출하지 않습니다.
-- **ai-service** (FastAPI) — RCA 에이전트, LLM 도구 라우팅(planner·retrieval), 인시던트 분석, pgvector 지식베이스, 운영자 피드백 gold set.
-- **frontend** (React·Vite·TypeScript) — 콘솔 UI, 파이프라인·인시던트 대시보드, AI 채팅 패널.
+대표적인 요청 흐름은 세 가지입니다.
-> 브라우저/외부 클라이언트는 `/api/**` 또는 FastAPI `/api/v1/agent/**`만 사용하고, FastAPI가 내부 DNS로 Spring Boot `/internal/ops/**`를 호출합니다. Spring Boot는 단일 모놀리스이며, core/orchestrator 분리는 [ADR 0004](docs/adr/0004-monorepo-monolith.md)로 흡수되었습니다.
+1. **파이프라인 생성** — Frontend wizard → Spring platform API → Fabric8가 Strimzi `KafkaConnector` CR 생성 → watcher가 상태 추적
+2. **장애 진단** — 사용자 질의/incident → FastAPI Agent가 read-only 조회 + catalog/evidence 기반 RCA → verifier 검증 → 근거와 함께 응답(SSE)
+3. **승인된 조치 실행** — Agent가 만든 조치 후보 → `/internal/ops`에서 policy·approval·idempotency·audit → Kafka Connect REST 조치
+
+### 서비스 책임
+
+- **`services/operations-backend`** (Spring Boot) — 플랫폼 본체. 인증, Workspace, DB registry, pipeline lifecycle, provisioning, monitoring, governance, `/internal/ops` 집행 경계.
+- **`services/ai-service`** (FastAPI) — 장애대응 AI 계층. Supervisor가 진단 경로(`correlation → planner → retrieval → classifier → rca → verifier → report`)를 제어하고, remediation 요청 시 `remediation → policy_guard → approval_gate`가 덧붙으며, 승인된 조치 실행은 별도 `action_execution` 경로(executor)에서 Spring `/internal/ops`로 위임.
+- **`services/frontend`** (React/Vite) — 운영 콘솔. Spring·FastAPI API를 함께 호출, pipeline·database·alerts·cluster·settings 화면과 AI Agent panel 제공.
+- **`connect-plugins/timestamptz-converter`** — Debezium PostgreSQL `timestamptz`를 Kafka Connect `Timestamp` 논리 타입으로 변환하는 custom converter.
## 기술 스택
-| 영역 | 스택 |
+| 구분 | 사용 기술 |
| --- | --- |
-| Backend | Java 21, Spring Boot, Gradle |
-| AI | Python 3.11, FastAPI, LLM, pgvector |
-| Frontend | React, Vite, TypeScript, Tailwind CSS |
-| Data plane | Apache Kafka (Strimzi), Debezium, Kafka Connect (JDBC) |
-| Datastore | PostgreSQL(metadb), pgvector(agentdb), 테넌트 DB(PostgreSQL/MariaDB) |
-| Build/CI/CD | Gradle multi-module(`operations-backend`, `timestamptz-converter`), Jenkins(Kaniko), Harbor, Argo CD GitOps |
-| Infra | AWS EKS(Terraform), Strimzi, ingress-nginx+cert-manager, Sealed Secrets |
-| Observability | Prometheus, Grafana, Loki, Tempo |
+| JVM Backend | Java 21, Spring Boot 3.3.5, Spring Security/Data JPA/Kafka, SSE, springdoc-openapi, Gradle multi-project |
+| Infra Client | Fabric8 Kubernetes Client 6.13.4, Strimzi API 0.45.0, Kafka Clients 3.7.1, Flyway, PostgreSQL·MariaDB JDBC |
+| AI Backend | Python 3.11+, FastAPI, Pydantic v2, httpx, asyncpg, Alembic, OpenAI SDK, OpenTelemetry |
+| Frontend | React 18.3, TypeScript 5.7, Vite 6, Tailwind CSS 4, React Router, Recharts, React Markdown, Three.js, Vitest |
+| Data Plane | Apache Kafka, Strimzi, Kafka Connect, Debezium PostgreSQL/MariaDB, Confluent JDBC Sink |
+| Storage | PostgreSQL metadb, PostgreSQL/pgvector agentdb, PostgreSQL·MariaDB tenant DB |
+| CI/CD · Infra | Terraform(EKS), Kubernetes, Jenkins, Kaniko, Harbor, Argo CD GitOps, SealedSecrets(gitops branch) |
+| Observability | Prometheus, OpenTelemetry OTLP (Grafana·Loki·Tempo 연동) |
+
+## 디렉터리 구조
+
+```text
+bifrost/
+├─ services/
+│ ├─ operations-backend/ Spring Boot 플랫폼 API · internal ops executor
+│ ├─ ai-service/ FastAPI RCA/Agent 서비스
+│ └─ frontend/ React/Vite 운영 콘솔
+├─ connect-plugins/
+│ └─ timestamptz-converter/ Kafka Connect custom converter (Gradle 모듈)
+├─ infra/
+│ ├─ terraform/ EKS Terraform (environments/dev · modules/eks)
+│ ├─ k8s/ Strimzi · Kafka · Connect · monitoring manifest
+│ ├─ cicd/ Jenkins · Argo CD · Harbor bootstrap
+│ ├─ docker/kafka-connect/ Custom Kafka Connect 이미지
+│ └─ local/ 로컬 tenant DB · smoke-test helper
+├─ docs/ 스펙 · 설계 · API · ADR
+├─ docker-compose.yml 로컬 Kafka/metadb/tenantdb/agentdb/WireMock 스택
+├─ Jenkinsfile CI/CD 파이프라인
+└─ Makefile Terraform · kubeconfig · Strimzi · compose 단축 명령
+```
-## 빠른 시작
+## 로컬 실행
-### Prerequisites
+로컬은 **의존 인프라를 Compose로 띄우고 각 애플리케이션 서비스를 직접 실행**하는 구성입니다. `docker-compose.yml`은 Kafka·Connect·DB·WireMock 등 인프라와 `ai-service`만 정의하며, `operations-backend`와 `frontend`는 아래처럼 별도로 실행합니다.
-- JDK 21 (Temurin 권장)
-- Node 20+
-- Python 3.11+
-- Docker + Docker Compose
+**Prerequisites** — JDK 21 · Node.js 20+ · Python 3.11+와 `uv` · Docker Compose (선택: Strimzi 대상 `KUBECONFIG`)
-### 로컬 실행
+> 파이프라인 provisioning의 정본 경로는 Strimzi `KafkaConnector` CR입니다. 로컬 Compose 스택은 개발/스모크 용도이며, CR 생성·watcher까지 보려면 kind/EKS 등 Kubernetes + Strimzi가 필요합니다.
```bash
-# 1. 의존 인프라(Kafka, metadb, 테넌트 DB 시뮬레이터, agentdb 등) 기동
-docker compose up -d # 또는 ./scripts/local-up.sh
-
-# 2. operations-backend (Spring Boot)
-JAVA_HOME=$(/usr/libexec/java_home -v 21) ./gradlew :services:operations-backend:bootRun
-
-# 3. ai-service (FastAPI)
-cd services/ai-service
-python -m venv .venv && .venv/bin/pip install -e .
-.venv/bin/uvicorn app.main:app --reload --port 8082
-
-# 4. frontend (React)
-cd services/frontend
-npm install && npm run dev
+# 1. 로컬 의존 인프라 기동 (make local-up 과 동일)
+docker compose up -d meta-db tenant-postgres tenant-mariadb kafka kafka-connect kafka-ui agentdb wiremock
+
+# 2. Operations Backend (Spring) — dev 프로필, env는 예시값
+SPRING_PROFILES_ACTIVE=dev \
+META_DB_URL=jdbc:postgresql://localhost:5433/metadb \
+KAFKA_BOOTSTRAP=localhost:9094 \
+KAFKA_CONNECT_REST_URL=http://localhost:8083 \
+INTERNAL_OPS_AUTH_DISABLED=true \
+./gradlew :services:operations-backend:bootRun
+
+# 3. AI Service (FastAPI) — 별도 터미널, agentdb는 Compose에서 localhost:5435
+(cd services/ai-service && uv sync && \
+ AI_DATABASE_URL=postgresql+asyncpg://agent:agent@localhost:5435/agentdb uv run alembic upgrade head)
+(cd services/ai-service && \
+ AI_SPRING_OPS_BASE_URL=http://localhost:8080 \
+ AI_DATABASE_URL=postgresql+asyncpg://agent:agent@localhost:5435/agentdb \
+ uv run uvicorn app.main:app --port 8082 --reload)
+
+# 4. Frontend — 별도 터미널
+(cd services/frontend && npm install && npm run dev)
```
-접속:
+LLM API key가 없으면 AI Service는 fallback 응답으로 동작합니다. 서비스별 필수 환경변수는 각 서비스 디렉터리의 설정과 `application-dev.yml`을 참고하세요. README에는 민감한 production secret을 포함하지 않습니다.
| 대상 | URL |
| --- | --- |
-| Frontend | http://localhost:5173 |
-| Platform API (Swagger) | http://localhost:8080/swagger-ui.html |
-| AI Service (OpenAPI) | http://localhost:8082/docs |
-| Kafka UI | http://localhost:8090 |
+| Frontend | `http://localhost:5173` |
+| Spring Swagger UI | `http://localhost:8080/swagger-ui.html` |
+| FastAPI OpenAPI | `http://localhost:8082/docs` |
+| Kafka UI | `http://localhost:8090` |
+| Kafka Connect REST | `http://localhost:8083` |
-## 프로젝트 구조
+## 테스트와 빌드
+```bash
+./gradlew :services:operations-backend:test # Spring Boot
+./gradlew :connect-plugins:timestamptz-converter:test # Kafka Connect converter
+cd services/ai-service && uv run pytest # FastAPI
+cd services/frontend && npm run test && npm run build # Frontend
```
-bifrost/
-├─ docs/ 문서·ADR·명세 (Source of Truth)
-├─ services/
-│ ├─ operations-backend/ Spring Boot — 플랫폼 API·K8s/Kafka 자동화
-│ ├─ ai-service/ FastAPI — RCA 에이전트·LLM
-│ └─ frontend/ React UI
-├─ connect-plugins/ Kafka Connect 커스텀 컨버터 Gradle 모듈
-├─ infra/ Terraform·K8s manifest·CI/CD bootstrap
-├─ scripts/ 로컬/배포 스크립트 (local-up.sh 등)
-└─ docker-compose.yml 로컬 의존 인프라
-```
-
-## CI/CD·배포
-
-- Jenkins `bifrost-ci`는 `jenkins-values.yaml`의 JCasC/job-dsl로 생성되는 단일 Pipeline job이며, SCM 브랜치는 `*/main`, scriptPath는 루트 `Jenkinsfile`이다.
-- `main` push/webhook 빌드에서 직전 성공 커밋 대비 변경된 앱 서비스(`services/ai-service`, `services/operations-backend`, `services/frontend`)만 Kaniko로 빌드해 Harbor `harbor.harbor.svc.cluster.local/library/bifrost-:`와 `:latest`에 push한다.
-- `operations-backend`는 멀티모듈 Gradle 빌드라 Kaniko 컨텍스트가 레포 루트이고, `ai-service`와 `frontend`는 각 서비스 디렉터리를 컨텍스트로 쓴다.
-- `infra/docker/kafka-connect` 또는 `connect-plugins/` 변경 시 Kafka Connect 커스텀 이미지도 루트 컨텍스트로 빌드해 고정 태그 `1.0.0-converter`, git sha, `latest`로 Harbor에 push한다. 앱 서비스처럼 GitOps tag를 자동 변경하지는 않는다.
-- 앱 서비스 배포는 Jenkins가 `gitops` 브랜치의 `charts//values.yaml` `image.tag`만 커밋하고, Argo CD `0-root-bifrost-root` app-of-apps가 `argocd/apps/`의 10개 child Application을 polling/reconcile해 적용한다.
-## 개발
+주요 테스트 축은 governance gate, Strimzi mapper·provisioner, RCA catalog·evidence·verifier, frontend Agent SSE·pipeline wizard helper입니다.
-브랜치·커밋·PR 컨벤션은 [docs/team/git-convention.md](docs/team/git-convention.md)를 따릅니다.
+## 인프라와 배포
-- **브랜치 모델**: `main`(배포 가능) ← `develop`(통합) ← 작업 브랜치 `{type}/#{이슈번호}`
-- **작업 흐름**: GitHub Issue 생성 → 브랜치 → PR(대상 `develop`) → **Squash & merge**. `main ← develop`은 릴리스 시점에만.
-- **타입**: `feat` · `fix` · `chore` · `docs` · `refactor` (커밋은 `test` 추가)
-- **커밋 메시지**: `#{이슈번호} [type] 메시지`
-- **보호**: `main`·`develop` 직접 푸시 금지, PR·CI 통과 필수
+- `infra/terraform`이 기존 VPC/Subnet 위에 EKS 클러스터·노드그룹을 구성합니다(`environments/dev`, `modules/eks`).
+- Kubernetes runtime은 namespace 경계로 Kafka/Connect, Bifrost services, registry, CI/CD, GitOps, monitoring, metadb·agentdb·tenantdb를 분리합니다.
+- Kafka는 Strimzi 기반 KRaft cluster, Kafka Connect는 Debezium·JDBC Sink·custom `timestamptz` converter를 포함한 custom image를 사용합니다.
+- Jenkins는 변경된 app service만 Kaniko로 build/push하고 `gitops` 브랜치의 Helm values image tag를 갱신합니다.
+- **이 저장소(기본 브랜치)** 에는 EKS Terraform(`infra/terraform`), Strimzi/Kafka/Connect/monitoring manifest, Jenkins·Argo CD·Harbor bootstrap이 있습니다.
+- **애플리케이션 배포 정본(app-of-apps, 서비스 Helm chart, SealedSecrets)은 별도 `gitops` 브랜치**에 있으며 Argo CD가 이를 reconcile합니다.
+- secret 값·token·production endpoint는 README에 포함하지 않습니다.
-## 팀
+## 설계에서 신경 쓴 점
-| 이름 | 역할 | 담당 | GitHub | Email |
-| --- | --- | --- | --- | --- |
-| 이성민 | **PM** | Spring Boot | [@seongmin0229](https://github.com/seongmin0229) | leesung2925@gmail.com |
-| 정재환 | **PL** | 인프라 · Frontend · CI/CD | [@hwnnn](https://github.com/hwnnn) | 2020112023@dgu.ac.kr |
-| 백강민 | Backend | Spring Boot | [@baekkangmin](https://github.com/baekkangmin) | rkdgur1902@naver.com |
-| 권세빈 | AI | FastAPI | [@sebeeeen](https://github.com/sebeeeen) | a856412@gmail.com |
-| 김연수 | AI | FastAPI | [@sooooscode](https://github.com/sooooscode) | sooooscode@gmail.com |
+- **v1 Agent는 pipeline 생성을 직접 실행하지 않습니다.** 파이프라인 생성은 UI wizard·Spring platform API가 정본 경로입니다.
+- **Agent mutation과 platform 조치의 책임이 다릅니다.** `POST /pipelines/{id}/pause|resume`(platform)와 Agent mutation tool은 경로가 구분되며, Agent 변경은 `/internal/ops`에서 approval·idempotency·audit을 거칩니다.
+- Workspace KafkaUser provisioning은 SCRAM-SHA-512 인증 CR을 생성합니다. Kafka ACL authorization은 cluster authorizer 설정에 의존해 현재 코드에서 제외돼 있습니다.
+- monitoring poller는 event row를 만들지만 완전 자동 incident 생성·RCA trigger는 제한적이며, RCA run은 주로 Alerts/Agent 경로에서 사용자 시작으로 수행됩니다.
+- DB credential은 metadb secret store에 저장될 수 있으나 API 응답·로그에 raw material을 노출하지 않습니다.
## 문서
-- [문서 인덱스](docs/README.md)
-- [기능 명세 (Spec)](docs/spec.md)
-- [ADR (Architecture Decision Records)](docs/adr/)
-- [Git 컨벤션](docs/team/git-convention.md)
+[문서 인덱스](docs/README.md) · [기능 명세](docs/spec.md) · [Spring 설계](docs/design/backend-springboot/overview.md) · [FastAPI 설계](docs/design/backend-fastapi/overview.md) · [Frontend 설계](docs/design/frontend.md) · [Infra 설계](docs/design/infra.md) · [Spring API](docs/api/springboot.md) · [FastAPI API](docs/api/fastapi.md) · [ADR](docs/adr/) · [Git Convention](docs/team/git-convention.md)
## License
-캡스톤 프로젝트 — 라이선스 미정.
+루트 `LICENSE` 파일이 아직 없습니다. 공개 배포 전 라이선스 확정이 필요합니다.