AICLW/wechatAiclaw

Fork 0

Files

Daniel aaf46207a4 fix:add new file

2026-03-24 10:51:05 +08:00

17 KiB

Raw Blame History

后端管理平台需求说明（仅订阅模块）

1. 范围

本期只做订阅模块，不考虑白标/OEM，不做合同/财务系统。

包含：

用户管理（后台）
套餐管理
订阅开通、升级、续费、到期失效
Token发放与吊销
额度校验与月用量统计
线下收款或第三方支付链接确认

不包含：

白标/OEM
分成系统
合同审批流
发票与财务对账系统

2. 角色

超级管理员：配置套餐、处理升级、强制开通/停用
运营：创建用户、确认支付、开通订阅、发放Token

3. 数据模型（最小集）

3.1 用户表 `users`

id
name
mobile
email
company_name
status（active/disabled）
created_at
updated_at

3.2 套餐表 `plans`

id
plan_code（starter/pro/enterprise）
plan_name
monthly_price
auth_fee
account_limit
active_user_limit
msg_quota
mass_quota
friend_quota
sns_quota
enabled_features（json，具体功能点）
status（active/inactive）
created_at
updated_at

3.3 订阅表 `subscriptions`

id
user_id
plan_id
status（pending/active/expired/cancelled）
start_time
end_time
renew_mode（manual/auto）
payment_channel（offline/pay_link）
payment_ref（线下流水号或第三方订单号）
created_at
updated_at

3.4 Token表 `api_tokens`

id
user_id
token_name
token_hash（仅存哈希）
status（active/revoked/expired）
expire_at
last_used_at
created_at
updated_at

3.5 月用量表 `usage_monthly`

id
user_id
plan_id
stat_month（YYYY-MM）
msg_count
mass_count
friend_count
sns_count
active_user_count
updated_at

4. 核心流程

4.1 开通流程

运营创建用户
选择套餐
记录支付方式（线下/支付链接）
支付确认后创建订阅（active）
生成Token并展示一次明文

4.2 升级流程

选择新套餐
确认补差支付
更新订阅的 plan_id 与生效时间
新套餐额度立即生效或次月生效（可配置）

4.3 续费流程

到期前提醒（D-7/D-3/D-1）
支付确认后延长 end_time
超期未续费则置为 expired
expired 状态禁止业务调用

4.4 Token鉴权流程（每次请求）

校验Token是否存在、是否过期、是否吊销
查询用户是否有 active 订阅
校验功能是否在 enabled_features 中
校验本月用量是否超套餐额度
通过则放行，失败返回明确错误码

5. 功能需求

5.1 用户管理

新增/编辑/禁用用户
查询用户当前订阅状态
查询用户Token列表

5.2 套餐管理

新增/编辑套餐
配置套餐价格、额度、功能点
套餐上下线

5.3 订阅管理

开通订阅
升级订阅
续费订阅
手动取消订阅
到期自动失效任务

5.4 Token管理

创建Token（只显示一次明文）
吊销Token
设置Token有效期
查询最后使用时间

5.5 支付确认（轻量）

线下收款：运营手动确认并录入 payment_ref
支付链接：接收第三方回调后确认支付并开通

6. 错误码（建议）

TOKEN_INVALID：Token不存在
TOKEN_EXPIRED：Token已过期
TOKEN_REVOKED：Token已吊销
SUBSCRIPTION_INACTIVE：无有效订阅
FEATURE_NOT_ALLOWED：功能不在套餐内
QUOTA_EXCEEDED：本月额度已用尽

7. 管理端API（MVP）

7.1 用户

POST /admin/users
GET /admin/users
GET /admin/users/{id}
PUT /admin/users/{id}
POST /admin/users/{id}/disable

7.2 套餐

POST /admin/plans
GET /admin/plans
PUT /admin/plans/{id}
POST /admin/plans/{id}/toggle

7.3 订阅

POST /admin/subscriptions/open
POST /admin/subscriptions/upgrade
POST /admin/subscriptions/renew
POST /admin/subscriptions/cancel
GET /admin/subscriptions/{user_id}

7.4 Token

POST /admin/tokens
GET /admin/tokens?user_id=
POST /admin/tokens/{id}/revoke

7.5 支付确认

POST /admin/payments/confirm-offline
POST /admin/payments/confirm-link

8. 定时任务

订阅到期扫描：每天00:10执行，更新 expired 状态
用量月结归档：每月1日00:30执行
续费提醒任务：每天09:00执行

9. 验收标准

可完成用户创建 -> 支付确认 -> 订阅开通 -> Token发放闭环
可完成升级与续费并正确生效
到期后能自动失效并阻断调用
功能与额度限制生效，错误码准确
支付链接回调或线下确认都可触发开通

