更新记录

1.0.0（2026-04-13） 下载此版本

1.0.0发布

平台兼容性

云端兼容性

阿里云 腾讯云 支付宝云
√ √ √

uni-app(4.87)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ - - - - - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
3.5.8 - - - - - - - - - - -

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

转盘项目功能清单（完整版）

有兴趣可以v：z20871209 (备注插件市场)

项目简介

本项目是一套面向 C 端抽奖拉活 + B 端精细化运营 的转盘应用：用户端（turntable-client） 提供转盘抽奖、体力/贡献/物品资产闭环、每日签到与激励广告、三级邀请裂变、贡献兑现与实物上报履约等完整玩法；管理端（kex-admin-zfb-dev） 提供奖池与经济策略配置、兑现订单审核与状态流转、稳定性灰度开关、邀请与活动订单查询、用户使用统计及系统权限管理能力。两端基于 uni-app + uniCloud（同一数据空间） 构建，业务数据以 *`kex-turntable-` 系列表 为核心贯通，关键写操作由 云对象** 兜底校验，兼顾迭代效率与资产安全。

项目优势（摘要）：① 端云一体、双端分工清晰——用户侧体验与运营侧工具分离，又共享同一套数据模型，减少重复开发与对账成本；② 经济模型可配置、可灰度——有效策略、风控阈值、releaseControl 等支持分阶段上线与紧急回退；③ 履约与资产可追溯——转盘结算、账本、上报/兑现订单链路可联查，贡献冻结与审核拒绝退回等规则保障资金侧可控；④ 可观测与可治理——管理端集成 uni 统计、支付与设备/用户看板，并内置数据清理等运维能力，便于灰度期与上线后治理。

文档范围：仅包含 turntable-client（用户端 / 小程序客户端） 与 kex-admin-zfb-dev（运营后台 / 管理端） 两个工程。二者共用同一套 uniCloud（uniCloud-alipay） 空间下的业务表与部分云函数。
维护说明：功能以仓库内代码与 pages.json 为准；部署环境差异（权限、菜单配置）需在实际上线环境二次核对。

一、总体架构

层级 工程 技术要点 主要职责
客户端 turntable-client uni-app、Vue3、databaseForJQL、uni-id C 端用户：转盘、资产、签到、邀请、上报兑现、部分管理员嵌入能力（经济模型、统计、数据清理等）
管理端 kex-admin-zfb-dev uni-app（PC 布局：topWindow / leftWindow）、uniCloud admin、uni-stat B 端运营：奖池维护、经济策略上报、兑现订单审核、稳定性开关、系统与统计模块
云端 两工程下的 uniCloud-alipay 云数据库 schema、云函数 / 云对象 数据持久化、部分需服务端的原子能力（奖池 CRUD、兑换、数据清理、统计接收等）

数据流概要：客户端大量业务通过 JQL 直连读写 kex-turntable-* 表；管理端同样以 JQL / 管理端权限操作同一批表；关键写操作辅以 云对象（如奖池、兑换、清理）保证校验与权限边界。

二、turntable-client（客户端）功能清单

2.1 技术栈与通用能力

  • 框架：uni-app + Vue3（<script setup>）
  • 登录：pages/login 分包（微信 / 账号密码 / 注册 / 协议）；pages.json 中 uniIdRouter 对部分 pages/user/.*、user-list、earn-friend-detail 要求登录
  • 云端访问：uniCloud.databaseForJQL() 为主；个别能力 uniCloud.importObject
  • 公共能力：composables/useTurntableSettlement.js（转盘结算）、services/effectivePolicyReader.js、services/inviteService.js、services/economyAdminService.js、utils/fulfillmentAsset.js、utils/fulfillmentOrderDisplay.js、utils/datetimeRange.js 等

2.2 页面与功能（主包 pages.json）

