商城模块开发 wiki

商城模块开发

每个版本相关责任人务必按以下要求进行版本的推进。

\	责任人	备注
产品	XXX	输出需求文档
测试	XXX	输出测试用例
前端	XXX	细分前端解决方案、在Coding拆分任务、评估开发工时
后端	XXX	细分后端解决方案、在Coding拆分任务、评估开发工时

需求清单：

• 商品分类：新增商品类别,方便商品筛选
• 商品管理: 商品的管理,增删改查
• 商城币：系统中的商品兑换货币。
• 硬件授权：对接的安卓设备进行授权,能执行兑换商品下单操作。
• 商品订单：创建订单 修改订单状态 退单 列表展示 支持兑换机兑换商品。
• 学校学生账户列表：筛选显示学生在当前时段的账户数量 支持导出
• 商城币获取/消费流水: 操作产生的流水数据入库操作

需求细分（含解决方案）：

• 商品分类：增删改查
• 商品管理: 增删改查 支持商品图片批量导入 商品信息批量导入 支持置顶 批量设置商品兑换提醒老师功能/批量上下架/批量删除/
• 商城币：系统中的商品兑换获币。
• 硬件授权：对接的安卓设备进行授权,能执行兑换商品下单操作。
• 商品订单：增删改查,高并发的控制，库存扣减的控制，这里要求做双重锁的检查，缓存数据的原子扣减判断 + 数据库的大于兑换额度的判断。
• 学校学生账户列表：创建账户信息,流水有变动进行触发账户数据更新 支持导出
• 商城币获取/消费流水:操作产生的数据入库操作 产生的流水数据入库 支持导出
• 从原服务中把积分商城管理的逻辑迁移到mall模块，商品信息、库存的增删改逻辑需要增加缓存
• 目前已经迁移到mall的逻辑，保留与H5、硬件相关的接口，并把缓存使用起来
• 这个和外部对接的部分，需要特别注意
• 兑换功能的接口需要进行压测，达到并发 1200/s
• 接口参数，需要遵循标准规范，进行统一的参数验证，用户信息按新方式获取

功能接口

模块	说明	时间
商品管理	商品管理,商品筛选,设置商品兑换限制使用班级,批量设置提醒教师,批量删除,批量下架,批量上架,批量导入商品 excel,批量导入商品图片,商品名唯一性判断, 缓存	15h
商品类别管理	商品类别管理,增删改查	1h
教师列表	全校教师	1h
全校班级	提供年级班级列表	1h
学校花名册	年级,班级,学生关联关系	1h
订单管理	订单列表,退单,确认订单,导出订单,批量领取,批量退单,筛选	5h
商城用户资产	筛选,分页显示商城币数量,导出	4h
兑换柜兑换	人脸数据提供,卡号获取用户信息,设备授权	5h
货币管理	货币流水,溯源,新学期清零归档(账户表冗余上次结算流水的最新的id)	5h

需求计划：

本次需求由产品xxx提出，测试xxx测试，前端（xxx）参与，后端（xxx）参与，预估开发5天。

版本开发周期：2024-02-01 ~ 2024-02-06

\	时长(H)	备注
开发	41h	后端开发、接口联调