格式化代码，websocket功能完善

2026-02-18 21:50:05 +08:00
parent 6543e2ccdd
commit b6c133952b
101 changed files with 15829 additions and 10739 deletions
--- a/docs/README_SYSTEM.md
+++ b/docs/README_SYSTEM.md
@@ -44,6 +44,8 @@ app/Http/Controllers/System/
 - Laravel 11
 - Redis 缓存
 - Intervention Image (图像处理)
+- Laravel-S / Swoole (WebSocket 通知)
+- WebSocket (实时消息推送)

 ## 数据库表结构

@@ -84,15 +86,18 @@ app/Http/Controllers/System/
 - `username`: 用户名
 - `module`: 模块
 - `action`: 操作
- `method`: 请求方法
+- `method`: 请求方法 (GET/POST/PUT/DELETE)
 - `url`: 请求URL
 - `ip`: IP地址
 - `user_agent`: 用户代理
- `request_data`: 请求数据（JSON）
- `response_data`: 响应数据（JSON）
- `duration`: 执行时间（毫秒）
- `status_code`: 状态码
+- `params`: 请求参数（JSON）
+- `result`: 响应结果（仅错误时记录）
+- `status_code`: HTTP状态码
+- `status`: 状态 (success/error)
+- `error_message`: 错误信息
+- `execution_time`: 执行时间（毫秒）
 - `created_at`: 创建时间
+- `updated_at`: 更新时间

 ### system_tasks (任务表)
 - `id`: 主键
@@ -197,34 +202,220 @@ app/Http/Controllers/System/

 ### 操作日志管理

+操作日志模块通过中间件自动记录所有后台管理 API 请求，实现全自动化的日志记录功能。
+
+#### 中间件说明
+
+**LogRequestMiddleware**
+
+位置: `app/Http/Middleware/LogRequestMiddleware.php`
+
+功能:
+- 自动拦截所有经过的请求
+- 记录请求和响应信息
+- 计算请求执行时间
+- 提取用户信息和操作详情
+- 过滤敏感参数（password、token、secret、key）
+- 获取客户端真实 IP（支持代理）
+- 异常处理，记录失败不影响业务
+
+使用方式:
+```php
+// 在路由中应用
+Route::middleware(['auth.check:admin', 'log.request'])->group(function () {
+    // 需要记录日志的路由
+});
+```
+
+#### 日志记录规则
+
+**自动记录的请求：**
+所有经过 `log.request` 中间件的请求都会被自动记录，包括:
+- 用户管理操作
+- 角色管理操作
+- 权限管理操作
+- 部门管理操作
+- 系统配置操作
+- 其他所有后台管理操作
+
+**不记录的请求：**
+- 登录接口 (`POST /admin/auth/login`)
+- 健康检查接口 (`GET /up`)
+- 其他明确排除的路由
+
+**敏感信息过滤：**
+以下字段会被自动过滤，记录为 `******`:
+- `password`
+- `password_confirmation`
+- `token`
+- `secret`
+- `key`
+
+**错误日志处理：**
+- 成功请求 (HTTP 状态码 < 400): `status` = `success`
+- 失败请求 (HTTP 状态码 >= 400): `status` = `error`
+- 错误时记录响应内容和错误消息
+- 同时写入 Laravel 日志文件 (`storage/logs/laravel.log`)
+
 #### 获取日志列表
 - **接口**: `GET /admin/logs`
 - **参数**:
-  - `page`, `page_size`
-  - `keyword`: 搜索关键词（用户名/模块/操作）
-  - `module`: 模块
-  - `action`: 操作
-  - `user_id`: 用户ID
-  - `start_date`: 开始日期
-  - `end_date`: 结束日期
-  - `order_by`, `order_direction`
+  ```json
+  {
+    "user_id": 1,
+    "username": "admin",
+    "module": "users",
+    "action": "创建 users",
+    "status": "success",
+    "start_date": "2024-01-01",
+    "end_date": "2024-12-31",
+    "ip": "192.168.1.1",
+    "page": 1,
+    "page_size": 20
+  }
+  ```
+- **响应示例**:
+  ```json
+  {
+    "code": 200,
+    "message": "success",
+    "data": {
+      "list": [
+        {
+          "id": 1,
+          "user_id": 1,
+          "username": "admin",
+          "module": "users",
+          "action": "创建 users",
+          "method": "POST",
+          "url": "http://example.com/admin/users",
+          "ip": "192.168.1.1",
+          "user_agent": "Mozilla/5.0...",
+          "params": {
+            "name": "test",
+            "email": "test@example.com"
+          },
+          "result": null,
+          "status_code": 200,
+          "status": "success",
+          "error_message": null,
+          "execution_time": 125,
+          "created_at": "2024-01-01 12:00:00"
+        }
+      ],
+      "total": 100,
+      "page": 1,
+      "page_size": 20
+    }
+  }
+  ```

 #### 获取日志详情
 - **接口**: `GET /admin/logs/{id}`
