From 4e16a635aa5956604a4d089004a3f9aa60549ed5 Mon Sep 17 00:00:00 2001 From: jhy <184825448@qq.com> Date: Thu, 15 Oct 2026 19:51:50 +0800 Subject: [PATCH] docs: add knowledge review templates --- docs/knowledge/acceptance-record.md | 25 ++++++++++++++ docs/knowledge/material-ledger.md | 39 +++++++++++++++++++++ docs/knowledge/review-rules.md | 53 +++++++++++++++++++++++++++++ 3 files changed, 117 insertions(+) create mode 100644 docs/knowledge/acceptance-record.md create mode 100644 docs/knowledge/material-ledger.md create mode 100644 docs/knowledge/review-rules.md diff --git a/docs/knowledge/acceptance-record.md b/docs/knowledge/acceptance-record.md new file mode 100644 index 0000000..7264089 --- /dev/null +++ b/docs/knowledge/acceptance-record.md @@ -0,0 +1,25 @@ +# 联调验收记录 + +> 用途:记录每次联调/验收的日期、人员、环境、操作与结果,保证测试过程可追溯。 +> 维护人:杨星萱 + +## 字段说明 + +| 字段 | 必填 | 说明 | +|---|---|---| +| 日期 | 是 | 联调/验收日期 `YYYY-MM-DD` | +| 人员 | 是 | 参与本次联调/验收的成员 | +| 环境 | 是 | 如「本机 Windows + Docker PostgreSQL + FastAPI + Vite」及版本号 | +| 操作 | 是 | 具体操作步骤,如「POST /api/knowledge 新增一条资料」 | +| 预期结果 | 是 | 操作前预期的结果 | +| 实际结果 | 是 | 实际观察到的结果(成功/失败/异常) | +| 截图/日志位置 | 否 | 相关截图或日志的存放路径 | +| 结论 | 是 | 通过 / 不通过 / 阻塞,及原因与下一步 | + +## 登记表 + +| 日期 | 人员 | 环境 | 操作 | 预期结果 | 实际结果 | 截图/日志位置 | 结论 | +|---|---|---|---|---|---|---|---| +| 【示例】2026-10-15 | 【示例】杨星萱 | 【示例】本机浏览器 | 【示例】打开知识管理页 | 【示例】页面正常展示 | 【示例】此处为占位,非真实结果 | 【示例】docs/screenshots/ | 【示例】待执行 | + +> 上表仅含一条**示例占位行**,用于演示填写格式,不含任何真实测试结果。 diff --git a/docs/knowledge/material-ledger.md b/docs/knowledge/material-ledger.md new file mode 100644 index 0000000..28eea7b --- /dev/null +++ b/docs/knowledge/material-ledger.md @@ -0,0 +1,39 @@ +# 资料台账 + +> 用途:登记候选资料及其核验状态,是资料进入正式检索库前的唯一登记入口。未核验(`pending`)资料不得进入正式检索。 +> 维护人:杨星萱(知识库、实验与文档负责人) + +## 状态约定 + +| 状态 | 含义 | +|---|---| +| `pending` | 待核验:已登记,尚未完成真实性/时效性核验 | +| `verified` | 可正式使用:来源可靠、交叉印证通过、可进入正式检索 | +| `rejected` | 不采用:来源不可靠、信息过时或被证伪 | + +> 详细判定标准见 [审核规则](review-rules.md)。 + +## 字段说明 + +| 字段 | 必填 | 说明 | +|---|---|---| +| 编号 | 是 | 唯一序号,格式 `K-0001`,按登记顺序递增 | +| 标题 | 是 | 资料的简短标题,便于检索和引用 | +| 类别 | 是 | 四选一:红色文化 / 旅游资源 / 民宿服务 / 交通出行 | +| 来源名称 | 是 | 发布方,如机构/媒体/网站名称 | +| URL | 是 | 来源链接;无法溯源时填「无链接」并在真实性判断中说明 | +| 获取日期 | 是 | 采集日期,格式 `YYYY-MM-DD` | +| 正文摘要 | 是 | 资料关键内容的一两句话摘要,不改变原意 | +| 真实性判断 | 是 | 核验结论依据,如「与官方公告一致」「与另一独立来源交叉印证」「无法核实」 | +| 核验日期 | 否 | 完成核验的日期 `YYYY-MM-DD`;`pending` 时可为空 | +| 核验人 | 否 | 完成核验的人;`pending` 时可为空 | +| 状态 | 是 | `pending` / `verified` / `rejected` | +| 备注 | 否 | 补充说明,如过期时间、需二次确认的事项 | + +## 登记表 + +| 编号 | 标题 | 类别 | 来源名称 | URL | 获取日期 | 正文摘要 | 真实性判断 | 核验日期 | 核验人 | 状态 | 备注 | +|---|---|---|---|---|---|---|---|---|---|---|---| +| K-0001 | 【示例·占位】某景区简介 | 旅游资源 | 【示例来源,非真实】示例站点 | https://example.com/ | 2026-10-15 | 【示例】此处为占位摘要,非真实资料 | 待核验 | | | pending | 示例行,仅演示填写格式,不构成真实资料 | + +> 上表仅含一条**示例占位行**,用于演示填写格式,不包含任何真实文旅信息。正式收集的资料按此格式逐行追加。 diff --git a/docs/knowledge/review-rules.md b/docs/knowledge/review-rules.md new file mode 100644 index 0000000..62adce1 --- /dev/null +++ b/docs/knowledge/review-rules.md @@ -0,0 +1,53 @@ +# 审核规则 + +> 用途:规定资料的核验状态、判定标准与核验流程,是资料能否进入正式检索库的统一依据。 +> 状态:本规则为**草案**,由杨星萱起草,需经确认后定稿。 +> 维护人:杨星萱 + +## 一、状态定义 + +| 状态 | 含义 | 能否进入正式检索库 | +|---|---|---| +| `pending` | 待核验:已登记,但来源可靠性、时效性或关键信息完整性尚未确认 | 否 | +| `verified` | 可正式使用:来源可靠、关键事实交叉印证、时效性满足需求、信息完整 | 是 | +| `rejected` | 不采用:来源不可靠、信息被证伪/与权威来源冲突、严重过时、或无法核验且影响关键事实 | 否 | + +## 二、判定标准(草案) + +### 标记为 `verified` 需同时满足 + +1. 来源可靠(官方文旅/景区/政府公告,或可溯源的权威媒体)。 +2. 关键事实与至少一个独立来源交叉印证一致。 +3. 信息时效性满足当前使用需求(未过期、未失效)。 +4. 关键信息完整,无影响结论的缺失。 + +### 标记为 `pending` 的情形 + +- 来源可靠性存疑,尚待核实。 +- 关键事实暂无法交叉印证。 +- 信息可能过期,但尚未确认。 +- 关键信息缺失,需要补充后再判。 + +### 标记为 `rejected` 的情形 + +- 来源不可靠(无法溯源的个人自媒体、无依据转载等)。 +- 信息已被证伪,或与权威来源冲突。 +- 信息严重过时,不再适用。 +- 无法核验,且该事实对结论有实质影响。 + +## 三、核验流程 + +1. 采集登记:在 [资料台账](material-ledger.md) 登记基础字段,状态先置 `pending`。 +2. 来源可靠性判断:确认发布方可溯源、权威性可接受。 +3. 真实性判断:关键事实与独立来源交叉印证。 +4. 时效性判断:确认信息当前仍适用。 +5. 定状态:根据判定标准置 `verified` / `rejected`,并填写核验日期、核验人、真实性判断说明。 + +## 四、核验要点 + +- 来源权威性排序(参考):官方文旅局/景区官网/政府公告 > 权威媒体 > 一般网站/个人自媒体。 +- 多源交叉:单一来源不足以定为 `verified`,关键事实需至少一个独立来源印证。 +- 时效性:注明信息发布时间,避免使用明显过时内容。 +- 边界一致:首版不承诺实时房态、实时价格、自动联网核验等,此类信息不按可靠事实收录。 + +> 本规则为草案,判定标准与流程以负责人确认为准。