# AdminSystem

**Repository Path**: tjfzeishuai/admin-system

## Basic Information

- **Project Name**: AdminSystem
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AdminSystem - 通用后台管理系统

前后端分离的通用后台管理系统基础框架，包含用户、角色、菜单、部门、字典、日志等通用模块，适用于快速搭建企业后台管理类项目。

## 技术栈

- 前端：Vite + React + TypeScript + Tailwind CSS + shadcn/ui（Radix UI）
- 后端：.NET 10 WebAPI + EF Core（Code First）+ SQLite
- 认证与授权：JWT Bearer + RBAC
- 日志：Serilog

## 功能模块

- 认证：登录 / 当前用户 / 刷新 Token
- 用户管理：CRUD、重置密码
- 角色管理：CRUD、分配权限
- 菜单管理：CRUD、菜单树
- 部门管理：CRUD、部门树
- 字典管理：字典类型与字典项
- 日志：操作日志、异常日志

## 快速开始

### 后端

```bash
cd backend/src/AdminSystem.Api
dotnet restore
dotnet run
```

- 启动成功后可访问 Swagger：`http(s)://localhost:<port>/swagger`
- 首次启动会自动创建 SQLite 数据库并写入种子数据

### 前端

```bash
cd frontend/admin-system-web
npm install
npm run dev
```

如需配置 API 地址，在 `frontend/admin-system-web` 下创建 `.env`：

```bash
VITE_API_BASE_URL=http://localhost:<port>/api
```

## 默认账号

- 用户名：admin
- 密码：Admin123!

## 项目结构

```text
AdminSystem/
├── backend/                      后端（.NET 10 WebAPI）
└── frontend/admin-system-web/    前端（Vite + React）
```

## 规范文档

详见 [SPEC.md](./SPEC.md)