事后诸葛亮分析

一、项目整体回顾

目标	是否达成	说明
实现用户注册/登录功能	✅ 是	支持邮箱+验证码验证，JWT鉴权
支持单文件与多文件上传	✅ 是	前端支持拖拽上传，后端分片处理
文件夹管理与文件转移	✅ 是	可创建、重命名、移动文件夹
文件下载与删除	✅ 是	下载带进度条，删除进入回收站
分享链接生成与权限控制	✅ 是	可设下载次数限制
回收站恢复与彻底删除	✅ 是	支持恢复原位置，30天自动清理
UI界面设计与交互体验	✅ 是	网页风格统一，操作流程清晰

二、事后诸葛亮会议讨论要点

2.1 成功经验（What Went Right）

• 任务拆解合理，责任到人
  • 每项功能均有明确负责人，避免了职责不清导致的推诿。
  • 如“上传接口”由朱一凡负责，“分享链接”由邹弘昊主攻，保障了模块独立性。
• 前后端并行开发，联调效率高
  • 后端提前提供Mock API文档，前端基于接口快速搭建页面。
  • 使用Postman共享接口集合，减少沟通成本。
• 测试左移意识强
  • 测试人员王彤德在需求评审阶段即介入，编写上传功能测试用例。
  • 所有Bug均记录在GitHub Issues中，修复闭环可追溯。
• 文档规范，易于交接
  • 提供 README.md、接口文档、数据库脚本等，新成员可在1小时内上手部署环境。

2.2 失误与教训（What Went Wrong）

• 初期对“断点续传”需求估计过高
  • 原计划实现断点续传，但因技术复杂度高，最终放弃，改为重新上传策略。
  • 教训：应更早评估技术可行性，避免资源浪费。
• 部分测试用例未覆盖边界场景
  • 如上传超大文件（>100MB）时，服务器响应超时，未提前压测。
  • 教训：需补充性能测试矩阵，尤其是极端负载下的表现。
• UI一致性未完全统一
  • 不同页面按钮样式略有差异（如“上传”和“删除”按钮颜色不一致）。
  • 教训：应在设计初期制定UI规范文档，统一视觉语言。
• 代码注释率偏低
  • 虽然代码结构清晰，但部分核心逻辑缺乏注释，影响后期维护。
  • 教训：应建立代码注释规范，作为代码提交检查项之一。

三、团队成员角色与贡献分析

名字	角色	团队贡献分	可验证的贡献
杨梓城	PM/后端	25	注册登录接口、QQ邮箱验证接口、文件重命名接口开发
朱一凡	后端	17	单/多文件上传、文件夹管理、文件转移、文件下载接口实现
曾添伟	前端	20	网页风格设计、注册登录界面、系统主页、个人云盘页面设计
邹弘昊	后端	24	文件删除、分享链接生成、链接识别、回收站恢复接口开发
黄炳城	前端	19	交互设计、接收分享文件页面、回收站页面原型设计
王彤德	测试	15	编写上传功能测试用例，发现并推动修复多个Bug

四、团队协作与沟通总结

• 优点：

  • 每周召开站立会，同步进度与阻塞问题；
  • 使用GitHub Issues跟踪任务状态，透明度高；
  • 开发过程中积极提问、及时反馈，无重大误解。

• 改进点：

  • 个别成员在任务延期时未提前预警，导致整体进度轻微延迟；
  • 应引入“风险登记表”，提前识别潜在瓶颈。

• 会议合照

五、未来改进方向

• 引入CI/CD流水线
  • 使用Jenkins或GitHub Actions实现自动化构建与部署。
• 完善测试体系
  • 补充单元测试（JUnit + Mockito）、接口自动化测试（Postman + Newman）。
• 优化用户体验
  • 增加上传队列管理、断点续传、文件预览功能。
• 加强安全防护
  • 添加XSS过滤、CSRF保护、文件类型白名单校验。
• 推进容器化部署
  • 将应用打包为Docker镜像，降低环境依赖。

六、结语

本次Alpha版本的成功交付，得益于团队成员的共同努力与清晰分工。通过“事后诸葛亮会议”，我们不仅看到了成果，也正视了不足。未来我们将以更高的标准要求自己，持续迭代，打造一个真正可用、安全、高效的云盘协作平台。