diff --git a/README.md b/README.md index f409d9b..62ea566 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,41 @@ DDS 변형의 능력 (멀티테넌트, OAuth2 federated identity, MAC 모드, --- +## 소스 위치와 Git 저장 기준 + +현재 이 저장소에는 **VPD 관리 백오피스**와 **PoC4 MCP AI Console 외피**가 함께 들어 있다. +두 소스는 별도 Git repository가 아니라 같은 repository의 서로 다른 경로로 관리한다. + +| 구분 | 저장 위치 | 역할 | +|---|---|---| +| VPD/ASO/FGA 관리 백오피스 | `src/main/java/com/cloudhandson/vpdbackoffice/` | Spring Boot 기반 데이터 접근 제어 관리 콘솔 | +| VPD 백오피스 화면 | `src/main/resources/templates/` | Thymeleaf 서버 렌더링 화면 | +| VPD 백오피스 CSS/JS | `src/main/resources/static/` | 화면 동작과 스타일 | +| VPD/ASO/FGA/ORDS/Select AI SQL | `sql/adb/` | ADB 적용·검증 SQL 스크립트 | +| DDS 백오피스 | `dds-backoffice/` | VPD와 분리된 DDS 전용 Spring Boot 데모 | +| Streamlit 외피 / PoC4 MCP AI Console | `poc4_active_source_20260714/` | ReAct-style로 MCP tool을 호출하는 PoC4 데모 소스 snapshot | +| Streamlit 외피 메인 화면 | `poc4_active_source_20260714/apps/poc4/mcp_discovery_ui.py` | MCP discovery, tool routing, ReAct-style agent loop, FGA evidence 표시 | +| Streamlit 외피 MCP 설정 | `poc4_active_source_20260714/config/mcp_servers.json` | `kb_mcp`, `kb_vector_mcp` endpoint와 allowlist | + +Git 기준은 다음과 같다. + +| 항목 | 값 | +|---|---| +| 로컬 작업 디렉터리 | `/home/opc/workspaces/vpd-permission-poc-20260628213409` | +| 운영 기준 remote | `gitea` | +| 운영 기준 repository | `https://gittea.cloud-handson.com/joungmin/vpd-permission-poc.git` | +| 기준 branch | `main` | +| 보조 remote | `origin` = `https://github.com/devmrko/vpd-permission-poc.git` | + +주의: + +- 현재 운영·현행화 기준은 `gitea/main`이다. +- `origin/main`은 보조 remote이며, 이 작업공간의 `main`이 `origin/main`보다 앞서 있을 수 있다. +- `poc4_active_source_20260714/`는 배포 VM의 PoC4 활성 소스를 가져온 snapshot이다. 원본은 배포 VM의 `/home/opc/poc_4/` 계열 경로에서 운영되었고, 저장소에는 비밀정보 없이 소스와 설정 sample만 보관한다. +- 실제 DB password, wallet password, Bearer token, AI key, 대화 SQLite DB는 Git에 넣지 않는다. + +--- + ## 구성요소 | 계층 | 객체 | 역할 |