# fastFrame

**Repository Path**: lushuifa/fastFrame

## Basic Information

- **Project Name**: fastFrame
- **Description**: 完全用AI来开发的项目脚手架
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-08
- **Last Updated**: 2026-01-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FastFrame 后台管理系统

## 1. 项目简介

FastFrame 是一个基于 Spring Boot 和 Layui 的轻量级后台管理系统。它提供了完善的权限管理（RBAC）、数据字典、文件管理、操作日志等基础功能，旨在为开发者提供一个快速开发企业级后台应用的脚手架。

系统采用前后端分离架构，但前端保持了简单易用的原生 HTML/JS 模式（基于 Layui），无需复杂的前端构建工具（如 Webpack/Vite），非常适合快速上手和中小项目的开发。

## 2. 核心功能

*   **用户管理**：用户的增删改查，状态管理，密码重置。
*   **角色管理**：角色创建与权限分配，支持细粒度的菜单和按钮权限控制。
*   **菜单管理**：动态路由配置，支持目录、菜单、按钮三种类型，可视化配置菜单图标和排序。
*   **部门管理**：支持多级部门组织架构管理，直观的树形展示和操作。
*   **数据字典**：系统参数和常量的集中管理，支持层级结构。
*   **文件管理**：集成文件上传、下载、重命名、删除功能，支持多种文件类型。
*   **操作日志**：全方位的系统操作记录，支持按模块、操作人、时间等条件搜索，保障系统安全。
*   **控制台**：直观的系统仪表盘，展示关键统计数据、快捷入口和系统公告。
*   **安全认证**：基于 Spring Security + JWT 的无状态认证机制。

## 3. 技术栈

### 后端
*   **核心框架**：Spring Boot 2.7+
*   **ORM框架**：MyBatis-Plus
*   **安全框架**：Spring Security + JWT
*   **缓存中间件**：Redis
*   **数据库**：MySQL 8.0
*   **API文档**：SpringDoc / Swagger 3
*   **工具库**：Lombok, Hutool
*   **日志**：Logback

### 前端
*   **UI框架**：Layui 2.9.3
*   **核心语言**：HTML5, CSS3, JavaScript (ES6)
*   **交互库**：jQuery (Layui内置)

## 4. 目录结构

```
fastFrame/
├── fastframe-front/          # 前端源码目录
│   ├── assets/               # 静态资源（CSS, JS, Config）
│   ├── layout/               # 布局文件
│   ├── modules/              # 业务模块页面（User, Role, Menu, etc.）
│   └── index.html            # 入口页面
├── src/                      # 后端源码目录
│   ├── main/
│   │   ├── java/             # Java 代码
│   │   └── resources/        # 资源配置
│   │       ├── db/           # 数据库脚本 (schema.sql)
│   │       └── application.yml # 系统配置文件
└── pom.xml                   # Maven 依赖配置
```

## 5. 快速开始

### 5.1 环境准备
*   JDK 1.8+
*   Maven 3.6+
*   MySQL 8.0+
*   Redis 5.0+

### 5.2 数据库初始化
1.  创建数据库 `fastFrame`。
2.  执行 `src/main/resources/db/schema.sql` 脚本，初始化表结构。
    > 注意：脚本中包含基础表结构，首次启动请确保数据库连接配置正确。

### 5.3 后端启动
1.  修改 `src/main/resources/application.yml` 中的数据库和 Redis 配置：
    ```yaml
    spring:
      datasource:
        url: jdbc:mysql://localhost:3306/fastFrame?...
        username: root
        password: your_password
      redis:
        host: localhost
        port: 6379
        password: your_redis_password
    ```
2.  运行 `FastFrameApplication.java` 启动服务。
3.  服务默认端口为 `8080`，Swagger 文档地址：`http://localhost:8080/swagger-ui.html`。

### 5.4 前端启动
前端为纯静态资源，可以通过以下任意方式运行：
1.  **直接打开**：直接用浏览器打开 `fastframe-front/index.html`（部分浏览器可能因跨域限制报错，建议使用方式2或3）。
2.  **本地服务**：使用 VS Code 的 Live Server 插件，或 Python `python -m http.server` 在 `fastframe-front` 目录下启动。
3.  **Nginx部署**：将 `fastframe-front` 目录部署到 Nginx html 目录。

**注意**：前端配置文件位于 `fastframe-front/assets/js/config.js`，请确保 `baseUrl` 指向正确的后端地址（默认为 `http://localhost:8080`）。

## 6. 使用说明

*   **默认登录账号**：
    *   用户名：`admin`
    *   密码：`123456` (假设初始密码，具体请查看数据库或初始化代码)

## 7. 常见问题

*   **登录报401/403**：请检查 Redis 是否启动，JWT Token 是否过期。
*   **菜单不显示**：请确认当前登录用户的角色已分配相应的菜单权限。
*   **文件上传失败**：请检查 `application.yml` 中 `fastplat.file.upload-path` 配置的路径是否有写入权限。

## 8. 许可证

MIT License