寻宝小分队——冲刺总结随笔

[寻宝小分队]

这个作业属于哪个课程	202501福大-软件工程实践-W班
这个作业要求在哪里	团队作业——站立式会议+α冲刺
这个作业的目标	记录冲刺随笔
其他参考文献

目录

• 1. 项目预期计划、现实进展
• 1）前端：
• 2）后端：
• 3）测试
• 成员心得体会和分工
• 2.1各成员在冲刺阶段的收获和心得体会
• 2.2组员分工协作情况、在alpha阶段的工作量比例
• 3.对下阶段的展望
• 1、前端：
• 2、后端：
• AI技术员
• 4.1回顾AI技术员在整个冲刺过程中的表现、分析其贡献
• 4.2下一阶段如何更好地利用AI

1. 项目预期计划、现实进展

1）前端：

a.项目预期：基础项目搭建、卡法登录页面、开发学生材料上传页面、开发学生积分查看模块、开发学生申诉页面、辅导员端信息审核页面、辅导员端查看申诉页面、辅导员端处理申诉页面、前后端联调
b.现实进展：页面基本实现，部分按钮功能还未实现，前后端联调还未实现

前端项目代码仓库地址：https://github.com/shubin45410292/competitionscoring-main

2）后端：

a.项目预期：用户登录接口、赛事信息提取接口、积分自动计算接口、辅导员审核接口、辅导员审核申诉接口、赛事规则配置接口
b.现实进展：完成了用户登录接口、赛事信息提取接口、积分自动计算接口已完成，辅导员审核接口、辅导员审核申诉接口、管理员端查询学院专业接口，赛事规则配置接口部分完成
c.项目进展未达预期的总结与反思：在写辅导员审核接口的时候忽然想到权限问题，即不是每个辅导员都有资格去审核一个学生的材料，应该在实现辅导员接口前先考虑权限问题并实现权限接口。考虑到权限接口后，就还有一个问题，如果有辅导员A、B可以去审核专业C的学生的材料，会有并发问题，审核的时候得业务得加锁。业务实际比一开始的计划复杂得多，业务顺序也要改变，导致辅导员接口部分几乎搁置

（核心代码截图）

（部分单元测试结果截图）
后端项目代码地址：https://vcn9ra8gf7nh.feishu.cn/wiki/YqyiwmJJYidBpYkivSHcverKnwc

3）测试

成员心得体会和分工

2.1各成员在冲刺阶段的收获和心得体会

102300301陈珞瑶
收获与心得体会：在团队协作中参与比赛材料上传接口的开发与优化，加深了对Go语言文件处理逻辑的掌握，学会了结合团队整体技术方案（如统一的对象存储策略、错误码规范）推进模块开发，也在与组员的联调配合中提升了跨模块沟通效率。团队开发中，接口不仅要实现功能，更要融入整体技术框架，协作中的规则对齐与及时同步比单独追求 “完美实现” 更重要。

102300305刘静芸
在参与项目的过程中，从创建初始数据库时梳理学院赛事数据关联，到开发管理员端学院专业查询接口时优化表结构与业务逻辑的映射，让我对数据链路有了清晰认知，也更了解Go的框架和整个项目业务的逻辑。根据开发实际调整原型设计，深刻体会到理论设计与落地实践的差距，也提升了灵活应变能力。辅助博客撰写和 PPT 制作，则让我学会从全局视角梳理项目价值，团队协作中更懂跨环节沟通的重要性，对项目全流程协作有了更立体的理解。

102300104李冬仙
在项目的冲刺阶段，我主要完成了比赛评分系统的整体打磨与功能拓展。
这一阶段的重点工作包括：环境优化、管理员端界面的实现、系统稳定性调试，以及项目代码的整合与版本管理。
首先，在环境搭建上，我重新配置了 Android SDK、Gradle、以及 Flutter 工具链，确保项目在本地与模拟器环境中都能顺利运行。中途遇到过路径冲突、依赖下载缓慢、Gradle Daemon 崩溃等问题，但通过修改 SDK 目录、切换国内镜像源、分析日志逐步解决。这部分让我意识到，环境调试的耐心与细致程度，直接决定开发进度的稳定性。
其次，在功能开发上，我新增并完善了多个核心页面，包括：登录、注册与忘记密码页；学生端主页、成绩详情页、申诉页与上传页；教师端主页与成绩管理页；管理员端主页。这些模块的实现让系统在功能上更加完整，界面风格也趋于统一。通过对比设计图，我在 Flutter 布局上对字体层级、图标比例、间距分配做了精细化调整，从最初的原型页面逐步进化到接近真实应用的 UI 成品。这让我更深刻地理解了 Flutter 在跨端开发中的高效与灵活，也提高了我对界面美学与逻辑结构的把握能力。
最后，在项目管理与协作上，我完成了本地仓库与 GitHub 的同步工作，掌握了从 git add、commit 到 push 的完整流程，能够独立提交模块化更新并维护项目版本。这部分训练了我在团队协作中使用版本控制的能力，也为后续团队分工与项目合并打下了基础。总体而言，这一阶段的开发让我更加熟悉 Flutter 的组件化思维与状态管理逻辑，也锻炼了独立排错、调试和自我学习的能力。从代码实现到版本管理的整个闭环，让我对软件工程项目的完整开发周期有了更全面的认识。

