kazusa
/
ai-admin
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ai-admin/docs/admin-backend-system/TODO_admin-backend-system.md

4.7 KiB
Raw Permalink Blame History

待办事项清单

✅ MyBatis XML映射文件已补充

所有Mapper接口的XML映射文件已创建并修正字段映射：

  • SysUserMapper.xml - 用户管理SQL映射 ✅
  • SysRoleMapper.xml - 角色管理SQL映射 ✅
  • SysMenuMapper.xml - 菜单管理SQL映射 ✅
  • SysOperationLogMapper.xml - 操作日志SQL映射 ✅

已修正的映射问题：

  • 移除了不存在的SysConfig相关文件
  • 修正了SysMenu实体的字段映射
  • 统一了操作日志表名为sys_operation_log
  • 移除了SysUser中不存在的remark字段

🗃️ 数据库配置（必需）

1. 执行数据库初始化脚本

需要在您的MySQL数据库中执行以下SQL文件：

# 1. 创建数据库表结构
mysql -u your_username -p your_database < admin-backend/src/main/resources/sql/init_schema.sql

# 2. 插入初始数据
mysql -u your_username -p your_database < admin-backend/src/main/resources/sql/init_data.sql

2. 验证数据库连接

确认后端应用配置文件中的数据库连接信息正确：

  • 文件位置: admin-backend/src/main/resources/application.yml
  • 当前配置: jdbc:mysql://16.tcp.vip.cpolar.cn:14768/admin_db

3. 默认登录账户

初始化完成后可使用以下账户登录：

  • 用户名: admin
  • 密码: admin123
  • 角色: 超级管理员

🚀 部署配置（推荐）

1. 环境变量设置

建议通过环境变量配置敏感信息：

# 数据库配置
export DB_USERNAME=your_db_username
export DB_PASSWORD=your_db_password

# JWT密钥（可选，有默认值）
export JWT_SECRET=your_custom_jwt_secret_key

2. 生产环境优化

# 前端构建
cd admin-frontend
npm run build

# 后端打包
cd admin-backend  
mvn clean package -Dmaven.test.skip=true

3. 服务器部署

  • 前端: 部署 dist/ 目录到Nginx
  • 后端: 运行 target/admin-backend-1.0.0.jar
  • 数据库: 配置MySQL主从复制（推荐）

🔧 可选功能扩展

1. 监控和日志

  • 集成Prometheus监控
  • 配置ELK日志收集
  • 添加健康检查端点

2. 安全加固

  • 启用HTTPS证书
  • 配置API访问频率限制
  • 添加登录验证码功能

3. 性能优化

  • 集成Redis缓存
  • 配置数据库连接池优化
  • 启用前端CDN加速

4. 功能增强

  • 文件上传功能
  • 邮件通知服务
  • 操作日志查看页面
  • 数据导入导出功能

📋 测试验证步骤

1. 后端API测试

# 测试服务状态
curl http://localhost:8080/api/auth/check

# 测试登录接口
curl -X POST http://localhost:8080/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin123"}'

2. 前端功能测试

访问 http://localhost:3000 验证以下功能：

  • 登录页面显示正常
  • 使用admin/admin123登录成功
  • 仪表板数据展示
  • 用户管理CRUD操作
  • 角色管理权限分配
  • 菜单管理树形结构

3. 权限验证测试

  • 非管理员用户权限限制
  • JWT Token过期处理
  • 路由权限守卫功能

🛠️ 开发环境配置

1. 后端开发

cd admin-backend
mvn spring-boot:run
# 访问: http://localhost:8080/api/swagger-ui.html

2. 前端开发

cd admin-frontend
npm install
npm run dev
# 访问: http://localhost:3000

3. 代码质量检查

# 前端代码检查
npm run lint

# 后端代码编译
mvn compile

📖 文档和支持

1. API文档

2. 项目文档

  • 需求文档: docs/admin-backend-system/ALIGNMENT_*.md
  • 架构设计: docs/admin-backend-system/DESIGN_*.md
  • 验收报告: docs/admin-backend-system/ACCEPTANCE_*.md

3. 技术支持

  • 前端技术栈: Vue 3 + TypeScript + Element Plus
  • 后端技术栈: Spring Boot + MyBatis-Plus + MySQL
  • 认证方式: Spring Security + JWT

⚠️ 注意事项

  1. 数据库初始化是必需步骤，系统无法在空数据库上运行
  2. 默认密码需要修改，生产环境建议修改admin账户密码
  3. JWT密钥建议自定义，避免使用默认密钥
  4. 数据库备份策略，建议定期备份重要数据
  5. 防火墙配置，确保只开放必要的端口访问

🎯 优先级建议

高优先级（必需）

  1. ✅ 执行数据库初始化脚本
  2. ✅ 验证登录功能
  3. ✅ 测试基本CRUD操作

中优先级（推荐）

  1. ⭐ 修改默认密码
  2. ⭐ 配置HTTPS
  3. ⭐ 设置定期备份

低优先级（可选）

  1. 📈 性能监控
  2. 📧 邮件通知
  3. 📊 日志分析

联系信息: 如有技术问题，请参考项目文档或检查系统日志进行排查。