# 影像仓库

**Repository Path**: qlad/image-repository

## Basic Information

- **Project Name**: 影像仓库
- **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-10-13
- **Last Updated**: 2026-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 影像实验

界面已按 [当前原型](docs/prototype/index.html) 重建。学生端提供主页、试卷中心、自主练习、AI 助教及学习记录；教师端提供教学概览、影像图库与标注、题库编辑、卷库组卷发布、班级管理、学情分析、学生详情和答卷评分。两端共用账号安全和个人 AI 配置。

## 运行

在项目根目录运行（需要 Docker Desktop Linux 容器）：

```powershell
docker compose up -d --build --remove-orphans
```

Docker 仅运行 `web`、`api` 和 `postgres` 三个服务，不使用 nginx。前端由 Node.js 24 提供静态页面和 `/api` 流式转发。

访问 [本地系统](http://127.0.0.1:8080)。教师和学生沿用当前数据库账号及密码。启动执行迁移，不自动导入演示数据。原有名单、题库、课件影像和历史记录保留。

前端开发需要 Node.js 24：

```powershell
cd apps/web
npm ci
npm run dev
npm run build
npm run lint
npm run test -- --run
npm run test:server
npm run test:smoke
```

## 仓库结构

- `apps/`：前后端源码、有效测试和构建配置。
- `content/`：当前教学影像、题库、标注和来源清单。
- `docs/`：原始 PPT、当前原型和维护说明。
- `scripts/`：部署、内容导入和验收工具。

设计规范见 [DESIGN.md](apps/web/DESIGN.md)，原型入口为 [docs/prototype/index.html](docs/prototype/index.html)。静态素材清单为 `content/images/courseware/manifest.json`；题目与参考区域仍需教师核对。

生成的截图、报告和历史脚本归档在 `artifacts/`；数据备份及学生名单在 `backups/`；缓存位于 `.runtime/`。这些目录均不进入 Git。验证报告输出到 `artifacts/verification/`。

数据库卷 `pgdata` 保留账号与历史答卷。Docker 启动不自动创建演示数据。