From 8cfc1be7108133e3b8b01db777cbdd24f60c87c4 Mon Sep 17 00:00:00 2001 From: gitee-bot Date: Sat, 28 Jun 2025 06:11:34 +0000 Subject: [PATCH] Update README.md --- README.md | 519 +++++++++++------------------------------------------- 1 file changed, 104 insertions(+), 415 deletions(-) diff --git a/README.md b/README.md index 834a4bb..2fbbaab 100644 --- a/README.md +++ b/README.md @@ -1,425 +1,114 @@ -# CodeSpirit Low-Code Framework | [简体中文](README.zh-CN.md) - -## Framework Overview - -CodeSpirit is a revolutionary full-stack low-code development framework that achieves **backend-driven full-stack development paradigm** through intelligent code generation engine and deep AI collaboration. Built on .NET 9 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** - -[![Try Now](https://img.shields.io/badge/Try%20Now-Professional%20Edition-brightgreen)](https://codespirit-app.xin-lai.com/) -*Please follow our WeChat Official Account below for the latest demo account and password.* - -***CodeSpirit, bringing elegant simplicity to complex system development!*** - -### 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 - -### Architecture Diagram - -```mermaid -flowchart TD - classDef uiLayer fill:#f9d1d1,stroke:#333,stroke-width:1px - classDef backendLayer fill:#d1f9d1,stroke:#333,stroke-width:1px - classDef cloudLayer fill:#d1d1f9,stroke:#333,stroke-width:1px - - subgraph UI["Intelligent UI Generation Engine"] - direction LR - A1["🧭 Dynamic Navigation"] --> A2["📝 Smart Forms"] - A2 --> A3["📊 Smart Tables"] - A3 --> A4["📦 Batch Processing"] - end - - subgraph Backend["Enterprise Backend Architecture"] - direction LR - B1["🔐 Permission System"] --> B2["💾 ORM Extensions"] - B2 --> B3["🏢 Multi-tenancy"] - B3 --> B4["📋 Audit Service"] - end - - subgraph Cloud["Cloud-Native Foundation"] - direction LR - C1["🚀 .NET Aspire"] --> C2["⚙️ Config Center"] - C2 --> C3["☸️ K8s Support"] - C3 --> C4["📦 Distributed Cache"] - end - - UI --> Backend - Backend --> Cloud - - class UI uiLayer - class Backend backendLayer - class Cloud cloudLayer +# CodeSpirit 考试系统 + +## 项目概述 +CodeSpirit Exam API 是一个功能完善的考试管理系统，提供从题库管理、试卷生成、考试设置到成绩统计的完整解决方案。系统支持多种题型、随机试卷生成、练习模式、错题记录等功能，并具备详细的考试监控和数据分析能力。 + +## 核心功能 +- **题库管理**：支持多种题型（单选、多选、判断等），包含题目分类、版本控制和难度评估 +- **试卷生成**：支持固定试卷和随机试卷生成，提供试卷预览和发布功能 +- **考试管理**：灵活的考试设置，包括时间控制、次数限制、防作弊检测等 +- **练习模式**：提供不同练习类型和模式，支持练习记录和统计分析 +- **成绩分析**：实时考试监控、成绩统计、题目正确率分析、错题管理 +- **考生管理**：支持考生分组、批量导入和考试分配 + +## 技术架构 +基于 .NET 9 构建，采用多租户架构设计，使用 Entity Framework Core 进行数据库操作，支持 PostgreSQL/MySQL 等多种数据库。系统包含以下主要模块： +- 数据访问层（ExamDbContext） +- 服务层（ExamSettingService, QuestionService 等） +- 控制器层（ApiControllerBase） +- DTO 模型（ExamPaperDto, ExamRecordDto 等） + +## 主要实体关系 +- **试卷（ExamPaper）** 与 **题目（Question）** 多对多关联 +- **考试设置（ExamSetting）** 关联 **试卷** 并包含多个 **考生组（StudentGroup）** +- **考生（Student）** 可属于多个 **考生组** +- **考试记录（ExamRecord）** 包含多个 **答题记录（ExamAnswerRecord）** +- **错题记录（WrongQuestion）** 关联考生和题目 + +## 使用指南 +### 本地开发环境搭建 +1. 安装 .NET 9 SDK +2. 安装支持的数据库（如 PostgreSQL/MySQL） +3. 配置数据库连接字符串（在 `appsettings.json` 中） +4. 执行数据库迁移： +```bash +dotnet ef database update ``` - -### UDL Integration Architecture - -UDL serves as the core UI description language of the CodeSpirit framework, providing unified interface description and rendering capabilities: - -```mermaid -graph TB - subgraph "CodeSpirit Framework Architecture" - subgraph "Frontend Layer" - WebApp["Web Application"] - MobileApp["Mobile Application"] - LargeScreen["Large Screen Display"] - end - - subgraph "UDL Engine Layer" - UDLSpec["UDL Specification
规范定义"] - UDLParser["UDL Parser
解析器"] - MetadataExtractor["Metadata Extractor
元数据提取器"] - CardEngine["Card Engine
卡片引擎"] - end - - subgraph "Rendering Layer" - AmisRenderer["AMIS Renderer
Web渲染器"] - MauiRenderer["MAUI Renderer
桌面/移动渲染器"] - CustomRenderer["Custom Renderer
自定义渲染器"] - end - - subgraph "Template Library" - StudentCard["Student Profile Card
考生信息卡片"] - StatCard["Statistics Card
统计卡片"] - ActionCard["Action Card
操作卡片"] - AnswerCard["Answer Card
答题卡"] - end - - subgraph "Backend Services" - ExamAPI["Exam API
考试服务"] - UserAPI["User API
用户服务"] - MonitorAPI["Monitor API
监控服务"] - end - end - - %% UDL Engine Flow - UDLParser --> MetadataExtractor - MetadataExtractor --> CardEngine - UDLSpec --> UDLParser - - %% UDL to Renderers - CardEngine --> AmisRenderer - CardEngine --> MauiRenderer - CardEngine --> CustomRenderer - - %% Template Library - CardEngine --> StudentCard - CardEngine --> StatCard - CardEngine --> ActionCard - CardEngine --> AnswerCard - - %% Renderers to Frontend - AmisRenderer --> WebApp - MauiRenderer --> MobileApp - CustomRenderer --> LargeScreen - - %% Backend Integration - MetadataExtractor --> ExamAPI - MetadataExtractor --> UserAPI - MetadataExtractor --> MonitorAPI - - style UDLSpec fill:#ffeb3b - style UDLParser fill:#ffeb3b - style MetadataExtractor fill:#ffeb3b - style CardEngine fill:#ffeb3b - style StudentCard fill:#4caf50 - style StatCard fill:#4caf50 - style ActionCard fill:#4caf50 - style AnswerCard fill:#4caf50 +5. 运行项目： +```bash +dotnet run ``` -### Core Technology Stack - -| Category | Technology Selection | -| :--- | :--- | -| **Framework** | .NET 9 | -| **Language** | C# 12 (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 (Service discovery, health checks) | -| **Container Orchestration** | Kubernetes (Supporting auto-scaling) | -| **Identity Authentication** | JWT + OAuth2.0 (RBAC/ABAC hybrid model) | -| **Data Access** | Repository Pattern + CQRS (partial modules) | - -## Functional Architecture Overview - -### I. 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-format data validation, visual data correction | -| Extended Operation System | Custom operation buttons, multi-step approval flows, permission-based context-sensitive operations | - -*Note: Zero-code here refers to zero frontend code.* - -#### 3. Intelligent Chart Analysis Module - -- Dynamic Chart Engine: Automatically matches optimal visualization solutions based on data characteristics -- SQL2API: Generate API interfaces from SQL -- SQL2Chart: Generate charts based on SQL -- Intelligent Time Dimension: Support automatic year-over-year/month-over-month calculations, intelligent time granularity adaptation -- Multi-data Source Aggregation: SQL/NoSQL hybrid data source joint analysis - -#### 4. Zero-Code H5 Generation (*VNext*) - -- Smart Forms -- Smart Charts - -#### 5. UDL (UI Description Language) Engine 🆕 - -UDL (UI Description Language) is a unified UI description language in the CodeSpirit framework, achieving "define once, use everywhere" cross-platform UI consistency development. - -**Core Features**: -- **Unified Description Specification**: Standardized UI description format supporting Web, mobile, large screen and other multi-modal outputs -- **Intelligent Metadata Generation**: Automatically generate UI configuration based on API Controllers with zero frontend coding -- **UDL Cards Components**: Predefined card template library for rapid construction of information display, statistical analysis, and interactive interfaces -- **Multi-platform Rendering**: Unified configuration, automatically adapting to different rendering engines like AMIS, MAUI - -**UDL Cards Predefined Templates**: -- Student Profile Card (student-profile-card): Display basic information with avatar and field icons support -- Statistics Card (stat-card): Data statistics display with progress bars, percentages, and status indicators -- Action Card (action-card): Interactive operation panels with multi-level operations and permission control -- Answer Card (answer-card): Exam scenario specific, answer status visualization - -**Technical Architecture**: -```mermaid -graph TB - subgraph "UDL Architecture Layers" - UDLSpec["UDL Specification"] --> UDLParser["UDL Parser"] - UDLParser --> RenderEngine["Render Engine"] - RenderEngine --> AmisRenderer["AMIS Renderer"] - RenderEngine --> MauiRenderer["MAUI Renderer"] - ApiMetadata["API Metadata"] --> UDLParser - CardTemplates["Cards Template Library"] --> RenderEngine - end +### API 使用示例 +#### 创建试卷 +```http +POST /api/exam/examPapers +{ + "name": "数学测试卷", + "description": "基础数学知识测试", + "type": 0, + "totalScore": 100, + "passScore": 60, + "duration": 120, + "questionIds": ["1", "2", "3"] +} ``` -**Application Scenarios**: -- Exam Monitoring Dashboard: Real-time statistics, status monitoring, anomaly alerts -- Exam Client: Student information display, answer progress tracking -- Management Backend: Data panels, operation interface auto-generation - -### II. Enterprise-Grade Backend Architecture - -#### 1. Core Framework Features - -- **Cloud-Native Foundation**: Native k8s support, deep integration with .NET Aspire, native support for Dapr distributed architecture -- **Security System**: Four-layer defense system (Authentication/Authorization/Audit/Encryption) -- **High-Performance Guarantee**: Distributed caching, automatic second-level caching, intelligent query optimization - -#### 2. Key Functional Components - -- **Permission System**: RBAC+ABAC hybrid model, fine-grained permission control -- **ORM Extensions**: Soft delete, audit tracking, multi-tenancy support -- **Multi-tenancy**: Data isolation, configuration isolation -- **Data Filters**: Global filters, automatic injection -- **Audit Service**: Full-chain operation tracking, data change recording -- **Health Checks**: Service status monitoring, automatic failover -- **Event Bus**: Distributed event processing, message queue integration -- **Distributed Lock**: Redis distributed lock, duplicate submission prevention -- **Configuration Center**: Multi-environment configuration management, dynamic configuration updates -- **Aggregator**: Data aggregation, dynamic field replacement -- **PDF Generation**: Template-based PDF document generation -- **Time Processing**: Unified time processing mechanism, timezone support - -### III. Out-of-the-Box Functional Modules - -| Module Name | Core Features | Technical Characteristics | -| :--- | :--- | :--- | -| User Center | Multi-factor authentication, Organization management(*VNext*), Fine-grained permission control | RBAC+ABAC hybrid model | -| Audit Center | Operation log tracing, Data change tracking, Security compliance reporting | Elasticsearch storage | -| Configuration Center | Multi-environment configuration management, Version control, Dynamic updates | Built-in implementation | -| Order Center | Order management, Status flow, Payment integration | Event-driven architecture | - -### IV. Full-Stack Generation Engine - -- **Code Feedback**: Automatically generate backend repository and controller code based on frontend operations - -- **AI-Assisted Design**: - - - Natural language requirement description → Automatic page prototype generation - - Screenshot page → Automatic DTO structure inference - - Voice commands → Real-time modification of table and form configurations - - Imagine this scenario: - - ***"Spirit, add a birthday field to the user table, use a calendar component, and display it as age in the list page"*** - - AI assistant completes instantly: - - ✅ Modify DTO model - - ✅ Regenerate frontend - - ✅ Write database migration script - -Concept Diagram: - -```mermaid -sequenceDiagram - Developer->>+AI Engine: Input natural language requirements - AI Engine->>+Code Analyzer: Parse semantic intent - Code Analyzer->>+Architecture Validator: Check compatibility - Architecture Validator-->>-AI Engine: Return constraints - AI Engine->>+Code Generator: Generate candidate solutions - Code Generator-->>-Developer: Return executable code +#### 创建考试设置 +```http +POST /api/exam/examSettings +{ + "name": "数学期末考试", + "description": "2025年春季学期数学期末考试", + "examPaperId": 1, + "startTime": "2025-06-15T09:00:00Z", + "endTime": "2025-06-15T11:00:00Z", + "duration": 120, + "allowedAttempts": 1, + "studentGroupIds": [1, 2] +} ``` -## Roadmap - -### Q2 2025 - -- Intelligent UI Generation Engine -- UDL Cards Basic Implementation -- CodeSpirit Beta Release -- H5 Generation Engine - -### Q3 2025 - -- UDL Metadata Auto-Generation -- UDL Multi-Platform Rendering Support -- Visual Analysis Module -- Deep Integration of LLM Code Generation Capabilities - -### Q4 2025 - -- UDL Ecosystem Completion (Visual Editor, Template Marketplace) -- Full-Stack Generation Engine -- Multi-Cloud Deployment Support -- Java Support - -## Framework Advantages Comparison - -### Low-Code Framework Comparison - -| Dimension | CodeSpirit | Traditional Low-Code Platforms | -| :--- | :--- | :--- | -| Architecture Openness | Fully Open Code | Black Box Generation | -| Performance | Native Code-Level Performance | Interpretation Execution Performance Loss | -| Customization Capability | Customizable Base Architecture | Limited Extensions | -| Technology Stack | Latest .NET Ecosystem | Proprietary Tech Stack | -| Deployment Mode | Hybrid Cloud/On-Premises | SaaS Bound | - -### Typical Development Scenario Comparison - -| Traditional Mode | CodeSpirit Mode | Efficiency Improvement | -| :--- | :--- | :--- | -| Frontend-Backend Integration 3 hours | Auto-generation Complete | 8x | -| Form Validation Development 0.5 day | Declarative Configuration 5 minutes | 12x | -| Permission System Integration 2 days | Out-of-box + Policy Extension | ∞ | - -## Try Now - -https://codespirit-app.xin-lai.com/ - -Please follow "麦扣聊技术" WeChat Official Account for the latest demo account and password. - -## Quick Start - -1. Install and start Docker Desktop - -2. Set CodeSpirit.AppHost as the startup project - -3. Start (Docker images like redis, seq, rabbitmq will be pulled during startup. If unable to pull, please use acceleration methods) - - **Note: Currently based on .NET Aspire to simplify orchestration, service discovery, environment variables, and container settings configuration for distributed application development, making it easier to manage during the development phase.** - -## Development Documentation - -- Github: [xin-lai/CodeSpirit](https://github.com/xin-lai/CodeSpirit) **(Regular updates)** -- Gitee: [magicodes/CodeSpirit](https://gitee.com/magicodes/code-spirit) **(Priority updates)** - -### 📘 Core Documentation - -1. [📖 Development Guide (Draft)](#) - Complete development guide and best practices (*File not found*) -2. [🏗️ Overall Technical System Description](./Docs/01-Core-Docs/总体技术体系说明.md) - Technical architecture and design philosophy -3. [🏛️ Backend Architecture](./Docs/01-Core-Docs/后端架构.md) - Backend architecture design description -4. [🏗️ Project Architecture Design](./Docs/01-Core-Docs/项目整体架构设计.md) - Overall project architecture design and principles -5. [🔧 Development Environment Setup Guide](./Docs/01-Core-Docs/开发环境搭建指南.md) - Complete development environment configuration guide -6. [💎 CodeSpirit.Core Framework](./Docs/01-Core-Docs/CodeSpirit.Core核心框架.md) - Core framework components and architecture -7. [⚠️ Unified Exception Handling Guide](./Docs/01-Core-Docs/CodeSpirit统一异常处理指南.md) - Enterprise-level exception handling mechanisms and AMIS API compatibility - -### 🎨 UI Generation Engine - -8. [🎯 AMIS UI Generation Engine](./Docs/02-UI-Generation/CodeSpirit.Amis智能界面生成引擎.md) - Intelligent UI generation core component -9. [📊 AMIS Column Auto-Inference](./Docs/02-UI-Generation/AMIS列自动推断功能说明.md) - Intelligent table column generation detailed explanation -10. [📝 Form Default Values](./Docs/02-UI-Generation/CodeSpirit.Amis表单默认值使用指南.md) - Form default value configuration guide -11. [📈 Smart Chart Component](./Docs/02-UI-Generation/CodeSpirit.Charts智能图表使用指南.md) - Data visualization solution -12. [⏰ Date Time Column Optimization](./Docs/02-UI-Generation/日期时间列优化功能总结.md) - Intelligent time field processing -13. [🃏 UDL Cards Usage Guide](./Docs/02-UI-Generation/CodeSpirit.UDL-Cards卡片使用指南.md) - Unified card system usage guide and best practices -14. [🎨 UDL UI Description Language Design](./Docs/02-UI-Generation/UDL-UI描述语言设计方案.md) - Unified UI description language architecture design -15. [🎯 UDL Cards Detailed Implementation](./Docs/02-UI-Generation/UDL-Cards详细实现方案.md) - Card component library implementation guide -16. [🎮 UDL Cards Simple Implementation](./Docs/02-UI-Generation/UDL-Cards简易实现方案.md) - Quick implementation guide for UDL Cards - -### 🔧 Core Components - -16. [🧭 Navigation Component](./Docs/03-Core-Components/CodeSpirit.Navigation导航组件使用指南.md) - Smart navigation system with multi-platform, permission filtering and context awareness -17. [🔗 Aggregator Usage Guide](./Docs/03-Core-Components/CodeSpirit.Aggregator聚合器使用指南.md) - Data aggregation and field replacement -18. [⚙️ Settings Management Component](./Docs/03-Core-Components/CodeSpirit.Settings设置管理组件使用指南.md) - Configuration management solution -19. [🔒 Distributed Lock Usage Guide](./Docs/03-Core-Components/CodeSpirit分布式锁使用指南.md) - Distributed lock implementation and usage -20. [📄 PDF Generation Component](./Docs/03-Core-Components/CodeSpirit.PdfGeneration使用指南.md) - PDF document generation service -21. [🕒 Time Processing Mechanism](./Docs/03-Core-Components/CodeSpirit时间处理机制.md) - Unified time processing solution -22. [🌐 Client IP Service](./Docs/03-Core-Components/ClientIpService使用指南.md) - Client IP acquisition and processing -23. [📋 Audit Component Integration Guide](./Docs/03-Core-Components/CodeSpirit.Audit审计组件集成使用指南.md) - Complete audit system integration and usage - -### 📝 Exam System - -24. [📚 Exam System Overview](./Docs/09-Exam-System/README.md) - Complete exam system documentation navigation and quick reference -25. [🏗️ Exam System Technical Architecture](./Docs/09-Exam-System/考试系统完整说明文档.md) - Comprehensive technical architecture, API design and security mechanisms -26. [📋 Exam System Business Functions](./Docs/09-Exam-System/考试系统业务功能清单.md) - Complete business function list with 200+ features across 12 modules - -### 🔐 Identity & Authorization - -27. [🔑 IdentityApi Identity Service](./Docs/04-Identity-Auth/CodeSpirit.IdentityApi身份认证服务.md) - Complete identity authentication service architecture -28. [👮 Authorization Component](./Docs/04-Identity-Auth/CodeSpirit.Authorization权限组件详解.md) - Comprehensive permission system with RBAC+ABAC hybrid model -29. [🎫 TokenManager Frontend Authentication Manager](./Docs/04-Identity-Auth/CodeSpirit.TokenManager前端认证管理器使用指南.md) - Frontend authentication management and token handling - -### 🏢 Multi-Tenancy Architecture - -30. [🏗️ Multi-Tenant Component Refactoring Plan](./Docs/05-Multi-Tenancy/CodeSpirit多租户组件整改计划.md) - Multi-tenancy architecture improvement and implementation plan -31. [🎯 TenantResolver Usage Guide](./Docs/05-Multi-Tenancy/CodeSpirit.TenantResolver租户解析器使用指南.md) - Tenant resolution and context management -32. [🔍 DataFilter Usage Guide](./Docs/05-Multi-Tenancy/CodeSpirit.DataFilter数据筛选器使用指南.md) - Data filtering and tenant isolation mechanisms -33. [🗄️ Multi-Tenant Database Context Architecture](./Docs/05-Multi-Tenancy/CodeSpirit 多租户数据库上下文架构.md) - Database architecture design for multi-tenancy -34. [✅ ExamApi Multi-Tenant Integration Report](./Docs/05-Multi-Tenancy/ExamApi多租户集成完成报告.md) - Multi-tenant integration completion report for exam system -35. [🖥️ Multi-Tenant Login Page Usage Guide](./Docs/05-Multi-Tenancy/多租户登录页面使用指南.md) - Multi-tenant login interface implementation - -### 🚀 Infrastructure & DevOps - -36. [🐰 RabbitMQ Integration Guide](./Docs/06-Infrastructure/RabbitMQ-Aspire-Integration.md) - Message queue integration solution -37. [🔧 RabbitMQ Troubleshooting](./Docs/06-Infrastructure/RabbitMQ故障排除指南.md) - Common problem solutions -38. [🔍 Elasticsearch Migration Summary](./Docs/06-Infrastructure/Elasticsearch-Aspire-Migration-Summary.md) - Search engine integration guide -39. [🌐 CORS Policy Configuration Guide](./Docs/06-Infrastructure/CodeSpirit跨域策略配置指南.md) - CORS cross-origin resource sharing configuration and security policies - -### 🌐 API & Communication - -40. [🔗 Universal API Jump Mechanism Usage Guide](./Docs/07-API-Communication/CodeSpirit通用API跳转机制使用指南.md) - Universal API routing and communication mechanisms - -### 📊 Project Management - -41. [📋 Technical Debt Management](./Docs/08-Project-Management/技术债管理文档.md) - Technical debt tracking and management standards - -### 💬 Technical Community +#### 获取考试记录 +```http +GET /api/exam/examRecords?Page=1&PerPage=10 +``` -[💬 Join Technical Community (Not yet open, please follow WeChat Official Account)](https://codespirit-chat.xin-lai.com/) +## 数据模型说明 +### 核心实体 +- **Question**：题目实体，包含内容、类型、选项、正确答案等信息 +- **ExamPaper**：试卷实体，定义试卷结构和题目列表 +- **ExamSetting**：考试设置，关联试卷和考生组 +- **ExamRecord**：考试记录，跟踪每次考试的详细信息 +- **Student**：考生信息，支持多租户隔离 + +### 主要枚举类型 +- **ExamPaperStatus**：试卷状态（草稿、已发布等） +- **ExamRecordStatus**：考试记录状态（进行中、已完成等） +- **QuestionType**：题目类型（单选、多选、判断等） +- **PracticeMode**：练习模式（限时练习、自由练习等） + +## 特色功能 +- **考试监控大屏**：实时显示考试情况，包括在线人数、提交状态、作弊嫌疑检测 +- **AI 题目生成**：集成 AI 功能，支持智能题目生成 +- **答卷导出**：支持 PDF 格式导出答卷，可配置水印、页眉页脚等 +- **数据分析**：提供成绩统计、题目正确率分析等图表展示 + +## 部署说明 +使用 Docker 部署： +```dockerfile +FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build +COPY . . +RUN dotnet publish -c Release -o /app/publish + +FROM mcr.microsoft.com/dotnet/runtime:9.0 +COPY --from=build /app/publish . +ENTRYPOINT ["dotnet", "CodeSpirit.ExamApi.dll"] +``` -![WeChat Official Account](./Res/qrcode.jpg) +## 文档资源 +- [考试系统实体设计文档](Data/README.md) +- [考试系统文档目录](Docs/09-Exam-System/README.md) +## 许可证 +本项目采用 MIT 许可证，请查看 [LICENSE](LICENSE) 文件获取详细信息。 \ No newline at end of file -- Gitee