Programmes, Consent & Awards
Institution hub · Portable trust
Turn milestones into credentials people can carry, then respect member consent when you read scores and network. Same PTI spine as mobile.
Audience: NGOs, trainers, clinics, co-ops, lenders, and hybrid institutions that issue portable proof and/or consume consented trust.
Self-serve programme templates include livelihoods / trades and youth development alongside Changemaker, workshop, mentorship, and general tracks. Members can Present Trust CV seals for hire, training, club, or funder from mobile Trussport.
This guide covers three connected surfaces in the institution hub:
| Surface | Path | What it feels like |
|---|---|---|
| Programme board | /institution/<slug>/programmes/ | Cohorts, enrollments, PTI + score chips, Award floor |
| Consent desk | /institution/<slug>/consent-desk/ | List-first access grants, expiring-soon pulse, selective share |
| Award floor | #tt-trust-award-panel on Programmes or Trust queues | Issue to Trust CV / attest milestones with credit meter + celebration |
Related: Institutions on TumiTrust, For partners, Trust platform API.
Quick walkthrough (under five minutes)
- Open Programmes: hero, metrics, and education cards explain credits, PTI, and consent at a glance.
- Scan participants: each row shows avatar, PTI id: headline Ubuntu score: and milestone progress.
- Issue a credential. Award floor credit meter shows balance and cost (default 2 credits to issue, 1 to attest).
- Confirm: review participant, credential, cohort, and credit charge.
- Confirm success: success toast, credit meter updates with −N credits: and the new activity row appears.
- Open Consent desk: list view by default (paginated); switch to grid if you prefer cards. Score chips appear only when the member granted Score access.
- Review expiring soon: highlight on the metric and rows ending within 14 days.
Programme board ──► Award floor (credits) ──► Trust CV + mobile progress
│ ▲
└── Consent desk (member-owned access) ────────┘
Programme board
What you see
- Programmes as outcome tracks (youth, livelihoods, health, apprenticeships, savings groups, any track you define)
- Participants rail with portable identity (PTI) and score, not username-only rows
- Award floor for issue + attest without waiting for a member request
- Cohort CSV for funder / M&E sharing
Education cards
Hover the three cards under the metrics:
| Card | Why it matters |
|---|---|
| Credits power awards | Same institution trust-credit pool as Trust Checks |
| Portable identity | PTI + score match what members see on mobile |
| Respect consent | Awards write to Trust CV; score peeks stay gated |
Empty states that move you forward
If there are no programmes or enrollments yet, the empty state offers Open Award floor and Take the tour: not a dead end.
Permissions
Team roles need Award credentials to issue or attest. Viewers can still see programme progress. Owners/admins grant the permission from Team management.
Award floor (credentials & milestones)
Issue credential
- Search a participant (typeahead shows avatar, PTI, and score)
- Pick credential type, optional cohort + milestone
- Review & issue, confirm dialog shows credit cost
- On success: toast + sparks + meter debit flash + fresh activity highlight
The badge lands on the member Trust CV / Trussport seals and can advance programme progress when a cohort is selected.
Attest milestone
Partner hubs push attestations into Pulse; all hubs can record programme milestone completion. Cost defaults to 1 trust credit.
Credits
| Action | Default cost | Ledger action |
|---|---|---|
| Issue portable credential | 2 | portable_credential_issue |
| Attest programme milestone | 1 | portable_milestone_attest |
- Balance and costs show on the Award floor meter
- Insufficient balance returns a 402 paywall with headline, shortfall, and Buy trust credits
- Topbar credits pill updates after a successful award
- Disable gating with
PORTABLE_TRUST_CREDIT_GATING_ENABLED=falsefor sandbox demos
Consent desk
List first, grid optional
- Default layout is a paginated list (10 per page) for scan speed
- Toggle Grid when you want card browsing (12 per page)
- Search by name, username, email, or PTI fragment
What each row shows
- Avatar + name + username
- PTI chip when resolved (minted/backfilled via PTI infra on first touch)
- Headline score + band only when
can_access_scoreis granted - Scope pills: Score / Network / Behavior
- Granted / time left / access count
- Details modal + jump to Award credential
Expiring soon
- Metric pulses amber when any active consent ends within 14 days
- Matching rows get an amber edge and status active · soon
Selective share
Score and network access are not the same as badge proof. When you need a specific credential, ask the member to share selectively from mobile, then award from Programmes when your role allows.
Mobile pairing
| Hub action | Member experience |
|---|---|
| Issue credential | Celebration / badge on Trust CV & Trussport |
| Attest + cohort | Progress rail / programme milestone update |
| Member grants consent | Row appears on Consent desk with scopes + expiry |
Demo seed (Wirepick Demo Bank): make seed-programme-award after Wirepick bank seed. Jane + cast with PTI, ContextScore, consents, and programmes.
Feature tours
On Programmes, Consent desk, and Trust queues, use Take a tour (sidebar / topbar replay) for a guided spotlight through:
- Programme board + credit-metered awards
- Consent list, selective share, award jump
- Trust queues + Award floor
Tours finish with the same spark language as a successful award, deliberately shared chrome.
API quick links
| Action | Endpoint |
|---|---|
| Issue credential | POST /api/v1/ubuntu/badges/issue/ |
| Attest milestone | POST /api/v1/ubuntu/badges/milestone-attest/ |
| Award activity | GET /api/v1/ubuntu/badges/award-activity/ |
| Cohort outcomes CSV | GET /api/v1/ubuntu/badges/cohort-outcomes.csv |
| Programme catalog | GET /api/v1/ubuntu/programmes/catalog/ |
Success responses may include credits_charged and credits_available_after. Insufficient credits return 402 with headline, subhead, and billing hints.
Next steps
- Open
/institution/<slug>/programmes/and walk the Award floor once with credits available - Confirm Consent desk list view + an expiring-soon row after
make seed-programme-award - Replay the feature tour for your team onboarding
- For producer ingest + Pulse, continue with For partners