feat: 累积功能变更 — 聊天集成、租户管理、小程序更新、ETL 增强、迁移脚本

包含多个会话的累积代码变更:
- backend: AI 聊天服务、触发器调度、认证增强、WebSocket、调度器最小间隔
- admin-web: ETL 状态页、任务管理、调度配置、登录优化
- miniprogram: 看板页面、聊天集成、UI 组件、导航更新
- etl: DWS 新任务(finance_area_daily/board_cache)、连接器增强
- tenant-admin: 项目初始化
- db: 19 个迁移脚本(etl_feiqiu 11 + zqyy_app 8)
- packages/shared: 枚举和工具函数更新
- tools: 数据库工具、报表生成、健康检查
- docs: PRD/架构/部署/合约文档更新

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Neo
2026-04-06 00:03:48 +08:00
parent 70324d8542
commit 6f8f12314f
515 changed files with 76604 additions and 7456 deletions

View File

@@ -19,7 +19,7 @@ apps/admin-web/
├── src/
│ ├── App.tsx # 主布局 + 路由配置 + 路由守卫
│ ├── main.tsx # 应用入口
│ ├── pages/ # 8 个功能页面
│ ├── pages/ # 18 个功能页面
│ │ ├── Login.tsx # 登录页
│ │ ├── TaskConfig.tsx # 任务配置Flow 选择 + 任务勾选 + 参数设置)
│ │ ├── TaskManager.tsx # 任务管理(队列 + 执行历史 + 实时日志)
@@ -27,13 +27,23 @@ apps/admin-web/
│ │ ├── DBViewer.tsx # 数据库查看器Schema/表/列浏览 + SQL 执行)
│ │ ├── LogViewer.tsx # 日志查看器
│ │ ├── EnvConfig.tsx # 环境配置管理
│ │ ── OpsPanel.tsx # 运维面板(服务启停 + Git + 系统监控)
│ │ ── OpsPanel.tsx # 运维面板(服务启停 + Git + 系统监控)
│ │ ├── TenantAdmins/ # 租户管理员管理2步创建 + 软删除 + 简写ID管理
│ │ ├── AIDashboard.tsx # AI 运行总览(统计卡片 + 趋势图 + 饼图 + 预算 + 告警)
│ │ ├── AITriggerJobs.tsx # AI 调度状态(分页表格 + 筛选 + 手动重跑)
│ │ ├── AIRunLogs.tsx # AI 调用明细(分页表格 + 详情抽屉)
│ │ ├── AIOperations.tsx # AI 手动操作(重跑 + 缓存失效 + 批量执行 + 告警管理)
│ │ ├── DevTrace.tsx # 开发调试全链路日志(覆盖率 + 筛选 + 请求列表 + Span 树 + 设置)
│ │ ├── TransferLog.tsx # P18 客户转移日志(分页表格 + 门店/时间/助教筛选 + guard_checks 标签)
│ │ ├── PendingReview.tsx # P18 待审核任务(分页表格 + 重新分配/关闭弹窗 + 转移历史抽屉)
│ │ ├── TaskEngineConfig.tsx # P18 参数管理(全局默认+门店覆盖 + 行内编辑 + 权重卡片编辑)
│ │ └── TriggerJobs.tsx # 定时任务管理biz.trigger_jobs 表展示 + 手动执行 + 清空任务)
│ ├── components/ # 可复用组件
│ │ ├── BusinessDayHint.tsx # 营业日提示组件
│ │ ├── DwdTableSelector.tsx # DWD 表选择器
│ │ ├── ErrorBoundary.tsx # 错误边界
│ │ ├── LogStream.tsx # 实时日志流组件
│ │ ├── ScheduleTab.tsx # 调度配置标签页
│ │ ├── ScheduleTab.tsx # 调度配置标签页(含最小运行间隔、强制执行、上次成功时间)
│ │ └── TaskSelector.tsx # 任务选择器
│ ├── api/ # API 调用层
│ │ ├── client.ts # Axios 实例baseURL + JWT 拦截器)
@@ -44,11 +54,17 @@ apps/admin-web/
│ │ ├── etlStatus.ts # ETL 状态 API
│ │ ├── dbViewer.ts # 数据库查看器 API
│ │ ├── envConfig.ts # 环境配置 API
│ │ ── opsPanel.ts # 运维面板 API
│ │ ── opsPanel.ts # 运维面板 API
│ │ ├── registry.ts # 注册体系 API租户/店铺/简写ID/同步)
│ │ ├── tenantAdmins.ts # 租户管理员 CRUD API
│ │ ├── adminAI.ts # AI 监控后台 APIDashboard/调度/调用/缓存/预算/批量/告警)
│ │ ├── devTrace.ts # DevTrace 全链路日志 API日期/请求/详情/清理/设置/覆盖率)
│ │ └── taskEngine.ts # P18 任务引擎运营看板 API转移日志/待审核/参数管理9 个函数)
│ ├── store/
│ │ ├── authStore.ts # Zustand 认证状态JWT 持久化 + hydrate
│ │ └── businessDayStore.ts # 营业日状态管理
── types/ # TypeScript 类型定义
── types/ # TypeScript 类型定义
│ │ └── devTrace.ts # DevTrace 类型TraceSpan/TraceRequest/TraceDetail/TraceSettings/TraceCoverage
├── index.html # HTML 入口
├── vite.config.ts # Vite 配置
├── tsconfig.json # TypeScript 配置
@@ -106,6 +122,84 @@ ETL 任务的核心配置界面:
- 依赖同步(`uv sync`
- 系统资源概况CPU、内存、磁盘
### 租户管理员管理 (`/tenant-admins`)
- 管理员列表(支持分页、关键词搜索、显示/隐藏已禁用记录)
- 2 步创建流程:第 1 步选择租户 + 输入账号信息 + 选择管辖门店;第 2 步可选设置简写ID
- 软删除管理员(二次确认 → `is_active=false`
- 编辑管理员(用户名可修改,需校验唯一性;所属租户只读)
- 简写ID 管理弹窗:展示租户下所有店铺及当前 code支持修改和查看变更历史
- 手动触发店铺同步(从 ETL 库同步最新店铺信息)
### AI 运行总览 (`/ai/dashboard`)
AI 模块运行状况一览:
- 顶部统计卡片今日调用次数、成功率、Token 消耗、平均延迟)
- 近 7 天趋势折线图(调用量 + 成功率)
- 各 App 调用占比饼图
- Token 预算使用进度条(日/月)
- 告警列表 + App 健康状态 + App 配置信息(只读)
- 支持门店筛选
### AI 调度状态 (`/ai/trigger-jobs`)
调度任务执行状态监控:
- 分页表格(事件类型、会员、状态、执行链、耗时)
- 筛选器event_type / status / site_id / 日期范围)
- 今日去重跳过数统计
- 操作列:查看详情、手动重跑(二次确认)
### AI 调用明细 (`/ai/run-logs`)
AI 调用记录追踪:
- 分页表格app_type、trigger_type、member_id、tokens、延迟、状态
- 筛选器app_type / status / trigger_type / site_id / 日期范围)
- 点击行展开详情抽屉(完整 prompt/response/error_message
### AI 手动操作 (`/ai/operations`)
AI 人工干预操作:
- 手动重跑App 选择 + 会员 + 门店 → 单次执行)
- 缓存失效(按 App / 会员 / 门店批量失效)
- 批量执行(成本二次确认流程:预估 → 确认弹窗 → 执行)
- 告警管理(告警列表 + 确认/忽略操作)
### 开发调试全链路日志 (`/dev-trace`)
后端请求全链路追踪日志的可视化查看与管理:
- 覆盖率状态栏:路由/Service/Job/SSE/WS 五维度进度条 + 未覆盖项列表
- 筛选栏日期、时间范围、trace_type、HTTP 方法、路径关键词、状态码、最小耗时、仅错误、Span 类型
- 请求列表:分页表格(时间/类型/方法/路径/状态/耗时/DB 查询数/错误标记)
- Span 链路树:选中请求后展示完整 span 树支持缩进层级、SQL 详情、参数、错误信息
- 设置抽屉:日志开关、记录 SQL/参数、保留天数、日志目录、手动清理日期范围
- 覆盖率扫描:手动触发 AST 扫描,检测追踪覆盖情况
对应后端模块 `apps/backend/app/trace/`,通过 8 个 admin API 端点(`/api/admin/dev-trace/*`)通信,需 admin 角色鉴权。
### 客户转移日志 (`/task-engine/transfer-log`)
P18 任务引擎运营看板 — 转移日志页面:
- 分页表格展示 `biz.coach_task_transfer_log` 记录
- 筛选器:门店 ID、日期范围RangePicker、助教 ID
- guard_checks JSON 渲染为彩色标签(通过/未通过)
- transfer_reason 映射中文标签(连续召回失败/人工重新分配/归属变更)
### 待审核任务 (`/task-engine/pending-review`)
P18 任务引擎运营看板 — 待审核任务页面:
- 分页表格展示 `status='pending_review'` 的任务
- 超级管理员操作列:重新分配(输入目标助教 ID、关闭填写原因
- 点击客户名打开转移历史抽屉
- 门店管理员只读(无操作列)
### 参数管理 (`/task-engine/config`)
P18 任务引擎运营看板 — 参数管理页面:
- 展示 `biz.cfg_task_generator_params` 全局默认 + 门店覆盖参数
- 行内编辑单个参数值
- 权重参数w_rs/w_ms/w_ml使用卡片编辑弹窗前端预校验三者之和 = 1.0
- 新增门店覆盖Select 选择参数名 + InputNumber 输入值)
- 删除门店覆盖(全局默认参数禁止删除)
- 超级管理员可编辑/新增/删除;门店管理员只读
### 定时任务管理 (`/trigger-jobs`)
`biz.trigger_jobs` 表中定时任务的管理页面:
- 表格展示所有定时任务名称、触发条件、Cron/间隔配置、状态、上次执行时间)
- 手动执行单个任务(二次确认)
- 清空所有任务Popconfirm 二次确认 + Modal 成功/失败反馈)
- 执行期间按钮 loading 状态防止重复操作
## 认证与路由守卫
- 所有功能页面通过 `PrivateRoute` 组件保护
@@ -162,3 +256,9 @@ ETL 任务的核心配置界面:
- [ ] 权限管理界面(角色/权限配置)
- [ ] 暗色主题支持
- [ ] 国际化i18n
- [x] 租户管理员 CRUD + 2 步创建 + 软删除NS4.1
- [x] 注册体系管理 — 简写ID 管理 + 店铺同步NS4.1
- [x] 调度任务最小运行间隔 + 强制执行P16
- [x] AI 监控后台 — Dashboard + 调度状态 + 调用明细 + 手动操作P15
- [x] 开发调试全链路日志 — DevTrace 页面 + 覆盖率扫描 + Span 树展示
- [x] P18 任务引擎运营看板 — 转移日志 + 待审核任务 + 参数管理3 页面 + 9 API