# Checklist - 智能物联网设备后台管理系统

## 项目初始化检查
- [ ] 前端Vue 3项目创建成功，package.json包含所需依赖
- [ ] 后端Midway.js项目创建成功，package.json包含所需依赖
- [ ] 前端目录结构符合规划（api、components、layouts、router、stores、utils、views）
- [ ] 后端目录结构符合规划（config、controller、service、middleware、entity、dto、util）
- [ ] Vite配置正确（代理、路径别名、环境变量）
- [ ] Midway配置正确（数据库、Redis、CORS、JWT密钥）
- [ ] 所有依赖通过yarn安装成功，无版本冲突
- [ ] MySQL数据库连接正常，6张核心表创建成功
- [ ] 初始数据插入成功（管理员账户、角色、权限）

## 认证授权系统检查
- [ ] JWT Token生成与验证逻辑正确
- [ ] AuthMiddleware能正确拦截未认证请求
- [ ] 登录接口返回正确的Token和用户信息
- [ ] Token过期后自动刷新机制工作正常
- [ ] 密码使用bcrypt加密存储
- [ ] RBAC中间件能正确验证权限码
- [ ] 用户权限树从数据库正确加载
- [ ] Redis权限缓存读写正常
- [ ] 前端路由守卫能根据权限动态生成路由
- [ ] v-permission指令能正确控制按钮显隐

## 用户管理模块检查
- [ ] 用户列表接口支持分页、搜索、筛选、排序
- [ ] 创建用户接口校验必填字段和数据合法性
- [ ] 编辑用户接口支持部分字段更新
- [ ] 删除用户接口有二次确认机制
- [ ] 用户状态切换接口工作正常
- [ ] 前端用户列表页面展示数据正确
- [ ] 前端新增/编辑表单校验规则生效
- [ ] 角色选择下拉框数据加载正确
- [ ] 批量操作功能可用
- [ ] CRUD操作后列表自动刷新

## 角色权限管理模块检查
- [ ] 角色列表接口返回正确的角色数据和关联用户数
- [ ] 创建/编辑角色接口工作正常
- [ ] 权限树接口返回层级结构正确的权限数据
- [ ] 更新角色权限接口正确保存关联关系
- [ ] 前端角色列表页面展示正确
- [ ] 前端权限配置弹窗Tree组件渲染正确
- [ ] 权限勾选/取消勾选交互流畅
- [ ] 保存权限后立即生效（缓存更新）

## 系统设置模块检查
- [ ] 获取设置接口返回完整的系统配置
- [ ] 更新设置接口正确持久化数据
- [ ] 基本设置页面各字段可正常编辑和保存
- [ ] 安全设置页面各字段可正常编辑和保存
- [ ] 设置变更后Redis缓存及时更新
- [ ] 表单校验规则生效（数值范围、IP格式等）

## 操作日志模块检查
- [ ] 日志中间件自动记录HTTP请求操作
- [ ] 日志记录包含完整字段（操作人、类型、时间、IP、详情）
- [ ] 日志查询接口支持筛选和时间范围
- [ ] 前端日志列表页面展示正确
- [ ] 筛选功能工作正常（操作人、类型、时间范围）
- [ ] 日志导出功能可下载CSV文件
- [ ] 日志异步写入不影响主业务性能

## 仪表盘模块检查
- [ ] 统计数据接口返回正确的聚合数据
- [ ] 4个统计卡片展示正确的数值
- [ ] 折线图展示近7天设备趋势数据
- [ ] 饼图展示设备类型分布
- [ ] 最近告警列表实时滚动
- [ ] 最近活动时间线展示正确
- [ ] 数据定时刷新机制工作正常（30秒间隔）
- [ ] Mock数据生成器可用于演示

## UI界面与用户体验检查
- [ ] AdminLayout布局组件渲染正确（侧边栏+顶栏+内容区）
- [ ] 侧边栏菜单可折叠/展开
- [ ] 当前访问菜单高亮显示
- [ ] 面包屑导航显示正确路径
- [ ] 用户下拉菜单包含个人信息、修改密码、退出登录
- [ ] 标签页导航支持多页面切换和关闭
- [ ] Loading状态在数据加载时正确显示
- [ ] Toast提示在操作成功/失败时正确弹出
- [ ] 登录页面UI美观，符合设计规范
- [ ] 登录表单校验规则全部生效
- [ ] 登录成功后正确跳转到仪表盘
- [ ] 未登录访问受保护页面时重定向到登录页
- [ ] 全局CSS变量定义完整
- [ ] Ant Design Vue主题定制生效（深蓝色系）
- [ ] 页面切换有平滑的动画过渡效果
- [ ] 响应式布局在1366px+分辨率下正常显示

## 前后端联调检查
- [ ] Vite代理配置正确，开发环境API请求正常转发
- [ ] Axios请求拦截器自动注入Authorization头
- [ ] Axios响应拦截器正确处理错误（401跳转、500提示）
- [ ] Token过期时自动调用刷新Token接口
- [ ] 完整业务流程可走通：登录→仪表盘→用户管理→角色配置→设置→日志
- [ ] 空数据状态展示友好提示
- [ ] 网络异常时有友好的错误提示
- [ ] 权限不足时显示403禁止访问页面
- [ ] 首屏加载时间合理（<3秒）
- [ ] 接口响应时间符合预期（<500ms）

## 代码质量检查
- [ ] TypeScript类型定义完整，无any滥用
- [ ] 组件代码行数控制在300行以内
- [ ] 组件职责单一，复用性良好
- [ ] API接口封装规范，错误处理统一
- [ ] 代码符合ESLint规范，无警告和错误
- [ ] 无硬编码的URL或敏感信息
- [ ] 注释清晰必要（中文注释）
- [ ] Git提交记录规范