Files
junhong_cmp_fiber/openspec/changes/client-api-data-model-fixes/specs/h5-legacy-cleanup/spec.md
huang ec86dbf463 feat: 客户端接口数据模型基础准备
- 新增资产状态、订单来源、操作人类型、实名链接类型常量
- 8个模型新增字段(asset_status/generation/source/retail_price等)
- 数据库迁移000082:7张表15+字段,含存量retail_price回填
- BUG-1修复:代理零售价渠道隔离,cost_price分配锁定
- BUG-2修复:一次性佣金仅客户端订单触发
- BUG-4修复:充值回调Store操作纳入事务
- 新增资产手动停用接口(PATCH /iot-cards/:id/deactivate、/devices/:id/deactivate)
- Carrier管理新增实名链接配置
- 后台订单generation写时快照
- BatchUpdatePricing支持retail_price调价目标
- 清理全部H5旧接口和个人客户旧登录方法
2026-03-19 10:56:50 +08:00

1.8 KiB
Raw Blame History

ADDED Requirements

Requirement: 旧 H5 接口文件删除清单

系统 MUST 完整删除以下旧 H5 文件:

  • internal/handler/h5/auth.go
  • internal/handler/h5/order.go
  • internal/handler/h5/recharge.go
  • internal/handler/h5/package_usage.go
  • internal/handler/h5/enterprise_device.go
  • internal/routes/h5.go
  • internal/routes/h5_enterprise_device.go
  • internal/routes/h5_package_usage.go

Scenario: 旧 H5 文件不存在

  • WHEN 执行本提案改造完成后检查仓库
  • THEN 上述文件 MUST 全部不存在

Requirement: 旧 H5 与旧登录引用清理清单

系统 MUST 清理以下代码引用:

  • bootstraphandlers.goH5AuthEnterpriseDeviceH5H5PackageUsageH5OrderH5Recharge
  • bootstraptypes.go 对应字段
  • bootstrapmiddlewares.gocreateH5AuthMiddleware
  • 路由:routes.go/api/h5 挂载
  • 路由:order.goregisterH5OrderRoutes
  • 路由:recharge.goregisterH5RechargeRoutes
  • 文档:pkg/openapi/handlers.go 中 H5 Handler 构造
  • 限流:cmd/api/main.go/api/h5 限流配置
  • 旧登录方法:internal/handler/app/personal_customer.goLoginSendCodeWechatOAuthLoginBindWechat
  • 旧登录路由:internal/routes/personal.go 中指向已删除方法的路由

Scenario: 编译期无已删除符号引用

  • WHEN 清理完成后执行编译
  • THEN 系统 MUST 不再出现对上述已删除 Handler、路由或方法的引用

Requirement: 清理后编译通过

系统 MUST 在完成文件删除与引用清理后保持工程可编译。

Scenario: 全量编译验证通过

  • WHEN 执行构建命令
  • THEN 工程 MUST 编译通过且无 H5 旧接口残留导致的编译错误