+- **响应示例**:
+  ```json
+  {
+    "code": 200,
+    "message": "success",
+    "data": {
+      "id": 1,
+      "user_id": 1,
+      "username": "admin",
+      "module": "users",
+      "action": "创建 users",
+      "method": "POST",
+      "url": "http://example.com/admin/users",
+      "ip": "192.168.1.1",
+      "user_agent": "Mozilla/5.0...",
+      "params": {
+        "name": "test",
+        "email": "test@example.com"
+      },
+      "result": null,
+      "status_code": 200,
+      "status": "success",
+      "error_message": null,
+      "execution_time": 125,
+      "created_at": "2024-01-01 12:00:00",
+      "user": {
+        "id": 1,
+        "name": "管理员",
+        "username": "admin"
+      }
+    }
+  }
+  ```

-#### 删除日志
+#### 获取日志统计
+- **接口**: `GET /admin/logs/statistics`
+- **参数**:
+  ```json
+  {
+    "start_date": "2024-01-01",
+    "end_date": "2024-12-31"
+  }
+  ```
+- **响应示例**:
+  ```json
+  {
+    "code": 200,
+    "message": "success",
+    "data": {
+      "total": 1000,
+      "success": 950,
+      "error": 50
+    }
+  }
+  ```
+
+#### 导出日志
+- **接口**: `POST /admin/logs/export`
+- **参数**: 与获取日志列表相同的查询参数
+- **响应**: Excel 文件下载
+- **文件名格式**: `系统操作日志_YYYYMMDDHHmmss.xlsx`
+- **包含字段**:
+  - ID
+  - 用户名
+  - 模块
+  - 操作
+  - 请求方法
+  - URL
+  - IP 地址
+  - 状态码
+  - 状态
+  - 错误信息
+  - 执行时间(ms)
+  - 创建时间
+
+#### 删除单条日志
 - **接口**: `DELETE /admin/logs/{id}`
+- **响应示例**:
+  ```json
+  {
+    "code": 200,
+    "message": "删除成功",
+    "data": null
+  }
+  ```

 #### 批量删除日志
 - **接口**: `POST /admin/logs/batch-delete`
 - **参数**:
  ```json
  {
-    "ids": [1, 2, 3]
+    "ids": [1, 2, 3, 4, 5]
+  }
+  ```
+- **响应示例**:
+  ```json
+  {
+    "code": 200,
+    "message": "批量删除成功",
+    "data": null
  }
  ```

-#### 清理日志
+#### 清理历史日志
 - **接口**: `POST /admin/logs/clear`
 - **参数**:
  ```json
@@ -232,39 +423,129 @@ app/Http/Controllers/System/
    "days": 30
  }
  ```
- **说明**: 删除指定天数之前的日志记录
-
-#### 获取日志统计
- **接口**: `GET /admin/logs/statistics`
- **参数**:
-  - `start_date`: 开始日期
-  - `end_date`: 结束日期
- **返回**:
+- **说明**: 清理指定天数前的所有日志记录，默认清理 30 天前的数据
+- **响应示例**:
  ```json
  {
    "code": 200,
-    "message": "success",
-    "data": {
-      "total_count": 1000,
-      "module_stats": [
-        {
-          "module": "user",
-          "count": 500
-        }
-      ],
-      "user_stats": [
-        {
-          "user_id": 1,
-          "username": "admin",
-          "count": 800
-        }
-      ]
-    }
+    "message": "清理成功",
+    "data": null
  }
  ```

 ### 数据字典管理

