# exam

**Repository Path**: laozhaoai/exam

## Basic Information

- **Project Name**: exam
- **Description**: 🎓 智慧周考 · AI 在线考试系统。⚡ FastAPI + React + PostgreSQL，支持组卷考试、🤖 AI 批阅与错题辅导、📊 成绩报告分享，🐳 Docker 一键部署。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-07-24
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎓 智慧周考 · 在线考试系统 

面向培训 / 周考场景的 AI 在线考试系统。前后端分离，支持 Docker 一键部署；覆盖讲师出题组卷、学员在线作答、AI 批阅与错题辅导、成绩报告分享等完整闭环。



# 项目介绍

- **技术栈**：FastAPI + React（Vite / Ant Design）+ PostgreSQL
- **角色**：管理员、讲师、学员
- **题型**：单选、多选、判断、编程题（支持 AI 批阅）
- **部署**：Docker Compose（`postgres` + `api` + `web`，对外只暴露 80 端口）

围绕周考闭环：用 RAG 管「教什么、出什么题」，用 Agent 管「考完怎么讲清楚、错了怎么补回来」。



## 演示地址

官方：http://zhaodashen.cn/static/exam/

系统地址：去官方下载客户端

讲师端账密：账号-19999999999   密码-admin888   

学员端账密：账号-18888888888   密码-admin888   



# 快速启动

```bash
docker compose up -d --build
```

浏览器访问：`http://localhost`

首次空库会自动创建管理员账号：

| 用户名 | 密码 |
| ---- | ---- |
| kane | kane888 |

> 已有数据卷 `pgdata` 会直接复用，不会覆盖已有账号密码。



> 使用步骤

- 管理员登录成功后，切记去创建一个讲师
- 然后右上角退出管理员登录，切换讲师账号登录，新建学员、新建题库、新建学员



# AI 能力亮点

| 亮点 | 说明 |
| ---- | ---- |
| 课程知识库 + RAG 出题 | 讲义分块入库，按主题 / 知识点检索后再生成试题，减少胡编与超上下文 |
| 周考报告 Agent | 基于本场成绩与分数段生成可编辑学情分析，支持导出 / 分享 |
| AI 错题辅导智能体 | 考后对错题解释错因，并可延伸巩固练习（考中不做，避免泄题） |

另支持：AI 大模型配置、AI 生成试题入库、编程题 AI 批阅。



# 学员端功能

| 模块 | 介绍 |
| ---- | ---- |
| 登录 | 用户名 / 手机号 + 密码 |
| 我的考试 | 查看待考 / 进行中试卷，开始或继续考试 |
| 在线考试 | 倒计时、切屏提醒、客观题作答、编程题代码编辑器 |
| 我的成绩 | 查看已交卷成绩、耗时、交卷时间 |
| 考试复盘 | 查看对错与解析；可唤起 AI 错题辅导 |
| 个人中心 | 查看 / 修改个人资料 |



# 讲师端功能

| 模块 | 介绍 |
| ---- | ---- |
| 登录 | 用户名 / 手机号 + 密码 |
| 学员管理 | 学员列表、新建学员、Excel 批量导入、编辑 / 禁用 / 删除 |
| 题库管理 | 题库列表、新建题库、试题维护（单选 / 多选 / 判断 / 编程） |
| 共享题库 | 查看共享题库与题目 |
| AI 出题 | 上传讲义等内容，AI 生成试题预览后入库 |
| 试卷管理 | 组卷、指定考试人员、发布、考试情况统计 |
| AI 批阅 | 编程题等主观题 AI / 人工批阅 |
| 成绩报告 | 分数段分布、名单导出、分享链接 |
| 个人中心 | 查看 / 修改个人资料 |



# 管理员功能

| 模块 | 介绍 |
| ---- | ---- |
| 用户管理 | 管理讲师与学员账号 |
| 题库 / 试卷 | 与讲师端能力类似，可跨用户管理 |
| 设置管理 | 全局 AI 大模型配置（Base URL / API Key / 模型），全站共用 |
| 系统种子数据 | 空库首次启动自动创建管理员与 AI 配置占位 |



# 系统展示

若下方截图未能正常显示，可前往在线文档预览：[系统演示文档](https://my.feishu.cn/docx/JuucdfmspowkM5xGSaAcwACpnpg?from=from_copylink)

https://my.feishu.cn/docx/JuucdfmspowkM5xGSaAcwACpnpg?from=from_copylink



## 学生端

- 我的考试

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/stu01_%E6%88%91%E7%9A%84%E8%80%83%E8%AF%95.jpg"/></td>
    </tr>
</table>

* 开始考试

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/stu02_考试中.jpg"/></td>
    </tr>
</table>

- 我的考试切屏

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/stu03_我的考试切屏.jpg"/></td>
    </tr>
</table>

- 我的成绩

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/stu04_我的成绩.jpg"/></td>
    </tr>
</table>
- 错题辅导智能体

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/stu05_错题辅导智能体.jpg"/></td>
    </tr>
</table>


## 讲师端

- 学员管理

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/teacher01_stu.jpg"/></td>
    </tr>
</table>
- 题库管理

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/teacher02_question.jpg"/></td>
    </tr>
</table>
​    


- 试卷管理

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/teacher03_new.jpg"/></td>
    </tr>
</table>
​    


- AI批阅试卷

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/teacher04_AI批阅试卷.jpg"/></td>
    </tr>
</table>

- 考试情况

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/teacher05_考试情况.jpg"/></td>
    </tr>
</table>

- 成绩报告

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/teacher06_成绩报告.jpg"/></td>
    </tr>
</table>

- 成绩报告导出

<table>
    <tr>
        <td><img src="http://cdn-img.zhaodashen.cn/exam/teacher07_成绩报告导出.jpg"/></td>
    </tr>
</table>
​