软工实践总结 052301103

绽放🌟

选择这个标题既契合了我们团队项目"植悟APP"的植物养护主题，又完美契合了我这一学期的成长轨迹——从最初迷茫的小白，到在团队协作中逐渐找到方向，最终在后端开发领域绽放光彩。它既包含了技术能力的绽放，也蕴含着团队合作中每个成员独特价值的绽放，更预示着未来职业道路上无限可能的绽放。

一、学期回顾📚

1.1 回顾对于软件工程课程的想象💭

通过参与植悟APP 的后端开发，我对自己在这门课中的学习目标有了更清晰的回顾。在上这门课之前，我的核心目标和期待非常明确：一是系统学习后端和前端开发的基础知识，摆脱纯理论状态；二是通过一个完整的项目来显著提升自己的代码量，在实践中成长；三是学会使用GitHub 进行版本控制和团队协作。回顾整个过程，我可以肯定地说，这些基础目标已经基本达成。✅

在知识学习方面，我学习了FastAPI 框架并成功搭建了部分后端服务，完成了与AI 模型接口的对接、用户请求的处理以及数据库的交互。为了与前端交互，我学习了基础的HTML、CSS 语法和JSON 数据格式。这个过程让我真正体会到了从需求分析、接口设计到编码实现、联调测试的完整软件工程流程，对“客户端-服务端”的协作模式有了直观认识，这远远超出了我最初仅仅“学些知识”的期待。当API 接口被成功调用、数据在前后端间流畅传输时，我获得了极大的成就感，这完全符合我最初对工程实践的期待。🎯

在提升代码量方面，这个项目为我提供了绝佳的实践机会。从零开始构建一个功能模块，意味着我需要编写大量的业务逻辑、数据模型和接口代码，这让我对Python 的运用更熟练了，代码量和信心都得到了实质性的提升。💪

在工具使用上，我成功地将GitHub 融入到了开发流程中。从最初的克隆仓库、提交代码、推送更新，到处理分支，我真实地体验了版本控制工具在团队项目中的重要性。🔧

同时，我也深刻认识到了团队协作的重要性。原型设计、前端设计、Vlog 制作、PPT制作，我们合理分工，互相配合，PM 也发挥强大的领导能力，合理安排每一次的分工，跟进项目进度。在开发过程中，我队员们也会随时帮助我，当我在后端代码调试受阻时，队友和我一起debug，当我在寻找合适的外部API 时，队友和我一起搜集。这种协作经历让我明白，软件开发从来都不是单打独斗，而是一个需要不断沟通、互相学习的过程。👥

不过，我也看到了自己的不足。发现问题并解决问题的能力还要加强，每次遇到bug都要调试很久，不能深入理解代码报错的原因。后端的整体框架是队友搭建的，我的能力应该还没办法完成整个框架的搭建，还不能很深入地理解每个文件的具体作用，这是我以后还要不断学习的。虽然模块基本功能可以实现，但在代码质量上还有很大提升空间，代码功能还能完善、代码结构还可以优化。🤔

总的来说，这次实践让我圆满达成了入门和积累的初始目标，成功地将理论转化为实践。但更大的收获是，它让我清晰地看到了一个专业开发者所应关注的技术深度和工程规范，这为我后续的学习指明了具体的方向。通过与团队成员的协作，我不仅提升了技术水平，更学会了如何更好地在团队中发挥作用，这种成长远比单纯掌握某个技术点更有价值。🌈

1.2 回顾在这门课程中的投入与产出📊

1.📝在软工实践课程当中我编写了800 行代码。

2.🎯在团队项目中我参与了撰写选题报告，分析调查问卷的数据，概念模型设计阶段UML图的绘制、AI 助手的后端设计与开发。

3.⏰软工实践的各次作业我花费的时间：

作业	花费时间
第一次团队作业	5h
第二次团队作业	5h
第一次团队项目作业	8h
第二次团队项目作业	10h
第三次团队项目作业	12h
第四次团队项目作业	12h

4.📅在软件工程课程上花费的时间

累计时间	实际周均时间	预计周均时间
60h	7h	7h

1.3 令我印象最深刻的一次作业🚀

印象最深的是冲刺的作业和答辩。这次作业期限的14 天里，我们不仅要完成项目从0到1 的搭建，还有几门考试要准备。在这里要夸夸PM 强大的组织能力和有序的工作分配，我们坚持两天进行一次集体讨论，跟进项目进度和完善功能，在全体成员的共同努力下，完成了这场意想不到的突破。💥

第一次集体会议后，我被分配了后端的工作，和后端的同学一起学习FastAPI 的框架。对于初次接触后端工作的我，觉得视频课程晦涩难懂，即使听完了整个课程也还是很难上手自己操作。自己独自学习感到了焦虑和绝望，觉得是自己不可能完成的任务。但幸运的是我遇到了强大的后端队友ly，她把视频里重要的概念框架和操作流程给我们梳理出来，帮助我们快速上手。她搭建出了完整的后端框架，教我们理解每一个代码文件要实现的具体功能，和如何合并整段代码。前端也是很快将原型界面搭建出来了，让后端要实现的工作变得更加清晰了。🙏

