# admin-core

**Repository Path**: wks20050721/admin-core

## Basic Information

- **Project Name**: admin-core
- **Description**: 通用后台管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-26
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Admin Core

基于 FastAPI + Vue 3 的现代化后台管理系统

## 项目简介

Admin Core 是一个功能完整的全栈后台管理系统，采用前后端分离架构。后端基于 Python FastAPI 框架构建，提供高效的 RESTful API 服务；前端采用 Vue 3 + TypeScript + Vite 技术栈，提供流畅的用户交互体验。

## 技术栈

### 后端技术
- **FastAPI**: 高性能异步 Web 框架
- **SQLAlchemy**: 数据库 ORM 工具
- **Pydantic**: 数据验证和序列化
- **JWT**: JSON Web Token 身份认证
- **Passlib**: 密码加密工具

### 前端技术
- **Vue 3**: 渐进式 JavaScript 框架
- **TypeScript**: 类型安全的编程语言
- **Vite**:下一代前端构建工具
- **Vue Router**: 官方路由管理
- **Pinia**: 状态管理库

## 项目结构

```
admin-core/
├── backend/                    # 后端项目
│   ├── app/
│   │   ├── api/               # API 路由
│   │   │   ├── auth.py        # 认证接口
│   │   │   └── users.py       # 用户接口
│   │   ├── config.py          # 配置文件
│   │   ├── database.py        # 数据库连接
│   │   ├── main.py           # 应用入口
│   │   ├── models/           # 数据模型
│   │   │   └── user.py       # 用户模型
│   │   ├── schemas/          # Pydantic 模型
│   │   │   └── user.py       # 用户 schemas
│   │   └── utils/            # 工具函数
│   │       └── security.py   # 安全相关工具
│   └── requirements.txt      # Python 依赖
│
└── frontend/my-admin/         # 前端项目
    ├── src/
    │   ├── api/              # API 调用
    │   │   ├── auth.ts       # 认证接口
    │   │   └── user.ts       # 用户接口
    │   ├── components/       # 公共组件
    │   ├── router/           # 路由配置
    │   ├── stores/           # 状态管理
    │   ├── types/            # TypeScript 类型
    │   ├── utils/            # 工具函数
    │   │   └── request.ts    # HTTP 请求封装
    │   └── views/            # 页面组件
    │       ├── InitAdmin.vue # 初始化页面
    │       └── Login.vue     # 登录页面
    └── package.json
```

## 主要功能

- **用户认证**: 支持 JWT Token 的身份验证机制
- **安全登录**: 密码加密存储，安全的登录流程
- **初始化管理**: 首次使用时创建管理员账户
- **用户管理**: 基础的用户数据管理功能

## 快速开始

### 环境要求

- Python 3.8+
- Node.js 16+
- pnpm (推荐) 或 npm

### 后端设置

1. 进入后端目录：
```bash
cd backend
```

2. 创建虚拟环境并激活：
```bash
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows
```

3. 安装依赖：
```bash
pip install -r requirements.txt
```

4. 配置数据库（修改 `app/config.py` 中的数据库 URL）

5. 启动后端服务：
```bash
uvicorn app.main:app --reload
```

后端服务将在 `http://localhost:8000` 启动。

### 前端设置

1. 进入前端目录：
```bash
cd frontend/my-admin
```

2. 安装依赖：
```bash
pnpm install
```

3. 启动开发服务器：
```bash
pnpm dev
```

前端服务将在 `http://localhost:5173` 启动。

## API 文档

后端服务启动后，可通过以下地址访问自动生成的 API 文档：

- Swagger UI: `http://localhost:8000/docs`
- ReDoc: `http://localhost:8000/redoc`

### 主要接口

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/auth/login` | 用户登录 |
| GET | `/api/users/check-init` | 检查是否需要初始化 |
| POST | `/api/users/init` | 初始化管理员账户 |

## 使用流程

1. **首次访问**: 打开前端页面，系统会自动检测是否需要初始化
2. **初始化**: 创建第一个管理员账户
3. **登录**: 使用管理员账户登录系统
4. **管理**: 进入后台管理界面进行操作

## 项目预览

- **登录页面**: 简洁的登录界面，支持管理员登录
- **初始化页面**: 首次使用时引导创建管理员账户

## 许可证

本项目仅供学习和研究使用。