幼儿阅读教学服务平台 - 项目总览
更新时间：2026-02-27
项目状态：需求重构中 - 课程包与套餐结构重构
⚠️ 重要变更通知（2026-02-27）
本项目正在进行课程包与套餐结构重构，涉及较大幅度的需求变更。请优先阅读以下新文档：
核心变更点：
- 新增"课程套餐"概念（授权/计费单位）
- 课程包结构重构（从单次课程变为教学单元）
- 新增"校本课程包"功能
- 授权方式变更（从按课程包授权变为按套餐授权）
📋 项目简介
幼儿阅读教学服务平台是一个面向幼儿园的B2B2C阅读教学服务平台，将优质绘本资源包装成教学课程，帮助幼儿园老师更好地完成教学工作。
核心价值
┌─────────────────────────────────────────────────────────────────┐
│ │
│ 专业教研团队 幼儿园教师 │
│ │ │ │
│ │ 课程套餐制作工作台 │ │
│ │ └──────┬───────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ 教学方案 ────▶ 课程套餐（含课程包） ────▶ "傻瓜式"教学 │
│ +素材资源 (按年级编排、 (备课简单、 │
│ 授权分发) 上课轻松) │
│ │
└─────────────────────────────────────────────────────────────────┘
🏗️ 平台架构
技术形态（MVP）
| 端 |
技术形态 |
说明 |
| 🔴 超管端 |
Web端 |
PC浏览器访问，复杂内容管理操作 |
| 🔴 学校端 |
Web端 |
PC浏览器访问，数据查看和管理 |
| 🔴 教师端 |
Web端 |
PC/平板浏览器访问，支持投屏上课 |
| ⬜ 家长端 |
H5响应式 |
手机/平板访问，支持微信内打开（V2版本） |
当前技术栈
| 层级 |
技术 |
说明 |
| 前端框架 |
Vue 3 + Vite |
已实现 |
| UI组件库 |
Ant Design Vue |
已实现 |
| 状态管理 |
Pinia |
已实现 |
| 后端框架 |
NestJS |
已实现 |
| ORM |
Prisma |
已实现 |
| 数据库 |
SQLite（开发）→ PostgreSQL（生产） |
开发阶段使用SQLite |
| 认证 |
JWT + Passport |
已实现 |
系统架构图
┌──────────┐ ┌──────────┐ ┌──────────┐
│ 超管端Web │ │ 学校端Web │ │ 教师端Web │ ← MVP
└──────────┘ └──────────┘ └──────────┘
│ │ │
└─────────────┼─────────────┘
│
┌──────▼──────┐
│ 后端API服务 │
└─────────────┘
│
┌──────▼──────┐
│ 数据库 │
└─────────────┘
👥 角色体系
| 角色 |
核心诉求 |
主要功能 |
| 超管端 |
制作套餐和课程包、管理租户、数据统计 |
套餐管理、课程包制作、租户管理、资源库、数据看板 |
| 学校端 |
管理教师、查看数据、套餐管理 |
教师管理、学生管理、套餐续费、校本课程包 |
| 教师端 |
备课上课、记录测评、班级管理 |
课程中心、备课模式、上课模式、校本课程包、成长档案 |
| 家长端 |
查看孩子情况、亲子共读 |
孩子成长档案、阅读记录、亲子共读指导（V2） |
📦 核心功能模块（新结构）
超管端
| 模块 |
功能 |
状态 |
说明 |
| 套餐管理 |
创建、编辑、发布套餐 |
✅ 已实现 |
新增模块，授权/计费单位 |
| 课程包管理 |
创建、编辑课程包（6步流程） |
✅ 已实现 |
结构重构（8个富文本+3类课程） |
| 主题字典 |
全局主题管理 |
✅ 已实现 |
新增模块 |
| 租户管理 |
开通学校、套餐授权 |
✅ 已实现 |
从按课程包授权改为按套餐授权 |
| 资源库管理 |
绘本库、多媒体素材 |
⬜ 待开发 |
第二阶段开发 |
| 数据统计看板 |
平台整体数据 |
⬜ 待开发 |
租户数、套餐数、使用量 |
| 系统配置 |
标签体系、年级配置 |
✅ 已实现 |
预置《3-6岁指南》标签 |
学校端
| 模块 |
功能 |
状态 |
说明 |
| 首页看板 |
学校数据概览 |
🔄 框架完成 |
授课趋势、活跃教师、课程排行 |
| 教师管理 |
教师列表、账号管理 |
🔄 框架完成 |
新增/停用教师、查看教师数据 |
| 套餐管理 |
查看套餐、续订套餐 |
🆕 待开发 |
新增模块 |
| 校本课程包 |
查看、预约、排课 |
🆕 待开发 |
新增模块 |
| 课程包查看 |
查看课程包详情 |
🔄 需调整 |
适配新结构 |
| 学生管理 |
学生列表、班级管理 |
🔄 框架完成 |
学生信息、成长档案 |
| 数据报表 |
授课统计、教师活跃度 |
⬜ 待开发 |
数据导出 |
教师端
| 模块 |
功能 |
状态 |
说明 |
| 课程中心 |
浏览、搜索课程包 |
🔄 需调整 |
适配新结构展示 |
| 备课模式 |
左侧导航+右侧预览 |
🔄 需调整 |
按课程维度备课 |
| 上课模式 |
大屏展示+环节导航 |
🔄 需调整 |
支持整体上或选择性上 |
| 校本课程包 |
创建、编辑校本课程包 |
🆕 待开发 |
新增模块 |
| 反馈记录 |
快速记录+详细反馈 |
🔄 部分完成 |
课程评分、意见建议 |
| 班级管理 |
学生列表、班级数据 |
🔄 框架完成 |
管理班级学生 |
| 成长档案 |
五大领域发展情况 |
⬜ 待开发 |
查看学生阅读和测评数据 |
🎓 课程体系（新结构）
概念层级
课程套餐（授权/计费单位）
│
├── 按年级分组（小班/中班/大班）
├── 课程包有前后顺序
│
└── 包含多个 ──→ 课程包
│
├── 基本信息（主题、年级、绘本、核心内容）
├── 课程介绍（8个富文本）
├── 排课计划参考（表格）
│
└── 包含课程
├── 1. 导入课（5-15分钟）
├── 2. 集体课（约25分钟）
└── 3. 五大领域课（可选）
├── 语言领域课
├── 健康领域课
├── 科学领域课
├── 社会领域课
└── 艺术领域课
课程包新结构
| 模块 |
内容 |
| 基本信息 |
主题（字典单选）、适用年级、关联绘本、核心内容 |
| 课程介绍 |
课程简介、课程亮点、课程总目标、课程内容安排、教学重难点、教学方法、评价方式、注意事项 |
| 排课计划参考 |
表格：时间、课程类型、课程名称、区域活动、备注 |
| 导入课 |
教学目标、教学准备、教学过程（自定义环节）、教学反思、测评工具 |
| 集体课 |
核心资源（动画+课件）、教学目标、教学准备、教学过程（4环节模板）、教学延伸、教学反思、测评工具 |
| 五大领域课 |
结构同集体课，但教学过程自定义，可选配置 |
标签体系（基于《3-6岁指南》）
一级：五大领域（5个）
└─ 二级：子领域（11个）
└─ 三级：发展目标（32个）
└─ 四级：年龄段指标（96个）
| 领域 |
子领域 |
目标数 |
| 健康 |
身心状况、动作发展、生活习惯与能力 |
9个 |
| 语言 |
倾听与表达、阅读与书写准备 |
6个 |
| 社会 |
人际交往、社会适应 |
7个 |
| 科学 |
科学探究、数学认知 |
6个 |
| 艺术 |
感受与欣赏、表现与创造 |
4个 |
💰 商业模式（新结构）
盈利模式
| 项目 |
说明 |
| 收费方式 |
按年/学期向幼儿园收费 |
| 授权单位 |
按课程套餐授权（非按课程包） |
| 套餐定价 |
手动填写固定价格或折扣价格 |
套餐示例
| 套餐类型 |
包含内容 |
价格示例 |
| 小班套餐 |
小班年级所有课程包 |
待定 |
| 中班套餐 |
中班年级所有课程包 |
待定 |
| 大班套餐 |
大班年级所有课程包 |
待定 |
| 全年套餐 |
所有年级课程包 |
待定 |
| 主题套餐 |
特定主题的课程包合集 |
待定 |
竞争优势
- ✅ 独家版权绘本资源
- ✅ 专业教研团队
- ✅ 强大的研发能力
- ✅ 完整的教学体系（导入→集体→领域延伸）
🗄️ 数据模型（重构中）
新增核心实体
课程套餐 (course_packages)
│
├──← 套餐-课程包关联 (course_package_courses) →→ 课程包 (courses)
│ │
│ ├── 课程 (course_lessons)
│ │ │
│ │ └── 教学环节 (lesson_steps)
│ │
│ └── 校本课程包 (school_course_packages)
│
└── 租户-套餐授权 (tenant_packages)
主要数据表（重构后）
| 表名 |
说明 |
状态 |
| course_packages |
课程套餐 |
🆕 新增 |
| course_package_courses |
套餐-课程包关联 |
🆕 新增 |
| courses |
课程包 |
🔄 重构 |
| course_lessons |
课程（导入课/集体课/领域课） |
🆕 新增 |
| lesson_steps |
教学环节 |
🆕 新增 |
| school_course_packages |
校本课程包 |
🆕 新增 |
| themes |
主题字典 |
🆕 新增 |
| tenants |
租户（幼儿园） |
✅ 保留 |
| teachers |
教师 |
✅ 保留 |
| students |
学生 |
✅ 保留 |
| classes |
班级 |
✅ 保留 |
| tags |
标签体系 |
✅ 保留 |
🔌 API接口设计
接口规范
| 项目 |
说明 |
| 协议 |
HTTPS |
| 数据格式 |
JSON |
| 认证方式 |
JWT Token |
| 基础路径 |
/api/v1 |
主要API模块
| 模块 |
路径前缀 |
说明 |
| 认证 |
/auth |
登录、登出、刷新Token |
| 超管端 |
/admin |
套餐管理、课程包管理、租户管理 |
| 学校端 |
/school |
教师、学生、班级、套餐、校本课程包 |
| 教师端 |
/teacher |
课程包、备课、上课、校本课程包、反馈 |
| 文件上传 |
/files |
文件上传、删除 |
📅 开发计划与进度
重构阶段（当前）
Phase R1 (2-3周) → 需求梳理与设计重构 ✅ 已完成
├── ✅ 需求梳理完成
├── ✅ 设计重构
│ ├── ✅ 超管端设计（套餐管理、课程包管理）
│ ├── ✅ 教师端设计（适配新结构）
│ └── ✅ 学校端设计（新增套餐、校本课程包）
└── ✅ 数据模型重构
Phase R2 (3-4周) → 功能重构 ✅ 已完成（2026-02-27）
├── ✅ 超管端：套餐管理、课程包管理重构（6步流程）
├── ✅ 学校端：套餐查看、校本课程包
├── ✅ 教师端：适配新结构、校本课程包
└── ✅ 后端API重构
Phase R3 (2周) → 测试与优化 ✅ 已完成（2026-02-27）
├── ✅ 功能测试
├── ✅ 数据迁移
└── ⬜ 上线部署
MVP验证指标
| 指标 |
目标 |
| 课程套餐数量 |
≥3个（覆盖小/中/大班） |
| 课程包数量 |
≥10个（覆盖各年级） |
| 试点学校 |
≥5所幼儿园 |
| 活跃教师 |
≥20人 |
| 使用次数 |
≥100次授课 |
| 反馈收集 |
≥50条反馈 |
| 付费意愿 |
≥2所续费意向 |
📁 项目文档清单
核心文档（最新）
| 序号 |
文档名称 |
状态 |
内容摘要 |
| 17 |
课程包套餐重构需求 |
✅ 已完成 |
完整的重构需求文档 |
| 18 |
超管端设计-重构版 |
✅ 已完成 |
套餐管理、课程包管理、主题字典 |
| 19 |
教师端设计-重构版 |
✅ 已完成 |
课程包查看、备课、上课、校本课程包 |
| 20 |
学校端设计-重构版 |
✅ 已完成 |
套餐查看、续订、校本课程包管理 |
| 21 |
数据模型重构设计 |
✅ 已完成 |
新增表设计、重构表设计、迁移方案 |
| 22 |
教师端重构开发规划 |
✅ 已完成 |
6阶段开发规划，Phase 1-6 全部完成 |
| 23 |
校本课程包功能完善设计 |
✅ 已完成 |
校本课程包完整设计方案 |
| 24 |
展播模式优化设计 |
✅ 已完成 |
展播模式儿童友好界面设计 |
| 00 |
项目概览 |
✅ |
本文档 |
设计文档
| 序号 |
文档名称 |
状态 |
说明 |
| 01 |
商业模式 |
⚠️ 需更新 |
套餐定价模式已变更 |
| 02 |
角色分析 |
✅ 有效 |
四端角色核心诉求 |
| 03 |
课程体系 |
⚠️ 需更新 |
课程包结构已重构 |
| 04 |
教学场景 |
✅ 有效 |
一日活动流程、延伸活动形式 |
| 06 |
指南解读与应用 |
✅ 有效 |
《3-6岁指南》标签体系详解 |
| 07 |
课程包设计 |
❌ 已过时 |
被17号文档替代 |
| 08 |
教师端功能设计 |
⚠️ 需更新 |
适配新结构 |
| 08+ |
教师端功能设计（补充） |
⚠️ 需更新 |
适配新结构 |
| 09 |
标签体系详解 |
✅ 有效 |
4级标签体系完整表格 |
| 10 |
超管端功能设计 |
❌ 已过时 |
被17号文档替代 |
| 11 |
技术形态与MVP范围 |
✅ 有效 |
技术选型、MVP功能清单 |
| 12 |
学校端功能设计 |
⚠️ 需更新 |
新增套餐、校本课程包 |
| 13 |
数据模型与API设计 |
❌ 已过时 |
需按新结构重构 |
| 15 |
课程发布流程完善方案 |
⚠️ 需更新 |
状态流转逻辑保留，但需适配套餐 |
| 16 |
教学环节资源关联设计 |
⚠️ 需更新 |
适配新的课程/环节结构 |
| 99 |
决策记录 |
✅ 有效 |
历次讨论结论和待办清单 |
文档状态说明
| 标记 |
说明 |
| 🆕 最新 |
最新文档，优先参考 |
| ✅ 有效 |
文档内容仍然有效 |
| ⚠️ 需更新 |
部分内容需要更新 |
| ❌ 已过时 |
文档已被新文档替代，仅供参考 |
🚀 下一步行动
当前重点
| 优先级 |
任务 |
状态 |
| 🔴 P0 |
设计重构 - 超管端（套餐管理、课程包管理） |
✅ 完成 |
| 🔴 P0 |
设计重构 - 教师端（适配新结构） |
✅ 完成 |
| 🔴 P0 |
设计重构 - 学校端（套餐、校本课程包） |
✅ 完成 |
| 🟡 P1 |
数据模型重构 |
✅ 完成 |
| 🟡 P1 |
后端API重构 |
✅ 完成 |
| 🟡 P1 |
前端界面开发 |
✅ 完成 |
| 🟢 P2 |
课程包7步流程重构 |
✅ 完成（2026-02-27） |
| 🟢 P2 |
Bug修复（10个） |
✅ 完成（2026-02-27） |
| 🟢 P2 |
学校端新功能开发 |
✅ 完成（2026-02-27 晚） |
| 🟢 P3 |
教师端重构 Phase 1-6 |
✅ 完成（2026-03-11） |
| 🟢 P3 |
PDF查看器增强（PDF.js） |
✅ 完成（2026-03-11） |
| 🟢 P3 |
展播模式优化 |
✅ 完成（2026-03-11） |
| 🟢 P3 |
自动化测试（60个用例） |
✅ 完成（2026-03-11） |
| ⬜ P4 |
上线部署 |
待开始 |
| ⬜ P4 |
TypeScript编译警告修复 |
待开始 |
📞 联系方式
如有问题或需要进一步讨论，请联系项目组。
文档版本：v2.3
最后更新：2026-03-11
e87e2dde00