社区榜单运维管控

一、插件简介

独立社区榜单页：活跃榜、主题榜、回帖榜、获赞榜，以及积分榜、金币榜。时间范围支持全部、近 7 天、近 30 天。积分/金币榜名称读取支付中心，未填写时默认「积分」「金币」。安装时向社区顶部导航写入「榜单」入口。

二、核心能力

三、依赖与安装

1. 将插件目录置于 plugins/ranklist/。
2. 在应用中心安装「社区榜单」。
3. 安装时向社区导航写入榜单入口，不创建独立数据表（读取社区主题、回帖、点赞与资产流水）。
4. 硬依赖：社区插件。
5. 软依赖：支付中心（积分/金币榜标题与指标名称）。卸载时会移除导航项。

四、应用中心基础配置

在应用中心 → 社区榜单 → 配置，字段来自 configSchema。本插件没有单独后台设置页：

五、后台重点配置

无独立后台菜单。改标题、副标题、人数、开关均在应用中心。导航显示名称与排序在社区导航管理中调整（插件安装会写入默认「榜单」指向 /ranklist）。

各榜统计口径：

• 活跃榜：活跃分 = 发帖数 × 2 + 回帖数 × 3（仅统计已发布、未删除内容）
• 主题榜：发帖数，同分看主题获赞合计
• 回帖榜：回帖数
• 获赞榜：主题获赞数合计
• 积分 / 金币榜（全部时间）：当前账户余额从高到低
• 积分 / 金币榜（近 7 / 30 天）：周期内资产流水正向入账合计（不含扣减）

六、前台用户流程

1. 从导航进入 /ranklist，默认活跃榜、全部时间。
2. 切换榜单类型与时间范围，查看领奖台与名次列表。
3. 点击用户进入个人主页；登录且上榜时可见自身名次。
4. 侧栏可看本周活跃前列。无数据时显示空状态引导发帖互动。

七、后台审核与运维

无审核队列、无日志表。运维即开关插件、改文案与每榜人数，并确认社区导航入口仍指向 /ranklist。

前台路由

八、特殊说明

• 实时计算：每次打开页面现查社区数据，无独立排行缓存表；人数过大时注意性能，建议每榜不超过 100。
• 作者合并：前台用户与管理员发帖按作者维度聚合，避免同一人拆成两条。
• 名称约定：积分榜、金币榜标题与指标随支付中心名称变化。
• 周期差异：主筛选的「近 7 天」是滚动 7×24 小时；侧栏「本周」是本周一 0 点起。
• 周期资产榜：只加正向流水，充值、奖励会计入，消费扣减不拉低名次。
• 静态资源：/static/ranklist/ranklist.css 与领奖台图片。

九、推荐上线清单

• 开启「启用榜单」，确认导航出现「榜单」且可打开
• 按站点文案修改标题、副标题
• 抽检六个榜单与三种时间范围，空站应显示空状态而非报错
• 用有发帖/回帖/资产的账号核对名次与个人主页跳转
• 到支付中心确认积分、金币名称后刷新积分榜/金币榜页签

十、常见问题

Q：打开榜单 404？ 插件未安装或「启用榜单」已关闭。

Q：导航没有「榜单」？ 重新安装或在社区导航中补一条指向 /ranklist 的项。卸载会删掉插件写入的导航。

Q：积分榜名称不是「积分」？ 以支付中心「积分名称 / 金币名称」为准。

Q：近 7 天积分榜和余额对不上？ 周期榜看的是这段时间正向入账合计，不是当前余额；全部时间才按余额排序。

Q：获赞榜没有回帖点赞？ 当前按主题获赞合计，不含回帖赞。

Q：活跃分怎么算？ 发帖 × 2 + 回帖 × 3；同分再比回帖数、发帖数。

Q：登录了为什么看不到我的名次？ 仅当本人出现在本榜本周期的展示人数内才会高亮；人数上限由「每榜人数」决定。

Q：关掉总开关后数据会丢吗？ 不会。插件不存榜单表，只是前台页不可访问。