# spring-boot-base-craft

**Repository Path**: do0ob/spring-boot-base-craft

## Basic Information

- **Project Name**: spring-boot-base-craft
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-27
- **Last Updated**: 2025-08-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Spring Boot 基础模板

这是一个基于 Spring Boot 和 Vue 3 的基础模板项目，提供了一个前后端分离的开发架构，包含用户、角色、菜单管理等基础功能。

## 技术栈

- **后端**: Spring Boot (Java)
  - Spring Data JPA
  - Spring Security (隐含)
  - RESTful API 设计
- **前端**: Vue 3 + TypeScript + Vite
  - 使用 Axios 进行 HTTP 请求
  - Vue Router 用于导航

## 项目结构

- **craft-core**: 核心模块，包含通用类（如响应封装类 `R`）。
- **craft-service**: 业务逻辑模块，包含实体类、服务接口及其实现，使用 JPA 进行数据库操作。
- **craft-web**: Web 模块，包含控制器类，提供 REST API 接口。
- **craft-frontend**: 前端模块，基于 Vue 3 和 Vite 构建，包含页面组件和相关资源。

## 功能模块

- **用户管理**
  - 获取所有用户
  - 获取用户详情
  - 创建用户
  - 更新用户
  - 删除用户
- **角色管理**
  - 获取所有角色
  - 获取角色详情
  - 创建角色
  - 更新角色
  - 删除角色
- **菜单管理**
  - 获取所有菜单
  - 获取顶层菜单
  - 获取菜单详情
  - 创建菜单
  - 更新菜单
  - 删除菜单

## 快速开始

### 后端

1. 确保已安装 JDK 和 Gradle。
2. 执行以下命令运行后端服务：
   ```bash
   ./gradlew bootRun
   ```
3. 默认服务运行在 `http://localhost:8080`。

### 前端

1. 确保已安装 Node.js 和 npm。
2. 进入 `modules/craft-frontend` 目录并执行：
   ```bash
   npm install
   npm run dev
   ```
3. 默认前端开发服务器运行在 `http://localhost:3000`。

## 使用说明

- 前端通过 Axios 调用后端 API，封装在 `src/utils/request.ts`。
- 后端控制器路径：
  - 用户: `/api/users`
  - 角色: `/api/roles`
  - 菜单: `/api/menus`
- 实体类使用 JPA 注解进行数据库映射。

## 贡献

欢迎贡献代码和提出问题！请阅读 CONTRIBUTING.md 了解贡献指南。

## 许可证

该项目采用 MIT 许可证。详情请查看 LICENSE 文件。