+数据字典模块提供了完整的字典管理功能，包括字典分类和字典项的 CRUD 操作。通过 WebSocket 实现了前后端缓存的实时同步更新。
+
+#### 字典缓存更新机制
+
+**概述**
+
+字典缓存更新机制通过 WebSocket 实现前后端字典缓存的实时同步，确保在字典分类和字典项的增删改等操作后，前端字典缓存能够自动更新。
+
+**技术实现**
+
+1. **后端实现**
+
+在 `app/Services/System/DictionaryService.php` 中添加了 WebSocket 通知功能：
+
+**通知方法：**
+- `notifyDictionaryUpdate` - 字典分类更新通知
+  - 触发时机：创建、更新、删除、批量删除、批量更新状态
+  - 消息类型：`dictionary_update`
+
+- `notifyDictionaryItemUpdate` - 字典项更新通知
+  - 触发时机：创建、更新、删除、批量删除、批量更新状态
+  - 消息类型：`dictionary_item_update`
+
+**WebSocket 消息格式：**
+
+字典分类更新消息：
+```json
+{
+  "type": "dictionary_update",
+  "data": {
+    "action": "create|update|delete|batch_delete|batch_update_status",
+    "resource_type": "dictionary",
+    "data": {
+      // 字典分类数据
+    },
+    "timestamp": 1234567890
+  }
+}
+```
+
+字典项更新消息：
+```json
+{
+  "type": "dictionary_item_update",
+  "data": {
+    "action": "create|update|delete|batch_delete|batch_update_status",
+    "resource_type": "dictionary_item",
+    "data": {
+      // 字典项数据
+    },
+    "timestamp": 1234567890
+  }
+}
+```
+
+2. **前端实现**
+
+创建了 `resources/admin/src/composables/useWebSocket.js` 来处理 WebSocket 连接和消息监听：
+
+**主要功能：**
+- 初始化 WebSocket 连接（检查用户登录状态、验证用户信息完整性）
+- 消息处理器：`handleDictionaryUpdate` 和 `handleDictionaryItemUpdate`
+- 缓存刷新：接收到更新通知后，自动刷新字典缓存并显示成功提示
+
+**App.vue 集成：**
+
+```javascript
+onMounted(async () => {
+  // 初始化 WebSocket 连接
+  if (userStore.isLoggedIn()) {
+    initWebSocket()
+  }
+})
+
+onUnmounted(() => {
+  // 关闭 WebSocket 连接
+  closeWebSocket()
+})
+```
+
+**工作流程：**
+
+```
+用户操作（增删改字典）
+    ↓
+后端 Controller 调用 Service
+    ↓
+Service 执行数据库操作
+    ↓
+Service 清理后端缓存（Redis）
+    ↓
+Service 发送 WebSocket 广播通知
+    ↓
+WebSocket 推送消息到所有在线客户端
+    ↓
+前端接收 WebSocket 消息
+    ↓
+触发相应的消息处理器
+    ↓
+刷新前端字典缓存
+    ↓
+显示成功提示
+```
+
+**注意事项：**
+- WebSocket 仅在用户登录后建立连接
+- 连接失败会自动重试（最多 5 次）
+- 页面卸载时会自动关闭连接
+- WebSocket 通知功能依赖于 Laravel-S (Swoole) 环境
+- 在普通 PHP 环境下运行时，WebSocket 通知会优雅降级（不发送通知，但不影响功能）
+
 #### 获取字典列表
 - **接口**: `GET /admin/dictionaries`
 - **参数**:
@@ -658,8 +939,17 @@ app/Http/Controllers/System/
 ### 数据字典缓存

 - **缓存键**: `dictionary:all` 或 `dictionary:code:{code}`
- **过期时间**: 60分钟
- **更新时机**: 字典数据增删改时自动清除
+- **过期时间**: 3600秒（1小时）
+- **更新时机**:
+  - 字典数据增删改时自动清除后端缓存（Redis）
+  - 通过 WebSocket 通知前端自动刷新缓存
+
+**字典缓存同步流程：**
+1. 后端执行字典操作（增删改）
+2. 清理 Redis 缓存
+3. 发送 WebSocket 广播通知
+4. 前端接收通知并自动刷新缓存
+5. 显示成功提示

 ## 服务层说明

@@ -681,13 +971,24 @@ app/Http/Controllers/System/

 **主要方法**:
 - `getList()`: 获取日志列表
