ROK内务管理_产品文档

👑ROK 内务管理

产品文档中心

让每一个 R5 盟主，都拥有一个数字管家

微信搜「ROK 内务管理」小程序

产品概述

ROK 内务管理是专为《万国觉醒》（Rise of Kingdoms）联盟管理打造的微信小程序。一个账号管理 N 个王国，三大核心模块覆盖联盟管理全流程。

三大核心模块

🏰 活动中心

埃及之战自动组队（权重算法 ABC 均衡）

KVK 积分 OCR 截图识别，识别率 98.2%

PDD/ZDD 付费门票，微信虚拟支付自动核销

👑 王国管理

成员批量导入（CSV/粘贴/JSON/URL 四种方式）

R1–R5 五级职位体系，精细化权限控制

一个账号管理无限个王国，一键切换

💰 国库商城

混资/金币/宝石资源商品，电子化财务管理

兑换码批量生成，邮件分发，拉新裂变必备

会员套餐：免费版 / 标准版 ¥99/月 / 旗舰版 ¥299/月

快速开始

环境要求

开通王国（4 步）

1️⃣打开小程序 → 底部「开通王国」

2️⃣填写王国名称、区服编号、管理员昵称

3️⃣点击「开通」→ 系统自动生成王国密码

4️⃣管理员账号自动获得 R5 最高权限

新开通王国自动赠送 7 天标准版会员，管理员账号自动获得 R5 最高权限。

批量导入成员

支持四种导入方式，CSV 上传（推荐）> 粘贴板导入 > URL 抓取 > JSON 导入

CSV 模板示例：

game_id,nickname,role_r 1303-001-001,江东小霸王,R1 1303-001-002,常山赵子龙,R2 1303-001-003,卧龙先生,R3

功能模块详解

🏰 活动中心

埃及之战自动组队

基于武将池 + 战力平衡 + 历史表现三维权重算法，自动分配 A/B/C 三队。目标均衡度 ≤ 8%。

请求示例：

POST /api/activities/:id/auto-assign-teams Content-Type: application/json{"save": true,"strategy": "balanced","teamCount": 3 }

响应示例：

{"code": 0,"data": {"teams": {"A": [{"nickname": "小明", "score": 390, "weight": 82}],"B": [{"nickname": "小红", "score": 370, "weight": 75}],"C": [{"nickname": "小刚", "score": 390, "weight": 88}]},"balance_ratio": 5.1,"has_assignment": true} }

KVK 积分 OCR

PDD / ZDD 付费门票

微信虚拟支付 → 自动核销 → 后台对账。告别微信红包接龙，100% 电子化财务管理。

👑 王国管理

R1–R5 职位体系

R5 盟主─── 最高权限（创建活动、修改王国、财务管理） R4 副盟主 ─── 可创建活动、管理成员（不能删王国） R3 官员─── 可编辑报名名单、查看国库 R2 精英─── 可报名活动、查看成员 R1 成员─── 仅可报名、查看信息

多王国切换

一个账号可管理无限个王国。接口示例：

GET /api/kingdoms/mine // → [{ id:1, name:"阿卡特赫王国", code:"TEST", role_r:"R5" }]

王国去重规则

💰 国库 & 商城

资源商品类型

兑换码批量生成

POST /api/coupons/batch {"count": 100,"value": "standard_30d","prefix": "ROK2026" } // → { codes:["ROK2026-XXXX-XXXX", ...], download_url:"..." }

会员套餐

权限体系

系统基于 R1–R5 五级职位实现精细化权限控制。权限判断在后端接口层统一校验。

接口权限对照表

权限校验代码示例

// 中间件：仅 R4/R5 可访问 function requireR4(req, res, next) {const km = await getKingdomMember(req.user.id, req.params.kingdomId);if (!km || !['R4', 'R5'].includes(km.role_r)) {return res.status(403).json({code: 403,message: '仅 R4/R5 可执行此操作'});}req.kingdomMember = km;next(); }

API 接口文档

基础信息

接口列表

统一响应格式

{"code": 0,"message": "success","data": {} }

错误码

常见问题

Q: 为什么创建活动提示「仅 R4/R5 可创建」？

A: 活动创建权限已收窄到 R4 和 R5。如果你是 R3 想创建，需要联系 R5 先把你升到 R4（副盟主）职位。

Q: 批量导入成员时 game_id 格式有要求吗？

A: 推荐用万国觉醒内的标准格式 1303-001-001（国家号-服号-玩家序号），系统会自动识别。也支持纯数字 ID。

Q: 一个微信账号能管理多少个王国？

A: 无上限。旗舰版可同时管理无限个王国，标准版 3 个，免费版 1 个。

Q: 数据存在哪里？安全吗？

A: 数据存在腾讯云 CloudBase 云开发（NoSQL 数据库 + 对象存储），支持自动备份和异地容灾。

Q: 埃及之战自动组队算法可以自定义吗？

A: 目前内置三种策略：balanced（均衡战力，默认）、weighted（按权重优先）、random（随机分配）。后续会开放自定义权重规则。

联系我们

© 2026 ROK 内务管理 · 让联盟管理更简单