Przeglądaj źródła

docs: /docs-check 复扫修 3 处残留漂移(鉴权引用/空态措辞/query范围指引)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
tianyu.chu 1 miesiąc temu
rodzic
commit
824dbf8b1f
3 zmienionych plików z 5 dodań i 4 usunięć
  1. 1 0
      CHANGELOG.md
  2. 2 2
      docs/02-技术架构.md
  3. 2 2
      docs/06-接口文档.md

+ 1 - 0
CHANGELOG.md

@@ -8,6 +8,7 @@
 - **PRD(`docs/01`)对齐现状 + 补完整性**:
   - 对齐:阶段改「已内网上线」、补 06-26/06-29 修订记录;§3 范围与 §8 验收补入**趋势视图**;§7 去掉与趋势矛盾的"不做自定义日期范围"(趋势已支持自定义起止);空态文案「数据缺失」→「暂无数据」。
   - 补充:§1.2 业务目标与成功指标、§1.3 目标用户与典型场景、§1.4 访问与权限(现状内网无鉴权、对外前须补)。
+- **`/docs-check` 全套复扫**(只读、未派子代理):修掉 3 处残留漂移——`docs/06` 鉴权交叉引用 §7→§1.4、`docs/02` 空态措辞对齐「暂无数据」、`docs/02` §5 标注 `/query` 不含自定义范围(趋势见 §5.1);其余(接口/口径/表结构/IA/结构/部署)均一致。
 
 ## 2026-06-29
 

+ 2 - 2
docs/02-技术架构.md

@@ -90,7 +90,7 @@ POST /api/funnels/query
 
 - `period` ∈ `day`(单日) | `last_7d` | `last_30d`。
 - `snapshot_dt`(可选,`yyyy-MM-dd`):**仅对 `day` 有意义**。省略=最新(昨日),给值=该历史日;上限昨日(T+1),今天/未来 → 422。`last_7d`/`last_30d` 忽略该字段。
-- MVP 不接受任意 `steps`、不接受自定义日期范围。
+- 本端点(`/query`)不接受任意 `steps`、不接受自定义日期范围(趋势的自定义起止见 §5.1)
 
 响应字段:
 
@@ -196,7 +196,7 @@ MVP 不引入:
 - 周期选择(单日 / 近 7 天 / 近 30 天),默认单日。
 - 单日日历:今天/未来不可选;选历史日重查。
 - 图表渲染、表格渲染。
-- `missing` 数据缺失空态、错误态。
+- `missing` 「暂无数据」空态、错误态。
 
 ## 9. 前端模块结构与路由
 

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

@@ -6,9 +6,9 @@
 | 项 | 内容 |
 |----|----|
 | 阶段 | MVP 开发中(未发布) |
-| 更新日期 | 2026-06-26 |
+| 更新日期 | 2026-07-03 |
 | Base URL(本地) | `http://localhost:8000` |
-| 鉴权 | MVP 暂无(内网访问);对外开放前需加鉴权,见 `docs/01` §7 |
+| 鉴权 | MVP 暂无(内网访问);对外开放前需加鉴权,见 `docs/01` §1.4 |
 
 ## 1. 健康检查