README.md

# 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. 后端

```bash
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. 前端

```bash
cd vetcopilot-app
npm install
npm run dev
```

### 3. 访问

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

## ASR 引擎切换

编辑 `vetcopilot-backend/.env`:

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

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

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

### 安装 SenseVoice

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

## 对接同事调优模型

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

```env
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`

```bash
# 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 — 仅供内部使用