# P1 独立验收计划 ## 1. 范围 验证独立治理平台基础骨架:PostgreSQL持久队列、API、普通Worker、默认关闭的Release Worker、React状态页,以及Worker异常中断后的租约恢复。 明确不验收:PP/AList/钉钉Connector、测试WeKnora导入、生产WeKnora发布、PG/ES/OSS跨环境复制。 ## 2. 前置条件 - 在`/home/zheromiku/knowledge-governance`执行。 - Go 1.26、Node.js 22、npm和Docker Compose可用。 - 不使用生产凭据,不连接测试或生产环境。 - `secrets/postgres_password`和`secrets/pgpass`使用同一个随机本地密码,权限为600。 ## 3. 自动化检查 ```bash make test make vet make build make web-test make web-typecheck make web-build ``` 通过标准:全部退出码为0。 ## 4. 启动与健康检查 由操作者执行: ```bash docker compose up --build -d docker compose ps curl -fsS http://127.0.0.1:8088/health ``` 通过标准:PostgreSQL和API健康;Web可访问;健康响应为`{"status":"ok"}`。 ## 5. 幂等入队 连续两次发送完全相同的请求: ```bash for n in 1 2; do curl -fsS -X POST http://127.0.0.1:8088/api/v1/jobs \ -H 'Content-Type: application/json' \ -d '{"type":"demo","payload":{"round":1},"idempotency_key":"acceptance:idempotent:001"}' done ``` 通过标准:两次响应中的任务ID相同;列表中该幂等键只有一个任务;任务最终为`completed`。 ## 6. Worker租约恢复 1. 创建60秒本地任务: ```bash curl -fsS -X POST http://127.0.0.1:8088/api/v1/jobs \ -H 'Content-Type: application/json' \ -d '{"type":"demo.sleep","payload":{"sleep_ms":60000},"idempotency_key":"acceptance:lease:001"}' ``` 2. 在状态页或列表API确认任务进入`running`且`attempt=1`。 3. 强制终止普通Worker: ```bash docker compose kill -s KILL worker ``` 4. 重新启动Worker: ```bash docker compose up -d worker ``` 5. 等待原租约到期(最多35秒)并持续查询: ```bash curl -fsS 'http://127.0.0.1:8088/api/v1/jobs?limit=50' ``` 通过标准:同一个任务被重新领取,`attempt=2`;继续等待后进入`completed`。不得产生第二条同幂等键任务。 ## 7. Release Worker默认关闭 ```bash docker compose logs --no-color release-worker ``` 通过标准:日志包含`release worker disabled`;没有`release worker started in probe-only mode`;没有任何测试或生产外部连接配置。 ## 8. 状态页 打开`http://127.0.0.1:8088/`: - 页面标题为“知识同步治理平台”。 - 显示任务总数、运行中、待重试、失败、已完成。 - 显示最近50条任务及尝试次数。 - 页面明确显示“Release Worker 默认关闭”。 - 桌面端无页面级横向溢出;窄屏仅任务表自身可横向滚动。 ## 9. 停止与保留数据 ```bash docker compose down ``` 通过标准:容器停止,`governance-pgdata`卷保留。未经单独确认不得执行`docker compose down -v`。 ## 10. 验收记录 记录每一步的时间、退出码、任务ID和最终状态。任何步骤失败时停止扩展,不连接WeKnora或来源系统,以失败证据定位P1本身。