报备契约队文件 β冲刺总结的重要文件

报备契约队 2025-12-01 23:21:07

项目	内容
这个作业属于哪个课程	202501 福大-软件工程实践-w 班
这个作业要求在哪里	团队作业——事后诸葛亮
这个作业的目标	β论冲刺总结

报备契约队
组长王胤杰
食光荐客 β 冲刺总结随笔
一、β 冲刺核心成果预览
1. 三端差异化登录页（覆盖学生 / 商家 / 管理方场景）
2. 学生端核心功能界面（覆盖日常使用场景）
3. 商家端与管理方端功能界面（覆盖运营管理场景）
4. 技术底层成果界面（覆盖接口与数据保障）
5. 核心业务流程联动界面（覆盖全角色协作场景）
二、β 冲刺任务完成情况（按分工关联成果）
三、α 阶段改进计划完成情况（按分工落地）
四、成员体验与收获（按分工角色分享）
组长王胤杰
前端开发 A 叶逸群
前端开发 B
前端开发 C
后端开发 A
后端开发 B
测试工程师
五、成员贡献度分配（按实际分工与产出）
八、后续规划

报备契约队

组长王胤杰

食光荐客 β 冲刺总结随笔

β 冲刺是项目从 “基础可用” 向 “稳定易用” 跨越的关键阶段。团队七人按 “前端三线 + 后端双线 + 测试 + 产品” 分工协作，不仅完成了订餐预约、数据看板等核心功能拓展，更攻克了 α 阶段遗留的 “接口不统一”“数据库架构松散” 等底层问题，同步深化三端登录权限、跨角色流程闭环能力，让平台从 “单一工具” 升级为 “体系化校园餐饮服务系统”。

一、β 冲刺核心成果预览

为直观呈现本轮冲刺的关键突破，以下为核心功能的页面截图：

1. 三端差异化登录页（覆盖学生 / 商家 / 管理方场景）

左：学生端微信授权登录页（含校园身份绑定入口，支持学号 + 姓名实时校验）；中：商家端账号登录页（带图形验证码、密码强度提示，登录失败 3 次触发手机验证码）；右：管理方高安全登录页（含 IP 白名单校验、部门验证码输入框，陌生 IP 限制登录）

2. 学生端核心功能界面（覆盖日常使用场景）

从左到右、从上到下：①首页（含店面推荐卡片、多维度筛选栏，支持下拉刷新）；②店面详情页（菜品分类折叠列表、预约订餐模块，显示实时库存）；③评价编辑页（多维度评分条、标签云选择、图文上传区）；④个人中心（订单状态筛选、我的评价 / 反馈入口，支持订单取消操作）

3. 商家端与管理方端功能界面（覆盖运营管理场景）

4. 技术底层成果界面（覆盖接口与数据保障）

5. 核心业务流程联动界面（覆盖全角色协作场景）

二、β 冲刺任务完成情况（按分工关联成果）

计划完善 / 新增功能	具体描述	完成状态	技术细节与对应分工角色
三端登录与权限体系	学生端（微信授权 + 校园身份绑定）、商家端（账号 + 验证码）、管理方端（账号 + IP 绑定）差异化登录，强化权限隔离	已完成	1. 前端：前端 A（学生端登录 + 身份绑定页）、前端 C（商家 / 管理方登录页）；2. 后端：后端 A（用户登录接口 + 校园身份校验逻辑）；3. 产品：产品经理（登录流程需求对齐 + 界面审核）
前后端接口完全统一	重构 α 阶段零散接口，制定 RESTful 规范，统一请求 / 响应格式、错误码、权限校验	已完成	1. 后端：后端 A（用户 / 店面接口标准化）、后端 B（评价 / 反馈接口标准化）；2. 前端：前端 A / 前端 B / 前端 C（按统一规范适配页面请求，封装通用工具）；3. 测试：测试工程师（接口一致性测试用例编写与执行）
数据库架构搭建与优化	重构表结构，设计实体关联，新增索引与数据安全策略	已完成	1. 后端：后端 A（用户 / 店面表设计）、后端 B（评价 / 反馈表设计）协同完成；2. 产品：产品经理（梳理业务实体关系，输出数据模型需求）；3. 测试：测试工程师（数据库性能测试，验证索引优化效果）
学生端核心功能	首页（店面推荐）、店面详情（菜品 + 预约）、个人中心（订单 / 评价）、评价 / 反馈提交模块开发	已完成	1. 前端：前端 A（首页 + 店面详情 + 预约功能）、前端 B（个人中心 + 评价编辑页 + 反馈提交页）；2. 后端：后端 A（店面列表 / 详情接口）、后端 B（评价提交 / 反馈接口）；3. 测试：测试工程师（学生端功能全流程测试，覆盖异常场景）
商家端核心功能	管理首页（订单统计）、评价管理（查看 / 回复）、店面基础信息编辑模块开发	已完成	1. 前端：前端 C（商家端登录 / 管理首页 / 评价管理页）；2. 后端：后端 A（店面编辑接口）、后端 B（评价回复接口）；3. 产品：产品经理（商家端界面审核，输出操作流程规范）
管理方核心功能	反馈处理（查看 / 回复 / 标记状态）、商家资质审核入口开发	已完成	1. 前端：前端 C（管理方登录 / 反馈处理页）；2. 后端：后端 B（反馈查询 / 处理接口）、后端 A（商家资质审核接口）；3. 测试：测试工程师（管理方权限测试，验证越权防护效果）
测试与文档保障	全功能测试覆盖、Bug 跟踪、项目文档整理，含 AI 辅助测试与设计	已完成	1. 测试：测试工程师（编写测试用例 200+，含 AI 辅助生成接口测试场景，每日执行测试并跟踪 Bug 修复）；2. 产品：产品经理（整理需求文档、接口规范文档、用户操作手册，兼 AI 设计界面资源方案）
跨校资源共享（试点）	对接周边 1 所高校，展示特色食堂菜品与基础信息	部分完成	1. 后端：后端 A（跨校菜品数据同步接口）；2. 前端：前端 A（学生端跨校菜品展示模块）；3. 产品：产品经理（跨校需求对齐与进度跟踪）

