dev

docs/08_domainCheck_交付说明.md

@@ -0,0 +1,122 @@
+# 08 domainCheck 交付说明
+
+## 一、当前交付范围
+
+本次已交付：
+
+- `domainCheck` 桌面版主项目
+- `domain-api` 轻量后端接口服务
+- `domain-web` 轻量运营管理后台
+- Windows 本地联调脚本
+- Linux 部署材料
+- Linux 自检与发布验收文档
+
+## 二、Windows 本地脚本
+
+可直接使用：
+
+- `start_domain_api.ps1`
+- `stop_domain_api.ps1`
+- `start_domain_web.ps1`
+- `stop_domain_web.ps1`
+- `start_domain_web_background.ps1`
+- `start_domain_stack.ps1`
+- `stop_domain_stack.ps1`
+- `smoke_test_stack.ps1`
+
+推荐整套启动：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\start_domain_stack.ps1
+```
+
+推荐整套停止：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\stop_domain_stack.ps1
+```
+
+推荐整套自测：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\smoke_test_stack.ps1
+```
+
+## 三、Web/API 默认地址
+
+- Web：`http://127.0.0.1:3200`
+- API：`http://127.0.0.1:8100`
+
+## 四、配置迁移能力
+
+系统设置页已经支持：
+
+- 手动创建配置备份
+- 下载配置备份
+- 导出当前配置快照
+- 导入配置快照
+
+配置快照内容包括：
+
+- 检测选项和执行顺序
+- 代理配置
+- 线程数
+- Web/API 运行配置
+
+推荐场景：
+
+- Windows 测试环境导出配置
+- Linux 正式环境导入配置
+- 发布前先做一次配置备份
+- 导入配置前系统会自动生成一份导入前备份
+
+## 五、Linux 部署相关
+
+请优先阅读：
+
+- `docs/05_domainCheck_Linux部署清单.md`
+- `docs/07_domainCheck_WebLinux发布验收清单.md`
+- `domain-api/deploy/linux/README.md`
+- `domain-web/README.md`
+
+## 六、上线前建议
+
+### 1. 跑 API 自检
+
+```bash
+cd /opt/domaincheck/domain-api
+python deploy/linux/smoke_test.py --base-url http://127.0.0.1:8100
+```
+
+### 2. 打开运行中心
+
+确认：
+
+- API 在线
+- Worker 在线
+- 运行模式正确
+- 部署自检通过
+
+### 3. 打开日志诊断
+
+确认：
+
+- 可正常查看日志
+- 可正常下载诊断包
+
+### 4. 导出一次配置快照
+
+确认：
+
+- 可以成功下载 JSON 快照
+- 导入后配置能恢复
+
+## 七、当前结论
+
+当前项目已经进入“可交付、可联调、可部署”的状态。
+
+剩余工作重点不再是基础开发，而是：
+
+- Linux 实机联调
+- 上线前复测
+- 真实服务器灰度验证