# AI-Forge Java21 SpringBoot3.5.x 后台框架

**Repository Path**: aiforge-project/aiforge-framework

## Basic Information

- **Project Name**: AI-Forge Java21 SpringBoot3.5.x 后台框架
- **Description**: AI-Forge Java21 SpringBoot3.5.x 后台框架
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-03
- **Last Updated**: 2026-01-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AIForge

> AI协作开发的SpringBoot + Java 21 模块化快速开发框架

## 项目简介

AIForge 是一个基于 SpringBoot 3.x 和 Java 21 的模块化快速开发框架，采用AI协作开发模式，集成了两级缓存、权限管理、通用工具等功能，旨在提供高效、智能的开发体验。

## 技术栈

- **基础框架**: SpringBoot 3.2.x + Java 21
- **数据访问**: MyBatis Plus 3.5.5 + Druid 连接池
- **缓存方案**: 两级缓存架构（Caffeine + Redis）
- **权限控制**: 全局过滤器 + JWT Token
- **工具库**: Hutool + Lombok + MapStruct
- **API文档**: SpringDoc OpenAPI 3
- **数据库**: MySQL 8.x + Redis 7.x

## 核心特性

### 🚀 AI协作开发
- 采用AI辅助编程模式
- 智能代码生成和优化
- 规范化的开发流程

### 🎯 模块化架构
- **aiforge-common**: 通用工具模块
- **aiforge-framework**: 框架核心模块
- **aiforge-system**: 系统管理模块
- **aiforge-admin**: 管理后台启动模块
- **aiforge-modules**: 业务模块集合

### 💾 两级缓存框架
- **一级缓存**: Caffeine本地缓存
- **二级缓存**: Redis分布式缓存
- **管理界面**: 可视化缓存监控和管理
- **智能同步**: 自动缓存穿透和更新策略

### 🔐 安全体系
- JWT Token认证机制
- 全局过滤器权限控制
- 密码BCrypt加密
- XSS防护和SQL注入防护

### 🛠️ 开发工具
- 统一响应格式封装
- 全局异常处理机制
- 分页查询支持
- 参数校验框架
- 操作日志记录

## 项目结构

```
aiforge/
├── pom.xml                           # 父工程POM
├── README.md                         # 项目说明
├── .gitignore                        # Git忽略文件
├── aiforge-common/                   # 通用模块
├── aiforge-framework/                # 框架核心模块
├── aiforge-system/                   # 系统管理模块
├── aiforge-admin/                    # 管理后台启动模块
└── aiforge-modules/                  # 业务模块目录
    ├── aiforge-user/                 # 用户模块
    ├── aiforge-video/                # 视频模块
    └── aiforge-message/              # 消息模块
```

## 快速开始

### 环境要求

- JDK 21+
- Maven 3.8+
- MySQL 8.0+
- Redis 7.0+

### 安装运行

1. **克隆项目**
```bash
git clone https://github.com/your-username/aiforge.git
cd aiforge
```

2. **编译项目**
```bash
mvn clean install
```

3. **配置数据库**
```yaml
# application.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/aiforge?useUnicode=true&characterEncoding=utf8&useSSL=false
    username: your_username
    password: your_password
```

4. **启动应用**
```bash
cd aiforge-admin
mvn spring-boot:run
```

5. **访问应用**
- 应用地址：http://localhost:8080
- API文档：http://localhost:8080/swagger-ui.html
- 缓存管理：http://localhost:8080/cache

## 开发规范

### 命名规范
- 包名：全小写，com.aiforge.模块名
- 类名：大驼峰 (PascalCase)
- 方法名：小驼峰 (camelCase)
- 常量：全大写下划线分隔

### API设计规范
- 统一返回格式：`R<T>` 包含code、message、data
- RESTful风格：GET查询、POST新增、PUT修改、DELETE删除
- 接口版本控制：`/api/v1/`

### 数据库设计规范
- 主键统一使用 id (BIGINT, 自增)
- 时间字段：create_time, update_time (DATETIME)
- 逻辑删除：deleted (TINYINT, 0正常 1删除)
- 状态字段：status (TINYINT)

## 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 版本历史

- **v1.0.0** - 初始版本
  - 基础框架搭建
  - 两级缓存实现
  - 权限管理系统

## 开源协议

本项目采用 [MIT License](LICENSE) 开源协议。

## 联系我们

如有问题或建议，请提交 [Issue](https://github.com/your-username/aiforge/issues)。

---

**AIForge** - 让AI与开发者协作，锻造更好的代码！