报备契约队α冲刺准备随笔：代码规范、任务计划与分工

[报备契约队]

一、代码规范

（参考阿里巴巴Java开发手册终极版v1.3.0、华为内部代码规范）

（一）通用规范

1. 命名原则：采用有意义的名称，避免拼音或模糊缩写，遵循"见名知意"原则。
2. 注释要求：类、方法、核心逻辑块必须添加注释，注释需准确描述功能与逻辑，避免"注释与代码不符"。
3. 格式规范：使用4个空格缩进，行尾无空格，文件编码统一为UTF-8，遵循"一行一语句"原则。

（二）后端Java规范

1. 结构规范：

   • 严格遵循"Controller-Service-Dao"三层架构，包路径示例：com.shiguangjianke.controller.user
   • 类名使用UpperCamelCase（如StudentController），方法名/变量名使用lowerCamelCase（如bindStudent）
   • 常量全大写且用下划线分隔（如MAX_IMAGE_COUNT = 3）

2. 代码规范：

   • 方法长度不超过80行，参数不超过5个，超过时用对象封装
   • 异常处理：自定义BusinessException，全局异常处理器统一返回格式{"code":xxx,"message":"xxx","data":xxx}
   • 数据库操作：使用MyBatis-Plus，SQL语句避免SELECT *，添加必要索引

3. 安全规范：

   • 密码采用BCrypt加密存储，禁止明文传输
   • 接口参数需校验（非空、格式），使用JWT进行身份认证
   • 敏感数据（如学号）传输时脱敏（显示前4后2中间用*）

（三）前端UniApp规范

1. 结构规范：

   • 页面文件用kebab-case命名（如store-detail.vue），组件文件前缀com-（如com-evaluation-card.vue）
   • 目录划分：/pages（页面）、/components（组件）、/utils（工具）、/static（静态资源）

2. 代码规范：

   • 脚本部分按"数据定义-生命周期-方法"顺序排列
   • 样式使用scoped隔离，公共样式放在/common/style
   • 禁止使用var，统一用let/const，条件判断用===而非==

3. 交互规范：

   • 按钮点击添加loading状态，避免重复提交
   • 网络请求统一封装在/utils/request.js，处理异常提示
   • 页面跳转使用路由管理，参数传递通过navigateTo({url: 'xxx?param=xxx'})

二、本次alpha冲刺任务与计划

1. 前端任务

核心目标：完成学生端、商家端、管理方端核心页面开发，实现基础交互与接口对接。

• 学生端：

  • 登录页：微信授权+身份绑定（学号+姓名）
  • 首页：搜索栏+食堂标签+店面列表（卡片展示）
  • 店面详情页：轮播图+菜品+评价入口
  • 评价编辑页：4维度评分+文字输入+图片上传（≤3张）
  • 反馈提交页：类型选择+内容+图片佐证
  • 个人中心：我的评价/收藏/反馈列表

• 商家端：

  • 登录页：账号密码登录
  • 管理首页：数据卡片+功能入口
  • 店面信息编辑页：基础信息+营业时间+菜品管理
  • 评价管理页：评价列表+回复功能

• 管理方端：

  • 登录页：管理员账号登录
  • 后台首页：核心指标统计
  • 反馈处理页：反馈列表+状态更新+结果填写

2. 后端任务

核心目标：开发核心接口，实现数据存储、业务逻辑与权限控制，支撑前端功能。

• 用户管理模块：

  • 学生身份绑定接口（对接校园身份系统）
  • 商家/管理方登录接口（含密码加密与锁定逻辑）
  • JWT身份认证与权限控制（区分学生/商家/管理方角色）

• 店面管理模块：

  • 店面列表查询接口（支持多条件筛选+Redis缓存）
  • 店面详情查询接口
  • 商家店面信息编辑接口

• 评价管理模块：

  • 评价提交接口（对接OSS存储图片+实时更新评分）
  • 评价列表查询接口
  • 商家评价回复接口（含微信通知）

• 反馈管理模块：

  • 反馈提交接口
  • 反馈状态查询接口
  • 管理方反馈处理接口（含状态同步）

三、分工

角色	成员	核心职责
前端开发A	叶逸群	学生端登录页、首页、店面详情页开发与接口联调
前端开发B	王可晨	学生端评价编辑页、反馈提交页、个人中心开发与接口联调
前端开发C	何闽新	商家端（登录/管理首页/评价管理）、管理方端（登录/反馈处理）开发与联调
后端开发A	余传斌	用户管理接口（身份绑定/登录）、店面管理接口（列表/详情/编辑）开发
后端开发B	蔡翔年	评价管理接口（提交/列表/回复）、反馈管理接口（提交/查询/处理）开发
测试工程师	李乐阳	编写测试用例（含AI辅助生成）、执行每日测试、记录Bug并跟踪修复（兼AI测试）
产品经理	王胤杰	需求对齐、进度跟踪、界面审核、文档整理（兼AI设计，生成界面与资源方案）

四、时间计划（7天）

日期	核心任务	交付物
第1天	环境搭建（前后端项目框架）、需求对齐、代码规范同步	前端/后端项目框架、数据库初始化脚本、任务拆解清单
第2天	学生端登录页开发、用户管理接口开发（身份绑定/商家登录）、接口联调	登录页（含微信授权）、2个用户接口、接口测试报告
第3天	学生端首页/店面详情页开发、店面管理接口开发（列表/详情）、联调	首页（含筛选）、店面详情页、2个店面接口、功能测试报告
第4天	学生端评价编辑页开发、评价管理接口开发（提交/列表）、联调	评价编辑页（含图片上传）、2个评价接口、评价功能测试报告
第5天	学生端反馈页/个人中心开发、反馈管理接口开发（提交/查询）、联调	反馈提交页、个人中心、2个反馈接口、反馈功能测试报告
第6天	商家端评价管理页、管理方反馈处理页开发、跨角色接口联调（回复/处理）	商家评价管理页、管理方反馈处理页、联调测试报告、Bug清单
第7天	Bug修复（阻断级优先）、验收测试、α版本部署、文档整理、复盘会	小程序测试包、后端部署包、验收测试报告、交付文档（功能清单+操作手册）

冲刺目标：完成核心功能开发，确保学生能顺畅完成"选店-评价-反馈"、商家能"回复评价-编辑信息"、管理方能"处理反馈"，交付无核心Bug的α版本。