# MonoAdmin

**Repository Path**: xbmt/mono-admin

## Basic Information

- **Project Name**: MonoAdmin
- **Description**: MonoAdmin 是基于 Vue3 + webman 开发的企业级中后台管理系统，以 “极简架构 + 高颜值交互” 重新定义企业级中后台系统管理框架
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://www.mnadm.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-10-09
- **Last Updated**: 2025-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mono Admin 系统使用说明文档

## 项目简介

mono-admin是一个现代化的后台管理系统，以 "极简架构 + 高颜值交互" 重新定义企业级中后台系统管理框架。

![项目展示](./images/1.png)
![系统界面](./images/2.png)

### 技术栈

**前端技术栈：**
- Vue 3.5.17 - 渐进式JavaScript框架
- Ant Design Vue 4.2.6 - 企业级UI组件库
- Vue Router 4.5.1 - 官方路由管理器
- Pinia 3.0.3 - 状态管理库
- ECharts 5.6.0 - 数据可视化图表库
- Vite 7.0.5 - 前端构建工具

**后端技术栈：**
- PHP 8.1+ - 服务端编程语言
- Webman 2.1 - 高性能HTTP服务框架

## 系统架构

```
mono-admin/
├── frontend/          # 前端项目（Vue3 + Ant Design Vue）
│   ├── src/
│   │   ├── api/       # API接口封装
│   │   ├── components/# 公共组件
│   │   ├── layout/    # 布局组件
│   │   ├── router/    # 路由配置
│   │   ├── stores/    # 状态管理
│   │   ├── styles/    # 样式文件
│   │   ├── utils/     # 工具函数
│   │   └── views/     # 页面组件
│   └── public/        # 静态资源
├── backend/           # 后端项目（Webman Framework）
│   ├── app/
│   │   ├── adminapi/  # 管理后台API
│   │   ├── model/     # 数据模型
│   │   ├── middleware/# 中间件
│   │   └── process/   # 进程管理
│   ├── config/        # 配置文件
│   ├── database/      # 数据库迁移
│   └── public/        # 公共资源
└── README.md          # 项目说明
```

## 功能模块

- **用户管理**：用户列表、新增、编辑、删除、状态管理
- **角色管理**：角色权限分配、角色列表维护
- **权限管理**：菜单权限、按钮权限、API权限控制
- **字典管理**：系统字典类型和字典数据维护
- **操作日志**：系统操作记录查询和管理


## 安装部署

### 环境要求

**系统要求：**
- PHP >= 8.1
- MySQL >= 5.7
- Redis >= 5.0
- Node.js >= 16.0

### 后端部署

1. **安装依赖**
```bash
cd backend
composer install
```

2. **配置数据库**
编辑 `config/database.php` 文件，配置数据库连接信息：
```php
'mysql' => [
    'driver'   => 'mysql',
    'host'     => 'localhost',
    'port'     => '3306',
    'database' => 'mono-admin',
    'username' => 'your_username',
    'password' => 'your_password',
    'charset'  => 'utf8mb4',
    'prefix'   => 'mono_',
]
```

3. **配置Redis**
编辑 `config/redis.php` 文件，配置Redis连接信息。

4. **启动服务**
```bash
# Windows环境
php windows.php start

# Linux环境
php start.php start
```

### 前端部署

1. **安装依赖**
```bash
cd frontend
npm install
```

2. **开发环境启动**
```bash
npm run dev
```
访问：http://localhost:3000

3. **生产环境构建**
```bash
npm run build
```

## 使用指南

### 登录系统

1. 访问系统登录页面
2. 输入用户名和密码
3. 可选择"记住密码"功能（7天免登录）
4. 点击登录按钮进入系统

**默认管理员账户：**
- 用户名：admin
- 密码：abcd1234@

## 联系我们
- 邮箱：mmteen@sina.com
- 微信：miaodadaq