哈基米噢南北绿豆-冲刺总结

作业所属课程 https://edu.cnblogs.com/campus/fzu/202501SoftwareEngineering/
作业要求 https://edu.cnblogs.com/campus/fzu/202501SoftwareEngineering/homework/14586
作业的目标 通过真实调研理解用户需求，结合智能体构思开发一款软件，并进行答辩、展示，撰写博客
团队名称 哈基米噢南北绿豆
团队成员学号-名字 102301111-周韩煜、102301112-郑隆熙、102301118-许竣阳、102301126-苏郑熙凡、102301129彭志成、102301135-李文伟、102301143-曾义山、102301243-陈文嘉，102301428-刘佳、102301517-肖垲、102301540-陈昌昊、102301543-鲍晓鹏

1. 冲刺目标达成情况

本次Alpha冲刺的核心目标是交付智能学习助手，实现"登录→AI对话→文件处理→历史管理"完整闭环。经过团队14天的密集开发，我们已基本完成冲刺计划中的核心功能改进，实现了可演示的基础场景闭环。

✅ 已实现的改进项

  • 完整业务闭环：实现了用户登录注册、AI流式对话、文件/图片上传、对话历史管理等核心功能链

  • MCP框架落地：成功部署MCP host与server集群，实现AI工具调用（代码运行、HTML生成）

  • 可视化能力突破：前端支持Plotly.js、ECharts等库动态渲染，实现对话中实时生成交互式图表

  • 工程化基建：完成微服务架构搭建、Docker容器化部署、Git Flow规范实施

  • 前后端联调：完成SSE流式传输对接，API文档自动生成，实现5+核心接口联调

⚠️ 未完成的计划项

根据任务表显示，后端任务HD007(todo增删改查)、HD008(课程表获取)、HD009(对话历史分页与minio) 在Alpha阶段未启动，属于明确的需求裁剪。此外，前端课程表与智能代办模块设计（QD006）仅完成设计未完全实现。

不过在本次冲刺中，我们实现了冲刺计划中高优先级（P0/P1）的核心改进，低优先级功能按计划延期，符合敏捷开发的"精益交付"原则。

2. 项目亮点

2.1 技术创新亮点

MCP框架深度落地：率先将MCP（Model Context Protocol）框架应用于教育场景，实现AI的"工具使用能力"。通过consul服务发现与工厂模式，支持多server热更新与功能解耦，为工程化扩展奠定基础。

可视化架构设计：首创<htmath>标签方案，在sandboxed iframe中安全渲染HTML/可视化内容。通过流式识别标签闭合状态，实现"加载-渲染"无缝体验，平衡了安全性与交互性。

全栈响应式体验：前端实现黑白简约主题系统，支持自动/手动切换；后端基于Hertz框架实现高性能SSE流式推送，端到端延迟<500ms。

2.2 工程实践亮点

微服务整洁架构：后端采用go-clean-architecture分层设计，通过viper管理配置、zap统一管理日志，代码 review 覆盖率100%，接口文档自动生成。

前后端协同效率：11月20日完成接口冻结，通过Mock数据并行开发；建立"每日站会+分组周会"机制，阻塞问题平均解决时间<4小时。

用户体验优化：支持localStorage本地会话持久化、消息导出为单页HTML、可视化库离线缓存等细节功能，体现产品思维。

2.3 团队管理亮点

自组织跨职能协作：前端5人+后端5人打破职能壁垒，Scrum Master每日移除障碍，Product Owner实时验收标准，体现真正的敏捷实践。

知识共享文化：形成"西二教程+结对指导"学习模式，后端新人平均上手时间缩短至3天，前端组件复用率达80%。

3. 项目不足与改进方向

