feat(sector-radar): 完成可恢复构建任务

docs/market-data-sync.md

@@ -95,3 +95,29 @@ docker compose -f docker-compose.prod.yml --profile jobs config
 ```
 
 真实 PostgreSQL 迁移和批量 upsert 集成测试使用 `ZHIXING_TEST_DATABASE_URL` 显式开启；普通单元测试不会访问网络、Tushare 或数据库。
+
+## 板块资金雷达 Job
+
+`sector-radar-build` 同样是外部调度器触发的一次性任务，FastAPI 不会在进程内启动定时器。它只读取 Tushare 的 `trade_cal`、`dc_index`、`dc_member`、`stock_basic`、`suspend_d`、`daily` 和 `moneyflow_dc`，保存 point-in-time 原始快照与规范化事实，再生成明确标注为“知行独立实现”的版本化指标。生产运行时不请求 OneChartLab。
+
+开发环境没有 token 时可以检查命令契约，但不能执行真实构建：
+
+```bash
+cd zhixing-server
+uv run sector-radar-build --help
+```
+
+提供 `ZHIXING_TUSHARE_TOKEN` 并完成迁移后，可构建单日、按交易日顺序回填区间，或从一个 `partial`/`failed` publication 的来源检查点继续重试。失败 publication 会复用此前已成功保存的来源组；覆盖率不足的 partial 只刷新被标记为缺口的 `daily` 或 `moneyflow_dc`，不会全量重采：
+
+```bash
+docker compose -f docker-compose.prod.yml --profile jobs run --rm sector-radar-build \
+  --trade-date 2026-08-28
+
+docker compose -f docker-compose.prod.yml --profile jobs run --rm sector-radar-build \
+  --start-date 2026-08-18 --end-date 2026-08-28
+
+docker compose -f docker-compose.prod.yml --profile jobs run --rm sector-radar-build \
+  --retry-publication-id <publication-id>
+```
+
+重复输入通过内容 hash 复用已有成功发布，不产生无意义修订；同一目标日由 PostgreSQL advisory lock 阻止并发构建。`success` 或 `unchanged` 返回 0，覆盖率不足的 `partial` 返回 2，输入、上游、锁或基础设施失败返回 1。`partial`/`failed` 会保留审计，但读取端只选择 `success` 作为 last-good。当前版本只提供手工和外部调度入口，不新增生产 Cron；待真实账号 capability、到达时点和首轮回填验证完成后再单独启用调度。