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,73 @@
# P10-NS4-08管理后台的国际化预留
## 简要结论
- 状态:✅ 已解决
- Ant Design 组件已配置 `zhCN` locale项目无国际化框架需求中文硬编码符合项目规范当前方案合理。
## 详细审查
### 前端代码
#### 1. Ant Design ConfigProvider locale 配置
`apps/tenant-admin/src/main.tsx` 已在根节点配置 Ant Design 中文 locale
```tsx
import { ConfigProvider } from "antd";
import zhCN from "antd/locale/zh_CN";
<ConfigProvider locale={zhCN}>
<App />
</ConfigProvider>
```
这确保了 Table 空状态文案、DatePicker 日期选择器、Pagination 分页器、Modal 确认/取消按钮等所有 Ant Design 内置组件均显示中文。
`apps/admin-web/src/main.tsx` 采用完全相同的配置方式,两个管理后台保持一致。
#### 2. i18n 框架依赖
`apps/tenant-admin/package.json``apps/admin-web/package.json` 均未引入任何 i18n 框架(如 `react-intl``i18next``react-i18next` 等)。
全局搜索 `i18n``intl``useIntl``formatMessage``i18next``react-intl` 关键词,两个项目中均无 i18n 框架使用痕迹。`locale` 关键词仅出现在 Ant Design ConfigProvider 配置和 `toLocaleString()` 日期格式化调用中。
#### 3. 中文硬编码情况
tenant-admin 所有页面中的 UI 文案均为中文硬编码,包括:
- 导航菜单:`"用户审核"``"用户管理"``"Excel 上传"``"维客线索管理"`
- 表格列标题:`"昵称"``"手机号"``"状态"`
- 操作按钮:`"审核"``"编辑"``"绑定"``"删除"``"登录"`
- 表单标签:`"请输入用户名"``"请输入密码"``"请选择角色"`
- 提示消息:`"审核通过成功"``"用户名或密码错误"``"账号已被禁用"`
- 状态标签:`"待审核"``"已通过"``"已拒绝"`
admin-web 同样采用中文硬编码方式,两个项目风格一致。
#### 4. 与 admin-web 的对比
| 维度 | tenant-admin | admin-web |
|------|-------------|-----------|
| ConfigProvider zhCN | ✅ 已配置 | ✅ 已配置 |
| i18n 框架 | 无 | 无 |
| UI 文案方式 | 中文硬编码 | 中文硬编码 |
| 日期格式化 | dayjs 依赖已安装 | `toLocaleString('zh-CN')` |
两个管理后台在国际化处理上完全一致。
### 差距分析
P10 标杆文件(`docs/prd/specs/P10-tenant-admin-web.md`)中没有独立的"国际化"章节,也未提出任何多语言支持要求。标杆文件明确定义的用户群体是"租户管理员",即国内台球门店的管理人员。
结合项目 steering 规则:
- `language-zh.md`:说明性文字一律简体中文
- `project-overview.md`:领域语言中文,货币 CNY
项目定位为面向国内台球门店的垂直业务系统,目标用户群体单一(国内门店管理员),不存在多语言需求场景。
### 建议
当前方案已满足项目需求,无需额外改动:
1. Ant Design `ConfigProvider locale={zhCN}` 已正确配置,组件内置文案为中文 — **已完成**
2. 无需引入 i18n 框架 — 项目面向国内市场,中文硬编码是合理选择,引入 i18n 框架反而增加不必要的复杂度
3. 如未来确有国际化需求(概率极低),可后续引入 `react-intl``i18next`,将硬编码文案提取为 message key改动范围可控