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.
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.
The wow loop (demo in 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.
- Celebrate — teal/amber spark burst, success toast, credit meter pulse with −N credits, and the new activity row rises in as fresh.
- 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.
- Watch expiring soon — amber pulse 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