huang
5425e2ce19
Constraint: omx team 默认使用独立 worktree，要求 leader 工作区干净 Rejected: git stash 提案文件 | 会让 worker 无法读取当前提案契约 Confidence: high Scope-risk: narrow Directive: 后续实现必须继续严格按 tasks.md 顺序推进，不得擅自跳步 Tested: git status 仅剩未跟踪的 .omx 上下文文件 Not-tested: 未验证提案内容本身的实现正确性
27 lines
2.0 KiB
Markdown
27 lines
2.0 KiB
Markdown
## Why
|
||
|
||
当前资产操作审计日志虽然已经落库，但很多操作内容仍主要记录内部主键 ID，业务侧排查时很难直接看懂“到底操作了哪张卡、哪台设备、哪家店铺”。同时，设备实时状态里虽然已有 `rsrp`、`rsrq`、`rssi`、`sinr` 四个原始指标，但一线使用人员难以理解，影响 C 端与后台管理端对设备信号状态的快速判断。
|
||
|
||
## What Changes
|
||
|
||
- 新增 `feature-001-asset-audit-readable-content`：优化资产操作审计日志的操作内容结构，在保留内部 ID 的同时补充业务可读字段，如 `iccid`、设备标识、店铺名称、企业名称等。
|
||
- 新增 `feature-002-device-signal-summary`：基于设备实时状态中的 `rsrp`、`rsrq`、`rssi`、`sinr` 计算两个新的综合字段，分别表达“信号好坏”和“怀疑原因”。
|
||
- 统一后台管理端与 C 端设备实时信息输出口径，确保两个新增信号字段在两端含义一致。
|
||
- 明确本次变更不处理店铺删除规则，也不处理企业账号列表过滤问题，避免需求范围漂移。
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
- `asset-audit-readable-content`: 定义资产操作审计日志中面向业务可读的操作内容字段要求与展示语义。
|
||
- `device-signal-summary`: 定义设备实时信号综合字段的计算输出、文案口径与 B/C 端返回要求。
|
||
|
||
### Modified Capabilities
|
||
- 无
|
||
|
||
## Impact
|
||
|
||
- 影响资产审计日志相关服务与写入点，主要涉及 `internal/service/asset_audit`、`internal/service/iot_card`、`internal/service/device`、`internal/service/asset`。
|
||
- 影响设备实时状态 DTO 与映射逻辑，主要涉及 `internal/model/dto/asset_dto.go`、`internal/model/dto/client_asset_dto.go`、`internal/service/asset/service.go`、`internal/handler/app/client_asset.go`。
|
||
- 影响后台管理端与 C 端既有响应结构，但属于向后兼容的新增字段，不引入破坏性变更。
|
||
- 无新增外部依赖、无新增数据表、无新增路由。
|