软件工程实践学期总结

一、学期回顾

1.1 回顾概述

目标：了解后端开发，学会团队协作

收获：参与 学海智航诞生到发布 的全过程，了解需求、开发与发布三大工作。

不足：没有充分发挥结对编程的优势，学习与开发效率有待提升。

1.2 投入与产出

• 本人代码量： 2575行
  

• 本人参与了学海智航的设计与开发，具体如下表。

作业	花费时间-小时	工作
第一次团队作业	6	git，博客园
第二次团队作业	36	go、docker、mcp入门，aiSEsolverTool开发
第一次团队项目作业	5	需求分析问卷，灵感
第二次团队项目作业	24	系统设计说明书，summary功能开发
第三次团队项目作业	6	PPT
第四次团队项目作业	21	上台，PPT，修后端bug

• 在软件工程课程上花费的时间

累计时间	预计周均时间	实际周均时间
98	7	9.8

1.3 印象最深刻的发布会

毕竟是本人上台，而且是最后的“斩杀”。

模仿雷军的演讲思路：why-how-what来展开的发布会。

我从小就害怕数学，而3blue1brown的可视化让我体验到了数学的美；以此为灵感，

看着 苏郑熙凡 实机演示的各个细节，目睹团队写的代码与文档变成真正可用、甚至帮助我们自己备考（比如证券投资学），自豪感油然而生。

老师点评，学海智航更可以面向教师的备课，从经济上看教师的购买力也更强，这拓展了我的思路。

二、总结收获

2.1 软工实践故事

2.1.1 git

你应该要为太久没使用github而脸红。以下是肌肉记忆。

先在github检查sync fork。

git pull origin main

更改代码……

git add .

commit之前先检查是否能跑通！

git commit -m "feat: xxx"

git push origin main

注：这里的origin是仓库地址（比如Kkkrran/go-mcp-demo: a demo to learn how to use mcp in go），main是分支名称。一个仓库里有多个分支，注意开发的时候别搞乱了。

2.1.2 跑通后端

在着急上手之前，为何不静下心来学一学框架本身，以及各种部署工具呢？要不然，面对这种复杂度的目录，你会顾此失彼的。整洁架构小文档 - Kkkrran - 博客园

对了，试着在具体工程里“破坏代码”，是学习框架的高效方式——致敬传奇教材编写者Zed A.Shaw（(99+ 封私信 / 80 条消息) “笨办法”先驱者：不会绘画的音乐家不是一个好的程序员 - 知乎）

2.1.3 需求分析问卷

把目标用户聚焦在理工科的学生和老师身上。可惜最后忙着忙着没来得及让老师这边试试我们的产品，没来得及针对备课进行优化。之后的开发还是围绕着学生。毕竟产能有限，不能既要又要嘛。

2.1.4 summary功能开发

关键一招：Notes只是个json，解释功能靠前端自由发挥。

下面是全流程，留作纪念。

改sql文件，重新生成 ORM 模型（cmd：make model）；

业务代码：提示词模板（summarize.txt），提示词加载器（prompt_loader.go）；

改api.thrift，然后hz update -idl "./idl/api.thrift“；

业务代码：summarize.go；

拓展Host结构（host.go），手动填充逻辑（api_service.go）。

2.1.5 修后端bug

写代码之前，先跟协作者们明确需求。要不然自以为是的commit被驳回，实在是太浪费时间了。

2.2 新技术

• go

  Less is more的哲学。

• docker

  是我喜欢的image，直接pull。让部署变得方便。

• hertz

  高可用性、高性能和高扩展性的Golang HTTP框架，旨在帮助开发者构建微服务。作为后端“鸡架”的一部分，免去了多人协作可能带来的不统一的麻烦。

• thrift

  核心思想是通过定义一种简单的 IDL（接口定义语言），来描述服务和数据结构，从而生成各种语言的服务端和客户端代码，实现跨语言的服务通信。

• apifox

  可视化的api调试工具，缩短我找到bug的时间。

2.3 技术之外，这门课程还带来了哪些方面的提升？

• 人脉，结识了各怀绝技的同学。
• 使用AI进行vibe coding的经验。在人人都用ai的时代，怎样快准狠，如何人机协同，就成了新的技术。
• 打代码是为了需求，不要为了code而code。开发过程中，很多浪费时间的操作都踩中了八耻的坑。
  

2.4 To 学弟学妹

以下是我学习过程中觉得很有效的资源，供参考。

建议40min从头看到尾【40分钟的Docker实战攻略，一期视频精通Docker】 https://www.bilibili.com/video/BV1THKyzBER6/

【Hertz快速搭建web server】 https://www.bilibili.com/video/BV1XhDfYWEUJ/?share_source=copy_web&vd_source=9a01f1a507a26302eb1ce436ab0aba5d

只要打算从事计算机相关工作，都建议跟西二。我因为想当然与怠惰，到大三才补上。

west2-online/learn-go: 福州大学西二在线工作室go方向考核指南

多问问ai为什么写这些代码，进步得快。

但是要注意，ai可能不了解你在用的框架，你需要自己对框架以及流程足够熟悉。

也可以闲鱼买号。注意别把自己的号拿去加入组织，会被封号。

github copilot学生认证教程，免费使用两年Copilot Pro！！（避免踩坑版）-CSDN博客

【AI Coding的理想流程】https://www.cnblogs.com/kkkrran/p/19389077

三、致谢

首先是技术领头人苏郑熙凡和肖垲，还有项目领头人郑隆熙。学海智航的3个太阳！

两位技术领头人在各方面指引本人的开发；项目领头人拍板决定，避免扯皮。

感谢陈昌昊提供的后端开发路径，从新手的角度，让我快速入门。

感谢刘佳的vlog，给发布会增添活力。