feat: 完善多租户权限与 RAG 检索能力 #11

2026-05-22T18:51:15+08:00

TanWenyan commented

2026-05-22 18:51:15 +08:00

背景

多租户模式下，租户管理负责决定租户可用的业务功能，角色权限负责控制同租户内用户可执行的操作。
文件管理、首页入口、合同模板、RAG 对话和知识库等能力需要在前后端保持权限语义一致。
行政处罚规则需要接入 RAG 检索依据，AI 对话和规则评查需要共用稳定的检索链路。

主要改动

合同模板后端支持替换上传、删除、详情权限独立校验，并按当前用户租户范围过滤模板列表、详情和搜索统计。
首页入口保留租户已配置的文档类业务入口，避免用户缺少文件管理操作权限时误隐藏租户业务入口。
抽取 RagRetriever，统一向量检索、关键词兜底、文档引用来源构建与命中文档统计。
将卷宗评查流水线接入 RAG 检索器，行政处罚规则新增案由及裁量标准适用准确性 RAG 规则。
优化页质检预警文案，分别聚合疑似模糊与建议重拍页面。
更新前端子模块指针，包含文件权限、首页入口和合同模板替换/删除交互。

影响范围

后端：合同模板接口、首页入口接口、RAG 对话检索、卷宗评查规则执行、文档页质检摘要。
前端子模块：合同模板列表、详情、上传弹窗、首页入口显示、文件管理权限提示。
数据：新增规则配置，不引入数据库结构变更。

测试

pytest tests/test_rag_retriever.py tests/test_leaudit_rag_bridge.py tests/test_contract_template_search.py：8 passed。
python -m py_compile fastapi_modules/fastapi_leaudit/rag_engine/retriever.py fastapi_modules/fastapi_leaudit/services/impl/ragChatServiceImpl.py fastapi_modules/fastapi_leaudit/leaudit_bridge/pipeline.py fastapi_modules/fastapi_leaudit/services/impl/documentServiceImpl.py tests/test_rag_retriever.py tests/test_leaudit_rag_bridge.py：通过。
git diff --check --cached：通过。

验收建议

使用不同租户用户验证首页入口：租户已开通入口应展示，缺少文件操作权限时点击上传或列表给出无权限提示。
验证合同模板：有上传权限用户能看到上传、替换、删除按钮，无权限用户按钮隐藏或接口拒绝。
验证模板列表、详情、搜索统计只返回公共、省级和当前租户范围数据。
使用 RAG 对话提问，确认新回答和历史消息均展示文档引用来源。
使用行政处罚卷宗跑规则，确认案由及裁量标准规则能检索指定知识来源并生成评查结果。

## 背景 - 多租户模式下，租户管理负责决定租户可用的业务功能，角色权限负责控制同租户内用户可执行的操作。 - 文件管理、首页入口、合同模板、RAG 对话和知识库等能力需要在前后端保持权限语义一致。 - 行政处罚规则需要接入 RAG 检索依据，AI 对话和规则评查需要共用稳定的检索链路。 ## 主要改动 - 合同模板后端支持替换上传、删除、详情权限独立校验，并按当前用户租户范围过滤模板列表、详情和搜索统计。 - 首页入口保留租户已配置的文档类业务入口，避免用户缺少文件管理操作权限时误隐藏租户业务入口。 - 抽取 RagRetriever，统一向量检索、关键词兜底、文档引用来源构建与命中文档统计。 - 将卷宗评查流水线接入 RAG 检索器，行政处罚规则新增案由及裁量标准适用准确性 RAG 规则。 - 优化页质检预警文案，分别聚合疑似模糊与建议重拍页面。 - 更新前端子模块指针，包含文件权限、首页入口和合同模板替换/删除交互。 ## 影响范围 - 后端：合同模板接口、首页入口接口、RAG 对话检索、卷宗评查规则执行、文档页质检摘要。 - 前端子模块：合同模板列表、详情、上传弹窗、首页入口显示、文件管理权限提示。 - 数据：新增规则配置，不引入数据库结构变更。 ## 测试 - pytest tests/test_rag_retriever.py tests/test_leaudit_rag_bridge.py tests/test_contract_template_search.py：8 passed。 - python -m py_compile fastapi_modules/fastapi_leaudit/rag_engine/retriever.py fastapi_modules/fastapi_leaudit/services/impl/ragChatServiceImpl.py fastapi_modules/fastapi_leaudit/leaudit_bridge/pipeline.py fastapi_modules/fastapi_leaudit/services/impl/documentServiceImpl.py tests/test_rag_retriever.py tests/test_leaudit_rag_bridge.py：通过。 - git diff --check --cached：通过。 ## 验收建议 - 使用不同租户用户验证首页入口：租户已开通入口应展示，缺少文件操作权限时点击上传或列表给出无权限提示。 - 验证合同模板：有上传权限用户能看到上传、替换、删除按钮，无权限用户按钮隐藏或接口拒绝。 - 验证模板列表、详情、搜索统计只返回公共、省级和当前租户范围数据。 - 使用 RAG 对话提问，确认新回答和历史消息均展示文档引用来源。 - 使用行政处罚卷宗跑规则，确认案由及裁量标准规则能检索指定知识来源并生成评查结果。

TanWenyan added 1 commit 2026-05-22 18:51:15 +08:00

feat: add rag retriever bridge ba8e93c0d3

TanWenyan changed title from ~~feat: 完善多租户权限与RAG检索能力~~ to feat: 完善多租户权限与 RAG 检索能力

2026-05-22 18:51:51 +08:00

TanWenyan merged commit 62302dc312 into main

2026-05-22 18:53:02 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: TanWenyan/leaudit-platform-backend#11