junhong_cmp_fiber/openspec/changes/client-api-data-model-fixes/specs/asset-lifecycle-status/spec.md at ec86dbf4636b7e6c0b80a9ee36a2f6620cf930ba

csxj2026/junhong_cmp_fiber

Files

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: 资产生命周期状态字段定义

系统 MUST 在 IotCard 与 Device 数据模型中新增 asset_status int NOT NULL DEFAULT 1 字段，用于表达资产生命周期状态。

状态值域 MUST 固定为：1-在库、2-已销售、3-已换货、4-已停用。

Scenario: 新建资产默认在库

WHEN 系统创建新的 IoT 卡或设备记录
THEN asset_status MUST 默认为 1（在库）

Scenario: 非法状态值被拒绝

WHEN 写入 asset_status 为 0、5 或其他非约定值
THEN 系统 MUST 拒绝该写入并提示状态值不合法

Requirement: 资产生命周期状态常量定义

系统 MUST 在 pkg/constants/ 中定义资产生命周期状态常量，并统一由业务层引用，禁止在业务代码中硬编码状态值。

Scenario: 业务代码引用常量

WHEN Service 层执行资产状态判断或赋值
THEN 代码 MUST 使用 pkg/constants/ 中定义的资产状态常量而不是硬编码数字

Requirement: 资产状态与网络状态独立

系统 MUST 保证 asset_status 与运营商侧 network_status 完全独立，二者不互相推导、不互相覆盖。

本提案阶段 MUST 仅新增字段与常量定义，状态流转逻辑（导入→在库、首次绑定/分配→已销售、换货完成→已换货、转新→在库且代际+1、手动停用→已停用）在后续提案实现。

Scenario: 网络状态变化不影响资产状态

WHEN Gateway 同步将 network_status 从开机改为停机
THEN 系统 MUST 保持 asset_status 不变

Scenario: 资产状态变化不强制修改网络状态

WHEN 管理端将资产手动停用（asset_status=4）
THEN 系统 MUST 不自动改写 network_status

1.8 KiB Raw Blame History Unescape Escape