kindergarten_java/docs/产品介绍与功能说明.md

# 幼儿阅读教学服务平台 - 产品介绍与功能说明

## 一、产品概述

### 1.1 产品定位

**幼儿阅读教学服务平台**是一款面向幼儿园的B2B2C综合性阅读教学管理系统，致力于为幼儿园、教师和家长提供全方位的绘本阅读教学服务。平台采用多端协同架构，打通超管、学校、教师、家长四方角色，实现从课程创作、教学管理到家校互动的完整闭环。

### 1.2 目标用户

| 用户角色 | 使用场景 | 核心需求 |
|---------|---------|---------|
| **平台超管** | 运营管理 | 课程内容管理、租户服务、平台运营 |
| **学校管理员** | 园所管理 | 教师学生管理、课程授权、数据统计 |
| **教师** | 教学实施 | 课程备课、课堂教学、任务布置、成长记录 |
| **家长** | 家校共育 | 查看任务、提交反馈、了解孩子成长 |

### 1.3 核心价值

- **标准化教学**：专业绘本课程包，标准化教学流程
- **效率提升**：备课上课一体化，教学管理智能化
- **家校联动**：任务布置与反馈，家校共育更紧密
- **成长可视**：多维度数据记录，成长轨迹清晰可见
- **灵活管理**：多租户架构，满足不同规模园所需求

---

## 二、技术架构

### 2.1 系统架构

```
┌─────────────────────────────────────────────────────────────┐
│                        前端应用层                             │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐     │
│  │  超管端   │  │  学校端   │  │  教师端   │  │  家长端   │     │
│  │  (Admin)  │  │ (School) │  │(Teacher) │  │ (Parent) │     │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘     │
│                      Vue 3 + Ant Design Vue                  │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                        API网关层                             │
│                    NestJS + JWT认证                          │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                        业务服务层                             │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐     │
│  │ 课程服务  │  │ 教学服务  │  │ 用户服务  │  │ 数据服务  │     │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘     │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                        数据存储层                             │
│              Prisma ORM + SQLite/PostgreSQL                 │
└─────────────────────────────────────────────────────────────┘
```

### 2.2 技术选型

| 层级 | 技术栈 | 说明 |
|-----|-------|------|
| **前端框架** | Vue 3 + Vite | 现代化前端开发框架 |
| **UI组件** | Ant Design Vue 4.x | 企业级UI组件库 |
| **状态管理** | Pinia | Vue官方状态管理 |
| **后端框架** | NestJS | 企业级Node.js框架 |
| **ORM** | Prisma | 现代化数据库工具 |
| **数据库** | SQLite / PostgreSQL | 开发/生产数据库 |
| **认证** | JWT + Passport | 安全认证方案 |
| **文件存储** | 本地存储 / 云存储 | 支持多种存储方案 |

---

## 三、功能模块详解

### 3.1 超管端功能

超管端是平台的运营管理中心，负责课程内容生产、租户服务和平台运营。

#### 3.1.1 数据看板

提供平台整体运营数据的可视化展示：

- **核心指标**：租户数量、课程数量、授课次数、学生总数
- **趋势图表**：用户增长趋势、课程使用趋势
- **快捷入口**：快速访问常用功能

#### 3.1.2 课程包管理

完整的课程内容生产与发布流程：

| 功能 | 说明 |
|-----|------|
| **基础信息** | 课程名称、适用年级、关联绘本、课程简介、核心目标 |
| **资源上传** | 封面图片、电子绘本(PDF)、音频资源、视频资源 |
| **教学环节** | 多步骤教学流程设计，每步包含时长、目标、讲稿、资源 |
| **逐页脚本** | 绘本每一页的教师话术和教学备注 |
| **延伸活动** | 课堂延伸和家庭延伸活动设计 |
| **审核流程** | 草稿 → 待审核 → 已发布 → 已下架 |
| **版本管理** | 支持课程版本迭代和历史回溯 |

