# 2026-07-29 系统更新说明

> 日期：2026-07-29  
> 分支：master  
> 说明：本次为 V2.0.1 后续补丁，涵盖入职填报、小程序包体、退卡导出、大项目看板及金三角业绩等优化。

---

## 建议标题

2026年7月29日系统更新（V2.0.1 补丁）

## 建议类型

功能更新 / 优化修复（Type = 1）

---

## 新增功能

### 1. 微信小程序版本更新提示

- 启动时通过官方 `UpdateManager` 检测新版本
- 有新版本时弹窗提示用户重启小程序

### 2. 金三角业绩绑定兜底（后端）

- 新增 `GoldTriangleBindingHelper`：耗卡/开单/退卡业绩入库时，若客户端未带金三角 ID，按「健康师 + 业绩月份」从 `lq_jinsanjiao_user` 自动补齐
- 解决客户端异步取绑定失败导致金三角业绩少算的问题

---

## 优化与修复

### 1. 扫码入职资料填报（H5 / 小程序）

- **移除「入职/用工」填报区块**：申请入职日期、组织、门店、司龄预览等不再由新员工填写
- 组织、门店、入职日期改由**人事审核通过时**在管理端填写
- 新增「身份证地址」必填项，前后端统一完整地址校验（含区/县/镇/街/路/号等关键字）
- 文化程度改为选填；页面副标题提示用工信息由人事审核填写
- 修复 H5 刷新仍显示旧版表单的问题（需重新构建 `unpackage/dist/build/web`）

### 2. 小程序代码包瘦身

- 主包静态资源 `static/me`、`static/rank` 迁移至 `pagesA/static/`
- 新建 **pagesB 分包**，迁移看板/报表类页面（战略决策、日报、工资查询等）
- 精简 `pagesA` 分包 iconfont（仅保留 woff2），缓解分包 2MB 超限
- 修复 `page-route.js` 路径兼容（旧 `/pagesA/...` 自动映射到 `/pagesB/...`）

### 3. 会员退卡明细导出

- 导出与列表共用 `buildQueryParams()`，筛选条件一致
- 修复筛选退卡时间后导出仅 1～2 条的问题（`tksj` 日期范围需 `join` 为逗号串）

### 4. 客户资料导出

- 抽取 `buildExportQuery()`，客户资料导出与会员品项导出共用筛选参数转换逻辑
- 沉睡天数、剩余权益范围等筛选在导出时与列表保持一致

### 5. 大项目部战略决策看板

- 「医美客户分层」暗黑模式样式适配
- 显示名统一走 `$catName`（如医美 → DXM）；老客/新客及业态标签同步替换

### 6. 短信发送日志

- 时间列由毫秒时间戳格式化为 `YYYY-MM-DD HH:mm:ss`

### 7. 项目资料（lq_xmzl）

- 列表/导出/表单移除「汇总·板块(fl1)」「汇总·业态(fl2)」「统计品项类(fl4)」字段，保留工资业绩类等核心分类

### 8. 手机端耗卡（member-consume）

- 编辑耗卡时按单据耗卡日期回填金三角绑定月份
- 提交前统一 `ensureJsjIdsResolved()`，防止金三角 ID 漏挂

---

## 部署说明

| 端 | 操作 |
|---|---|
| 后端 | 重新发布 `netcore` |
| 管理后台 | `cd antis-ncc-admin && npm run build` 或 `npm run build:with-h5` |
| uni-app H5 | HBuilderX 发行 Web，或 `npm run build:with-h5`（需 HBuilderX CLI） |
| 微信小程序 | HBuilderX 发行到微信小程序并上传 |

> `localhost:3000/h5` 开发环境读取的是 `绿纤uni-app/unpackage/dist/build/web`，修改 uni-app 源码后须重新构建 H5，普通浏览器刷新不会自动编译。

---

## 纯文本版（发布到系统更新说明时用）

```text
新增功能
1. 微信小程序版本更新提示：有新版本时提示重启
2. 金三角业绩绑定兜底：耗卡/开单/退卡入库自动补齐金三角 ID

优化与修复
1. 扫码入职：移除入职/用工填报，组织门店入职日期改人事审核填写；身份证地址校验增强
2. 小程序包体瘦身：pagesB 分包、静态资源迁移、iconfont 精简
3. 会员退卡导出：修复时间筛选后导出不完整
4. 客户资料导出：筛选条件与列表一致
5. 大项目看板：DXM 客户分层暗黑适配与显示名替换
6. 短信发送日志：时间格式化
7. 项目资料：精简分类字段
8. 手机端耗卡：金三角绑定月份与提交前补齐
```