# soybean-admin

**Repository Path**: gxsq/soybean-admin

## Basic Information

- **Project Name**: soybean-admin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-20
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SoybeanAdmin

SoybeanAdmin 是一个清新优雅、高颜值且功能强大的后台管理模板，基于 Vue3、Vite8、TypeScript、Pinia 和 UnoCSS 构建，提供一站式的后台管理解决方案。

## 安装步骤

```bash
# 进入项目目录
cd 01-web

# 安装依赖（需使用 pnpm）
pnpm install

# 启动开发服务器
pnpm dev
```

## 使用说明

### 环境要求

- NodeJS >= 20.19.0
- pnpm >= 10.5.0
- 后端服务：LightBoat Backend（需先启动）

### 后端服务配置

前端默认连接的后端地址：`http://localhost:10030`

如需修改后端地址，请修改 `.env` 文件或 `vite.config.ts` 中的代理配置。

### 默认登录账号

| 用户名   | 密码         | 角色    |
| ----- | ---------- | ----- |
| admin | `Aa12345#` | 超级管理员 |

### 运行命令

```bash
# 启动开发服务器（测试环境）
pnpm dev

# 启动开发服务器（生产环境配置）
pnpm dev:prod

# 构建生产版本
pnpm build

# 构建测试版本
pnpm build:test

# 预览构建结果
pnpm preview

# 代码检查与修复
pnpm lint

# 类型检查
pnpm typecheck

# 运行测试
pnpm test

# 生成路由
pnpm gen-route
```

## 主要功能

- **用户管理**：用户列表展示、新增、编辑、删除、批量操作
- **角色管理**：角色配置、权限分配、用户关联
- **菜单管理**：动态菜单配置、路由权限控制
- **部门管理**：部门树结构展示与管理
- **字典管理**：系统字典配置与维护
- **操作日志**：用户操作记录查询与审计
- **登录日志**：登录记录、失败原因追踪
- **文件管理**：文件上传、预览、下载
- **缓存管理**：缓存查看与清除
- **数据脱敏演示**：敏感数据展示效果预览
- **API加密**：接口加密配置与测试
- **三级防护**：安全防护级别配置

## 技术特性

- 采用 Vue3 Composition API
- Vite8 构建工具，极速开发体验
- TypeScript 类型安全
- Pinia 状态管理
- UnoCSS 原子化CSS
- NaiveUI 组件库
- 自动化文件路由系统
- 支持前端静态路由和后端动态路由
- 内置国际化方案
- 移动端自适应布局

## 依赖项

| 依赖         | 版本           | 说明      |
| ---------- | ------------ | ------- |
| Vue        | 3.5.34       | 前端框架    |
| Vite       | 8.0.12       | 构建工具    |
| TypeScript | 6.0.3        | 类型语言    |
| Pinia      | 3.0.4        | 状态管理    |
| NaiveUI    | 2.44.1       | UI组件库   |
| UnoCSS     | ^66.6.8      | 样式框架    |
| Vue Router | 5.0.7        | 路由管理    |
| Vue I18n   | 11.4.2       | 国际化     |
| ECharts    | 6.0.0        | 图表库     |
| Axios      | workspace:\* | HTTP客户端 |

## 许可证

MIT License