10. 开发优先级

P0：

用户管理
套餐管理
订阅开通/升级/续费/失效
Token管理与鉴权

P1：

支付回调确认
用量统计与额度限制
到期提醒

后端管理平台需求说明（轻量核心版）

1. 目标

搭建最小可用后台，只做四件事：

用户管理
Token管理
套餐管理
开通/升级流程管理

不做（V1不开发）：

合同管理
财务系统集成
分成系统
复杂风控引擎

收费方式：

线下打款或在线支付链接（第三方支付页面）
支付成功后由后台手动或回调触发开通

2. 核心角色

超管：全局配置、套餐配置、手动开通
运营：用户资料维护、Token发放、套餐变更
客户（可选后续）：仅查看自己的Token和套餐状态

3. 核心数据模型

3.1 用户

users

id
name
mobile
email
company_name
status（active / disabled）
created_at
updated_at

3.2 套餐

plans

id
plan_code（starter/pro/enterprise）
plan_name
monthly_price
auth_fee
account_limit
active_user_limit
msg_quota
mass_quota
friend_quota
sns_quota
enabled_features（json数组，存具体功能点）
status（active / inactive）
created_at
updated_at

3.3 用户套餐实例

user_subscriptions

id
user_id
plan_id
start_time
end_time
status（pending/active/expired/cancelled）
payment_channel（offline / pay_link）
payment_ref（线下流水号或第三方订单号）
created_at
updated_at

3.4 Token

api_tokens

id
user_id
token_name
token_hash（仅存哈希）
status（active/revoked/expired）
plan_id（冗余，便于鉴权）
expire_at
last_used_at
created_at
updated_at

3.5 用量（按月聚合）

usage_monthly

id
user_id
plan_id
stat_month（YYYY-MM）
msg_count
mass_count
friend_count
sns_count
active_user_count
updated_at

4. 功能需求（MVP）

4.1 用户管理

新增/编辑/禁用用户
查看用户当前套餐、到期时间、Token数量
用户搜索（手机号、公司名、状态）

4.2 套餐管理

新增/编辑套餐
配置套餐额度和功能点
套餐上下线（active/inactive）
查看套餐被多少用户使用

4.3 Token管理

为用户创建Token（仅展示一次明文）
Token吊销（revoke）
Token过期时间设置
Token使用记录查看（最后使用时间）

鉴权规则（核心）：

请求带Token
校验Token状态与是否过期
读取用户当前有效套餐
判断功能是否在套餐内
判断当月额度是否超限

4.4 开通与升级流程

开通流程

创建用户
选择套餐
记录支付方式（线下/支付链接）
支付成功后开通订阅
生成Token并交付客户

升级流程

选择新套餐
记录补差支付
生效新套餐（立即或次月）
Token权限自动按新套餐生效

续费流程

到期前提醒（D-7、D-3、D-1）
支付成功后延长套餐周期
未支付则到期失效（Token权限受限）

5. 支付与开通方式（轻量）

支持两种方式：

offline：线下收款，后台手动录入流水号后开通
pay_link：调用第三方支付链接，回调成功后自动开通（或运营手动确认）

V1要求：

只保存支付结果与订单号
不做复杂账单系统

6. 最小风控与安全

Token只存哈希，不存明文
超管/运营所有关键操作写审计日志
单用户默认Token数量上限（如5个）
支持一键吊销全部Token
超额度后返回明确错误码（不做复杂策略引擎）

7. 接口清单（管理端）

7.1 用户

POST /admin/users 创建用户
GET /admin/users 用户列表
GET /admin/users/{id} 用户详情
PUT /admin/users/{id} 更新用户
POST /admin/users/{id}/disable 禁用用户

7.2 套餐

POST /admin/plans 创建套餐
GET /admin/plans 套餐列表
PUT /admin/plans/{id} 更新套餐
POST /admin/plans/{id}/toggle 上下线套餐

7.3 订阅

POST /admin/subscriptions/open 开通套餐
POST /admin/subscriptions/upgrade 升级套餐
POST /admin/subscriptions/renew 续费套餐
GET /admin/subscriptions/{user_id} 查询用户订阅

7.4 Token

POST /admin/tokens 创建Token
GET /admin/tokens?user_id= Token列表
POST /admin/tokens/{id}/revoke 吊销Token

7.5 支付记录

POST /admin/payments/confirm-offline 线下收款确认
POST /admin/payments/confirm-link 支付链接回调确认

8. 验收标准（上线即用）

可创建用户并成功开通任一套餐
可生成Token并用Token通过鉴权
套餐功能和额度能正确限制请求
可完成升级、续费、到期失效流程
支付成功后可触发开通（手动或回调）

9. 开发优先级与周期建议

P0（第1周）：

