refs #741 #742: reorganize repository by application

docs/notes/hmm-brand-refresh.md

@@ -0,0 +1,28 @@
+# HMM 화면 전환
+
+대상 기업을 HMM으로 전환하면서 PoC4의 로그인·헤더 화면을 해운·물류 업무 에이전트로 재구성한다.
+
+- 공식 페이지의 `Connect Values Navigate Growth` 메시지와 해운·물류·디지털 솔루션 맥락을 반영한다.
+- 외부 KB 로고·전용 글꼴 의존성을 제거하고, 애플리케이션 내부 SVG 워드마크와 해양 청색 계열로 표시한다.
+- 기존 MCP, VPD, 데이터베이스 스키마 및 도구 계약은 변경하지 않는다.
+- 로그인 유지 기능은 서버 비밀키로 서명한 7일 만료 토큰을 사용하며, 로그아웃 시 즉시 폐기한다.
+- 공통 화면 CSS와 로그인/헤더 renderer는
+  `ai-web-agent-console/ai_web_agent_console/presentation.py`에서 관리한다.
+  HMM의 제품명·문구·색상은 `config/app_profile.json`에만 둔다.
+# HMM MCP runtime wiring
+
+The PoC4 MCP registry defaults to `hmm_hr_mcp` (`https://hmm-mcp.cloud-handson.com/mcp`).
+Its gateway credential is supplied only at runtime as `HMM_MCP_BEARER_TOKEN` in the
+deployed `.env`; it is intentionally not committed and is not the selected VPD user's token.
+
+## HMM demo user presets
+
+`config/vpd_token_presets.json` is retained as a legacy deployment filename, but its content is
+an HMM HR demo-user list. The Streamlit sidebar uses it to select a manager or team-member
+persona and resolves pronouns such as “내” and “우리 팀” in the test question. Each preset uses
+`mcp_token_env: HMM_MCP_BEARER_TOKEN`; the bearer value stays in `/opt/hmm-poc4/.env` and is
+never rendered, downloaded, or committed. The selector is a test context, not a claim of
+row-level authorization enforcement.
+
+The security-operation link in the Streamlit console points to
+`https://hmm-backoffice.cloud-handson.com/`, the HMM access-management backoffice.