WWsCa/VetNet-LCPS

VetCopilot — AI 兽医助手

智能兽医诊疗辅助系统，集成语音转写、AI 辅助诊断、病历管理、药品管理、预约排班等功能。

技术栈

层	技术
前端	React 18 + TypeScript + Vite + TailwindCSS
后端	Python 3.12 + FastAPI + SQLAlchemy + SQLite
ASR	SenseVoice (阿里免费) / Whisper / 讯飞（三引擎可切换）
LLM	DeepSeek / 自定义模型（OpenAI 兼容 API）
数据可视化	Recharts
部署	Docker + Nginx + Let's Encrypt HTTPS

项目结构

can_you_help_me/
├── vetcopilot-app/          # 前端 (React + Vite)
│   ├── src/
│   │   ├── api/             # API 调用层
│   │   ├── components/      # 公共组件
│   │   ├── hooks/           # 自定义 Hooks
│   │   ├── i18n/            # 国际化 (中/英)
│   │   └── pages/           # 页面组件
│   └── vite.config.ts
├── vetcopilot-backend/      # 后端 (FastAPI)
│   ├── app/
│   │   ├── models/          # SQLAlchemy 数据模型
│   │   ├── routers/         # API 路由
│   │   ├── schemas/         # Pydantic 数据验证
│   │   ├── services/        # 业务逻辑层
│   │   │   └── asr/        # ASR 引擎 (SenseVoice/Whisper/Xunfei)
│   │   ├── config.py        # 全局配置
│   │   └── main.py          # 应用入口
│   └── requirements.txt
├── deploy/                  # 部署配置
│   ├── docker-compose.yml
│   ├── Dockerfile.backend
│   ├── Dockerfile.frontend
│   ├── nginx.conf
│   ├── nginx-site.conf
│   ├── setup-https.sh       # HTTPS 证书自动获取
│   └── .env.production.example
└── dev-log/                 # 开发日志

快速开始

1. 后端

cd vetcopilot-backend
python -m venv venv
venv\Scripts\activate        # Windows
# source venv/bin/activate   # Mac/Linux

pip install -r requirements.txt
uvicorn app.main:app --host 0.0.0.0 --port 8080 --reload

2. 前端

cd vetcopilot-app
npm install
npm run dev

3. 访问

• 前端: http://localhost:5173
• 后端 API 文档: http://localhost:8080/docs
• 测试账号: 13800000002 / password123

ASR 引擎切换

编辑 vetcopilot-backend/.env:

# 推荐：阿里 SenseVoice（免费，中文优化，约 200MB）
ASR_PROVIDER=sensevoice

# 或：Whisper（免费，多语言）
ASR_PROVIDER=whisper

# 或：讯飞（付费，高精度实时流式）
ASR_PROVIDER=xunfei

安装 SenseVoice

pip install funasr sentencepiece
# 首次使用会自动从 ModelScope 下载模型权重

对接同事调优模型

在 .env 中配置（任意 OpenAI 兼容 API）：

LLM_PROVIDER=custom
CUSTOM_LLM_ENABLED=true
CUSTOM_LLM_API_BASE=http://同事IP:端口/v1
CUSTOM_LLM_MODEL=模型名称

生产部署

参考 deploy/ 目录下的配置文件。建议方案：

• 服务器: 阿里云/腾讯云 教育优惠 (~100元/年)
• 域名: 万网/DNSPod 教育优惠 (~1元/年)
• HTTPS: Let's Encrypt 免费证书（setup-https.sh 自动配置）
• 容器化: docker compose --env-file .env.production up -d

# 1. 准备环境变量
cp deploy/.env.production.example deploy/.env.production
# 编辑 deploy/.env.production 填写真实密钥

# 2. 启动
cd deploy
docker compose --env-file .env.production up -d

# 3. 配置 HTTPS
sudo bash setup-https.sh your-domain.com admin@example.com

功能模块

• 语音转写：实时录音 → ASR 引擎 → 结构化病历
• AI 辅助诊断：症状输入 → LLM 分析 → 鉴别诊断 + 治疗方案
• 病历管理：结构化病历 + PDF/DOCX 导出
• 药品管理：库存/出入库/处方
• 预约排班：日历视图 + 时段管理
• 账单收费：诊疗项目 + 账单统计
• 通知中心：模板管理 + SMS/Email/Push 多渠道
• 权限管理：RBAC 角色权限控制
• 数据可视化：收入/患者/药品等多维度图表
• 超级管理员：全功能后台控制面板

许可证

Private — 仅供内部使用