QiLuo - Rust Rapid Development Platform

High Performance · Secure and Reliable · Enterprise-grade Application Development Framework

📖 Project Overview

QiLuo is an enterprise-grade rapid development platform built on the Rust technology stack. It adopts modern architectural design and provides a complete backend management system solution. The platform integrates core functions such as user management, permission control, system monitoring, and WeChat official account management, suitable for information construction of small and medium-sized enterprises.

✨ Core Features

🦀 Rust Ecosystem — Built on Rust + Axum + Sea-ORM + JWT, with excellent performance and memory safety
🔐 Permission Management — Complete RBAC permission system, supporting multi-dimensional permission control for users, roles, menus, and APIs
📱 WeChat Integration — Built-in WeChat official account management, supporting menu configuration, message management, user management, and automatic replies
⚡ High Performance — Asynchronous architecture, supporting high concurrency and fast response speed
🌐 Distributed — Supports cluster deployment, multiple data sources, and distributed architecture
📊 System Monitoring — Real-time server status monitoring, online user management, and operation log tracking
⏰ Scheduled Tasks — Online configuration of scheduled tasks, supporting Cron expressions
🎨 Modern Interface — Vue-based management backend with a beautiful interface and convenient operation

🛠️ Technology Stack

Backend Technology

Technology	Description	Version
Rust	System development language	>= 1.70.0
Axum	Web framework	Latest version
Sea-ORM	ORM framework	Latest version
Tokio	Asynchronous runtime	Latest version
MySQL/SQLite	Database	MySQL >= 8.0 or SQLite >= 3.35
Redis	Cache service	>= 6.0
JWT	Authentication mechanism	Latest version
tracing	Logging system	Latest version

Frontend Technology

Technology	Description	Version
Vue	Frontend framework	3.4.x
Vite	Build tool	5.2.x
TypeScript	Type system	5.4.x
Pinia	State management	2.1.x
Vue Router	Routing management	4.3.x
Element Plus	UI component library	2.7.x
Axios	HTTP request	Latest version
ECharts	Chart library	Latest version

🚀 Quick Start

System Requirements

Before running the project, ensure your system has the following software installed:

Rust >= 1.70.0 (Installation Guide)
MySQL >= 8.0 or SQLite >= 3.35
Redis >= 6.0 (optional, for caching)
Node.js >= 16.0.0 (for frontend development)

1. Obtain Source Code

Backend address: https://github.com/chelunfu/qiluo_admin.git

Clone the backend project

git clone https://github.com/chelunfu/qiluo_admin.git
cd qiluo_admin

Frontend address: https://github.com/chelunfu/qiluo_vue.git

Clone the frontend project

git clone https://github.com/chelunfu/qiluo_vue.git
cd qiluo_vue

2. Configure Database

Edit the configuration file in the config/ directory to set database connection information:

[database]
url = "mysql://username:password@localhost:3306/qiluo"
# Or use SQLite
# url = "sqlite:data/qiluo.db"

Create the database and import the qiluo.sql file.

3. Start the Project

Start the backend service

# Run in development mode
cargo run


#### Start the frontend project

