# P2.3 PP完整来源清单验收 ## 交付范围 - 将旧manifest中54个超过50 MiB、未进入旧账本终态的来源建模为阻断对象; - 形成613个PP来源对象的统一治理快照; - reconciliation以内容SHA revision为依据,同URL内容变化必须计划上传; - 历史已同步快照与治理数据库一致时,计划上传数必须为0; - 提供只读分页/状态筛选API和真实知识资产Web页面。 不在本阶段执行:来源网络访问、文件下载或上传、测试/生产WeKnora连接、生产发布、AList写操作、钉钉授权、commit或push。 ## 数据契约 ```text source_items=613 completed=530 content_alias=29 over_limit=54 content_objects=530 source_item_versions=613 test_publications=530 planned_uploads=0 ``` 54个over_limit版本必须同时满足: ```text content_state=over_limit content_object_id IS NULL download_error=legacy_50_mib_limit 关联TestPublication数量=0 ``` ## Reconciliation契约 - stable source key相同且SHA revision相同:unchanged; - stable source key不存在:adopted; - stable source key相同但SHA revision变化:upload_required; - over_limit:始终计为阻断,不计划上传; - 完整真实快照:unchanged=559、over_limit=54、upload_required=0。 ## 只读API ```text GET /api/v1/source-items?state=&limit=50&offset=0 GET /api/v1/source-items?state=over_limit&limit=100&offset=0 ``` `state`只接受`completed`、`content_alias`、`over_limit`或空值;`limit`范围1..100;`offset`范围0..1000000。响应只投影安全治理字段,不返回stable external ID、URI hash、raw_record_summary、Knowledge ID、来源URL、签名URL或凭据。 ## UI验收 “知识资产”页必须读取真实API,并显示: - 来源对象613; - 历史已同步530; - 内容别名29; - 超过上限54; - 状态筛选和服务端分页; - over_limit项显示“超过旧同步上限”和“阻断”。 桌面宽度1440px必须无页面级横向溢出。多标签工作台、左侧导航和刷新恢复行为保持不变。 ## 数据库升级门禁 1. 在唯一临时数据库导入真实613项两次; 2. 首次新增`1/613/530/613/530`; 3. 第二次新增全0; 4. 验证54个阻断版本约束; 5. 当前库升级前创建非空、mode 600且通过`pg_restore --list`的自定义格式备份; 6. 当前库只增量新增54个SourceItem和54个Version; 7. 不重启或删除PostgreSQL卷。 ## 自动门禁 ```bash /home/zheromiku/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.0.linux-amd64/bin/go test ./... -count=1 /home/zheromiku/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.0.linux-amd64/bin/go vet ./... /home/zheromiku/go/pkg/mod/golang.org/toolchain@v0.0.1-go1.26.0.linux-amd64/bin/go build ./cmd/... npm --prefix web test -- --run npm --prefix web run typecheck npm --prefix web run build ```