# 来源选择与文档关联边界验收

## 范围与前置

原知识编辑修正 PR #50 已由真正合入 dev 的替代 PR #56 完整交付；PR #58 增加来源选择与名称展示，PR #59 维持草稿时间可空、审核前必填，并暂缓知识通用备注。本轮针对新来源选择路径开展浏览器及独立 HTTP 验收，承接 Issue #57 和 #52，不重复实现已有后端字段。

使用隔离数据库 Schema、默认 FastAPI 生命周期与 Vite；账户、101个来源、一个文档和三个知识条目均为明确标注的合成数据。网址使用 `example.com`，不代表真实文旅资料或领域质量。修正前的复现与最终验收分别使用两个全新 Schema。

## 复现与修正

1. 为一个已核验知识条目关联文档；该文档属于一个已登记来源。
2. 原页面允许将来源选为“不关联已登记来源”并保存，提示成功，但后端会根据文档恢复原来源。条目还会回到待审核；页面没有解释无法解除的原因。
3. 现在，文档关联知识的来源选择禁用、网址只读，并显示文档决定来源的说明。保存标题等其他字段时省略 `source_id` 和 `source_url`，不会提交来源重绑意图。
4. 未关联文档的条目仍能选择或解除登记来源，解除后可保留独立网址。后端仍负责关联一致性、版本和权限校验；本页不增加文档解绑功能。

![文档关联来源锁定说明](assets/source-selection-acceptance/document-source-locked.png)

## 最终浏览器验收

| 操作 | 实际结果 |
|---|---|
| 管理员打开 `/knowledge`，载入101个来源 | 下拉框包含101个来源及“不关联”选项，覆盖来源API的两页数据 |
| 普通知识选择来源API第二页的合成来源 | 网址正确回填，保存后列表显示正确来源名称与链接，条目回到 `pending` |
| 该条目的来源网址改为与登记来源冲突的值 | 显示后端错误，编辑表单保留，不提示保存成功 |
| 普通知识解除登记来源 | 列表变为“未关联”，仍保留原独立网址；重新查询确认 `source_id=null` |
| 编辑文档关联知识 | 来源控件禁用、网址只读，说明清晰；仍能保存标题修订 |
| 展开普通条目的历史 | 旧版本仍显示其当时来源名称及原微秒采集时间 |

![第二页来源实际保存后的名称与链接](assets/source-selection-acceptance/source-selected.png)

## 独立 HTTP 核对

- 来源切换、解除与文档关联标题修订的版本、来源ID/网址、审核回退均与页面结果一致；标题修订和来源操作保留原采集时间的全部微秒。
- 文档来源冲突、登记来源网址冲突返回422；过期编辑返回409；这些失败请求不改变当前条目或审计历史。
- 普通用户不能读取管理来源列表或修改知识（403）；客户端控件不代替后端权限与关联校验。
- 修改后旧文本发布返回409；保存的检索记录及原有审计事件保持一致。独立网址草稿未受其他条目操作影响。

HTTP仅用于准备合成数据、独立查询及负向接口验证，不冒充浏览器交互；浏览器操作与截图均来自实际页面。

## 验证与清理

- `cd frontend && node --test tests/datetime.test.mjs`：**6 passed**。
- `cd frontend && npm run build`：类型检查与生产构建通过。
- `git diff --check`：通过。
- 本轮没有后端代码或迁移变更，未重跑全量pytest；未运行Embedding或生成模型。
- 两个隔离Schema已分别独立查询确认不存在；自有FastAPI、Vite及数据库服务停止，临时浏览器标签关闭。原始合成记录、运行环境、账户和本机进度不入库。

仅覆盖上述来源编辑路径。原生删除确认、Docker/生产HTTPS/多浏览器/浏览器改密与真实领域资料验收继续单列；Issue #5、#52、#57 已关闭的远程状态不能替代这些剩余验收。