domainCheck Workspace

这个仓库是 domainCheck 项目的本地工作区，包含：

• 旧版桌面端源码 domainCheck/
• 新版后端服务 domain-api/
• 新版 Web 管理后台 domain-web/
• 全套交付与部署文档 docs/
• Windows 本地启动、打包、验包脚本

如果你是第一次打开这个仓库，建议先看：

• docs/12_domainCheck_导航索引.md
• docs/04_domainCheck_WebLinux改造总体方案.md

目录结构

.
├─ docs/                文档、验收、部署、交付说明
├─ domainCheck/         旧版 Windows 桌面端源码
├─ domain-api/          新版 FastAPI 后端
├─ domain-web/          新版 Vue Web 管理后台
├─ release/             打包产物目录（通常不提交 git）
├─ start_*.ps1          Windows 启动脚本
├─ stop_*.ps1           Windows 停止脚本
├─ smoke_test_stack.ps1 本地整栈自测
├─ package_domain_release.ps1   交付打包
├─ verify_domain_release.ps1    交付包校验
├─ prepare_final_release.ps1    最终发布准备
└─ show_latest_release.ps1      查看最新交付包

各目录用途

domainCheck/

旧版桌面工具项目，主要用于：

• 历史功能保留
• 旧版桌面端运行
• 检测逻辑来源与兼容

domain-api/

新版后端服务，负责：

• 配置中心
• 检测控制
• 域名筛选与批量更新
• 导入与导出
• 日志诊断
• 运行中心
• Linux 部署与联调

关键入口：

• domain-api/README.md
• domain-api/deploy/linux/README.md

domain-web/

新版 Web 管理后台，负责：

• 登录
• 概览
• 系统设置
• 域名导入
• 检测控制
• 域名筛选
• 导出中心
• 日志诊断
• 运行中心

关键入口：

• domain-web/README.md

docs/

这个目录是项目的总文档区，包含：

• 验收清单
• 优化清单
• 外包整改清单
• Web/Linux 改造方案
• Linux 部署说明
• 发布验收清单
• 交付说明
• 打包说明
• 最终交付结论
• Linux 联调输入清单
• 总导航索引

最推荐的阅读顺序：

1. docs/04_domainCheck_WebLinux改造总体方案.md
2. docs/08_domainCheck_交付说明.md
3. docs/05_domainCheck_Linux部署清单.md
4. docs/07_domainCheck_WebLinux发布验收清单.md
5. docs/12_domainCheck_导航索引.md

Windows 本地常用脚本

启动与停止

• start_domain_stack.ps1
• stop_domain_stack.ps1
• start_domain_api.ps1
• stop_domain_api.ps1
• start_domain_web.ps1
• stop_domain_web.ps1

自测与交付

• smoke_test_stack.ps1
• package_domain_release.ps1
• verify_domain_release.ps1
• prepare_final_release.ps1
• show_latest_release.ps1

当前状态

当前这套工作区已经完成：

• 本地开发
• Web/API 落地
• Windows 本地联调
• 自检与自测
• 配置迁移与备份
• 打包与验包
• 发布准备

剩余工作主要在真实 Linux 环境：

• 部署
• 联调
• 灰度上线

Linux 阶段建议先看：

• docs/11_domainCheck_Linux联调输入清单.md
• docs/12_domainCheck_导航索引.md

Git 提交建议

建议提交：

• docs/
• domain-api/
• domain-web/
• domainCheck/ 中需要保留的源码
• 根目录 .ps1 脚本

不建议提交：

• release/
• 真实 .env
• 日志
• runtime/
• node_modules/
• dist/
• .venv/
• 其他运行生成文件