三、α 阶段改进计划完成情况（按分工落地）

α 阶段改进计划	具体内容	完成状态	实施细节与对应分工角色
接口规范化与统一	解决 “学生端 / 商家端接口格式不统一、错误码混乱” 问题	已完成	1. 后端：后端 A 牵头制定《接口规范文档》，后端 B 配合重构评价 / 反馈接口；2. 前端：前端 A / 前端 B / 前端 C 按规范适配页面请求，封装通用请求工具；3. 测试：测试工程师设计接口一致性测试用例，验证 12 个重构接口
数据库架构优化	解决 “表结构冗余、关联关系不清晰” 问题	已完成	1. 后端：后端 A（用户 / 店面表拆分与关联）、后端 B（评价 / 反馈表设计）协同梳理 7 大核心实体；2. 产品：产品经理输出《数据模型设计方案》，明确实体关系与字段定义；3. 测试：测试工程师执行数据库性能测试，高频查询接口速度提升 60%
三端权限细化	解决 “商家可查看其他店面数据、管理方权限过于集中” 问题	已完成	1. 后端：后端 A（学生 / 商家权限拦截逻辑）、后端 B（管理方角色权限控制）；2. 前端：前端 C（商家 / 管理方端权限级页面隐藏，越权访问自动跳转）；3. 测试：测试工程师设计权限测试场景，覆盖 15 种越权操作验证
页面加载速度优化	将页面加载速度提升至 1 秒内，减少缓存占用	已完成	1. 前端：前端 A（学生端首页懒加载）、前端 B（个人中心缓存优化）、前端 C（商家端数据分页加载）；2. 后端：后端 A（店面列表接口缓存策略）；3. 测试：测试工程师监测页面加载速度，首页从 1.5 秒优化至 0.7 秒

四、成员体验与收获（按分工角色分享）

组长王胤杰

作为产品经理兼 AI 设计，核心工作是 “平衡需求与落地可行性”—— 比如用户提出 “跨校订餐” 需求，考虑到开发周期（β 冲刺仅 2 周）与数据安全（跨校数据互通需多校协调），先落地 “跨校菜品展示”（P1 级需求），将 “跨校订餐” 纳入下一阶段（P2 级需求），避免因需求过载导致核心功能延期。通过 AI 工具生成界面原型，减少了 50% 的设计时间，同时组织前后端需求对齐会，避免了 “前端开发与后端接口理解偏差”，比如 “预约订餐模块” 中 “取餐时间精度” 的定义，提前明确为 “30 分钟一档”，确保前后端开发一致。这次经历让我掌握了 “小步快跑，快速迭代” 的项目管理方法，确保冲刺目标如期完成

前端开发 A 叶逸群

这次负责学生端首页与店面详情页，最大挑战是 “预约模块与库存的实时联动”—— 一开始没考虑到 “多用户同时预约同一菜品导致超售”，后来配合后端 A 的接口做了 “前端按钮置灰（库存为 0 时）+ 后端库存校验（提交订单时）” 双重防护，最终解决了超售问题。通过这次开发，不仅提升了 Vue 3 组合式 API 的使用熟练度，更理解了 “前端体验” 与 “后端逻辑” 的协同重要性，比如首页懒加载优化让加载速度从 1.2 秒降至 0.7 秒，用户反馈明显变好。

前端开发 B

