Ai Chat产品系统

【痛点与立项原因】
当前市面上流通的AI对话系统源码，绝大多数属于“拼凑型”的CRUD模板。这类系统往往只能演示最基础的对话，缺乏生产环境所需的并发控制、Token成本管控、数据安全隔离以及完善的后台管理体系。企业内网想要接入大模型，常面临数据泄露给公有云、员工滥用API导致费用失控、缺乏权限审计等致命问题；而计算机专业的毕设/论文群体，苦于找不到架构完整、有技术深度的全栈项目，大量使用SSM或简单JSP系统，难以在答辩中体现工程化水平。正是基于这些行业痛点，我立项并独立自研了这套“全栈AI对话系统”，旨在提供一个真正能够投入商业运营、私有化部署的完整解决方案。

【行业场景与业务背景】
这套源码的业务背景定位于三大核心场景：

毕设与论文：为大学生提供一套符合现代互联网企业级架构的全栈项目，自带完整的架构图、ER图、数据库迁移版本，并且提供论文技术章节辅导和答辩预演，解决毕设“没亮点、不会写论文、答辩被怼”的痛点。

企业内网私有化：为企业提供数据不出内网的AI解决方案。支持接入本地大模型，支持BYOK（每个员工配置自己的API Key），管理员可在后台按人、按模型、按日审计Token用量，让企业用AI既安全又可控。

二次开发与商用：为开发者或创业团队提供一个高起点的底座。这不是一个玩具项目，而是可以立即投入生产、进行商业变现的完整系统。它采用前后端共享Zod契约的模式，改一个字段前端立刻报错，全中文注释详细说明了技术取舍，极大地降低了后续二次开发的维护成本。

【核心价值】这套源码不仅是代码的交付，更是一套经过6周136次提交、3.6万行代码验证的工程化实践。通过Docker一键部署、Nginx SSE调优等生产级配置，帮助客户节省数月研发时间，直接跨过从“Demo”到“产品”的鸿沟，这是本项目在行业内独一无二的核心价值。

本项目拥有覆盖AI对话全生命周期的完整功能模块，堪称企业级AI应用的功能标杆：

【核心对话模块】

真·SSE流式对话：采用真正的Server-Sent Events，实现极致的打字机输出效果。底层加入了心跳防断连机制和会话级锁，从根本上杜绝了高并发场景下的踩踏问题，保障对话稳定流畅。

上下文智能管理：系统会根据Token预算智能裁剪上下文，特别针对中英文进行分开估算，确保请求不炸上游接口报错，最大化利用大模型的上下文窗口。

多模态问答：支持图片和文本附件上传，后端直接对接MinIO进行文件直传，并且具备孤儿文件自动清理机制，极大地节省服务器存储空间。

【管理与安全模块】

多模型后台管理：管理员可在后台自由配置多个大模型，温度、max_tokens、上下文窗口、默认模型等参数全部可视化配置，一键切换。

BYOK与审计体系：支持每人使用自己的API Key，系统按人、按模型、按日进行Token用量审计，彻底解决企业用AI的费用管控难题。

企业级认证体系：构建了极高的安全水位，包含双令牌认证、会话吊销、tokenVersion强制踢下线、邮箱验证码、图形验证码以及API限流，能够有效抵御常见Web攻击。

【会话与分享模块】

快照式分享：用户可以将对话生成分享链接，支持密码保护、设置有效期、访问计数。最大的亮点是“快照”机制，即使原会话被删除了，分享链接依然可以查看，极大地提升了内容分享的实用性。

会话管理功能：包含会话置顶、全文搜索、回收站（防误删）、以及导出Markdown与Word（公式自动转换）功能，完全对标商业级SaaS应用。

【后台与运维模块】

完整管理后台：提供成员管理、模型管理、分享管理、用量管理的完整后台控制面板。

一键部署：提供docker compose一条命令起全套的服务能力，Nginx配置已针对SSE进行了专门调优（如关闭缓冲、

【“我”负责的具体任务】
本项目由我一人独立完成，从零到一实现了全栈开发。具体任务包括：前期产品需求分析与数据库建模、PostgreSQL表结构设计与21个数据库迁移版本的迭代；后端NestJS 11框架的搭建与API开发；前端Vue 3.5 SPA架构的搭建与页面开发；Redis缓存、MinIO对象存储的集成；Nginx反向代理配置及针对SSE的调优；Docker Compose一键部署编排文件的编写，以及长达6周、共计136次Git提交的代码版本管理与测试。

【项目使用的技术栈与架构】

后端：NestJS 11 + PostgreSQL 16 + Drizzle ORM + Redis + MinIO

前端：Vue 3.5 + Vite 8 + Pinia + Element Plus

契约层：前后端共享Zod契约，实现类型安全贯穿全链路

部署：Docker一键部署，Nginx生产级调优

架构：采用模块化架构设计，前后端分离，接口契约化，基础设施容器化。

【实现上的亮点与难点】

SSE并发防踩踏（难点）：在做流式对话时，遭遇了并发请求导致的会话状态混乱。我通过引入“会话级锁”结合“心跳防断连”机制，并在Nginx层针对SSE（Server-Sent Events）关闭了代理缓冲、延长了超时时间，彻底解决了高并发下的断连与踩踏问题，确保了打字机输出的绝对稳定。

Token智能裁剪算法（亮点）：大模型的上下文窗口限制是痛点。我创新性地实现了按Token预算智能裁剪的算法，并且针对中文和英文分别进行Token估算（因为二者的Token消耗比例差异巨大），保证输入不超限，同时最大化保留上下文记忆，避免向上游API报错。

前后端共享契约（亮点）：引入Zod作为前后端共享的契约包，前端在调用API时能获得极佳的TypeScript类型提示。后端更改任何一个字段，