CodeSpirit AI Framework | 简体中文

Framework Overview

CodeSpirit is a revolutionary full-stack low-code + AI development framework that achieves backend-driven full-stack development paradigm through intelligent code generation engine and deep AI collaboration. Built on .NET 10 and Aspire 13.0 technology stack, it provides enterprise-level technical depth and cloud-native scalability, supporting the entire lifecycle from UI generation and business logic orchestration to system operations.

Return Full-Stack Development to Engineering Essence

• Backend-Driven Development Paradigm · Enterprise-Grade Open Architecture · AI-Enhanced Engineering Loop

CodeSpirit, bringing elegant simplicity to complex system development!

🌟 Core Innovation Highlights

Revolutionary AI Integration 🤖

• Zero-Configuration AI Endpoint Generation: Industry-first! Just one attribute tag automatically generates AI-fill API endpoints without writing any controller code
• Smart Form Filling: Automatically analyzes DTO structure to generate prompts, automatically parses AI responses and fills forms, boosting development efficiency by 10x+
• AI Long-Running Task Handling: Complete AI task management and progress tracking with multi-step interface display and real-time polling
• Unified LLM Interface: Seamlessly switch between multiple large language models including OpenAI, Alibaba Qwen, DeepSeek

Ultimate Development Experience 🚀

• Unified Startup Framework: Program.cs requires only 2 lines of code to complete API project configuration with extreme standardization
• Automatic Dependency Injection: Zero-configuration batch service registration based on Scrutor, automatically identifying lifecycle through interface tags
• Multi-Database Support: Flexible switching between MySQL and SQL Server with independent migration management and completely decoupled business code
• Smart Chart Recommendations: Automatically recommends optimal visualization solutions based on data characteristics with zero frontend code chart generation

Enterprise-Grade Architecture 🏢

• Event-Driven Architecture: RabbitMQ-based distributed event system with tenant-awareness and cross-service communication
• RBAC+ABAC Hybrid Permissions: Fine-grained permission control with permission inheritance and data scope restrictions
• Comprehensive Multi-Tenancy: Data isolation, configuration isolation, and tenant-aware event system
• Distributed Component Library: Out-of-the-box distributed locks, file storage, image processing, PDF generation

Core Value Propositions

• Full-Stack Intelligent Generation: Eliminate 80% repetitive coding through backend model-driven frontend UI generation
• Deeply Controllable Architecture: Generated code is fully open and controllable, supporting smooth evolution from rapid prototyping to complex systems
• Enterprise-Grade Engineering Capabilities: Built-in permission system, audit tracking, distributed architecture support, out-of-the-box
• AI-Collaborative Programming: Requirement Description → Prototype Generation → Code Verification → Deployment Monitoring
• Cloud-Native Foundation: Native Kubernetes support, one-click deployment to multi-cloud environments

Technical Architecture Overview

Core Technology Stack

| Category | Technology Selection | | :--- | :--- | | Framework | .NET 10 | | Language | C# 13 (Supporting Primary Constructor and other new features) | | Backend Architecture | Clean Architecture + DDD | | ORM | Entity Framework Core (with soft delete, audit tracking) | | Frontend Generation | AMIS (Dynamic form/table generation) | | UI Description Language | UDL (Unified UI Description Language + Cards Library) | | Microservices | .NET Aspire 13.0 (Service discovery, health checks) | | Database | MySQL 8.0 / SQL Server 2022 (Multi-database support) | | Time-Series DB | GreptimeDB (For audit logging) | | Container Orchestration | Kubernetes (Supporting auto-scaling) | | Identity Authentication | JWT + OAuth2.0 (RBAC/ABAC hybrid model) | | Data Access | Repository Pattern + CQRS (partial modules) |

Project Structure

Core Architecture

