推广分佣功能开发

This commit is contained in:
Dev
2026-10-14 14:44:01 +08:00
parent da26eb5306
commit 1754df972d
34 changed files with 1414 additions and 16 deletions
+29 -5
View File
@@ -1,32 +1,56 @@
import updateManager from './common/updateManager';
import {
QUERY_KEY as PROMOTER_KEY,
savePendingPromoter,
getPendingPromoter,
clearPendingPromoter,
bindPendingPromoter,
} from './utils/promoter';
var util = require('utils/util.js');
var api = require('config/api.js');
App({
onLaunch: function () {
onLaunch: function (options) {
wx.$api = api
wx.$util = util
// 展示本地存储能力
var logs = wx.getStorageSync('logs') || []
logs.unshift(Date.now())
wx.setStorageSync('logs', logs)
//通过分享链接/小程序码冷启动时缓存推广人,随登录请求一起绑定
savePendingPromoter(options && options.query);
this.loggingIn = true;
// 登录
wx.login({
success: (res) => {
util.request(api.AuthLoginByWeixin, {
code: res.code
}, 'POST').then(function (res) {
console.log('App Launch')
code: res.code,
[PROMOTER_KEY]: getPendingPromoter(),
}, 'POST').then((res) => {
this.loggingIn = false;
if (res.code === 1) {
let userInfo = res.data.userinfo;
wx.setStorageSync('token', res.data.token);
wx.setStorageSync('userInfo', userInfo);
//推广关系为永久绑定,登录成功后无论是否绑定都无需再次提交
clearPendingPromoter();
}
}).catch((err) => {
this.loggingIn = false;
console.error('wxLogin failed:', err);
});
},
fail: () => {
this.loggingIn = false;
},
});
},
onShow: function () {
onShow: function (options) {
//热启动从分享进入:已登录时直接绑定,冷启动由 onLaunch 的登录请求处理
savePendingPromoter(options && options.query);
if (!this.loggingIn) {
bindPendingPromoter();
}
updateManager();
//从后台切回前台时刷新一次未读红点(不使用定时轮询,避免请求堆积导致页面卡死)
this.refreshUnread();
+2 -1
View File
@@ -37,7 +37,8 @@
"pages/demand/contract/index",
"pages/demand/deliver/index",
"pages/demand/agreement/index",
"pages/usercenter/balance/index"
"pages/usercenter/balance/index",
"pages/promoter/index/index"
],
"tabBar": {
"custom": true,
+6
View File
@@ -104,6 +104,12 @@ module.exports = {
AccountApplyWithdraw: ApiRootUrl + 'account/applyWithdraw', //提现申请
AccountTransferAuthorization: ApiRootUrl + 'account/transferAuthorization', //免确认收款授权(发起/查询)
// 推广分佣
PromotionBind: ApiRootUrl + 'promotion/bind', //绑定推广人
PromotionInfo: ApiRootUrl + 'promotion/info', //推广中心概览
PromotionOrders: ApiRootUrl + 'promotion/orders', //推广订单列表
PromotionQrcode: ApiRootUrl + 'promotion/qrcode', //推广小程序码
// 消息
MessageList: ApiRootUrl + 'message/list', //消息列表
MessageDetail: ApiRootUrl + 'message/detail', //消息详情
+11 -1
View File
@@ -6,6 +6,7 @@ import {
} from '../../../services/good/fetchGoodsDetailsComments';
import { cdnBase } from '../../../config/index';
import { withPromoter, promoterQuery } from '../../../utils/promoter';
const imgPrefix = `${cdnBase}/`;
@@ -350,11 +351,20 @@ Page({
const customInfo = {
imageUrl: this.data.details.primaryImage,
title: this.data.details.title + shareSubTitle,
path: `/pages/goods/details/index?spuId=${this.data.spuId}`,
path: withPromoter(`/pages/goods/details/index?spuId=${this.data.spuId}`),
};
return customInfo;
},
onShareTimeline() {
const query = promoterQuery();
return {
title: this.data.details.title,
imageUrl: this.data.details.primaryImage,
query: `spuId=${this.data.spuId}${query ? `&${query}` : ''}`,
};
},
/** 获取评价统计 */
async getCommentsStatistics() {
try {
+15
View File
@@ -1,5 +1,6 @@
import { fetchHome, fetchConfig } from '../../services/home/home';
import { fetchPerson } from '../../services/usercenter/fetchPerson';
import { withPromoter, promoterQuery } from '../../utils/promoter';
Page({
data: {
@@ -143,4 +144,18 @@ Page({
url: `/pages/promotion-detail/index?promotion_id=${promotionID}`,
});
},
onShareAppMessage() {
return {
title: '代码帮 - 软件商城与定制开发平台',
path: withPromoter('/pages/home/home'),
};
},
onShareTimeline() {
return {
title: '代码帮 - 软件商城与定制开发平台',
query: promoterQuery(),
};
},
});
@@ -0,0 +1,159 @@
// pages/promoter/index/index.js
import { fetchPromoterInfo, fetchPromoterOrders, fetchPromoterQrcode } from '../../../services/promoter/fetchPromoter';
import { withPromoter } from '../../../utils/promoter';
const PAGE_SIZE = 10;
Page({
data: {
// 推广概览:enabled 是否开启分佣、soft_ratio_percent 软件订单佣金比例(%)、
// demand_ratio_percent 需求订单佣金比例(%)、invite_count 推广用户数、
// order_count 推广订单数、settled_amount 累计已结算佣金(元)、pending_count 待结算订单数
overview: {},
list: [], // 推广订单列表
page: 1, // 下一次请求的页码
hasMore: true, // 是否还有更多数据
isEmpty: false, // 列表是否为空
loadMoreStatus: 0, // 加载状态 0=空闲 1=加载中 2=没有更多 3=失败
showQrcode: false, // 是否展示推广码弹窗
qrcode: '', // 推广小程序码 data URL
qrcodeLoading: false, // 推广码生成中
saving: false, // 保存推广码中
},
onLoad() {
this.loadOverview();
this.loadList(true);
},
async onPullDownRefresh() {
await Promise.all([this.loadOverview(), this.loadList(true)]);
wx.stopPullDownRefresh();
},
onReachBottom() {
if (this.data.hasMore && this.data.loadMoreStatus !== 1) {
this.loadList();
}
},
onShareAppMessage() {
return {
title: '代码帮 - 软件商城与定制开发平台',
path: withPromoter('/pages/home/home'),
};
},
async loadOverview() {
try {
const res = await fetchPromoterInfo();
if (res.code === 1) {
this.setData({ overview: res.data });
}
} catch (err) {
console.error('fetchPromoterInfo failed:', err);
}
},
async loadList(fresh = false) {
const page = fresh ? 1 : this.data.page;
this.setData({ loadMoreStatus: 1 });
try {
const res = await fetchPromoterOrders({ page, pageSize: PAGE_SIZE });
if (res.code !== 1) {
this.setData({ loadMoreStatus: 3 });
return;
}
const { data = [], current_page: currentPage, last_page: lastPage } = res.data;
const list = fresh ? data : this.data.list.concat(data);
const hasMore = currentPage < lastPage;
this.setData({
list,
page: currentPage + 1,
hasMore,
isEmpty: list.length === 0,
loadMoreStatus: hasMore ? 0 : 2,
});
} catch (err) {
console.error('fetchPromoterOrders failed:', err);
this.setData({ loadMoreStatus: 3 });
}
},
onRetryLoad() {
this.loadList();
},
async onShowQrcode() {
this.setData({ showQrcode: true });
if (this.data.qrcode || this.data.qrcodeLoading) {
return;
}
this.setData({ qrcodeLoading: true });
try {
const res = await fetchPromoterQrcode({ envVersion: wx.$api.envVersion });
if (res.code !== 1) {
wx.showToast({ title: res.msg || '推广码生成失败', icon: 'none' });
return;
}
this.setData({ qrcode: res.data.qrcode });
} catch (err) {
console.error('fetchPromoterQrcode failed:', err);
wx.showToast({ title: '网络异常,请重试', icon: 'none' });
} finally {
this.setData({ qrcodeLoading: false });
}
},
onQrcodeVisibleChange(e) {
this.setData({ showQrcode: e.detail.visible });
},
onCloseQrcode() {
this.setData({ showQrcode: false });
},
/** 保存推广码到相册:data URL 需先写入本地文件 */
async onSaveQrcode() {
const { qrcode, saving } = this.data;
if (!qrcode || saving) {
return;
}
this.setData({ saving: true });
try {
const [meta, base64] = qrcode.split(',');
const ext = meta.indexOf('png') > -1 ? 'png' : 'jpg';
const filePath = `${wx.env.USER_DATA_PATH}/promoter_qrcode.${ext}`;
wx.getFileSystemManager().writeFileSync(filePath, base64, 'base64');
await this.saveImage(filePath);
wx.showToast({ title: '已保存到相册', icon: 'success' });
} catch (err) {
console.error('saveQrcode failed:', err);
if (err && err.errMsg && err.errMsg.indexOf('auth') > -1) {
this.guideAlbumSetting();
} else if (!(err && err.errMsg && err.errMsg.indexOf('cancel') > -1)) {
wx.showToast({ title: '保存失败,请重试', icon: 'none' });
}
} finally {
this.setData({ saving: false });
}
},
saveImage(filePath) {
return new Promise((resolve, reject) => {
wx.saveImageToPhotosAlbum({ filePath, success: resolve, fail: reject });
});
},
guideAlbumSetting() {
wx.showModal({
title: '提示',
content: '需要授权保存到相册,是否前往设置开启?',
success: (res) => {
if (res.confirm) {
wx.openSetting();
}
},
});
},
});
@@ -0,0 +1,14 @@
{
"navigationBarTitleText": "推广中心",
"enablePullDownRefresh": true,
"backgroundTextStyle": "dark",
"usingComponents": {
"t-button": "tdesign-miniprogram/button/button",
"t-icon": "tdesign-miniprogram/icon/icon",
"t-avatar": "tdesign-miniprogram/avatar/avatar",
"t-empty": "tdesign-miniprogram/empty/empty",
"t-popup": "tdesign-miniprogram/popup/popup",
"t-loading": "tdesign-miniprogram/loading/loading",
"t-load-more": "/components/load-more/index"
}
}
@@ -0,0 +1,69 @@
<!--pages/promoter/index/index.wxml-->
<view class="promoter-card">
<view class="promoter-card__total">
<text class="promoter-card__amount">{{overview.settled_amount || '0.00'}}</text>
<text class="promoter-card__label">累计佣金(元)</text>
</view>
<view class="promoter-card__stats">
<view class="promoter-card__stat">
<text class="promoter-card__value">{{overview.invite_count || 0}}</text>
<text class="promoter-card__stat-label">推广用户</text>
</view>
<view class="promoter-card__stat">
<text class="promoter-card__value">{{overview.order_count || 0}}</text>
<text class="promoter-card__stat-label">推广订单</text>
</view>
<view class="promoter-card__stat">
<text class="promoter-card__value">{{overview.pending_count || 0}}</text>
<text class="promoter-card__stat-label">待结算订单</text>
</view>
</view>
<view class="promoter-card__actions">
<t-button class="promoter-card__btn" theme="primary" size="medium" open-type="share">分享给好友</t-button>
<t-button class="promoter-card__btn" theme="primary" size="medium" variant="outline" bind:tap="onShowQrcode">推广二维码</t-button>
</view>
</view>
<view class="rule-card">
<t-icon name="info-circle-filled" size="32rpx" color="#ff5f15" />
<view class="rule-card__text" wx:if="{{overview.enabled}}">
<view>好友通过你的分享链接或二维码进入并下单,订单交易完成后按实付金额结算佣金,自动存入余额,可直接提现:</view>
<view>· 软件订单:{{overview.soft_ratio_percent > 0 ? overview.soft_ratio_percent + '%' : '暂无佣金'}}</view>
<view>· 定制需求订单:{{overview.demand_ratio_percent > 0 ? overview.demand_ratio_percent + '%' : '暂无佣金'}}</view>
</view>
<text class="rule-card__text" wx:else>平台暂未开启推广分佣,你仍可邀请好友,开启后好友完成的订单将按规则结算佣金。</text>
</view>
<view class="order-card">
<view class="order-card__title">推广订单</view>
<view class="order-item" wx:for="{{list}}" wx:key="id">
<t-avatar class="order-item__avatar" size="72rpx" image="{{item.buyer_avatar}}" />
<view class="order-item__main">
<view class="order-item__name">{{item.buyer_nickname || '用户'}} · {{item.order_type_text}}</view>
<view class="order-item__desc">实付 ¥{{item.payment_amount}} · {{item.createtime_text}}</view>
</view>
<view class="order-item__side">
<view class="order-item__amount" wx:if="{{item.commission_status === 1}}">+{{item.commission_amount}}</view>
<view class="order-item__status order-item__status--{{item.commission_status}}">{{item.commission_status_text}}</view>
</view>
</view>
<view class="order-card__empty" wx:if="{{isEmpty}}">
<t-empty icon="file" description="暂无推广订单" />
</view>
<t-load-more wx:else status="{{loadMoreStatus}}" bind:retry="onRetryLoad" />
</view>
<t-popup visible="{{showQrcode}}" placement="center" bind:visible-change="onQrcodeVisibleChange">
<view class="qrcode-popup">
<view class="qrcode-popup__title">我的推广码</view>
<view class="qrcode-popup__image">
<t-loading wx:if="{{qrcodeLoading}}" theme="circular" size="64rpx" />
<image wx:elif="{{qrcode}}" class="qrcode-popup__img" src="{{qrcode}}" mode="aspectFit" show-menu-by-longpress />
</view>
<view class="qrcode-popup__tips">好友微信扫码进入小程序即成为你的推广用户</view>
<view class="qrcode-popup__actions">
<t-button theme="primary" block loading="{{saving}}" disabled="{{!qrcode}}" bind:tap="onSaveQrcode">保存到相册</t-button>
<t-button theme="default" variant="text" block bind:tap="onCloseQrcode">关闭</t-button>
</view>
</view>
</t-popup>
@@ -0,0 +1,194 @@
/* pages/promoter/index/index.wxss */
page {
padding-bottom: 40rpx;
}
/* 佣金主卡 */
.promoter-card {
margin: 24rpx;
padding: 48rpx 32rpx 36rpx;
background: var(--brand-gradient);
border-radius: var(--radius-lg);
box-shadow: var(--shadow-brand);
text-align: center;
color: var(--text-inverse);
}
.promoter-card__amount {
display: block;
font-size: 64rpx;
font-weight: 700;
line-height: 80rpx;
font-family: 'DIN Alternate', -apple-system, sans-serif;
}
.promoter-card__label {
display: block;
margin-top: 8rpx;
font-size: 24rpx;
color: rgba(255, 255, 255, 0.85);
}
.promoter-card__stats {
display: flex;
margin: 40rpx 0 32rpx;
}
.promoter-card__stat {
flex: 1;
display: flex;
flex-direction: column;
align-items: center;
}
.promoter-card__value {
font-size: 34rpx;
font-weight: 600;
font-family: 'DIN Alternate', -apple-system, sans-serif;
}
.promoter-card__stat-label {
margin-top: 8rpx;
font-size: 24rpx;
color: rgba(255, 255, 255, 0.75);
}
.promoter-card__actions {
display: flex;
justify-content: center;
}
.promoter-card__btn {
margin: 0 12rpx;
--td-button-primary-bg-color: #ffffff;
--td-button-primary-color: var(--brand);
--td-button-primary-border-color: #ffffff;
--td-button-primary-active-bg-color: #fff5ef;
--td-button-primary-active-border-color: #fff5ef;
}
/* 规则说明 */
.rule-card {
display: flex;
align-items: flex-start;
margin: 0 24rpx 24rpx;
padding: 24rpx 28rpx;
background: var(--brand-light);
border-radius: var(--radius-md);
}
.rule-card__text {
flex: 1;
margin-left: 12rpx;
font-size: 24rpx;
line-height: 38rpx;
color: var(--brand);
}
/* 推广订单 */
.order-card {
margin: 0 24rpx;
padding-bottom: 16rpx;
background: var(--bg-card);
border-radius: var(--radius-lg);
box-shadow: var(--shadow-card);
overflow: hidden;
}
.order-card__title {
padding: 28rpx 32rpx 12rpx;
font-size: 30rpx;
font-weight: 600;
color: var(--text-primary);
}
.order-card__empty {
padding: 40rpx 0;
}
.order-item {
display: flex;
align-items: center;
padding: 24rpx 32rpx;
border-bottom: 1px solid var(--border-level-1);
}
.order-item__main {
flex: 1;
margin-left: 20rpx;
overflow: hidden;
}
.order-item__name {
font-size: 28rpx;
color: var(--text-primary);
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.order-item__desc {
margin-top: 6rpx;
font-size: 22rpx;
color: var(--text-placeholder);
}
.order-item__side {
margin-left: 16rpx;
text-align: right;
}
.order-item__amount {
font-size: 32rpx;
font-weight: 700;
color: var(--success);
font-family: 'DIN Alternate', -apple-system, sans-serif;
}
.order-item__status {
margin-top: 4rpx;
font-size: 22rpx;
color: var(--text-tertiary);
}
.order-item__status--0 {
color: var(--brand);
}
/* 推广码弹窗 */
.qrcode-popup {
width: 600rpx;
padding: 40rpx 40rpx 24rpx;
background: var(--bg-card);
border-radius: var(--radius-lg);
text-align: center;
}
.qrcode-popup__title {
font-size: 32rpx;
font-weight: 600;
color: var(--text-primary);
}
.qrcode-popup__image {
display: flex;
align-items: center;
justify-content: center;
width: 400rpx;
height: 400rpx;
margin: 32rpx auto 16rpx;
}
.qrcode-popup__img {
width: 400rpx;
height: 400rpx;
}
.qrcode-popup__tips {
font-size: 24rpx;
color: var(--text-tertiary);
}
.qrcode-popup__actions {
margin-top: 32rpx;
}
@@ -30,6 +30,12 @@ const menuData = [
url: '',
type: 'balance',
},
{
title: '推广中心',
tit: '',
url: '',
type: 'promoter',
},
],
[{
title: '帮助中心',
@@ -201,6 +207,12 @@ Page({
});
break;
}
case 'promoter': {
wx.navigateTo({
url: '/pages/promoter/index/index'
});
break;
}
case 'coupon': {
// wx.navigateTo({
// url: '/pages/coupon/coupon-list/index'
@@ -0,0 +1,19 @@
/** 绑定推广人(已绑定过的用户后端会忽略) */
export function bindPromoter(params) {
return wx.$util.request(wx.$api.PromotionBind, params, 'POST');
}
/** 获取推广中心概览 */
export function fetchPromoterInfo() {
return wx.$util.request(wx.$api.PromotionInfo, {}, 'GET');
}
/** 获取推广订单列表 */
export function fetchPromoterOrders(params) {
return wx.$util.request(wx.$api.PromotionOrders, params, 'GET');
}
/** 获取推广小程序码(data URL) */
export function fetchPromoterQrcode(params) {
return wx.$util.request(wx.$api.PromotionQrcode, params, 'GET');
}
+75
View File
@@ -0,0 +1,75 @@
import { bindPromoter } from '../services/promoter/fetchPromoter';
// 待绑定的推广人ID(登录前进入时先缓存,登录/绑定成功后清除)
const PENDING_KEY = 'pendingPromoterId';
// 分享链接参数:/pages/xxx?promoter_id=1,同时作为登录/绑定接口的参数名
export const QUERY_KEY = 'promoter_id';
// 小程序码 scene 参数:scene=pid%3D1,与后端 PromotionService::QRCODE_SCENE_KEY 一致
const SCENE_KEY = 'pid';
/** 当前登录用户ID */
export function getCurrentUserId() {
return Number((wx.getStorageSync('userInfo') || {}).id) || 0;
}
/** 从页面启动参数中解析推广人ID */
export function parsePromoterId(query = {}) {
if (query[QUERY_KEY]) {
return Number(query[QUERY_KEY]) || 0;
}
if (query.scene) {
const pair = decodeURIComponent(query.scene)
.split('&')
.map((item) => item.split('='))
.find(([key]) => key === SCENE_KEY);
return pair ? Number(pair[1]) || 0 : 0;
}
return 0;
}
/** 启动参数中带推广人时缓存,等待登录后绑定 */
export function savePendingPromoter(query) {
const promoterId = parsePromoterId(query || {});
if (promoterId && promoterId !== getCurrentUserId()) {
wx.setStorageSync(PENDING_KEY, promoterId);
}
}
export function getPendingPromoter() {
return Number(wx.getStorageSync(PENDING_KEY)) || 0;
}
export function clearPendingPromoter() {
wx.removeStorageSync(PENDING_KEY);
}
/** 已登录状态下绑定缓存的推广人(热启动从分享进入时使用) */
export async function bindPendingPromoter() {
const promoterId = getPendingPromoter();
if (!promoterId || !wx.getStorageSync('token')) {
return;
}
try {
const res = await bindPromoter({ [QUERY_KEY]: promoterId });
if (res.code === 1) {
clearPendingPromoter();
}
} catch (err) {
console.error('bindPromoter failed:', err);
}
}
/** 分享参数:promoter_id=当前用户ID,未登录时为空 */
export function promoterQuery() {
const userId = getCurrentUserId();
return userId ? `${QUERY_KEY}=${userId}` : '';
}
/** 给分享路径追加推广人参数 */
export function withPromoter(path) {
const query = promoterQuery();
if (!query) {
return path;
}
return `${path}${path.indexOf('?') > -1 ? '&' : '?'}${query}`;
}