tonytech/kindergarten_java
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2f5ad32820
kindergarten_java/docs/design/README.md

400 lines
16 KiB
Markdown
Raw Normal View History

提交说明
2026-02-28 16:41:39 +08:00
# 幼儿阅读教学服务平台 - 项目总览
> 更新时间：2026-02-27
> 项目状态：需求重构中 - 课程包与套餐结构重构
---
## ⚠️ 重要变更通知（2026-02-27）
本项目正在进行**课程包与套餐结构重构**，涉及较大幅度的需求变更。请优先阅读以下新文档：
| 文档 | 说明 |
|-----|------|
| **[17-课程包套餐重构需求.md](./17-课程包套餐重构需求.md)** | 最新需求文档，包含完整的重构需求 |
**核心变更点：**
- 新增"课程套餐"概念（授权/计费单位）
- 课程包结构重构（从单次课程变为教学单元）
- 新增"校本课程包"功能
- 授权方式变更（从按课程包授权变为按套餐授权）
---
## 📋 项目简介
**幼儿阅读教学服务平台**是一个面向幼儿园的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** | **数据模型重构设计** | 🆕 **最新** | 新增表设计、重构表设计、迁移方案 |
| 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 | 课程包6步流程重构 | ✅ 完成（2026-02-27） |
| 🟢 P2 | Bug修复（10个） | ✅ 完成（2026-02-27） |
| 🟢 P2 | 学校端新功能开发 | ✅ 完成（2026-02-27 晚） |
| ⬜ P3 | 上线部署 | 待开始 |
| ⬜ P3 | TypeScript编译警告修复 | 待开始 |
---
## 📞 联系方式
如有问题或需要进一步讨论，请联系项目组。
---
**文档版本：v2.2**
**最后更新：2026-02-27 23:00**
Reference in New Issue Copy Permalink