refs #701: modularize HMM console profile and scenarios

poc4_active_source_20260714/SOURCE_README.md

@@ -1,8 +1,9 @@
-# PoC4 MCP AI Console source snapshot
+# HMM AI 업무 에이전트 소스
 
 생성일: 2026-07-14 GMT
 
-이 폴더는 현재 PoC4 MCP AI Console 실행에 필요한 소스 파일을 원래 경로 구조로 추려 복사한 스냅샷입니다.
+이 폴더는 HMM AI 업무 에이전트 실행 소스다. `poc4`라는 디렉터리·환경변수 접두어는
+기존 배포 호환성을 위한 레거시 경로이며, 서비스의 정식 이름은 **HMM AI 업무 에이전트**다.
 
 ## Entrypoint
 
@@ -25,7 +26,8 @@ streamlit run apps/poc4/mcp_discovery_ui.py --server.address 0.0.0.0 --server.po
 ## Included
 
 - `apps/poc4/mcp_discovery_ui.py`
-- `apps/poc4/ui_theme.py`
+- `src/agent_console/presentation.py`
+- `src/agent_console/profile.py`
 - `src/mcp_tool_router.py`
 - `src/oci_genai_sdk.py`
 - `src/poc3/model_registry.py`
@@ -33,6 +35,8 @@ streamlit run apps/poc4/mcp_discovery_ui.py --server.address 0.0.0.0 --server.po
 - `config/mcp_servers.json`
 - `config/poc3_model_profiles.json`
 - `config/vpd_token_presets.json`
+- `config/hmm_demo_scenarios.json` — 화면에 표시할 데모 질문. 코드 수정 없이 이 파일만 변경한다.
+- `config/app_profile.json` — 제품명, 문구, 아이콘, 색상을 지정하는 제품 profile
 - `.env.sample`
 - `requirements.txt`
 - `requirements-langgraph.txt`
@@ -44,3 +48,14 @@ streamlit run apps/poc4/mcp_discovery_ui.py --server.address 0.0.0.0 --server.po
 - 실제 `.env`는 복사하지 않았습니다. `.env.sample`을 기준으로 새로 만드세요.
 - 실제 VPD 토큰 원문은 복사하지 않았습니다. `config/vpd_token_presets.json`의 `token` 값을 배포 환경에서 교체하세요.
 - 대화 DB `data/poc4_mcp_chat.sqlite3`는 개인정보/대화 내용이 포함될 수 있어 복사하지 않았습니다.
+
+## 구성 원칙
+
+- `config/`: 운영자가 바꿀 수 있는 MCP, 모델, 사용자 preset, 데모 질문 JSON
+- `src/poc4/`: Streamlit과 분리 가능한 화면 보조 모듈 및 도메인 로직
+- `apps/poc4/`: 레거시 호환 entrypoint. 화면 조립과 사용자 상호작용만 담당하도록 점진적으로 축소
+- `tests/`: 설정 파일과 순수 Python 모듈의 회귀 검증
+
+다른 프로젝트에 적용할 때는 scenario/MCP JSON만 교체하고, 제품명·설명·색상은
+`AGENT_CONSOLE_*` 환경변수로 지정합니다. 환경변수가 없을 때만 `config/app_profile.json`의
+중립 기본값을 사용합니다.