# 不良事件管理 - 测试数据填充说明

## 概述

本文档说明如何为"不良事件管理"模块填充测试数据，以便进行功能测试和演示。

## 文件说明

### 1. 数据库迁移文件
- `database/migrations/2025_07_24_093101_create_adverse_table.php`
  - 创建不良事件数据表结构

### 2. 数据填充文件
- `database/seeders/AdverseSeeder.php` - Laravel Seeder填充器
- `database/seeders/adverse_data.sql` - SQL脚本文件
- `insert_adverse_data.php` - 独立PHP脚本

### 3. 模型和控制器
- `app/Models/Adverse.php` - 不良事件模型
- `app/Http/Controllers/Admin/AdverseController.php` - 管理控制器
- `app/Forms/AdverseForm.php` - 表单类

### 4. 视图文件
- `resources/views/admin/adverse/index.blade.php` - 列表页面
- `resources/views/admin/adverse/create.blade.php` - 创建页面
- `resources/views/admin/adverse/edit.blade.php` - 编辑页面
- `resources/views/admin/adverse/show.blade.php` - 详情页面

## 使用方法

### 方法一：使用Laravel Seeder（推荐）

1. 确保已运行数据库迁移：
```bash
php artisan migrate
```

2. 运行Seeder填充数据：
```bash
php artisan db:seed --class=AdverseSeeder
```

### 方法二：使用SQL脚本

1. 确保已运行数据库迁移
2. 确保已有项目和订单数据
3. 执行SQL脚本：
```bash
mysql -u username -p database_name < database/seeders/adverse_data.sql
```

### 方法三：使用独立PHP脚本

1. 确保已运行数据库迁移
2. 确保已有项目和订单数据
3. 运行脚本：
```bash
php insert_adverse_data.php
```

## 数据内容

### 不良事件类型
- `safety` - 意外事件
- `complaint` - 沟通事件
- `other` - 其他

### 解决状态
- `pending` - 待处理
- `processing` - 处理中
- `solved` - 已解决
- `closed` - 已关闭

### 测试数据特点
- 包含30条测试记录
- 涵盖所有类型和状态
- 包含真实的事件描述和解决结果
- 时间分布在最近90天内
- 关联到实际的项目和订单

## 数据字段说明

| 字段名 | 类型 | 说明 |
|--------|------|------|
| project_id | int | 所属项目ID |
| order_id | int | 相关订单ID（可为空） |
| type | varchar | 事件类型 |
| description | text | 事件描述 |
| solved_status | varchar | 解决状态 |
| solved_by | varchar | 经办人 |
| solved_at | datetime | 解决时间 |
| solved_result | text | 解决结果描述 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

## 注意事项

1. **依赖关系**：确保在填充不良事件数据之前，已有项目和订单数据
2. **数据完整性**：已解决的事件会自动设置解决时间和结果
3. **时间分布**：创建时间分布在最近90天内，解决时间分布在最近30天内
4. **关联关系**：订单ID会根据项目ID自动匹配

## 功能测试

填充数据后，可以测试以下功能：

1. **列表展示**：查看不良事件列表
2. **搜索筛选**：按关键词、状态、类型、项目等条件筛选
3. **创建事件**：新增不良事件记录
4. **编辑事件**：修改事件信息和状态
5. **查看详情**：查看完整的事件信息
6. **批量操作**：批量删除、标记解决等

## 故障排除

### 常见问题

1. **没有项目数据**
   - 解决：先创建项目数据

2. **没有订单数据**
   - 解决：先创建订单数据

3. **数据库连接错误**
   - 检查数据库配置
   - 确保数据库服务运行正常

4. **权限问题**
   - 确保数据库用户有插入权限

### 日志查看

如果遇到问题，可以查看Laravel日志：
```bash
tail -f storage/logs/laravel.log
```

## 联系支持

如有问题，请联系开发团队或查看项目文档。