feat(admin): v3.5.12 大屏BGM、中文展示、分类删除修复与侧栏顺序
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -31,6 +31,7 @@
|
||||
| 3.5.9 | 08-25 | 门店累计核销好客权益;HQ 表格去省略号;序号列 + 列设置 + 拖表头改列宽;用户备注 / 手机号不脱敏 | [`v3.5.9`](./杜康好客-v3.5.9-开发文档.md) |
|
||||
| 3.5.10 | 08-25 | C 端门店详情去掉分享按钮;同城送提示改承运商 HTML;小程序客服接通企微微信客服 | [`v3.5.10`](./杜康好客-v3.5.10-开发文档.md) |
|
||||
| 3.5.11 | 08-26 | 城市三种履约起购;企微通知补提交人/规格物流/核销用户;结算任务失败通知 + 提现通过/四账单 | [`v3.5.11`](./杜康好客-v3.5.11-开发文档.md) |
|
||||
| 3.5.12 | 08-26 | 发布会订单大屏循环 BGM;HQ 日志/订单状态流转/用户行为时间线展示中文;修复删除门店分类被默认树回种;HQ 侧栏顺序(业务前 11 项,系统设置置底) | [`v3.5.12`](./杜康好客-v3.5.12-开发文档.md) |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -66,9 +66,11 @@
|
||||
| 3.5.9 | [`门店累计核销 + HQ 去截断 + 列设置`](./杜康好客-v3.5.9-开发文档.md) | 🔶 开发完成 |
|
||||
| 3.5.10 | [`门店详情去分享按钮 + 同城提示改承运商 HTML + 小程序客服接企微`](./杜康好客-v3.5.10-开发文档.md) | 🔶 开发完成 |
|
||||
| 3.5.11 | [`城市履约起购 + 企微通知字段与结算通知`](./杜康好客-v3.5.11-开发文档.md) | 🔶 开发完成 |
|
||||
| 3.5.12 | [`订单大屏 BGM + HQ 中文展示 + 修复删除门店分类 + HQ 侧栏顺序`](./杜康好客-v3.5.12-开发文档.md) | 🔶 开发完成 |
|
||||
|
||||
| 日期 | 说明 |
|
||||
|------|------|
|
||||
| 2026-08-26 | v3.5.12:订单大屏循环 BGM;HQ 日志/订单状态流转/用户行为时间线英文码改中文;修复删除门店分类后被 `ensureDefaults` 回种;HQ 侧栏按业务前 11 项重排、系统设置置底 |
|
||||
| 2026-08-26 | v3.5.11:城市三种履约起购;企微补提交人/订单规格物流收货/核销用户;`alert.settlement` 改名「结算任务失败通知」归入系统监控;补提现通过与四账单 |
|
||||
| 2026-08-25 | v3.5.10:门店详情去掉分享按钮;同城送提示改承运商 HTML(`GET /catalog/local-deliveries`);小程序客服接通企微(需填 CorpID) |
|
||||
| 2026-08-25 | v3.5.9:门店列表累计核销好客权益;HQ 表格去省略号;主列表序号 + 列设置/列宽存 HQ 账号;用户列表备注(不改昵称)、手机号不脱敏;订单列表状态可多选 |
|
||||
|
||||
@@ -0,0 +1,104 @@
|
||||
# 杜康好客 · v3.5.12 开发文档
|
||||
|
||||
> **2026-08-26** · admin-web / API
|
||||
> **主题**:发布会订单大屏循环 BGM;HQ 日志 / 订单状态流转 / 用户行为时间线展示中文;修复删除门店分类被默认树回种;HQ 侧栏菜单顺序
|
||||
|
||||
---
|
||||
|
||||
## 1. 版本目标
|
||||
|
||||
1. 订单大屏内置杜康 BGM,循环播放。
|
||||
2. 右上角提供「播放 BGM / BGM 播放中」开关(浏览器禁止自动出声,需用户点击)。
|
||||
3. 新成交撒花音效响起时,BGM 自动压低,特效结束后恢复。
|
||||
4. HQ 日志、订单详情「状态流转」、用户详情「行为时间线」中的英文码全部改为中文展示。
|
||||
5. 修复 HQ 删除门店分类:接口成功后列表不再自动补种默认树,分类真正消失(有门店占用则停用并明确提示)。
|
||||
6. HQ 左侧导航按业务优先重排:前 11 项固定,系统设置置底。
|
||||
|
||||
**不做**:C 端 / 门店 / 合伙人音频;OSS 签名直链(会过期);成交音效替换;改库内存储码(筛选仍可用事件编码);改权限 key。
|
||||
|
||||
---
|
||||
|
||||
## 2. 规则
|
||||
|
||||
### 2.1 大屏 BGM
|
||||
|
||||
- 音频文件随 `admin-web` 打包:`apps/admin-web/src/assets/big-screen/dukang-bgm.mp3`(约 2MB)。
|
||||
- BGM 与成交音效分两个 `Audio` 实例,互不打断。
|
||||
- 离开大屏页立即暂停 BGM。
|
||||
|
||||
### 2.2 英文码展示中文
|
||||
|
||||
只改 HQ 展示,不改 API 字段值。对照表在 `apps/admin-web/src/lib/display-labels.ts`。
|
||||
|
||||
| 页面 | 原英文 | 展示 |
|
||||
|------|--------|------|
|
||||
| 日志(用户/门店/合伙人/HQ/第三方/领域事件/企微机器人) | `pay_success`、`USER_MINI`、`ORDER`、`WECHAT_PAY`、`SUCCESS`、`order.read` 等 | 支付成功、C 端小程序、订单、微信支付、成功、查询订单 |
|
||||
| 订单详情 · 状态流转 | `WECHAT_PAY`、`PARTNER_PROXY`、`SYSTEM_AUTO_EXPIRE`;备注里的 `deliveryMode=LOCAL` | 微信支付、合伙人代下单、系统·超时取消;履约方式=同城 |
|
||||
| 用户详情 · 行为时间线 | 分类 `pay`、事件 `pay_success`、端 `USER_H5` | 支付、支付成功、C 端 H5 |
|
||||
|
||||
未知码仍原文回退,避免丢信息。列表筛选项「事件编码 / 对象编码」仍按存储码查询。
|
||||
|
||||
### 2.3 删除门店分类
|
||||
|
||||
根因:`GET /admin/store-categories`(以及 C 端/合伙人分类列表)默认 `ensureDefaults()`。删除无门店占用的默认分类(如「火锅」)后刷新列表会按编码把行再 insert 回来,前端却提示「已处理」。
|
||||
|
||||
规则:
|
||||
|
||||
- 列表接口 **不再自动补种**;缺省分类只通过 seed 或 HQ「同步默认分类」补齐。
|
||||
- 无门店占用:硬删除,提示「已删除」。
|
||||
- 有门店占用:改为停用,提示「该分类已有门店占用,已改为停用」。
|
||||
- 仍有下级:拒绝删除(「请先删除或停用下级分类」)。
|
||||
|
||||
### 2.4 HQ 侧栏顺序
|
||||
|
||||
仅改 `apps/admin-web/src/layouts/AdminLayout.tsx` 的 `MENU_ITEMS` 展示顺序与「发票」文案;路由、权限 key 不变。无权限项仍按原规则隐藏。
|
||||
|
||||
固定前 11 项:概览 → 用户 → 商品 → 订单 → 开城 → 门店 → 财务 → 好客权益 → 配送单 → 工单 → 发票。
|
||||
其余:推广码 → 微信绑定 → 企微机器人 → 语言模型 → 知识库 → 开发计划 → OSS 资源库 → 日志 → 权限分配 → HQ账户 → 白名单管理。
|
||||
最后一项:系统设置。
|
||||
|
||||
侧栏「发票」对应原「发票管理」入口(`/invoices`),页内标题仍为发票管理。
|
||||
|
||||
---
|
||||
|
||||
## 3. 关键路径
|
||||
|
||||
| 域 | 路径 |
|
||||
|----|------|
|
||||
| 大屏页 | `apps/admin-web/src/pages/BigScreenPage.tsx` |
|
||||
| 样式 | `apps/admin-web/src/admin.css` |
|
||||
| 音频 | `apps/admin-web/src/assets/big-screen/dukang-bgm.mp3` |
|
||||
| 中文对照 | `apps/admin-web/src/lib/display-labels.ts` |
|
||||
| 日志页 | `UserLogsPage` / `StoreLogsPage` / `PartnerLogsPage` / `HqLogsPage` / `ThirdPartyLogsPage` / `DomainEventsPage` / `WecomBotLogsPage` |
|
||||
| 订单详情 | `OrdersPage.tsx` 状态流转表 |
|
||||
| 用户详情 | `UsersPage.tsx` 行为时间线 |
|
||||
| 门店分类删除 | `store-category.service.ts` · `admin-store-categories.controller.ts` · `StoreCategoriesPage.tsx` |
|
||||
| HQ 侧栏顺序 | `apps/admin-web/src/layouts/AdminLayout.tsx` |
|
||||
|
||||
---
|
||||
|
||||
## 4. 发版步骤
|
||||
|
||||
| 步骤 | 动作 |
|
||||
|------|------|
|
||||
| 1 | `pnpm --filter @dukang/admin-web build` |
|
||||
| 2 | 发 `admin-web` 静态资源 + `dukang-api`(分类删除修复) |
|
||||
|
||||
无 Prisma 迁移。
|
||||
|
||||
---
|
||||
|
||||
## 5. 验收清单
|
||||
|
||||
- [ ] 打开 `/orders/big-screen`,右上角可见「播放 BGM」
|
||||
- [ ] 点击后循环播放背景音乐,按钮变为「BGM 播放中」;再点暂停
|
||||
- [ ] 新成交撒花时成交音效清晰,BGM 变轻;特效结束后 BGM 恢复
|
||||
- [ ] 离开大屏后背景音乐停止
|
||||
- [ ] 日志列表「事件 / 端 / 关联 / 渠道 / 状态」为中文,详情抽屉字段名不为 `param1` / `eventName`
|
||||
- [ ] 订单详情「状态流转」操作人为中文,备注中的履约方式为中文
|
||||
- [ ] 用户详情「行为时间线」分类、事件、端为中文
|
||||
- [ ] 删除无门店占用的分类后列表不再出现该行,提示「已删除」(再点「同步默认分类」才会补回默认项)
|
||||
- [ ] 删除有门店占用的分类:行仍在但状态为停用,提示「已有门店占用,已改为停用」
|
||||
- [ ] 有下级的一级分类删除被拒绝,提示先处理下级
|
||||
- [ ] HQ 侧栏前 11 项为:概览、用户、商品、订单、开城、门店、财务、好客权益、配送单、工单、发票
|
||||
- [ ] 系统设置在侧栏最后一项
|
||||
@@ -49,6 +49,8 @@ C 端购酒核销 · 门店扫码核销+打款 · 合伙人拓店履约 · WebAd
|
||||
|
||||
**起购(v3.5.11)**:现场提货 / 同城 / 跨城阈值在城市 `pickup_min_qty` / `local_min_qty` / `cross_min_qty`(瓶当量)。承运商「起送瓶数」只用于物流计价,不拦下单。
|
||||
|
||||
**订单大屏(v3.5.12)**:循环 BGM;右上角「播放 BGM」开关(需点击才出声);成交撒花时压低背景音。HQ 日志 / 订单状态流转 / 用户行为时间线展示中文(存储码不变)。删除门店分类后列表不再自动补种默认树(「同步默认分类」才补)。HQ 侧栏:概览→用户→商品→订单→开城→门店→财务→好客权益→配送单→工单→发票,其余运营/工具项随后,**系统设置最后**。
|
||||
|
||||
## 5. 验收用例(必过)
|
||||
|
||||
**主链路 15 项**:登录、4 SKU、起购、支付+权益、双通道核销、payout、关店不可见、拓店审核、配送完成、退款、T+1/T+30…
|
||||
|
||||
Reference in New Issue
Block a user