# super-admin **Repository Path**: fking86/super-admin ## Basic Information - **Project Name**: super-admin - **Description**: super-admin - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2024-01-31 - **Last Updated**: 2026-04-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README \# 超级管理平台（letter-add-serice） 一个基于 Spring Boot + Vue2 的前后端分离管理后台项目。 \## 1. 项目简介 本仓库包含后端服务、前端管理台、框架依赖模块和数据库初始化脚本，适用于快速搭建后台管理系统（用户、权限、字典、日志、任务等通用能力）。 主要技术栈： \- 后端：Java 8、Spring Boot、MyBatis-Plus、Redis、Quartz \- 前端：Vue 2、Element UI、Vue CLI \- 构建：Maven（后端）、npm（前端） \## 2. 目录结构 \```text letter-add-serice ├─ super-admin-server # 后端服务（可运行） ├─ super-admin-ui # 前端项目（Vue2） ├─ venus-framework # 公共框架与 starter 模块 ├─ venus-dependencies # Maven 依赖版本管理（BOM） ├─ sql # 数据库初始化脚本 └─ pom.xml # Maven 聚合工程 \``` \## 3. 环境要求 \- JDK 1.8 \- Maven 3.6+ \- Node.js 14+（建议 14/16 LTS） \- MySQL 5.7+/8.0 \- Redis 5+ \## 4. 后端启动 \### 4.1 初始化数据库 按需执行 `sql` 目录下脚本（常见顺序）： \1. `app-common.sql` \2. `admin-system.sql` \3. `quartz.sql` \4. 其它业务 SQL（如 `app.sql`、`admin-system-log.sql`） \### 4.2 配置文件 后端主配置文件位于： \- `super-admin-server/src/main/resources/application.yaml` 默认环境为： \```yaml spring: profiles: ​ active: local \``` 请根据本地环境补充/确认数据库、Redis、端口等配置（通常在 `application-local.yaml`）。 \### 4.3 启动命令 在项目根目录执行： \```bash mvn clean install -DskipTests mvn -pl super-admin-server spring-boot:run \``` 或直接运行启动类： \- `com.venus.adminserver.SuperAdminApplication` \## 5. 前端启动 进入前端目录： \```bash cd super-admin-ui npm install \``` 若依赖冲突，可尝试： \```bash npm install --legacy-peer-deps \``` 启动开发环境： \```bash npm run dev \``` 常用命令： \- `npm run build:prod`：生产构建 \- `npm run build:test`：测试构建 \- `npm run lint`：代码检查 \## 6. 前后端联调说明 \- 前端通过 `vue.config.js` 的代理转发后端接口 \- 默认后端接口前缀为 `/api` \- 请确保前端代理目标地址与后端启动端口一致 \## 7. 常见问题 \### 7.1 前端安装报依赖冲突 使用： \```bash npm install --legacy-peer-deps \``` \### 7.2 后端启动后前端无法访问接口 请检查： \1. 后端是否成功启动 \2. 前端代理地址是否正确 \3. 后端端口/跨域/网关配置是否与本地环境一致 \### 7.3 数据库连接失败 请检查本地 MySQL 服务、账号密码、库名和字符集配置。 \## 8. 开发建议 \- 新增业务优先放在 `super-admin-server` 的 `modules` 下按领域拆分 \- 公共能力优先复用 `venus-framework` \- 提交前执行前端 `lint` 与后端基本编译，减少 CI 失败 \## 9. 一键本地启动（推荐） 本节用于新同事快速跑通项目，按顺序执行即可。 \### 9.1 第一次启动前检查 \1. 本地已启动 MySQL、Redis \2. 已执行 `sql` 目录初始化脚本 \3. 已确认后端本地配置（`application-local.yaml`）中的数据库与 Redis 地址可连通 \### 9.2 后端一键启动（PowerShell） 在项目根目录执行： \```powershell mvn clean install -DskipTests; mvn -pl super-admin-server spring-boot:run \``` \> 说明：第一段用于编译安装依赖，第二段只启动后端服务模块。 \### 9.3 前端一键启动（PowerShell） 新开一个终端，执行： \```powershell cd .\super-admin-ui npm install npm run dev \``` 如果 `npm install` 依赖冲突： \```powershell npm install --legacy-peer-deps \``` \### 9.4 联调自检清单（2 分钟） \1. 后端控制台无启动异常（出现 Started 关键字） \2. 前端控制台编译成功（无红色报错） \3. 浏览器打开前端地址（以控制台输出地址为准） \4. 登录页可访问，调用接口不报 404/502 \### 9.5 建议的日常开发启动顺序 \1. 先起后端 \2. 再起前端 \3. 最后检查代理与接口前缀（`/api`）是否一致