+- `getById()`: 根据 ID 获取日志详情
 - `getStatistics()`: 获取统计数据
+- `getListQuery()`: 获取日志查询构建器
 - `clearLogs()`: 清理过期日志
+- `delete()`: 删除单条日志
+- `batchDelete()`: 批量删除日志
 - `record()`: 记录日志（由中间件自动调用）

+**特性**:
+- 自动记录所有经过中间件的请求
+- 计算请求执行时间
+- 过滤敏感参数
+- 获取客户端真实 IP（支持代理）
+- 异常处理，记录失败不影响业务
+
 ### DictionaryService

-提供数据字典和字典项的管理功能。
+提供数据字典和字典项的管理功能，包括 WebSocket 通知机制。

 **主要方法**:
 - `getList()`: 获取字典列表
@@ -696,6 +997,13 @@ app/Http/Controllers/System/
 - `createItem()`: 创建字典项
 - `update()`: 更新字典
 - `updateItem()`: 更新字典项
+- `notifyDictionaryUpdate()`: 发送字典更新通知
+- `notifyDictionaryItemUpdate()`: 发送字典项更新通知
+
+**缓存机制**:
+- Redis 缓存字典数据（TTL: 3600秒）
+- WebSocket 实时通知前端更新
+- 前端 Pinia + 本地存储持久化

 ### TaskService

@@ -744,49 +1052,459 @@ php artisan db:seed --class=SystemSeeder
 - 常用数据字典
 - 全国省市区数据

+## 前端集成示例
+
+### 日志管理页面
+
+```vue
+<template>
+  <a-card title="操作日志">
+    <!-- 搜索表单 -->
+    <a-form layout="inline" :model="searchParams">
+      <a-form-item label="用户名">
+        <a-input v-model:value="searchParams.username" placeholder="请输入用户名" />
+      </a-form-item>
+      <a-form-item label="模块">
+        <a-input v-model:value="searchParams.module" placeholder="请输入模块名" />
+      </a-form-item>
+      <a-form-item label="状态">
+        <a-select v-model:value="searchParams.status" placeholder="请选择状态">
+          <a-select-option value="success">成功</a-select-option>
+          <a-select-option value="error">失败</a-select-option>
+        </a-select>
+      </a-form-item>
+      <a-form-item>
+        <a-button type="primary" @click="handleSearch">查询</a-button>
+        <a-button @click="handleReset">重置</a-button>
+        <a-button @click="handleExport">导出</a-button>
+      </a-form-item>
+    </a-form>
+
+    <!-- 数据表格 -->
+    <a-table
+      :columns="columns"
+      :data-source="logs"
+      :loading="loading"
+      :pagination="pagination"
+      @change="handleTableChange"
+    >
+      <template #status="{ record }">
+        <a-tag :color="record.status === 'success' ? 'green' : 'red'">
+          {{ record.status === 'success' ? '成功' : '失败' }}
+        </a-tag>
+      </template>
+      <template #action="{ record }">
+        <a-button type="link" @click="handleView(record)">查看</a-button>
+        <a-button type="link" danger @click="handleDelete(record.id)">删除</a-button>
+      </template>
+    </a-table>
+  </a-card>
+</template>
+
+<script setup>
+import { ref, reactive, onMounted } from 'vue'
+import { message } from 'ant-design-vue'
+import request from '@/utils/request'
+
+const logs = ref([])
+const loading = ref(false)
+
+const searchParams = reactive({
+  username: '',
+  module: '',
+  status: null,
+  page: 1,
+  page_size: 20
+})
+
+const pagination = reactive({
+  total: 0,
+  current: 1,
+  pageSize: 20
+})
+
+const columns = [
+  { title: 'ID', dataIndex: 'id', width: 80 },
+  { title: '用户名', dataIndex: 'username', width: 120 },
+  { title: '模块', dataIndex: 'module', width: 100 },
+  { title: '操作', dataIndex: 'action', width: 150 },
+  { title: '请求方法', dataIndex: 'method', width: 100 },
+  { title: 'IP 地址', dataIndex: 'ip', width: 150 },
+  { title: '状态', dataIndex: 'status', slots: { customRender: 'status' }, width: 100 },
+  { title: '执行时间', dataIndex: 'execution_time', width: 100 },
+  { title: '创建时间', dataIndex: 'created_at', width: 180 },
+  { title: '操作', slots: { customRender: 'action' }, width: 150, fixed: 'right' }
+]
+
+// 获取日志列表
+const fetchLogs = async () => {
+  loading.value = true
+  try {
+    const res = await request.get('/admin/logs', { params: searchParams })
+    logs.value = res.data.list
+    pagination.total = res.data.total
+    pagination.current = res.data.page
+    pagination.pageSize = res.data.page_size
+  } catch (error) {
+    message.error('获取日志失败')
+  } finally {
+    loading.value = false
+  }
+}
+
+// 查询
+const handleSearch = () => {
+  searchParams.page = 1
+  fetchLogs()
+}
+
+// 重置
+const handleReset = () => {
+  searchParams.username = ''
+  searchParams.module = ''
+  searchParams.status = null
+  searchParams.page = 1
+  fetchLogs()
+}
+
+// 导出
+const handleExport = async () => {
+  try {
+    const res = await request.post('/admin/logs/export', searchParams, {
+      responseType: 'blob'
+    })
+    const url = window.URL.createObjectURL(new Blob([res]))
+    const link = document.createElement('a')
+    link.href = url
+    link.setAttribute('download', `操作日志_${new Date().getTime()}.xlsx`)
+    document.body.appendChild(link)
+    link.click()
+    document.body.removeChild(link)
+    message.success('导出成功')
+  } catch (error) {
+    message.error('导出失败')
+  }
+}
+
+// 查看详情
+const handleView = (record) => {
+  // 打开详情对话框
+  console.log('查看日志', record)
+}
+
+// 删除
+const handleDelete = async (id) => {
+  try {
+    await request.delete(`/admin/logs/${id}`)
+    message.success('删除成功')
+    fetchLogs()
+  } catch (error) {
+    message.error('删除失败')
+  }
+}
+
+// 表格分页变化
+const handleTableChange = (pag) => {
+  searchParams.page = pag.current
+  searchParams.page_size = pag.pageSize
+  fetchLogs()
+}
+
+onMounted(() => {
+  fetchLogs()
+})
+</script>
+```
+
 ## 注意事项

