# asset-lifecycle-status Specification

## Purpose
TBD - created by archiving change client-api-data-model-fixes. Update Purpose after archive.
## 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`