# Foadmin

**Repository Path**: Lyong9102/foadmin

## Basic Information

- **Project Name**: Foadmin
- **Description**: Foadmin 是一款现代化的企业级后台管理系统，基于 Vue 3 和 Python FastAPI 构建。 我们致力于为开发者提供高效、灵活、易用的管理后台解决方案。
- **Primary Language**: Unknown
- **License**: Artistic-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2026-05-11
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
    <img src="https://serve.www.foadmin.com/api/admin/media/preview/32f6d3c529cbbc87d64796c7638d2d79f7d513c277cf24052f717d4253c61812" width="300" alt="logo" />
</p>

<h3 align="center">Foadmin - Modern Enterprise Admin System</h3>

<p align="center">
    <a href="https://www.foadmin.com" target="_blank">🏠 Website</a> &nbsp;|&nbsp;
    <a href="https://www.foadmin.com/docs" target="_blank">📖 Docs</a> &nbsp;|&nbsp;
    <a href="https://demo.foadmin.com" target="_blank">🎮 Demo</a>
</p>

<p align="center">
    <img src="https://img.shields.io/badge/Vue-3.5-42b883?style=flat-square&logo=vue.js" alt="Vue 3" />
    <img src="https://img.shields.io/badge/FastAPI-0.116-009688?style=flat-square&logo=fastapi" alt="FastAPI" />
    <img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python" alt="Python" />
    <img src="https://img.shields.io/badge/Element_Plus-2.10-409EFF?style=flat-square" alt="Element Plus" />
    <img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" alt="License" />
</p>

---

### ✨ Introduction

Foadmin is a modern enterprise-level backend management system built on **Vue 3** and **Python FastAPI**. We aim to provide developers with an efficient, flexible, and easy-to-use backend solution.

### 🛠️ Tech Stack

| Layer | Technology | Description |
|:---:|:---:|:---|
| Frontend | Vue 3 + Vite 7 | Progressive JavaScript Framework |
| UI Components | Element Plus | Vue 3 based component library |
| CSS | Tailwind CSS | Utility-first CSS framework |
| Charts | ECharts | Data visualization library |
| Rich Editor | WangEditor | Lightweight web rich text editor |
| Backend | FastAPI | High-performance async Python web framework |
| ORM | SQLAlchemy 2.0 | Python SQL toolkit & ORM |
| Database | MySQL | Relational database |
| Auth | JWT (python-jose) | Stateless token authentication |
| Scheduler | APScheduler | Advanced Python task scheduler |

### 📸 Preview

![Preview](image.png)

### 🚀 Quick Start

#### Prerequisites

- Python 3.10+
- Node.js 18+
- MySQL 8.0+

#### Frontend

```bash
cd admin
npm install
npm run dev
```

#### Backend

```bash
cd server
pip install -r requirements.txt
# Configure .env file
python -m app.main
```

> 📖 For detailed deployment instructions, please visit: [Foadmin Docs](https://www.foadmin.com/docs)

### 📚 Documentation

Development documentation: [https://www.foadmin.com/docs](https://www.foadmin.com/docs)