正在加载文档...
文档内容较大,正在处理中,请稍候
正在加载文档...
文档内容较大,正在处理中,请稍候
WlAdmin 是一个企业级全栈管理系统解决方案,采用 Monorepo 架构统一管理多个应用:
react-antd-webpack) - React 18 + Ant Design 6 + Webpack 5app-rn-ts) - React Native + Expo 54 + TypeScriptnode-express-mysql) - Node.js + Express + MySQLdoc-next-ts) - Next.js 16 + TypeScript代码仓库:https://gitee.com/lyqjob/project-root
在开始之前,请确保你的开发环境满足以下要求:
npm 或 yarnnpm install 或 yarn installpnpm install 安装依赖# 克隆项目到本地
git clone https://gitee.com/lyqjob/project-root.git
# 进入项目目录
cd project-root# 使用 npm 全局安装 pnpm
npm install -g pnpm
# 验证安装
pnpm --version
# 应该显示:10.24.0 或更高版本# 在项目根目录执行,安装所有应用的依赖
pnpm install说明:
apps/ 和 packages/ 的依赖# 登录 MySQL
mysql -u root -p
# 创建数据库(请根据实际情况修改数据库名)
CREATE DATABASE wladmin CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
# 退出 MySQL
exit;项目提供了完整的数据库初始化脚本,位于 sql/sqlinit/ 目录。
按顺序执行以下脚本(重要:必须按顺序执行):
# 进入数据库初始化脚本目录
cd sql/sqlinit
# 1. 创建所有核心数据表
mysql -u root -p wladmin < 建表.sql
# 2. 创建监控数据相关表
mysql -u root -p wladmin < 监控数据相关表.sql
# 3. 导入省市区数据
mysql -u root -p wladmin < 省市区数据.sql
# 4. 导入预制数据:超级管理员(可自定义)、角色、菜单、权限等
mysql -u root -p wladmin < 预制数据.sql
默认超级管理员账号:
superadmin123456# 进入后端应用目录
cd apps/node-express-mysql
# 复制环境变量模板
cp .env.example .env
# 编辑 .env 文件,配置数据库连接等信息
# 至少需要配置以下变量:
# DB_DEV_HOST=localhost
# DB_DEV_PORT=3306
# DB_DEV_USER=root
# DB_DEV_PASSWORD=your_password
# DB_DEV_NAME=wladmin# 进入文档站应用目录
cd apps/doc-next-ts
# 复制环境变量模板
cp .env.example .env
# 配置 API 地址等(如果需要)# 在项目根目录执行
# 启动所有应用(并行启动)
pnpm dev
# 或者单独启动某个应用
pnpm dev:frontend # 只启动 Web 前端
pnpm dev:backend # 只启动后端服务
pnpm dev:doc # 只启动文档站# 启动后端服务(端口 8888)
cd apps/node-express-mysql
pnpm dev
# 启动 Web 前端(端口 8080)
cd apps/react-antd-webpack
pnpm dev
# 启动文档站(端口 8081)
cd apps/doc-next-ts
pnpm dev启动成功后,可以通过以下地址访问:
默认登录账号:
superadmin123456project-root/ # 项目根目录
├── apps/ # 应用程序目录
│ ├── react-antd-webpack/ # Web 前端应用
│ ├── node-express-mysql/ # 后端服务应用
│ ├── app-rn-ts/ # 移动端 App
│ └── doc-next-ts/ # 文档站(当前项目)
├── packages/ # 共享包目录
│ └── utils/ # 工具包
│ └── axiosApi/ # Axios API 封装
├── sql/ # 数据库脚本
│ └── sqlinit/ # 数据库初始化脚本
├── docs/ # 项目文档
├── pnpm-workspace.yaml # PNPM workspace 配置
├── turbo.json # Turbo 构建配置
└── package.json # 根目录配置# 开发环境
pnpm dev # 启动所有应用
pnpm dev:frontend # 只启动 Web 前端
pnpm dev:backend # 只启动后端服务
pnpm dev:doc # 只启动文档站
# 构建
pnpm build # 构建所有应用
pnpm build:frontend # 只构建 Web 前端
# 代码质量
pnpm lint # 运行 ESLint 检查
pnpm format # 格式化代码
pnpm format:check # 检查代码格式
# 清理
pnpm clean # 清理所有构建产物
pnpm kill:ports # 杀死占用端口的进程# 进入应用目录
cd apps/doc-next-ts
# 开发环境
pnpm dev # 启动开发服务器(端口 8081)
# 构建
pnpm build # 构建生产版本
pnpm start # 启动生产服务器
# 代码质量
pnpm lint # 运行 ESLint 检查
pnpm lint:fix # 自动修复 ESLint 错误
pnpm format # 格式化代码
pnpm type-check # TypeScript 类型检查如果你熟悉 Docker,可以使用 Docker 快速启动后端MySQL和Redis:
cd docker_project/docker-compose
# 配置 MySQL 环境变量
cp .env.example .env
# 编辑 .env 文件,配置数据库密码等
# 配置 Redis 配置文件
# 从模板文件复制 Redis 配置文件
cp redis-data/conf/redis.conf.example redis-data/conf/redis.conf
# 编辑 Redis 配置文件,设置 Redis 密码
# 将 redis.conf 文件中的 your-password 替换为你的实际密码
# 例如:requirepass your-password -> requirepass your_redis_password
# 同时更新 user default 和 user admin 的密码配置
# 启动 MySQL 和 Redis
docker-compose up -dRedis 配置说明:
Redis 配置文件位于 docker_project/docker-compose/redis-data/conf/redis.conf,需要从模板文件 redis.conf.example 复制并配置:
复制配置文件:
cp redis-data/conf/redis.conf.example redis-data/conf/redis.conf编辑配置文件,修改以下内容:
requirepass your-password - 设置 Redis 密码(替换 your-password)user default on >your-password ~* +@all - 设置 default 用户密码user admin on >your-password ~* +@all - 设置 admin 用户密码配置示例:
requirepass your_redis_password
user default on >your_redis_password ~* +@all
user admin on >your_redis_password ~* +@all注意:Redis 密码需要与后端服务.env 文件中的 PRO_REDIS_PASSWORD 配置保持一致。
祝使用愉快! 🎉