getDomain/docs/03_domainCheck_整改清单_外包版.md

domainCheck 项目整改清单（外包沟通版）

本文档用于当前版本项目的整改确认与后续复测对齐。
依据为现有交付代码、运行联调结果及 需求文档内容_utf8.txt。

请外包方根据本清单逐项确认：

• 是否已完成
• 如未完成，预计整改方案与时间
• 如有与需求理解不一致之处，请逐项书面说明

当前联调状态

• 更新时间：2026-04-15
• 说明：以下状态由当前代码联调结果同步，便于外包方按项书面回复。
• 状态口径：
• 已整改：代码已落地，待外包方和甲方复测确认
• 整改中：已有部分优化，但仍需继续补齐
• 暂缓：按当前阶段安排，不纳入首轮阻塞项

最近复测结果

• 复测时间：2026-04-16
• 复测范围：导入测试数据、筛选查询、TXT/分页导出、批量更新
• 复测结论：
• 备案筛选、友链大于 10 筛选、检测时间展示、TXT 导出、分页导出底层链路均已通过脚本化复测
• 批量更新选中域名在实际代码链路下已验证可正常更新数据库
• 当前仍建议外包方配合做一轮 GUI 人工复测与检测端全流程复测，再关闭整改项

最新检测联调结果

• 联调时间：2026-04-16
• 联调范围：导入建任务、聚查/桔子补查取数、单域名检测完成路径、单域名命中黑名单路径
• 联调结论：
• TXT 导入后可自动创建待检测任务
• 聚查、桔子补查逻辑已可按状态取数，且黑名单域名不会再次进入补查
• 单域名检测完成后，detect_status / detect_time / review_status / expire_date 联动已验证正常
• 单域名命中风险后，detect_status / domain_blacklist / 时光机附加字段 联动已验证正常
• 当前 Wayback 已按最新验收口径调整为“全快照倒序扫描标题、命中即停、标题去重、结果缓存”
• 当前保留风险主要为超大域名首次获取 CDX 时间戳列表时的耗时问题；已补充 Redis 时间戳缓存，建议外包方继续优化首次全量列表获取策略

---

一、整改结论

当前版本可以完成基础启动、基础界面展示、远程数据库连接与部分导入/采集功能，但暂不具备整体验收通过条件。
主要原因是核心检测闭环、状态定义一致性、部分导出与筛选逻辑、以及多项需求规则尚未完整落地。

为避免后续复测口径不一致，现将整改事项分为以下三类：

• 一类问题：必须整改，整改完成后方可进入整体验收
• 二类问题：建议整改，影响可用性、稳定性或需求完整度
• 三类问题：可按阶段排期，属于增强项或扩展项

---

二、一类问题（必须整改）

1. 检测任务创建、执行、结果回写需形成完整闭环

• 当前状态：已整改

• 问题说明：当前版本中，域名入库后“创建待检测任务”、检测完成后“回写检测结果”的流程不稳定，部分数据库写入逻辑存在连接对象使用不一致的问题。

• 需求依据：需求文档明确要求入库后创建待检测任务，并通过流水线方式持续检测与更新数据库状态。

• 整改要求：

• 保证入库后可稳定创建待检测任务

• 保证检测完成后可稳定写入检测结果

• 保证失败任务、重试任务、已完成任务状态可追踪

• 验收标准：

• 随机导入一批域名后，可在数据库中看到对应任务

• 执行检测后，数据库状态与检测结果表有完整回写

2. 状态码定义必须统一

• 当前状态：已整改

• 问题说明：当前项目中注册状态、检测状态等枚举值在数据库、检测器、工具函数、界面显示之间存在不一致。

• 需求依据：需求文档已给出明确状态定义。

• 整改要求：

• 统一注册状态枚举

• 统一检测状态枚举

• 统一使用状态、人工复核状态枚举

• 确保数据库值、代码逻辑、界面显示、导出结果一致

• 验收标准：

• 任取一个域名，其数据库状态、界面显示、导出内容含义一致

3. 导出功能需补齐 TXT 格式

• 当前状态：已整改

• 问题说明：需求要求“导出 TXT，一行一个域名”，当前版本仅支持 Excel/CSV。

• 需求依据：运营导出明确要求 TXT 格式。

• 整改要求：

• 增加 TXT 导出

• 每行一个域名

• 导出内容与当前筛选结果一致

• 验收标准：

• 在筛选结果页导出 TXT，文件内容符合“一行一个域名”

4. 筛选条件必须真实生效，不能仅停留在界面层

• 当前状态：已整改

• 问题说明：当前部分筛选项虽已在界面存在，但未完整进入查询逻辑，导致界面与结果不一致。

• 重点项：

• 注册状态

• 检测状态

• 使用状态

• 备案年份

• 快照年份

• 是否有备案历史

• 友链数量是否大于 10

• 首页网址筛选

• 整改要求：

• 所有界面筛选条件必须真正作用于数据库查询

• 查询结果必须与筛选条件一致

• 验收标准：

