docs: add knowledge review templates
This commit is contained in:
@@ -0,0 +1,25 @@
|
||||
# 联调验收记录
|
||||
|
||||
> 用途：记录每次联调/验收的日期、人员、环境、操作与结果，保证测试过程可追溯。
|
||||
> 维护人：杨星萱
|
||||
|
||||
## 字段说明
|
||||
|
||||
| 字段 | 必填 | 说明 |
|
||||
|---|---|---|
|
||||
| 日期 | 是 | 联调/验收日期 `YYYY-MM-DD` |
|
||||
| 人员 | 是 | 参与本次联调/验收的成员 |
|
||||
| 环境 | 是 | 如「本机 Windows + Docker PostgreSQL + FastAPI + Vite」及版本号 |
|
||||
| 操作 | 是 | 具体操作步骤，如「POST /api/knowledge 新增一条资料」 |
|
||||
| 预期结果 | 是 | 操作前预期的结果 |
|
||||
| 实际结果 | 是 | 实际观察到的结果（成功/失败/异常） |
|
||||
| 截图/日志位置 | 否 | 相关截图或日志的存放路径 |
|
||||
| 结论 | 是 | 通过 / 不通过 / 阻塞，及原因与下一步 |
|
||||
|
||||
## 登记表
|
||||
|
||||
| 日期 | 人员 | 环境 | 操作 | 预期结果 | 实际结果 | 截图/日志位置 | 结论 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 【示例】2026-10-15 | 【示例】杨星萱 | 【示例】本机浏览器 | 【示例】打开知识管理页 | 【示例】页面正常展示 | 【示例】此处为占位，非真实结果 | 【示例】docs/screenshots/ | 【示例】待执行 |
|
||||
|
||||
> 上表仅含一条**示例占位行**，用于演示填写格式，不含任何真实测试结果。
|
||||
@@ -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 | 示例行，仅演示填写格式，不构成真实资料 |
|
||||
|
||||
> 上表仅含一条**示例占位行**，用于演示填写格式，不包含任何真实文旅信息。正式收集的资料按此格式逐行追加。
|
||||
@@ -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`，关键事实需至少一个独立来源印证。
|
||||
- 时效性：注明信息发布时间，避免使用明显过时内容。
|
||||
- 边界一致：首版不承诺实时房态、实时价格、自动联网核验等，此类信息不按可靠事实收录。
|
||||
|
||||
> 本规则为草案，判定标准与流程以负责人确认为准。
|
||||
Reference in New Issue
Block a user