文件
hl-api-changelog/changelogs-v2/2026-09/27_frontend_房务订单列表类型页签改造-小蒙马改团期全局文案-菜单改名同步-前端优化-管理后台.md
T
API Changelog Bot和Claude Opus 5.5 5c3421d8cd
changelog-filename-gate / validate (push) Failing after 1s
feat(changelog): 房务订单列表类型改页签 + 小蒙马改团期 + 菜单改名同步
三项联动的前端优化:
- 房务订单列表「类型」下拉改为页签(核心/定制/团期)
- 全局「小蒙马」文案改为「团期」(5处+注释)
- 菜单改名后同步前端页面标题(班期看板→出团管理、团期详情→出团详情)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-27 19:31:26 +08:00

7.4 KiB
原始文件 Blame 文件历史

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
schema ticket title consumer author change_type backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at status_note updated_at base
hl-changelog/v2 frontend 房务订单列表「类型」改页签 + 「小蒙马」改「团期」文案 + 菜单改名后页面名同步 admin wx(GIT) 前端优化 not_required not_required pending mmg 后端菜单已改名,订单列表类型改页签样式,全局「小蒙马」改「团期」。三项改动独立但同步推送,涉修文件 8 处,涉改行 13 处。 2026-09-27 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:
    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 附近):
    .product-tabs {
      width: 280px;
    }
    

2. 页签内容:去掉「全部」,仅保留核心、定制、团期,默认核心

<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 的注释也需同步:
    // 改前: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