merge: server architecture modularization

.env.example

@@ -151,6 +151,16 @@ H5_ADMIN_PASSWORD=change-me-admin
 # H5_LOCAL_LLM_API_KEY=ollama
 # H5_LOCAL_LLM_NAME=Local Ollama 7B
 H5_ACCESS_PASSWORD=change-me
+# Portal API 访问策略第一阶段仅支持 off / shadow；shadow 只记录差异，不改变放行结果。
+# MEMIND_PORTAL_ACCESS_POLICY_MODE=shadow
+# 同一访问策略差异在窗口内只记录一次，后续日志携带累计与抑制次数。
+# MEMIND_PORTAL_ACCESS_SHADOW_LOG_INTERVAL_MS=60000
+# Phase C 灰度执行必须同时开启总开关并精确列出策略组；默认全部关闭，不支持 all。
+# 可选组：legacy-page-data,page-data-public,plaza-optional-user
+# MEMIND_PORTAL_ACCESS_POLICY_ENFORCEMENT_ENABLED=0
+# MEMIND_PORTAL_ACCESS_POLICY_ENFORCE_GROUPS=
+# 紧急熔断优先级最高；设为 1 后所有策略组立即回到旧鉴权路径（重启 Portal 生效）。
+# MEMIND_PORTAL_ACCESS_POLICY_KILL_SWITCH=0
 
 # 计费（Phase 2，金额单位均为人民币分）
 # 默认按 Token 单价扣费；生产推荐开启成本模式（见 docs/h5-metering-gateway.md）
@@ -304,6 +314,10 @@ VITE_TKMIND_WORKING_DIR=/Users/john/PycharmProjects/tkmind
 
 # 【本地开发 — 复制到 .env 的默认值】
 MEMIND_RUNTIME_PROFILE=local
+# Portal 代码目录与持久化数据目录分离（例如从 git worktree 启动）时显式设置。
+# MindSpace/<userId>、users/ 与默认 data/mindspace 都以此目录为根；
+# 前端 dist/public 等代码静态资源仍从当前 runtime 目录读取。
+# MEMIND_PORTAL_H5_ROOT=/Users/john/Project/Memind
 # MINDSPACE_STORAGE_ROOT 留空即可，自动使用 <repo>/data/mindspace
 
 # 【本机 split-service 联调 — 需要独立 MindSpace LaunchAgent 已启动】