feat(changelog): 房务订单列表类型改页签 + 小蒙马改团期 + 菜单改名同步
changelog-filename-gate / validate (push) Failing after 1s

三项联动的前端优化:
- 房务订单列表「类型」下拉改为页签(核心/定制/团期)
- 全局「小蒙马」文案改为「团期」(5处+注释)
- 菜单改名后同步前端页面标题(班期看板→出团管理、团期详情→出团详情)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot
2026-09-27 19:31:26 +08:00
共同撰写人 Claude Opus 5.5
父节点 ec2426eda7
当前提交 5c3421d8cd
@@ -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