#### 3.1.3 资源库管理

统一管理平台所有教学资源：

- **资源类型**：图片、音频、视频、文档
- **资源分类**：按类型、用途自动分类
- **在线预览**：支持图片、PDF、音视频在线预览
- **批量管理**：支持批量上传、删除操作

#### 3.1.4 租户管理

多租户服务的核心管理功能：

- **租户列表**：查看所有签约园所
- **创建租户**：录入园所基本信息和管理员账号
- **套餐配置**：设置教师数、学生数、存储空间等配额
- **课程授权**：为租户分配可使用的课程包
- **服务管理**：暂停/恢复租户服务
- **密码重置**：重置租户管理员密码

#### 3.1.5 系统设置

平台全局配置：

- **标签管理**：课程标签、领域分类
- **年级配置**：小班、中班、大班等年级设置

---

### 3.2 学校端功能

学校端是园所管理员的管理后台，负责本园的教师、学生、班级和教学管理。

#### 3.2.1 数据概览

园所运营数据一目了然：

- **人员统计**：教师数、学生数、班级数
- **教学统计**：授课次数、任务完成率
- **图表展示**：授课趋势、课程分布

#### 3.2.2 人员管理

##### 教师管理
- 教师列表查看与搜索
- 添加/编辑教师信息（姓名、邮箱、手机号）
- 分配教师到班级
- 重置教师密码
- 删除教师账号

##### 学生管理
- 学生列表查看与搜索
- 添加/编辑学生信息（姓名、年级、家长联系方式）
- 批量导入学生（Excel）
- 学生调班功能
- 删除学生档案

#### 3.2.3 班级管理

- **班级列表**：查看所有班级及学生数量
- **创建班级**：设置班级名称、年级
- **教师分配**：设置班主任、配班教师
- **学生管理**：查看班级学生列表

#### 3.2.4 教学管理

##### 课程管理
- 查看已授权课程列表
- 按年级、领域筛选课程
- 搜索课程名称
- 查看课程详情

##### 课程排期
- **日历视图**：直观展示排课情况
- **创建排课**：选择课程、班级、教师、时间
- **编辑/删除**：调整排课安排
- **批量排课**：一次性安排多节课

##### 阅读任务
- 任务列表管理
- 创建/编辑/删除任务
- 查看任务完成情况
- 按班级、学生分配任务

##### 任务模板
- 预设任务模板库
- 基于模板快速创建任务
- 自定义任务模板

##### 课程反馈
- 查看教师提交的课程反馈
- 反馈数据统计分析

#### 3.2.5 数据中心

##### 数据报告
- 授课次数统计
- 活跃教师排行
- 课程评分统计
- 导出Excel报表

##### 成长档案
- 学生成长档案列表
- 查看个人成长详情
- 按班级、学生筛选

#### 3.2.6 系统管理

##### 套餐管理
- 查看当前套餐信息
- 配额使用情况（教师数、学生数、存储空间）
- 套餐有效期

##### 操作日志
- 记录所有管理操作
- 按时间、操作类型筛选

##### 系统设置
- 学校基本信息维护
- 通知设置

---

### 3.3 教师端功能

教师端是教师日常教学的核心工具，覆盖备课、上课、课后全流程。

#### 3.3.1 首页

教学数据一目了然：

- **我的班级**：负责的班级数量
- **学生总数**：教授的学生数量
- **授课次数**：累计授课次数
- **使用课程**：使用过的课程数

#### 3.3.2 课程中心

浏览和使用已授权的课程：

- **课程列表**：卡片式展示所有可用课程
- **年级筛选**：按小班/中班/大班筛选
- **领域筛选**：按语言、社会、科学等领域筛选
- **关键词搜索**：快速找到目标课程
- **课程详情**：查看完整的教学设计

#### 3.3.3 备课模式

课前准备工作：

