SufiChain.SufiPlatform.AspNetCore.Authentication.Abstractions 0.1.0-alpha.1.0

Sufi Platform

Open-source modular platform for multi-tenant Blazor business applications

Sufi Platform is the LGPL foundation for building enterprise products on .NET 10 and ABP Framework without rebuilding identity, tenancy, permissions, settings, auditing, localization, files, AI workspaces, or communications for every solution.

It is not an ABP fork. Backend modularity and infrastructure come from ABP NuGet packages. Sufi Platform adds a focused product layer: ~31 value-add framework packages (SufiChain.SufiPlatform.*), 19 first-party modules, the sufi CLI and templates, plus two independent UI products — SufiBlazor (MIT component library, ~90 Sb* controls) and SufiTheme (LGPL app shell, DualSidebar / SideMenu / TopMenu layouts). Together they replace Blazorise-based ABP UI with a branded Blazor experience for admin and portal surfaces.

Generated hosts start with account and identity, tenant and edition foundations, feature/permission/setting management, OpenIddict, audit logging, background jobs, file management, calendar, tags, menus, short links, database blob storage, SufiAI workspaces (RAG/MCP), and SufiCom messaging contracts. Pro products — SufiCom, HelpDesk, AI Copilots, Calendar Copilot, CRM, CMS, Forms, Branding, Dashboard, and Finance (payments, wallets, invoicing, inventory) — are not open source. They ship as NuGet packages. Obtain a license at sufichain.com to use them; a free tier is available for every licensee.

What is Sufi Platform?

Sufi Platform is an independent platform on top of ABP. It extends ABP with Sufi-branded APIs, a custom UI stack, and original modules:

• Consumes ABP as NuGet for modular DDD, multi-tenancy, permissions, settings, auditing, and persistence (Volo.Abp.* used directly where Sufi adds no behavior)
• Provides ~31 framework packages — UI abstractions, DDD bases, authentication, SufiAI, SufiCom, captcha, AspNetCore/MVC, CLI
• Ships 19 first-party modules — reimplemented ABP-style modules with Sufi UI, plus Calendar, AI, File Manager, Menus, Tags, Short Links, Editions, and more
• Uses SufiBlazor + SufiTheme as the default Blazor component system and application shell (independent products, not Blazorise)
• Offers the sufi CLI for scaffolding solutions from the unified template
• Stays open-source under LGPL-3.0 (SufiBlazor is MIT)

Architecture Stack

flowchart TB
    Host[Host Applications]

    subgraph Pro["Pro products — NuGet, licensed free tier"]
        direction TB
        ProA["SufiCom · HelpDesk · AI Copilots · Calendar Copilot"]
        ProB["CRM · CMS · Forms · Finance · Branding · Dashboard"]
    end

    subgraph OSS["Open-source modules — modules/"]
        direction TB
        OssA["Account · Identity · Tenants · Editions · Users"]
        OssB["Permissions · Features · Settings · OpenIddict"]
        OssC["Audit Logging · Background Jobs · Localization · Menus"]
        OssD["File Manager · Calendar · AI · Tags · Short Links · Blob Database"]
    end

    Theme[SufiTheme]
    Blazor[SufiBlazor]
    Framework[Sufi Platform Framework]
    Abp[ABP Framework]
    DotNet[.NET 10]

    Host --> Pro
    Host --> OSS
    Pro --> OSS
    OSS --> Theme
    Theme --> Blazor
    Blazor --> Framework
    Framework --> Abp
    Abp --> DotNet

Framework Packages

31 SufiChain.SufiPlatform.* packages under framework/ — each adds real value beyond ABP (UI, branding, AI, communications, captcha, CLI). Thin re-export wrappers were removed as part of Framework Reduction.

Infrastructure packages (EF Core, MongoDB, EventBus, Caching, AutoMapper, etc.) are consumed directly as Volo.Abp.* NuGet packages.

Modules

19 first-party modules under modules/, each following ABP's layered structure with Sufi Platform UI and branding.

Reimplemented from ABP

Sufi Platform Originals

All modules support both EF Core and MongoDB, use SufiBlazor components, and follow the SufiComponentBase / SufiControllerBase / Sufi Platform DTO conventions.

Pro Products

Licensed capability packages (not open source), distributed as NuGet. Free tier via a license from sufichain.com.

Core Features

Backend Infrastructure (from ABP)

• Modular Architecture: Build applications from reusable modules with clear boundaries
• Domain-Driven Design: Entities, aggregates, repositories, domain services, specifications
• Multi-Tenancy: Database-per-tenant or shared database with tenant isolation
• Authorization: Permission-based access control with role and user management
• Localization: Multi-language support with JSON resource files
• Auditing: Automatic tracking of entity changes and user actions
• Settings & Features: Hierarchical configuration system (global, tenant, user)
• Background Jobs: Async task processing with retry and scheduling
• Event Bus: Local and distributed event handling
• Caching: Distributed caching with Redis support
• Validation: Fluent validation with automatic DTO validation
• Exception Handling: Centralized error handling with localized messages

