【框架设计】行会工资：贡献结算与发放审计

实战应用：用在哪里

行会按周给核心成员发工资，资金来自行会基金，金额按上周贡献排名分档，打城主力与后勤管理都拿得心安理得。发放是资金出口，必须走审计：谁批的、发了多少、给谁，三问都有据可查，行会资金纠纷才能有据可解。

贡献结算

function GuildPay.rank(contribs)
    local list = {}
    for pid, pt in pairs(contribs) do
        if pt >= 200 then
            list[#list + 1] = { id = pid, point = pt }
        end
    end
    table.sort(list, function(a, b) return a.point > b.point end)
    return list
end

周贡献 200 起才有工资资格，防止挂名领钱，贡献来源覆盖任务、捐献与活动出勤三块。排序后按名次分三档：前十拿高档，前三十中档，其余低档，档位金额由帮主在后台配置，系统只提供框架。

工资发放

function GuildPay.grant(guildId, list)
    local fund = guildFunds[guildId]
    local total = 0
    for i, rec in ipairs(list) do
        local pay = i <= 10 and 500000 or i <= 30 and 200000 or 80000
        pay = math.min(pay, fund.balance - total)
        if pay <= 0 then break end
        total = total + pay
        QF_MailGold(rec.id, pay, "行会工资")
        payAudit[#payAudit + 1] = { guild = guildId, to = rec.id, gold = pay, at = os.time() }
    end
    fund.balance = fund.balance - total
    QF_LogGuildPay(guildId, total, #list)
end

基金余额不足按名次从高到低发到发完为止，欠发透明可查，下周基金进账优先补发。每笔发放写入审计表，帮主后台可导出，审计记录保留一个赛季。发放时间固定在周一零点，到账推送用 SL 金币到账特效，明细页用 GUI:TableView 展示四周对比，成员对贡献与回报的对应关系一目了然。

验证与监控

发放总额与基金扣减每日核对，审计表缺失任何一笔即触发完整性告警。

踩坑记录

贡献来源的统计口径早期只算任务与捐献，活动出勤的贡献被漏算，后勤型成员连续几周零工资后集体找上门，口径补齐时专门发了补偿。发放失败的邮件重试曾经无限循环，一个已删号成员的邮件反复失败，重试上限三次后转人工队列。工资报表的四周对比视图是帮主要求加的，他们用它来定激励政策，系统提供数据、会长提供治理，分工清楚的工具才能长用。工资体系的上线说明做了一期帮主专场直播，答疑收集的四十七个问题里一半关于贡献口径，口径文档随后按高频问题重写。发放日的基金余额曲线是个有趣的观察，周日深夜的捐献高峰与发放前的补缴行为高度相关，激励的预期改变了行为。审计接口对上级平台开放了只读查询，母公司合规审查时直接拉数据，审计的价值在于让每一次发钱都经得起回看。工资体系的上线说明做了一期帮主专场直播，答疑收集的四十七个问题里一半关于贡献口径，口径文档随后按高频问题重写。发放日的基金余额曲线是个有趣的观察，周日深夜的捐献高峰与发放前的补缴行为高度相关，激励的预期改变了行为。审计接口对上级平台开放了只读查询，母公司合规审查时直接拉数据，审计的价值在于让每一次发钱都经得起回看。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。