huang
ec86dbf463
- 新增资产状态、订单来源、操作人类型、实名链接类型常量 - 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旧接口和个人客户旧登录方法
2.1 KiB
2.1 KiB
ADDED Requirements
Requirement: 资产表新增代际字段
系统 MUST 在资产主表新增 generation int NOT NULL DEFAULT 1 字段，覆盖 IotCard 与 Device。
Scenario: 新资产默认代际为 1
- WHEN 创建新的 IoT 卡或设备
- THEN 系统 MUST 将
generation初始化为1
Requirement: 关联业务表新增代际字段
系统 MUST 在以下关联业务表新增 generation int NOT NULL DEFAULT 1 字段：Order、PackageUsage、AssetRechargeRecord。
Scenario: 新关联记录默认代际为 1
- WHEN 创建订单、套餐使用记录或资产充值记录
- THEN 系统 MUST 将记录的
generation默认为1
Requirement: 写时快照代际规则
系统 MUST 在创建关联记录时执行代际写时快照：从当前资产（IoT 卡/设备）的 generation 复制到新建的 Order、PackageUsage、AssetRechargeRecord 记录。
Scenario: 创建订单时复制资产代际
- WHEN 某资产当前
generation=3，并基于该资产创建订单 - THEN 该订单记录的
generationMUST 写入为3
Requirement: 查询过滤规则
系统 MUST 支持客户端按 generation 过滤历史数据；后台管理侧 MUST 不默认按 generation 过滤。
本提案阶段 MUST 仅新增字段定义，具体过滤逻辑在后续提案实现。
Scenario: 客户端按代际查看历史
- WHEN 客户端请求携带指定
generation - THEN 系统 MUST 仅返回该代际的数据（在后续提案中实现）
Scenario: 后台查询不按代际裁剪
- WHEN 管理端查询订单或充值记录且未显式指定
generation - THEN 系统 MUST 返回全部代际数据
Requirement: 钱包流水不引入代际字段
系统 MUST NOT 在钱包流水相关表新增 generation 字段，因为钱包流水已通过 wallet_id 天然隔离。
Scenario: 钱包流水按钱包隔离
- WHEN 查询某资产钱包流水
- THEN 系统 MUST 仅依赖
wallet_id完成数据隔离，不新增generation参与过滤