```bash
# Install dependencies
pnpm install

# Start the development server
pnpm run dev

4. Access the System

After the service starts, access the following address:

Management backend: http://localhost:4000

🔧 Production Environment Deployment

Backend Deployment

# Build Release version
cargo build --release

# Run Release version
./target/release/qiluo

Frontend Deployment

# Build for production environment
pnpm build:pro

# The build output is in the dist directory, which can be deployed to any static server

📁 Project Structure

Backend Directory Structure

qiluo/
├── 📁 config/               # Configuration files
├── 📁 data/                 # Data storage directory
│   ├── 📁 img/              # Image resources
│   ├── 📁 log/              # Log files
│   ├── 📁 static/           # Static resources
│   ├── 📁 upload/           # Uploaded files
│   └── 📁 web/              # Frontend files
├── 📁 migration/            # Database migrations
├── 📁 src/                  # Source code
│   ├── 📁 api/              # API controllers
│   │   ├── 📁 sys_controll/ # System management interfaces
│   │   └── 📁 wechat/       # WeChat interfaces
│   ├── 📁 cache/            # Cache management
│   ├── 📁 common/           # Common modules
│   ├── 📁 config/           # Configuration module
│   ├── 📁 midle_ware/       # Middleware
│   ├── 📁 model/            # Data models
│   ├── 📁 service/          # Business services
│   └── 📁 worker/           # Background tasks
└── 📄 Cargo.toml            # Project configuration

Frontend Directory Structure

qiluo_vue/
├── 📁 public/               # Static resources directory
├── 📁 src/                  # Source code directory
│   ├── 📁 api/              # API interface definitions
│   ├── 📁 assets/           # Project resource files
│   ├── 📁 axios/            # Axios request configuration
│   ├── 📁 components/       # Common components
│   ├── 📁 constants/        # Constant definitions
│   ├── 📁 directives/       # Custom directives
│   ├── 📁 hooks/            # Custom Hooks
│   ├── 📁 layout/           # Layout components
│   ├── 📁 locales/          # Internationalization resources
│   ├── 📁 plugins/          # Plugin configurations
│   ├── 📁 router/           # Routing configuration
│   ├── 📁 store/            # State management
│   ├── 📁 styles/           # Style files
│   ├── 📁 utils/            # Utility functions
│   ├── 📁 views/            # Page views
│   ├── 📄 App.vue           # Root component
│   ├── 📄 main.ts           # Application entry file
│   └── 📄 permission.ts     # Permission control
├── 📁 types/                # TypeScript type definitions
├── 📄 index.html            # HTML template
├── 📄 package.json          # Project dependencies
└── 📄 vite.config.ts        # Vite configuration

📖 Function Modules

System Management

👥 User Management — User CRUD, password reset, avatar upload
🔐 Role Management — Role creation, permission assignment, user association
🏢 Department Management — Organizational structure tree management
📋 Menu Management — System menu configuration and permission control
📚 Data Dictionary — System dictionary data management
📊 System Monitoring — Server status, online user monitoring
📝 Log Management — Operation logs, login log records
⏰ Scheduled Tasks — Task configuration, execution monitoring
🔌 API Permissions — Interface-level permission control

WeChat Management

📱 Official Account Management — Multi-account configuration management
📋 Menu Management — Custom menu creation and publishing
💬 Message Management — Message sending/receiving and history records
👤 User Management — Fan information management
🤖 Auto-reply — Keyword intelligent reply

🔑 Default Account

When running the system for the first time, you can log in with the following default administrator account:

Username: admin
Password: 123456

⚠️ Security Note: Please change the default password immediately after the first login!

🌐 Browser Support

This system supports modern browsers and does not support IE:

Edge	Firefox	Chrome	Safari
last 2 versions	last 2 versions	last 2 versions	last 2 versions

📷 System Screenshots

For more screenshots, please visit the official website

🐛 Issue Feedback

If you encounter problems during use, please provide feedback through the following methods:

GitHub Issues: Submit an issue
Official Website: https://www.qiluo.vip
Technical Exchange: Welcome to join our technical exchange QQ group to communicate with other users, share your problems, and seek their help.

🤝 Contribution Guide

We welcome contributions in any form, including but not limited to:

🐛 Submitting bug reports
💡 Proposing new feature suggestions
📝 Improving documentation
🔧 Submitting code patches

Before submitting contributions, please read our Contribution Guide.

💰 Become a Sponsor

If you would like to support the development of this project, you can become a sponsor through the following ways:

WeChat Pay

Alipay

📄 License

This project is licensed under the MIT License. For details, please refer to the LICENSE file.

🙏 Acknowledgments

Thank all sponsors and contributors who support this project; your support enables this project to develop better.

Special thanks to the following open-source projects:

⭐ If this project is helpful to you, please give me a Star!

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
config		config
data		data
migration		migration
src		src
.env		.env
.gitignore		.gitignore
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md
README.zh-CN.md		README.zh-CN.md
doc.md		doc.md
qiluo.sql		qiluo.sql

License

lineCode/qiluo_admin

Folders and files

Latest commit

History

Repository files navigation