# web-starter —— Web 框架整合启动器

## 概述

web-starter 是苍穹 ERP 的核心 web 框架整合模块，封装了 Spring Boot Web 开发所需的所有基础设施能力，以自动配置方式提供开箱即用的体验。

## 核心能力

### ORM 与数据库
- **MyBatis-Plus 3.5.7** —— ORM 框架，支持 Lambda 查询、分页、自动填充
- **Druid** —— 数据库连接池
- **Dynamic Datasource** —— 多数据源支持
- **PageHelper** —— 分页插件

### 认证与授权
- **Sa-Token 1.44** —— 认证鉴权框架（Spring Boot 3 集成 + Redis 序列化）
- **@SaCheckPermission / @SaCheckRole** —— 权限注解

### 缓存与会话
- **Redis**（Spring Data Redis + Lettuce 连接池）
- **Spring Session + Redis** —— Session 集中存储

### 任务调度
- **Quartz** —— 分布式任务调度（JDBC 存储）

### 文件处理
- **EasyExcel** —— Excel 导入导出
- **OSS 客户端** —— 阿里云 OSS / 华为云 OBS / 腾讯云 COS

### API 文档
- **Knife4j 4.5.0** —— OpenAPI 3 接口文档

### 动态 API
- **Magic-API 2.1.1** —— 在线编写接口脚本（Groovy），支持数据库存储、集群模式

### 其他
- **WebSocket** —— 实时消息推送（基于 Redis Pub/Sub 广播）
- **验证码** —— Kaptcha 图形验证码
- **操作日志** —— 业务操作日志记录
- **数据脱敏/加密** —— 敏感字段处理
- **租户隔离** —— 多租户数据隔离
- **ID 生成器** —— 雪花算法（支持 workerId / dataCenterId 配置）

## 内置管理功能

web-starter 还包含了 ERP 系统管理模块的内置实现：

- 用户管理、角色管理、权限（菜单）管理
- 部门管理
- 数据字典
- 系统参数配置
- 操作日志查询
- 定时任务管理
- 消息通知（站内信、邮件）
- 公告管理
- 模块管理
- 代码生成器
- OpenAPI 管理
- 租户管理