fix: Phase3 终审修复（env入库/通用配置组面板/锁屏通知摘除/记档修正）
- I-2: admin/.env（被根 .gitignore 误伤）删除，内容并入入库的 .env.development/.env.production（公共块两份都写，PORT 仅 dev） - I-1: 配置中心补 contact/engine/misc 三组通用 JSON 编辑面板 （JsonGroupPane：等宽 textarea 整组编辑 + JSON.parse 预检 + PUT 整组 + 重置出厂 + 顶部字段说明；挂进 GROUP_NAV 三入口）； 修组键缺失租户的禁存 bug（父层快照加载后挂载，空组可建组） - I-3: config_routes.py docstring 改「接线归 Phase 4」； CLAUDE.md Phase 4 清理单补 resolver 回退链与 email/push test 限流 - M-1: 锁屏摘除入口（用户菜单项删 + 全局组件 enabled:false） - M-2: 顶栏通知铃铛隐藏（headerBar notification.enabled:false） - M-5/M-8: admin/README 换三行指针（删模板 README.zh-CN.md）； quickLinks 删「登录」项 - M-3/M-4 不做记档入 Phase 4 清理单 - 测试基线：后端 pytest 595 / 前端 vitest 156（+3 通用 JSON 组） Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
@@ -106,7 +106,7 @@
|
||||
|
||||
## Phase 3 完成状态（2026-10-13 收尾核对）
|
||||
|
||||
**测试基线：后端 pytest 595 passed / 前端 vitest 153 passed**（Phase 3 起步 139，Task 9 平台设置页 +14；两端数字均已实跑核对，后端唯一 warning 仍为 starlette TestClient 弃用提示，无害）。`pnpm build`（vue-tsc --noEmit && vite build）零错误。后续回归以此为准。
|
||||
**测试基线：后端 pytest 595 passed / 前端 vitest 156 passed**（Phase 3 起步 139，Task 9 平台设置页 +14、终审修复通用 JSON 组 +3；两端数字均已实跑核对，后端唯一 warning 仍为 starlette TestClient 弃用提示，无害）。`pnpm build`（vue-tsc --noEmit && vite build）零错误。后续回归以此为准。
|
||||
|
||||
**交付形态**：`admin/` 子目录的 Vue3 + TS + Vite + Element Plus SPA（art-design-pro 模板，pnpm 管理），与后端同仓。本地起法：
|
||||
|
||||
@@ -120,7 +120,7 @@
|
||||
- 仪表盘：平台总览 + 租户卡片墙（超管）/ 我的指标（租户管理员），时间窗切换。
|
||||
- 租户管理（仅超管）：列表 / 创建向导（消费出厂档案）/ 详情编辑 / 站点与域名子资源 / 停用复启。
|
||||
- 会话与线索：列表（筛选 / 分页 / 租户切换）/ 详情消息流 / 推送日志 / 删除。
|
||||
- 配置中心：品牌（表单 / 本地简化预览 / 嵌入代码 / 头像上传）、提示词四件套与结构化词表、试金石面板、凭据（邮件 / 推送 / AI 表单 + SMTP 测试 + 推送探测）、版本历史（两版对比 / 回滚 / 组级重置出厂）。
|
||||
- 配置中心：品牌（表单 / 本地简化预览 / 嵌入代码 / 头像上传）、提示词四件套与结构化词表、试金石面板、凭据（邮件 / 推送 / AI 表单 + SMTP 测试 + 推送探测）、contact/engine/misc 三组通用 JSON 编辑（终审 I-1 补齐 spec §7.3 全组覆盖）、版本历史（两版对比 / 回滚 / 组级重置出厂）。
|
||||
- 统计分析：卡片 / 转化漏斗 / 按日趋势 / 意向·来源·站点·国家分布（ECharts）/ 推送健康表；时间与租户筛选（口径同 stats.py docstring 口径表）。
|
||||
- 平台设置（仅超管）：自由 KV 表的推荐键表单（ai.* / smtp.*，键名是前端约定）+ 存储总览表格；保存 = 逐键 PUT（只提交脏键）。**当前仅存储与展示——resolver 的平台默认回退链未接线（页头注记），引擎不读取这些值**；密钥键掩码哨兵交互与凭据页同款（清除 / 恢复保持）。
|
||||
|
||||
@@ -140,11 +140,16 @@
|
||||
- **TENANT_SOURCE=db 默认**（生产装配形态）；`file` 为冷备/本地调试回退。
|
||||
- **admin 域名反代区分**：`/api/platform/*` 前缀豁免租户 Host 解析——平台后台 API 可与租户聊天域名同源反代（按路径分流）或独立域名，两形态皆可；租户聊天面（`/`、`/static`、WS、`/api/public`、`/api/chat*`）仍严格按 Host 解析租户，未知 Host 404。
|
||||
- **ADMIN_PASSWORD 默认值警示**（终审 I-4）：lifespan 启动检测到 ADMIN_PASSWORD 仍是出厂默认（admin123）时打 WARNING 日志——生产部署必须设 ADMIN_PASSWORD 环境变量换掉，且超管首登立即改密（must_change_password 门强制）。
|
||||
- **Phase 4 清理单增补**（Phase 3 冒烟沉淀；Phase 3 清理单未结项 5/6/8/9/10 一并滚入）：
|
||||
- **Phase 4 清理单增补**（Phase 3 冒烟沉淀 + 终审记档；Phase 3 清理单未结项 5/6/8/9/10 一并滚入）：
|
||||
1. `components.d.ts` 构建行尾漂移（长期收口 = 生成物出库或 EOL 规范钩子，现阶段靠手工还原）。
|
||||
2. 推送探测 env 回退真址：租户 push URL 空槽时 `resolve_push_settings` 回退 env `PUSH_API_URL`（默认即真 UniService 生产址）——后台点「探测」会对真实服务发空批量 POST（`{"messages": []}`，按契约文档应为无操作，但属真实出站）。收口 = 部署设 stub 域或探测端点拒绝 env 回退 URL。
|
||||
3. 生产反代需规划 admin 域的头像/品牌公开端点：`/api/public/*` 按租户 Host 解析，admin 域直挂必 404——开发期靠 Vite Host 改写代理，生产要么同源反代改 Host（单租户形态）要么前端改用租户域名绝对 URL。
|
||||
4. `VITE_TENANT_PREVIEW_HOST` 单一预览域名：开发代理只指向一个租户 Host，切换租户时头像等公开资源预览不准（.env.development 已注记）。
|
||||
5. **resolver 平台默认回退链接入 platform_settings**（终审 I-3 记档）：平台设置当前仅存储与展示（admin 页头有注记），引擎不读取——回退链接线是 Phase 4 的功能项。
|
||||
6. **email/test 与 push/test 速率限制**（终审 I-3 记档）：两测试端点无限流，复用登录限流器模式收口。
|
||||
7. **锁屏功能已摘除入口**（终审 M-1）：用户菜单项删除 + 全局组件 enabled:false 不再挂载（AES 存 localStorage + 公开模板默认密钥，防御价值为零）；代码待 Phase 4 决定删否。
|
||||
8. **租户切换器 composable 收拢**（终审 M-3 不做记档）：仪表盘/会话/配置三页各自内联实现同一模式，收拢归后续。
|
||||
9. **ECharts 按需收窄**（终审 M-4 不做记档）：stats 的 charts.ts 全量注册，bundle 体积优化归后续。
|
||||
|
||||
## 文档索引
|
||||
|
||||
|
||||
Reference in New Issue
Block a user