diff --git a/apps/taro/README.md b/apps/taro/README.md index 1979e39b..f5ba8e20 100644 --- a/apps/taro/README.md +++ b/apps/taro/README.md @@ -60,11 +60,11 @@ pages/tenant-admin/workbench/index 租户后台工作台、权限驱动模块 pages/tenant-admin/dashboard/index 数据看板 pages/tenant-admin/students/index 学生与班级 pages/tenant-admin/content/index 内容入口、导入任务、字段模板、异步轮询、复检、公共题库采纳/同步/单条和批量冲突处理 -pages/tenant-admin/marketing/index 优惠券、激活码、CRM、分佣摘要 +pages/tenant-admin/marketing/index 优惠券、激活码、CRM 配置/队列、分佣结算 pages/tenant-admin/settings/index 品牌、域名、支付、登录、角色模板和成员绑定 ``` -当前后台页面已经从只读联调推进到第一批运营写操作。题库内容页已接入公共题库采纳、公共题库同步、同步冲突查看、单条/批量采纳平台版本或保留本地版本、导入任务详情、异步任务轮询、导入问题查看、模板预览/下载、导入后复检详情，以及 JSON/CSV/Excel 的 H5 选择文件或粘贴内容、后端预览、字段别名覆盖和同步/异步执行导入第一版；营销、设置和学生页仍以扫描和轻量操作为主。真正权限以后端 permission keys 为准，前端菜单隐藏只做体验优化。 +当前后台页面已经从只读联调推进到第一批运营写操作。题库内容页已接入公共题库采纳、公共题库同步、同步冲突查看、单条/批量采纳平台版本或保留本地版本、导入任务详情、异步任务轮询、导入问题查看、模板预览/下载、导入后复检详情，以及 JSON/CSV/Excel 的 H5 选择文件或粘贴内容、后端预览、字段别名覆盖和同步/异步执行导入第一版；营销中心已接入 CRM 配置保存、CRM 队列按状态查看、分佣默认规则、成员分佣比例、分佣订单明细、生成结算单、审核通过/驳回和标记线下打款第一版。真正权限以后端 permission keys 为准，前端菜单隐藏只做体验优化。 租户工作台会读取 `/api/tenant-admin/permissions`，按菜单权限和有效权限隐藏不可见模块。租户设置页已接入角色模板与成员绑定写操作第一版：可新建、编辑、停用非系统模板，配置权限点、菜单可见、模块可见、字段可见和基础数据范围，也可以搜索/新建成员、绑定角色模板、设置成员状态和额外权限覆盖。前端只负责操作体验，`tenant_owner`、`tenant_admin`、通配权限、系统模板保护和最后一名 owner 保护仍以后端校验与审计为准。 diff --git a/apps/taro/src/pages/tenant-admin/marketing/index.tsx b/apps/taro/src/pages/tenant-admin/marketing/index.tsx index 07ec10b2..584e10d0 100644 --- a/apps/taro/src/pages/tenant-admin/marketing/index.tsx +++ b/apps/taro/src/pages/tenant-admin/marketing/index.tsx @@ -1,13 +1,31 @@ -import { useEffect, useState } from 'react'; -import { Text, View } from '@tarojs/components'; +import { useEffect, useMemo, useState } from 'react'; +import Taro from '@tarojs/taro'; +import { Button, Input, Text, View } from '@tarojs/components'; import { + generateCommissionSettlement, loadActivationCodes, loadCodeBatches, + loadCommissionOrders, + loadCommissionSettings, + loadCommissionSettlements, loadCommissionSummary, loadCoupons, + loadCrmConfig, loadCrmQueue, + loadTenantMembers, + updateCommissionSettings, + updateCommissionSettlementStatus, + updateMemberCommissionRate, + upsertCrmConfig, type CodeBatchItem, + type CommissionOrderItem, + type CommissionSettlementItem, + type CommissionSettingsItem, + type CommissionSummaryItem, type CouponItem, + type CrmConfigItem, + type CrmQueueItem, + type TenantMemberItem, } from '@/services/tenantAdmin'; import '../admin.css'; @@ -15,30 +33,251 @@ function money(cents: unknown) { return `¥${(Number(cents || 0) / 100).toFixed(2)}`; } +function today() { + return new Date().toISOString().slice(0, 10); +} + +function monthStart() { + const now = new Date(); + return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-01`; +} + +function percentToRate(value: string) { + const numberValue = Number(value || 0); + return Number.isFinite(numberValue) ? numberValue / 100 : 0; +} + +function rateToPercent(value: unknown) { + return String((Number(value || 0) * 100).toFixed(2)).replace(/\.00$/, ''); +} + export default function TenantMarketingPage() { const [coupons, setCoupons] = useState([]); const [batches, setBatches] = useState([]); const [codes, setCodes] = useState[]>([]); - const [crmQueue, setCrmQueue] = useState[]>([]); - const [commission, setCommission] = useState | null>(null); + const [crmConfig, setCrmConfig] = useState(null); + const [crmQueue, setCrmQueue] = useState([]); + const [commissionSettings, setCommissionSettings] = useState(null); + const [commission, setCommission] = useState(null); + const [commissionOrders, setCommissionOrders] = useState([]); + const [settlements, setSettlements] = useState([]); + const [members, setMembers] = useState([]); + const [crmForm, setCrmForm] = useState({ enabled: false, url: '', secretRef: '', formName: '刷题题库', examType: '专升本', timeoutSec: '10', delaySec: '60' }); + const [commissionForm, setCommissionForm] = useState({ defaultRatePercent: '20', minSettlementYuan: '0', settlementCycle: 'monthly' }); + const [period, setPeriod] = useState({ startDate: monthStart(), endDate: today(), referrerUserId: '' }); + const [memberRate, setMemberRate] = useState({ userId: '', ratePercent: '' }); + const [settlementPay, setSettlementPay] = useState({ paymentMethod: 'offline_bank', paymentAccount: '' }); + const [crmStatus, setCrmStatus] = useState(''); + const [busy, setBusy] = useState(''); const [error, setError] = useState(''); - useEffect(() => { - Promise.all([ - loadCoupons().catch(() => ({ items: [] })), - loadCodeBatches().catch(() => ({ items: [] })), - loadActivationCodes(20).catch(() => ({ items: [] })), - loadCrmQueue(20).catch(() => ({ items: [] })), - loadCommissionSummary().catch(() => ({ item: null })), - ]).then(([couponPayload, batchPayload, codePayload, crmPayload, commissionPayload]) => { + const salesMembers = useMemo( + () => members.filter(item => ['sales', 'agent', 'tenant_operator', 'teacher', 'tenant_admin', 'tenant_owner'].includes(item.role) && item.status === 'active'), + [members], + ); + + async function reloadAll() { + setError(''); + try { + const [couponPayload, batchPayload, codePayload, crmConfigPayload, crmPayload, commissionSettingsPayload, commissionPayload, orderPayload, settlementPayload, memberPayload] = await Promise.all([ + loadCoupons().catch(() => ({ items: [] })), + loadCodeBatches().catch(() => ({ items: [] })), + loadActivationCodes(20).catch(() => ({ items: [] })), + loadCrmConfig().catch(() => ({ item: null })), + loadCrmQueue(20, crmStatus || undefined).catch(() => ({ items: [] })), + loadCommissionSettings().catch(() => ({ item: null })), + loadCommissionSummary(period).catch(() => ({ item: null })), + loadCommissionOrders({ ...period, limit: 20 }).catch(() => ({ items: [] })), + loadCommissionSettlements({ limit: 20 }).catch(() => ({ items: [] })), + loadTenantMembers({ limit: 100 }).catch(() => ({ items: [] })), + ]); + const nextCrm = crmConfigPayload.item || null; + const nextSettings = commissionSettingsPayload.item || null; setCoupons(couponPayload.items || []); setBatches(batchPayload.items || []); setCodes(codePayload.items || []); + setCrmConfig(nextCrm); setCrmQueue(crmPayload.items || []); + setCommissionSettings(nextSettings); setCommission(commissionPayload.item || null); - }).catch(nextError => setError(nextError instanceof Error ? nextError.message : '营销数据加载失败')); + setCommissionOrders(orderPayload.items || []); + setSettlements(settlementPayload.items || []); + setMembers(memberPayload.items || []); + if (nextCrm) { + setCrmForm({ + enabled: nextCrm.enabled === true, + url: nextCrm.url || '', + secretRef: nextCrm.secretRef || '', + formName: nextCrm.formName || '刷题题库', + examType: nextCrm.examType || '专升本', + timeoutSec: String(nextCrm.timeoutSec || 10), + delaySec: String(nextCrm.delaySec || 60), + }); + } + if (nextSettings) { + setCommissionForm({ + defaultRatePercent: rateToPercent(nextSettings.defaultRate), + minSettlementYuan: String((Number(nextSettings.minSettlementCents || 0) / 100).toFixed(2)).replace(/\.00$/, ''), + settlementCycle: nextSettings.settlementCycle || 'monthly', + }); + } + } catch (nextError) { + setError(nextError instanceof Error ? nextError.message : '营销数据加载失败'); + } + } + + useEffect(() => { + void reloadAll(); }, []); + async function saveCrmConfig() { + setBusy('crm'); + setError(''); + try { + const result = await upsertCrmConfig({ + enabled: crmForm.enabled, + url: crmForm.url.trim() || null, + secretRef: crmForm.secretRef.trim() || null, + formName: crmForm.formName.trim() || '刷题题库', + examType: crmForm.examType.trim() || '专升本', + timeoutSec: Math.max(1, Math.trunc(Number(crmForm.timeoutSec || 10))), + delaySec: Math.max(0, Math.trunc(Number(crmForm.delaySec || 60))), + }); + setCrmConfig(result.item || null); + Taro.showToast({ title: 'CRM 已保存', icon: 'success' }); + } catch (nextError) { + setError(nextError instanceof Error ? nextError.message : 'CRM 保存失败'); + } finally { + setBusy(''); + } + } + + async function refreshCrmQueue(status = crmStatus) { + setBusy('crm-queue'); + setError(''); + try { + const payload = await loadCrmQueue(30, status || undefined); + setCrmQueue(payload.items || []); + } catch (nextError) { + setError(nextError instanceof Error ? nextError.message : 'CRM 队列加载失败'); + } finally { + setBusy(''); + } + } + + async function saveCommissionSettings() { + setBusy('commission-settings'); + setError(''); + try { + const result = await updateCommissionSettings({ + defaultRate: percentToRate(commissionForm.defaultRatePercent), + minSettlementCents: Math.max(0, Math.round(Number(commissionForm.minSettlementYuan || 0) * 100)), + settlementCycle: commissionForm.settlementCycle, + config: { source: 'taro-tenant-admin' }, + }); + setCommissionSettings(result.item || null); + Taro.showToast({ title: '分佣规则已保存', icon: 'success' }); + await reloadCommission(); + } catch (nextError) { + setError(nextError instanceof Error ? nextError.message : '分佣规则保存失败'); + } finally { + setBusy(''); + } + } + + async function saveMemberRate() { + if (!memberRate.userId) { + Taro.showToast({ title: '请选择成员', icon: 'none' }); + return; + } + setBusy('member-rate'); + setError(''); + try { + await updateMemberCommissionRate({ + userId: memberRate.userId, + commissionRate: memberRate.ratePercent.trim() ? percentToRate(memberRate.ratePercent) : null, + commissionConfig: { source: 'taro-tenant-admin' }, + }); + Taro.showToast({ title: '成员比例已保存', icon: 'success' }); + await reloadCommission(); + } catch (nextError) { + setError(nextError instanceof Error ? nextError.message : '成员比例保存失败'); + } finally { + setBusy(''); + } + } + + async function reloadCommission() { + setBusy('commission'); + setError(''); + try { + const [summaryPayload, orderPayload, settlementPayload] = await Promise.all([ + loadCommissionSummary(period), + loadCommissionOrders({ ...period, limit: 30 }), + loadCommissionSettlements({ limit: 30 }), + ]); + setCommission(summaryPayload.item || null); + setCommissionOrders(orderPayload.items || []); + setSettlements(settlementPayload.items || []); + } catch (nextError) { + setError(nextError instanceof Error ? nextError.message : '分佣数据加载失败'); + } finally { + setBusy(''); + } + } + + async function generateSettlement() { + if (!period.referrerUserId) { + Taro.showToast({ title: '请选择销售/代理成员', icon: 'none' }); + return; + } + setBusy('settlement-generate'); + setError(''); + try { + await generateCommissionSettlement({ + referrerUserId: period.referrerUserId, + startDate: period.startDate, + endDate: period.endDate, + status: 'pending_review', + remark: 'Taro 管理台生成', + }); + Taro.showToast({ title: '结算单已生成', icon: 'success' }); + await reloadCommission(); + } catch (nextError) { + setError(nextError instanceof Error ? nextError.message : '结算单生成失败'); + } finally { + setBusy(''); + } + } + + async function updateSettlement(item: CommissionSettlementItem, status: string) { + const confirmed = await Taro.showModal({ + title: status === 'paid' ? '确认已打款' : '更新结算状态', + content: `${item.referrerName || item.referrerPhone || item.referrerUserId || '成员'} · ${money(item.commissionAmountCents)}`, + confirmText: status === 'paid' ? '已打款' : '确认', + cancelText: '取消', + }); + if (!confirmed.confirm) return; + setBusy(`settlement:${item.id}:${status}`); + setError(''); + try { + await updateCommissionSettlementStatus({ + settlementId: item.id, + status, + paymentMethod: status === 'paid' ? settlementPay.paymentMethod : undefined, + paymentAccount: status === 'paid' ? settlementPay.paymentAccount || null : undefined, + remark: `Taro 管理台标记 ${status}`, + metadata: { source: 'taro-tenant-admin' }, + }); + Taro.showToast({ title: '状态已更新', icon: 'success' }); + await reloadCommission(); + } catch (nextError) { + setError(nextError instanceof Error ? nextError.message : '状态更新失败'); + } finally { + setBusy(''); + } + } + return ( @@ -55,6 +294,150 @@ export default function TenantMarketingPage() { 预计佣金{money(commission?.commissionAmountCents)} + + CRM 配置 + + + setCrmForm(prev => ({ ...prev, url: String(event.detail.value || '') }))} /> + setCrmForm(prev => ({ ...prev, secretRef: String(event.detail.value || '') }))} /> + setCrmForm(prev => ({ ...prev, formName: String(event.detail.value || '') }))} /> + setCrmForm(prev => ({ ...prev, examType: String(event.detail.value || '') }))} /> + setCrmForm(prev => ({ ...prev, timeoutSec: String(event.detail.value || '') }))} /> + setCrmForm(prev => ({ ...prev, delaySec: String(event.detail.value || '') }))} /> + + + + + + + {crmConfig?.enabled ? 'CRM 已启用' : 'CRM 未启用'} + {crmConfig?.url || '未配置 URL'} · {crmConfig?.secretRef || '未配置 secretRef'} + + + + + CRM 队列 + + {['', 'pending', 'sent', 'failed', 'discarded'].map(status => ( + + ))} + + + {crmQueue.slice(0, 10).map(item => ( + + {item.status || 'pending'} · {item.source || 'lead'} + 尝试 {item.attempts || 0} 次 · HTTP {item.lastHttpCode || '-'} · {item.sentAt || item.nextAttemptAt || item.createdAt || '-'} + {item.lastError ? {item.lastError} : null} + + ))} + + {!crmQueue.length ? 暂无 CRM 队列。 : null} + + + + 分佣规则 + + setCommissionForm(prev => ({ ...prev, defaultRatePercent: String(event.detail.value || '') }))} /> + setCommissionForm(prev => ({ ...prev, minSettlementYuan: String(event.detail.value || '') }))} /> + + + {['manual', 'weekly', 'monthly'].map(item => ( + + ))} + + + + 默认 {rateToPercent(commissionSettings?.defaultRate)}% + 最低结算 {money(commissionSettings?.minSettlementCents)} · {commissionSettings?.settlementCycle || 'monthly'} + + + + + 成员分佣比例 + + {salesMembers.map(item => ( + + ))} + + + setMemberRate(prev => ({ ...prev, ratePercent: String(event.detail.value || '') }))} /> + + + + + + 分佣统计 + + setPeriod(prev => ({ ...prev, startDate: String(event.detail.value || '') }))} /> + setPeriod(prev => ({ ...prev, endDate: String(event.detail.value || '') }))} /> + + + + {salesMembers.map(item => ( + + ))} + + + + + 来源数{String(commission?.sourceCount || 0)} + 成交金额{money(commission?.grossAmountCents)} + 应结佣金{money(commission?.commissionAmountCents)} + 成交用户{String(commission?.paidUserCount || 0)} + + + + + 分佣订单明细 + + {commissionOrders.slice(0, 10).map((item, index) => ( + + {item.referrerName || item.referrerPhone || item.referrerUserId || '成员'} · {money(item.commissionAmountCents)} + {item.sourceType || '-'} · 成交 {money(item.grossAmountCents)} · 比例 {rateToPercent(item.commissionRate)}% · {item.rateSource || '-'} + + ))} + + {!commissionOrders.length ? 当前筛选范围暂无可结算订单。 : null} + + + + 结算单 + + setSettlementPay(prev => ({ ...prev, paymentMethod: String(event.detail.value || '') }))} /> + setSettlementPay(prev => ({ ...prev, paymentAccount: String(event.detail.value || '') }))} /> + + + {settlements.map(item => ( + + {item.settlementNo || item.id} + {item.referrerName || item.referrerPhone || item.referrerUserId} · {item.status || 'draft'} · {money(item.commissionAmountCents)} + {item.periodStart || '-'} 至 {item.periodEnd || '-'} · 来源 {item.sourceCount || 0} + + {item.status === 'pending_review' ? : null} + {item.status === 'pending_review' ? : null} + {item.status === 'approved' ? : null} + + + ))} + + {!settlements.length ? 暂无结算单。 : null} + + 优惠券 diff --git a/apps/taro/src/services/tenantAdmin.ts b/apps/taro/src/services/tenantAdmin.ts index a9bf1f61..2b532436 100644 --- a/apps/taro/src/services/tenantAdmin.ts +++ b/apps/taro/src/services/tenantAdmin.ts @@ -234,6 +234,101 @@ export interface CodeBatchItem { status?: string; } +export interface CrmConfigItem { + id?: string; + enabled?: boolean; + url?: string | null; + secretRef?: string | null; + formName?: string | null; + examType?: string | null; + timeoutSec?: number; + delaySec?: number; + updatedAt?: string; +} + +export interface CrmQueueItem { + id: string; + recordId?: string | null; + status?: string; + scheduledAt?: string | null; + attempts?: number; + nextAttemptAt?: string | null; + lastError?: string | null; + lastHttpCode?: number | null; + leadId?: string | null; + sentAt?: string | null; + source?: string | null; + targetUrl?: string | null; + payload?: Record; + createdAt?: string; +} + +export interface CommissionSettingsItem { + defaultRate?: number | string; + minSettlementCents?: number; + settlementCycle?: string; + config?: Record; + updatedAt?: string; +} + +export interface CommissionSummaryItem { + tenantId?: string; + startDate?: string; + endDate?: string; + referrerUserId?: string | null; + defaultRate?: number | string; + minSettlementCents?: number; + sourceCount?: number; + paidUserCount?: number; + grossAmountCents?: number; + commissionAmountCents?: number; + byReferrer?: Record[]; +} + +export interface CommissionOrderItem { + sourceType?: string; + sourceId?: string; + sourceNo?: string | null; + referrerUserId?: string; + referrerName?: string | null; + referrerPhone?: string | null; + studentUserId?: string | null; + studentName?: string | null; + grossAmountCents?: number; + commissionRate?: number | string; + commissionAmountCents?: number; + rateSource?: string; + settlementId?: string | null; + sourcePaidAt?: string | null; +} + +export interface CommissionSettlementItem { + id: string; + settlementNo?: string; + referrerUserId?: string; + referrerName?: string | null; + referrerPhone?: string | null; + status?: string; + periodStart?: string; + periodEnd?: string; + sourceCount?: number; + paidUserCount?: number; + grossAmountCents?: number; + commissionAmountCents?: number; + defaultRate?: number | string; + effectiveRate?: number | string; + reviewedBy?: string | null; + reviewedAt?: string | null; + paidBy?: string | null; + paidAt?: string | null; + paymentMethod?: string | null; + paymentAccount?: string | null; + remark?: string | null; + metadata?: Record; + createdAt?: string; + updatedAt?: string; +} + export interface TenantOverview { id?: string; name?: string; @@ -518,10 +613,95 @@ export async function disableTenantMember(membershipId: string) { }); } -export async function loadCrmQueue(limit = 20) { - return apiRequest<{ items?: Record[] }>('/api/crm/queue', { query: { limit } }); +export async function loadCrmConfig() { + return apiRequest<{ item?: CrmConfigItem | null }>('/api/crm/config'); } -export async function loadCommissionSummary() { - return apiRequest<{ item?: Record }>('/api/commission/summary'); +export async function upsertCrmConfig(input: { + enabled?: boolean; + url?: string | null; + secretRef?: string | null; + formName?: string | null; + examType?: string | null; + timeoutSec?: number; + delaySec?: number; +}) { + return apiRequest<{ item?: CrmConfigItem }>('/api/crm/config', { + method: 'PUT', + body: input, + }); +} + +export async function loadCrmQueue(limit = 20, status?: string) { + return apiRequest<{ items?: CrmQueueItem[] }>('/api/crm/queue', { query: { limit, status } }); +} + +export async function loadCommissionSettings() { + return apiRequest<{ item?: CommissionSettingsItem }>('/api/commission/settings'); +} + +export async function updateCommissionSettings(input: { + defaultRate: number; + minSettlementCents?: number; + settlementCycle?: string; + config?: Record; +}) { + return apiRequest<{ item?: CommissionSettingsItem }>('/api/commission/settings', { + method: 'PUT', + body: input, + }); +} + +export async function updateMemberCommissionRate(input: { + userId: string; + commissionRate?: number | null; + commissionConfig?: Record; +}) { + return apiRequest<{ item?: Record }>('/api/commission/member-rate', { + method: 'PUT', + body: input, + }); +} + +export async function loadCommissionSummary(query: { startDate?: string; endDate?: string; referrerUserId?: string } = {}) { + return apiRequest<{ item?: CommissionSummaryItem }>('/api/commission/summary', { query }); +} + +export async function loadCommissionOrders(query: { startDate?: string; endDate?: string; referrerUserId?: string; limit?: number } = {}) { + return apiRequest<{ items?: CommissionOrderItem[]; scope?: Record }>('/api/commission/orders', { + query: { ...query, limit: query.limit || 50 }, + }); +} + +export async function loadCommissionSettlements(query: { status?: string; referrerUserId?: string; limit?: number } = {}) { + return apiRequest<{ items?: CommissionSettlementItem[] }>('/api/commission/settlements', { + query: { ...query, limit: query.limit || 50 }, + }); +} + +export async function generateCommissionSettlement(input: { + referrerUserId: string; + startDate: string; + endDate: string; + status?: string; + remark?: string | null; +}) { + return apiRequest<{ item?: CommissionSettlementItem & { items?: CommissionOrderItem[] } }>('/api/commission/settlements/generate', { + method: 'POST', + body: input, + }); +} + +export async function updateCommissionSettlementStatus(input: { + settlementId: string; + status: string; + paymentMethod?: string | null; + paymentAccount?: string | null; + remark?: string | null; + metadata?: Record; +}) { + return apiRequest<{ item?: CommissionSettlementItem }>('/api/commission/settlements/status', { + method: 'POST', + body: input, + }); } diff --git a/docs/refactor/backend-handoff-roadmap.md b/docs/refactor/backend-handoff-roadmap.md index 257d2d0a..3563779d 100644 --- a/docs/refactor/backend-handoff-roadmap.md +++ b/docs/refactor/backend-handoff-roadmap.md @@ -11,10 +11,10 @@ - 平台侧可以管理租户、SaaS 套餐、订阅、账单、服务费和用量。 - 租户侧可以管理品牌、域名、支付账户、登录配置、私密密钥、活动、兑换码、优惠券、成员权限、审计日志、内容入口、分类树、题目集合、练习蓝图、题目、视频、分数线、单词、知识手册、资料资源和题库导出任务。 - 学生侧已经有题库入口、分类树、题目集合、顺序/随机/全真模拟组卷、答题、错题、收藏、背单词进度、个人中心、勋章、排行榜、分数线、视频、订单详情/状态轮询、优惠券领取/抵扣、权益、激活码预检查/兑换和资料下载的基础 API。 -- 销售/代理/CRM 已经有邀请码、扫码/分享事件、首绑客资保护、团队关系、统计、CRM 配置和入队能力。 +- 销售/代理/CRM 已经有邀请码、扫码/分享事件、首绑客资保护、团队关系、统计、CRM 配置、入队、worker 推送和分佣结算基础闭环。 - 旧题库 JSON、单词模板、知识手册嵌套模板、分数线 JSON 和视频绑定 JSON 已经进入后端 preview/import 管线，由后端负责规范化、校验、幂等、审计和租户隔离。 -因此，后端现在已经具备进入 Taro 前端第一阶段联调的基础。需要注意的是，它还不是完整生产交付状态，真实云端鉴权、对象存储生产安全、支付/短信/OAuth 生产账号、真实数据 dry-run 迁移仍需要继续补齐或联调；导入后复检、模板下载、字段映射 API 和导入任务详情已可联调，Taro 租户内容页已接入上传/粘贴预览、字段别名覆盖、同步/异步执行、异步轮询和复检详情第一版。 +因此，后端现在已经具备进入 Taro 前端第一阶段联调的基础。需要注意的是，它还不是完整生产交付状态，真实云端鉴权、对象存储生产安全、支付/短信/OAuth 生产账号、真实数据 dry-run 迁移仍需要继续补齐或联调；导入后复检、模板下载、字段映射 API 和导入任务详情已可联调，Taro 租户内容页已接入上传/粘贴预览、字段别名覆盖、同步/异步执行、异步轮询和复检详情第一版，租户营销中心已接入 CRM 配置/队列和分佣结算操作台第一版。 ## 后端模块进度 @@ -22,7 +22,7 @@ | --- | --- | --- | --- | | 多租户底座 | 可联调 | 租户、域名、品牌、设置、RLS 基础、审计、Supabase JWT/API 身份映射 | 真实云端 Auth/JWKS 回归、生产 RLS 深测 | | 平台后台 | 基础完成 | 租户、套餐、订阅、账单、服务费、用量、公共题库授权、公共题库自动同步 worker、公共题库冲突单条/批量处理 API | 自动计费、平台审计、公共题库版本通知和运营消息 | -| 租户后台 | 可联调 | 品牌、域名、支付账户、登录配置、密钥掩码、活动、兑换码、优惠券、勋章管理/发放、成员权限、角色模板、菜单/模块/字段权限配置 API、班级/教师/学生范围权限；Taro 工作台已接权限驱动模块入口，租户设置页已接角色模板和成员绑定操作台第一版 | 更细的数据范围组合、成员批量运营和完整权限菜单 | +| 租户后台 | 可联调 | 品牌、域名、支付账户、登录配置、密钥掩码、活动、兑换码、优惠券、勋章管理/发放、成员权限、角色模板、菜单/模块/字段权限配置 API、班级/教师/学生范围权限；Taro 工作台已接权限驱动模块入口，租户设置页已接角色模板和成员绑定操作台第一版，营销中心已接 CRM 配置/队列和分佣结算操作台第一版 | 更细的数据范围组合、成员批量运营、真实打款/导出/凭证和完整权限菜单 | | 题库与练习 | 可联调 | 内容入口、任意深度分类、题目集合、顺序/随机/全真模拟蓝图、组卷快照、答题、错题、收藏、模考报告、排行榜、公共题库采纳快照、手动同步、自动同步 worker、冲突查询/单条和批量处理 API、JSON/试卷 payload 导出 | 专项策略、PDF/Word 导出 worker、公共题库版本通知、排行榜防刷/预聚合 | | 背单词 | 可联调 | 单元、单词、进度、收藏、统计、每日计划、JSON/CSV/Excel 导入、排行榜 | 更细复习参数 | | 知识手册 | 可联调 | 科目、章节、条目、Markdown 内容、嵌套 JSON/CSV/Excel 导入 | 富文本资源、版本管理、附件/PDF 关联 | @@ -31,11 +31,11 @@ | 资料下载 | 部分完成 | 资源台账、SVIP 权限校验、`local_dev`/阿里云 OSS/腾讯 COS/Supabase Storage 上传下载签名、上传确认、PDF/图片预览签名、assets worker 复检异常下架 | PDF 渲染、CDN 防盗链、杀毒扫描、视频水印 | | 会员与订单 | 可联调 | 下单、订单详情/状态轮询、优惠券领取/抵扣、零元订单自动开通、手工确认权限保护、激活码预检查/兑换、微信支付、支付宝、微信/支付宝发起退款、微信/支付宝退款查询确认、微信/支付宝退款通知 webhook、支付/退款补偿 worker、权益发放 | 完整资金流水对账、异常订单运营台 | | 登录认证 | 可联调 | 短信 mock、阿里云/腾讯云短信 adapter、迁移期 session、Supabase Auth JWT、微信小程序登录、微信网页登录、QQ 登录、手机号绑定/换绑、OAuth 配置表 | 真实生产账号和回调域名联调 | -| 销售/代理/CRM | 基础完成 | 邀请码、首绑保护、团队关系、销售统计、CRM 入队 | 小程序码真实生成、分佣结算、钉钉/飞书/企微 worker | +| 销售/代理/CRM | 可联调 | 邀请码、首绑保护、团队关系、销售统计、CRM 配置/队列、钉钉/飞书/企微 worker、分佣规则、成员分佣比例、订单/激活码归因、结算生成、审核和打款状态；Taro 营销中心已接第一版操作台 | 小程序码真实生成、CRM 分配策略、结算导出、真实打款、凭证、财务复核和销售转化看板 | | 内容导入 | 可联调 | 题目、单词、知识手册、分数线、视频 JSON/CSV/Excel preview/import、issue、job/detail、审计、幂等、`executionMode=async`、imports worker、导入后复检、模板下载、字段映射 API、字段映射覆盖白名单校验、PocketBase JSON dry-run 报告；Taro 租户内容页已接上传/粘贴预览、模板文件下载、字段别名编辑、同步/异步执行、异步轮询和复检详情第一版 | 真实数据 dry-run 执行验收、抽样校验和导入性能压测 | | 数据看板 | 可联调 | 租户 dashboard 聚合接口，收益、注册、学习、内容、激活码、反馈、趋势、24h 活跃、套餐销量和运营动态 | 预聚合 worker、缓存、慢 SQL 监控和销售转化看板 | | AI 择校推荐 | 未开始 | 暂无 | 数据上下文、AI JSON schema、报告渲染、PDF 生成 | -| Taro 前端 | 地基已建 | `apps/taro` 已有 Taro 4 React 工程、H5 三入口、租户解析、统一 API client、Supabase Auth client 初始化；学生端、租户后台和平台后台均已有第一批真实 API 页面；学生端已接地区选择、错题/收藏复习、题目反馈、视频解析、练习/模考报告、收银台、订单详情和售后入口第一版；平台后台已接关键写操作第一版，租户工作台已接权限驱动模块入口，租户内容页已接公共题库采纳/同步、冲突查看、单条/批量采纳平台或保留本地、导入问题、字段模板预览/下载、上传/粘贴预览、字段别名覆盖、同步/异步导入、异步轮询和复检详情第一版；租户设置页已接角色模板和成员绑定操作台第一版 | 刷题细节 UI、更细数据范围 UI、平台后台审计/详情增强、小程序兼容验证和端到端测试 | +| Taro 前端 | 地基已建 | `apps/taro` 已有 Taro 4 React 工程、H5 三入口、租户解析、统一 API client、Supabase Auth client 初始化；学生端、租户后台和平台后台均已有第一批真实 API 页面；学生端已接地区选择、错题/收藏复习、题目反馈、视频解析、练习/模考报告、收银台、订单详情和售后入口第一版；平台后台已接关键写操作第一版，租户工作台已接权限驱动模块入口，租户内容页已接公共题库采纳/同步、冲突查看、单条/批量采纳平台或保留本地、导入问题、字段模板预览/下载、上传/粘贴预览、字段别名覆盖、同步/异步导入、异步轮询和复检详情第一版；租户设置页已接角色模板和成员绑定操作台第一版；租户营销中心已接 CRM 配置保存、队列筛选、分佣规则、成员比例、订单明细、结算生成/审核/标记线下打款第一版 | 刷题细节 UI、更细数据范围 UI、平台后台审计/详情增强、小程序兼容验证和端到端测试 | ## 前端接入建议 @@ -79,7 +79,7 @@ - 对象存储：上传/下载签名已接入阿里云 OSS、腾讯云 COS、Supabase Storage；上传确认、PDF/图片预览签名和 assets worker 复检已完成，继续补 PDF 渲染、视频播放防盗链、杀毒扫描和水印。 - 真实数据 dry-run：导出 PocketBase 用户、题库、单词、知识手册、分数线、订单、权益，先跑 `npm run pb:import:dry-run`，再跑迁移和校验报告。 - 生产环境配置：`.env.example` 和 `npm run readiness:production` / `npm run readiness:production:db` 已补；继续补数据库迁移流程、备份恢复、日志、告警和 API 容器部署说明。 -- Taro scaffold：`apps/taro` 地基已建立；学生端、租户后台、平台后台第一批 H5 页面已接真实 API，学生端已接地区选择、错题/收藏复习、题目反馈、视频解析、练习/模考报告、收银台、订单详情和售后入口第一版，平台后台关键写操作第一版已接入，租户工作台已接权限驱动模块入口，租户内容页已接公共题库采纳/同步、冲突查看、单条/批量采纳平台或保留本地、导入问题、字段模板预览/下载、上传/粘贴预览、字段别名覆盖、同步/异步导入、异步轮询和复检详情第一版，租户设置页已接角色模板创建/编辑/停用、成员绑定模板和权限可见性配置第一版；下一步补刷题细节 UI、更细数据范围 UI、平台后台审计增强和小程序兼容验证。 +- Taro scaffold：`apps/taro` 地基已建立；学生端、租户后台、平台后台第一批 H5 页面已接真实 API，学生端已接地区选择、错题/收藏复习、题目反馈、视频解析、练习/模考报告、收银台、订单详情和售后入口第一版，平台后台关键写操作第一版已接入，租户工作台已接权限驱动模块入口，租户内容页已接公共题库采纳/同步、冲突查看、单条/批量采纳平台或保留本地、导入问题、字段模板预览/下载、上传/粘贴预览、字段别名覆盖、同步/异步导入、异步轮询和复检详情第一版，租户设置页已接角色模板创建/编辑/停用、成员绑定模板和权限可见性配置第一版，租户营销中心已接 CRM 配置/队列和分佣结算操作台第一版；下一步补刷题细节 UI、更细数据范围 UI、平台后台审计增强和小程序兼容验证。 ### P1：商用收费和运营能力 @@ -95,8 +95,8 @@ - 租户自定义角色模板基础 API、Taro 权限配置 UI、成员绑定模板和工作台权限驱动入口第一版已完成；继续补班级/教师/学生组合范围 UI、成员批量运营和平台级审计报表。 - 三套默认主题、租户主题预览、Logo/图标/分享图配置。 -- CRM worker：钉钉、飞书、企微机器人发送、签名、失败重试已落地；继续补轮询/定向分配、富卡片、失败告警和死信运营台。 -- 销售/代理分佣结算、销售团队看板、客资跟进效果。 +- CRM worker：钉钉、飞书、企微机器人发送、签名、失败重试已落地；Taro 营销中心已能配置 CRM 和查看队列；继续补轮询/定向分配、富卡片、失败告警和死信运营台。 +- 销售/代理分佣基础闭环已接 Taro 第一版；继续补销售团队看板、客资跟进效果、结算导出、真实打款、凭证和财务复核。 - AI 择校推荐：地区考试数据、学生输入 schema、AI JSON 输出、PDF 报告生成。 - 性能压测、慢 SQL 审查、备份恢复演练、灰度发布和回滚预案。 diff --git a/docs/refactor/frontend-handoff-index.md b/docs/refactor/frontend-handoff-index.md index ba26ddc7..6bf25a43 100644 --- a/docs/refactor/frontend-handoff-index.md +++ b/docs/refactor/frontend-handoff-index.md @@ -26,7 +26,7 @@ ## 当前可进入的前端工作 - `apps/taro` 已经建立，且学生端第一批 H5 页面已经可构建：登录、首页、地区选择、题库、练习、错题/收藏、练习报告、视频解析、会员收银台、订单详情、背单词、知识手册、分数线、资料、个人中心。 -- 租户后台第一批 H5 页面已经可构建：工作台、数据看板、学生/班级、题库内容、营销中心、租户设置；工作台已接 `/api/tenant-admin/permissions` 做权限驱动模块入口；题库内容页已具备公共题库采纳/同步、冲突查看、单条/批量采纳平台版本或保留本地版本、导入任务详情、异步轮询、导入问题查看、模板预览/下载、导入后复检详情、JSON/CSV/Excel 选择文件或粘贴内容、后端预览、字段别名覆盖和同步/异步执行导入的第一版操作能力；租户设置页已具备角色模板新建、编辑、停用、成员搜索/新建、成员绑定模板、成员状态和额外权限覆盖第一版。 +- 租户后台第一批 H5 页面已经可构建：工作台、数据看板、学生/班级、题库内容、营销中心、租户设置；工作台已接 `/api/tenant-admin/permissions` 做权限驱动模块入口；题库内容页已具备公共题库采纳/同步、冲突查看、单条/批量采纳平台版本或保留本地版本、导入任务详情、异步轮询、导入问题查看、模板预览/下载、导入后复检详情、JSON/CSV/Excel 选择文件或粘贴内容、后端预览、字段别名覆盖和同步/异步执行导入的第一版操作能力；营销中心已具备 CRM 配置、CRM 队列查看、分佣规则、成员分佣比例、分佣订单、结算单生成/审核/标记打款第一版；租户设置页已具备角色模板新建、编辑、停用、成员搜索/新建、成员绑定模板、成员状态和额外权限覆盖第一版。 - 平台后台第一批 H5 页面已经可构建：工作台、租户管理、账务中心、公共题库授权。 - 可以继续复刻旧题库学生端主要视觉和交互：刷题细节、勋章展示和小程序端分享/支付体验。地区选择、视频解析、题目反馈、模考/练习报告、错题复习、收藏复习、商城收银台、订单详情和售后入口已经有第一版页面。 - 可以按新后端主模型接入内容导航： @@ -88,10 +88,10 @@ | 数据看板 | `apps/taro/src/pages/tenant-admin/dashboard/index.tsx` | `tenant-admin/dashboard` | | 学生运营 | `apps/taro/src/pages/tenant-admin/students/index.tsx` | `tenant-admin/classes`、`tenant-admin/students` | | 题库内容 | `apps/taro/src/pages/tenant-admin/content/index.tsx` | `tenant-content/content-entries`、`tenant-content/imports`、`imports/detail`、`imports/issues`、`imports/field-mapping`、`imports/templates`、`imports/post-check`、`tenant-content/public-question-banks`、`public-question-banks/adopt`、`public-question-banks/sync`、`public-question-banks/conflicts`、`public-question-banks/conflicts/resolve`、`public-question-banks/conflicts/resolve-batch` | -| 营销中心 | `apps/taro/src/pages/tenant-admin/marketing/index.tsx` | `tenant-admin/coupons`、`code-batches`、`activation-codes`、`crm/queue`、`commission/summary` | +| 营销中心 | `apps/taro/src/pages/tenant-admin/marketing/index.tsx` | `tenant-admin/coupons`、`code-batches`、`activation-codes`、`crm/config`、`crm/queue`、`commission/settings`、`member-rate`、`summary`、`orders`、`settlements`、`settlements/generate`、`settlements/status` | | 租户设置 | `apps/taro/src/pages/tenant-admin/settings/index.tsx` | `tenant-admin/overview`、`domains`、`payment-accounts`、`auth-providers`、`permissions`、`GET/PUT role-templates`、`POST role-templates/disable`、`GET/PUT members`、`POST members/disable` | -当前租户后台已有第一批运营操作：工作台按权限矩阵隐藏不可见模块；题库内容页支持公共题库采纳/同步、同步冲突查看、单条/批量采纳平台版本或保留本地版本、导入任务详情、异步 job 轮询、导入问题查看、字段映射/模板预览/下载、JSON/CSV/Excel 导入预览和执行、字段别名覆盖和导入后复检详情；租户设置页支持角色模板创建、编辑、停用、权限点、菜单、模块、字段、基础数据范围配置、成员搜索/新建、成员绑定模板、成员状态和额外权限覆盖。下一批需要继续补完整后台写入表单、学生批量导入、更细数据范围 UI 和成员批量运营。 +当前租户后台已有第一批运营操作：工作台按权限矩阵隐藏不可见模块；题库内容页支持公共题库采纳/同步、同步冲突查看、单条/批量采纳平台版本或保留本地版本、导入任务详情、异步 job 轮询、导入问题查看、字段映射/模板预览/下载、JSON/CSV/Excel 导入预览和执行、字段别名覆盖和导入后复检详情；营销中心支持 CRM 配置保存、队列按状态查看、分佣规则、成员分佣比例、分佣订单明细、结算单生成、审核通过/驳回和标记线下打款；租户设置页支持角色模板创建、编辑、停用、权限点、菜单、模块、字段、基础数据范围配置、成员搜索/新建、成员绑定模板、成员状态和额外权限覆盖。下一批需要继续补完整后台写入表单、学生批量导入、更细数据范围 UI、真实打款 provider、结算导出和凭证。 ## 已落地的 Taro 平台后台页面 diff --git a/docs/refactor/next-development-todo.md b/docs/refactor/next-development-todo.md index 7ffff9c6..b073d9fa 100644 --- a/docs/refactor/next-development-todo.md +++ b/docs/refactor/next-development-todo.md @@ -11,7 +11,7 @@ - 学生端核心 API：题库、练习、答题、模考交卷报告、练习历史、学习统计、排行榜、错题复习计划、错题、收藏、背单词、知识手册、分数线、视频播放签名、资料、订单详情/状态轮询、优惠券领取/抵扣、激活码预检查/兑换、权益、个人中心、考试倒计时、签到积分、题目反馈、勋章。 - 租户后台 API：品牌、域名、设置、支付账户、登录 provider、私密密钥、活动、考试日期、题目反馈处理、激活码、优惠券、勋章管理/发放、成员权限、审计、内容管理、班级/教师/学生、学生批量导入、批量分班、学生备注、跟进任务。 - 平台后台 API：租户、SaaS 套餐、订阅、账单、服务费收款、用量。 -- 销售/代理/CRM 增长链路：邀请码、扫码事件、首绑保护、团队、统计、CRM 队列。 +- 销售/代理/CRM 增长链路：邀请码、扫码事件、首绑保护、团队、统计、CRM 配置/队列、CRM worker、分佣规则、成员比例、订单/激活码归因、结算生成、审核和打款状态；Taro 租户营销中心已接第一版操作台。 - 内容导航：`content_entries/content_nodes` 支持任意深度入口和分类。 - 练习组卷：`question_collections/practice_blueprints` 支持顺序、随机、全真模拟快照。 - 模考报告与学习统计：`practice_session_reports/practice_session_report_sections` 支持交卷、评分、题型/小节统计、错题解析汇总和历史查询；`/api/learning/stats`、`trend`、`practice-sessions/history`、`wrong-questions/review-plan` 可支撑个人中心和学习报告基础页。 @@ -164,7 +164,7 @@ - H5 和小程序共用同一套业务 API client。 - 租户通过域名、小程序配置或启动参数解析。 - 页面主题、品牌、功能开关都从后端租户配置读取。 -- 当前已完成 H5 学生端、租户后台、平台后台三套构建入口和统一 API client；学生端、租户后台、平台后台都有第一批真实 API 页面；学生端已补地区选择、错题/收藏复习、题目反馈、视频解析、练习/模考报告、会员收银台、订单详情和售后入口第一版；平台后台已接入创建租户、状态变更、订阅、账单、收款、用量和公共题库授权第一版写操作；租户后台已接权限驱动工作台、角色模板和成员绑定第一版；下一步补租户后台 CRM/分佣深度写操作、刷题细节 UI、状态管理和小程序兼容验证。 +- 当前已完成 H5 学生端、租户后台、平台后台三套构建入口和统一 API client；学生端、租户后台、平台后台都有第一批真实 API 页面；学生端已补地区选择、错题/收藏复习、题目反馈、视频解析、练习/模考报告、会员收银台、订单详情和售后入口第一版；平台后台已接入创建租户、状态变更、订阅、账单、收款、用量和公共题库授权第一版写操作；租户后台已接权限驱动工作台、角色模板、成员绑定和 CRM/分佣操作台第一版；下一步补刷题细节 UI、状态管理、更细数据范围 UI、学生批量运营和小程序兼容验证。 ### 第一批页面 @@ -213,7 +213,7 @@ ## 推荐下一步顺序 -1. 补租户后台写操作台：公共题库采纳/同步、冲突查看、单条/批量冲突采纳平台或保留本地、导入问题、模板预览/下载、上传/粘贴 preview/import、字段映射编辑、异步导入轮询、导入后复检详情、权限驱动工作台、角色模板配置和成员绑定模板已接第一版；继续补 CRM/分佣深度写操作、成员批量运营和更细数据范围 UI。 +1. 补租户后台写操作台：公共题库采纳/同步、冲突查看、单条/批量冲突采纳平台或保留本地、导入问题、模板预览/下载、上传/粘贴 preview/import、字段映射编辑、异步导入轮询、导入后复检详情、权限驱动工作台、角色模板配置、成员绑定模板、CRM 配置/队列、分佣规则/成员比例/结算生成审核打款已接第一版；继续补成员批量运营、学生批量导入、更细数据范围 UI、真实打款/导出/凭证。 2. 继续补 Taro 学生端旧体验：地区选择、视频播放、反馈、模考报告、错题/收藏专题、收银台、订单详情和售后入口已接第一版；继续补刷题细节 UI、小程序支付容器、分享场景和状态管理。 3. 补平台后台增强：租户详情/编辑、平台审计报表、自动计费、账单批量操作和更细平台权限点。 4. 云服务器部署 Supabase/PostgreSQL 和 API，配置对象存储生产环境变量，跑 `check:refactor` 的远程等价测试。 diff --git a/docs/refactor/taro-frontend-integration.md b/docs/refactor/taro-frontend-integration.md index 5e51747a..a1d979c1 100644 --- a/docs/refactor/taro-frontend-integration.md +++ b/docs/refactor/taro-frontend-integration.md @@ -1408,7 +1408,7 @@ src/services/learning.ts 练习 session、答题、收藏、错题/收藏复 src/services/commerce.ts 套餐、优惠券、下单、支付参数、订单详情、权益、激活码 src/services/profile.ts 个人中心、地区目标、签到、反馈、勋章、倒计时 src/services/video.ts 题目视频列表、播放签名 -src/services/tenantAdmin.ts 租户后台看板、权限矩阵、成员、学生、内容、营销、设置、角色模板写操作、公共题库采纳/同步/单条和批量冲突处理、导入详情/复检 +src/services/tenantAdmin.ts 租户后台看板、权限矩阵、成员、学生、内容、营销、设置、角色模板写操作、公共题库采纳/同步/单条和批量冲突处理、导入详情/复检、CRM 配置/队列、分佣规则/成员比例/订单/结算 src/services/platformAdmin.ts 平台后台租户、套餐账单、用量、公共题库授权 ``` @@ -1426,7 +1426,7 @@ npm run build:taro:h5:platform 下一批前端开发重点： - 学生端：地区选择、题目视频播放、题目反馈、错题/收藏专题页、模考交卷报告、收银台、订单详情和售后入口已接第一版；下一批继续补刷题细节 UI、小程序支付容器和分享场景。 -- 租户后台：工作台已接权限驱动模块入口；题库内容页已接公共题库采纳/同步、冲突查看、单条/批量采纳平台或保留本地、导入问题、模板预览/下载、异步任务轮询和导入后复检第一版；租户设置页已接角色模板创建、编辑、停用、权限点、菜单、模块、字段、基础数据范围、成员搜索/新建、成员绑定模板、成员状态和额外权限覆盖第一版；下一批继续补完整写入表单、学生批量导入、CRM 分配和分佣结算操作。 +- 租户后台：工作台已接权限驱动模块入口；题库内容页已接公共题库采纳/同步、冲突查看、单条/批量采纳平台或保留本地、导入问题、模板预览/下载、异步任务轮询和导入后复检第一版；营销中心已接 CRM 配置保存、CRM 队列按状态查看、分佣默认规则、成员分佣比例、分佣订单明细、结算单生成、审核通过/驳回和标记线下打款第一版；租户设置页已接角色模板创建、编辑、停用、权限点、菜单、模块、字段、基础数据范围、成员搜索/新建、成员绑定模板、成员状态和额外权限覆盖第一版；下一批继续补完整写入表单、学生批量导入、CRM 分配策略、真实打款/导出/凭证和更细数据范围 UI。 - 平台后台：租户创建、状态变更、订阅开通、账单生成、人工收款确认、用量录入、公共题库授权编辑已接第一版；继续补租户详情/编辑、平台审计、自动计费和批量账单操作。 - 小程序：验证 `Taro.login`、微信支付、分享 scene/referral、Supabase client 兼容性；如不稳定，保留 `apps/api/auth/*` 作为小程序登录适配层。 @@ -1448,7 +1448,7 @@ npm run build:taro:h5:platform - 勋章：`GET/PUT /api/tenant-admin/badges`、`GET/POST /api/tenant-admin/badge-grants` - 考试日期：`GET/PUT /api/tenant-admin/exam-dates` - 题目反馈：`GET /api/tenant-admin/feedbacks`、`POST /api/tenant-admin/feedbacks/status`、`GET /api/tenant-admin/feedbacks/events` -- 销售/代理/CRM 队列 +- 销售/代理/CRM 队列、CRM 配置、分佣规则、成员分佣比例、分佣订单、结算单审核和线下打款登记；当前 Taro 租户营销中心已接第一版，真实打款 provider、结算导出、凭证和财务复核后续增强。 租户后台不应在前端自行决定权限；隐藏菜单只是体验优化，接口仍会校验权限。角色模板用于让租户配置“运营、教师、销售、代理”等自定义后台体验，成员绑定模板后，前端按模板的菜单/模块/字段权限渲染，后端按 permission keys 执行真正的访问控制。班级/学生范围权限由后端根据角色、模板 `dataScope.classIds` 和 `tenant_class_members` 计算，教师默认只能看到自己负责班级。