• 通过构造测试数据，验证各筛选项结果准确

5. 敏感词配置必须全链路生效

• 当前状态：已整改

• 问题说明：当前虽然存在敏感词配置页面，但部分检测逻辑仍使用写死词表。

• 需求依据：需求明确要求“敏感词、风险词必须可配置”。

• 整改要求：

• 检测流程统一从配置或数据库读取敏感词

• 不再保留独立的写死敏感词规则作为主判定来源

• 验收标准：

• 新增/删除敏感词后，检测结果可随配置变化

6. 停止规则需完整落实

• 当前状态：整改中

• 问题说明：需求文档中对停止检测、进入候选池、排除运营池等有明确规则，当前只实现了部分中止逻辑。

• 整改要求：

• 黑名单命中后停止后续检测

• 已使用/已卖出/已预定域名不进入运营候选池

• 非可注册且非一口价域名不进入“可注册域名池”

• 验收标准：

• 按规则构造测试样本，流程结果符合需求定义

7. 核心检测流程需与需求步骤一致

• 当前状态：整改中

• 问题说明：当前版本已有基础检测器，但与需求中的完整筛选链路仍有差距。

• 需求链路：

• 注册状态检测

• 黑名单缓存检查

• 时光机基础筛选

• 各平台深度检测

• 备案检测

• 更新数据库

• 运营筛选导出

• 整改要求：

• 明确各步骤执行顺序

• 明确每一步的中止条件

• 明确每一步的结果回写字段

• 验收标准：

• 随机抽取样本域名，能完整追踪检测执行链路

++ 8. 聚查、桔子需增加独立检测状态并支持增量补查

• 当前状态：已整改

• 问题说明：人工验收反馈中提出，聚查、桔子当前缺少独立检测状态，无法区分“未检测”和“已检测”，导致二次检测场景下无法按需补查。

• 业务要求：

• 第一次检测时，如未勾选聚查、桔子，则仅按当次检测选项执行

• 第二次检测时，如新增勾选聚查、桔子，则数据库中尚未检测过聚查、桔子的域名需补查一次

• 当本次选中的流程全部执行完且未命中黑名单时，总检测状态应更新为“检测完成”

• 整改要求：

• 为聚查、桔子增加独立检测状态字段或等效机制

• 支持按子项状态触发增量补查

• 明确总检测状态与子项检测状态的联动关系

• 验收标准：

• 构造“第一次未勾选、第二次勾选”的测试场景，验证聚查、桔子可正确补查

++ 9. 检测选项配置需与实际执行流程保持一致

• 当前状态：已整改

• 问题说明：人工验收反馈指出，系统设置中仅配置了少量检测项，但检测端运行耗时异常，无法明确系统实际执行了哪些检测流程。

• 人工反馈重点：

• 当前希望可配置的检测项包括：

• 检查注册

• 站长之家查询

• 爱站网查询

• 百度 site 查询

• 360 site 查询

• 整改要求：

• 系统设置中的检测选项必须与实际执行逻辑严格一致

• 未勾选的检测项不得执行

• 检测端应能清晰反映当前执行项

• 验收标准：

• 在仅勾选部分检测项时，日志与结果仅体现对应检测流程

++ 10. 域名筛选结果中需显示检测时间

• 当前状态：已整改

• 问题说明：人工验收反馈中，在“注册状态=可注册、使用状态=未使用、检测状态=检测完成”条件下查询后，结果列表未显示检测时间。

• 业务口径：检测时间 = 检测完成时间。

• 整改要求：

• 检测完成后必须回写检测完成时间

• 筛选结果页需显示该时间

• 验收标准：

• 随机选取已检测完成域名，列表中可看到检测完成时间

++ 11. 域名筛选导出需支持“导出多页”或“导出全部”

• 当前状态：已整改

• 问题说明：当前导出范围仅限当前页，不满足实际运营导出需求。

• 整改要求：

• 在导出时增加导出范围选择

• 至少支持：

• 导出当前页

• 导出指定页数

• 导出全部结果

• 验收标准：

• 针对多页数据可完成跨页导出

++ 12. “是否有备案”筛选需修复

• 当前状态：已整改

• 问题说明：人工验收中，无论是否勾选备案条件，出现的域名结果均相同。

• 整改要求：

• 核查备案字段写入与筛选逻辑

• 保证“有备案 / 无备案 / 未检测”条件能真实区分结果集

• 验收标准：

• 构造不同备案状态数据后，筛选结果明显区分

++ 13. 批量更新选中域名功能需修复

• 当前状态：已整改

• 问题说明：人工验收中，已选中域名后执行批量更新，系统提示“成功更新0个域名的信息”。

• 整改要求：

• 修复选中项识别、域名定位、更新提交逻辑

• 保证选中数据可真正更新到数据库

• 验收标准：

• 选择多条域名执行批量更新后，数据库与界面结果同步变化

++ 14. 检测选项配置中需补充时光机检测

• 当前状态：已整改

• 问题说明：人工验收中指出系统设置的检测选项中没有“时光机检测”，但需求流程中时光机属于基础检测步骤。