有了后端的基础框架和前端的界面支持，我选择植悟的AI 助手界面，完成知识库的创建和接入外部API。编写了基础的代码后，发现chat 接口一直存在问题，也卡壳了很久，我借助了AI 工具编写测试文件对接口进行测试，经过一两天的调试后可以看到接入的deepseekAPI 返回的成功测试数据，并且在deepseek 的API 使用次数界面看到了API 成功被调用。🎉

尽管成功调用了API，但遇到了很多问题。前端界面只能通过三个预先设计好的问题按钮进行提问，在文本输入框输入文字并不能通过API 发送给大模型。三个问题的答案可以通过已经导入的知识库结合大模型得到答案，但是输出的数据是Markdown 的语法格式，不美观，而且答案的输出很不稳定，经常会得不到大模型的回复。剩下的debug 放在了冲刺阶段，包括在文本输入框输入任何问题让大模型解答、在前端加上Markdown 渲染等工作。🐛

时间紧急加上考试的压力，在冲刺中只实现了三个问题的基础聊天功能，答辩也还算顺利，队友剪辑的vlog 和制作的ppt 都得到了我们和老师的夸赞。👏

之所以影响最深刻，是因为对于从未接触过后端代码设计的我来说，是一次前所未有的突破。从后端代码小白，到能自己独立编写一个模块的代码，是一次全新的尝试。🌟

二、总结收获🎁

2.1 展开说说我的软工实践故事📖

1.📋 需求分析阶段：

在撰写选题报告时，我们制作了问卷调查，将问卷分享给身边的同学并发布到网上，收集了两百多份用户的数据，了解了用户对植物养护的需求。我对问卷调查的结果进行了数据分析，发现新手用户与资深爱好者的需求呈现明显差异，我用饼图展示经验分布，用簇状柱形图对比不同群体对功能的优先级排序，这些直观的可视化结果成为团队决策的关键依据。这次经历让我真正理解，高质量的需求分析不是简单收集意见，而是通过科学方法发现潜在规律。

2.📐 概念模型设计：

在概念模型设计阶段绘制用例图、业务流程活动图和协作图的过程，让我认识到，绘制UML 图远非一项为了交付文档而进行的表面任务，它是一个不可或缺的深度思考与团队对齐的过程。这些图表共同构成了一座坚固的桥梁，一端连接着抽象的用户需求，另一端则指向了具体、可执行的技术方案。它极大地提升了我的抽象建模能力和系统思维，让我学会了在动手编码之前，先运用设计工具把“蓝图”画清楚。

3.💻后端开发实践：

编写植悟APP 后端AI 助手代码的过程，是一次将理论知识转化为工程实践的深度历练。在这个过程中，我最大的收获是深刻理解了系统集成与API 设计的复杂性。最初，我以为只需简单调用外部AI 模型的接口，但实际开发中却面临诸多挑战：调试API 接口使大模型能收到用户的问题，渲染前端的Markdown 格式界面等。这次经历让我形成了工程化的思维模式，更加关注代码的可读性、可测试性和可扩展性。这段开发经历不仅巩固了我的技术能力，更培养了我的严谨态度和系统思维，为未来的专业发展奠定了坚实基础。看到自己编写的界面成功运行，真的会有很大的成就感。

2.2 介绍学习到的新技术和生产力工具以及它们给我带来的帮助🛠️

1.🤖MCP概念学习：

在搭建天气智能体的过程中深入学习了MCP 的概念，让我对AI 应用架构有了全新的认识。最大的收获在于理解了如何通过标准化的协议来实现智能体与各种工具、数据源之间的高效协作。MCP 提供了一种清晰的解耦思路：将智能体的核心推理能力与外部工具的执行能力分离，通过标准化的请求和响应格式进行通信。这让我意识到，设计一个优秀的AI系统不仅仅是训练或调用模型那么简单，更重要的是构建一个灵活、可扩展的架构，让智能体能够像“使用工具箱”一样轻松利用外部资源。

2.📊UML图表绘制：

在概念模型设计阶段，学习使用draw.io 绘制时序图、协作图、数据流图等多种UML图表，让我收获的远不止是掌握了一个绘图工具，更获得了一种系统设计和沟通的共通语言。在绘制时序图的过程中，我学会了如何精确描述对象间按时间顺序的交互过程；协作图的绘制让我从空间结构的角度理解了对象间的链接关系；数据流图则帮助我聚焦于信息的变换与传递，明确了系统中每个处理环节的输入输出。

3.🔗GitHub协作：

