补齐相关日志日志
This commit is contained in:
@@ -473,11 +473,11 @@ Authorization: Bearer <access_token>
|
||||
| quota_flow_uuid | string | 流水 UUID |
|
||||
| quota_type | int | `1`=上传 `2`=AI `3`=社区分享 `4`=衣柜分享 |
|
||||
| change_target | int | `1`=配额调整 `2`=使用 |
|
||||
| change_type | int | `1`=购买获赠 `2`=活动赠送 `3`=上传消耗 `4`=删除回退 `5`=人工调整 `6`=退款回收 |
|
||||
| change_num | int64 | 变更数量（**正数为增加，负数为减少**） |
|
||||
| change_type | int | `1`=购买获赠 `2`=活动赠送 `3`=上传消耗 `4`=删除回退 `5`=人工调整 `6`=退款回收 `7`=**到期失效**（固定有效期的额度凭证过期，由后台任务每小时补记） |
|
||||
| change_num | int64 | 变更数量（**正数为增加，负数为减少**；到期失效为负数） |
|
||||
| new_value | int64 | 变更后的数值 |
|
||||
| reason | string | 变更原因 / 备注 |
|
||||
| order_no | string | 关联订单号（购买类流水才有） |
|
||||
| order_no | string | 关联订单号：购买/退款类为真实订单号；赠送/消耗/回退/到期类由后端填充流水 UUID 或凭证 `ref_id`，用于满足唯一索引幂等 |
|
||||
| created_at | int64 | 创建时间（秒） |
|
||||
|
||||
### 4.8 微信支付参数 `pay_params`
|
||||
@@ -507,7 +507,11 @@ Authorization: Bearer <access_token>
|
||||
**业务逻辑**
|
||||
|
||||
1. 前端 `wx.login()` 获取 `code`，传给后端；后端用 `code2session` 换 `openid`。
|
||||
2. **首次登录自动注册**：昵称默认"微信用户"，`status=1` 正常，返回 `is_new_user=true`；同时**自动初始化 4 类免费额度**（内置默认：上传 20 / AI 推荐 3 / 搭配分享 10 / 衣柜分享 5；可由服务端配置 `UserDefaultQuota` 覆盖，允许配置为 0），并**赠送体验会员**（`vip_type=4`，内置默认 3 天；可由 `UserDefaultQuota.GiftVIPDay` 配置，配 0 表示不赠送），赠送成功后下发一条系统通知「欢迎礼包已到账」。因此新用户返回的 `vip_type` 通常为 `4`（配置为 0 时为 `1`）。
|
||||
2. **首次登录自动注册**：昵称默认"微信用户"，`status=1` 正常，返回 `is_new_user=true`，随后依次赠送两样东西：
|
||||
- **免费额度**（`UserDefaultQuota` 段，与会员身份无关、所有用户长期享有）：内置默认上传 20 / AI 推荐 3 / 搭配分享 10 / 衣柜分享 5，允许显式配置为 0；
|
||||
- **体验会员及其额度**（`NewUserGift` 段）：开通 `vip_type=4` 体验会员（内置默认 3 天，配 0 表示不赠送会员），并按该段配置发放**体验会员额度凭证**（`source=4`，如右上表；有效期是**固定值** = 注册时刻 + 体验天数，**不随后续续费延长**）。内置默认上传 0 / AI 3 / 搭配分享 3 / 衣柜分享 3。这部分额度与上面的免费额度**叠加生效**。
|
||||
|
||||
两段配置都支持显式配 0 表示不赠送；`GiftVIPDay` 配 0 时，体验会员额度一律不发放。赠送成功后下发一条系统通知「欢迎礼包已到账」。因此新用户返回的 `vip_type` 通常为 `4`（配置为 0 时为 `1`）。
|
||||
3. 并发首次登录不会注册重复账号（依赖 `wx_open_id` 唯一索引）。
|
||||
4. 账号被禁用/注销（`status != 1`）时返回 `21001`，HTTP 仍是 200。
|
||||
5. 额度初始化失败**不影响登录**（仅后端告警）。
|
||||
@@ -617,7 +621,11 @@ Authorization: Bearer <access_token>
|
||||
|
||||
### 5.2 额度模块
|
||||
|
||||
全站共 **4 类额度**：**上传额度为永久额度（不每天重置）**；**AI 推荐 / 社区分享 / 衣柜分享为每日额度（每天 0 点重置）**。免费额度由服务端配置 `UserDefaultQuota` 覆盖（下表「新用户默认」为内置兜底值，**允许配置为 0**，表示不赠送该类免费额度）：
|
||||
全站共 **4 类额度**：**上传额度为永久额度（不每天重置）**；**AI 推荐 / 社区分享 / 衣柜分享为每日额度（每天 0 点重置）**。
|
||||
|
||||
额度有两个来源，**叠加生效**：
|
||||
|
||||
**① 免费额度** —— 由服务端配置 `UserDefaultQuota` 控制，所有用户长期享有、与会员身份无关（下表「新用户默认」为内置兜底值，**允许配置为 0**，表示不赠送该类免费额度）：
|
||||
|
||||
| quota_type | 名称 | 类型 | 新用户默认 | 消耗场景 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
@@ -626,7 +634,18 @@ Authorization: Bearer <access_token>
|
||||
| 3 | 社区分享额度（搭配分享） | 每日 | 10 | 穿搭首次公开扣 1 |
|
||||
| 4 | 衣柜分享额度 | 每日 | 5 | 创建一次衣柜分享扣 1 |
|
||||
|
||||
> 购买赠送额度以**额度凭证**（`quota_grants`）发放，分三类来源：**会员包**（随 VIP 有效期，续期自动延长）、**加量包**（独立有效期 `goods.valid_days`，到期失效）、**广告激励**（当天 23:59:59 到期，金额由服务端 `AdReward` 配置固定，开关控制）。Cos 消费先扣「即将过期凭证」再扣免费额度；每日额度总额 = 免费配置 + 有效凭证赠送额。
|
||||
**② 额度凭证**（`quota_grants`）—— 有有效期的赠送额度，按来源分三类：
|
||||
|
||||
| source | 来源 | 有效期 |
|
||||
| --- | --- | --- |
|
||||
| 1 | 会员包（购买） | `expire_time=0`，**跟随 VIP**：VIP 到期自动失效，续期自动延长 |
|
||||
| 2 | 加量包（购买） | 独立有效期 `goods.valid_days`，到期失效 |
|
||||
| 3 | 广告激励 | 当天 23:59:59 到期（金额由 `AdReward` 配置固定，开关控制） |
|
||||
| 4 | 体验会员赠送（新用户注册） | **固定有效期** = 注册时刻 + 体验天数，**不随后续续费延长** |
|
||||
|
||||
> 新用户注册时，`NewUserGift` 段配置的体验会员额度以 **source=4** 凭证发放；`GiftVIPDay` 配 0（不赠送会员）时这部分额度一律不发放。
|
||||
> ⚠️ 体验额度**不会**被后续充值「继承」：用户 3 天体验期后再购买会员，体验额度照常失效，只剩免费额度 + 新购会员包额度。
|
||||
> Cos 消费先扣「即将过期凭证」再扣免费额度；每日额度总额 = 免费配置 + 有效凭证赠送额。
|
||||
|
||||
#### GET `/quota/info` — 额度概览（鉴权）
|
||||
|
||||
@@ -1827,8 +1846,9 @@ wx.requestVirtualPayment({
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["微信登录<br/>新用户自动注册"] --> B["初始化免费额度<br/>默认 上传 20 / AI 3 / 搭配分享 10 / 衣柜分享 5<br/>（可配置，允许为 0）"]
|
||||
B --> C["上传衣物<br/>校验 → 扣上传额度 → 异步 AI 抠图 + 分类"]
|
||||
A["微信登录<br/>新用户自动注册"] --> B["初始化 4 类免费额度<br/>默认 上传 20 / AI 3 / 搭配分享 10 / 衣柜分享 5<br/>（可配置，允许为 0）"]
|
||||
B --> B2["赠送体验会员 + 会员额度<br/>默认 3 天；AI 3 / 分享 3 / 衣柜 3<br/>（体验会员凭证 source=4，固定到期）"]
|
||||
B2 --> C["上传衣物<br/>校验 → 扣上传额度 → 异步 AI 抠图 + 分类"]
|
||||
C --> D["衣橱管理<br/>查看 / 修正属性 / 删除回退额度"]
|
||||
D --> E["创建穿搭"]
|
||||
D --> F["AI 穿搭推荐<br/>扣 AI 额度 → 大模型生成 → 待用户保存"]
|
||||
@@ -1982,6 +2002,9 @@ stateDiagram-v2
|
||||
| 创建衣柜分享 | **扣 1 个衣柜分享额度** | — |
|
||||
| 创建衣柜分享但明细写入失败 | **自动回退** | 重试即可 |
|
||||
| 取消衣柜分享 | **不返还** | 二次确认 |
|
||||
| 新用户注册 | **发放**：免费额度 + 体验会员额度（`NewUserGift`，`source=4` 凭证，固定有效期=体验期结束） | 「欢迎礼包已到账」 |
|
||||
| 固定有效期额度过期 | **自动失效**：到期即不再计入有效额度；**后续充值续费不会延长它**（跟随 VIP 的凭证则不受影响，续期自动延长） | 无感知，剩余额度同步下降 |
|
||||
| 额度过期记账 | 后台任务**每小时**为已过期的固定有效期凭证补记 `change_type=7`（到期失效）流水，变更量为负数（幂等，重复执行不会重复记账） | 额度明细里能看到 `-N 到期失效`，账目闭环 |
|
||||
| 购买商品支付成功 | **发放**（按订单快照） | 展示"已到账" |
|
||||
| 退款成功 | **回收**（`total >= used`，已用部分不退） | 提示额度已回收 |
|
||||
|
||||
@@ -2016,7 +2039,7 @@ sequenceDiagram
|
||||
F->>B: POST /user/wxlogin {code}
|
||||
B->>W: code2session(code)
|
||||
W-->>B: openid / session_key
|
||||
B->>B: 首次登录：注册用户 + 初始化 4 类免费额度
|
||||
B->>B: 首次登录：注册用户 + 初始化 4 类免费额度 + 赠送体验会员及会员额度
|
||||
B-->>F: {access_token, refresh_token, expire_time, user_info}
|
||||
|
||||
Note over F,B: 后续请求携带 Authorization: Bearer <access_token>
|
||||
|
||||
Reference in New Issue
Block a user