行稳致远

一、学期回顾

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

在课程开始前，我一度认为软件工程的重心完全在于代码的编写，甚至担心如果主要负责测试与部署以及部分文书工作，会接触不到项目的核心。那时我对软工的期待更多是学习如何快速堆砌功能，觉得只要程序能跑通就算大功告成。但随着项目从需求分析推进到 Alpha 和 Beta 阶段，我意识到这种认知非常浅薄。

作为负责测试的一员，我发现代码实现只是第一步，如何建立稳定的运行环境并确保功能在各种边界条件下不崩溃，才是工程化的难点所在。在这个过程中，我通过配置服务器环境和学习后端接口逻辑，真正理解了软件从本地到生产环境的交付流程。能够成功保障项目的正常运行并顺利部署上线，确实达到了我跨出编程舒适区、掌握工程化闭环的初衷。

然而，在收获之余也暴露了不少短板。在测试实践中，我发现由于自己前期对后端业务逻辑的渗透不够深，导致编写的部分测试用例颗粒度不够细，没能在开发初期就拦截住一些潜在的缺陷。这些不足让我深刻体会到，测试和部署并非开发的末端环节，而是需要贯穿始终的质量保障体系。

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

• 代码贡献：在软工实践课程当中编写了约 600行 代码。
• 主要职责：在团队项目“植悟”中负责设计与开发，主要承担 测试 和 从本地部署到服务器 的工作。

团队作业时间统计表

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

课程整体投入

软件工程课程花费时间指标	数值
累计时间	47 (h)
实际周均时间	5 (h)
预计周均时间	7 (h)

1.3 令你印象最深刻的是哪一次作业或哪一场答辩？

令我们印象最深刻的，莫过于 Alpha 阶段的冲刺答辩。

在那场答辩中，看着“植悟”项目从最初的几个零散构思，到最后被完整地呈现出来，内心的触动非常强烈。最让我们感到紧绷的时刻是作品演示环节。当 PPT 翻到“后端运行 main 程序调用各模块代码逻辑”的部署流程时，只有我们自己知道，为了让 V0.3.0 这个本地版本能够正常运行，我们在后台付出了多少努力。

为了确保数据库连接与后端逻辑能够严丝合缝地配合，我们反复调试环境适配，梳理了无数遍接口调用流程。当看到 Demo 顺畅运行的那一刻，我们才真正感受到一种守住了技术底线的成就感。这种确保项目从逻辑代码转化为可运行产品的过程，远比想象中要有分量。

二、总结收获

2.1 展开说说你的软工实践故事

• 第一次团队项目作业
  我负责了需求规格说明书中功能描述、性能需求及验收标准等章节的撰写。通过将项目构思转化为具体的工程要求，我意识到需求定义并非简单的文字罗列，而是为后续开发划定执行边界。

• 第二次团队项目作业
  我主要参与了系统类图的绘制和数据库 ER 图的设计。在绘制类图时，我不光要考虑实体类关联，还要结合后端框架的逻辑对数据流动进行拆解。这次经历让我明白，类图是对软件结构的模拟演练，能有效避免技术实现脱离最初的逻辑设定。

• 第三次团队项目作业
  在 Alpha 冲刺阶段，我们对“植悟”进行了全方位的连通性测试。由于项目是基于 FastAPI 框架的本地版本，我们重点调试了后端程序与各模块的调用逻辑。通过记录缺陷、定位 Bug 并推动修复，确保了数据库与后端服务在演示环境下的深度衔接。

• 第四次团队项目作业
  在 Beta 冲刺阶段，我的工作重点是针对云端部署后的项目进行全面复核。我参照测试方案，对注册登录、植物管理、养护日记以及 AI 助手等模块进行了多轮业务流验证。排查并修复了一些在云端环境下才暴露出的路径适配和配置偏差问题，为项目的最终落地提供了必要的保障。

2.2 介绍学习到的新技术或生产力工具

1. FastAPI 后端开发技术：掌握了异步接口的开发逻辑，能够阅读并理解 API 路由、Pydantic 模型以及数据库 ORM 映射代码。
2. Postman 接口调试工具：学会了配置请求参数和环境校验，实现了对后端返回数据的快速复核，大幅提升了排查效率。
3. 云端部署与 API 管理：学习了服务器环境适配，确保了项目在云端环境下的访问。
4. 自动化验证与监控工具：掌握了利用浏览器开发者工具分析网络请求，并学习了使用自动化单元测试工具进行逻辑校验。

2.3 技术之外带来的提升

1. 从“写代码”到“做工程”的思维转变：意识到从需求文档到系统设计再到上线验证，每一个环节的规范化操作都能极大减少后期的返工成本。
2. 团队角色中的协作信任：学会了在发现 Bug 时通过准确的问题描述和进度同步，与前后端同学保持高效沟通。
3. 面对复杂环境的抗压与解决能力：在压力和紧迫的截止日期面前，学会了保持冷静并以解决问题为第一优先级。
4. 对交付质量的责任感：养成了对细节严格把控的习惯，意识到任何一个微小的接口不匹配都可能导致用户无法正常使用。

2.4 自由发挥与记录

关于这门课，我想记录的是一种职业心态的转变。最有趣的瞬间莫过于每次测试成功后的“那一刻”，当后端接口从 Postman 里第一次跳出正常的响应，或者看到之前报错的功能在页面上真正跑通时，那种跨越感非常真实。遗憾的是因为时间限制，没能把测试覆盖率做得更广，虽然核心业务跑通了，但像极端边界情况的测试、代码的性能优化还没来得及深入研究。

这门课也让我意识到，自己虽然学会了看后端代码和做接口复核，但相比于纯粹的业务开发，我似乎对“如何让一个系统可靠运行并落地”更有兴趣。给学弟学妹们留一句话：Bug 是修不完的，但逻辑是可以理清的。 不要害怕看那些报错信息，也不要畏惧去翻队友的代码，当你真正耐着性子把逻辑跑通时，你会发现软件工程的魅力在于你能控制并解决那些不确定性。最后，我也想贴出我调试时反复核对的测试记录，它们见证了这学期每一个守在屏幕前的深夜。

三、致谢

一个学期的软工实践临近尾声，最想感谢的是并肩作战的队友们。

首先要特别感谢我们的组长，他在整个学期里承担了繁重的组织和协调工作，总能在任务堆积如山的时候帮大家理清先后顺序，带着团队稳步前进。正是因为组长的统筹，我们才能在有限的时间里高效协作。

同时，也要感谢后端组的同学们。在项目冲刺阶段，每当我发现逻辑跑不通或者数据有误时，后端同学总是第一时间响应，耐心帮我理顺逻辑并修复问题。正是因为大家这种不计较个人分工、共同解决困难的态度，才让我们最终能够交出一份完整的答卷。

这学期大家辛苦了，很高兴能和你们在一个团队！