docs: 活文档§17 首夜巡查修正——margin_sse T+1 结构根治/NAS 同步链扩容/回灌纪律/VPS 部署终态(同批同步,防失传) [nas]
CI/CD / test (push) Successful in 0s
CI/CD / nas-deploy (push) Successful in 6s
CI/CD / nas-verify (push) Successful in 14s

This commit is contained in:
2026-09-02 23:09:19 +08:00
parent 564160db11
commit 99355bfbea
@@ -3,7 +3,7 @@
> 日期:2026-07-21 创建 | 基于 brainstorming + 4 源全能力调查(akshare / baostock / miniQMT / csindex)
> **状态:活文档(唯一数据设计文档)** —— 2026-09-02 起用户钦定:本文件是数据架构唯一权威设计,
> 每次数据架构变更必须同批更新到最新状态;演进采用「日期节追加,新节覆盖旧节相关决策」模式。
> 最后更新:2026-09-02(A 档截面数据域全量上生产,§15;使用层 provider 接口,§16)
> 最后更新:2026-09-02(A 档截面数据域全量上生产,§15;使用层 provider 接口,§16;首夜巡查修正,§17)
---
@@ -386,6 +386,23 @@ baostock 栈=bs_* 系列,xtdata 栈=daily_update_xtdata,新浪指数=sina_index_
FETCHERS 注册表新增两键即自动可被未来 provider MCP server 暴露
(`Fetcher.fetch(ctx=provider, **kwargs)` 直接调用,fetchers 包设计初衷)。
## 17. 增补 2026-09-02 深夜:首夜巡查修正(覆盖 §15 相关决策)
- **首夜实绩(09-02 19:30,13 类)**: 12/13 绿——快照族 6/6 行数与双机实验一致
(资金流 90/387、同花顺 90/375、雪球 5634、新浪行业 49);唯一红=margin_sse(下条)。
- **margin_sse 结构性缺陷根治(用户批准)**: SSE 融资融券 **T+1 供应**(当晚拉当天→空响应
→akshare Length mismatch 崩),自 07-22 起慢性失血 43 天全空(旧码 empty+done 锁死,
缺日检查未覆盖老四类故无人发现)。修=①`--force` 回补 0722~0901(30/30 ok 59865 行,
VPS+NAS 双端);②wrapper 拆 margin_sse 单独 **T-1~T 两天窗**(564160d):每晚稳定写昨日,
当天失败不写不标、次晚同窗自愈。
- **NAS 同步链扩容(ab8f4e3)**: `sync_parquet_daily.sh` TYPES 原写死老 4 类——扩到 13 类;
gdhs=per-period 季度日期永不落 7 天滚动窗,单独全量拉(≤10 文件幂等)。⚠️NAS 坑:03:00 链
以 root 跑留 root 属主文件,admin scp 覆盖之=Permission denied,先 rm 再拉。
- **回灌纪律(zt_pool 0902 事故)**: 回灌窗口**绝不含当日**——盘前拉当日=拿到上一交易日态
复制品(0902 文件≡0901 逐值同)+marker 占位致当晚 19:30 跳过;已删+盘后重拉 52/15/8 真数据。
- **VPS 部署终态**: 使用层 3 commit(4966d30/7f01c5f/564160d)推 VPS(run#1043,tag=564160d,
gap=0),VPS 端 8/8 功能验证过(双层接口/区间滤日/回补数据可读/白名单拒绝/实盘方法面)。
## 参考(调查来源)
- xtdata 官方:https://dict.thinktrader.net/nativeApi/xtdata.html