فهرست منبع

docs: docs/06 纠偏 snapshot_dt 在 missing 下的取值(/docs-check 首次审计抓到)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
tianyu.chu 1 ماه پیش
والد
کامیت
01c2a08f9a
2فایلهای تغییر یافته به همراه3 افزوده شده و 2 حذف شده
  1. 1 0
      CHANGELOG.md
  2. 2 2
      docs/06-接口文档.md

+ 1 - 0
CHANGELOG.md

@@ -9,6 +9,7 @@
 - **`docs/07-项目结构与模块`**:新接手者的"地图"——顶层目录树、apps/web · apps/api · packages · infra 各模块与关键文件职责、线上/本地运行数据流、构建与 `/look` 部署流程、本地怎么跑。
 
 ### 文档
+- **`docs/06` snapshot_dt 表述纠偏**(`/docs-check` 首次审计抓到):原写"`missing` 时 `snapshot_dt` 为 `null`",与代码不符——`null` 仅当未命中任何行;命中行但列为 NULL 的 `missing` 仍回该行 `dt`。已在 §2.2/§2.3 改准。
 - **`apps/api/README` 翻成中文并更新**:补趋势端点、`DB_SCHEMA=ads`/search_path、假数据 ~95 天、`STATIC_DIR` 单进程同源托管、真实数据由上游 ETL 写入(不经 seed/alembic)。
 - **对齐滞后文档到现状**:
   - `README`:部署段从"hypothetical nginx/conda+node20"改为实际(`/look` + uvicorn:8080 单进程同源 + 隔离 Miniconda),infra 目录说明更正,加 docs/07 指路 + 趋势两视图。

+ 2 - 2
docs/06-接口文档.md

@@ -44,7 +44,7 @@ Content-Type: application/json
 | 字段 | 类型 | 说明 |
 |----|----|----|
 | `period` | string | 回显请求周期 |
-| `snapshot_dt` | string `yyyyMMdd` \| null | 实际取数那行的 `dt`;单日=该日,近 7/30 天=rolling 的 as-of 日;`missing` 时为 `null` |
+| `snapshot_dt` | string `yyyyMMdd` \| null | 实际命中行的 `dt`;单日=该日,近 7/30 天=rolling 的 as-of 日。**仅未命中任何行时为 `null`**(命中行但列为 NULL 的 `missing` 仍回该行 `dt`) |
 | `results` | array(5) | 固定 5 步,见下 |
 | `data_status` | string 枚举 | `ready` / `missing` |
 
@@ -79,7 +79,7 @@ Content-Type: application/json
 | 值 | 含义 |
 |----|----|
 | `ready` | 目标行存在且对应列非空,正常返回 |
-| `missing` | 目标行不存在或对应列为空。**不补零**:`results` 为空、`snapshot_dt` 为 `null` |
+| `missing` | 目标行不存在,**或**命中行但对应列为 NULL。**不补零**:`results` 为空;`snapshot_dt` 仅在未命中行时为 `null`(命中行但列空时仍回该行 `dt`) |
 
 ### 2.4 错误 `422`