53 lines
1.2 KiB
Markdown
53 lines
1.2 KiB
Markdown
# Jungle Treasure 后端模块
|
||
|
||
Laf 云函数采用单模块结构：
|
||
|
||
- `functions/jungleTreasure.ts`：礼包配置、类型、状态工具、客户端读取和领取接口；
|
||
- `functions/jungleTreasure.yaml`：对应的 Laf 云函数定义。
|
||
|
||
其他云函数统一通过下面的方式引用公共模块：
|
||
|
||
```ts
|
||
import {
|
||
getJunglePaidTierByProductId,
|
||
unlockJungleTierByProductId,
|
||
} from "@/jungleTreasure";
|
||
```
|
||
|
||
不再保留独立的 `jungleConfig`、`jungleState` 和 `types` 模块。
|
||
|
||
## 状态规则
|
||
|
||
- `0`：付费档位未解锁；
|
||
- `1`：已解锁未领取，免费档位默认是 `1`；
|
||
- `2`：已经领取。
|
||
|
||
状态数组固定为 51 项。领取接口不检查前置档位，只检查目标档位自身是否为 `1`。
|
||
|
||
付费商品依次对应第 `4/10/16/22/28/34/40/46` 档。支付回调根据 `jungleTreasure.ts` 中的 `productId` 查找档位，不在支付代码中重复维护映射。
|
||
|
||
## 接口
|
||
|
||
读取：
|
||
|
||
```json
|
||
{
|
||
"action": "read",
|
||
"uid": "用户 _id",
|
||
"token": "登录 token"
|
||
}
|
||
```
|
||
|
||
领取：
|
||
|
||
```json
|
||
{
|
||
"action": "claim",
|
||
"uid": "用户 _id",
|
||
"token": "登录 token",
|
||
"tierId": 5
|
||
}
|
||
```
|
||
|
||
原来的 `save` 操作已停用。旧版 `claimedTierIds` 数据会在首次读取时自动迁移为三状态数组。
|