冲刺记录2

第2周冲刺记录
架构设计文档、API规范
100% 完成
一、冲刺目标
本周的核心任务是完成校园二手交易平台的系统架构设计。基于第一周的需求分析结果，我们需要将用户需求转化为具体的技术方案，包括系统整体架构设计、模块划分、技术选型确认、API接口规范制定以及数据库概念模型设计。架构设计的质量直接决定了后续开发工作的效率和质量，因此本周的工作至关重要。
二、每日工作进展
周一：召开架构设计启动会议，回顾了上周的需求分析成果，明确了本周的工作任务和里程碑。项目经理分配了各成员的具体任务：后端开发人员负责系统架构图和API设计，前端开发人员负责前端架构和页面结构设计，测试人员负责编写测试计划大纲。
周二：后端团队完成了系统整体架构设计。采用经典的分层架构模式，将系统分为表现层、业务逻辑层、数据访问层和数据库层。同时引入了RESTful API设计风格，确定了前后端分离的开发模式。架构设计中还考虑了系统的可扩展性，预留了消息队列和缓存层的接口。
周三：前端团队完成了前端架构设计。采用Vue.js 3.x框架，配合Vue Router进行路由管理，使用Pinia进行状态管理。UI组件库选择了Element Plus，以加快开发速度。前端项目结构按照功能模块进行划分，包括用户模块、商品模块、订单模块、聊天模块和评价模块。
周四：团队联合完成了API接口规范的制定。使用Swagger/OpenAPI规范编写了接口文档，定义了用户认证、商品管理、订单处理、消息通知等核心接口的请求方式、参数格式和返回结构。共定义了42个API接口，覆盖了系统的主要业务场景。
周五：完成了数据库概念模型设计，绘制了ER图。核心实体包括用户、商品、订单、消息、评价、分类等。确定了实体之间的关系：用户与商品是一对多关系，用户与订单是一对多关系，商品与订单是多对多关系。初步确定了各实体的主要属性。
周六：编写并完善了系统架构设计文档，将本周的所有设计成果整理成正式文档。文档包括系统概述、架构设计、模块说明、API规范、数据库设计和部署方案等内容。
周日：进行了架构设计评审。邀请了指导教师和另一组同学参与评审，收集了改进建议。主要反馈包括：需要增加安全认证方案的详细设计、考虑高并发场景下的性能优化策略、补充异常处理机制的设计。
三、遇到的问题与解决方案
在API接口设计过程中，前后端团队对部分接口的设计存在分歧。前端希望接口返回的数据格式尽量贴合页面展示需求，而后端倾向于遵循RESTful标准，保持接口的通用性。经过讨论，我们达成了一致：核心接口遵循RESTful规范，对于前端有特殊需求的场景，通过额外的查询参数来定制返回格式。这种折中方案既保证了API的规范性，又满足了前端的实际需求。
四、下周计划
下周将进行数据库详细设计和开发环境搭建，包括：完成数据库表结构设计、搭建前后端开发框架、配置CI/CD流水线、编写开发规范文档。