Zhontai Admin Documentation

Zhontai Admin is a backend permission management system with frontend and backend separation. Key features include:

• User & Role Management: Advanced querying, department linking, and role-based access control (RBAC).
• Tenant Management: Automatic initialization of departments/roles for new tenants and plan management.
• Permission & Interface Management: Tree-structured management of menus, permission points, and API interfaces.
• Task Scheduling: Execution logs, retries, and email alerts.
• File Management: Support for local storage or OSS uploads.
• Print Templates: Drag-and-drop component designer with JSON data source configuration.
• Logging: Comprehensive login and operation logs with IP tracking.

zhontai.ui.admin.vue3 is a front-end and back-end separated administrative permission management system. It is designed to reduce development workload by providing a framework that supports mobile, tablet, and PC devices, and includes built-in support for one-click microservice interface generation.

Core Technology Stack:

• Vue 3.x with Composition API (setup syntax sugar)
• TypeScript
• Vite
• Element Plus
• Vue Router Next
• Pinia

Zhontai Admin is a decoupled (frontend/backend) permission management system built on .NET 10.0. It utilizes a modern technology stack including FreeSql (ORM), Autofac (DI), Mapster (Mapping), and CAP (Distributed Transactions).

Key features include:

• CodeFirst Support: Automatically synchronizes database schema and permission data from entity configurations upon startup.
• Database Capabilities: Supports major domestic and international databases, read/write splitting, sharding, and distributed transactions (TCC/SAGA).
• Comprehensive Management: Includes modules for User, Role, Department, Permission, Tenant, Dictionary, Task Scheduling, Cache, File Management, and more.

Before running the project, ensure your environment meets the following requirements:

Node.js Version:

• Must be Node 14.18+ or 16+. Vite does not support Node 12, 13, or 15 as they are End-of-Life (EOL).

Browser Support:

• Edge: ≥ 88
• Firefox: ≥ 78
• Chrome: ≥ 87
• Safari: ≥ 13

Note: Because Vue 3 and Element Plus do not support IE11, older versions of Internet Explorer are not supported.

Online Preview:

• URL: https://admin.zhontai.net
• Account: user
• Password: 123asd

Once the template is installed, use the dotnet new command with the MyIMServer identifier to scaffold a new project. Use the -n flag to specify your company or project name.

dotnet new MyIMServer -n MyCompanyName.IMServer

To remove the MyIMServer template from your dotnet environment, use the uninstall command.

dotnet new uninstall ZhonTai.Template.IMServer

Follow these steps to clone, install dependencies, and run the project locally:

1. Clone the repository
2. Navigate to the specific UI directory
3. Install dependencies using pnpm
4. Run the development server
5. Build for production (if needed)

# 克隆项目
git clone https://github.com/zhontai/Admin.Core.git

# 进入项目
cd ui\zhontai.ui.admin.vue3

# 安装依赖
pnpm install

# 运行项目
pnpm run dev

# 打包发布
pnpm run build

You can install the MyIMServer template either from a remote NuGet source or from a local .nupkg file.

To install from NuGet:

dotnet new install ZhonTai.Template.IMServer

To install from a local file:

dotnet new install F:\zhontai\Admin.Core\templates\ZhonTai.Template.IMServer.1.0.0.nupkg

You can install the ZhonTai templates either from the NuGet gallery or from a local .nupkg file.

To install from the NuGet gallery:

dotnet new install ZhonTai.Template

To install from a local package file:

dotnet new install F:\zhontai\Admin.Core\templates\ZhonTai.Template.8.6.0.nupkg

Once the template is installed, use the dotnet new command with the MyFramework identifier to scaffold a new project. Use the -n flag to specify your desired company and project name.

Example:

dotnet new MyFramework -n MyCompanyName.MyProjectName

You can install the MyFramework template either from NuGet.org or from a local .nupkg file using the dotnet new install command.

To install from the official NuGet gallery:

dotnet new install ZhonTai.Template.Framework

To install from a local package file:

dotnet new install E:\zhontai\templates\ZhonTai.Template.Framework.9.0.0.nupkg