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

@@ -0,0 +1,57 @@
# P9→NS1/RNS1 缺失项 #3消费记录 3 种类型的图标/颜色/标签样式映射
## 简要结论
- 状态:⚠️ 部分解决
- 风险等级:🔴 高
- 台桌消费和商城消费有颜色区分(蓝色/绿色 header + 圆点),但充值类型在客户详情页 wxml 中缺少渲染模板;设计规范文档中无消费记录类型的视觉映射定义。
## 详细审查
### 审查范围
- `apps/backend/app/schemas/xcx_customers.py``ConsumptionRecord.type` 字段
- `apps/backend/app/services/customer_service.py``_build_consumption_records()` 实现
- `apps/miniprogram/miniprogram/pages/customer-detail/customer-detail.wxml` — 消费记录展示
- `apps/miniprogram/miniprogram/pages/customer-detail/customer-detail.wxss` — 消费记录样式
- `docs/miniprogram-dev/design-system/` — 设计规范文档
### 发现
1. **后端type 字段已定义但实际只返回 "table"**
- Schema 定义 `type: str # table / shop / recharge`
- `_build_consumption_records()` 硬编码 `"type": "table"`,未根据实际数据区分商城/充值类型
- 前端 TypeScript 接口定义了 `type: "table" | "shop" | "recharge"` 三种类型
2. **前端:台桌和商城有视觉区分,充值缺失**
- 台桌消费(`type === 'table'`):蓝色 header`record-header-blue`+ 蓝色圆点(`record-dot-blue`
- 商城消费(`type === 'shop'`):绿色 header`record-header-green`+ 绿色圆点(`record-dot-green`
- 充值(`type === 'recharge'`**wxml 中无对应的渲染模板**`wx:elif` 链中缺少 recharge 分支)
- Mock 数据中有 `{ type: 'recharge', rechargeAmount: 0 }` 但无对应 UI
3. **设计规范文档中无消费记录类型映射**
- `VI-DESIGN-SYSTEM.md``DISPLAY-STANDARDS.md` 中未定义消费记录类型的图标/颜色/标签映射
- 无统一的类型→视觉映射表
### 证据
后端硬编码 type 为 "table"
```python
result.append({
"type": "table", # 始终为 table未区分 shop/recharge
...
})
```
前端 wxml 缺少 recharge 分支:
```html
<view class="record-card" wx:if="{{item.type === 'table'}}">...</view>
<view class="record-card" wx:elif="{{item.type === 'shop'}}">...</view>
<!-- 缺少 wx:elif="{{item.type === 'recharge'}}" -->
```
### 建议(如未完全解决)
1. **后端**`_build_consumption_records()` 根据结算单类型字段区分 table/shop/recharge
2. **前端**:添加 recharge 类型的渲染模板(建议橙色/金色 header充值图标
3. **设计规范**:在 `VI-DESIGN-SYSTEM.md` 中添加消费记录类型映射表:
- 台桌消费:🎱 蓝色(`#3b82f6`
- 商城消费:🛒 绿色(`#22c55e`
- 充值:💰 橙色/金色(`#f59e0b`