翠刚视频讲解
福袋
状态转移图
下面 终止、完成 统称为 结束
- 注意，上面的所有通过时间来改变状态的，都是后台服务器整分钟定时器来改变的，因此可能存在延时，但一般在一分钟以内
- 客户端计算的倒计时以客户端为准，因此时间偏差还取决于客户端时间是否准确
常规福袋
上下架：和上面的状态独立开来，比如售卖中也可下架。下架即前端看不到
开始时间：福袋的开始售卖时间；到开始时间后自动转为售卖中状态；只有此状态才能售卖。
- 保存时如果开始时间小于等于当前时间，则状态直接变为
售卖中
结束时间：到结束时间后如果当前为售卖中，则状态变为终止。
结束方式
- 倒计时结束
- 卖完自动结束
- 管理员后台手动结束（？？）
开奖类型 & 退款方式
- 满开：所有盒子卖完再开奖。如果结束了还没卖完，则全部退款。
- 即买即开：买后即知道中的是哪个商品其他。如果结束了还没卖完，则不退款。
其他属性：
- 名字
- 备注(TODO: 之前遗漏的)
- 配图一个
- 参考价格（福袋有统一的价格配置，但每个盲盒可以有单独的配置）
- 关联的盲盒列表
购买方式：一次只能购买一个，次数不限制
排序 & 额外奖品
-
用
微信订单号排序，展示总的排名，具体规则：- 先用后三位比较，如果相同，再用倒数第四位；以此类推
- 前端展示只显示后三位
-
可配置每个名次额外得到的奖品，如第2、3、8名（其他名次无额外奖品）分别获得的奖品，并且展示当前的排名对应的奖品
-
待支付的订单不能让用户看到微信订单号
后台盲盒上传配置
- 批量上传多张图，每张图对应一个盲盒；
- 上传后可以有以下操作（
原图不用）： 
- 复制时将所有属性一起复制
- 可选输入名字
- 可选输入参考价格，如果没有用福袋的
- 可选输入个数，默认为1
- 可选输入贝壳价值，默认为0
- 必须输入品相，品相(TODO: 之前遗漏的)：全新未拆盒，拆盒未拆袋，已拆袋，默认 全新未拆盒
- 编辑时每条盲盒带上id，提交修改时，有id的修改，没有的新增；不存在的删除
一键复制福袋
- 复制后进入编辑页面，点击保存才真正写入数据库
- 所有的数据都要复制，包括盲盒；但图片的 url 可以共用。
其他
- 已经购买的位置，显示购买者的头像
- 简单起见，一旦福袋有用户购买了，则不允许修改任何信息，也不允许删除；反之可以
超级福袋
超级福袋可以看成就是由多个常规附带组成的。其中一个常规福袋作为一个一级福袋。然后另外有1-n个常规福袋作为二级福袋。因此上面讲的这些常规附带的规则基本都适用于超级福袋里面的一二级福袋。这里仅讲一下他们之间的区别。
- 全部都是满开。没有即买即开
作为一级福袋时
- 没有排序
- 同样一组盲盒会被售卖多轮。轮次由二级福袋的盲盒的个数决定。
- 结束时间是指的多轮的总共的截止时间。而不是指每一轮的结束时间。
作为二级福袋时
- 不需要购买。位置的选购资格是由一级福袋的满开后的结果决定的。
- 没有结束时间。只不过他的选则需要一个倒计时时间。这个倒计时时间是指超级福袋
结束之后，如果二级福袋还没有及时选择，给的一个二级福袋的选择时间。
没有售完需要退款时
比如一级福袋卖了三轮。然后第四轮卖了五个。这个时候超级福袋结束了。
一级福袋的的退款
- 前三轮的不退，第四轮的五个退。
二级福袋的处理，说明视频
- 对应盲盒正常开奖
- 排名能排对少算多少
小程序接口
首页
曲子陌
- 超级福袋的id 以及 热卖、即将开售列表
cyb
- 后台编辑的弹幕 barrage/list
背包
待定
- 背包列表（TODO: 原型中缺失自动发货的倒计时） yxt
- 发货
- 兑换
我的
订单列表
常规福袋
曲子陌
- 在商城订单的结构基础上（数据结构、排序、分页等同商城订单）
- 返回关联的福袋id
- 用户购买的位置
- 微信订单号（待付款状态不能返回）
超级福袋
曲子陌
- 基本同常规福袋，附加几点：
- 如果中的是二级福袋的资格，则额外返回：
- 二级福袋 id、name
- 最终选择的二级福袋的位置、商品信息（TODO: design)
地址管理
待定
- 城市数据，json
后台管理需求
通用
列表页
查询：参照商城订单管理
- 基本信息没有特殊说明都可以查询，如果是时间则查询时间段
- 重置：重置查询
导出：都需要。按照页面展示的样子导出，也参照商城订单的导出
基本信息都直接展示，不要点击按钮再展示
列表操作：
- 详情：界面同编辑，但是不能编辑，只能查看
都有分页
超级福袋订单列表页
- 取消：确认发货、渠道、地址信息
- 微信订单号
- 福袋编号。主福袋编号？？
- 支付时间
- 退款？？
每个盲盒：
-
图片
-
盲盒名字
-
用户处理状态：待处理、待发货、已发货、已完成、已兑换
-
来源
- 福袋：常规福袋+编号+福袋名称；二级福袋+编号+福袋名称
- 排名：排名值
-- 用户管理
hcg https://www.eolink.com/share/index?shareCode=EHmQ2m 密码:123456
从老后台迁移到新后台，贝壳明细接口可以先不给
积分：在之前积分签到的逻辑上叠加，保留积分签到备用
-
可用积分，用于后面的消费
-
总积分，用于等级计算。注意，退款要减，其他情况不减。
等级（暂时不做了，规则不太合理）：每次更新积分时更新等级。规则：https://mnwg75o1yb.feishu.cn/file/boxcnxVReXe5ZvJiH3WlqtZXW1b p14
小卖部调整需求
新建商品
发货模式以及发货天数（列表页也要加入，两个字段），选择：
- 现货发货模式（默认支付成功以后三天内发货，可改） - 默认
- 预售发货模式（填写支付成功以后XX天发货，必填）
sku编辑，增加两列：
- 库存
- 图片
- 即每个sku都有自己的图片（用于前端切换sku时展示）以及库存。
售后与服务
- 是否支持7天无理由退款
TODO: 前端相应调整，设计（参考京东）yxt
-- 2023-4-6 hcg
- -- 不要供货商必填
- 改库存，有无限制（可以不用）？用户购买的限制做了没(需要返回剩余库存，总库存可以不用返回）？
- -- 背包
- 列表
- 发货
- 兑换
- -- user/info 返回剩余积分、总积分、贝壳余额
-- 订单打印对接 hcg
-- 2023-4-17 hcg
- 视频说明1
- 加个小任务：把powder生成的数据清理代码维护下，主要是清理下生成的福袋，以及相关的数据（订单，盲盒等）
- 前后端的api：放到 mvc 相关代码都放对应的 blindbox 文件夹下，controller route 如何配置？
- 包括route，放blindbox.
- OrderBox 改名为 Order，因为 OrderBox 有自己的含义
- 需要加一个贝壳变化流水表（类型：兑换、消费、管理员增减）
- blindbox-api\api\v1\services\blindbox\OrderBoxService.php // TODO
- powder 说明
* 修改背包列表返回数据dispatch_order_no字段的数据类型, 避免powder验证不通过
这种可以直接修改powder不验证类型：
"__dispatch_order_no": "t", // type null key ignore
"dispatch_order_no": "B1077403364" // 发货订单号(可使用此订单号查看物流信息)
- 后台用户管理接口，手机号支持模糊查询，并返回贝壳余额
- 贝壳明细接口，用上面提到的流水表。参见用户管理
- 积分：两种订单都需要给用户增加积分
- 小卖部：支付后
- 盲盒：满开后
- TODO: 即买即开，支付后，这个后面再处理
- 退款减积分
管理后台设计
背包管理 -- 暂时不用
订单管理 cyb
- 需要退款功能，手动输入金额
马辉 2023-4-8
- 昵称、头像适配（接口应该要改）
- UI
- 首页
- 福袋详情页
- 背包
- 订单详情
- 老商城的：
- 商品详情页
- 售后与服务
- tab 组件抽取，已经做了，review下
- checkbox 用uniapp的？
