leaudit-platform-backend/docs/内部公文模块/内部公文模块剩余细节与边界结论.md

内部公文模块剩余细节与边界结论

1. 文档目的

本文档只回答 2 个问题：

• 当前内部公文模块还差哪些细节没有真正收口
• 哪些问题属于运行部署边界，不能再误判成业务逻辑问题

本文档基于 2026-05-17 当前仓库、当前机器、当前联调结果整理。

---

2. 先给结论

截至当前，内部公文模块不再是“没接上”的状态。

更准确的结论是：

• 业务语义主线已经对齐
• 前后端主链路已经接通
• 报告产物主闭环已经补齐
• 当前最大的剩余问题是运行部署收口，而不是公文业务逻辑方向错误

因此后续动作应坚持一个边界：

• 可以继续补齐平台化能力和运行稳定性
• 但不要再为了排查运行问题去改动公文业务语义

---

3. 当前已经成立的事实

3.1 业务主语义已经成立

当前内部公文模块的业务主语义已经能稳定描述为：

• 主对象是 document
• 审查历史通过 run 保留
• 详情默认展示文档当前最新一次运行结果
• 结果语义仍然包括 summary / findings / checkedRules / entities / structure / outline

这与旧 govdoc-audit 的业务方向是一致的，只是承载方式换成了当前平台的 document + run + artifact 模型。

3.2 页面与接口链路已经成立

当前链路已经核实通过：

1. 浏览器访问 5173
2. nginx 转发到 5193
3. legal-platform-frontend 页面走 /api/govdoc/*
4. /api/govdoc/* 代理到当前后端 8096/api/govdoc/*
5. 当前后端路由已能实际处理请求

因此：

• 现在再出现 401，说明链路已经通了，只是没有有效登录态
• 现在再出现跳 /login，优先说明会话 cookie 不完整，而不是页面路由不存在

3.3 正式报告产物闭环已经成立

当前真实运行已验证以下产物可以生成并落库：

• annotated_docx
• html_report
• paragraph_html

并且：

• 列表与详情已经能感知这些产物是否存在
• HTML 报告、DOCX 报告、段落视图都已有当前仓库侧实现

---

4. 现在还差的细节

4.1 旧 worker 干扰还没清掉

当前机器上仍有旧进程：

• python start_worker_with_routing.py --config-port 8096
• cwd=/home/wren-dev/Porject/docauditai

这件事的影响非常直接：

• 它会让“当前页面 + 旧执行链”混在一起
• 它会导致故障判断失真
• 它会让人误以为是当前仓库业务没实现

这不是业务逻辑缺口，而是运行环境没有彻底收口。

4.2 正式启动方式还不够固化

当前 ./leaudit.sh start 在当前机器上可以把链路拉起来，但仍需注意：

• 临时 shell 启动不等于正式守护方式
• 需要确保正式重启、后台保活、日志落点都固定在当前仓库
• 要避免以后又混回旧仓库进程

4.3 登录态验收还没完整做完

当前已经确认：

• 未登录访问 /govdoc/audits 会被 requireAuth() 正常重定向到 /login
• /api/* 请求的 Authorization 依赖 access_token cookie 注入

但还没有完成一轮带真实登录态的完整验收，包括：

• 列表加载
• 详情打开
• HTML 报告打开
• DOCX 报告下载
• 段落视图联动
• 重跑与历史 run 切换

4.4 历史运行数据需要补跑

修复前已经成功但没有正式产物的旧 run，不会自动补齐。

因此仍需：

• 对需要交付报告的历史文档重新触发审查
• 确认 current_run_id 指向最新有效 run

4.5 规则来源策略还没有平台化

当前 govdoc 已经有可用规则文件：

• rules/govdoc/govdoc_general/rules.yaml

但当前仍是“单路径硬编码解析”：

• 还没有按文种/类型切换规则
• 还没有按版本切换规则
• 还没有接入统一规则管理

这不是阻塞当前链路跑通的 P0 问题，但它是后续正式化必须收口的 P1。

4.6 产物语义仍有两个小尾巴

当前最关键的正式产物已经补齐，但还有两点没完全平台化：

• canonical.docx 还没有作为显式产物沉淀
• result.json 还没有作为显式产物沉淀

这不会阻塞当前页面使用，但会影响与旧系统“完整产物语义”一一对应的程度。

---

5. 哪些问题不要再误判

5.1 跳 /login 不等于页面坏了

当前 /govdoc/audits 在服务端布局阶段就会做鉴权。

所以：

• 没有 user_info cookie 时跳转是正常行为
• 这不代表 govdoc 页面不存在

5.2 401 不等于没接后端

当前 /api/govdoc/documents 返回 401 时，更准确的含义是：

• 请求已经到达当前后端
• 只是当前请求没有有效凭证

5.3 旧 worker 活着时，不能只看页面表象下判断

只要旧 docauditai worker 还在：

• 页面报错不一定是当前仓库逻辑错
• 任务结果异常也不一定是当前仓库执行错

必须先判断任务到底被谁消费。

---

6. 后续实施边界

后续如果继续推进，建议边界固定如下：

1. 不改内部公文核心业务语义。
2. 允许继续按当前平台规范补齐运行、规则管理、产物治理。
3. 先处理运行收口，再做带登录态验收。
4. 只有在运行链路完全收口后，才继续判断剩余产品细节是否需要调整。

---

7. 一句话结论

内部公文模块当前已经进入“运行部署收口 + 平台化细节补齐”阶段。

主业务逻辑方向当前没有发现需要推翻重做的问题，真正还没做好的，主要是旧链路清退、真实登录态验收、历史数据补跑、规则来源平台化和少量产物治理细节。