- **教学流程**：按步骤展示教学环节
- **教师讲稿**：每个环节的详细讲稿
- **逐页脚本**：绘本每一页的教学话术
- **备课笔记**：记录个人备课心得
- **教学材料**：查看本节课需要的材料
- **选择班级**：选择要授课的班级

#### 3.3.4 上课模式

课堂教学核心功能：

| 功能模块 | 说明 |
|---------|------|
| **计时器** | 实时显示课程进行时间 |
| **流程导航** | 上一步/下一步切换教学环节 |
| **讲稿展示** | 当前环节的教师讲稿 |
| **展播模式** | 全屏展示，适合投屏教学 |
| **课堂评价** | 对每个环节进行星级评价 |
| **结束课程** | 保存课堂记录 |

##### 课堂记录
课程结束时填写：
- **完成情况**：完全完成/基本完成/未完成
- **整体评价**：星级评分
- **学生参与度**：星级评分
- **完成备注**：文字描述课堂情况

#### 3.3.5 上课记录

历史授课记录管理：

- **记录列表**：展示所有授课记录
- **状态筛选**：已计划/进行中/已完成
- **日期筛选**：按时间段查看
- **记录详情**：查看完整课堂信息
- **课后记录**：补充课后反思

#### 3.3.6 我的班级

管理负责的班级：

- **班级卡片**：显示班级信息、学生数、授课进度
- **学生列表**：查看班级学生详情
- **快捷操作**：备课、查看学生、查看记录

#### 3.3.7 阅读任务

布置和管理阅读任务：

- 任务列表查看
- 创建/编辑任务
- 查看完成情况

#### 3.3.8 课程反馈

对课程内容进行评价反馈：

- 反馈列表
- 提交课程反馈
- 设计质量、参与度、目标达成评价

#### 3.3.9 成长档案

记录学生成长瞬间：

- **档案列表**：查看所有成长记录
- **添加档案**：创建新的成长记录
- **档案类型**：个人档案/班级档案
- **内容记录**：标题、日期、内容、图片

---

### 3.4 家长端功能

家长端是家校互动的桥梁，让家长了解并参与孩子的阅读成长。

#### 3.4.1 首页

孩子信息概览：

- **孩子卡片**：显示孩子姓名、班级、阅读次数
- **最近任务**：待完成的阅读任务
- **成长档案**：最新的成长记录

#### 3.4.2 我的孩子

查看孩子详细信息：

- 基本信息（姓名、班级、年级）
- 阅读次数统计
- 上课次数统计

#### 3.4.3 阅读记录

查看孩子的学习记录：

- **记录列表**：显示所有上课记录
- **课程信息**：课程名称、绘本名称
- **上课时间**：授课日期
- **评分展示**：专注度、兴趣度星级评分

#### 3.4.4 阅读任务

完成教师布置的任务：

- **任务列表**：显示待完成的阅读任务
- **任务详情**：任务要求、截止日期
- **提交反馈**：填写任务完成情况
- **反馈记录**：查看已提交的反馈

#### 3.4.5 成长档案

查看孩子的成长记录：

- 档案列表展示
- 查看档案详情（图片、文字记录）

---

## 四、核心业务流程

### 4.1 课程生产流程

```
超管创建课程 → 填写基础信息 → 上传资源 → 设计教学环节
      → 添加延伸活动 → 提交审核 → 审核通过 → 发布课程
      → 授权给租户 → 学校/教师使用
```

### 4.2 教学实施流程

```
教师浏览课程 → 进入备课模式 → 记录备课笔记 → 选择班级
      → 开始上课 → 按流程教学 → 课堂评价 → 结束课程
      → 填写课堂记录 → 查看上课记录
```

### 4.3 家校互动流程

```
教师布置任务 → 分配给学生/班级 → 家长查看任务
      → 亲子完成阅读 → 家长提交反馈 → 教师查看反馈
```

