starecho产品系统Vibe Coding

StarEcho（星聆湾）立项的核心原因是：特殊儿童音乐教育领域缺乏专门为一线教师设计的数字化工具。 现有特教管理软件要么是通用型 CRM（无法适配音乐教学的独特流程），要么是医疗化的评估系统（语言和视角与教育脱节）。特教音乐教师每天需要记录课堂观察、跟踪 IEP（个别化教育计划）目标进展、与家长沟通、备课找曲目——这些工作完全依赖纸笔或零散的工具，没有统一的数字化平台支撑。

该产品旨在解决以下问题：

1.特教音乐教师没有专门的课堂记录和教学管理工具
2.家校沟通缺乏及时、结构化的渠道（教师课堂记录 → 家长查看反馈 → 教师审阅的闭环断裂）
3.IEP 目标制定→跟踪→评估的全流程数字化缺失
4.曲目管理和 AI 辅助备课能力缺失
5.机构管理者和平台管理者无法获得多维度的数据看板和预警
6.行业场景与业务背景

产品面向特殊儿童音乐教育垂直领域。使用者有四类角色：平台管理员（系统运营）、机构管理员（机构内管理）、特教音乐教师（核心使用者）、家长（家校互动参与者）。系统围绕"五大闭环"构建：家校互动（教师课堂记录→家长反馈→教师审阅）、成长追踪（IEP 制定→目标跟踪→量表评估→综合报告）、课堂音乐（曲目管理→课堂记录→情绪追踪→AI 推荐）、数据分析（多维采集→仪表盘→预警→干预决策）、学生管理（档案→记录→偏好→个性化教学）。

品牌定位强调"不宣称疗效、不替代诊断、不定义孩子"，以音乐为媒介，以教师为决策主体，AI 为辅助工具而非主导者。视觉和语言风格追求安静、温暖、克制。

教师端（25 页）： 首页今日概览、学生管理（CRUD + 综合档案）、AI 教案生成（异步任务 + Word 下载）、课堂管理（7 步音乐活动录制 + 曲目库 + AI 三层策略推荐曲目）、成长追踪（IEP 制定→目标跟踪→雷达图→综合报告）、家校互动（内容审查 + 训练 + 留言 + 考勤）、教学分析（仪表盘 + 趋势 + 预警 + 全局搜索 + 导出）。

家长端（19 页）： 今日活动聚合（课堂/训练/考勤/通知）、家校互动（声音日记/绘本查看+反馈、训练任务完成、观察记录提交、留言）、成长追踪（IEP 只读 + 评估量表 + 时间线）。

机构管理端（21 页）： 首页概览、教师/学员/班级管理、考勤、评估量表、干预审批、曲目库、邀请、公告、档案、预警、隐私设置。

平台管理端（11 页）： 全平台统计、机构审核、用户管理、内容审核、系统监控、开放平台 API、数据大盘、日志、社区审核。

五大闭环：
1.家校互动（课堂记录→绘本/日记→家长反馈→教师审阅→回流档案）
2.成长追踪（IEP→目标→评估→报告→归档）
3.课堂音乐（曲目→AI推荐→录制→情绪数据→趋势分析）
4.数据分析（多维采集→仪表盘→预警→决策）
5.学生管理（建档→分组→记录→偏好→个性化）。

负责内容： 后端 43 个 API 模块（284 路由）、前端四端 SPA（93 页面 + 30 组件 + 3 布局）、设计体系全链路落地（品牌文档→CSS 变量→Tailwind→JS Token）、Docker 部署（Nginx + Gunicorn + PostgreSQL + Redis + MinIO）、阿里云 ECS 运维、CI/CD 流水线、19 个数据库迁移脚本。

技术栈： React 18 + TypeScript 5（strict） + Vite 5 + Tailwind 3 + React Router 6 + TanStack Query 5 + Zustand 4 + recharts / Flask 3 + SQLAlchemy 2 + PostgreSQL 16 + Gunicorn + Redis 7 / DeepSeek API / 阿里云 ECS + Nginx + Docker Compose。

架构亮点与难点：

五仓库解耦：web（前端 SPA）、api（REST 后端）、infra（基础设施/CI）、miniapp（小程序）、harmony（鸿蒙端），职责清晰
设计令牌全链路：单一信源 design-tokens.json → CSS 变量 + Tailwind + JS 常量，~83 个变量覆盖颜色/字体/间距/阴影/动效
四端角色隔离：AppShell + 路由前缀 + 权限守卫，各端独立路由和侧边栏
生产级 API 客户端：JWT 自动刷新（提前 120s + 防并发锁）、请求去重、AbortController、在线检测
五大闭环验证：CI 中编排 5 个闭环验证脚本，一键验证端到端流程
核心技术难点：家校互动双向数据流一致性、AI 教案异步编排（DeepSeek + 轮询 + Word 生成）、四端灵活权限模型。