因为把dll看成ddl而急死——Beta冲刺总结随笔

[因为把dll看成ddl而急死]

这个作业属于哪个课程	2501_CS_SE_FZU
这个作业要求在哪里	团队作业—Beta冲刺
团队名称	因为把dll看成ddl而急死
这个作业的目标	Beta冲刺总结随笔
其他参考文献	《构建之法》、《数据库设计说明书》、《概要设计说明书》

目录

• 1. 项目预期计划、完成度
• 1.1 回应冲刺开始前设立的任务
• 1.2 改进计划的完成情况
• 2. 项目实际进展
• 2.1 项目链接
• 2.2 服务端
• 基础/中间 件
• 网关模块
• 用户模块
• 笔记模块
• 社交模块
• 互动模块
• 视频模块
• 2.3 客户端
• 安全模块
• 用户模块
• 视频模块
• 互动模块
• 社交模块
• 笔记模块
• 系统模块
• 3. 收获和心得体会
• 3.1 叶达（102300229）
• 3.2 张钰婷（102300206）
• 3.3 郑天浩（102300109）
• 3.4 陈彦哲（032201218）
• 3.5 李严（102300127）
• 3.6 苏峻（102300221）
• 3.7 朱添驰（032201109）
• 3.8 陈雨昕（102300214）
• 3.9 陈雨桐（102300202）
• 3.10 吴嘉鑫（102300225）
• 4.AI技术员作用分析
• 4.1项目参与概况
• 4.2主要贡献领域
• 4.2.1 后端开发
• 4.2.2 前端开发
• 4.3 优点分析
• 4.4 不足之处
• 4.5 总结
• 5. 组员分工协作情况
• 6. 工作量比例

1. 项目预期计划、完成度

日期	任务
11.24——11.26	前后端核心功能实现
11.27——11.29	对接前后端功能
11.30	前后端功能优化与完善
12.1	集成测试与部署准备

1.1 回应冲刺开始前设立的任务

Beta阶段按照预期计划有序推进，各核心任务完成情况如下：

计划任务	完成情况	关键成果
前后端核心功能实现	100%	完成视频播放管理器、笔记模块、推荐系统等核心功能开发
对接前后端功能	95%	实现用户认证、视频、笔记、社交等模块的前后端联调
功能优化与完善	90%	完成网络感知预加载、Token自动刷新、生产模式性能优化
集成测试与部署	90%	已完成主流程测试，存在部分边界场景验证不到位的情况

本阶段累计提交148次，采用Git Flow分支管理策略，通过feat/social、feat/zyt、feat/cyz等多个功能分支并行开发，有效提升了团队协作效率。

1.2 改进计划的完成情况

针对Alpha阶段暴露的问题，Beta阶段采取了以下改进措施：

1. 前后端沟通机制优化

• Alpha痛点：前后端各自开发，接口定义不一致导致返工
• 改进措施：建立每日站会同步机制，接口文档前置评审，使用统一的API规范
• 改进效果：返工率显著降低，模块对接效率提升约40%

2. 任务定义标准化

• Alpha痛点：任务边界模糊，交付物不明确
• 改进措施：每个任务明确输入、输出和验收标准，使用看板跟踪进度
• 改进效果：任务完成质量提升，减少了"做完但不对"的情况

3. 边界场景处理增强

• Alpha痛点：弱网环境下视频卡死、进度丢失
• 改进措施：引入connectivity_plus插件进行网络状态检测，实现网络感知预加载和断点续传
• 改进效果：弱网体验明显改善，用户反馈问题减少

4. 代码质量管控

• 严格执行Code Review制度，核心模块需2人以上评审通过方可合并
• 建立统一的代码规范文档，命名、注释、结构保持一致

2. 项目实际进展

2.1 项目链接

Zitok项目仓库

2.2 服务端

基础/中间 件

集成 MySQL 存储核心业务数据，Redis 负责缓存加速，Kafka 处理点赞/评论等高并发异步消息，Elasticsearch 结合向量引擎提供混合搜索，并配套 Jaeger/Prometheus/Grafana 实现全链路监控。除部分监控件版本问题运行不了基本没有问题

网关模块

基于 Hertz 框架构建高性能 API 网关，统一通过 JWT 中间件进行身份鉴权与 Token 解析，负责将 HTTP 请求路由分发至后端的 Kitex RPC 微服务集群。

用户模块

实现了用户注册、登录与个人信息管理，支持头像与背景图的上传存储（对接第三方存储），并通过 RPC 接口为视频、社交等服务提供统一的用户基础信息查询。

笔记模块

创建删除点赞收藏笔记与获取视频/用户笔记已大体完善

社交模块

主要负责即时通讯相关的业务逻辑，实现了聊天室的创建与消息收发功能，支持用户间关注与好友关系的添加及管理，为互动提供社交关系链支持。

互动模块

负责视频点赞、评论发布与删除等核心交互功能，采用 Kafka 消息队列异步同步交互状态至推荐系统与搜索服务，确保高并发下的数据最终一致性。

视频模块

核心涵盖视频投稿发布、流式 Feed 获取及 Gorse 推荐系统反馈闭环，最新集成了 OpenAI 向量嵌入生成与 Elasticsearch 混合搜索，实现了基于语义的高级视频检索能力。