路由 标题 功能说明
pages/index/index （自定义导航） 主转盘：加载奖池、转盘动画、抽奖扣体力、写 drawOrder、更新余额与账本、物品入账；读 kex-turntable-effectiveEconomy 策略；激励视频广告补体力/贡献；未中奖返体力策略（简易概率或广告分档）
pages/invite/index 我的邀请码 邀请码 / 链接、绑定与展示
pages/invite-team/index 我的下级 邀请关系 / 下级列表展示
pages/pool/index 选择奖池 选择官方或自定义奖池并回到首页
pages/pool/add 新增奖池 自定义奖池配置入口
pages/user/index 个人中心 总导航：体力/贡献/碎片概览；玩法、资产、上报履约、登录与客服；releaseControl.fulfillmentEnabled 控制「上报与履约」整块；用户使用统计 仅 admin 可见且已独立于履约灰度整块
pages/user-prizes/index 我的仓库 碎片库存、兑换贡献、实物申请；风控与 releaseControl（兑换/履约关闭时限制交互）
pages/user-records/index 转盘记录 用户历史抽奖记录
pages/user-pools/index 我的转盘 管理自定义转盘 / 奖池
pages/economy/index 经济模型 管理员：本地编辑经济参数、邀请/签到/返体力/广告/风控、releaseControl、写入有效经济策略、一键紧急回退（仅改 releaseControl）
pages/settle/index 结算明细 当前用户 drawOrder、账本、fulfillmentOrder 联查；筛选与批量重试失败结算
pages/signin/index 今日签到 按策略发体力/贡献、写签到与账本；触发邀请侧奖励（与 inviteService 协同）
pages/exchange-records/index 上报记录 查询 kex-turntable-fulfillmentOrder（本人）；状态筛选；手续费/净值；待审撤回并退贡献；展示字段用 fulfillmentOrderDisplay 统一映射
pages/fulfillment-apply/index 上报申请 贡献兑现 / 实物申请；兑现 先扣贡献再建单，失败回滚流水；成功 toast 后返回上一页
pages/fulfillment-records/index 提现记录 管理员：全量履约单；审核通过（兼容提交已扣 / 审核时扣）、拒绝 退贡献、打款完成、邀请提现返贡献等
pages/usage-stats/index 用户使用统计 管理员：多表汇总用户资产与行为、时段筛选、排序、分页
pages/user-list/index 赚友列表 列表 + 策略开关控制是否展示
pages/earn-friend-detail/index 赚友详情 管理员：单用户资产、广告、转盘、履约、地址等聚合
pages/data-clean/index 数据清理 管理员：调用云对象 kex-turntable-data-clean，按表或字段删除（操作密码）
pages/asset-ledger/index 体力贡献明细 userAssetLedger 流水与原因中文
pages/address-list/index 收货地址管理 地址列表、默认地址
pages/address-edit/index 收货地址 单条编辑

