AI-CRM-System：面向医疗专业人士的智能客户关系管理系统

AI-CRM-System是专为医疗行业设计的开源CRM系统，集成Groq LLM提供实时WebSocket聊天代理功能，支持医疗专业人士（HCP）管理、交互记录、自动化工作流，并提供完整的Docker化部署方案。核心特性包括HCP档案与交互管理、现代化React前端、智能代理驱动的业务流程等，采用PostgreSQL数据层、FastAPI服务层、React前端层的三层架构。

医疗行业是关系驱动领域，但传统CRM系统无法满足特殊需求：

1. 严格合规要求：HCP互动需详细记录以备审计；
2. 复杂决策链：医院采购涉及多利益相关方；
3. 高频交互场景：学术会议、科室会、一对一拜访等；
4. 个性化沟通：不同专科医生关注信息差异大。 AI-CRM-System针对这些痛点提供AI集成的开源解决方案。

后端架构

采用FastAPI框架，依赖包括PostgreSQL（数据库）、Groq API（LLM服务）、WebSocket（实时通信）。数据模型核心为HCP（含id、姓名、专科等扩展字段）和Interaction（含id、hcp_id、交互内容、时间戳）。

AI聊天代理

通过WebSocket /ws端点实现双向实时通信，支持自动重连与心跳；代理可触发工具（查询HCP信息、记录交互、生成提醒等），能解析自然语言意图并执行对应操作。

前端架构

基于React 18，支持深色模式、打字机效果、记忆功能；技术选型包括React Hooks/Context（状态管理）、Fetch/Axios（HTTP客户端）、原生WebSocket API。

HCP管理

完整生命周期管理：档案（基础信息、联系信息、专业标签、关系历史）、智能搜索（模糊匹配、专科/医院筛选、交互时间排序）。

交互记录与追踪

详细记录交互类型（拜访、电话等）、主题、反馈、附件；提供时间线视图（按时间展示、筛选搜索、关键事件高亮）。

AI聊天代理

自然语言交互（查询HCP动态、记录交互、生成报告、设置提醒）、上下文感知（记住对话上下文、关联HCP、基于历史提建议）、工具调用（自动调用API、验证数据、处理异常）。

自动化工作流

跟进提醒（基于交互时间生成任务、优先级排序、多渠道通知）、报告生成（周期性活动、区域业绩、合规审计）、数据同步（外部系统集成、数据清洗、备份归档）。

Docker全栈部署（推荐）

1. 复制.env.example为.env，设置DB_PASSWORD和GROQ_API_KEY；
2. 执行docker compose up --build启动服务；
3. 访问：后端API（http://localhost:8000/docs）、前端界面（http://localhost:3000）、WebSocket（ws://localhost:3000/ws）。 服务组成：PostgreSQL（5432端口）、FastAPI（8000）、React（3000）。

本地开发模式

后端：cd backend→pip install -r requirements.txt→uvicorn app.main:app --reload； 前端：cd frontend→npm install→npm run dev（支持热重载）。

数据保护

PostgreSQL数据加密、敏感信息（API Key、密码）通过环境变量管理、Docker内部网络隔离。

审计追踪

所有数据变更记录日志、交互记录不可篡改、支持数据导出用于审计。

访问控制

基于角色的权限管理、API认证授权、会话管理。

合规建议

需根据地区法规实施：GDPR（欧盟）、HIPAA（美国）、中国网络安全法（数据本地化存储）。

当前局限

移动端支持有限、多语言待完善、高级分析（BI/预测）需开发、缺乏与EHR系统标准集成。

未来改进

移动应用（React Native/Flutter）、离线模式、高级分析仪表板、FHIR标准集成、语音输入、多租户SaaS版本。

总结

AI-CRM-System融合传统CRM与AI能力，提高医疗销售团队效率；Docker部署降低运维门槛，模块化架构便于定制扩展，是医疗行业值得评估的解决方案，也可作为全栈开发参考项目。