# LibertaAdmin

**Repository Path**: hangelk/LibertaAdmin

## Basic Information

- **Project Name**: LibertaAdmin
- **Description**: 基于 .NET 8 + Vue 3 的轻量框架的详细指导，专注于用户管理、权限管理和登录验证，支持 SQLite、MySQL，保持简单、轻量。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-06-12
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

LibertaAdmin
🚀 介绍
LibertaAdmin 是一个基于 .NET 8 + Vue 3 (Vite) 开发的轻量级前后端分离后台管理系统。 本项目专注于用户管理、RBAC 权限管理和身份验证（JWT），旨在保持代码的简洁性与轻量化，同时支持 SQLite 和 MySQL 数据库切换，非常适合作为中小型项目的脚手架或学习参考。

🏗️ 目录结构说明
Plaintext

LibertaAdmin/
├── Liberta.sln             # 全局解决方案文件 (管理所有后端项目)
├── .gitignore               # 根目录 Git 忽略配置
├── README.md                # 项目说明文档
│
├── Liberta.Api/             # 【后端核心 - .NET 8】
│   ├── WebApi/              # 启动层：控制器、Swagger 配置、中间件
│   ├── Application/         # 应用层：业务逻辑、DTO、接口定义
│   ├── Domain/              # 领域层：实体类、业务逻辑常量
│   ├── Infrastructure/      # 基础设施层：EF Core、数据库迁移、第三方集成
│   ├── Common/              # 公共组件：工具类、通用枚举
│   └── .gitignore           # 后端专用忽略配置
│
└── Liberta.UI/              # 【前端核心 - Vue 3 + Vite】
    ├── src/                 # 源代码 (Views, Components, Stores, API)
    ├── node_modules/        # 前端依赖包
    ├── index.html           # 入口页面
    ├── vite.config.js       # Vite 配置文件
    ├── tailwind.config.js   # Tailwind CSS 配置
    └── .gitignore           # 前端专用忽略配置

🛠️ 软件架构
后端: 采用 Clean Architecture (整洁架构) 思想，分层解耦。

ORM: Entity Framework Core

数据库: 默认使用 SQLite (轻量)，可轻松切换至 MySQL。

认证: JWT (JSON Web Token)

前端: Vue 3 (Composition API) + Vite + Pinia。

样式: Tailwind CSS

UI组件: (此处可填写你使用的组件库，如 Element Plus 或 Ant Design Vue)

🚦 快速开始
1. 环境准备
安装 .NET 8 SDK

安装 Node.js (建议 v18+)

安装 IDE (推荐 Visual Studio 2022 或 VS Code)

2. 后端启动 (Server)
Bash

cd Liberta.Api/WebApi
# 运行项目
dotnet run
注意: 数据库连接字符串可在 WebApi/appsettings.json 中配置。首次运行会自动创建 SQLite 数据库文件。

3. 前端启动 (UI)
Bash

cd Liberta.UI
# 安装依赖
npm install
# 启动开发服务器
npm run dev
4. 项目构建
Bash

# 前端打包
npm run build
# 后端发布
dotnet publish -c Release
✨ 主要功能
[x] 身份验证: 基于 JWT 的登录与刷新 Token。

[x] 权限管理: 灵活的 RBAC（用户-角色-权限）模型。

[x] 动态菜单: 根据后台权限配置自动生成前端菜单。

[x] 多数据库支持: 一键切换 SQLite 或 MySQL。

[x] 代码简洁: 拒绝过度设计，核心代码易读易懂。

📄 开源协议
本项目遵循 MIT 开源协议。