-1. **Swoole环境注意事项**:
-   - 文件上传时注意临时文件清理
-   - 使用Redis缓存避免内存泄漏
-   - 图片压缩使用协程安全的方式
+### 1. Swoole环境注意事项
+- 文件上传时注意临时文件清理
+- 使用Redis缓存避免内存泄漏
+- 图片压缩使用协程安全的方式
+- WebSocket 通知依赖于 Laravel-S 环境

-2. **安全注意事项**:
-   - 文件上传必须验证文件类型和大小
-   - 敏感操作必须记录日志
-   - 配置数据不要存储密码等敏感信息
+### 2. 安全注意事项
+- 文件上传必须验证文件类型和大小
+- 敏感操作必须记录日志
+- 配置数据不要存储密码等敏感信息
+- 日志敏感信息已自动过滤

-3. **性能优化**:
-   - 城市数据使用Redis缓存
-   - 大量日志数据定期清理
-   - 图片上传时进行压缩处理
+### 3. 性能优化
+- 城市数据使用Redis缓存
+- 大量日志数据定期清理
+- 图片上传时进行压缩处理
+- 日志记录在请求处理后执行，不影响响应速度

-4. **文件上传**:
-   - 限制文件上传大小
-   - 验证文件MIME类型
-   - 定期清理临时文件
+### 4. 文件上传
+- 限制文件上传大小
+- 验证文件MIME类型
+- 定期清理临时文件
+
+### 5. 日志管理
+- 定期清理历史日志（建议使用任务调度器）
+- 确保查询字段有索引
+- 使用分页查询避免加载过多数据
+
+## 性能优化建议
+
+### 1. 定期清理日志
+
+建议使用 Laravel 任务调度器定期清理历史日志:
+
+```php
+// app/Console/Kernel.php
+
+protected function schedule(Schedule $schedule)
+{
+    // 每天凌晨 2 点清理 90 天前的日志
+    $schedule->call(function () {
+        app(LogService::class)->clearLogs(90);
+    })->dailyAt('02:00');
+}
+```
+
+### 2. 数据库索引
+
+确保以下字段有索引:
+- `system_logs`: `user_id`, `username`, `module`, `status`, `created_at`
+- `system_dictionaries`: `code`, `status`
+- `system_dictionary_items`: `dictionary_id`, `status`
+- `system_configs`: `group`, `key`, `status`
+
+### 3. 分页查询
+
+列表查询必须使用分页，避免一次加载过多数据。
+
+### 4. 异步记录
+
+日志记录操作应放在请求处理后，不影响响应速度。
+
+### 5. 细粒度缓存更新
+
+字典缓存当前实现为全量刷新，未来可以优化为增量更新：
+
+```javascript
+// 只更新受影响的字典
+async function handleDictionaryUpdate(data) {
+  const { action, data: dictData } = data
+  
+  if (action === 'update' && dictData.code) {
+    // 只更新特定的字典
+    await dictionaryStore.getDictionary(dictData.code, true)
+  } else {
+    // 全量刷新
+    await dictionaryStore.refresh(true)
+  }
+}
+```

 ## 扩展建议

