开发说明 · 公会

公会功能规格

按入口、权限、页面、数据与异常说明公会模块。区分当前可操作的交互、原型展示约定，以及仍需确认的正式入会、创建和收益规则。

1.0.0 · 初始草稿成员网站与公会探索正式入会规则待确认

01 / 公会

G01 · 范围与状态边界

公会模块包含成员首页、探索目录、国家官方公会、TOP200 以及相关说明弹层。首页与探索目录使用五栏导航，公会保持选中；国家官方公会与 TOP200 使用独立返回，不显示五栏导航。

类别	本草稿的约束
已明确的页面交互	网站展示、收藏分类、排序、说明弹层、名称搜索、国家筛选、空结果、登录与返回。
原型展示约定	默认入口未登录展示公会目录；任意已登录账号展示成员首页。未加入的登录状态保留为设计预览，不作为当前登录后的默认分支。
真实业务边界	展示成员页面不创建成员关系，不替用户加入巴西或任一公会，不提交申请、不审核、不计算收益。正式成员状态与权限规则待确认。
资料状态	本页仍属 1.0.0 初始草稿。加入、创建、结算和实时服务尚未完成，不能以说明弹层代替实际成功结果。

职责划分

账号流程复用账号与首页规格；VIB 分析交互见 VIB 开发说明；L4 与团队奖励见邀请开发说明。本页不指定正式产品采用的客户端、认证或存储技术。

02 / 公会

G02 · 入口、权限与登录衔接

入口	未登录	已登录或已识别成员
底部公会入口	直接浏览公会目录，无需先登录。	当前统一显示成员首页；未加入状态的正式判断规则待确认。
目录、政策、搜索、国家筛选、TOP200	允许浏览与操作。	允许浏览，不因查看另一公会而修改所属关系。
已开放公会的申请加入	打开手机号登录弹层，保留来源与目标页面。	当前展示加入流程待设计说明；不能写为申请已提交、已通过或已加入。
创建公会	打开登录弹层。	展示创建规则待设计说明。L4 为邀请政策的草稿申请资格，资格校验及后续流程待设计。
审核中、筹备中的官方公会	直接显示对应状态说明，不触发申请。	同样只提示公会状态，不生成用户申请记录。
当前所在／已加入	仅在存在明确匹配的展示状态时出现，不据卡片推断账号身份。	官方卡片可“进入公会”；普通公会卡片“已加入”不可重复操作。

账号弹层默认手机号登录，支持切换注册，保留巴西 +55 区号；手机号为 11 位数字，登录与注册共用常规校验，不提供邮箱方式。关闭后保留来源页面并恢复入口焦点。登录成功进入原目标公会页面；当前不自动执行加入或创建，正式流程设计时需明确是否继续未完成的操作。

身份与展示状态分开理解

登录状态、真实公会成员身份、当前浏览的公会及网站账号关联状态是不同概念。不能因为页面展示成员首页、点击加入或看到了巴西介绍卡片，就改变真实成员身份。跨公会加入权限、退出和换会规则待确认。

03 / 公会

G03 · 成员首页与网站列表

功能	展示、操作与结果
顶部教学与横幅	标题为“公会”，保留视频入口。视频图标与横幅教学按钮打开同一介绍；可进入 VIB 游戏助手，关闭恢复来源。视频内容待提供；不把装饰圆点视为已完成的轮播能力。
网站卡片	展示网站标识、名称、域名、账号关联状态、收藏状态、在线人数、Live RTP、分析提示和主要操作。每个网站需要稳定的识别信息，名称和域名不能替代唯一身份。
收藏分类	默认全部网站；我的收藏展示当前支持的网站与个人收藏的交集。切换分类不改变收藏。取消收藏后立即从收藏列表移除；空列表提供“浏览全部网站”。
排序	推荐按提供的推荐顺序；在线人数、Live RTP 均降序；名称按名称升序。选择的排序应用于当前分类。推荐算法、同值次序、多语言名称比较和缺失指标处理待确认。
主要按钮	“打开网站,开始游戏”当前打开该网站说明，可继续进入 VIB 或返回公会。真实目标地址、打开方式、登录态传递和账号关联流程待设计。
指标与网站说明	Live RTP 信息入口说明指标含义；网站说明入口解释各公会支持范围不同。说明关闭后回到原位置并恢复触发入口焦点。指标来源、统计口径与实时性待确认。
推荐公会	卡片展示公会、国家和支持的网站；加入入口按账号权限处理。探索按钮进入完整目录。推荐依据和完整网站详情流程待确认。

