技术架构

架构概览

项目采用 Next.js 16 App Router 作为统一前后端入口。客户侧通过聊天 widget 发送消息，服务端 API 负责会话记录、意图判断、RAG 检索、工具调用和 SSE 流式返回。商家侧后台读取同一套会话、工单、知识库、Prompt 和质检数据。PostgreSQL 保存结构化业务数据，pgvector 与文本检索用于知识库召回，Redis 用于短期状态和缓存，LLM 使用 OpenAI 兼容协议以便切换模型。

数据流

客户消息进入 /api/chat 后，系统先记录消息，再检索相关知识，判断是否需要订单查询、工单或转人工。AI 回复时带上知识引用和工具结果。会话结束后，质量任务抽样质检并写入评分。后台看板聚合这些数据，形成解决率、工单、成本和知识命中趋势。

设计取舍

系统不引入微服务编排，也不实现多租户注册与计费。重点放在产品闭环和运营文档的可复用性上。代码保留 merchantId、Prompt 版本、知识库版本和工单状态等多租户字段，为后续扩展预留空间，但当前实现优先保证可演示、可阅读、可部署。