-1. **日志告警**: 添加日志异常告警功能
-2. **配置加密**: 敏感配置数据加密存储
-3. **多语言**: 支持配置数据的多语言
-4. **任务监控**: 添加任务执行监控和通知
-5. **CDN集成**: 文件上传支持CDN分发
+### 1. 日志告警
+添加日志异常告警功能，当出现大量错误日志时自动通知管理员。
+
+### 2. 配置加密
+敏感配置数据加密存储，提高安全性。
+
+### 3. 多语言
+支持配置数据的多语言，便于国际化部署。
+
+### 4. 任务监控
+添加任务执行监控和通知，实时掌握任务运行状态。
+
+### 5. CDN集成
+文件上传支持CDN分发，提高访问速度。
+
+### 6. WebSocket 权限控制
+可以只向有权限的用户发送通知：
+
+```php
+// 后端只向有字典管理权限的用户发送
+$adminUserIds = User::whereHas('roles', function($query) {
+    $query->where('name', 'admin');
+})->pluck('id')->toArray();
+
+$this->webSocketService->sendToUsers($adminUserIds, $message);
+```
+
+### 7. 消息队列
+对于高并发场景，可以使用消息队列异步发送 WebSocket 通知：
+
+```php
+// 使用 Laravel 队列
+UpdateDictionaryCacheJob::dispatch($action, $data);
+```

 ## 常见问题

-### Q: 如何清除城市数据缓存？
+### Q1: 如何清除城市数据缓存？
 A: 调用 `CityService::clearCache()` 方法或运行 `php artisan cache:forget city:tree`。

-### Q: 图片上传后如何压缩？
+### Q2: 图片上传后如何压缩？
 A: 上传时设置 `compress=true` 和 `quality` 参数，系统会自动压缩。

-### Q: 如何配置定时任务？
+### Q3: 如何配置定时任务？
 A: 在Admin后台创建任务，设置Cron表达式，系统会自动调度执行。

-### Q: 数据字典如何使用？
+### Q4: 数据字典如何使用？
 A: 通过Public API获取字典数据，前端根据数据渲染下拉框等组件。

-### Q: 日志数据过多如何处理？
+### Q5: 日志数据过多如何处理？
 A: 定期使用 `/admin/logs/clear` 接口清理过期日志，或在后台设置自动清理任务。
