案例
项目概述
QKIT NEXUS 是一套多租户 SaaS 平台，目的是让企业在同一系统内运行 AI 工具与运营管理功能，而不必分别采购多个产品再自行拼接。
难点在于各功能域差异很大——AI 聊天机器人、知识库、内容管理、营销自动化、客户管理——却共用同一层底座：当前是哪个租户、该用户能看到哪些数据、以及如何确保一个租户的数据绝不流向另一个租户。大部分设计工作落在这层底座上，而不在单个功能上。
系统采用多租户架构与多级授权，可按租户与工作区扩展，界面支持三种语言：越南语、英语与希伯来语。
案例
实施范围
- 租户与工作区管理
- 用户、角色与权限管理
- 基于 RAG 架构的 AI 聊天机器人与知识库
- 内容管理与博客发布
- 营销工作流与潜在客户管理
- 实时聊天
- 通过 API 与 webhook 对接外部 AI 服务
- 可嵌入第三方网站的聊天机器人组件
参与角色
承担工作
Project Leader / Lead Full-stack Engineer
- 业务需求分析，编写 BRD 与 PRD
- 系统架构与多租户架构设计
- 后端与前端管理后台开发
- 认证、授权、角色与权限设计
- 租户与工作区数据隔离
- 指导后端开发并进行实现评审
- 生产部署、性能与可扩展性优化
案例
核心功能
多租户与工作区
每个租户拥有独立数据空间，内部再划分为工作区。权限在两级同时校验，因此隶属多个工作区的用户仍只能看到分配给他的部分。
基于专属知识库的 AI 问答
各租户的文档经向量化后按 RAG 架构检索，回答依据该租户自有资料，而非模型的通用知识。
认证与授权
JWT 配合 refresh token，角色与权限可配置，所有数据查询在触达数据库前均经过租户校验。
实时与后台处理
聊天与通知通过 Socket.IO 传输；文档向量化、批量发送等长任务进入队列处理，不占用用户请求。
可嵌入组件
聊天机器人封装为可嵌入第三方网站的组件。运行环境不可控，因此必须自行限定作用域并自行处理连接失败。
内容与营销
内容撰写发布、潜在客户管理与营销工作流，与平台其余部分共用同一套权限体系。
架构与技术
技术难点
租户数据隔离
SaaS 平台最大的风险：一条漏掉租户条件的查询就是一起数据泄露事故。隔离下沉到数据访问层并拆分 Prisma schema，而不是依赖每位开发者在每个调用点记得加条件。
两级授权
租户级与工作区级权限可能互相冲突。权限模型必须明确规定何者优先，并且在后端与界面给出一致的答案。
RAG 检索质量
聊天机器人只有检索到正确段落才有价值。难点不在调用模型，而在文档切分、向量化与排序——而各租户的资料质量差异极大。
按租户扩展
负载分布并不均匀：一个大租户可能超过上百个小租户之和。后端按模块拆分并以事件通信，使承压部分可独立扩展。
案例
成果
- 平台运行于多租户架构，具备数据隔离与两级授权
- AI 聊天机器人基于各租户自有知识库、按 RAG 架构作答
- 界面支持越南语、英语与希伯来语三种语言
- 聊天机器人封装为可嵌入第三方网站的组件
案例
项目图片
租户管理后台 AI 聊天机器人与知识库 工作区与权限管理
服务