# pet-hospital

**Repository Path**: ai_application/pet-hospital

## Basic Information

- **Project Name**: pet-hospital
- **Description**: 宠物医院管理系统 - 完整的宠物医院管理软件，支持预约、病历、处方、药品、订单、会员、医疗设备接入等功能
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-31
- **Last Updated**: 2026-01-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 宠物医院管理系统

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Next.js](https://img.shields.io/badge/Next.js-15-black)](https://nextjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5-blue)](https://www.typescriptlang.org/)
[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-14-blue)](https://www.postgresql.org/)

完整的宠物医院管理软件，使用 Next.js 全栈 + PostgreSQL + Prisma 开发，包含预约、病历、处方、订单、药品、宠物档案、会员管理、医疗设备接入等核心功能。

## ✨ 功能特性

### 核心业务模块

- 🏥 **预约管理系统** - 在线预约、排班管理、状态流转
- 📋 **病历管理系统** - 电子病历、体格检查、诊断记录
- 💊 **处方管理系统** - 电子处方、自动扣减库存
- 💰 **订单管理系统** - 收费结算、多种支付方式
- 🐾 **宠物档案系统** - 完整档案、疫苗记录、过敏史
- 💳 **会员管理系统** - 会员等级、积分系统、储值管理
- 🎫 **优惠券系统** - 优惠券创建、发放、使用
- 📊 **报表统计系统** - 数据统计、收入分析
- 🔬 **医疗设备接入** - 支持 Mindray BC-2600Vet 血液分析仪

### 系统管理模块

- 👨‍⚕️ **医生管理** - 医生信息、排班管理
- 👥 **用户管理** - 多角色权限控制
- 🛠️ **服务项目管理** - 服务项目、价格管理
- 🔐 **权限管理** - 5种角色、精细权限控制

## 🚀 技术栈

- **前端框架**: Next.js 15 (App Router)
- **开发语言**: TypeScript
- **数据库**: PostgreSQL 14
- **ORM**: Prisma 6
- **认证**: NextAuth.js v5
- **UI 组件**: shadcn/ui + Tailwind CSS
- **表单处理**: react-hook-form + zod
- **日期处理**: date-fns

## 📦 快速开始

### 环境要求

- Node.js 18+
- PostgreSQL 14+
- npm 或 yarn

### 安装步骤

1. **克隆项目**

```bash
git clone https://gitee.com/ai_application/pet-hospital.git
cd pet-hospital
```

2. **安装依赖**

```bash
npm install
```

3. **配置环境变量**

复制 `.env.example` 为 `.env` 并配置数据库连接：

```env
DATABASE_URL="postgresql://user:password@localhost:5432/pet_hospital"
NEXTAUTH_SECRET="your-secret-key"
NEXTAUTH_URL="http://localhost:3000"
```

4. **初始化数据库**

```bash
# 运行数据库迁移
npx prisma migrate dev

# 填充测试数据
npx prisma db seed
```

5. **启动开发服务器**

```bash
npm run dev
```

访问 http://localhost:3000

### 测试账号

- **管理员**: admin@example.com / admin123
- **医生1**: doctor1@example.com / admin123
- **医生2**: doctor2@example.com / admin123
- **前台**: receptionist@example.com / admin123
- **宠物主人1**: owner1@example.com / admin123
- **宠物主人2**: owner2@example.com / admin123

## 📖 文档

- [功能清单](FEATURES.md) - 完整功能列表
- [快速开始](QUICKSTART.md) - 详细安装指南
- [权限管理](PERMISSIONS.md) - 权限控制说明
- [医疗设备接入](MEDICAL-DEVICES.md) - 设备接入技术文档
- [更新日志](UPDATE-V7.md) - 版本更新记录

## 🎯 核心功能

### 完整的就诊流程

```
预约挂号 → 签到 → 就诊 → 创建病历 → 开具处方 → 配药 → 收费结算 → 会员积分
```

### 智能库存管理

- 处方配药自动扣减库存
- 订单支付自动扣减库存
- 低库存预警
- 库存调整记录

### 医疗设备接入

- 支持 Mindray BC-2600Vet 血液分析仪
- CSV 文件自动解析
- 自动异常检测（基于犬猫参考范围）
- 与病历系统无缝集成

### 权限管理

支持 5 种角色：

- **ADMIN** - 管理员（所有权限）
- **DOCTOR** - 医生（诊疗相关）
- **NURSE** - 护士（配药、查看）
- **RECEPTIONIST** - 前台（预约、收费）
- **PET_OWNER** - 宠物主人（查看自己的记录）

## 📊 数据库模型

系统包含 22 个核心数据表：

- User, Doctor, DoctorSchedule
- PetOwner, Pet, Vaccination
- Appointment, MedicalRecord, MedicalAttachment
- Prescription, PrescriptionItem, Medicine
- ServiceItem, Order, OrderItem, Payment
- Membership, PointRecord
- Coupon, CouponUsage
- MedicalDevice, LabReport

## 🔒 安全特性

- NextAuth.js v5 认证
- 基于角色的访问控制（RBAC）
- API 级别权限验证
- 密码加密存储
- SQL 注入防护
- XSS 防护

## 📱 界面预览

系统采用现代化的 UI 设计，响应式布局，支持桌面端和移动端访问。

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

[MIT License](LICENSE)

## 👨‍💻 作者

- **开发**: Claude Sonnet 4.5
- **项目**: 宠物医院管理系统
- **版本**: v1.3.1
- **日期**: 2026-01-31

## 🙏 致谢

感谢以下开源项目：

- [Next.js](https://nextjs.org/)
- [Prisma](https://www.prisma.io/)
- [NextAuth.js](https://next-auth.js.org/)
- [shadcn/ui](https://ui.shadcn.com/)
- [Tailwind CSS](https://tailwindcss.com/)

---

⭐ 如果这个项目对你有帮助，请给个 Star！