1. Project Overview

FuAdmin

A backend management system and Python low-code platform developed using the currently popular technology stack Vben Vue Vue3 Python Django Ninja (a combination of Fast Api and Django).

2. Open Source License

Licensed under Apache-2.0

3. Screenshots

Demo Images 

4. Feature Overview

Why Use Django-Ninja and Vue3

「Django Ninja Compared to Django Rest Framework 」

• Simple: Designed to be easy to use and intuitive. Develop APIs directly using @decorators (called annotations in Java, I think).

• Fast Execution: Very high performance thanks to Pydantic and asynchronous support.

• Fast Coding: Input hints and automatic documentation let you focus only on business logic.

• Standards-Based: Built on open API standards: OpenAPI (formerly known as Swagger) and JSON Schema.

• Django Integration: Well integrated with Django's own features and ORM.

「Vue3 」

• One of the most popular frameworks and one of the most popular frontend frameworks in China.

• Improved performance, running 1.5 times faster than Vue2.

• Smaller bundle size, with a smaller compiled size than Vue2 through on-demand compilation.

• Type inference, better TypeScript support, which is also a trend.

• Advanced capabilities, exposing lower-level APIs and providing more advanced built-in components.

• Composition API, better organization, encapsulation, and reuse of logic.

Built-in functions

• Menu Management: Configure system menus, operation permissions, button permission identifiers, backend API permissions, and more.

• Department Management: Configure system organizational structures (companies, departments, and roles).

• Role Management: Assign menu permissions and data permissions to roles, and configure data access scopes by department.

• Permission Management: Authorize the permission scope of roles.

• User Management: Users are system operators. This feature mainly handles system user configuration.

• Data Dictionary: Maintain relatively fixed data frequently used in the system.

• Category Dictionary: Maintain hierarchical data frequently used in the system.

• Attachment Management: Centrally manage all files, images, and other attachments across the platform.

• Operation Logs: Record and query normal system operation logs; record and query system error logs.

• Scheduled Tasks: Configure scheduled tasks for the system.

5. Tech Stack

fu-admin-web is developed using VUE3 and TS. fu-admin-backend is developed using Python, Django, and Django-Ninija. The database supports MySql, SqlServer, and Sqlite.

• Frontend uses VbenAdmin, Vue3, and Ant Design Vue.

• Backend uses the Python language, Django framework, and the powerful Django Ninja.

• Support loading dynamic permission menus, easy and convenient permission control.

• For Vue2 projects, see Dvadmin.

• Special Thanks: VbenAdmin, Ant Design Vue, GoView

Preparation Work

Python >= 3.8.0 (Version 3.8+ recommended)
nodejs >= 16.0 (Latest version recommended)
Mysql >= 5.7.0 (Optional; default database is sqlite3, version 8.0 recommended)
Redis (Required by default; latest version recommended. The cache configuration in the backend project can be modified.)

Frontend ♝

pnpm is recommended. The project provides pnpm-lock.yaml. Using other package managers may cause version dependency issues.

# Clone the project
Visit Yifei Open Source: https://code.exmay.com/ Download

# Enter the project directory
cd fu-admin/web

# Install dependencies
pnpm install --registry=https://registry.npm.taobao.org

# Start Service
pnpm dev
# Access via Browser https://localhost:8080
# The .env file can be used to configure parameters such as the startup port.
# Build for production
# pnpm build

Backend

# Clone the project
Visit Yifei Open Source: https://code.exmay.com/ Download
# Enter the project directory
cd fu-admin/backend
# Configure database information in `env.py`.
# The default database is Mysql. If you use SqlServer, enable it in requirements.txt.
    mssql-django==1.1.2
    pyodbc==4.0.32
# Install Dependencies
pip3 install -r requirements.txt
# Run the migration command:
python3 manage.py makemigrations system
python3 manage.py migrate
# Initialize Data
python3 manage.py init
# Initialize Province, City, and County Data:
python3 manage.py init_area
# Start the Project
python3 manage.py runserver 0.0.0.0:8000
# Or use daphne:
daphne -b 0.0.0.0 -p 8000 fuadmin.asgi:application

Access the Project

• Documentation URL: [https://localhost:8080/api/docs](https://localhost:8080/api/docs) (This is the default URL. If modified, refer to the configuration file.)

• Username: superadmin Password: 123456

Docker Build

Please refer to the Docker Build documentation.