104 lines
6.2 KiB
Markdown
104 lines
6.2 KiB
Markdown
# 第一轮审核清单
|
||
|
||
第一轮目标：先查控制面、运行态聚合、同步链、节点控制和配置分发。
|
||
|
||
建议模型与强度：
|
||
- `gpt-5.4`
|
||
- `xhigh`
|
||
|
||
建议额度：
|
||
- `300万 ~ 450万 tokens`
|
||
|
||
本轮不看：
|
||
- `release/`
|
||
- `.venv/`
|
||
- `node_modules/`
|
||
- 运行时日志、快照、night runs
|
||
- 大型静态资源和锁文件
|
||
|
||
## 审核顺序
|
||
|
||
### P0：运行态与页面口径
|
||
1. [domain-api/app/services/detect_job_service.py](/www/wwwroot/getDomain/domain-api/app/services/detect_job_service.py)
|
||
重点看：`active_job`、`runtime_snapshot`、`runtime_ingest`、`distributed_node_stats`、`display_*` 字段是否会互相覆盖。
|
||
2. [domain-api/app/services/detect_service.py](/www/wwwroot/getDomain/domain-api/app/services/detect_service.py)
|
||
重点看：检测控制页口径、聚合线程数、参与节点/参与进程统计、零值回退逻辑。
|
||
3. [domain-api/app/services/runtime_status_service.py](/www/wwwroot/getDomain/domain-api/app/services/runtime_status_service.py)
|
||
重点看：运行中心聚合、`queue_health` 与 backlog 对齐、活跃任务判定。
|
||
4. [domain-api/app/services/dashboard.py](/www/wwwroot/getDomain/domain-api/app/services/dashboard.py)
|
||
重点看：首页总览是否复用旧快照、`queue_display_*` 和 `active_job` 是否一致。
|
||
5. [domain-api/app/api/routes/detect.py](/www/wwwroot/getDomain/domain-api/app/api/routes/detect.py)
|
||
重点看：检测控制接口有没有直接透传脏口径。
|
||
6. [domain-api/app/api/routes/runtime.py](/www/wwwroot/getDomain/domain-api/app/api/routes/runtime.py)
|
||
重点看：运行中心接口是否二次加工错误。
|
||
7. [domain-api/app/api/routes/dashboard.py](/www/wwwroot/getDomain/domain-api/app/api/routes/dashboard.py)
|
||
重点看：首页口径是否和服务层一致。
|
||
|
||
### P0：同步链与投影链
|
||
8. [domain-api/app/services/sync_record_service.py](/www/wwwroot/getDomain/domain-api/app/services/sync_record_service.py)
|
||
重点看：`runtime_projection`、`runtime_ingest`、未来时间记录、重复投影、自愈逻辑。
|
||
9. [domain-api/app/services/sync_push_service.py](/www/wwwroot/getDomain/domain-api/app/services/sync_push_service.py)
|
||
重点看：同步触发、推送条件、失败重试、是否会把旧状态推成新状态。
|
||
10. [domain-api/app/services/cluster_runtime_service.py](/www/wwwroot/getDomain/domain-api/app/services/cluster_runtime_service.py)
|
||
重点看：集群节点汇总、心跳、stale/offline 判定。
|
||
11. [domain-api/app/services/debug_event_service.py](/www/wwwroot/getDomain/domain-api/app/services/debug_event_service.py)
|
||
重点看：调试事件是否参与运行态推断，是否会误导当前任务。
|
||
|
||
### P0：节点控制与配置分发
|
||
12. [domain-api/app/services/worker_control_service.py](/www/wwwroot/getDomain/domain-api/app/services/worker_control_service.py)
|
||
重点看：worker 进程探测、当前状态读取、systemd 口径和实际进程口径是否一致。
|
||
13. [domain-api/app/services/settings_service.py](/www/wwwroot/getDomain/domain-api/app/services/settings_service.py)
|
||
重点看：`process_count`、`thread_count`、节点级覆盖、多实例父子节点映射。
|
||
14. [domain-api/app/services/runtime_settings_service.py](/www/wwwroot/getDomain/domain-api/app/services/runtime_settings_service.py)
|
||
重点看：运行态配置来源、热配置优先级、页面修改后是否真生效。
|
||
15. [domain-api/app/services/runtime_control_service.py](/www/wwwroot/getDomain/domain-api/app/services/runtime_control_service.py)
|
||
重点看：启动/停止/恢复对多实例 worker 是否安全。
|
||
|
||
### P1：检测任务主链
|
||
16. [domain-api/app/services/detect_run_service.py](/www/wwwroot/getDomain/domain-api/app/services/detect_run_service.py)
|
||
重点看：运行记录、cycle 事件、页面日志来源。
|
||
17. [domain-api/app/services/domains_service.py](/www/wwwroot/getDomain/domain-api/app/services/domains_service.py)
|
||
重点看：域名主数据是否和检测任务状态有交叉写入风险。
|
||
18. [domain-api/app/services/import_task_service.py](/www/wwwroot/getDomain/domain-api/app/services/import_task_service.py)
|
||
重点看：导入任务是否影响 backlog、是否能造成页面统计失真。
|
||
|
||
## 必看测试
|
||
|
||
### 直接对应运行态/聚合
|
||
1. [domain-api/tests/test_detect_job_service.py](/www/wwwroot/getDomain/domain-api/tests/test_detect_job_service.py)
|
||
2. [domain-api/tests/test_detect_service_status_fallback.py](/www/wwwroot/getDomain/domain-api/tests/test_detect_service_status_fallback.py)
|
||
3. [domain-api/tests/test_runtime_status_service.py](/www/wwwroot/getDomain/domain-api/tests/test_runtime_status_service.py)
|
||
4. [domain-api/tests/test_dashboard_service.py](/www/wwwroot/getDomain/domain-api/tests/test_dashboard_service.py)
|
||
|
||
### 直接对应同步链
|
||
5. [domain-api/tests/test_sync_record_service.py](/www/wwwroot/getDomain/domain-api/tests/test_sync_record_service.py)
|
||
6. [domain-api/tests/test_sync_push_service.py](/www/wwwroot/getDomain/domain-api/tests/test_sync_push_service.py)
|
||
7. [domain-api/tests/test_cluster_runtime_service.py](/www/wwwroot/getDomain/domain-api/tests/test_cluster_runtime_service.py)
|
||
|
||
### 直接对应节点控制与配置
|
||
8. [domain-api/tests/test_worker_control_service.py](/www/wwwroot/getDomain/domain-api/tests/test_worker_control_service.py)
|
||
9. [domain-api/tests/test_settings_service.py](/www/wwwroot/getDomain/domain-api/tests/test_settings_service.py)
|
||
10. [domain-api/tests/test_detect_api_routes.py](/www/wwwroot/getDomain/domain-api/tests/test_detect_api_routes.py)
|
||
11. [domain-api/tests/test_ops_api_routes.py](/www/wwwroot/getDomain/domain-api/tests/test_ops_api_routes.py)
|
||
|
||
## 本轮输出要求
|
||
|
||
只输出这 3 类内容，避免烧额度：
|
||
- `P0 / P1` 真实问题，带文件和行号
|
||
- 影响范围
|
||
- 修复建议
|
||
|
||
不要在第一轮做这些：
|
||
- 大篇架构说明
|
||
- 文件逐段复述
|
||
- UI 细节优化建议
|
||
- 发布脚本和迁移功能深挖
|
||
|
||
## 第一轮完成标准
|
||
|
||
满足以下条件就可以结束第一轮，转第二轮：
|
||
- 能回答“为什么页面显示会和现场不一致”
|
||
- 能回答“为什么 sync 会把旧运行态覆盖成新页面口径”
|
||
- 能回答“进程/线程配置、页面显示、节点实际执行三者有没有断层”
|
||
- 能列出前 `10` 个最值得先修的 `P0/P1` 问题
|