统一编辑模板并移除首批台账工具(05-31-business-edit-template-remove-ledger-tools-wave1)
这个提交包含在:
@@ -0,0 +1,82 @@
|
||||
# 建立业务编辑模板并移除台账工具首批
|
||||
|
||||
## Goal
|
||||
|
||||
按已确认的 frontend-design 规则建立业务编辑页模板,并先在报销、资产两个高频页面取消 `台账工具` 入口,把原有能力迁移到具体、可理解的动作位置,降低国内小团队日常使用复杂度。
|
||||
|
||||
## What I Already Know
|
||||
|
||||
- 面向对象是国内小于 10 人的科技初创公司,系统应优先低复杂度、高频动作和成熟后台惯例。
|
||||
- 当前已有列表模板 `BusinessListTemplate.tsx` 和详情模板 `BusinessDetailTemplate.tsx`。
|
||||
- 当前还没有统一编辑模板。
|
||||
- 用户明确不想要 `台账工具` 这个泛化入口。
|
||||
- 本轮采用成熟 Ant Design / Ant Design Pro 式后台结构:页头主动作、状态/范围切换、筛选、表格、选中后批量条、详情右侧操作区、编辑页分区表单。
|
||||
|
||||
## Scope
|
||||
|
||||
- 新增 `BusinessEditTemplate` 及配套编辑页布局组件。
|
||||
- 首批只迁移报销列表和资产列表中的 `台账工具` 入口。
|
||||
- 更新 frontend 设计规范,固化三类模板和 `台账工具` 禁用规则。
|
||||
- 补充或调整必要的前端测试断言。
|
||||
|
||||
## Requirements
|
||||
|
||||
- 列表、详情、编辑模板必须只统一布局和交互槽位,不做 JSON 配置式页面生成器。
|
||||
- `台账工具` 按钮名不得继续出现在报销、资产首批页面。
|
||||
- 报销列表:
|
||||
- `新建报销` 保持页头主按钮。
|
||||
- 更多创建方式归入 `新建报销` 的下拉或明确命名入口。
|
||||
- 导出使用明确的 `导出` 入口。
|
||||
- 全范围/仅自己/审批中台账使用范围或筛选动作,不藏在 `台账工具`。
|
||||
- 资产列表:
|
||||
- 常用列表筛选和状态切换保持在列表上方。
|
||||
- 导出、盘点、导入等能力使用具体动作名或详情/管理入口,不使用 `台账工具`。
|
||||
- 编辑模板应支持:
|
||||
- 标题、返回、状态;
|
||||
- 右上角操作;
|
||||
- 底部固定操作条;
|
||||
- 分区表单;
|
||||
- 校验摘要;
|
||||
- 未保存提醒接入点。
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [x] 新增业务编辑模板组件并可被后续页面复用。
|
||||
- [x] 报销页不再出现 `台账工具` 文案,原功能仍可通过具体按钮/下拉访问。
|
||||
- [x] 资产页不再出现 `台账工具` 文案,原功能仍可通过具体按钮/下拉访问或合理迁移。
|
||||
- [x] 前端规范记录三类模板和 `台账工具` 禁用规则。
|
||||
- [x] `cd client && npm run typecheck` 通过。
|
||||
- [x] `cd client && npm run build` 通过。
|
||||
- [x] 相关 Playwright/静态检查按需通过。
|
||||
|
||||
## Out Of Scope
|
||||
|
||||
- 不一次性迁移合同、采购、付款、应付账款、票据和项目。
|
||||
- 不重做业务状态机、审批规则或后端接口。
|
||||
- 不把所有业务字段改成配置生成。
|
||||
- 不做公网部署,除非用户后续明确批准。
|
||||
|
||||
## Test Plan
|
||||
|
||||
- `cd client && npm run typecheck`
|
||||
- `cd client && npm run build`
|
||||
- `rg -n "台账工具" client/src/pages/ReimbursementsPage.tsx client/src/pages/AssetRegistryPage.tsx`
|
||||
- 运行受影响页面相关的聚焦 Playwright 测试,或新增静态/组件断言覆盖入口文案。
|
||||
|
||||
## Technical Notes
|
||||
|
||||
- 设计裁决:`frontend-design` skill。
|
||||
- 现有列表模板:`client/src/components/patterns/BusinessListTemplate.tsx`
|
||||
- 现有详情模板:`client/src/components/patterns/BusinessDetailTemplate.tsx`
|
||||
- 首批页面:`client/src/pages/ReimbursementsPage.tsx`、`client/src/pages/AssetRegistryPage.tsx`
|
||||
|
||||
## Validation Result
|
||||
|
||||
- `cd client && npm run typecheck`:通过。
|
||||
- `cd client && npm run build`:通过。
|
||||
- `rg -n "台账工具|showLedgerTools|asset-ledger-tools|更多创建方式" client/src/pages/ReimbursementsPage.tsx client/src/pages/AssetRegistryPage.tsx`:无结果。
|
||||
- `git diff --check`:通过。
|
||||
- `python3 ./.trellis/scripts/task.py validate 05-31-business-edit-template-remove-ledger-tools-wave1`:通过。
|
||||
- `node scripts/qa/check-trellis-governance.mjs`:通过。
|
||||
- `cd client && npx playwright test tests/e2e/system-action-confirmation.spec.ts --workers=1 --reporter=list`:2 passed。
|
||||
- `cd client && npx playwright test tests/e2e/visual-shell.spec.ts --workers=1 --reporter=list`:5 passed。
|
||||
在新工单中引用
屏蔽一个用户