From 60082532a9ca68a1703d215307f37e7740069551 Mon Sep 17 00:00:00 2001 From: yxx <2412119399@qq.com> Date: Sat, 17 Oct 2026 21:32:09 +0800 Subject: [PATCH 1/2] docs: register phase 1 test entry and add update-time field Co-Authored-By: Claude Code --- docs/knowledge/material-ledger.md | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/docs/knowledge/material-ledger.md b/docs/knowledge/material-ledger.md index 28eea7b..f075e49 100644 --- a/docs/knowledge/material-ledger.md +++ b/docs/knowledge/material-ledger.md @@ -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 为**测试条目**，均不包含真实文旅信息。正式收集的资料按此格式逐行追加。 From 01d006d55f5c13e712b418e5337c6d3414c7450a Mon Sep 17 00:00:00 2001 From: yxx <2412119399@qq.com> Date: Sat, 17 Oct 2026 21:32:09 +0800 Subject: [PATCH 2/2] docs: add material traceability field feedback Co-Authored-By: Claude Code --- docs/knowledge/field-feedback.md | 41 ++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 docs/knowledge/field-feedback.md diff --git a/docs/knowledge/field-feedback.md b/docs/knowledge/field-feedback.md new file mode 100644 index 0000000..72b7226 --- /dev/null +++ b/docs/knowledge/field-feedback.md @@ -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 入库前与范涵宇、吉海燕确认。 +- 数据库结构改动仅为建议，不由本文档直接执行。