快速开始

本节带你快速了解项目结构，并如何快速开始使用 EasyDev Admin。

项目结构

后端

文件夹admin-base # 管理后台基础包
- 文件夹src
  - 文件夹main
    文件夹java/
    …
    文件夹resources
    application.yml
    application-dev.yml
    application-prod.yml
- pom.xml # 子模块 maven 配置文件
文件夹file-service/ # 文件服务模块
- …
文件夹mybatis-flex-base/ # mybatis-flex 基础包
- …
文件夹user-base/ # 用户基础包
- …
文件夹web-security-base/ # web 安全基础包
- …
文件夹web-service-base/ # web 服务基础包
- …
pom.xml # 根POM

前端

文件夹docs/ # 文档目录
- …
文件夹mock/ # 模拟数据目录
- …
文件夹public/ # 静态资源目录
- …
文件夹src
- 文件夹api/ # 接口目录
  - …
- 文件夹assets/ # 会被编译处理的静态资源目录
  - …
- 文件夹components/ # 组件目录
  - …
- 文件夹config/ # 配置目录
  - …
- 文件夹constants/ # 常量目录
  - …
- 文件夹layouts/ # 布局目录
  - …
- 文件夹locales/ # 国际化目录
  - …
- 文件夹pages/ # 页面目录
  - …
- 文件夹router/ # 路由目录
  - …
- 文件夹store/ # 状态管理目录
  - …
- 文件夹style/ # 样式目录
  - …
- 文件夹types/ # 类型定义目录
  - …
- 文件夹utils/ # 工具函数目录
  - …
- App.vue
- main.ts
- permission.ts # 权限管理
.env # 生产环境变量配置文件
.env.development # 开发环境变量配置文件
CHANGELOG.md # 变更日志
README.md # 项目介绍
commitlint.config.js # commitlint 规范
eslint.config.js # eslint 规范
index.html # 入口文件
tsconfig.json # typescript 配置文件
vite.config.ts # Vite 配置文件

启动

后端

拉取项目后，项目根目录下的 create_table-mysql.sql 文件夹，执行其中的 sql 脚本，初始化数据库。如果你用的是非 Mysql，请做必要的转换。
application-dev.yml 文件，做必要的配置后，即可启动项目。主要配置数据源、redis、easydev.system.init., easydev.system.cors., easydev.file.*。
配置完成后，启动项目，访问： http://localhost:xxxx/admin-base/swagger-ui/index.html#/System/init，找到系统初始化接口，输入初始化 key，初始化系统。

前端

拉取项目后，进入目录。通过 pnpm 安装依赖，配置 .env.development 文件，启动项目。

# 打包路径
VITE_BASE_URL = /
VITE_IS_REQUEST_PROXY = true
VITE_API_URL = http://xxxx:xxxx/admin-base    #后端接口地址
VITE_API_URL_PREFIX = /api    #后端接口前缀
VITE_STATIC_URL = http://xxxx:xxxx/admin-base #静态资源地址， 如果用的是后端文件服务，则该地址为后端项目地址。

pnpm install
pnpm dev