๐Ÿ“˜ The Rules

Every rule the Susu Manager enforces โ€” from contributions to payment windows to how winners are chosen. Read once, benefit for the entire cycle.

Jump to a section

๐Ÿ’ฐ Contributions & Cycle Length

How much each member pays and how long a cycle runs.

  1. Weekly contribution = GHS 200.00 = 1 slot.
  2. A member commits to N slots at registration (1, 2, 3, โ€ฆ up to 20).
  3. The member pays N ร— GHS 200.00 every week โ€” the same amount for the whole cycle.
  4. A cycle runs for as many weeks as the total number of committed slots across all members.
  5. Once committed, the weekly amount is fixed for the entire cycle.
  6. 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.

  1. The admin sets: cycle start date, payment day, window open hours, window close hour, and grace period.
  2. These settings apply to every week of the cycle.
  3. Window for week N: due date = start + (N โˆ’ 1) ร— 7 days.
  4. The window opens 48 hours before the due day.
  5. The window closes at 23:00 on the due day.
  6. 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

โœ… Eligibility to Win

Only these two conditions decide if a member can win this week's pot.

  1. Must have paid this week โ€” a successful contribution exists for the current week.
  2. 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.

  1. When a member wins a payout, the system starts tracking their post-payout payments.
  2. It records: weeks paid after, weeks missed, and average delay.
  3. At the end of the cycle, a fairness score (0โ€“100) is computed for every winner.
  4. The score is carried into the next cycle as their starting reputation.
  5. Members with score โ‰ฅ 60 are in good standing โ€” normal ranking.
  6. Members with score < 60 are demoted โ€” they rank below every good-standing member.
  7. Demoted members are never excluded โ€” they can still win if all good-standing members above them are ineligible.
  8. 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.

  1. Every week, the queue is recomputed from scratch.
  2. The criteria stay the same โ€” only the inputs change.
  3. Inputs that change weekly: payment time, eligibility, net slots, payouts received.
  4. The rotation naturally progresses โ€” winners get skipped once they've received all their slots.
  5. 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.
โ†‘