学习了GitHub 的基本操作，包括克隆仓库、提交代码、推送更新、处理分支等。GitHub为我们团队提供了一个中心化的协作平台，它不仅是一个工具，更是一种工程思维的体现。

4.⚡FastAPI框架：

学习了后端FastAPI 框架并完成外部API 的接入。在将AI 模型接口对接到植悟APP 的过程中，我学会了使用requests 库发起HTTP 调用、处理认证和解析响应这些关键技术步骤。

2.3 技术之外，这门课程还给我带来了别的方面的提升🌱

1.🏗️ 建立了系统化的工程思维。课程项目让我亲身体验了从需求分析、技术选型、接口设计、代码实现到测试部署的完整软件生命周期。我不再仅仅关注如何用代码实现一个孤立功能，而是开始习惯性地思考整个系统的架构合理性、模块间的耦合度、以及未来的可扩展性。

2.👥锻炼了我的团队协作与沟通能力。在团队开发中，我深刻体会到清晰的沟通与规范的流程远比个人技术能力更重要。我们通过定期的站会同步进度、使用GitHub 进行异步协作。这个过程让我学会了如何准确地描述技术问题、如何审阅同伴的代码并给出建设性意见。这些是独自编码无法获得的宝贵经验。

3.🔍解决问题能力的全面提升。在项目中，从环境配置的报错到调试的未知异常，我遇到了无数课本上未曾提及的问题。通过大量查阅官方文档、技术社区和调试排错，我逐渐形成了一套自己的问题定位和解决方法论，从盲目尝试转向有逻辑地分析。

2.4 想说的话💫

这门课对我未来的专业道路选择产生了深远而具体的影响，它像一次集中的“职业预演”，让我从迷茫的观望转向了清晰而坚定的实践。在此之前，我对软件行业的理解大多来自课程和论坛，感觉各个方向都很宏大，但不知道自己究竟适合什么、对什么有真正的热情。而通过亲手构建植悟APP 的全过程，我获得了一次宝贵的“自我诊断”机会。🔍

最大的影响在于，它让我确认了对后端开发与系统架构的浓厚兴趣。当我沉浸在使用FastAPI 设计接口、思考数据模型、优化API 与AI 服务交互逻辑时，我体验到了一种解决复杂逻辑难题的深度乐趣和巨大的成就感。这种在幕后构建系统“发动机”、确保一切稳定高效运行的工作模式让我着迷。课程让我清晰地认识到，我享受的是这种通过代码来设计规则、处理数据、支撑业务的创造过程。因此，它坚定了我未来走向后端开发或系统架构师方向的决心。🎯

在这次团队项目中有一个我最遗憾的点。前端和原型在设计AI 助手界面的时候设计了添加图片按钮，目的是实现用户在界面添加植物的图片，大模型分析植物图片后能判断植物病虫害或给出养护建议。在冲刺的最后几天，界面的功能基本已经完成了，我才开始上手这个功能，但是由于一开始没考虑到deepseek 提供的API 不能传送图片，只能找其他的方式。PM 帮我找了一个可进行图片分析识别植物病虫害的API，但是我没研究明白具体的使用说明，最终也没接上。我还尝试了豆包的API，它可以支持图片分析功能，但是改动以后原来接好的端口就要全部推翻重建，我调试了很久最终还是放弃了。😔

这门课最有趣的点在于录制了我们开集体会议的vlog，记录我们项目完善过程的点点滴滴，也记录着每一个成员的付出。这段vlog 也会成为我们以后最宝贵的回忆。🎥

三、致谢

一个学期过去了，感谢我们团队每一位女孩的付出。我们项目的成功部署，也让我相信girls’power 也很强大！💖

感谢后端的组长乐妍，记得我有一个bug 一直调不出来，请求ly 的帮助，她从六楼下来陪我一起debug，真的超有耐心，她研究了一会就把困扰我好几天的bug 找到了。Ly 也是后端代码的顶梁柱，教我们学习视频，帮我们搭建框架，还会问我们有没有遇到问题，很幸运能遇见这么好的女孩！👩💻

感谢伟大的PM 琪丽，每次开会都把会议和任务安排地井井有条，有非常强大的组织能力和领导力，也会认真倾听每一个人的意见和想法。最后几天还帮我搜集了能用的API，希望对我有帮助，能遇见这样贴心负责的PM，也是我的荣幸！📋

还要感谢其她伙伴们，前端的伙伴们yp rm py 很快就把整个界面搭建出来了，也非常专业，让后端的任务变得更加清晰了；感谢yy，帮我注册了谷歌账号，通过她的测试也发现了我的chat 接口出现了问题；感谢fl 帮我接好了VPN，教我使用先进的工具；感谢zy 教我git 的一些操作；感谢yy 把原型设计得那么完美；感谢zy 设计的数据库。👩🎨

谢谢大家，感谢遇见！都是一群很好很好的女孩！🌸✨