用户管理
套餐管理
订阅开通
Token创建与鉴权

P1（第2周）：

升级/续费流程
线下支付确认与支付链接回调
月用量聚合与额度限制

P2（第3周）：

到期提醒
审计日志页面
基础运营看板

微信自动化平台后端管理需求说明（V1）

1. 目标与范围

建设一套后端管理平台，支撑 方案.md 与 功能执行文档-报价方案配套.md 的落地执行，覆盖：

客户开通与版本管理
功能开关与白名单控制
额度管理与超量计费
授权码生命周期管理
账单、对账、分成结算
风险控制与违规处置

不在V1范围：

客户前台门户（仅后台运营端）
财务开票系统深度集成（先导出报表）

2. 角色与权限

2.1 角色

超级管理员：全局配置、价格策略、风控策略
商务运营：客户开通、版本变更、合同与授权
交付运营：功能开关、额度配置、验收记录
财务：账单确认、对账、分成结算
风控：告警处理、停用/解封、违规记录

2.2 权限原则

最小权限原则
核心动作（停服、改价、授权升级）需二次确认与审计日志
所有配置变更可追溯（操作者、时间、变更前后）

3. 核心业务对象（数据模型）

3.1 客户与合同

customer：客户主体信息（公司/个人、联系人、状态）
contract：合同编号、版本、期限、签约类型、分成比例、补充条款
service_instance：客户服务实例（当前版本、生效时间、到期时间）

3.2 版本与功能

plan：初级/高级/定制/白标
feature_catalog：功能目录（按具体功能点，不按抽象模块）
plan_feature_map：版本与功能映射（是否默认开通）
feature_switch：客户级功能开关（开/关、原因、操作者）

3.3 额度与计费

quota_policy：版本默认额度（消息、群发、加好友、朋友圈、企业微信）
customer_quota：客户当前额度（可覆盖默认值）
usage_daily / usage_monthly：按客户、按计费项聚合用量
price_policy：单价策略（默认价、阶梯价、生效时间）
billing_statement：月账单（固定费、超量费、人头费、分成）

3.4 授权与风控

license_key：授权码及状态（生成、激活、禁用、延期、删除）
risk_rule：风控规则（阈值、频率、异常模式）
risk_event：风险事件记录（级别、动作、处理结果）
penalty_action：处罚动作（限流、降级、停服、解封）

4. 功能模块需求

4.1 客户开通中心

功能点：

创建客户档案
绑定合同与版本
设置账号上限、活跃终端用户上限
初始化功能开关与额度
生成开通确认单

校验规则：

无合同不得开通付费版本
开通版本必须匹配授权级别
对外收费客户必须配置分成策略

4.2 版本与功能管理

功能点：

维护版本基础配置（初级/高级/定制/白标）
维护“具体功能点”目录与分组
一键应用版本默认功能到客户
客户级功能差异化调整（例外开关）

关键要求：

必须支持“包含/禁开”双清单导出（用于交付验收）
功能变更需记录变更单号与审批人

4.3 额度与限流管理

功能点：

配置套餐默认额度
按客户调整额度
配置阈值告警（80%、100%、120%）
配置超额后策略（仅计费 / 限流 / 禁止高风险动作）

关键要求：

日级、月级双维度统计
支持手动补偿额度（需审计）

4.4 计费与账单中心

功能点：

固定费用：月费 + 授权费
用量费用：按计费项单价计算
用户规模费用：超过100后按1元/人/月（可配置）
分成费用：按合同分成比例计算
生成月账单、账单确认、导出对账单

计算规则（V1）：

月账单金额 = 固定费 + 超量费 + 人头费 + 分成费
人头费基数 = max(活跃终端用户-100, 0)
活跃终端用户按唯一ID月去重

4.5 授权码管理

功能点：

生成授权码（不同有效期）
激活状态查询
禁用、删除、延期
授权状态同步任务

关键要求：

授权码与客户主体绑定
禁用后相关能力按策略自动降级/停用

4.6 分成与结算管理

功能点：

设置客户分成比例（10%/15%/20%或合同自定义）
录入/同步客户营收数据
自动计算应结分成
月度结算单导出

关键要求：

分成口径可配置（净营收/归因营收）
允许人工复核后确认入账

4.7 风控与违规处置

功能点：

风控规则配置（频率阈值、异常行为模式）
告警中心（低/中/高风险）
自动处罚策略（限流、冻结高风险功能、停服）
违规记录与解封流程

关键要求：

处罚动作必须可回溯
高风险停服需双人审批（可配置）

4.8 审计与操作日志

必须记录：

谁在何时改了什么
改前值/改后值
操作来源（后台/任务/接口）
关联客户、合同、账单编号

5. 核心流程（状态机）

