补齐相关日志日志

README.md

@@ -199,7 +199,8 @@ curl http://localhost:<HttpPort>/ping
 | `WechatVirtualPay` | 小程序虚拟支付（XPay） | `Enable`（是否启用）/`OfferID`/`EnvAppKey`（现网 AppKey）/`SandboxAppKey`（沙箱 AppKey）/`Token`（消息推送验签）；与普通微信支付独立商户号、独立结算，虚拟商品（会员/额度包）须走此通道。**环境自动选择**：只填 `SandboxAppKey` 走沙箱测试（不真实扣款），只填 `EnvAppKey` 或两把都填走现网（现网优先） |
 
 > **虚拟支付道具同步由管理后台负责，服务端不会自动同步**：商品发布为虚拟支付道具（上传/发布、改价）由管理后台完成，并将微信侧返回的 `product_id` 与 `product_status` 回填到 `goods` 表后，虚拟商品才可下单。**运营改价后必须通过管理后台同步道具价格**，否则微信侧道具价格与本地不一致：微信扣款多于订单金额时发货金额校验会拒绝（用户付款拿不到权益），少于订单金额时产生差价资损。
-| `UserDefaultQuota` | 新用户免费额度与赠送会员 | `Cos`（**永久**额度，未配置回落 20）、`AI`/`OutfitShare`/`ClosetShare`（**每日**额度，未配置回落 3/10/5，每天 0 点重置；可显式配 **0** 表示不赠送）、`GiftVIPDay`（注册赠送体验会员天数，未配置回落 3 天，可配 **0** 关闭；负数回落默认） |
+| `UserDefaultQuota` | 新用户**免费额度** | `Cos`（**永久**额度，未配置回落 20）、`AI`/`OutfitShare`/`ClosetShare`（**每日**额度，未配置回落 3/10/5，每天 0 点重置；可显式配 **0** 表示不赠送）。与会员身份无关，所有用户长期享有 |
+| `NewUserGift` | 新用户注册赠送的**体验会员及其额度** | `GiftVIPDay`（体验会员天数，未配置回落 3 天，可配 **0** 表示不赠送会员）、`Cos`/`AI`/`OutfitShare`/`ClosetShare`（体验会员额度，未配置回落 0/3/3/3）。额度以**体验会员凭证**（`source=4`）发放，**有效期为固定值 = 注册时刻 + 体验天数**（⚠️ 不跟随 VIP 延长，否则用户后续充值会把体验额度一直「继承」下去）；`GiftVIPDay` 配 0 时额度一律不发放。与 `UserDefaultQuota` 的免费额度**叠加生效** |
 | `AdReward` | 广告激励额度 | `Enable`（是否开启，关闭时接口返回「广告激励未开启」）、`Cos`/`AI`/`OutfitShare`/`ClosetShare`（各类型**固定金额**，服务端定价，前端不传金额；可删或置 0 表示不发放该类型） |
 | `Tokenhub` | 大模型网关 | `APIKey`、`Model`（默认 hy4）；**模板中缺失，需手动补充（见快速开始）** |
 
@@ -213,8 +214,9 @@ curl http://localhost:<HttpPort>/ping
 
 ```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 额度 → 大模型生成 → 待用户保存"]
@@ -229,7 +231,7 @@ flowchart TD
 
 全系统共 7 条业务主线：
 
-1. **注册与额度**：微信登录首次自动注册，初始化 Cos **永久**免费额度（内置默认 20），AI 推荐 / 搭配分享 / 衣柜分享为**每日**额度（内置默认 3/10/5，可由 `UserDefaultQuota` 覆盖，**允许显式配 0** 表示不赠送；未配置或负数回落默认），每日额度不落库、按当天计数每天 0 点重置；并赠送体验会员（`vip_type=4`，内置默认 3 天，可由 `UserDefaultQuota.GiftVIPDay` 覆盖，**允许配 0 关闭**），同时下发一条系统通知；会员已过期时接口返回的 `vip_type` 归一为 1。
+1. **注册与额度**：微信登录首次自动注册，先初始化**免费额度**（`UserDefaultQuota`：Cos **永久**默认 20，AI 推荐 / 搭配分享 / 衣柜分享为**每日**默认 3/10/5，**允许显式配 0**；未配置或负数回落默认，每日额度不落库、按当天计数每天 0 点重置），再赠送**体验会员及其额度**（`NewUserGift`：开通 `vip_type=4` 默认 3 天、**允许配 0 关闭**，并发放 `source=4` 体验会员额度凭证，**固定有效期为体验期结束、续费不会延长**，与免费额度叠加），同时下发一条系统通知；会员已过期时接口返回的 `vip_type` 归一为 1。
 2. **衣物生命周期**：上传（校验 + 扣额）→ 异步 AI 处理（抠图 → 分类）→ 成功入库可被选用；失败自动回退额度；删除软删并回退额度。
 3. **穿搭与社区**：创建穿搭 → 公开（审核自动通过 + 扣分享额度）→ 其他用户点赞/收藏 → 触发通知。
 4. **衣柜分享**：部分衣物或全量快照分享 → 扣额度 → 属主/访客查看（访客访问即记录接收关系）→ 取消或到期懒过期；"分享给我的"列表联表查询接收关系。
@@ -665,11 +667,11 @@ flowchart TD
 | 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 | 创建时间戳（秒） |
 
 #### 1. 用户模块
@@ -680,7 +682,7 @@ flowchart TD
 
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| code | string | 是 | 微信登录 code（`wx.login` 获取），首次登录自动注册并初始化免费额度 |
+| code | string | 是 | 微信登录 code（`wx.login` 获取），首次登录自动注册：初始化免费额度 + 赠送体验会员及额度 |
 
 响应 `data`：
 
@@ -1313,7 +1315,7 @@ sequenceDiagram
     F->>B: POST /user/wxlogin {code}
     B->>W: code2session(code)
     W-->>B: openid / session_key
-    B->>B: 首次登录：注册用户 + 初始化免费额度
+    B->>B: 首次登录：注册用户 + 初始化免费额度 + 赠送体验会员及会员额度
     B-->>F: {access_token, refresh_token, expire_time, user_info}
 
     Note over F,B: access_token 过期（业务码 11002 / HTTP 401）