2 changed files with 52 additions and 9 deletions
@@ -0,0 +1,41 @@
+# 资料追溯字段核对（阶段1 · 2026-10-17）
+
+> 用途：核对资料台账所需字段与系统（后端数据模型 + 前端页面）实际字段的对应关系，确认是否满足「来源可回访、核验可追溯」的要求，并给出需补齐的字段建议。
+> 对照对象：[资料台账](material-ledger.md) 的字段 vs 后端 `knowledge_items` / `sources` / `documents` 三张表，以及前端知识管理、来源管理、知识审核页面。
+> 结论：核心追溯字段已基本覆盖，存在 5 处需补齐/确认的差异。
+
+## 一、字段对照表
+
+| 台账字段 | 系统对应字段（表） | 覆盖情况 |
+|---|---|---|
+| 编号 | `id`（自动生成） | ✅ |
+| 标题 | `title`（knowledge / documents） | ✅ |
+| 类别 | `category`（knowledge / documents，默认「未分类」） | ✅ |
+| 来源名称 | `sources.name`（经 `knowledge.source_id` 关联） | ⚠️ 见差异 1 |
+| URL | `source_url`（knowledge / sources） | ✅ |
+| 获取日期 | `collected_at`（documents 必填，knowledge 可空） | ⚠️ 见差异 2 |
+| 更新时间 | `updated_at`（自动维护） | ✅ 系统有，台账此前缺此列，已补 |
+| 正文摘要 | `content`（正文，最长 10 万字符） | ⚠️ 见差异 3 |
+| 真实性判断 | `verification_notes`（核验说明） | ✅ |
+| 核验日期 | `reviewed_at` | ✅ |
+| 核验人 | `reviewer` | ✅ |
+| 状态 | `verification_status`（pending / verified / rejected） | ✅ 三值与台账完全一致 |
+| 备注 | 无独立字段（sources / documents 有 `notes`，knowledge 无） | ⚠️ 见差异 4 |
+
+## 二、差异与建议
+
+1. **来源名称是独立实体**：知识条目本身只有 `source_url`，来源名称需先在「来源管理」登记 `sources`，再通过 `source_id` 关联。前端知识管理页目前只展示「来源网址」链接，未显示来源名称，也未在知识表单暴露 `source_id` 选择。建议：知识录入时允许选择已登记来源（`source_id`），并在列表同时显示来源名称与网址。
+
+2. **采集时间在知识条目上可空**：`documents.collected_at` 必填、`knowledge.collected_at` 可空。前端知识表单已有「采集时间」输入，但后端允许为空。为满足追溯，建议知识条目也要求填写采集时间，或强制关联到含采集时间的文档。
+
+3. **「正文摘要」无独立字段**：系统只有正文 `content`，无单独摘要列。台账中「正文摘要」作为登记用摘要；正式入库时以 `content`（正文/摘要原文）为准，两者须在核验时对齐，避免摘要与正文不一致。
+
+4. **知识条目缺通用「备注」**：`knowledge_items` 没有 `notes`，只有 `verification_notes`（核验说明）。若需在审核之外记录备注（如过期时间、待二次确认），目前只能写入核验说明或关联文档的 `notes`。建议：给知识条目增加 `notes` 字段（需范涵宇评估，仅建议，不直接改库）。
+
+5. **来源名称回填**：现有直接填 `source_url` 的条目，来源名称缺失；后续入库前应补登记到 `sources` 并关联。
+
+## 三、核对结论
+
+- 追溯核心字段（标题、类别、URL、获取/更新时间、核验状态、核验人、核验依据）系统均已支持，状态三值与审核规则一致。
+- 主要缺口集中在「来源名称的独立登记与前端展示」「知识条目通用备注」「摘要与正文的一致性」三点，需在阶段 2 入库前与范涵宇、吉海燕确认。
+- 数据库结构改动仅为建议，不由本文档直接执行。
@@ -19,21 +19,23 @@
 |---|---|---|
 | 编号 | 是 | 唯一序号，格式 `K-0001`，按登记顺序递增 |
 | 标题 | 是 | 资料的简短标题，便于检索和引用 |
-| 类别 | 是 | 四选一：红色文化 / 旅游资源 / 民宿服务 / 交通出行 |
-| 来源名称 | 是 | 发布方，如机构/媒体/网站名称 |
-| URL | 是 | 来源链接；无法溯源时填「无链接」并在真实性判断中说明 |
+| 类别 | 是 | 四选一：红色文化 / 旅游资源 / 民宿服务 / 交通出行；测试条目用「其他」并注明测试 |
+| 来源名称 | 是 | 发布方，如机构/媒体/网站名称；无来源的测试条目填「无（测试）」 |
+| URL | 否 | 来源链接；无法溯源时留空并说明 |
 | 获取日期 | 是 | 采集日期，格式 `YYYY-MM-DD` |
+| 更新时间 | 是 | 最近一次更新该条目的日期 `YYYY-MM-DD` |
 | 正文摘要 | 是 | 资料关键内容的一两句话摘要，不改变原意 |
-| 真实性判断 | 是 | 核验结论依据，如「与官方公告一致」「与另一独立来源交叉印证」「无法核实」 |
+| 真实性判断 | 是 | 核验结论依据，如「与官方公告一致」「与另一独立来源交叉印证」「无法核实」；测试条目填「无需核验（测试）」 |
 | 核验日期 | 否 | 完成核验的日期 `YYYY-MM-DD`；`pending` 时可为空 |
 | 核验人 | 否 | 完成核验的人；`pending` 时可为空 |
 | 状态 | 是 | `pending` / `verified` / `rejected` |
-| 备注 | 否 | 补充说明，如过期时间、需二次确认的事项 |
+| 备注 | 否 | 补充说明，如过期时间、需二次确认的事项、测试标记 |

 ## 登记表

-| 编号 | 标题 | 类别 | 来源名称 | URL | 获取日期 | 正文摘要 | 真实性判断 | 核验日期 | 核验人 | 状态 | 备注 |
-|---|---|---|---|---|---|---|---|---|---|---|---|
-| K-0001 | 【示例·占位】某景区简介 | 旅游资源 | 【示例来源，非真实】示例站点 | https://example.com/ | 2026-10-15 | 【示例】此处为占位摘要，非真实资料 | 待核验 |  |  | pending | 示例行，仅演示填写格式，不构成真实资料 |
+| 编号 | 标题 | 类别 | 来源名称 | URL | 获取日期 | 更新时间 | 正文摘要 | 真实性判断 | 核验日期 | 核验人 | 状态 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| K-0001 | 【示例·占位】某景区简介 | 旅游资源 | 【示例来源，非真实】示例站点 | https://example.com/ | 2026-10-15 | 2026-10-15 | 【示例】此处为占位摘要，非真实资料 | 待核验 |  |  | pending | 示例行，仅演示填写格式，不构成真实资料 |
+| K-0002 | 阶段1联调测试条目 | 其他（测试） | 无（测试） |  | 2026-10-17 | 2026-10-17 | 仅用于验证资料登记与持久化流程，不构成任何那拉提文旅事实 | 无需核验（测试） |  |  | pending | 阶段1测试条目，仅验证登记流程，不进入正式检索库，不伪装为真实资料 |

-> 上表仅含一条**示例占位行**，用于演示填写格式，不包含任何真实文旅信息。正式收集的资料按此格式逐行追加。
+> 上表 K-0001 为**示例占位行**，K-0002 为**测试条目**，均不包含真实文旅信息。正式收集的资料按此格式逐行追加。