zhoushengchen
88526b9619
附加费类型字典自维护（含进仓费） (#98)
## 任务占用与边界
- 任务名称：附加费类型字典自维护
- 实际开发者：zhoushengchen
- 目标结果：在快递附加费报价维护页支持附加费类型的新增、启用/停用；新增报价仅可选择启用类型，历史报价保留原类型。
- 预计修改路径：附加费类型 Repository、Model、Controller、报价 Repository/Controller、页面、管理路由、类型表迁移和专项测试。
- 将写入的公共契约：business.courier-surcharge.types.store、business.courier-surcharge.types.status、business_courier_surcharge_types。
- 仅复用、不修改的公共契约：business.pages.show、business.courier-surcharge.store。
- 明确不修改的范围：上游数据库、业务镜像、七牛、生产配置和无关页面。
## 开工碰撞检查
- [x] 已检查最新 main 和所有远程任务分支
- [x] 已运行 scripts/codex-task-preflight.ps1
- [x] 未发现与其他远程任务的实际写入重叠
## 实际改动
- 新增附加费类型字典及公司范围隔离。
- 新增类型管理弹窗、创建接口、启用/停用接口。
- 报价表单和后端校验动态读取启用类型；筛选仍可查看全部类型。
- 默认初始化原有 11 种类型，并增加“进仓费”。
- 增加幂等增量迁移，补齐已执行建表迁移环境中的“进仓费”。
## 验证证据
- tests/Feature/Business/CourierSurchargePageTest.php：6 个用例、60 个断言通过。
- 相关 PHP 文件语法检查通过。
- business.courier-surcharge 路由共 5 条，路由检查通过。
- git diff --check 通过。
- 本地共享系统库现状：类型表已存在，当前公司有 11 个旧类型；增量迁移待执行。
## 风险检查
- 未提交 .env、密码、Token、私钥、真实财务数据、生产日志或构建产物。
- 前端遵循 DESIGN.md 的 VIP 黑金令牌。
- 数据库影响：仅新增类型表（若环境尚未建表）或幂等补充“进仓费”，不删除、不覆盖已有类型。
- 回滚：类型字典不做物理删除；迁移 down 保持空操作以保护业务引用。
- 已获得本次“合并 PR 并执行类型表迁移”的明确授权；迁移目标为本机当前连接的团队系统数据库，不涉及生产部署。
## 合并前复查
- [x] 已重新 fetch 远程引用并再次运行碰撞检查
- [x] 已逐文件审核 origin/main...任务分支完整 diff
- [ ] PR 创建后移除 WIP 并执行 Squash merge
- [ ] 合并后验证 main、执行迁移并验证页面
Reviewed-on: http://git.1080p.hk/WuYongJie/CaiWuXiTong/pulls/98
2026-09-02 18:22:17 +08:00
..
2026-07-21 18:43:52 +08:00
2026-09-02 18:22:17 +08:00
2026-07-24 12:18:01 +08:00
2026-07-21 18:43:52 +08:00