# CoreExam

**Repository Path**: qc-cool/core-exam

## Basic Information

- **Project Name**: CoreExam
- **Description**: CoreExam 是基于 .NET 10、SqlSugar、Vue 3、Element Plus 和 SignalR 开发的企业级在线考试系统，支持题库管理、智能组卷、在线考试、实时监考、阅卷评分、成绩发布、多数据库及国产信创数据库适配。
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 在线考试, 考试系统

## README

# CoreExam 企业考试系统

基于 .NET 10、SqlSugar、Vue 3、Element Plus、Tiptap 和 SignalR 的企业内部考试系统。

当前版本为 Beta，适合功能体验和小范围内部试用。用于重要考试前，请先完成数据备份、并发验证和完整业务验收。

前端使用 pnpm workspace 管理依赖，需要 pnpm 11 或更高版本。

## 项目结构

- `src/CoreExam.Host`：唯一启动与发布项目。
- `src/CoreExam.Admin`：管理后台 Minimal API 与监考 Hub。
- `src/CoreExam.Candidate`：考生 Minimal API、答题服务与考试 Hub。
- `src/CoreExam.Core`：共享数据库实体、权限和基础抽象。
- `src/CoreExam.Infrastructure`：SqlSugar、配置加密和对象存储实现。
- `web`：后台管理与考生端共用的 Vue 应用，通过 `/admin` 和 `/exam` 路由分区。

## 本地开发

双击 `start.bat`，或执行：

```powershell
.\start.bat
```

默认地址：

- API：`http://localhost:5000`
- 管理后台：`http://localhost:5173/admin/`
- 考生端：`http://localhost:5173/exam/`

首次启动会创建 SQLite 数据库和初始管理员：`admin / Admin@123456`。首次登录后必须修改密码；生产环境必须通过外部配置更换 JWT Key 和系统主密钥。

## 发布

执行 `build.bat` 后选择：

1. Windows x64
2. Linux x64
3. Windows x64 与 Linux x64

发布结果位于 `artifacts`，后端为自包含单文件，统一 Vue 应用打包在发布目录的 `wwwroot`。

## 操作系统兼容性

CoreExam 支持 [.NET 10 官方支持](https://github.com/dotnet/core/blob/main/release-notes/10.0/supported-os.md)的 Windows、Windows Server、Linux 和 macOS。当前一键打包提供 `win-x64` 和 `linux-x64` 自包含版本。

## 数据库兼容性

CoreExam 的数据库兼容范围以 [SqlSugar 官方支持列表](https://www.donet5.com/Home/Doc?typeId=1180) 为准，支持 SQLite、SQL Server、MySQL、MariaDB、PostgreSQL、Oracle、DB2、OceanBase、TiDB、ClickHouse 等数据库。

国产信创数据库支持达梦、人大金仓、神通、瀚高、GaussDB、南大通用 GBase、Vastbase、虚谷等。它们具有自主可控、本地化服务和信创生态适配等特点，部分产品提供 Oracle、PostgreSQL 或 MySQL 兼容模式。

## 开源许可证

Copyright (C) 2026 CoreExam contributors

本项目采用 [GNU Affero General Public License v3.0 only](LICENSE)，SPDX 标识为 `AGPL-3.0-only`。

你可以使用、修改和分发本项目，也可以收费提供部署或支持服务。分发程序或将修改后的版本作为网络服务提供给用户时，必须按照 AGPL-3.0-only 提供对应源码并保留版权、许可证和修改声明。完整权利与义务以根目录 `LICENSE` 的英文协议正文为准。

本软件按现状提供，不附带任何明示或默示担保。正式环境部署者应自行承担数据备份、安全配置、可用性验证和合规责任。