diff --git a/changelogs-v2/2026-09/27_frontend_房务订单列表类型页签改造-小蒙马改团期全局文案-菜单改名同步-前端优化-管理后台.md b/changelogs-v2/2026-09/27_frontend_房务订单列表类型页签改造-小蒙马改团期全局文案-菜单改名同步-前端优化-管理后台.md new file mode 100644 index 00000000..8e0b6faf --- /dev/null +++ b/changelogs-v2/2026-09/27_frontend_房务订单列表类型页签改造-小蒙马改团期全局文案-菜单改名同步-前端优化-管理后台.md @@ -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` + - 结构:`` 左侧放页签 + - 页签配置:`` + - 样式(同文件 `:217` 附近): + ```less + .product-tabs { + width: 280px; + } + ``` + +#### 2. 页签内容:**去掉「全部」,仅保留核心、定制、团期,默认核心** + ```vue + + 核心 + 定制 + 团期 + + ``` + - 绑定到 `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 | `

小蒙马按班期招募...` | `

团期按班期招募...` | + +### 注释与类型定义 +- `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