26 lines
1.1 KiB
Markdown
26 lines
1.1 KiB
Markdown
# 常见修改
|
|
|
|
## 增加设备字段
|
|
|
|
先检查设备表、注册响应、心跳、管理端列表和 API 文档。跨三端字段必须在同一工单修改并做契约测试。
|
|
|
|
## 修改采集字段
|
|
|
|
依次检查规则输出、Android 结果 DTO、服务端校验、结果表和管理端详情。不能只改数据库或前端。
|
|
|
|
## 新增或修改规则
|
|
|
|
规则创建后立即可用。编辑或删除规则不修改已有任务的 `rule_snapshot`；规则软删除后不能创建新任务，已有任务仍可执行。
|
|
|
|
## 增加错误码
|
|
|
|
错误码必须包含稳定代码、用户可读消息、是否可重试和建议处理。同步更新 Android、服务端、管理端和 `docs/08-agent-api-contract.md`。
|
|
|
|
## 修改任务状态
|
|
|
|
任务状态影响数据库、领取租约、Android 本地状态和 UI 筛选，属于跨端高风险修改，必须有迁移与并发测试。
|
|
|
|
## 修改任务重置
|
|
|
|
重置只允许用于终态任务，并在一个事务中删除旧规格/SKU、清空结果与错误、恢复为 `pending`。URL、goods_id、规则和设备快照保持不变。
|