Files
goauto/docs/05-common-changes.md
T

1.1 KiB

常见修改

增加设备字段

先检查设备表、注册响应、心跳、管理端列表和 API 文档。跨三端字段必须在同一工单修改并做契约测试。

修改采集字段

依次检查规则输出、Android 结果 DTO、服务端校验、结果表和管理端详情。不能只改数据库或前端。

新增或修改规则

规则创建后立即可用。编辑或删除规则不修改已有任务的 rule_snapshot;规则软删除后不能创建新任务,已有任务仍可执行。

增加错误码

错误码必须包含稳定代码、用户可读消息、是否可重试和建议处理。同步更新 Android、服务端、管理端和 docs/08-agent-api-contract.md。

修改任务状态

任务状态影响数据库、领取租约、Android 本地状态和 UI 筛选,属于跨端高风险修改,必须有迁移与并发测试。

修改任务重置

重置只允许用于终态任务,并在一个事务中删除旧规格/SKU、清空结果与错误、恢复为 pending。URL、goods_id、规则和设备快照保持不变。