基于 linli-zhiying 增量改造的社区智慧药房平台。隔离测试环境已运行附近门店查询、批次支撑的 OTC 预约、Kafka 异步订单、FEFO 库存、Caffeine + Redis 门店缓存和门店工作台。经营助手已接入真实模型工具调用(生产环境实测来源为 LANGCHAIN4J_AGENT),规则摘要仅作降级路径;OCR 候选复核与正式入库链路已接入,但服务器尚未运行真实 PaddleOCR 模型。
- 用户按经纬度查找药房、查看商品与已发布活动。
- 使用服务端登录身份、requestId 幂等和 Redis Lua 预约;MySQL 批次库存是最终账本。
- Outbox 投递 Kafka 异步创建订单,支持查单、取消和门店核销。
- Flyway 增量迁移、FEFO 批次分配、库存预留与流水。
- 有界 Caffeine 本地缓存、Redis 共享缓存和 Pub/Sub 失效;布隆过滤器初始化失败时 fail-open。
- 门店商品与库存工作台、OCR 候选字段与 SKU 建议、店主人工复核审计及事务入库。
- 药房经营助手按门店读取库存与出库流水;模型不可用时返回标记为
RULES_FALLBACK的规则摘要。
演示账号为合成手机号 19900000001,门店 ID 900010;商品和批次均为演示数据。只有隔离测试 Compose 显式回传临时验证码;应用默认关闭。生产环境已部署于腾讯云并开放公网访问:http://111.230.167.35/ 。
OCR 后端经 mock 上游验证了上传、候选持久化、SKU 建议、人工确认、库存与流水事务及重复确认拒绝;该测试不代表真实 OCR 准确率。OCR 提取/PDF 规则测试共 15 项,包含 20 份合成供应商文本样例、明确分隔的多商品表格及规格/采购单价字段;扫描版 PDF 的真实 PaddleOCR 推理、图像字段准确率和运行峰值尚未实测。2026-11-18 服务器端验证电池 9/9 全部通过:全栈冒烟、1000 用户压测(100 成功 / 900 售罄,库存对账全过)、Kafka 故障注入(重复消费、Offset 中断、DLT 重投、Outbox 恢复、订单生命周期)、MySQL 中断、缓存失效、AI 经营评估 20/20(真实模型)与生产重启;生产环境经营助手已实测为真实模型工具调用。服务器主机内存使用上限为 1,898 MiB,Compose 容器硬限额预算为 1,600 MiB。处方药不可参加线上预约。
- 浏览店铺和分类、查看店铺详情、发现附近店铺。
- 浏览探店笔记,支持点赞、关注、签到、优惠券和秒杀订单等功能。
- 登录后创建和查看店铺预约。
- 使用可配置的 AI Skills 生成评价摘要、回复草稿、探店笔记草稿、优惠券文案和短视频脚本。
- 登录后的 AI 商家顾问可以调用业务工具;预约创建仍走当前登录用户的业务流程。
- 用户可从店铺详情发起实时咨询;WebSocket 接收消息,Kafka 通过
push-topic实时推送、store-topic异步写入 MySQL,解耦消息投递与持久化。 - 可选开启只读 MCP 查询接口,用于查询店铺、分类和优惠券。配置
MCP_API_TOKEN前,MCP 接口默认关闭。
顾客端 / 药房工作台 -> Nginx -> Spring Boot 模块化单体
|-> MySQL 8(库存账本、批次、订单、Outbox、审核记录)
|-> Redis 7(Lua 预约、限流、共享缓存)
|-> Kafka(药房订单链路、原有聊天 Topic)
|-> FastAPI + PaddleOCR(可选;产出待人工复核候选)
|-> OpenAI 兼容 API(可选;只读经营工具)
|-> WebSocket / STOMP(原有实时聊天)
`-> MCP HTTP 接口(可选,Bearer Token)
预约:Redis Lua 原子预占 -> MySQL 请求记录与 Outbox -> Kafka -> 幂等消费者 -> MySQL FEFO 库存事务。
需要 Docker Desktop 和 Compose v2。AI 模型密钥是可选的;不配置密钥时,浏览等功能仍可使用,但 AI 调用无法生成内容。
cp .env.example .env
# 编辑 .env,填入 DeepSeek API Key 后即可使用聊天和 AI Skills。
docker compose up --build打开 http://localhost:8080。前端通过同源地址访问后端。MySQL 映射到 127.0.0.1:3307;Redis 只在 Compose 网络内部开放。
首次启动会创建表结构和少量合成店铺/分类演示数据。MySQL 数据卷非空后不会再次执行初始化脚本。要重置演示数据库和 Redis 数据,运行 docker compose down -v 后重新启动。
需要 Java 17+、Maven 3.9+、MySQL 8+、Redis 7+ 和 Kafka。创建数据库后,按顺序执行:
db/mysql/001-schema.sql
db/mysql/002-demo-data.sql
db/mysql/003-chat.sql
按需设置 DB_URL、DB_USERNAME、DB_PASSWORD、REDIS_HOST、REDIS_PORT 和 KAFKA_BOOTSTRAP_SERVERS,然后运行:
cd AI-dianping-backend
mvn spring-boot:run使用 AI 功能还需要配置 AI_BASE_URL、AI_API_KEY 和 AI_MODEL_NAME。MCP_API_TOKEN 为可选项;未设置时 /mcp 返回 HTTP 503。启用后用 Authorization: Bearer <token> 认证。MCP 只注册只读的店铺、分类和优惠券查询工具。
即时通信需要 Kafka。全新 Compose 数据卷会执行 db/mysql/003-chat.sql 建表;已有数据库需手动执行该迁移。商家账号通过 tb_shop_owner 关联店铺,例如先确认用户和店铺 ID,再执行:
INSERT INTO tb_shop_owner (shop_id, user_id) VALUES (店铺ID, 商家用户ID)
ON DUPLICATE KEY UPDATE user_id = VALUES(user_id);顾客从店铺详情点击“联系商家”发消息;商家使用映射的账号打开 chat.html?shopId=店铺ID 回复。WebSocket STOMP CONNECT 帧使用 authorization 原生头传入登录 token。生产端在 Kafka 事务中将同一消息写入 push-topic 和 store-topic;独立消费组分别负责 WebSocket 实时推送和 MySQL 异步落库,会话历史通过 MySQL 查询。两个 Kafka Topic 的写入具备事务性,但 Kafka 与 MySQL 之间不构成跨系统事务。
运行后端单元测试:
cd AI-dianping-backend
mvn test测试不依赖本机 MySQL 或 Redis。GitHub Actions 会在 Java 17 环境运行相同的 Maven 测试命令。
| 变量 | 用途 | 默认值 |
|---|---|---|
DB_URL |
JDBC 连接串 | Compose 本地 MySQL,端口 3307 |
DB_USERNAME / DB_PASSWORD |
数据库账号 | hmdp / 仅供本地开发的密码 |
REDIS_HOST / REDIS_PORT |
Redis 连接 | Compose 外默认为 localhost:6379 |
KAFKA_BOOTSTRAP_SERVERS |
Kafka Broker 地址 | Compose 内部 kafka:19092;本地运行默认为 localhost:9092 |
KAFKA_PUSH_TOPIC |
实时推送 Topic | push-topic |
KAFKA_STORE_TOPIC |
异步落库 Topic | store-topic |
AI_BASE_URL |
OpenAI 兼容 API 地址 | https://api.deepseek.com |
AI_API_KEY |
DeepSeek API Key | .env.example 中为占位值,需替换 |
AI_MODEL_NAME |
对话模型 | deepseek-v4-flash |
MCP_API_TOKEN |
MCP 接口 Bearer Token | 留空表示关闭 |
不要提交 .env 或生产凭据。部署到本机以外前,请修改开发环境数据库密码。
AI-dianping-backend/:Spring Boot API、业务服务、AI Skills、顾问工具和 MCP 服务。AI-dianping-frontend/html/hmdp/:Vue 静态前端。AI-dianping-frontend/conf/nginx.conf:本地及 Compose 使用的 Nginx 配置。db/mysql/:建表脚本和合成演示数据,不包含导入的用户账号、手机号或探店笔记。
- 短信登录需要接入短信服务,仓库没有包含短信服务配置。
- AI 聊天和内容生成需要可用的模型服务密钥。
- Compose 中 Kafka 为单 Broker 开发配置,不提供生产环境所需的副本容灾;商家需由管理员在
tb_shop_owner中配置。 - 项目没有可核验的性能基准材料,因此不在此声明项目介绍中提到的性能百分比。
- 这是学习/演示项目。用于生产前还需评估认证、限流、存储和部署配置。
贡献步骤见 CONTRIBUTING.md,漏洞报告方式见 SECURITY.md。源码来源见 UPSTREAM.md。本仓库使用 MIT License,详见 LICENSE。 前端第三方依赖声明见 THIRD-PARTY-NOTICES.md。