「标准知识库独立版」是一套可私有化部署的多租户企业知识库与智能问答平台。背景是资料散落在文档、网页、FAQ 中难以问答,而通用 SaaS 满足不了多租户强隔离与租户内细粒度权限。全局规则强制五层校验、禁止裸写不带 tenant_id 的 SQL、禁止业务模块自写权限判断。工程目标是零外部依赖即可跑通全链路(向量库、Embedding、LLM、限流均可切换或降级)、越权可证明(576 用例 0 失败)、能力可插拔。交付形态为 Spring Boot 单体后端、Vue3 PC 管理端、uni-app 小程序问答端与契约文档;功能覆盖认证、租户隔离、组织成员、权限中心、向量底座、知识库、文档切片、检索问答、分享、API 密钥、审计与配额监控
请求依次经 JWT 过滤器(校验 X-Tenant-Id 与 token 租户一致)、租户 Filter(建上下文与跨租户拦截)、TenantInterceptor(归属校验)、权限与数据范围切面、审计切面,Service 层由权限 SDK 决策、拦截器保证 SQL 带租户,VO 层脱敏裁剪。
登录先定租户再定位账号(一账号仅属一租户),校验租户状态、BCrypt 密码与 TOTP 后签发 JWT,成败均审计。租户开通即初始化配额,注销走延迟删除定时任务;跨租户访问受双防线加总开关控制并强制审计。组织侧维护部门树(path 与环校验)与邀请,公开邀请以邀请记录租户为准建号并原子占用。
权限决策链为功能权限 → 黑名单 → 文档 ACL(ALLOW 放大、DENY 收敛)→ 数据范围(USER 覆盖 ROLE 取最宽、再部门继承)→ 默认拒绝;变更走事件加主动失效加 5 秒 TTL,拒绝双写审计,模拟器与接口共用同一决策。
文档有五种录入方式,状态机 PENDING_PARSE→PARSED→VECTORIZING→INDEXED→归档/删除;按类型路由解析引擎、按库配置切片;文档 hash 去重、切片 content_hash 命中即复用向量实现增量更新,仅对未向量化切片调 Embedding;任务队列在插入前校验租户并发配额。
问答先过限流与配额,再做改写与多轮上下文(按租户+KB 隔离),向量召回(底座强制租户与 kbId 过滤)与内存 BM25 双路经 RRF 融合,随后逐条静默过滤(切片开关、文档状态、ACL、黑名单、范围、业务条件)、词重叠重排、生成答案(FAQ 取 top1,其余拼接,LLM 失败或无命中则转人工/降级抽取)、脱敏,最后落会话与引用溯源。
分享令牌非 JWT,先忽略拦截器按全局唯一 token 定位再重建租户上下文,依次校验租户开关、KB 状态、有效期、密码、次数(原子更新防超卖),问答以创建者为权限主体。密钥只存 SHA-256,Filter 校验存在/启停/过期/IP 并覆盖租户、主体设为创建者,业务层再校验 scope 与绑定 KB,最终复用同一套文档与问答服务。
审计由注解切面统一写入,缺 tenant_id 即丢弃,租户段仅本租户、平台段用平台管理员守卫;监控做八维配额校验、Redis 限流(故障降级内存)、超阈告警冷却去重后发本租户站内信;小程序按邀请码/域名/手机号识别租户后复用问答链路。