### 4.4 成长记录流程

```
教师观察学生 → 创建成长档案 → 选择学生 → 填写内容
      → 上传图片 → 保存档案 → 家长查看
```

---

## 五、数据模型

### 5.1 核心实体关系

```
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Tenant    │────→│   School    │────→│    Class    │
│   (租户)    │     │   (学校)    │     │   (班级)    │
└─────────────┘     └─────────────┘     └─────────────┘
                          │                    │
                          │                    │
                          ▼                    ▼
                   ┌─────────────┐     ┌─────────────┐
                   │   Teacher   │     │   Student   │
                   │   (教师)    │     │   (学生)    │
                   └─────────────┘     └─────────────┘
                          │                    │
                          │                    │
                          ▼                    ▼
                   ┌─────────────────────────────────┐
                   │            Lesson               │
                   │           (授课)                │
                   └─────────────────────────────────┘
```

### 5.2 主要数据表

| 表名 | 说明 | 主要字段 |
|-----|------|---------|
| **Tenant** | 租户信息 | name, status, packageType, quota |
| **User** | 用户账号 | username, password, role, tenantId |
| **Teacher** | 教师信息 | name, email, phone, classIds |
| **Student** | 学生信息 | name, grade, classId, parentId |
| **Parent** | 家长信息 | name, phone, studentIds |
| **Class** | 班级信息 | name, grade, teacherIds, studentIds |
| **Course** | 课程包 | name, grade, bookName, status, version |
| **Lesson** | 授课记录 | courseId, classId, teacherId, status |
| **Task** | 阅读任务 | title, courseId, classId, deadline |
| **GrowthRecord** | 成长档案 | studentId, type, title, content |
| **Resource** | 资源文件 | name, type, url, size |

---

## 六、安全与权限

### 6.1 认证机制

- **JWT Token**：用户登录后获取Token，后续请求携带Token
- **角色区分**：ADMIN/SCHOOL/TEACHER/PARENT四种角色
- **租户隔离**：数据按tenantId隔离，确保数据安全

### 6.2 权限控制

| 角色 | 数据范围 | 功能权限 |
|-----|---------|---------|
| **超管** | 全平台数据 | 课程管理、租户管理、系统设置 |
| **学校** | 本园数据 | 人员管理、班级管理、教学管理 |
| **教师** | 本班数据 | 课程使用、上课、任务布置 |
| **家长** | 自己孩子数据 | 查看任务、提交反馈、查看档案 |

---

## 七、部署与运维

### 7.1 部署架构

```
┌─────────────────────────────────────────────────────────────┐
│                      负载均衡 (Nginx)                        │
└─────────────────────────────────────────────────────────────┘
                    │                    │
                    ▼                    ▼
         ┌─────────────────┐   ┌─────────────────┐
         │   前端服务       │   │   后端服务       │
         │   (静态资源)     │   │   (NestJS)      │
         └─────────────────┘   └─────────────────┘
                                       │
                                       ▼
                              ┌─────────────────┐
                              │   数据库         │
                              │  (PostgreSQL)   │
                              └─────────────────┘
```

### 7.2 环境配置

| 环境 | 前端地址 | 后端地址 | 数据库 |
|-----|---------|---------|-------|
| **开发** | localhost:5173 | localhost:3000 | SQLite |
| **生产** | 域名/CDN | 域名/API | PostgreSQL |

### 7.3 启动命令

```bash
# 开发环境启动
./start-all.sh

# 停止服务
./stop-all.sh
```

---

## 八、版本信息

| 项目 | 版本 | 更新日期 |
|-----|------|---------|
| 前端 | v1.0 | 2026-02-24 |
| 后端 | v1.0 | 2026-02-24 |

---

## 九、联系方式

如有问题或建议，请联系技术支持团队。

---

*文档版本：v1.0*
*创建日期：2026-02-24*
*最后更新：2026-02-24*