# AuraK 版本管理文档

## 版本命名规则
- 格式: `v主版本.次版本.修订版本`
- 示例: v1.0.0, v1.1.0, v2.0.0

## 版本历史

### v1.1.0 (2026-05-13)
**状态**: ✅ 已完成

**新增功能**:
- 复查功能: PUT /assessment/:id/review
  * 支持调整最终总分
  * 记录复查历史(reviewHistory)
  * 保留原始分数(originalScore)
- 批量审核: POST /question-banks/:bankId/items/batch-review
  * 支持批量通过/拒绝题目
- 历史管理: GET /assessment/history
  * 自动保留最近3条评估记录

**已实现功能**:
- 题库管理: CRUD + 题目CRUD + AI生成 + 审核
- 模板管理: Settings-测评模板
- 评估执行: 抽取/答题/评分
- 成绩管理: 统计 + CSV导出 + 复查
- 证书管理: 生成 + 预览

**技术栈**:
- 后端: Node.js + NestJS + TypeORM + SQLite
- 前端: React + TypeScript + React Router
- 容器化: Docker Compose
- 搜索: Elasticsearch 9.2.1

**代码仓库**:
- Gitee: https://gitee.com/hangshuo652/aurak.git

---

### v1.0.0 (2026-05-13)
**状态**: ✅ 已完成

**功能**:
- 题库管理后端API完整实现
- 题库列表页：创建/删除/编辑入口
- 题库详情页：题目CRUD/AI生成/审核流程
- 模板管理页面 (Settings-测评模板)
- 评估统计页面
- 人才测评页面 (AssessmentView)

---

## Docker环境管理

### 启动服务
```bash
# 构建并启动所有服务
docker-compose up --build

# 后台运行
docker-compose up -d
```

### 停止服务
```bash
docker-compose down
```

### 查看状态
```bash
docker-compose ps
```

### 查看日志
```bash
# 所有服务
docker-compose logs -f

# 特定服务
docker-compose logs -f server
docker-compose logs -f web
```

---

## 后续版本规划

### v1.1.0 (待开发)
- [ ] 批量导入题目功能
- [ ] 相似题目检测
- [ ] 题目使用统计
- [ ] 复查功能（调整总分）

### v2.0.0 (规划中)
- [ ] 证书管理模块
- [ ] 多租户权限优化
- [ ] 导出功能 (Excel/PDF/CSV)

---

## 已知问题
1. 题库列表页删除按钮已实现，需测试
2. 题库详情页AI生成功能需测试
3. 审核流程需完善（批量审核）

---

*最后更新: 2026-05-13*