收藏与其他状态的区别

收藏只改变个人偏好，不改变网站关联状态、成员关系或网站可用权限。当前原型在同一浏览器内按账号保留收藏；正式的跨设备同步范围待确认。演示存储方式只在维护附录说明。

04 / 公会

G04 · 探索目录与名称搜索

区域	要求
游客／未加入顶部	显示尚未加入公会及说明，保留“查看其他国家的官方公会”。公会目录可公开浏览。
从成员页进入的探索顶部	保留返回与创建入口，隐藏视觉标题“公会”，仍提供可识别的页面名称。展示巴西官方示范公会图片、官方标识、国家与介绍；不将展示内容写入成员关系。
公会政策	展示 20% 收益、增加支持网站与专属分析申请的说明，更多入口打开政策弹层。收益对象、基数与实际申请能力未定。
公会列表	展示头像、名称、国家、支持网站图标、其他网站数量与加入状态。当前仅有 7 个示例；网站“+N”无详情流程，不作为已完成的展开操作。
搜索	按公会名称进行包含匹配，忽略首尾空白与英文字母大小写。无匹配显示空结果与清除按钮；清除后恢复当前示例列表。
榜单与创建	查看 TOP200 进入独立榜单；顶部创建与底部立即创建使用同一权限与说明流程。

页面的榜外公会搜索说明属于产品目标。正式公会搜索的数据范围、请求时机、搜索上限、加载更多与失效结果处理待确认；当前不能把示例名单搜索验收为全量公会检索。

05 / 公会

G05 · 国家官方公会

功能或状态	展示与处理规则
基础信息	展示国家官方公会标题、选择说明，以及公会标识、官方身份、名称、国家或地区、介绍、开放状态与操作。
搜索与国家筛选	默认全部国家。关键词匹配公会名称、国家中文名称及已配置的英文名称；忽略首尾空白和英文大小写。结果需同时满足关键词与所选国家。
已开放	非当前公会显示申请加入，按 G02 检查登录。当前没有实际申请提交。
审核中	该官方公会的开放状态，点击给出状态提示。不能映射为当前用户的入会审核进度。
筹备中	给出筹备提示，不允许提交加入申请。
当前所在	根据明确的当前公会匹配信息标注，入口为进入公会。不能仅按国家或名称推定成员关系。
空结果	显示暂无匹配公会，“查看全部”同时清空关键词并恢复全部国家。可选择的国家未必已有公会卡片，空结果不等于加载失败。
国家选择与返回	支持选择、取消和关闭；键盘可以移动选项，关闭后恢复焦点。返回进入前的公会目录；当前返回后恢复默认查询条件。

名单与状态仍需服务定义

当前使用 11 张官方公会示例卡片，其中 VIB 为全球示例；其他国家名称不代表已经运营或开放。正式名单、官方认证来源、开放状态变更、可加入的国家限制与语言适配待确认。

06 / 公会

G06 · TOP200 与返回关系

独立 TOP200 页使用名称搜索和公会卡片，匹配与空结果规则同 G04。当前公会的“已加入”操作不可重复触发；其他公会按 G02 处理加入。列表不继承国家官方公会的国家筛选。

进入路径	返回结果
成员首页 → 探索更多公会	探索页返回成员首页；浏览其他公会不切换成员身份。
探索页 → 国家官方公会／TOP200	下级页返回探索页。
游客公会目录 → 国家官方公会／TOP200	下级页返回公会默认入口，按此时登录状态决定目录或成员首页。
直接进入国家官方公会／TOP200	提供可用的返回入口；无探索来源时返回公会默认入口。
说明弹层 → 关闭或取消	留在原页面并恢复触发入口焦点。跳转 VIB 后交由智能体模块承接。

榜单数据与浏览状态

当前 7 个示例只能验证布局、搜索与操作入口。真实前 200 名的排名指标、并列规则、更新周期、完整数据和分页方式待确认；返回或重新打开页面时保留搜索、排序和滚动位置的规则待设计，当前使用默认条件。

07 / 公会

G07 · 加入、创建与政策依赖

