多租户 AI 智能客服系统

1、立项背景和目标
当前企业线上获客沟通场景中，传统客服人力成本高，夜间无人值守容易流失意向客户，网站访客咨询过程中的手机号、企业名称、业务诉求等线索难以自动采集留存。本项目搭建多租户商用 AI 智能客服 SaaS 系统，支持私有化部署与源码二次开发，目标实现 7×24 小时 AI 接待、人机协同会话，自动抓取对话内客户线索，支持 JS 代码嵌入 SEO 站点、外部官网，统一管理访客咨询，降低企业客服人力压力，沉淀意向客户线索，形成咨询‑线索‑人工跟进的完整业务闭环。
2、软件功能、核心功能模块的介绍
系统采用前后端分离架构，分为访客端、客服工作台、租户管理后台、超级管理员平台四大模块。访客端提供悬浮聊天弹窗，支持消息提示音、已读未读状态，区分在线 / 离线状态；AI 对话模块对接大模型 + 租户独立知识库，支持知识库问答。线索采集模块自动识别提取对话内手机号、公司名称、客户需求，线索统一入库。嵌入代码管理模块生成 JS 跟踪代码，可挂载至外部 SEO 站点。租户后台包含知识库管理、线索管理、会话记录、站点嵌入配置、数据统计、系统备案信息配置；客服工作台支持坐席接待会话、接管 AI 对话，查看访客线索；超级管理员实现多租户管理、账号权限管控、系统全局配置；系统区分演示模式与生产模式，演示加载 Mock 模拟数据，生产环境真实落库，生产环境移除演示账号，具备图形验证码、高强度密码校验等安全能力。
3、业务流程、功能路径描述
企业租户注册登录后台，维护业务知识库，生成 JS 嵌入代码部署到自身 SEO 站点或官网。网站访客点击悬浮客服窗口发起咨询，AI 优先进行应答，对话过程自动捕捉手机号、公司名称、业务需求并保存为线索。访客咨询复杂问题可转接人工坐席，坐席在工作台接收会话，查看已提取的客户线索开展沟通；会话全程留存聊天记录。租户管理员可在后台查看全部会话、线索数据，管理嵌入站点、修改 ICP 备案与联系信息。超级管理员负责多租户管理、全局权限管控；系统演示模式用于产品效果预览，不影响正式生产业务数据隔离。

1、整体架构和设计思路，不同模块使用的技术栈
本项目采用前后端分离 SaaS 多租户架构，按租户数据隔离原则进行设计，区分演示 Mock 环境与正式生产环境，实现 AI 客服、线索采集、外部站点嵌入完整业务。前端使用 Vue3+Vite+NaiveUI+SCSS，实现访客聊天弹窗、客服工作台、租户后台、超级管理后台，完成深浅色模式、多端响应式适配；后端基于 SpringBoot+MyBatis‑Plus，数据库选用 MySQL8.0，实现权限控制、线索识别、会话管理、JS 嵌入代码生成、知识库管理，集成图形验证码安全校验；AI 能力对接外部大模型接口，外部站点通过 JS 脚本跨域接入本客服系统，所有业务数据按租户维度隔离存储。
2、“我” 的负责模块和结果 (尽可能量化)
本人负责整体需求梳理、PRD 文档编写、前后端功能设计、多租户权限体系设计、外部 SEO 站点嵌入方案、线索自动采集模块、账号安全机制、演示 / 生产环境隔离逻辑。完成 4 大业务模块设计，实现 3 类角色权限管控，支持 JS 代码快速对接外部网站；实现对话自动提取手机号、公司名称、客户需求线索；完成演示 Mock 数据与生产真实数据隔离，新增图形验证码、强密码校验等安全能力；输出完整初始化脚本与测试用例，支撑私有化部署、源码交付，满足商用 SaaS 交付标准。
3、“我” 遇到的难点、坑，和解决方案
难点一：多租户场景下数据隔离，容易出现租户间数据泄露风险。解决方案：所有业务表增加租户 ID 字段，后端接口统一拦截过滤租户条件，严格隔离查询范围。
难点二：外部 SEO 站点 JS 嵌入跨域、样式冲突问题。解决方案：采用 iframe 隔离嵌入，统一处理跨域请求，样式独立封装不受宿主页面干扰。
难点三：演示环境与生产环境混用，存在演示账号泄露安全隐患。解决方案：生产环境自动清除 demo、agent01 演示账号，仅保留超级管理员 admin，首次登录强制修改密码，区分 Mock 模拟数据与真实数据库写入逻辑。