EsusuOnline — Trust Tier Config Guide

What is Trust Tier Config?

Trust Tier Config is the admin matrix that maps user trust scores into operational limits. It defines how a user moves from Tin → Copper → Bronze → Silver → Gold → Platinum, and controls what each tier is allowed to do inside the platform.

Trust Tier Ladder

The platform currently uses six trust tiers

Each tier is tied to a score range and a star count. Higher tiers unlock broader slot governance, larger limits, and more room for active participation.

🪙

Tin

0 - 100 points

★

🔶

Copper

101 - 300 points

★★

🥉

Bronze

301 - 600 points

★★★

🥈

Silver

601 - 800 points

★★★★

🥇

Gold

801 - 1000 points

★★★★★

💎

Platinum

1001+ points

★★★★★★

ℹ️ These ranges come from the current frontend trust model in the rating logic, where each tier has a lower bound, upper bound, and star count.

Open the Tier Matrix in Admin

Navigate to the Configurable Rating Tier Matrix

Inside the admin configuration area, open the Tier Matrix tab. This screen is the main place where trust-tier policy is edited.

esusuonline.org/admin

Configurable Rating Tier Matrix

Tier-based governance matrix mapping trust scores to creator caps, active exposure limits, and slot boundaries.

Tier Matrix Validation Active 6 Tiers Configured

Tier	Label	Lower Limit	Upper Limit	Max Active Created Slots	Max Active Exposure	Max Amount (₦)	Max Amount ($)	Min Participants	Max Participants
tier_0	Tin	0	100	1	1	50,000	50	2	6
tier_1	Copper	101	300	2	2	100,000	100	2	8
tier_2	Bronze	301	600	3	3	250,000	250	2	10
tier_3	Silver	601	800	4	4	500,000	500	2	12
tier_4	Gold	801	1000	5	5	1,000,000	1,000	2	15
tier_5	Platinum	1001	Infinity	6	6	2,000,000	2,000	2	20

Range Check

No gaps or overlaps

Tin starts at 0 and each next tier begins where the last one ends + 1.

Capacity Rule

Higher tier, broader limits

Created-slot caps and exposure rise as users move toward Gold and Platinum.

Inline Validation

Errors appear under fields

Lower-limit, upper-limit, create-slot, and exposure issues are surfaced immediately.

What Each Config Field Means

Tier / Label

The internal tier key and its display label. This is what admins and users will recognize, for example Tin, Copper, Bronze, Silver, Gold, and Platinum.

Lower Limit / Upper Limit

The score interval that places a user into that tier. A user qualifies when their trust score falls within the configured range.

Max Active Created Slots

How many active slots a user in that tier is allowed to create at the same time.

Max Active Exposure

Total active slot exposure for that tier. This controls how many concurrent active slots a user can be involved in.

Max Slot Amount (NGN / USD)

The largest slot amount a user in that tier can create or manage in naira and dollars.

Min / Max Participants

The permitted participant boundaries for slots created under that tier's governance rules.

Validation Rules You Must Respect

The admin form actively validates bad tier ranges

The trust-tier editor checks for invalid ranges and impossible slot permissions before the configuration is accepted.

Valid Config

First tier starts at 0.
Each lower limit is less than its upper limit.
No overlap between adjacent tiers.
No gap between adjacent tiers unless intentionally designed and supported.
Each tier allows at least 1 active created slot.
Each tier allows at least 1 active slot exposure.

Invalid Config

Lower limit greater than or equal to upper limit.
Negative lower or upper limits.
Gap before the first tier starts.
Range overlap between Tin/Copper or any adjacent tiers.
Zero allowed created slots.
Zero allowed active exposure.

🚨 If you create overlapping or broken ranges, users can be assigned to the wrong tier or end up with undefined trust behavior.

⚠️ The admin UI surfaces range, overlap, gap, and start-gap errors directly under the affected fields.

How Users Move Up or Down Tiers

Trust score is driven by contribution behavior and ratings

The tier matrix is only half the system. Users move between Tin, Copper, Bronze, Silver, Gold, and Platinum because the platform adds or subtracts trust points from real events.

Positive System Events

KYC Approved+50

Joined Slot+5

On-Time Contribution+5

Completed Slot Participant+20

Completed Slot Owner Bonus+30

Negative System Events

Late Contribution-10

Defaulted Contribution-50

Aborted Slot Owner-30

Negative Peer VotesVaries

ℹ️ That means trust-tier config should be designed together with your scoring policy. If score gain is fast but range jumps are too narrow, users may climb tiers too quickly.

Recommended Admin Workflow

Edit tiers from lowest to highest

Start with Tin, then continue upward through Copper, Bronze, Silver, Gold, and Platinum. This prevents gaps and makes it easier to reason about boundaries.

✅ Good pattern: define ranges first, then set slot caps, then set amount limits, then review participant limits.

Use progressively broader permissions at higher tiers

Higher tiers should usually allow larger slot amounts, broader exposure, and more active created slots. If Gold or Platinum is more restrictive than Bronze, the tier ladder stops making sense operationally.

Example Progression Pattern

Tier	Created Slots	Exposure	Max Participants
Tin	1	1	6
Copper	2	2	8
Bronze	3	3	10
Silver	4	4	12
Gold	5	5	15
Platinum	6+	6+	20

Trust Tier Config Tips

Keep the ladder monotonic. Higher tiers should not have weaker limits than lower tiers unless there is a very specific policy reason.
Start from operational risk. Decide what Tin users should be prevented from doing, then expand safely upward.
Watch for narrow bands. If Copper spans too few points, normal user activity may cause unstable tier hopping.
Review both score rules and tier ranges together. The matrix and the scoring engine are one system.
Validate after every edit. Range gaps and overlaps are easy to introduce when adjusting multiple tiers quickly.
Platinum should be exceptional. It should represent sustained trust, not routine usage.

→ Admin Panel → Ratings → Dashboard → Contributions Guide → Slot Guide → Full User Guide