102300205吴诗涵
收获与心得体会：
1.对项目整体架构的理解加深： 通过测试每一个接口，我被动地熟悉了整个项目的业务流和数据流。我清楚地知道哪个功能模块依赖于哪个接口，一个接口的变动可能会在何处引发“蝴蝶效应”。这种全局视角让我在发现Bug时，能更精准地描述问题，并与开发同学高效沟通，共同定位根源，而不是简单地抛出“这个接口错了”。
2.工具赋能与流程规范的重要性： Apifox这样的工具极大地提升了我的效率。利用它的环境变量、自动化测试和团队协作功能，我为我们组建立了一套可回归的测试用例集。这让我认识到，规范的测试流程和合适的工具，是保证项目在快速迭代中质量不滑坡的基石。

102300217 梁伟彬
收获与心得体会：此次开发让我认识到，业务理解是前提，技术实现是手段，而数据逻辑是系统的灵魂。后续将进一步优化接口性能，例如通过缓存高频查询的赛事规则与用户信息，减少数据库压力；同时，针对赛事信息识别的准确率提升，计划引入多模型对比机制，让 AI 提取的结果更贴合实际业务需求。通过持续迭代，让系统在功能完整性与运行稳定性上不断提升，更好地服务于赛事管理与积分核算的业务场景。

102300220 张宇亮
在开发登录登出、赛事材料上传接口及辅助完成积分查询接口的过程中，我对系统用户认证与数据交互逻辑有了更深入的理解。登录登出接口的实现，让我熟练掌握了 Token 生成与验证机制，通过处理用户身份校验、会话管理等细节，强化了对系统安全性的考量。
赛事材料上传接口开发时，结合数据库中赛事与专业的关联关系，需兼顾文件格式校验、存储路径设计及与后续信息提取流程的衔接，让我体会到接口设计需贯穿业务全链路。
辅助积分查询接口时，通过关联integral_results表与赛事、用户信息表，理解了多表联查在数据聚合中的关键作用，也意识到索引优化对查询效率的重要性。
整体开发让我更注重接口的健壮性与用户体验，比如处理异常登录、文件上传失败等场景，同时深刻认识到团队协作中接口文档规范与前后端交互逻辑对齐的必要性，为后续功能迭代打下了扎实基础。

102300332 叶远涛
收获:在冲刺这段时间里不断提升自己的技术学到新的知识，感觉很充实
心得:在遇到问题的时候要耐心寻找解决方法，只要慢慢改进就能解决问题

102300407 黎淑平
一、阶段收获
在前端冲刺阶段，我对整个前端开发流程有了更完整的认识。从最初的界面原型，到组件布局、状态管理、数据交互的实现，我逐渐掌握了从“页面展示”到“逻辑联动”的关键思维。在开发界面时将设计与功能结合：分页、筛选、搜索等功能实现，让我学会了用代码去表达用户的使用习惯；也体会到界面层次、配色风格、按钮响应等细节对用户体验的重要性。整个过程让我从“写出能跑的页面”提升到“构建可靠的用户交互”的层面。
二、心得体会
这次冲刺让我明白，前端开发并不仅是视觉层的实现，更是用户与系统沟通的桥梁。这一阶段的学习与实践更让我更清晰地认识到前端开发的价值所在，也激发了我继续深入探索这一领域的动力。

222100112 陈俊南
收获：在α冲刺阶段，我不断和组员沟通交流，很大提升了我的团队协作能力和配合，同时在完成项目的过程中学习到了很多新技术，也对ai工具有了进一步的认识。
心得体会：这次作业让我意识到一个大型项目需要团队密切的合作和坚定的信念，同时遇到问题也需要自己解决，耐心寻找办法。

