chore: docs update + docker-compose + H5 login

2026-07-09 13:46:48 +08:00
parent db70a3a6a8
commit 3d152fc8eb
5 changed files with 48 additions and 5 deletions
@@ -1071,6 +1071,30 @@ ALTER TABLE agents ADD COLUMN mfa_bound_at TIMESTAMP;

 **开发周期**：4-6周

+#### 管理后台日志体系（贯穿各阶段，2026-07-09 增补）
+
+> **为什么单列**：管理后台长期存在 5 类「日志」机制概念混淆（配置变更历史 / 安全审计日志 / 自动化动作日志 / 运行期结构化日志 / 会话消息记录）。本小节统一定义与边界，支撑阶段四「日志标准」，并将用户 2026-07-09 拍板的 5 项决策纳入 PRD。详细定义、接口、字段、验收标准见 `docs/04-功能设计/系统日志与审计日志-产品与设计.md`。
+
+**五类日志定位**：
+
+| 编号 | 名称 | 落点 | 核心用途 | 实现状态 |
+|------|------|------|----------|----------|
+| A | 配置变更历史（系统日志） | `config_change_logs` | 配置项前后值 diff | 已实现（前端无筛选） |
+| B | 安全审计日志（操作日志） | `audit_logs` | 安全行为事件 | 已实现（部分事件待补） |
+| C | 自动化动作日志 | `auto_action_logs` | 外部系统调用出入参 | 已实现（落表为主） |
+| D | 运行期结构化日志 | stdout → Docker 文件 | 应用运行排障 | 后端已实现，查看页未落地 |
+| E | 会话 / 消息记录 | `conversations` / `messages` | 业务主数据 | 已实现 |
+
+**用户已拍板 5 项决策（2026-07-09，宋献）**：
+
+| # | 决策 | 优先级 | 验收要点 |
+|---|------|--------|----------|
+| 1 | 侧边栏「系统日志」区分命名：配置变更历史（A） vs 安全审计日志（B） | P1 | 两个独立清晰入口，无「系统日志」歧义统称 |
+| 2 | 配置变更维持 A+B 双写，不收敛 | P0 | `PUT /api/admin/configs/{key}` 同时写两表（`config_change` 事件） |
+| 3 | A 页补充「配置键 / 操作人 / 时间」筛选（后端 `GET /api/admin/system-logs` 加参） | P1 | 三筛选可用，后端参数支持 |
+| 4 | D 运行期日志查看：按级别 / 时间筛选 + 下载（权限 admin） | P0 | 页面 + 后端接口落地（`.txt` / `.log`） |
+| 5 | 补《系统日志/审计日志 产品+设计文档》，并入 PRD/架构、列项目任务 | — | 本文档即交付，看板登记 #101–#104 |
+
 #### 阶段五：自动/辅助审核、开单、结单

 > **本阶段解决痛点**：多系统切换效率问题（延伸痛点4/5，进一步提升人效）。