+
+### Q6: 为什么某些请求没有被记录？
+A: 检查路由是否应用了 `log.request` 中间件，或者在中间件中是否被排除了。
+
+### Q7: 字典缓存未更新怎么办？
+A: 检查以下几点：
+- 确认 Laravel-S 服务是否启动：`php bin/laravels status`
+- 检查浏览器控制台是否有 WebSocket 错误
+- 确认用户已登录且有 token
+- 手动刷新页面验证 API 是否正常
+
+### Q8: WebSocket 连接失败会影响功能吗？
+A: 不会。WebSocket 连接失败不影响页面正常使用，只是不会收到自动更新通知。字典数据仍会正常更新到数据库和 Redis 缓存，只是前端不会收到实时通知，需要手动刷新页面。
+
+## 测试建议
+
+### 1. 功能测试
+1. 测试各种请求是否被正确记录
+2. 测试敏感信息是否被正确过滤
+3. 测试日志查询和筛选功能
+4. 测试日志导出功能
+5. 测试批量删除和清理功能
+6. 测试字典 WebSocket 通知是否正确
+
+### 2. 性能测试
+1. 测试日志记录对响应时间的影响
+2. 测试大量日志数据的查询性能
+3. 测试并发写入的性能
+4. 测试 WebSocket 广播性能
+
+### 3. 集成测试（字典 WebSocket）
+1. 启动后端服务（Laravel-S）
+2. 启动前端开发服务器
+3. 在浏览器中登录系统
+4. 打开开发者工具的 Network -> WS 标签查看 WebSocket 消息
+5. 执行字典增删改操作
+6. 验证：
+   - WebSocket 消息是否正确接收
+   - 缓存是否自动刷新
+   - 页面数据是否更新
+   - 提示消息是否显示
+
+### 4. 并发测试
+1. 打开多个浏览器窗口并登录
+2. 在一个窗口中进行字典操作
+3. 验证所有窗口的缓存是否同步更新
+
+### 5. 边界测试
+1. 测试异常情况下的日志记录
+2. 测试超长参数的处理
+3. 测试特殊字符的处理
+4. 测试 WebSocket 断连重连机制
+
+## 文件清单
+
+### 核心文件
+
+**控制器：**
+```
+app/Http/Controllers/System/Admin/Config.php
+app/Http/Controllers/System/Admin/Log.php
+app/Http/Controllers/System/Admin/Dictionary.php
+app/Http/Controllers/System/Admin/Task.php
+app/Http/Controllers/System/Admin/City.php
+app/Http/Controllers/System/Admin/Upload.php
+app/Http/Controllers/System/WebSocket.php
+```
+
+**中间件：**
+```
+app/Http/Middleware/LogRequestMiddleware.php
+```
+
+**请求验证：**
+```
+app/Http/Requests/LogRequest.php
+```
+
+**服务层：**
+```
+app/Services/System/ConfigService.php
+app/Services/System/LogService.php
+app/Services/System/DictionaryService.php
+app/Services/System/TaskService.php
+app/Services/System/CityService.php
+app/Services/System/UploadService.php
+app/Services/WebSocket/WebSocketService.php
+```
+
+**模型：**
+```
+app/Models/System/Config.php
+app/Models/System/Log.php
+app/Models/System/Dictionary.php
+app/Models/System/DictionaryItem.php
+app/Models/System/Task.php
+app/Models/System/City.php
+```
+
+**路由：**
+```
+routes/admin.php (后台管理路由)
+routes/api.php (公共 API 路由)
+```
+
+**前端：**
+```
+resources/admin/src/composables/useWebSocket.js
+resources/admin/src/App.vue (集成 WebSocket)
+```
+
+**文档：**
+```
+docs/README_SYSTEM.md (本文档)
+```
+
+## 总结
+
+System 基础模块提供了完整的系统管理功能，包括：
+
+### 核心功能
+
+- ✅ 系统配置管理（多分组、多类型支持）
+- ✅ 数据字典管理（分类 + 字典项）
+- ✅ 操作日志管理（自动记录、多维度查询、导出）
+- ✅ 任务管理（定时任务、手动执行、统计）
+- ✅ 城市数据管理（三级联动、缓存优化）
+- ✅ 文件上传管理（单文件、多文件、Base64、压缩）
+
+### 高级特性
+
+- ✅ WebSocket 实时通知（字典缓存自动更新）
+- ✅ Redis 缓存机制（性能优化）
+- ✅ 自动化日志记录（中间件拦截）
+- ✅ 敏感信息保护（自动过滤）
+- ✅ 数据导出功能（Excel 导出）
+- ✅ 批量操作支持
+- ✅ 完整的 API 文档
+
+### 性能优化
+
+- ✅ Redis 缓存（城市数据、系统配置、数据字典）
+- ✅ 日志异步记录（不影响响应速度）
+- ✅ 分页查询（避免加载过多数据）
+- ✅ 图片压缩（减少存储空间）
+- ✅ WebSocket 实时更新（减少不必要的请求）
+
+### 安全特性
+
+- ✅ 敏感信息过滤
+- ✅ 文件类型验证
+- ✅ 请求日志记录
+- ✅ IP 地址记录
+- ✅ 异常处理机制
+
+System 模块现已完全集成到项目中，提供了完整的系统管理功能和优秀的用户体验。