feat(changelog): 房务订单列表类型改页签 + 小蒙马改团期 + 菜单改名同步
changelog-filename-gate / validate (push) Failing after 1s
changelog-filename-gate / validate (push) Failing after 1s
三项联动的前端优化: - 房务订单列表「类型」下拉改为页签(核心/定制/团期) - 全局「小蒙马」文案改为「团期」(5处+注释) - 菜单改名后同步前端页面标题(班期看板→出团管理、团期详情→出团详情) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
这个提交包含在:
@@ -0,0 +1,186 @@
|
||||
---
|
||||
schema: "hl-changelog/v2"
|
||||
ticket: "frontend"
|
||||
title: "房务订单列表「类型」改页签 + 「小蒙马」改「团期」文案 + 菜单改名后页面名同步"
|
||||
consumer: "admin"
|
||||
author: "wx(GIT)"
|
||||
change_type: "前端优化"
|
||||
backend_status: "not_required"
|
||||
gateway_status: "not_required"
|
||||
frontend_status: "pending"
|
||||
frontend_owner: "mmg"
|
||||
frontend_ref: ""
|
||||
target_release: ""
|
||||
verified_at: ""
|
||||
status_note: "后端菜单已改名,订单列表类型改页签样式,全局「小蒙马」改「团期」。三项改动独立但同步推送,涉修文件 8 处,涉改行 13 处。"
|
||||
updated_at: "2026-09-27"
|
||||
base: "dev-v3"
|
||||
---
|
||||
|
||||
# 前端优化:房务订单列表与全局文案同步(第二期菜单与业务定案对齐)
|
||||
|
||||
## ⚠️ 关键变化
|
||||
|
||||
三项联动改动,无依赖关系,可独立完成但应同步推送:
|
||||
|
||||
1. **房务管家 › 订单列表:「类型」下拉改为页签**
|
||||
- 改为三页签(核心 / 定制 / 团期),去掉「全部」选项,默认「核心」
|
||||
- 样式照 `src/views/finance/settlement/index.vue` 的「常规产品 / 团期产品」页签
|
||||
- 后端户级端点不收 GROUP,原「全部」只含核心+定制;GROUP 独走 `group-batches` 端点
|
||||
|
||||
2. **全局文案替换:「小蒙马」→「团期」**
|
||||
- 后端字典已改,走翻译的地方自动生效
|
||||
- 只有 5 处写死的文案需手改(共计 6 处命中点)
|
||||
|
||||
3. **菜单改名后的前端页面名同步**
|
||||
- 后端菜单改名,侧栏自动生效
|
||||
- 前端 4 处写死的页面标题同步改名
|
||||
|
||||
---
|
||||
|
||||
## 一、背景
|
||||
|
||||
wx 2026-09-27 确认三项协同改动,后端部分(菜单改名、字典值改动)已在测试服生效(PR #8450,#8444)。前端需消费这些变化以保持一致。
|
||||
|
||||
---
|
||||
|
||||
## 二、订单列表「类型」改为页签
|
||||
|
||||
### 现状(ref `gitea/v2.1` origin/v2.1)
|
||||
|
||||
**文件**:`src/views/housekeeper/orders/index.vue`
|
||||
|
||||
- **搜索区** `:33-44`:「类型」使用 `n-select` 下拉框,宽度 120px
|
||||
- **选项定义** 约 `:366-371`:
|
||||
```js
|
||||
const orderTabOptions = [
|
||||
{ value: 'all', label: '全部' },
|
||||
{ value: 'CORE', label: '核心' },
|
||||
{ value: 'CUSTOM', label: '定制' },
|
||||
{ value: 'GROUP', label: '团期' },
|
||||
]
|
||||
```
|
||||
|
||||
### 改动要点
|
||||
|
||||
#### 1. 样式改为页签,置于 ProTable toolbar 左侧
|
||||
- 参考文件:`src/views/finance/settlement/index.vue:58-66`
|
||||
- 结构:`<n-flex justify="space-between" class="table-summary">` 左侧放页签
|
||||
- 页签配置:`<n-tabs type="line" size="small" class="product-tabs">`
|
||||
- 样式(同文件 `:217` 附近):
|
||||
```less
|
||||
.product-tabs {
|
||||
width: 280px;
|
||||
}
|
||||
```
|
||||
|
||||
#### 2. 页签内容:**去掉「全部」,仅保留核心、定制、团期,默认核心**
|
||||
```vue
|
||||
<n-tabs type="line" size="small" class="product-tabs">
|
||||
<n-tab name="CORE">核心</n-tab>
|
||||
<n-tab name="CUSTOM">定制</n-tab>
|
||||
<n-tab name="GROUP">团期</n-tab>
|
||||
</n-tabs>
|
||||
```
|
||||
- 绑定到 `orderTab`(当前状态变量)
|
||||
- `@update:model-value="onOrderTabChange"` 仍调现有回调
|
||||
|
||||
#### 3. 端点行为不变
|
||||
- 核心、定制:`GET house-allocation/households`,带 `productType=CORE|CUSTOM`
|
||||
- 团期:`GET house-allocation/group-batches`(整团一行)
|
||||
- 切换页签重置状态桶(现有 `onOrderTabChange` 逻辑)
|
||||
|
||||
#### 4. 通知链接行为
|
||||
- `?groupBatchId=` 仍自动切到「团期」页签并精确定位
|
||||
- `?orderId=` 行为不变
|
||||
|
||||
#### 5. 页面注释同步
|
||||
- 约 `:298-308` 的注释,「类型下拉」描述同步改成「类型页签」
|
||||
|
||||
---
|
||||
|
||||
## 三、全局文案替换:「小蒙马」→「团期」
|
||||
|
||||
### 后端字典已改
|
||||
后端 PR #8450(HL-#8444)部署完毕,字典值修改:
|
||||
- `product_type/GROUP` label 为「团期」(原「小蒙马」)
|
||||
- `vehicle_type/GROUP` label 为「团期专用」(原「小蒙马」)
|
||||
- 走字典翻译的地方自动生效
|
||||
|
||||
### 前端需改的写死文案
|
||||
|
||||
| 文件 | 行号 | 改前 | 改后 |
|
||||
|------|------|------|------|
|
||||
| `src/views/grassland-guide/ProductPickerModal.vue` | 26 | placeholder="核心产品 / 小蒙马" | placeholder="核心产品 / 团期" |
|
||||
| `src/views/grassland-guide/ProductPickerModal.vue` | 132 | { label: '小蒙马', value: 'GROUP' } | { label: '团期', value: 'GROUP' } |
|
||||
| `src/views/housekeeper/_shared/constants.js` | 68 | GROUP: '小蒙马' | GROUP: '团期' |
|
||||
| `src/views/housekeeper/_shared/constants.js` | 71 | xmm: '小蒙马' | xmm: '团期' |
|
||||
| `src/views/order-v2/new/components/Step0Theme.vue` | 252 | GROUP: { label: '小蒙马', cls: ... | GROUP: { label: '团期', cls: ... |
|
||||
| `src/views/order-v2/new/components/Step0Theme.vue` | 258 | { key: 'GROUP', label: '小蒙马' } | { key: 'GROUP', label: '团期' } |
|
||||
| `src/views/product/batch/BatchEditModal.vue` | 195 | '小蒙马产品下单时需要...' | '团期产品下单时需要...' |
|
||||
| `src/views/product/edit/components/steps/BatchPricingStep.vue` | 348 | `<p class="bps-desc">小蒙马按班期招募...` | `<p class="bps-desc">团期按班期招募...` |
|
||||
|
||||
### 注释与类型定义
|
||||
- `src/views/order-v2/new/components/Step0Theme.vue:249` 的注释也需同步:
|
||||
```js
|
||||
// 改前:GROUP 小蒙马
|
||||
// 改后:GROUP 团期
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、菜单改名后的前端页面名同步
|
||||
|
||||
后端已改名的菜单及对应前端页面标题:
|
||||
|
||||
| 菜单变化 | 前端文件 | 改前 | 改后 |
|
||||
|---------|---------|------|------|
|
||||
| 订单管理v2 › 团期订单 → 出团管理 | `src/views/order-v2/batch/index.vue:3` | title="班期看板" | title="出团管理" |
|
||||
| 隐藏页:团期详情 → 出团详情 | `src/views/order-v2/batch/detail/index.vue:3` | title="团期详情" | title="出团详情" |
|
||||
| —— | `src/views/order-v2/detail/_shared/orderDetailActions.js:32` 文案 | "请到团期详情完成..." | "请到出团详情完成..." |
|
||||
| —— | `src/views/order-v2/detail/components/__tests__/BottomActionBar.spec.js:73` 测试断言 | '团期详情' | '出团详情' |
|
||||
| —— | `src/views/order-v2/detail/_shared/orderDetailActions.spec.js:73` 测试断言 | '团期详情' | '出团详情' |
|
||||
| 车务管理 › 团期配车 → 车务管理(已拍平) | `src/views/fleet/group-dispatch/index.vue` | —— | **无需改** |
|
||||
|
||||
#### 特别说明
|
||||
- **班期看板页面**改名为「出团管理」,与侧栏菜单「出团管理」保持同名
|
||||
- **团期详情页**改名为「出团详情」,同步更新引导文案与测试用例
|
||||
- **团期配车页面**无需改动,该页面路由与菜单一致,由后端动态挂载
|
||||
|
||||
---
|
||||
|
||||
## 五、验证检查清单
|
||||
|
||||
改完后逐项核对(无需部署,仅检查代码变更):
|
||||
|
||||
- [ ] 房务订单列表的「类型」改为三页签(核心 / 定制 / 团期),去掉「全部」
|
||||
- [ ] 页签默认「核心」,样式参考金融结算页
|
||||
- [ ] 5 处文案「小蒙马」改「团期」
|
||||
- [ ] 订单列表班期看板标题「班期看板」→「出团管理」
|
||||
- [ ] 团期详情页标题「团期详情」→「出团详情」
|
||||
- [ ] 团期确认引导文案同步改「出团详情」
|
||||
- [ ] 相关测试用例中的文案断言同步
|
||||
|
||||
---
|
||||
|
||||
## 六、不影响范围
|
||||
|
||||
- 后端接口零改动
|
||||
- 小程序、H5 不涉及
|
||||
- 团期详情页除标题外的其它区域不涉及
|
||||
- 房务配房列表的其它筛选条件不涉及
|
||||
|
||||
---
|
||||
|
||||
## 七、相关工单与文档
|
||||
|
||||
- 后端菜单改名:PR #8450(HL-#8444),已部署测试服
|
||||
- 字典值改动:同上 PR
|
||||
- 前端对接无新的接口契约变更
|
||||
|
||||
---
|
||||
|
||||
## 联系人
|
||||
|
||||
- **后端负责人**: @wx
|
||||
- **前端负责人**: @mmg
|
||||
在新工单中引用
屏蔽一个用户