reminder/README.md

病例回访提醒系统

一个基于 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. 克隆项目

git clone <repository-url>
cd reminder

2. 安装依赖

composer install

3. 配置环境

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. 运行迁移

php artisan migrate

6. 启动服务

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