# 课评状态管理面板

> 解决"待确认"状态不直观问题，提升流程闭环率

---

## 🎛️ 状态面板设计

### 面板位置

在`memory/class-evaluation-summary/第X周/{班级}.md`文件顶部，插入状态管理面板：

```markdown
---

## 📊 本周课评状态面板

> 最后更新：{时间} | 当前操作员：{教师名}

### 快速统计

| 指标 | 数值 | 状态 |
|------|:----:|:----:|
| 应到人数 | {X}人 | - |
| **实到人数** | **{Y}人** | ✅ |
| 已确认 | {Z}人 | ☑️ |
| 待确认 | {W}人 | ⏳ |
| 待生成 | {V}人 | ⏸️ |
| 缺勤 | {U}人 | 🚫 |
| **课评完成率** | **{XX}%** | {进度条} |

### 操作快捷入口

| 操作 | 指令 | 说明 |
|------|------|------|
| 一键确认全部 | `[确认全部]` | 确认所有待确认课评 |
| 查看待确认 | `[查看待确认]` | 只显示待确认学生 |
| 生成缺勤 | `[标记缺勤]` | 为未到学生记录缺勤 |
| 更新状态 | `[刷新]` | 重新计算统计数据 |

---

```

---

## 📋 学生状态明细表

在学生列表部分，使用交互式状态表：

```markdown
### 学生状态明细

| 序号 | 学生 | 状态 | 生成时间 | 确认时间 | 操作 |
|:----:|:-----|:----:|:--------:|:--------:|:----:|
| 1 | 乔乔 | ☑️ 已确认 | 16:00 | 16:05 | [查看] [修改] |
| 2 | 昊昊 | ⏳ 待确认 | 16:02 | - | [确认] [修改] [删除] |
| 3 | 小明 | ⏸️ 待生成 | - | - | [输入表现] [标记缺勤] |
| 4 | 小红 | 🚫 缺勤 | - | - | [补录] |

**图例**：
- ☑️ 已确认 - 已审核通过，已双轨保存
- ⏳ 待确认 - 已生成，等待教师确认
- ⏸️ 待生成 - 教师未输入表现
- 🚫 缺勤 - 学生未到校
```

---

## 🔔 自动提醒机制

### 提醒触发条件

| 场景 | 触发时间 | 提醒内容 |
|------|---------|---------|
| 批量生成后未确认 | 5分钟后 | "您有{X}份课评待确认" |
| 课评生成后1小时 | 1小时后 | "{学生}的课评还未确认，是否遗忘？" |
| 当日结束 | 22:00 | "今日有{X}份待确认课评，建议处理" |
| 跨周提醒 | 下周一 | "上周有{X}份未确认课评，请尽快处理" |

### 提醒展示格式

```
━━━━━━━━━━━━━━━━━━━━━━━━━
⏰ 课评状态提醒

您当前有 3份课评待确认：

1. 昊昊（发现世界-周四19点）- 生成于16:02
2. 小明（发现世界-周四19点）- 生成于16:05
3. 小红（Wedo-周六1030）- 生成于昨天

[一键全部确认] [查看详情] [忽略]
━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## 🔄 状态流转规则

### 状态流转图

```
                    教师输入表现
                           ↓
                   ┌───────────────┐
         标记缺勤 →│   待生成      │← 取消缺勤
                   └───────┬───────┘
                           ↓ AI生成课评
                   ┌───────────────┐
         教师确认 →│   待确认      │← 教师修改
                   └───────┬───────┘
                           ↓ 教师确认
                   ┌───────────────┐
                   │   已确认      │
                   └───────┬───────┘
                           ↓ 自动双轨保存
                   ┌───────────────┐
         查看/修改 →│   已保存      │
                   └───────────────┘
```

### 操作指令对照表

| 当前状态 | 教师操作 | 新状态 | 效果 |
|:--------:|---------|:------:|:-----|
| 待生成 | 输入表现 | 待确认 | 生成课评 |
| 待生成 | 标记缺勤 | 缺勤 | 记录缺勤 |
| 待确认 | 回复"确认" | 已确认 | 双轨保存 |
| 待确认 | 回复"修改：XXX" | 待确认 | 重新生成 |
| 待确认 | 点击[确认] | 已确认 | 双轨保存 |
| 已确认 | 回复"修改：XXX" | 已确认 | 更新内容 |
| 缺勤 | 补录表现 | 待确认 | 生成课评 |

---

## 📱 快速操作示例

### 场景1：一键确认全部

```
教师：确认全部

AI：
━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 已确认 3份课评

☑️ 昊昊 - 发现世界-周四19点 - DISC-007
☑️ 小明 - 发现世界-周四19点 - DISC-007
☑️ 小红 - Wedo-周六1030 - CREATE-007

已自动双轨保存到：
- 班级周汇总
- 个人历史课评
━━━━━━━━━━━━━━━━━━━━━━━━━
```

### 场景2：批量查看待确认

```
教师：查看待确认

AI：
━━━━━━━━━━━━━━━━━━━━━━━━━
⏳ 待确认课评列表（3份）

【发现世界-周四19点 - DISC-007】
1. 昊昊
   生成时间：16:02
   字数：205字
   [确认] [查看] [修改]

2. 小明
   生成时间：16:05
   字数：198字
   [确认] [查看] [修改]

【Wedo-周六1030 - CREATE-007】
3. 小红
   生成时间：昨天
   字数：210字
   [确认] [查看] [修改]

[一键全部确认]
━━━━━━━━━━━━━━━━━━━━━━━━━
```

### 场景3：单个学生快速操作

```
教师：确认昊昊

AI：
━━━━━━━━━━━━━━━━━━━━━━━━━
☑️ 已确认：昊昊（发现世界-周四19点）

课评内容预览：
"昊昊本节课学习了..."

已保存到：
- 班级周汇总：第7周/发现世界-周四19点.md
- 个人档案：student/发现世界-周四19点/昊昊/历史课评记录.md
━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## 📊 数据持久化

### 状态存储位置

状态信息保存在班级汇总文件的YAML Frontmatter中：

```markdown
---
class: 发现世界-周四19点
week: 7
course: DISC-007
generated_at: 2026-04-17T16:00:00
status:
  total: 2
  confirmed: 1
  pending: 1
  missing: 0
students:
  - name: 乔乔
    status: confirmed
    generated_at: "16:00"
    confirmed_at: "16:05"
  - name: 昊昊
    status: pending
    generated_at: "16:02"
    confirmed_at: null
---

# 发现世界-周四19点 第7周汇总
...
```

---

## ✅ 实施检查清单

- [ ] 在班级汇总模板中添加状态面板
- [ ] 实现"一键确认全部"功能
- [ ] 实现"查看待确认"过滤功能
- [ ] 配置自动提醒（5分钟、1小时、当日结束）
- [ ] 在文件Frontmatter中添加状态元数据
- [ ] 测试状态流转是否正常

---

*版本：v1.0*  
*更新日期：2026-04-19*  
*配套文件：32-batch-generation.md*