• 整改要求：

• 在检测选项配置中增加“时光机检测”开关

• 并确保该开关与实际流程联动

• 验收标准：

• 关闭时光机后流程不执行时光机检测

• 开启后流程正常执行并写入结果

---

三、二类问题（建议整改）

8. 时光机检测已按当前验收口径调整为“全快照倒序扫描标题，命中即停”

• 当前状态：已整改，待复测确认

• 当前情况：已使用 Wayback/CDX API 获取全量快照时间戳，并按倒序进行扫描。

• 当前实现：

• 仅抓取快照 title

• 按 title 去重

• 先快速检查最新快照，命中后不再继续拉取全量快照列表

• 使用 CDX 返回的 digest 先做内容级去重，减少重复 title 请求

• 命中敏感词立即停止后续扫描

• 已增加标题缓存与时间戳列表缓存

• 保留说明：当前不再按正文提取友链数量；如甲方仍要求自动产出友链数，需另行补充正文抓取或其他统计来源。

• 备注：该实现已与当前人工审核口径一致，即必须检查全部快照，但命中后立即停止。

9. “友链数量是否大于 10”建议接入自动检测闭环

• 当前状态：已整改

• 当前情况：已有相关字段与部分处理逻辑。

• 存在差距：与自动检测、筛选条件、落库逻辑的衔接还不完整。

• 整改建议：

• 自动检测时计算并回写友链结果

• 筛选页支持按该结果稳定筛选

10. 人工筛选规则脚本化建议进一步补齐

• 当前状态：整改中

• 需求涉及平台：

• 站长之家

• 爱站

• 百度 site

• 360 site

• 聚查 WHOIS/备案/拦截

• 桔子 SEO 历史/外链

• 当前情况：已有平台检测器，但规则覆盖不完整。

• 整改建议：

• 逐项补齐需求文档中已列明的业务判断规则

• 能自动拉黑的规则尽量自动化，不保留人为口径歧义

11. 检测端稳定性建议优化

• 当前状态：已完成一轮基础整改，待长时压测

• 当前情况：项目可运行，但数据库连接、线程模型、失败重试等仍有优化空间。

• 整改建议：

• 优化连接池与并发参数

• 梳理失败重试与日志

• 降低因资源配置导致的不稳定情况

12. 配置写入逻辑建议优化

• 当前状态：已整改

• 当前情况：系统设置页在初始化过程中存在重复写本地文件/Redis 的现象。

• 整改建议：

• 初始化加载与主动保存行为区分

• 减少无效写入与重复日志

13. 明文密码存储建议整改

• 当前状态：已整改

• 当前情况：本地存在明文账号密码保存。

• 整改建议：

• 明确是否允许本地持久化保存

• 若允许，应增加最基本的保护措施

• 若不允许，应移除明文存储

---

四、三类问题（可阶段处理）

14. 多来源采集扩展

• 当前状态：暂缓

• 包含项：

• 搜索引擎采集

• 企业目录采集

• Zone File 采集

• 第三方 API / 数据包接入

• 说明：该类功能对“全网增量建设”有价值，但可根据当前项目阶段单独排期。

15. Redis Bloom 模块支持

• 当前状态：暂缓

• 当前情况：Redis 当前可正常使用，但未安装 Bloom 模块。

• 说明：不影响当前基础运行，可后续视大数据量需求决定是否补充。

16. 亿级数据量专项优化

• 当前状态：暂缓

• 说明：需求文档中有“支持亿级数据量”的目标，当前项目尚不足以证明已达到该级别设计要求。

• 建议后续处理方向：

• 索引优化

• 批量导入策略

• 分区/分表设计

• 大规模调度与队列方案

17. 交互体验优化

• 当前状态：整改中

• 包含项：

• 批量操作反馈

• 查询空结果提示

• 导出结果提示

• 状态说明更清晰

• 说明：可在主流程稳定后再安排

---

五、建议整改优先级

建议外包方按以下顺序整改：

1. 检测任务闭环
2. 检测结果回写
3. 状态码统一
4. TXT 导出
5. 筛选条件真实生效
6. 敏感词配置全链路生效
7. 停止规则补齐
8. 时光机升级
9. 人工筛选规则补齐
10. 稳定性与安全性优化

---

六、复测建议

整改完成后，建议按以下顺序重新复测：

1. 环境连接与数据库初始化
2. 域名导入与去重
3. 自动创建检测任务
4. 注册状态检测
5. 时光机检测
6. 平台深度检测
7. 结果回写数据库
8. 筛选页面结果准确性
9. 批量更新使用状态/人工复核状态
10. TXT 导出正确性

---

七、外包方回复建议格式

请外包方按以下格式逐项回复：

• 问题编号
• 是否认可
• 是否已整改
• 整改说明
• 涉及文件
• 预计完成时间

---

八、当前阶段结论

当前版本不建议直接整体验收通过。
建议以本清单为基础，由外包方完成一类问题整改后，再进入下一轮正式复测。