2.2组员分工协作情况、在alpha阶段的工作量比例

学号姓名	任务	贡献度
102300301陈珞瑶	辅助完成赛事材料上传接口、完成ppt	8
102300305刘静芸	辅助完成博客、创建初始数据库、完成管理员端查询学院专业接口、根据开发中实际遇到问题修改原型设计、辅助完成ppt	12.5
102300104李东仙	完成辅导员端界面与管理员登录界面	9
102300205吴诗涵	评审表、接口测试、完成测试随笔	9.5
102300217 梁伟彬	完成赛事材料识别、积分计算接口、积分查询接口、用户信息查询接口	15.5
102300220 张宇亮	完成登录登出、赛事材料上传接口，辅助完成积分查询接口	14
102300332 叶远涛	完成注册页面与学生界面、上台答辩	9
102300407 黎淑平	完成忘记密码界面与主要登录界面和框架、统一管理仓库、辅助完成辅导员端与学生端	13.5
222100112 陈俊南	完成博客、跟踪成员进度	8.5

3.对下阶段的展望

1、前端：

对接后方端口实现详细内部分局与内部实际内容

2、后端：

1）完善alpha冲刺中未实现的接口
a.实现管理员对各角色的权限分配
b.如果有辅导员A、B可以去审核专业C的学生的材料，会有并发问题，解决辅导员在审核学生材料时会出现的并发问题，增加系统安全性可靠性
2）完善管理员端的接口设计
3）完成管理员端的接口代码实现
4）实现部分优化
a.在查询奖项认定信息里实现联合查询，即可以选择多个关键字进行查询
b.在新建认定奖项时，做一个上传xls文件，实现奖项自动插入

AI技术员

4.1回顾AI技术员在整个冲刺过程中的表现、分析其贡献

1、前端部分：
1）在学生积分界面的开发过程中，AI 工具主要用于界面逻辑设计与数据交互优化。
2）通过自然语言生成辅助编写 Flutter UI 代码、分页逻辑与筛选栏组件；同时借助 AI 自动生成假数据用于前端调试，大大提升了迭代效率。
3）导员查看积分界面部分，AI 协助团队构建了数据表展示逻辑与分页控制方案，使教师能直观地查看学生成绩与积分汇总。
4）AI 的加入显著提升了代码编写速度、逻辑一致性与界面统一性。

2、后端部分：
1）赋能核心业务：实现了通过 AI 模型自动从图片中提取竞赛信息的功能，这一功能是后端处理竞赛相关业务的重要环节，能够减少人工输入的工作量，提高信息处理的效率和准确性，为整个系统的竞赛信息管理提供了有力支持。
2）技术基础构建：编写的 AI 调用相关代码为后续可能的其他 AI 功能扩展奠定了基础，提供了可参考的模式和方法。
3）提升系统智能化水平：引入 AI 模型处理图片信息，使系统具备了一定的智能化处理能力，增强了系统的竞争力和实用性。

3、测试部分：
1）测试用例生成器： 当我对一个复杂的业务接口感到无从下手时，我会将接口文档丢给AI，它可以迅速为我生成一系列涵盖正常、边界和异常场景的测试用例，极大地拓展了我的测试思路，避免了遗漏。
2）Bug分析助手： 当遇到一个难以理解的错误响应时，我会将错误日志和相关代码片段提供给AI。它能够帮我分析可能的成因，例如“这个空指针异常可能是因为在某个条件下，对象没有被正确初始化”，为我定位问题提供了关键方向。

4.2下一阶段如何更好地利用AI

1、前端部分：
下一步可以更深入地将 AI 融入：
数据分析层面：让 AI 协助分析学生积分分布、生成智能统计图或异常提醒；
代码协同层面：用 AI 做自动代码审查，发现冗余逻辑和潜在漏洞。

2、后端部分：
下一步可以拓展AI的使用：
1）自动分类与标签生成：基于提取的赛事信息（event_name、event_organizer等），通过 AI 模型自动为赛事打上分类标签（如 “学科竞赛”“商业赛事”），并关联至event_level字段，辅助后续的统计分析和筛选。
2）赛事数据统计与趋势分析：利用 AI 对系统中的Event数据进行聚合分析，生成可视化报表（如各学院赛事参与率、获奖等级分布、年度赛事趋势等），为管理员提供决策参考

3、测试部分：
下一阶段：尝试将其更深度的集成到工作流中。例如，探索能否将AI与我们的CI/CD流程结合，让AI自动分析代码提交，并建议可能需要重点测试的模块。