diff --git a/changelogs-v2/2026-09/27_frontend_房务订单列表类型页签改造-小蒙马改团期全局文案-菜单改名同步-前端优化-管理后台.md b/changelogs-v2/2026-09/27_frontend_房务订单列表类型页签改造-小蒙马改团期全局文案-菜单改名同步-前端优化-管理后台.md index 8e0b6faf..1a26034f 100644 --- a/changelogs-v2/2026-09/27_frontend_房务订单列表类型页签改造-小蒙马改团期全局文案-菜单改名同步-前端优化-管理后台.md +++ b/changelogs-v2/2026-09/27_frontend_房务订单列表类型页签改造-小蒙马改团期全局文案-菜单改名同步-前端优化-管理后台.md @@ -12,7 +12,7 @@ frontend_owner: "mmg" frontend_ref: "" target_release: "" verified_at: "" -status_note: "后端菜单已改名，订单列表类型改页签样式，全局「小蒙马」改「团期」。三项改动独立但同步推送，涉修文件 8 处，涉改行 13 处。" +status_note: "后端菜单改名与字典改名已在测试服生效。前端三项改动互不依赖：房务订单列表「类型」改页签、写死的「小蒙马」改「团期」、出团管理/出团详情页面名同步。2026-09-27 订正：写死文案 5 个文件 8 处、菜单名同步补「返回班期看板」按钮与 spec 路径、页签绑定改 @update:value。" updated_at: "2026-09-27" base: "dev-v3" --- @@ -25,16 +25,16 @@ base: "dev-v3" 1. **房务管家 › 订单列表：「类型」下拉改为页签** - 改为三页签（核心 / 定制 / 团期），去掉「全部」选项，默认「核心」 - - 样式照 `src/views/finance/settlement/index.vue` 的「常规产品 / 团期产品」页签 - - 后端户级端点不收 GROUP，原「全部」只含核心+定制；GROUP 独走 `group-batches` 端点 + - 样式照「财务管理 › 核单列表」（`src/views/finance/settlement/index.vue:58-66`）的「常规产品 / 团期产品」页签 + - 端点不变：核心、定制走户级端点 `house-allocation/households`，团期走 `house-allocation/group-batches` 2. **全局文案替换：「小蒙马」→「团期」** - - 后端字典已改，走翻译的地方自动生效 - - 只有 5 处写死的文案需手改（共计 6 处命中点） + - 后端字典已改，走字典翻译的地方自动生效 + - 写死的用户可见文案共 5 个文件 8 处需手改（见第三节表格） 3. **菜单改名后的前端页面名同步** - 后端菜单改名，侧栏自动生效 - - 前端 4 处写死的页面标题同步改名 + - 前端写死的页面标题、按钮与提示文案共 4 个文件 4 处，另有 2 个 spec 断言跟着改（见第四节表格） --- @@ -50,8 +50,9 @@ wx 2026-09-27 确认三项协同改动，后端部分（菜单改名、字典值 **文件**：`src/views/housekeeper/orders/index.vue` -- **搜索区** `:33-44`：「类型」使用 `n-select` 下拉框，宽度 120px -- **选项定义** 约 `:366-371`： +- **搜索区** `:34-45`：「类型」使用 `n-select` 下拉框，宽度 120px，`:value="orderTab"` + `@update:value="onOrderTabChange"`。`:34` 的注释写明它是 2026-09-27 当天由页签改成下拉的，本次按 wx 要求改回页签 +- **状态变量** `:365`：`const orderTab = ref('all')` +- **选项定义** `:366-372`： ```js const orderTabOptions = [ { value: 'all', label: '全部' }, @@ -76,14 +77,20 @@ wx 2026-09-27 确认三项协同改动，后端部分（菜单改名、字典值 #### 2. 页签内容：**去掉「全部」，仅保留核心、定制、团期，默认核心** ```vue - + 核心 定制 团期 ``` - - 绑定到 `orderTab`（当前状态变量） - - `@update:model-value="onOrderTabChange"` 仍调现有回调 + - 绑定方式与现有 `n-select` 相同：`:value="orderTab"` + `@update:value="onOrderTabChange"`，仍由现有回调重置状态桶。核单列表用的是 `v-model:value`，这里不能照抄，否则切换时会绕过 `onOrderTabChange` + - `:365` 的初始值由 `ref('all')` 改为 `ref('CORE')`；`orderTabOptions` 删除；凡把 `orderTab` 置为或判断为 `'all'` 的地方（如 `:456` 的 `orderTab.value !== 'all'`）按「默认 CORE、恒有值」改。同文件 `scope`、`statusTab` 也有 `'all'`，与本改动无关，不动 #### 3. 端点行为不变 - 核心、定制：`GET house-allocation/households`，带 `productType=CORE|CUSTOM` @@ -95,7 +102,7 @@ wx 2026-09-27 确认三项协同改动，后端部分（菜单改名、字典值 - `?orderId=` 行为不变 #### 5. 页面注释同步 - - 约 `:298-308` 的注释，「类型下拉」描述同步改成「类型页签」 + - `:34-35`、`:297-308`、`:366` 的注释里「下拉 / 全部」的描述同步改成「页签 / 核心·定制·团期」 --- @@ -104,10 +111,10 @@ wx 2026-09-27 确认三项协同改动，后端部分（菜单改名、字典值 ### 后端字典已改 后端 PR #8450（HL-#8444）部署完毕，字典值修改： - `product_type/GROUP` label 为「团期」（原「小蒙马」） -- `vehicle_type/GROUP` label 为「团期专用」（原「小蒙马」） +- `vehicle_type/GROUP` label 为「团期专用」（原「小蒙马专用」） - 走字典翻译的地方自动生效 -### 前端需改的写死文案 +### 前端需改的写死文案（5 个文件 8 处，均对 origin/v2.1 `1c555f5` 逐行核过） | 文件 | 行号 | 改前 | 改后 | |------|------|------|------| @@ -120,12 +127,14 @@ wx 2026-09-27 确认三项协同改动，后端部分（菜单改名、字典值 | `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 团期 - ``` +`constants.js:71` 的 `xmm` 是旧产品类型键（同文件 `PRODUCT_TYPE.XMM = 'xmm'`），只改 label，键名不动。 + +### 注释（顺手改，不影响展示） +- `src/views/order-v2/new/components/Step0Theme.vue:249`：`CORE 核心产品 / GROUP 小蒙马 / CUSTOM 私人定制` → `GROUP 团期` +- 其余注释命中：`src/constants/productType.js:14,33`、`src/stores/productEdit.js:139`、`housekeeper/components/orderDetailAdapter.js:507`、`housekeeper/ledger/index.vue:183`、`housekeeper/todos/index.vue:273`、`product/edit/` 下 `DayEditor.vue:39`、`HotelCard.vue:12`、`HotelPickerModal.vue:36,308`、`config/product-type-config.js:2,5`、`index.vue:3`、`product/line/components/MiniappShareModal.vue:189` + +### 不在本次替换范围 +- `src/views/product/edit/config/block-type-config.js:97,101,129,307,311,313`：产品详情页营销模块的默认文案（「小蒙马领队团队」「今年，小蒙马 2 岁了」「小蒙马亲子营」）。这里的「小蒙马」是品牌名，不是产品类型名，替换成「团期」语义不通，保持原样。 --- @@ -137,15 +146,17 @@ wx 2026-09-27 确认三项协同改动，后端部分（菜单改名、字典值 |---------|---------|------|------| | 订单管理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` | —— | **无需改** | +| 同上（详情页空态按钮） | `src/views/order-v2/batch/detail/index.vue:348` | action-text="返回班期看板" | action-text="返回出团管理" | +| 同上（订单详情里的引导提示） | `src/views/order-v2/detail/_shared/orderDetailActions.js:32` | '…请到团期详情完成团期确认后…' | '…请到出团详情完成团期确认后…' | +| 同上（测试断言） | `src/views/order-v2/detail/_shared/__tests__/orderDetailActions.spec.js:73` | toContain('团期详情') | toContain('出团详情') | +| 同上（测试断言） | `src/views/order-v2/detail/components/__tests__/BottomActionBar.spec.js:73` | toContain('团期详情') | toContain('出团详情') | +| 车务管理 › 团期配车 › 团期配车 → 车务管理 › 团期配车（拍平） | `src/views/fleet/group-dispatch/index.vue` | —— | **无需改** | #### 特别说明 -- **班期看板页面**改名为「出团管理」，与侧栏菜单「出团管理」保持同名 -- **团期详情页**改名为「出团详情」，同步更新引导文案与测试用例 -- **团期配车页面**无需改动，该页面路由与菜单一致，由后端动态挂载 +- 「班期看板」页面标题改为「出团管理」，与侧栏菜单同名 +- 「团期详情」页面标题改为「出团详情」，引导提示与测试断言一起改。后端 581065 的 message 是「团期单随团期确认，不可单独确认」，不含页面名，前端改提示不会和后端文案对不上 +- 团期配车页面路由与菜单 path 都没变，只是菜单少了一层目录，前端无需改动 +- 代码注释里的「团期详情」（`src/api/`、`stores/`、`notification/` 等处）指的是接口或数据，不是页面名，不用改 --- @@ -154,12 +165,13 @@ wx 2026-09-27 确认三项协同改动，后端部分（菜单改名、字典值 改完后逐项核对（无需部署，仅检查代码变更）： - [ ] 房务订单列表的「类型」改为三页签（核心 / 定制 / 团期），去掉「全部」 -- [ ] 页签默认「核心」，样式参考金融结算页 -- [ ] 5 处文案「小蒙马」改「团期」 -- [ ] 订单列表班期看板标题「班期看板」→「出团管理」 -- [ ] 团期详情页标题「团期详情」→「出团详情」 -- [ ] 团期确认引导文案同步改「出团详情」 -- [ ] 相关测试用例中的文案断言同步 +- [ ] 页签默认「核心」，样式同「财务管理 › 核单列表」；切换页签时状态桶照常重置 +- [ ] `?groupBatchId=` 通知链接仍自动切到「团期」页签并定位 +- [ ] 5 个文件 8 处写死文案「小蒙马」改「团期」 +- [ ] 「班期看板」页面标题 →「出团管理」，详情页空态按钮「返回班期看板」→「返回出团管理」 +- [ ] 「团期详情」页面标题 →「出团详情」 +- [ ] 订单详情里的团期确认引导提示改「出团详情」 +- [ ] `orderDetailActions.spec.js`、`BottomActionBar.spec.js` 断言同步，单测绿 ---