# layuiadmin

**Repository Path**: zimuo/layuiadmin

## Basic Information

- **Project Name**: layuiadmin
- **Description**: LayuiAdmin基础后台管理系统（登录、注册、用户管理、菜单管理）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-10
- **Last Updated**: 2025-12-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XBAdmin后台管理系统介绍与使用教程

## 项目概述
XBAdmin是一个基于Flask和LayUI开发的轻量级后台管理系统，提供用户认证、权限管理、用户管理和菜单管理等核心功能。系统采用角色-菜单的权限控制模型，支持多级菜单结构，适合作为各类Web应用的后台管理解决方案。

## 技术栈
- 后端：Python 3.11 + Flask 2.0 + SQLAlchemy
- 数据库：SQLite
- 前端：LayUI 2.9.7 + jQuery

## 功能介绍

### 1. 用户认证
- 登录功能：支持用户名和密码登录
- 会话管理：使用Flask-Session管理用户会话
- 权限控制：基于角色的访问控制

### 2. 权限管理
- 角色管理：支持创建、编辑、删除角色
- 菜单管理：支持创建、编辑、删除菜单，支持多级菜单结构
- 角色-菜单关联：通过多对多关系实现角色与菜单的权限分配

### 3. 用户管理
- 用户列表：查看所有用户信息
- 添加用户：创建新用户并分配角色
- 编辑用户：修改用户信息和角色
- 删除用户：删除指定用户

### 4. 系统管理
- 仪表盘：显示系统统计数据（用户数量、角色数量、菜单数量）
- 菜单树：基于角色权限动态生成左侧导航菜单

## 使用教程

### 1. 安装与配置
1. 克隆项目代码到本地
2. 安装依赖：`pip install -r requirements.txt`
3. 初始化数据库：`python init_data.py`
4. 启动服务：`python run.py`
5. 访问系统：在浏览器中输入 `http://127.0.0.1:5001`

### 2. 登录系统
- 默认管理员账号：admin
- 默认管理员密码：admin
- 登录页面：输入用户名和密码后点击"登录"按钮

### 3. 系统使用

#### 3.1 仪表盘
登录成功后，系统会自动跳转到仪表盘页面，显示系统统计数据。

#### 3.2 用户管理
1. 点击左侧菜单中的"用户管理"，进入用户列表页面
2. 在用户列表页面，可以查看所有用户信息
3. 点击"添加用户"按钮，填写用户信息并分配角色
4. 点击用户列表中的"编辑"按钮，修改用户信息
5. 点击用户列表中的"删除"按钮，删除指定用户

#### 3.3 菜单管理
1. 点击左侧菜单中的"菜单管理"，进入菜单列表页面
2. 在菜单列表页面，可以查看所有菜单信息
3. 点击"添加菜单"按钮，填写菜单信息并设置父菜单（可选）
4. 点击菜单列表中的"编辑"按钮，修改菜单信息
5. 点击菜单列表中的"删除"按钮，删除指定菜单

### 4. 退出系统
点击右上角的用户名，在下拉菜单中选择"退出"，即可退出系统。

## 注意事项
1. 系统默认使用SQLite数据库，数据存储在instance/xbadmin.db文件中
2. 建议在生产环境中修改SECRET_KEY和管理员密码
3. 生产环境中应使用更安全的数据库，如MySQL或PostgreSQL
4. 系统目前处于开发阶段，请勿直接用于生产环境