2.3 客户端

安全模块

登录展示视频：

注册展示视频：

退出登录展示：

软件关闭后认证信息仍然存在展示：

切换账号展示：

用户模块

用户资料更新获取展示：

个人主页展示：

视频模块

推荐模式

推荐模式视频无限加载

精选模式

视频详情界面

视频发布

互动模块

视频收藏点赞

评论发布

笔记点赞收藏

社交模块

聊天模块

好友添加，好友搜索

三种关系

群聊模式

笔记模块

发布笔记流程

md预览器（发布阶段和发布后的笔记条目）

md编辑器

系统模块

3. 收获和心得体会

3.1 叶达（102300229）

参与整个前后端流程，前后端代码都有贡献，粗糙的领悟了团队的工作流，比起开发技术来说，管理技术、好的产品经理、好的前期分析和准备是项目进行的关键

3.2 张钰婷（102300206）

ai只是辅助工作，具体实现还需要人把控。
学无止境。

3.3 郑天浩（102300109）

要及时充分沟通，避免频繁返工

3.4 陈彦哲（032201218）

学无止境，任何一个看起来简单的任务都有可能蕴藏着巨大的工作量。
一定要给任务留好充足的时间和饱满的精力。

3.5 李严（102300127）

不能累。得加油

3.6 苏峻（102300221）

团队项目中一定要及时沟通，交流问题和需求，有什么异常状况要及时提出，防止后期补救时带来更大的麻烦。

3.7 朱添驰（032201109）

心静，遇到问题不要着急，先喂给AI，慢慢调教它。

3.8 陈雨昕（102300214）

事情要提前准备，有预计工期。
计划安排好，不要高估自己。

3.9 陈雨桐（102300202）

不要死赶ddl，提早些完成。

3.10 吴嘉鑫（102300225）

项目的推进在于明确的分工，代码的开发在于demo + 扩展的形式，这样有利于队伍的沟通和代码开发的稳定

4.AI技术员作用分析

4.1项目参与概况

本项目为ZiTok短视频社交平台，AI技术员（Claude Code）全程参与前后端开发，承担代码生成、架构设计、问题诊断等核心工作。

4.2主要贡献领域

4.2.1 后端开发

贡献内容	具体实例	效率提升
API接口实现	笔记CRUD、群聊消息等接口	代码编写提速3倍
Bug诊断修复	定位WebSocket连接泄漏、缓存不一致等问题	排查时间减少70%

4.2.2 前端开发

贡献内容	具体实例	效率提升
Flutter组件开发	视频播放器、聊天界面、笔记编辑器	开发周期缩短50%
状态管理优化	Provider架构重构、视频播放管理器设计	性能提升40%
UI/UX改进	发现页布局、群聊成员页面样式	迭代速度提升2倍

4.3 优点分析

1.高效率：复杂功能（如AI语义搜索）从设计到实现仅需数小时
2.低错误率：生成代码经验证，首次运行成功率约85%
3.知识广度：熟悉Go/Dart/微服务/向量数据库等多技术栈
4.文档能力：自动生成架构文档、API文档，节省30%文档时间

4.4 不足之处

不足项	具体表现	改进建议
上下文限制	超长对话后可能遗忘早期需求	分阶段明确需求
业务理解	对特定业务逻辑需反复确认	提供详细需求文档
测试覆盖	生成代码缺少完整单元测试	明确要求补充测试
创意局限	UI设计偏保守，缺乏创新性	提供设计参考

4.5 总结

AI技术员在本项目前端中承担了约60%的代码生成工作，显著提升了开发效率。但仍需人工把控业务逻辑、代码审查和创意设计，形成"AI执行+人工决策"的协作模式最为高效。
而在后端中承担了约30%的代码生成工作，对于复杂的架构来说，ai还是难以胜任

5. 组员分工协作情况

角色	任务内容	负责人
产品经理/客户端开发	视频模块对接，客户端所有代码整合	叶达
客户端开发	登录模块优化、忘记密码界面编写、搜索界面添加、设置界面实际功能	张钰婷
后端开发	笔记模块对接	李严
后端开发	推荐系统载入	陈彦哲
后端开发	用户模块、视频模块优化	郑天浩
客户端开发	好友聊天模块对接	吴嘉鑫
客户端开发	个人信息模块对接	苏峻
客户端开发	前端评论模块对接、互动模块对接、帮助好友聊天模块对接	朱添驰
文档与测试	协作文档搭建	陈雨昕
文档与测试	用户调查使用报告 答辩ppt	陈雨桐

6. 工作量比例

学号	姓名	工作内容	贡献度
102300229	叶达	视频模块对接，所有模块合并，所有问题优化	13
102300206	张钰婷	登录模块优化、忘记密码界面编写、搜索界面添加、设置界面实际功能	10
102300109	郑天浩	用户模块、视频模块优化	12
032201218	陈彦哲	推荐系统载入	10
102300127	李严	笔记模块对接	9
102300225	吴嘉鑫	好友聊天模块对接	9
102300221	苏峻	个人信息模块对接	11
032201109	朱添驰	前端评论模块对接、互动模块对接、帮助好友聊天模块对接	8
102300214	陈雨昕	协作文档搭建	9
102300202	陈雨桐	用户调查使用报告 答辩ppt	9