135 lines
3.1 KiB
Markdown
135 lines
3.1 KiB
Markdown
# 病例回访提醒系统
|
||
|
||
一个基于 Laravel 的患者随访管理系统，帮助医疗机构管理患者回访工作。
|
||
|
||
## 功能特性
|
||
|
||
### 患者管理
|
||
- 📋 患者信息列表，支持搜索和分页
|
||
- 📥 Excel/CSV 批量导入患者数据
|
||
- 📤 导出患者数据到 Excel
|
||
- 🗑️ 删除患者记录
|
||
|
||
### 随访提醒
|
||
- ⏰ 智能计算随访日期（出院后1、3、6、12个月）
|
||
- 📅 本月提醒 - 只显示本月需要随访的患者列表
|
||
- 📊 进度自动更新 - 过期月份自动算作已完成
|
||
- 📞 一键拨打电话进行回访
|
||
|
||
### 用户系统
|
||
- 👤 用户注册/登录
|
||
- 🔐 数据隔离 - 每个用户只能查看自己的患者数据
|
||
- 🚪 安全退出
|
||
|
||
### 界面特性
|
||
- 📱 响应式设计，完美适配移动端和PC端
|
||
- 🎨 现代化UI设计，浅色主题
|
||
- 📊 统计面板，一目了然查看随访状态
|
||
- 📞 一键拨打患者电话
|
||
|
||
## 技术栈
|
||
|
||
- **后端**: Laravel 11 / PHP 8.2+
|
||
- **数据库**: MySQL
|
||
- **Excel处理**: xlswriter 扩展
|
||
- **前端**: Blade 模板 + 原生 CSS
|
||
|
||
## 安装部署
|
||
|
||
### 环境要求
|
||
- PHP >= 8.2
|
||
- MySQL >= 5.7
|
||
- Composer
|
||
- xlswriter PHP 扩展（用于 Excel 导入导出）
|
||
|
||
### 安装步骤
|
||
|
||
1. **克隆项目**
|
||
```bash
|
||
git clone <repository-url>
|
||
cd reminder
|
||
```
|
||
|
||
2. **安装依赖**
|
||
```bash
|
||
composer install
|
||
```
|
||
|
||
3. **配置环境**
|
||
```bash
|
||
cp .env.example .env
|
||
php artisan key:generate
|
||
```
|
||
|
||
4. **配置数据库**
|
||
编辑 `.env` 文件，设置数据库连接：
|
||
```
|
||
DB_CONNECTION=mysql
|
||
DB_HOST=127.0.0.1
|
||
DB_PORT=3306
|
||
DB_DATABASE=reminder
|
||
DB_USERNAME=your_username
|
||
DB_PASSWORD=your_password
|
||
```
|
||
|
||
5. **运行迁移**
|
||
```bash
|
||
php artisan migrate
|
||
```
|
||
|
||
6. **启动服务**
|
||
```bash
|
||
php artisan serve
|
||
```
|
||
|
||
访问 `http://localhost:8000` 即可使用。
|
||
|
||
## Excel 导入格式
|
||
|
||
支持 `.xlsx` 和 `.csv` 格式，表头需包含以下字段：
|
||
|
||
| 字段 | 说明 | 必填 |
|
||
|------|------|------|
|
||
| 姓名 | 患者姓名 | ✅ |
|
||
| 性别 | 男/女 | ✅ |
|
||
| 年龄 | 数字 | ✅ |
|
||
| 诊断 | 疾病诊断 | ✅ |
|
||
| 转诊日期 | 出院/转诊日期 | ✅ |
|
||
| 地址 | 患者地址 | ❌ |
|
||
| 联系方式 | 电话号码 | ❌ |
|
||
| 备注 | 其他备注信息 | ❌ |
|
||
|
||
## 随访时间规则
|
||
|
||
系统根据患者的转诊日期自动计算随访时间：
|
||
|
||
| 随访次数 | 时间节点 |
|
||
|----------|----------|
|
||
| 第1次 | 转诊后 7 天 |
|
||
| 第2次 | 转诊后 1 个月 |
|
||
| 第3次 | 转诊后 3 个月 |
|
||
| 第4次 | 转诊后 6 个月 |
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
reminder/
|
||
├── app/
|
||
│ ├── Http/Controllers/
|
||
│ │ ├── AuthController.php # 用户认证
|
||
│ │ └── PatientController.php # 患者管理
|
||
│ └── Models/
|
||
│ ├── Patient.php # 患者模型
|
||
│ └── User.php # 用户模型
|
||
├── resources/views/
|
||
│ ├── layouts/app.blade.php # 主布局
|
||
│ ├── auth/ # 登录注册页面
|
||
│ └── patients/ # 患者相关页面
|
||
├── routes/web.php # 路由定义
|
||
└── database/migrations/ # 数据库迁移
|
||
```
|
||
|
||
## License
|
||
|
||
MIT License
|