En
de264d3298
- 修改 pom.xml 中的 groupId - 移动所有 Java 文件到新包路径 com/lesingle/edu - 更新所有 Java 文件的 package 和 import 语句 (438 个文件) - 更新配置文件中的日志包名引用 (application-*.yml, logback-spring.xml) - 更新 @MapperScan 注解路径 - 更新 CLAUDE.md 文档中的目录结构说明 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
18 KiB
18 KiB
少儿智慧阅读 - 产品介绍与功能说明
一、产品概述
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 启动命令
# 开发环境启动
./start-all.sh
# 停止服务
./stop-all.sh
八、版本信息
| 项目 | 版本 | 更新日期 |
|---|---|---|
| 前端 | v1.0 | 2026-02-24 |
| 后端 | v1.0 | 2026-02-24 |
九、联系方式
如有问题或建议，请联系技术支持团队。
文档版本：v1.0 创建日期：2026-02-24 最后更新：2026-02-24