洋芋教育平台是一家面向少儿编程教育机构的端到端SaaS解决方案,通过"Web管理后台 + 微信小程序家长/学生端 + Java微服务后端 + OnlyOffice文档协作 + 本地Ollama大模型AI智能点评"的完整产品矩阵,帮助机构实现从招生、排课、教学到课后反馈的全流程数字化升级,同时为家长提供透明可视化的孩子成长档案,沉淀学员活跃度,提升续费率与口碑传播。
一、课程与教学管理:多机构隔离的课程体系,支持平台共享课程与机构自建课程并行;章节内容上传(图文混排课件、Word/PDF/.cpp源码附件);OnlyOffice Document Server集成,实现课件在线预览与协作编辑;排课系统按班级/教师/教室三维度智能组织课表。
二、题库与作业系统:1142道C++等级考试真题入库,支持题干图片自动提取转代码文本(基于VLM本地视觉模型qwen2.5vl:3b识别);四维评分表格(思维逻辑/协作沟通/创新创意/专注力);AI智能点评根据课堂表现自动生成评语,智能回填到未手动打分的维度,仅覆盖未打分项;答案解析支持图文混排(RichEditor富文本编辑器)。
三、家长与学生端:家长微信小程序查看课表、孩子作业、成长档案、AI点评结果;学生在线做题、查看反馈、参与社区互动;社区功能支持作品发布(Scratch/Python/C++)、点赞收藏、评论互动、开源代码分享,封面图后端previewUrl为null时自动降级拼接流式地址。
四、用户与机构管理:多机构多角色RBAC权限(超管/机构管理员/教师/家长/学员);机构绑定学员、班级分组、教师档案、订单与课消记录;用户管理详情支持学员绑定;首页门户公开访问,"我的"页面仅做登录交互不强制token校验,终端用户端暂隐藏学员绑定入口。
五、系统支撑与合规:首页内容无需登录可访问;登录态JWT双密钥机制(超管静态密钥写死yml + 普通账号动态密钥共享文件0600权限);CORS白名单生产域名根治(显式加www.yangyuedu.cn/yangyuedu.cn);微信小程序已上线运行,生产域名 https://www.yangyuedu.cn , 完成ICP备案(鄂ICP备2026052644号)与服务类目(教育服务→课程销售)配置。
任务清单:
1. Web管理后台(Vue3+Vite+Pinia+Element-Plus),覆盖课程/题库/用户/订单/社区等模块;
2. 微信小程序原生开发(家长+学生端),含社区、课表、AI点评、成长档案;
3. Spring Boot后端三服务微服务(system/business/internal);
4. MongoDB GridFS存题库图片与社区封面;
5. OnlyOffice Document Server课件在线预览与协作编辑;
6. 本地Ollama大模型(qwen2.5:3b)AI智能点评,完全离线;
7. 阿里云ECS生产部署(Docker+Nginx+HTTPS)。
技术栈:Vue3/Vite/Pinia/Element-Plus;原生WXML/WXSS;Spring Boot+MyBatis-Plus+JWT;MySQL/MariaDB+MongoDB GridFS;OnlyOffice;Ollama;Docker+Nginx。
实现难点:
1. WXSS不支持中文类名、var()、inset、gap、transition等CSS特性;
2. 雪花ID精度:JS number默认int32致大ID精度丢失,前后端统一string传递;
3. OnlyOffice白屏:hideAllToasts误用祖先textContent匹配关键词致编辑器被display:none,需限定叶子节点;
4. 1Mbps窄带宽:文档key须稳定(fileId_size的SHA256)避免重复转换;
5. JWT双密钥:超管静态密钥+普通账号动态密钥共存,冒充superAdmin的token会被密钥类型不匹配拒绝;
6. 课程多机构隔离:读写统一rootOrgId,跨机构操作返回明确403,平台课程显示只读角标;
7. CORS根治:nginx /biz/a