refs #699: configure HMM demo users and OCI runtime

poc4_active_source_20260714/SOURCE_README.md

@@ -15,7 +15,9 @@ streamlit run apps/poc4/mcp_discovery_ui.py --server.address 0.0.0.0 --server.po
 
 - Python 3.11 이상을 사용합니다.
 - 이 개발 서버의 기본 `python3`가 3.6 계열이면 문법 검증이 실패합니다.
-- 배포 서버 검증 런타임: `/home/opc/poc_4/.python-runtime/cpython-3.11.15+20260610/bin/python3.11`
+- 배포 서버는 `/opt/hmm-poc4/.venv`와 Python 3.11을 사용합니다.
+- OCI Generative AI SDK 인증은 배포 서버의 `/home/opc/.oci/config` `DEFAULT` profile을 사용합니다.
+  private key와 compartment OCID는 Git에 저장하지 않고 서버의 `~/.oci`와 `.env`에서만 관리합니다.
 
 ## Deployment DB reference
 
@@ -46,12 +48,14 @@ streamlit run apps/poc4/mcp_discovery_ui.py --server.address 0.0.0.0 --server.po
 ## Security note
 
 - 실제 `.env`는 복사하지 않았습니다. `.env.sample`을 기준으로 새로 만드세요.
-- 실제 VPD 토큰 원문은 복사하지 않았습니다. `config/vpd_token_presets.json`의 `token` 값을 배포 환경에서 교체하세요.
+- `config/vpd_token_presets.json`은 파일명 호환성을 유지한 HMM **데모 사용자** 목록입니다.
+  사용자별 `mcp_token_env`는 배포 환경의 `HMM_MCP_BEARER_TOKEN`만 참조하며, token 원문은 JSON·Git에 저장하지 않습니다.
 - 대화 DB `data/poc4_mcp_chat.sqlite3`는 개인정보/대화 내용이 포함될 수 있어 복사하지 않았습니다.
+- MCP 호출 상세의 JSON/code 영역은 공통 presentation CSS에서 밝은 배경과 어두운 글자를 함께 지정합니다.
 
 ## 구성 원칙
 
-- `config/`: 운영자가 바꿀 수 있는 MCP, 모델, 사용자 preset, 데모 질문 JSON
+- `config/`: 운영자가 바꿀 수 있는 MCP, 모델, HMM 데모 사용자 preset, 데모 질문 JSON
 - `src/poc4/`: Streamlit과 분리 가능한 화면 보조 모듈 및 도메인 로직
 - `apps/poc4/`: 레거시 호환 entrypoint. 화면 조립과 사용자 상호작용만 담당하도록 점진적으로 축소
 - `tests/`: 설정 파일과 순수 Python 모듈의 회귀 검증