2.3 登录分包 pages/login/*

  • 登录首页、账号密码登录、注册、隐私协议等，与 uniIdRouter 配合。

2.4 客户端涉及的核心数据表（JQL，节选）

  • kex-turntable-prizePool、kex-turntable-drawOrder
  • kex-turntable-userAssetBalance、kex-turntable-userAssetLedger
  • kex-turntable-userShardBalance
  • kex-turntable-effectiveEconomy（含 global-effective-policy 单例）
  • kex-turntable-adWatchLog
  • kex-turntable-fulfillmentOrder
  • kex-turntable-inviteCode、kex-turntable-inviteRelation、kex-turntable-activityOrder
  • kex-turntable-userAddress
  • kex-turntable-signinLog（签到相关）
  • 其它以代码中表名字符串为准

2.5 客户端文档（同仓库 docs/）

  • 玩法规则说明-推广版.md、连转道具功能-设计备忘.md、turntable-table-guide.md、phase6-go-live-checklist.md、phase6-acceptance-record.md 等：产品与上线备忘，不替代代码行为。

三、kex-admin-zfb-dev（管理端）功能清单

3.1 技术栈与壳体

  • 布局：pages.json 配置 topWindow（windows/topWindow）、leftWindow（windows/leftWindow），典型 PC 管理后台 结构
  • 登录与账号：uni-id-pages（密码登录、验证码登录、免密、注册、超管创建、找回密码、个人资料、绑定手机、实名、注销等）
  • 全局：uniIdRouter 对除登录/注册/找回外的路由 resToLogin: true
  • 统计：pages/uni-stat/* 全套（与 DCloud uni 统计模块一致）
  • 升级：uni-upgrade-center 版本列表 / 发布 / 详情
  • 反馈：uni-feedback 模块页面

3.2 业务分包 pages/client/*（转盘 / 履约运营）

路由 标题 功能说明
client/turntable/list 转盘列表 奖池 / 转盘配置列表入口
client/turntable/form 转盘奖池 奖池表单维护（与 kex-turntable-prizePool 对应）
client/economy/index 经济策略（二阶段） 运营侧经济参数、日报收入、有效策略写入 kex-turntable-effectiveEconomy（与客户端 economyAdmin 工具同源思路）
client/fulfillmentOrder/list 兑现订单（五阶段） kex-turntable-fulfillmentOrder 查询与状态流：审核通过/拒绝（拒绝退贡献）、打款完成、批量操作、失败重试；邀请提现返贡献；手续费读取 withdrawFeeRate
client/stability/index 稳定性看板（六阶段） releaseControl 等开关：如 fulfillmentEnabled 等灰度控制
client/inviteRelation/list 邀请关系（三层） kex-turntable-inviteRelation 数据查看
client/activityOrder/list 活动奖励订单（邀请） kex-turntable-activityOrder
client/inviteCode/list 邀请码（短码） kex-turntable-inviteCode
client/fragmentOrder/list 兑换记录 kex-turntable-fragmentOrder
client/usageStats/list 用户使用统计 管理端视角的用户使用统计列表（与客户端统计页互补，面向运营大屏/表格）

3.3 系统分包 pages/system/*

  • 菜单：menu/list|add|edit — 对应 opendb-admin-menus 等
  • 权限 / 角色 / 用户：permission/*、role/*、user/*
  • 应用：app/list|add、app/uni-portal/uni-portal（发布页管理）
  • 标签：tag/list|add|edit
  • 安全：safety/list（用户日志）

3.4 统计分包 pages/uni-stat/*（节选）

  • 页面：受访页、入口页、内容统计、页面规则、场景值、渠道、事件与转化
  • 错误：JS 报错、App 原生报错、详情与上传任务
  • 设备：概况、活跃、趋势、留存、对比、粘性
  • 用户：概况、活跃、趋势、留存、对比、粘性
  • 支付订单：概况、明细、漏斗、排行等（依赖 uni-pay 与统计库表）

3.5 演示与其它主包页面

  • pages/demo/icons/*、pages/demo/table/table：组件演示
  • pages/index/index：管理端首页（壳内内容）
  • pages/error/404：404

3.6 管理端 uniCloud（uniCloud-alipay）业务云函数 / 云对象（转盘相关）

名称 类型 作用（摘要）
kex-turntable-prizePool 云对象 奖池增删改查，校验奖品字段，操作 kex-turntable-prizePool 集合
kex-turntable-exchange 云对象 碎片/物品兑换相关批量逻辑，读有效经济策略，写 fragmentOrder、userShardBalance、userAssetBalance、userAssetLedger 等
kex-turntable-data-clean 云对象 按表或字段清理数据（客户端 data-clean 页 importObject 调用）
kex-turntable-getInviteMpCode 云函数 邀请相关小程序码等能力

此外还包含 uni 官方统计、短信、升级中心、扩展存储 等云函数（uni-stat-receiver、uni-sms-co、uni-upgrade-center 等），用于管理端统计与通用能力，具体以 uniCloud-alipay/cloudfunctions 目录为准。

3.7 管理端数据库 Schema（uniCloud-alipay/database）

*转盘业务（`kex-turntable-`）**（与客户端共用同一空间时表结构一致），包括但不限于：

  • kex-turntable-prizePool、kex-turntable-drawOrder、kex-turntable-record
  • kex-turntable-userAssetBalance、kex-turntable-userAssetLedger
  • kex-turntable-userShardBalance、kex-turntable-fragmentOrder
  • kex-turntable-effectiveEconomy、kex-turntable-econDailyRevenue
  • kex-turntable-fulfillmentOrder
  • kex-turntable-inviteCode、kex-turntable-inviteRelation、kex-turntable-activityOrder
  • kex-turntable-userAddress、kex-turntable-userSetting
  • kex-turntable-adWatchLog、kex-turntable-signinLog

平台与运营（节选）：uni-stat-*、uni-pay-orders、uni-id-*、opendb-* 等，用于 uni 统计、支付统计、开放数据表。

四、客户端与管理端对照关系

业务域 客户端 管理端
奖池配置 选择奖池、我的转盘、新增奖池（读表 / 用户侧配置） client/turntable/list、form + 云对象 kex-turntable-prizePool
经济策略 pages/economy/index（管理员在小程序内改参、上报、紧急回退） client/economy/index（运营按日报一键生效等）
兑现 / 履约单 fulfillment-apply、exchange-records；管理员 fulfillment-records client/fulfillmentOrder/list（主审核台）
灰度 / 紧急 releaseControl（客户端读、经济页改） client/stability/index（稳定性看板开关）
用户使用统计 pages/usage-stats/index（管理员，JQL 聚合） client/usageStats/list
邀请数据查看 邀请码、下级、赚友详情 inviteRelation、activityOrder、inviteCode 列表
碎片兑换记录 客户端「上报记录」等与 fragmentOrder 若有交叉以实际页面为准 client/fragmentOrder/list
数据清理 pages/data-clean/index 同一云对象 kex-turntable-data-clean（权限在云端控制）

五、附录 A — 客户端路由一览（turntable-client/pages.json）

主包：pages/index/index、invite/index、invite-team/index、pool/index、pool/add、user/index、user-prizes/index、user-records/index、user-pools/index、economy/index、settle/index、signin/index、exchange-records/index、fulfillment-apply/index、fulfillment-records/index、usage-stats/index、user-list/index、earn-friend-detail/index、data-clean/index、asset-ledger/index、address-edit/index、address-list/index。

分包：pages/login → index/index、login-password/index、register/index、agreement/index。

六、附录 B — 管理端分包路由一览（kex-admin-zfb-dev/pages.json 摘要）

  • client：turntable/list、turntable/form、economy/index、fulfillmentOrder/list、stability/index、inviteRelation/list、activityOrder/list、inviteCode/list、fragmentOrder/list、usageStats/list
  • system：menu/*、permission/*、role/*、user/*、app/*、tag/*、safety/list
  • uni-stat：page-res、page-ent、page-content、page-rule、scene、channel、error/*、event、device/*、user/*、pay-order/* 等（详见 pages.json 全量）
  • uni_modules：uni-id-pages、uni-upgrade-center、uni-feedback 等页面路径

七、附录 C — 权限与角色约定（摘要）

  • 客户端：部分能力通过 uniCloud.getCurrentUserInfo()?.role 包含 admin 判断（经济模型、提现记录、统计、数据清理、赚友详情等）。
  • 管理端：依赖 uni-id 后台账号体系 与菜单/权限表；具体菜单在 opendb-admin-menus 中配置后出现于 leftWindow。

文档生成自仓库目录结构、pages.json 与关键源码路径梳理；若后续增删页面或云函数，请同步更新本节。

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。