td {white-space:nowrap;border:0.5pt solid #dee0e3;font-size:10pt;font-style:normal;font-weight:normal;vertical-align:middle;word-break:normal;word-wrap:normal;}
不足维度 具体问题 影响程度 改进措施
功能完整性 Todo、课程表、历史分页功能未开发 高 Beta冲刺启动后立即评估优先级，补充人力或裁剪需求
联调充分性 仅有2个页面完成真机演示，接口联调时间不足 中 增加自动化测试覆盖率（目标>70%），引入API契约测试工具
性能表现 文件上传未做大小限制，AI响应偶现超时 中 实现MinIO分片上传，增加AI调用降级策略（缓存+本地模型）
文档完善度 部分组件缺少JSDoc/GoDoc注释，新人上手成本较高 中 建立文档即代码规范，每次提交必须更新对应API文档
风险管理 R004风险（HD007-HD009未排期）实际发生，应对滞后 高 需求评审会必须输出风险登记册，Scrum Master每日跟踪TOP3风险

根本原因分析：

  • 技术债积累：为保MVP交付，部分代码未严格遵守DRY原则（如SSE处理逻辑前后端各有实现）

  • 缓冲时间不足：冲刺计划预留缓冲2天，但AI搜索复杂度超预期，导致后续任务链后移

  • 跨组沟通损耗：前后端对接时发现3次字段命名不一致，反映接口契约评审不充分

4. 团队成员贡献与体会

4.1 工作量分布

td {white-space:nowrap;border:0.5pt solid #dee0e3;font-size:10pt;font-style:normal;font-weight:normal;vertical-align:middle;word-break:normal;word-wrap:normal;}
姓名 学号 冲刺任务 核心贡献 工作量占比 个人体会关键词
肖垲 102301517 后端基建、Docker部署、consul封装 微服务架构设计与实现，主导技术选型 14% 工程化、MCP协议、consul二次封装
郑隆熙 102301112 项目管理、前端动画、博客撰写 Scrum Master职责，推动3次关键决策会议 12% 组织能力、Vue入门、团队运营
苏郑熙凡 102301126 前端架构、API对接、文档编写 主导Vue框架搭建，实现SSE与AI对接 12% SSE对接、前端深化、团队协作
鲍晓鹏 102301543 代码运行组件、MCP机制探索 实现codeRunTool前端交互，可视化组件调优 9% MCP原理、组件开发、实战经验
周韩煜 102301111 可视化组件、课程表设计、vlog剪辑 完成Plotly/ECharts组件封装 7% 前端入门、可视化、团队指导
许竣阳 102301118 登录注册流程、client统一入口 打通用户认证与初始化逻辑 7% Go语言、沟通协作、实践出真知
曾义山 102301143 SSE流式对话、OpenAI兼容、冲刺计划撰写 实现后端SSE核心逻辑与API适配 7% Go入门、SSE技术、成就感
彭志成 102301129 AI搜索配置、流式对话、冲刺总结撰写 实现AI联网搜索功能与配置模块 7% Go实践、并发编程、团队合作
刘佳 102301428 渲染流程调优、历史模块 优化htmath标签解析，提升渲染性能30% 7% 前端入门、渲染优化、团队协作
陈昌昊 102301540 codeRunTool后端实现、PPT制作 开发devCodeRunTool三个函数 6% Go特性、工具链、独立解决问题
陈文嘉 102301243 aiSEsolverTool、AI总结、PPT制作 实现科学工程求解工具与AI总结 6% MCP框架、Prompt工程、工程化思维
李文伟 102301135 SSE流显示优化、消息导出 实现流式消息平滑滚动与导出功能 6% 交互开发、Vue进阶、学习曲线

4.2 成员过程体会摘要

前端组感悟

  • 苏郑熙凡：作为前端负责人，深入理解了SSE与AI对接的挑战，iframe缓存管理与localStorage持久化设计成为关键突破点。团队协作中，"前后端的紧密配合让架构设计从理论走向落地"。

  • 郑隆熙：作为团队负责人，我积极制定任务计划，并按时进行推进，这个过程让我感受到敏捷开发的价值；不仅如此，我从HTML/CSS基础到Vue项目实战，"编程是思想与逻辑的共舞"。作为组长，深刻体会到"团队不是强者独行，而是群星共耀"，组织能力与工程能力双提升。

  • 刘佳：初识Vue框架如"登山者初见雪岭"，在成员指导下完成渲染优化，感悟到"大道至简，繁在枝末"，坚定了从前端新兵到核心贡献者的成长路径。

  • 李文伟：对前端开发有了较全面的了解。在协作项目中深刻领悟到，团队开发绝非个体简单叠加，高效沟通、规范协作与责任共担才是攻克复杂需求的关键，这也让我更注重自身专业能力与协作素养的双重提升。

  • 周韩煜：在前端知识学习的基础上，通过组长指导以及与小组成员沟通快速掌握可视化组件开发，实现了理论知识到实战经验的转化，认识到了团队协作对于前端开发的重要性。

  • 鲍晓鹏：通过实现AI对话的核心渲染组件，获得了Markdown高效流式渲染经验，同时完善可视化组件封装对异步注入微前端的实践也有了更深的认识。

后端组感悟··

  • 肖垲：对MCP使用场景与StreamableHTTP协议有了工程级理解，consul二次封装解决了服务发现痛点，认识到"架构设计需平衡扩展性与性能"。

  • 许竣阳：在使用go语言实现后端的登陆注册流程和client统一入口的过程中，我体会到"官方工具链的简洁高效"，并且深刻地认识到"计算机是一门实践的学科"，深刻地理解了后端各个层要实现的功能，代码能力得到了较大提升，对后端的组成结构有了更深刻的理解。

  • 曾义山：作为Go初学者，在队友帮助下实现SSE与OpenAI兼容，"将理论转化为可运行代码的成就感无与伦比"，锻炼了独立解决实际问题的能力。

  • 彭志成：首次实战Go语言，"goroutine和channel处理多任务特别顺手"，在SSE实现中深化了对并发编程的理解，同时通过对于本次冲刺的总结，我也感受到了团队融洽的交流氛围。

  • 陈昌昊：负责codeRunTool模块，深入理解Go高并发特性与Hertz框架，"独立解决问题的能力在调试中得到显著提升"，认识到系统设计中扩展性与用户体验的平衡艺术。

  • 陈文嘉：快速掌握MCP框架与Go AI集成，"认识到工程化中平衡简洁与扩展性的重要性"，体会到多人协作与单人作业的本质差异，体会到后端的“八荣八耻”，认识到写代码时应明确应用场景。

5. 冲刺计划链接与资产

冲刺计划文档：Alpha冲刺计划完整版已归档至飞书知识库 🔗 链接：哈基米噢南北绿豆-冲刺计划

🔗 答辩ppt：Alpha冲刺

6. 后续规划与建议

6.1 短期内目标

  1. 功能补全：优先实现Todo管理、课程表集成、历史分页三大缺失模块

  2. 体验升级：

    1. 前端：增加动画过渡效果，优化移动端抽屉交互

    2. 后端：实现AI响应缓存机制，P95延迟降低至1s内

  3. 质量保障：补充单元测试（覆盖率>70%）、E2E测试，建立CI/CD流水线

6.2 长期愿景

根据调研报告，78%学生最需要概率统计可视化，61%需要物理学科支持。因此：

  • 学科扩展：新增物理力学、电路分析、算法可视化等学科模板

  • 智能进化：探索"代码编译纠错"与"智能日程提醒"的MCP tool实现

  • 产品化准备：申请域名与SSL证书，部署生产环境，准备用户内测

6.3 流程改进

  • 需求评审强化：每个Story必须附带"风险等级"与"缓冲时间"评估

  • 技术债治理：每冲刺预留20%时间重构，建立技术债看板

  • 知识沉淀：将成员心得整理为《哈基米南北绿豆开发手册》，降低新人门槛

7. 总结

本次Alpha冲刺，哈基米噢南北绿豆团队以14天的极致效率，完成了从0到1的智能学习助手MVP交付。我们不仅实现了计划中的核心闭环，更在MCP框架落地、可视化架构、工程化实践三方面取得超出预期的突破。尽管存在功能裁剪与联调充分性不足的问题，但团队展现了强大的自组织能力与敏捷实践素养。

正如成员刘佳所言："我们所构建的，不仅是一个智能的学习助手，更是一个理想团队的蓝图——在这里，高效与和谐并存，个人与集体共荣。" 这，或许是我们本次冲刺最大的成果。

posted @ 2025-12-01 21:20  REREREGO  阅读(4)  评论(0)    收藏  举报