Frontend (Sufi Platform Custom)

• SufiBlazor Component Library: Custom Blazor components (DataGrid, Form, Modal, Tabs, etc.)
• SufiTheme: Dual-layout theme system (collapsed/expanded shells) with LTR/RTL support
• Responsive Design: Mobile-first layouts with adaptive navigation
• Theming System: CSS variables for easy customization
• Icon System: Integrated icon library with consistent styling
• Localization: Seamless integration with backend localization

AI Integration

• SufiAI Framework: Workspace-based configuration over Microsoft.Extensions.AI + Semantic Kernel
• Provider Support: OpenAI, Ollama, and custom OpenAI-compatible endpoints
• RAG: Document indexing and semantic search with Qdrant or Pgvector vector stores
• MCP Tools: Model Context Protocol tool registry with Semantic Kernel plugin integration
• Calendar Copilot: 12 MCP tools for scheduling, availability, and free/busy queries

Data Access

• Entity Framework Core: Full EF Core support with migrations and LINQ queries
• MongoDB: Native MongoDB support with repository pattern
• Dual Database Support: All modules support both EF Core and MongoDB
• Repository Pattern: Generic repositories with async operations
• Unit of Work: Automatic transaction management

Technology Stack

Backend

• .NET 10.0 and ASP.NET Core 10.0
• Entity Framework Core 10.0 with migrations and LINQ
• MongoDB Driver with native repository support
• OpenIddict for OAuth 2.0 and OpenID Connect
• Microsoft.Extensions.AI + Semantic Kernel for AI integration
• SignalR for real-time communication
• Mapperly for compile-time object mapping
• Serilog for structured logging

Frontend

• Blazor Server and Blazor WebAssembly support
• SufiBlazor custom component library (Sb* prefix)
• SufiTheme layout and theming system
• CSS Variables for dynamic theming
• LTR/RTL bidirectional layout support

Infrastructure

• Redis for distributed caching and session storage
• RabbitMQ for distributed events
• MinIO / S3 for object storage
• Qdrant / Pgvector for vector search (AI RAG)
• PostgreSQL / SQL Server / MySQL / SQLite relational databases
• MongoDB NoSQL database

Getting Started

Prerequisites

• .NET 10.0 SDK
• Node.js 20+ (for frontend tooling)
• Docker (optional, for Redis, RabbitMQ, databases)
• Visual Studio 2026 / VS Code / Rider

Installation

1. Install the Sufi Platform CLI:

   dotnet tool install -g SufiChain.SufiPlatform.Cli
   

2. Create a new application:

   sufi new MyApp -t app
   

   Architecture variants:

   Variant	CLI flags
   WebApp (all-in-one)	--solution-kind webapp

   Database options: -d ef (default) or -d mongodb

3. Run database migrations:

   cd MyApp/src/MyApp.DbMigrator
   dotnet run
   

4. Run the application:

   cd ../MyApp.Blazor
   dotnet run
   

5. Open in browser:

   Navigate to https://localhost:44300

   Default credentials: admin / 1q2w3E*

Project Structure

sufi-platform/
  framework/        # ~31 SufiChain.SufiPlatform.* packages
  modules/          # 19 first-party modules (short folders)
  templates/        # CLI solution templates
  docs/             # Module and framework documentation

Roadmap

Phase 1 (open-source foundation) is in alpha. Phases 2–3 — Pro Products and Finance are the active development focus.

Full detail: docs/roadmap.md.

License

Open-source base (this repository — framework, first-party modules, CLI, templates) is LGPL-3.0. SufiBlazor is MIT; SufiTheme is LGPL-3.0.

Pro products (SufiCom, HelpDesk, AI Copilots, Calendar Copilot, CRM, CMS, Forms, Branding, Dashboard, Finance, and related packages) are not open source. They are distributed only as NuGet packages. Anyone can obtain a license from sufichain.com and use the free tier of Pro products; paid tiers unlock higher limits and commercial support.

You can use the open-source base in open-source and commercial projects under LGPL terms. Pro usage requires a valid Sufi Platform license.

Community & Support

• Website: https://sufichain.com
• Documentation: https://sufichain.com/kb/sufi-platform-docs
• User Guide: https://sufichain.com/kb/sufi-platform-docs/kb/sufi-platform-user-guide
• GitHub (Sufi Platform): https://github.com/sufi-chain/sufi-platform
• GitHub (SufiBlazor): https://github.com/sufi-chain/sufi-blazor
• GitHub (SufiTheme): https://github.com/sufi-chain/sufi-theme

Commercial Support

• Priority support via email and chat
• Consulting services for architecture and implementation
• Custom module development
• Training and workshops

Contributing

Sufi Platform is an open-source project and welcomes contributions:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Write tests
5. Submit a pull request

Acknowledgments

Sufi Platform is built on top of ABP Framework and would not be possible without the excellent work of the ABP team. We consume ABP as NuGet packages and extend it with our custom UI system, modules, and tooling.

Built with care by the Sufi Chain Team