ZR.Admin.NET Documentation

The project includes a built-in SaaS Multi-tenancy solution using a DB-per-tenant (independent database) architecture. It leverages SqlSugar's SugarScope multi-configuration capability to perform dynamic database routing.

Key Concepts:

• Data Isolation: Each tenant has its own independent database instance for physical data isolation. Tenant, package, and menu metadata are stored in a central Main Database.
• Activation: Multi-tenancy can be toggled on or off using the TenantSettings:UseTenant configuration key. When disabled, the system behaves as a single-tenant application.
• Authorization Model: A tenant's capabilities are determined by the intersection of their assigned Role Menus and the Package Menus (Role Menus ∩ Package Menus).
• Lifecycle Management: Supports full lifecycle management including provisioning (creating records, tables, seed data, and default packages), suspension, renewal, and cancellation.
• User Quotas: The system automatically validates user counts against the limits defined by the tenant's current package during user creation or import.

The project is organized into several layers to separate business logic, system services, and data access:

• ZR.Service: Your business service layer library; provides WebApi interface calls.
• ZR.ServiceCore: System service layer library; provides WebApi interface calls.
• ZR.Repository: Repository layer library; used for executing stored procedures and data access.
• ZR.Model: Entity layer library; contains database tables and Data Transfer Objects (DTOs).
• ZR.Admin.WebApi: The Web API entry point; provides services for Vue versions or third-party systems.
• ZR.Tasks: Scheduled task library; implements project-specific scheduled tasks.
• ZR.CodeGenerator: Code generation module; contains templates and methods for generating code.
• ZR.Vue: Front-end UI layer (Vue 2.0 version; Vue 3 is recommended for new projects).
• document: Contains database scripts and documentation.

The backend solution is organized into several specialized layers:

• ZR.Service: Your business service layer; provides API interfaces for your custom business logic.
• ZR.ServiceCore: The system service layer; provides core system API interfaces.
• ZR.Repository: The repository layer; facilitates database operations, including stored procedures.
• ZR.Model: The entity layer; contains business database tables and Data Transfer Objects (DTOs).
• ZR.Admin.WebApi: The Web API entry point; provides services for Vue front-ends or third-party systems.
• ZR.Tasks: The task library; contains implementations for scheduled tasks.
• ZR.CodeGenerator: The code generation module; contains templates and logic for generating code.
• ZR.Mall: The backend for the integrated Mall/Store module.
• ZR.Vue: The Vue 2.0 UI layer (Note: Vue 3 is recommended for new projects).

├─ZR.Service                ->[你的业务服务层类库]：提供自己业务数据Api接口调用；
├─ZR.ServiceCore            ->[系统服务层类库]：提供系统Api接口；
├─ZR.Repository             ->[仓库层类库]：方便提供有执行存储过程的操作；
├─ZR.Model                	->[实体层类库]：自己业务库表、数据传输对象；
├─ZR.Admin.WebApi           ->[webapi接口]：为Vue版或其他三方系统提供接口服务。
├─ZR.Tasks               	->[定时任务类库]：提供项目定时任务实现功能；
├─ZR.CodeGenerator          ->[代码生成功能]：包含代码生成的模板、方法、代码生成的下载。
├─ZR.Mall                   ->[商城后端]：商城相关的后端代码。
├─ZR.Vue               		->[前端UI]：vue2.0版本UI层(已经不再更新推荐使用vue3)。
└─document               	->[文档]：数据库脚本(已弃用)