1. Project Overview

Magic.NET

A decoupled frontend and backend architecture, ready to use out of the box and built with cutting-edge technologies

A general-purpose management platform built with Furion/.NET 7. It integrates the latest technologies and supports modular, plugin-based development with a decoupled frontend and backend architecture, ready to use out of the box. It incorporates numerous advanced features, including SqlSugar, multi-tenancy, caching, data validation, authentication and authorization, event bus, dynamic APIs, communications, remote requests, task scheduling, and workflows. Its clean, extensible code makes development simpler, more versatile, and more accessible!

2. Open Source License

Licensed under Apache-2.0

3. Screenshots

Effect picture

4. Feature Overview

Overview

• A general-purpose permission management platform (RBAC model) built with .NET 6 and .NET 7. It integrates the latest technologies for efficient and rapid development, features a decoupled frontend and backend architecture, and is ready to use out of the box.

• The frontend is based on the Xiaonuo Vue (Ant Design Vue) framework. The overall RBAC basic data structure and API interface style follow the Xiaonuo Vue version.

• The backend is built on the Furion framework and integrates numerous core features, including SqlSugar, multi-tenancy, database sharding with read/write separation, caching, data validation, authentication and authorization, dynamic APIs, and gRPC.

• A modular architecture with a clear layered structure. Business logic is recommended to be implemented in separate modules, so framework upgrades won't affect your business code!

• Core modules include user, role, position, organization, menu, dictionary, logs, multi-application management, file management, scheduled tasks, and more.

• Less code, easy to understand, powerful features, and easy extensibility. Start developing with ease today!

• Integrated with many new features, including workflow and SignalR.

Detailed Features

• Dashboard and console pages provide displays for workbenches, analysis pages, statistics, and other features.

• User management: Manage enterprise users and system administrator accounts. Users can be assigned positions, organizations, roles, data permissions, and more.

• Application management: Control menu displays across different dimensions through applications.

• Organization management: Maintain the company's organizational structure with support for hierarchical tree structures across multiple levels.

• Position management: Manage user positions. Positions can serve as user tags but are not currently linked to permissions or other features.

• Menu management: Maintain menu directories, menus, and buttons, which serve as the basic units for permission control.

• Role management: Bind menus to roles to restrict the features available to users with those roles when logging into the system. Roles can also be assigned data authorization scopes.

• Dictionary management: Maintain various enumeration types within the system.

• Access logs: View and manage user login and logout records.

• Operation logs: View and manage logs of user business operations.

• Service monitoring: View server operating status and information such as CPU, memory, and network usage.

• Online users: View users currently online in the system.

• Announcement management: Manage system announcements.

• File management: Upload, download, and view files. Supports local storage, Alibaba Cloud OSS, and Tencent Cloud COS, with extensibility for additional storage providers.

• Scheduled tasks: Manage scheduled tasks and control their execution frequency using cron expressions.

• System configuration: Maintain system runtime parameters. Parameter configurations are closely related to the system's operating mechanisms.

• Email sending: Provides email delivery functionality.

• SMS sending: Provides SMS delivery functionality. Supports Alibaba Cloud SMS, Tencent Cloud SMS, and extensibility for additional providers.

5. Tech Stack

Database Initialization

• The framework includes an original SQLite database. The Magic.db and Flow.db files are located in Magic.Web.Entry.

• To initialize your own database, follow these steps:

• Modify dbsettings.json in Magic.Web.Core. Note: The connection string for DefaultDbString must be different from those in DbConfigs.

• Simply run the Magic.CodeFirst project to complete database initialization.

If integrating other ORMs, refer to their respective usage instructions. The default SqlSugar configuration does not handle entities from other ORMs, so you must handle them yourself.

Quick Startup

Required installations: Node.js (version 14.17.4 recommended) and Visual Studio (latest version).

• Start the backend: Open the backend/Magic.sln solution and run it directly (F5) to start the application (SQLite is the default database).

• Start the frontend: Open the frontend folder, install dependencies by running npm install or yarn. Running yarn install is recommended. Then execute npm run serve or yarn run serve.

• Access the application in your browser: [http://localhost:82](http://localhost:82) (the default frontend port is 82, and the backend port is 5566).

Database Switching

• Currently supports only SQLite, SQL Server, and MySQL. Database files are located in the DB folder.

• Open Startup in the Magic.Web.Core project and modify DbType.

• Switch the dbsettings.json configuration for "DefaultConnection": ``

 Additional Notes

• Developed by combining the Furion framework for .NET 6 and .NET 7 with the Xiaonuo Vue version!

• Continuously drawing on the strengths of various projects to improve and enrich the framework's infrastructure, providing another option for the .NET ecosystem!

• Related application scenario examples based on this framework will be released in the future for everyone to use!

Special thanks

• Furion

• Admin.NET

• SimpleAdmin

• xiaonuo

• k-form-design

• MiniExcel

• SqlSugar