专注学生端评价与反馈模块，印象最深的是 “评价标签的交互设计”—— 最初用下拉框选择标签，测试时测试工程师提出 “操作不够直观，需多次点击”，后来改成标签云样式（点击即可选中 / 取消），并配合产品经理的 AI 生成界面方案调整标签颜色（选中为主题色，未选中为灰色），最终用户操作效率提升 40%。另外，通过封装通用请求工具适配统一接口，减少了 30% 的重复代码，深刻体会到 “规范先行” 对前端开发效率的巨大提升。

前端开发 C

同时负责商家端与管理方端开发，最大难点是 “权限级页面控制”—— 比如商家端只能看到自己绑定的店面评价，管理方不同角色（运营专员 / 主任）看到的功能入口不同。通过解析后端返回的role字段，在路由守卫中做权限判断（如 “非主任角色隐藏‘商家审核’入口”），最终实现 “越权访问自动跳转至无权限提示页”。这次开发让我掌握了 “多端适配” 的技巧，比如商家端管理首页的图表组件，同时适配 Web 端大屏（1920px）与小程序小屏（375px），输出了可复用的响应式组件方案。

后端开发 A

负责用户与店面接口开发，核心突破是 “三端登录的统一权限校验”—— 通过 JWT 令牌携带role（角色）与user_id（用户 ID），配合全局拦截器实现 “一次校验，多接口复用”，解决了 α 阶段 “每个接口单独写权限逻辑” 的冗余问题，减少了 40% 的重复代码。另外，在设计店面表时，按产品经理的需求拆分为 “基础信息表（store_basic）” 与 “营业信息表（store_business）”，查询 “店面列表” 时仅需调用基础信息表，查询速度提升 60%，深刻理解到 “合理的表结构设计比后期代码优化更能提升性能”。

后端开发 B

专注评价与反馈接口，最大收获是 “异常场景处理的全面性”—— 比如评价提交时 “重复评价拦截”（通过 “订单 ID + 用户 ID” 唯一键约束）、反馈处理时 “状态流转校验”（只能从 “待处理”→“处理中”→“已解决”，不允许逆向流转），这些逻辑的完善让接口稳定性从 α 阶段的 92% 提升至 99%。同时，配合测试工程师的测试用例，修复了 “评价回复后店面平均评分未实时更新” 的 Bug，学会了 “从测试视角反推接口逻辑漏洞”，比如测试用例中 “评价删除后关联的标签数据未删除” 的场景，促使我补充了数据删除的关联逻辑。

测试工程师

首次尝试 “AI 辅助测试”，通过 AI 工具基于接口文档自动生成 100 + 参数组合用例，覆盖了 “边界值”（如 “预约时间选择当前时间前 1 小时”）、“异常参数”（如 “学号输入特殊字符”）等人工易忽略的场景，比如发现 “预约时间选择过去时间时接口未拦截” 的高危 Bug，避免了上线后用户提交无效订单的问题。另外，通过每日测试与 Bug 跟踪，确保 38 个 Bug 全部修复并验证，其中高危 Bug 修复率 100%，深刻体会到 “测试不是最后一道防线，而是全程保障”—— 比如早期发现 “商家端评价回复接口无权限校验”，及时反馈后端补充权限逻辑，避免了上线后数据安全风险。

五、成员贡献度分配（按实际分工与产出）

姓名	角色	核心工作内容	贡献度
组长王胤杰	后端开发A 产品经理	统领全局，负责后端开发	15%
叶逸群	前端开发 A	负责前端开发、总结博客编写	15%
王可晨	前端开发 B	负责前端开发、PPT编写	15%
何闽新	前端开发 C	负责前端开发、每日博客编写	15%
余传斌	后端开发 B	负责部分开发、用户调查	12.5%
蔡翔年	后端开发 C	负责部分开发、代码规范编写	12.5%
李乐阳	ai技术员测试工程师	负责AI 测试、评审表和演讲	15%

八、后续规划

β 阶段通过七人分工协作，完成了 “接口统一”“数据库搭建”“三端功能落地” 三大核心目标，为平台后续迭代打下坚实基础。下一阶段将重点推进三项工作：1. 基于现有接口拓展 “校园一卡通支付” 功能（后端 A + 后端 B 负责支付接口开发，前端 A 负责学生端支付模块），实现 “预约→支付→取餐” 全流程闭环；2. 完善商家资质审核功能（前端 C 负责管理方审核页优化，产品经理负责需求对齐与流程规范），规范商家入驻标准；3. 优化店面推荐算法（后端 B 负责算法逻辑开发，测试工程师负责算法测试，产品经理负责 AI 推荐方案设计），基于用户偏好推荐个性化店面。同时，持续收集三端用户反馈，打磨细节体验（如 “学生端订单提醒推送”“商家端订单打印功能”），让平台更贴合校园餐饮场景需求。

...全文