5.1 客户生命周期

待签约 -> 已签约 -> 待开通 -> 已开通 -> 运行中 -> 欠费限制 -> 暂停服务 -> 终止

5.2 版本变更流程

提交升级/降级申请 -> 商务审批 -> 配置预览 -> 生效执行 -> 通知客户 -> 留档

5.3 月结流程

月末汇总用量 -> 生成预账单 -> 财务复核 -> 账单确认 -> 推送客户 -> 回款核销

6. 配置字典（建议）

6.1 计费项编码

MSG_CALL：消息调用
MASS_TASK：群发任务
ADD_FRIEND：加好友动作
SNS_ACTION：朋友圈动作
QY_ACTION：企业微信动作
ACTIVE_USER：活跃终端用户

6.2 风险等级

LOW：告警
MEDIUM：限流或冻结部分能力
HIGH：停服并人工复核

7. 报表与看板需求

7.1 运营看板

在服客户数（按版本）
当月升级/降级数量
功能开关变更次数
告警事件数量

7.2 财务看板

MRR、ARR
超量收入占比
人头费收入占比
分成收入占比
回款率与逾期率

7.3 客户视图

客户当前版本与到期时间
功能已开通清单
本月额度、已用量、超量预估
本月预估账单

8. 非功能性要求

可用性：后台可用性 >= 99.9%
审计性：关键操作100%留痕
安全性：权限隔离、敏感操作二次确认
性能：日汇总任务在60分钟内完成

9. MVP开发优先级

P0（必须）：

客户开通中心
版本/功能开关管理
额度管理
用量统计
账单生成
授权码管理
审计日志

P1（次优先）：

分成结算
风控自动处置
看板与报表

P2（后续）：

工作流审批引擎
财务系统对接
客户自助门户

10. 验收标准

10.1 功能验收

能按客户版本一键开通并生效
能对单客户进行功能级开关控制
能正确统计月用量并生成账单
能处理授权码生成、禁用、延期、查询

10.2 计费验收

对同一客户可复算账单结果（误差为0）
活跃终端用户去重规则正确
超量计费与阶梯价计算正确

10.3 风控验收

触发阈值后自动生成告警
可执行限流/停服动作并记录日志

11. 建议交付物

后台原型图（客户、版本、计费、风控四大页面）
数据库DDL初稿
后台API清单（管理端）
月账单计算任务说明
上线回滚预案

17 KiB Raw Blame History Unescape Escape

后端管理平台需求说明（仅订阅模块）

1. 范围

2. 角色

3. 数据模型（最小集）

3.1 用户表 users

3.2 套餐表 plans

3.3 订阅表 subscriptions

3.4 Token表 api_tokens

3.5 月用量表 usage_monthly

4. 核心流程

4.1 开通流程

4.2 升级流程

4.3 续费流程

4.4 Token鉴权流程（每次请求）

5. 功能需求

5.1 用户管理

5.2 套餐管理

5.3 订阅管理

5.4 Token管理

5.5 支付确认（轻量）

6. 错误码（建议）

7. 管理端API（MVP）

7.1 用户

7.2 套餐

7.3 订阅

7.4 Token

7.5 支付确认

8. 定时任务

9. 验收标准

10. 开发优先级

后端管理平台需求说明（轻量核心版）

1. 目标

2. 核心角色

3. 核心数据模型

3.1 用户

3.2 套餐

3.3 用户套餐实例

3.4 Token

3.5 用量（按月聚合）

4. 功能需求（MVP）

4.1 用户管理

4.2 套餐管理

4.3 Token管理

4.4 开通与升级流程

开通流程

升级流程

续费流程

5. 支付与开通方式（轻量）

6. 最小风控与安全

7. 接口清单（管理端）

7.1 用户

7.2 套餐

7.3 订阅

7.4 Token

7.5 支付记录

8. 验收标准（上线即用）

9. 开发优先级与周期建议

微信自动化平台后端管理需求说明（V1）

1. 目标与范围

2. 角色与权限

2.1 角色

2.2 权限原则

3. 核心业务对象（数据模型）

3.1 客户与合同

3.2 版本与功能

3.3 额度与计费

3.4 授权与风控

4. 功能模块需求

4.1 客户开通中心

4.2 版本与功能管理

4.3 额度与限流管理

4.4 计费与账单中心

4.5 授权码管理

4.6 分成与结算管理

4.7 风控与违规处置

4.8 审计与操作日志

5. 核心流程（状态机）

5.1 客户生命周期

5.2 版本变更流程

17 KiB

Raw Blame History

3.1 用户表 `users`

3.2 套餐表 `plans`

3.3 订阅表 `subscriptions`

3.4 Token表 `api_tokens`

3.5 月用量表 `usage_monthly`