# recent_eval

**Repository Path**: legand/recent_eval

## Basic Information

- **Project Name**: recent_eval
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 课后反馈助手 MVP

一个面向老师的 H5 课后反馈生成工作台。当前版本采用 Next.js 单体应用、Prisma、SQLite 和邀请码登录。

## 本地运行

```bash
pnpm install
pnpm prisma:generate
pnpm prisma:seed
pnpm dev
```

默认邀请码：

```text
TEACHER-DEMO
```

默认管理员邀请码：

```text
ADMIN-DEMO
```

管理员登录后进入 `/admin/invites`，可以生成老师邀请码，并复制邀请码或入口页地址。

如果是首次初始化数据库：

```bash
pnpm prisma migrate dev --name init
```

在 Windows 上如果 Prisma 引擎文件被 dev server 占用，先停止 `pnpm dev`，再运行 Prisma 命令。

## 环境变量

复制 `.env.example` 为 `.env`，至少配置：

```env
DATABASE_URL="file:./../data/app.db"
SESSION_SECRET="change-me-to-a-long-random-secret"
OPENAI_API_KEY=""
OPENAI_BASE_URL="https://api.openai.com/v1"
OPENAI_MODEL="gpt-4.1-mini"
DEFAULT_INVITE_CODE="TEACHER-DEMO"
ADMIN_INVITE_CODE="ADMIN-DEMO"
```

`OPENAI_API_KEY` 必须放在服务端环境变量中，不能放到 H5 前端。

## 核心流程

```text
邀请码登录
  -> 首次新增学生
  -> 可选维护参考模板
  -> 生成反馈
  -> 编辑确认
  -> 保存并复制
  -> 最终确认稿进入历史记录，作为后续 few-shot 样本
```

## 参考模板

老师可以在 `/templates` 维护自己的参考模板。模板是完整示例文本，生成反馈时可在生成页手动选择。

选择模板后，模型会强参考模板的标题、栏目顺序、符号、换行和整体排版，但仍以本次课堂记录作为事实来源，不会复用模板里的具体学生信息或课堂事实。

## 代码分层

```text
src/app
  页面与 API Routes

src/server/repositories
  数据访问封装，避免业务代码散落 Prisma 查询

src/server/services
  邀请码登录、学生管理、反馈生成与保存

src/server/ai
  prompt 构造、模型调用、生成后校验
```

后续从 SQLite 迁移 PostgreSQL 时，优先保持 `repositories` 和 `services` 的调用边界不变。