SchoolDash Beta冲刺前一阶段问题总结随笔-优快云博客

SchoolDash Beta冲刺前一阶段问题总结随笔

课程与作业信息

所属课程：软件工程实践
本篇目标：总结Alpha阶段问题与后见之明，规划Beta阶段改进、新功能、团队分工改进
其他参考：开发问题记录.md、Alpha冲刺随笔与总结

1. Alpha阶段问题总结与后见之明

Alpha冲刺（2025年12月12日至12月21日）是我们团队首次完整实践"learning by doing"的过程，通过开发SchoolDash校园配送管理系统，我们从零学习Vue.js、Express.js、Sequelize等技术，构建了用户端、骑手端和管理端的基本功能。但这个过程暴露了许多问题，这些问题不仅技术性强，还涉及团队协作和规划不足。开发问题记录.md详细记录了10个主要问题，下面分类总结，并分享后见之明，帮助我们避免类似错误。

功能实现与重构问题：项目最初包含图片相关功能（如商品图片上传和轮播图），但需求变更要求完全移除。这导致代码中残留字段和逻辑，测试时出现数据返回异常和页面渲染问题（如订单详情失败，由于数据结构不匹配）。后见之明：需求变更应在设计阶段就全面评估，采用模块化设计，便于移除或替换功能。早期引入代码审查可以避免残留代码，节省后期调试时间。我们本该在冲刺开始前定义清晰的功能清单，避免"边做边改"的混乱。
API与交互问题：多次遇到API错误，如商品详情访问404（前后端路径不一致）、商品上传500（前端发送无效字段导致数据库插入失败）。这些问题源于前后端沟通不足，开发中未及时同步接口定义。后见之明：API设计应使用工具如Swagger或Postman提前文档化，并通过集成测试早暴露不匹配。Alpha阶段的"试错"让我们理解，软件工程不是单纯编码，而是强调接口契约的稳定性。
数据库与配置问题：环境配置是痛点，如服务器连接拒绝（SQLite模块加载失败）、模型与实际表结构不匹配（移除图片字段后数据库未同步）。这些导致服务启动失败或查询异常。后见之明：配置管理应标准化，使用环境变量和脚本自动化切换（如MySQL/SQLite）。定期数据库检查（如SQL DESCRIBE命令）可以防患未然。我们忽略了生产环境模拟，导致问题在后期暴露，未来需在规划阶段纳入多环境测试。
缓存、权限与部署问题：测试中发现订单页面缓存残留（浏览器保留旧数据，导致已移除图片仍显示）、身份验证角色权限混淆（用户/骑手/管理员Token未分离）、跨域CORS错误（前后端分离部署时访问拒绝）。这些影响用户体验和安全性。后见之明：缓存和权限是隐形杀手，应在架构设计时考虑，如添加缓存控制头和基于角色的访问控制（RBAC）。部署前模拟真实场景（如不同浏览器测试）至关重要。Alpha的这些问题提醒我们，软件工程强调端到端视角，而非孤立模块。

总体而言，Alpha阶段的问题源于对软件工程的浅显认识：我们低估了测试的重要性（手动测试过多，导致bug晚发现）、协作的复杂性（分工清晰但沟通不足）和规划的必要性（任务估算不准，导致后期赶工）。通过后见之明，我们认识到"learning by doing"不仅是技术积累，更是培养工程思维的过程。这些问题虽延误进度，但让我们团队从"学生模式"转向"工程师模式"，为Beta阶段奠定基础。

2. Beta阶段改进与新功能

基于Alpha阶段暴露的问题，我们规划Beta阶段的改进和新功能，重点针对痛点进行优化，同时引入实用性增强的功能。改进强调问题预防和新功能的可行性，避免引入过多复杂性，确保系统更稳定和用户友好。

改进：
- 功能稳定性提升：针对Alpha中功能移除导致的残留问题，我们将加强代码审查流程，确保任何变更后进行全面回归测试。同时，优化数据处理逻辑，避免类似数据结构不匹配的渲染失败，提高系统的整体可靠性。
- 交互与API优化：解决API路径不一致和错误响应问题，通过标准化接口文档和早期集成测试，确保前后端无缝对接。改进用户界面反馈，如添加加载提示和错误提示，提升操作流畅度。
- 配置与部署改进：针对数据库连接和环境切换困难，我们将统一配置管理，引入简单脚本自动化部署过程，减少手动错误。同时，增强跨域处理，确保分离部署时的安全性。
- 缓存与权限管理：针对缓存残留和权限混淆，我们将完善浏览器缓存控制机制，并细化角色权限定义，确保不同用户（如骑手和管理员）操作隔离，提高系统安全性和用户体验。
新功能：
- 数据统计与报告：在管理端引入基本订单统计（如每日销量汇总），帮助管理员分析趋势，便于决策。这将扩展Alpha的核心功能，使系统从基本管理向智能分析转型。
- 用户反馈机制：添加简单反馈表单，收集使用意见，为后续迭代提供数据支持。

这些改进和新功能预计在Beta冲刺中逐步实现，优先解决Alpha痛点，确保新添加不影响现有稳定性。

3. 团队分工改进

Alpha阶段的分工基本明确：端逻辑和数据库管理，前端界面和交互设计，测试和文档工作分工明确。这种分工利用了各自优势，但也暴露了协作瓶颈，如前后端API对接时沟通不畅，导致延误；测试反馈循环慢，问题修复效率低；成员间知识共享不足，某人阻塞时难以互助。这些问题反映了团队协作的初级阶段，缺乏灵活性和交叉支持。

为弥补这些不足，Beta阶段我们将改进分工模式，采用更动态和协作导向的策略：