事项	当前结果与依赖	待确认的业务规则
加入公会	只有登录与待设计提示，没有申请单、受理结果或新成员关系。	直接加入或申请审核、一个账号可加入数量、已加入者申请另一公会、取消申请、审批结果与通知。
创建公会	上下两处入口一致。邀请政策草稿规定 L4 可申请，原型未实现资格拦截。	等级判定服务、资格不足提示、申请资料、唯一名称、审核、费用、创建完成及管理权限。
20% 公会收益	只展示政策说明；不生成返佣、余额或提现记录。	受益对象、计算基数、适用消费、与三级邀请奖励叠加关系、结算周期、币种、退款和退出后的处理。
网站扩展与专属建模	只提供政策介绍。	申请人资格、申请内容、处理状态、收费与交付标准、失败和取消流程。

正式流程确定前，各入口继续明确显示待设计，不出现“申请成功”“创建成功”等虚假确认。未来服务提交、重复提交防护与结果恢复均需在流程确认后补充规格。

08 / 公会

G08 · 数据含义与展示约束

数据	含义及约束
公会身份与用户关系	公会需有稳定标识，区分普通与官方身份。用户成员关系独立于当前浏览的公会和登录状态；申请状态不与官方公会开放状态混用。
国家或地区	用于展示与筛选，不等于用户国籍、所在地或自动入会依据；全球公会应与单一国家区分。
网站与关联状态	网站包含标识、名称、域名、图标及所属公会支持关系；关联状态描述用户与网站账号的关系，不表示公会成员身份。
在线人数与 Live RTP	在线人数表示示例在线规模，Live RTP 表示返还率指标；正式统计对象、时间窗口、精度、来源和更新时间待确认。不可把缺失数据显示成真实零值。
收藏、推荐与排名	收藏是个人偏好；推荐顺序与全球排名是不同数据；榜单标题不等于已有排名结果。
盈利播报与收益政策	播报与 20% 政策不是账户金额。真实播报的来源、展示授权、更新及隐藏方式待确认，不根据示例播报生成资产记录。

当前所有公会名单、网站、人数、RTP 与金额均为示例。正式产品需要哪些更新时间和数据状态标识，需随服务口径确认；不得让用户将示例数据误认为真实统计。

09 / 公会

G09 · 异常、空态与操作反馈

场景	已有交互或建议规则	状态
没有收藏	明确提示暂无收藏，提供浏览全部网站；不能显示无反馈的空白区域。	当前原型已有。
公会搜索或国家筛选无结果	显示空结果；普通列表清除关键词，官方列表“查看全部”同时清除两项条件。	当前原型已有。
收藏无法读取或保存	提示失败，仍可浏览网站；保存失败不能把未保存状态当成成功。	当前原型已有演示处理。
取消登录或关闭说明	保留来源页面，关闭后恢复入口焦点；不生成申请或成员关系。	当前原型已有。
数据正在加载或加载失败	建议区分正在加载、空名单与请求失败，提供重试并避免把旧数据作为最新结果。	正式服务待接入，规则待确认。
申请或创建失败、超时、重复操作	建议提供清晰状态，允许安全返回并防止重复提交；具体恢复方式随申请流程定义。	流程待设计，当前无真实提交。
公会关闭、网站失效或成员权限变更	建议说明原因并提供可去往的页面，避免仍展示可执行的失效操作。	正式状态及处理规则待确认。

10 / 公会

G10 · 验收结果与未决事项

以下结果覆盖当前已明确的页面和交互，不代表真实入会、创建、结算或统计服务已经完成。

范围	应达到的结果
入口与身份	游客可浏览目录；登录后按当前约定显示成员首页；探索中的巴西卡片和浏览行为不产生真实成员关系。
网站列表	分类、收藏、取消收藏和排序有明确反馈；空收藏可回到全部；账号关联状态与入会状态可区分。
探索与下级页面	探索页面顶部没有视觉“公会”文字，保留返回、创建和国家官方公会按钮；官方页与 TOP200 返回正确来源。
搜索与筛选	名称搜索可清除；官方页关键词与国家同时生效，无结果可恢复全部；TOP200 不受官方国家选择影响。
受限入口与状态	加入、创建复用登录弹层；官方审核中／筹备中只说明公会状态；当前所在可进入，已加入不可重复申请。
弹层与导航	说明可以关闭、取消和键盘退出，焦点回到入口；主要页面保留公会选中的五栏导航，下级列表使用返回。
业务边界	未设计的动作有明确提示，不伪造成功、真实收益、实际跳转或完整 TOP200 数据。

进入正式开发前需补齐

真实成员关系与权限、申请／换会／退出、创建与 L4 判定、20% 收益结算、网站关联与跳转、排名／统计／搜索数据服务、状态变更和失败恢复。上述事项未确认前，当前页面方案不构成相关业务已经批准或上线的证明。