Jump to a section
๐ฐ Contributions & Cycle Length
How much each member pays and how long a cycle runs.
- Weekly contribution = GHS 200.00 = 1 slot.
- A member commits to N slots at registration (1, 2, 3, โฆ up to 20).
- The member pays N ร GHS 200.00 every week โ the same amount for the whole cycle.
- A cycle runs for as many weeks as the total number of committed slots across all members.
- Once committed, the weekly amount is fixed for the entire cycle.
- Every member keeps paying weekly until the cycle ends, even after receiving all payouts.
Example: 5 members each commit 1 slot โ total = 5 slots โ
5-week cycle. Every week the pot = GHS 1,000.00.
โฐ Payment Window
When payments are accepted โ set by the admin and enforced strictly.
- The admin sets: cycle start date, payment day, window open hours, window close hour, and grace period.
- These settings apply to every week of the cycle.
- Window for week N: due date =
start + (N โ 1) ร 7 days. - The window opens 48 hours before the due day.
- The window closes at 23:00 on the due day.
- Grace period: 6 hours after close.
| When a member paysโฆ | Result |
|---|---|
| Before the window opens | Rejected โ button disabled |
| Within the window | Accepted โ marked on time |
| Within the grace period | Accepted โ marked in grace |
| After grace ends | Accepted โ marked late (penalised in the ranking) |
Current window configuration:
Payment day = Monday ยท Opens 48h early ยท Closes at 23:00 ยท Grace = 6h
Payment day = Monday ยท Opens 48h early ยท Closes at 23:00 ยท Grace = 6h
โ Eligibility to Win
Only these two conditions decide if a member can win this week's pot.
- Must have paid this week โ a successful contribution exists for the current week.
- Must still have slots remaining:
slots_committed โ payouts_received > 0.
Note: Fairness, member type, and payment time affect ranking only โ not eligibility.
A member stays in the queue until they have received all their committed slots.
๐ Ranking Criteria (Strict Order)
Applied in this exact order. A lower criterion only matters when everything above is tied.
1
Fairness group
โ
Good standing (fairness โฅ 60) beats โ ๏ธ Demoted (fairness < 60)
2
Member type
โญ Old beats ๐ New โ no exceptions
3
Payment time (this week)
Earlier payment wins โ exact second precision
4
Net slots
More net slots wins = (slots paid this cycle) โ (slots received via payouts)
5
Fairness score
Higher fairness score breaks any remaining tie
Key rule: No matter how many slots a member has or how early they paid,
a demoted member can never outrank a good-standing member in the queue.
Same for New vs Old.
๐ฅ Member Types
Every member is either Old or New, and it affects where they rank.
| Type | Who they are | How they rank |
|---|---|---|
| โญ Old | Members carried over from a previous cycle, or manually promoted | Ranked normally |
| ๐ New | Members who joined mid-cycle | Ranked below every Old member |
Note: New members still pay weekly โ they just wait their turn.
When a new cycle starts, all members become Old.
โ๏ธ Fairness System
Rewards reliable post-payout payment and demotes those who default.
- When a member wins a payout, the system starts tracking their post-payout payments.
- It records: weeks paid after, weeks missed, and average delay.
- At the end of the cycle, a fairness score (0โ100) is computed for every winner.
- The score is carried into the next cycle as their starting reputation.
- Members with score โฅ 60 are in good standing โ normal ranking.
- Members with score < 60 are demoted โ they rank below every good-standing member.
- Demoted members are never excluded โ they can still win if all good-standing members above them are ineligible.
- Consistent on-time payment in the new cycle restores their score for the next cycle.
fairness = 100
โ (weeks_missed ร 20)
โ (avg_delay_hours รท 10)
+ (weeks_paid_after_payout ร 2)
clamped to [0, 100]
Why this matters: If a member takes the pot but doesn't keep paying,
their fairness drops. When the next cycle begins, they will be ranked below
everyone who paid reliably โ even if they have more slots or pay earlier.
๐ Weekly Queue Behaviour
The queue re-ranks automatically every week.
- Every week, the queue is recomputed from scratch.
- The criteria stay the same โ only the inputs change.
- Inputs that change weekly: payment time, eligibility, net slots, payouts received.
- The rotation naturally progresses โ winners get skipped once they've received all their slots.
- When every member has received every committed slot, the cycle auto-completes.
๐ Worked Example
A 4-member, 5-slot cycle over 5 weeks.
Group: Ama (1 slot), Kofi (2 slots), Yaw (1 slot), Esi (1 slot).
Total = 5 slots โ 5-week cycle.
| Week | Winner | Pot | Why |
|---|---|---|---|
| Week 1 | Ama | GHS 1,000.00 | Old + earliest payment |
| Week 2 | Kofi | GHS 1,000.00 | Old + earliest โ Ama excluded (0 slots left) |
| Week 3 | Kofi | GHS 1,000.00 | Kofi still had 1 slot remaining โ wins again |
| Week 4 | Yaw | GHS 1,000.00 | Only eligible member with slots left |
| Week 5 | Esi | GHS 1,000.00 | Last remaining member |
After week 5: everyone has received the number of slots they committed to.
The cycle completes and fairness scores are computed for the next cycle.