# CommonAdminTemplate

**Repository Path**: wangingan/common-admin-template

## Basic Information

- **Project Name**: CommonAdminTemplate
- **Description**: 个人开发的通用后台管理模板项目，包含前端和后端
后端使用 net8 、sqlsugar 分库分表多租户，兼容MySQL、SQL server、Oracle、sqlite、达梦、人大金仓等数据库
前端采用最新的Vue3 、TS、Vite
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-13
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 通用后台管理系统模板

## 项目介绍
这是一个基于.NET 8的通用后台管理系统模板，包含以下主要功能模块：
- 用户权限管理
- 部门管理
- 角色管理
- 菜单管理
- 系统日志
- 多租户支持
- 文件上传
- 数据缓存
- 事务管理
- 接口限流
- 数据审计

## 技术架构
后端采用.NET 8 + SqlSugar + Autofac + Serilog + JWT + Swagger + Redis
- ORM框架：SqlSugar
- 依赖注入：Autofac
- 日志记录：Serilog
- 身份验证：JWT
- 接口文档：Swagger
- 缓存管理：Redis
- 异常处理：全局异常过滤器
- 请求日志：中间件记录请求响应
- 数据库分表：按月分表处理日志数据

## 安装部署
1. 数据库配置：修改`appsettings.json`中的数据库连接字符串
2. Redis配置：修改`appsettings.json`中的Redis连接配置
3. JWT配置：修改`appsettings.json`中的JWT配置
4. 日志路径：确保日志存储路径有写入权限
5. 数据库迁移：运行数据迁移脚本初始化数据库结构
6. 数据种子：系统包含初始化数据种子，可自动创建基础数据

## 使用说明
### 用户权限
- 系统采用基于角色的权限控制(RBAC)
- 支持接口级权限控制
- 支持按钮级权限控制
- 支持菜单树权限分配

### API文档
- 接口文档地址：`/swagger`
- 提供完整的API测试界面
- 支持JWT令牌认证测试

### 数据缓存
- 支持分布式缓存配置
- 提供缓存清理接口
- 支持缓存键值管理

### 日志管理
- 记录所有SQL执行日志
- 记录系统异常日志
- 记录接口访问日志
- 支持日志文件查看
- 支持日志级别过滤

### 多租户支持
- 支持数据库级租户隔离
- 支持表级租户隔离
- 支持租户配置管理

## 接口规范
所有API接口返回统一格式：
```json
{
  "status": 200,
  "success": true,
  "msg": "请求成功",
  "response": {}
}
```

错误响应示例：
```json
{
  "status": 500,
  "success": false,
  "msg": "系统异常",
  "msgDev": "异常详细信息",
  "response": null
}
```

## 贡献指南
1. Fork本仓库
2. 创建新分支
3. 提交代码修改
4. 创建Pull Request

## 特色功能
- 完善的AOP日志记录
- 数据库事务管理
- 自动化数据迁移
- 请求响应日志记录
- 完整的用户权限体系
- 支持多级缓存策略
- 完善的异常处理机制
- 支持分库分表
- 提供丰富的扩展点
- 支持性能监控

## 版本更新
- v1.0.0: 基础框架搭建
- v1.1.0: 增加多租户支持
- v1.2.0: 完善日志审计功能
- v1.3.0: 增加Redis缓存管理
- v1.4.0: 完善接口文档和测试用例

## 许可证
本项目采用MIT开源许可证，详情请查看LICENSE文件。