Src/
├── ApiServices/                          # API Service Layer
│   ├── CodeSpirit.AiCardsApi/           # AI Cards API Service
│   ├── CodeSpirit.ApprovalApi/          # Approval Workflow API Service
│   ├── CodeSpirit.ConfigCenter/         # Configuration Center API
│   ├── CodeSpirit.ExamApi/              # Exam System API
│   ├── CodeSpirit.FileStorageApi/       # File Storage API
│   ├── CodeSpirit.IdentityApi/          # Identity Authentication API
│   ├── CodeSpirit.MessagingApi/         # Messaging Service API
│   ├── CodeSpirit.PathfinderApi/        # Pathfinder AI Goal Management API
│   └── CodeSpirit.SurveyApi/            # Survey System API
├── Components/                           # Independent Component Library
│   ├── CodeSpirit.Aggregator/           # Data Aggregator Component
│   ├── CodeSpirit.AiFormFill/           # AI Form Fill Component
│   ├── CodeSpirit.Amis/                 # AMIS UI Generation Engine
│   ├── CodeSpirit.Audit/                # Audit Tracking Component
│   ├── CodeSpirit.Authorization/        # Authorization Management Component
│   ├── CodeSpirit.Caching/              # Distributed Caching Component
│   ├── CodeSpirit.Charts/               # Smart Chart Component
│   ├── CodeSpirit.ConfigCenter.Client/ # Configuration Center Client
│   ├── CodeSpirit.LLM/                  # Large Language Model Integration
│   ├── CodeSpirit.Messaging/            # Message Queue Component
│   ├── CodeSpirit.MultiTenant/          # Multi-Tenancy Component
│   ├── CodeSpirit.Navigation/           # Navigation Component
│   ├── CodeSpirit.PdfGeneration/        # PDF Generation Component
│   ├── CodeSpirit.ScheduledTasks/       # Scheduled Tasks Component
│   ├── CodeSpirit.Settings/             # Settings Management Component
│   ├── CodeSpirit.Shared/               # Component Shared Library
│   └── CodeSpirit.UdlCards/             # UDL Cards Component
├── CodeSpirit.AppHost/                   # Aspire Application Host (Startup Project)
├── CodeSpirit.Core/                      # Core Framework Definitions
├── CodeSpirit.ServiceDefaults/           # Service Default Configuration
├── CodeSpirit.Shared/                    # Global Shared Library
├── CodeSpirit.Web/                       # Web Frontend Project
└── Tests/                                # Test Project Collection
    ├── ApiServices/                      # API Service Tests
    │   ├── CodeSpirit.IdentityApi.Tests/
    │   └── CodeSpirit.ExamApi.Tests/
    ├── Components/                       # Component Tests
    │   ├── CodeSpirit.Aggregator.Tests/
    │   ├── CodeSpirit.Authorization.Tests/
    │   ├── CodeSpirit.Caching.Tests/
    │   ├── CodeSpirit.Charts.Tests/
    │   └── ... (Other Component Tests)
    ├── Shared/                           # Shared Test Infrastructure
    │   ├── CodeSpirit.Shared.Tests/
    │   └── CodeSpirit.Components.TestsBase/
    ├── Infrastructure/                   # Infrastructure Tests
    │   └── CodeSpirit.PdfGeneration.Tests/
    └── LoadTests/                        # Performance Load Tests
        └── CodeSpirit.ExamApi.LoadTests/

Functional Architecture Overview

I. AI-Enhanced Features 🤖

CodeSpirit provides a complete AI integration solution covering the full chain from basic LLM calls to intelligent business applications.

Core Components:

• CodeSpirit.LLM: Unified LLM interface supporting OpenAI, Alibaba Qwen, DeepSeek and other models, providing advanced features like structured task processing, batch processing, and intelligent JSON repair
• AI Form Intelligent Fill ⭐: Industry-first! Just one attribute tag [AiFormFill] automatically generates AI fill endpoints without writing controller code, boosting development efficiency by 10x+
• AI Import Wizard: Intelligent text parsing, batch AI review, visual preview, supporting automatic recognition and correction of multiple question formats
• LLM Audit Tracking: Complete AI decision traceability, recording prompts, responses, costs, performance metrics, supporting dual storage with Elasticsearch and GreptimeDB
• AI Smart Tool System: Four-stage progressive tool selection (keywords → vector search → LLM classification → LLM selection), intelligent tool recommendation and configuration generation
• AI Partner System: Server-side intelligent dialogue platform supporting Function Calling, providing scenario-based AI assistants (exam analyst, question creator, etc.)
• AI Long-Running Task Handling: Complete task management and progress tracking, supporting multi-step interface display and real-time polling

Performance Optimization Strategies:

• 🚀 Multi-level caching strategy (L1 memory + L2 Redis), intelligent degradation mechanism
• 📦 Request merging and batch processing, reducing API call costs
• 🌊 Streaming response optimization, improving user experience
• ⚡ Intelligent batching and concurrency control, supporting large-scale data processing

See CodeSpirit AI Feature Deep Dive for details

II. Intelligent UI Generation Engine

1. Dynamic Navigation System

• Intelligent Permission Adaptation: Automatic synchronization with RBAC permission model for dynamic menu rendering
• Multi-level Navigation Support: Global navigation(vNext)/local navigation hybrid architecture

2. Zero-Code CRUD Generation

| Module | Capabilities | | :--- | :--- | | Smart Forms | 20+ field type automatic mapping, including complex scenarios like image upload and Excel import | | Smart Tables | Nested data presentation, column configuration hot reload, real-time quick editing | | Batch Processing | Excel template import/export, multi-for