RCL Hub 2.0 — Wireframes v0.3 · Othab Solutions × Updefine

Identity & Access · 01

Login

Single-column auth surface matching the built Angular component: 28rem max-width card region, clay primary action, green link accents, 44px touch targets. Supabase Auth session handled by the client.

Spec §6 Identity · Epic 1 · matches auth.scss in repo

09:41RCL Hub · PWA

1

R

Welcome back

Sign in to your RCL Hub account

Email

thandi.m@school.za

2

Password

••••••••••

Forgot password?

3

Sign in

New to RCL Hub? Create an account

4

EnglishisiZuluSepedi

mobile · 360 × 740 · learner default

1

Brand block. Display serif for the greeting only; everything else stays in the sans. Quiet, credible, youth-appropriate.

2

Field states. Inputs follow the built component: 1px border, 10px radius, danger border + inline role="alert" error below on invalid, aria-invalid wired.

3

Primary action. Clay full-width button — the single warm accent on the screen. Disabled + aria-busy while submitting.

4

Language switch before auth. en / zu / nso selectable pre-login via ngx-translate; choice persists into the session.

Identity & Access · 02

Register — 6-step wizard

Mirrors the shipped component one-to-one: one underlying FormGroup, per-step validation, native progress element, focus moved to the step heading on navigation. Steps: About you → A few details → Your school → How we reach you → Guardian details → Create a password.

Spec §6 Identity · Epic 1 · matches register.component.html in repo

09:41RCL Hub · PWA

Create your account

1

Step 3 of 6

Your school

Province

Gauteng

2

District

Johannesburg North

School

Select your school

Please choose your school to continue.

3

My school is not listed

4

Back

09:41RCL Hub · PWA

Create your account

Step 5 of 6

Guardian details

Because you're under 18, a parent or guardian must give consent for you to use RCL Hub.

5

Guardian full name

N. Mokoena

Relationship

Parent

Guardian email

n.mokoena@gmail.com

Guardian phone

072 ___ ____

✓My guardian consents to me creating this account and agrees to the privacy terms.

6

Back

1

Wizard chrome. Native <progress> + "Step n of 6" with aria-live="polite". Step title takes focus on next/back so screen readers announce the new step.

2

Cascading selects. District appears only after province; school only after district — mirrors the conditional template blocks in the built form.

3

School not listed. Checkbox swaps the select for a free-text school name; cross-field validators (schoolRequired / schoolNameRequired) enforce one or the other.

4

Nav contract. Back never destroys data — one FormGroup persists across steps. Next runs per-step validation only (STEP_CONTROLS array).

5

Guardian step. Required for learner accounts; collects consent identity for POPIA-compliant processing of a minor's data.

6

Final step. Step 6 (password + confirm, passwordMismatch validator) ends in submit → success state with "Sign in" link.

Learner Home · 03

Learner dashboard

The personalised starting point: quote of the day, today's governance work, learning progress and points — every pillar of the platform surfaced once, nothing duplicated. Role-gated: learners see participation; RCL members additionally see their committee duties.

Spec §8 — Learner home · KPI: human-centred & participatory

09:41RCL Hub · PWA

1

"It always seems impossible until it is done."

NELSON MANDELA · QUOTE OF THE DAY

2

1,240

Points

3 / 8

Lessons mastered

3

Continue learning

Female Leadership

Level 2 · Application — awaiting your submission

Resume

4

Today

RCL general meeting

14:30 · School hall · RSVP confirmed

Meeting

Poster for civvies day

Task · due tomorrow

Due soon

Vote: water station proposal

Voting closes 17:00 today

Vote

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · learner role

1

Quote of the day. Pulled from the moderated quote gallery (engagement schema). Deep-green card is the one saturated block on the screen.

2

Gamification at a glance. Points balance + mastery count from PointsTransaction and UserLessonProgress. Tapping opens Badges & achievements.

3

Continue learning. Single resume card targeting the learner's furthest in-progress lesson level — the main drop-off recovery surface.

4

Today feed. Meetings, tasks and open votes merged into one chronological list. Each row deep-links into its module. Bottom tabs map to the five UI module groups.

Governance · 04

Proposal list

Card-based feed of proposals for the learner's governance unit, filterable by status. Matches the built GovernanceService ViewState pattern — loading, empty, error and content states all designed.

Spec §8 — Governance · Epic 2 · built: proposal-list component

09:41RCL Hub · PWA

1

Open · 3ClosedMine

2

Closes today 17:00

Water station at sports field

Install a filtered water point near the netball courts.

62 of 91 voted

Closes Mon 16 Jun

Recycling bins per classroom

Partner with EnviroClub to place sorting bins in every Grade 8–12 classroom.

28 voted

Draft · only visible to you

Library Saturday hours

Open the library 09:00–12:00 on Saturdays during exams.

Draft

3

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · learner + RCL member

1

Status filters. Open / Closed / Mine. Counts come from the same query, no extra round trips.

2

Proposal card. Deadline eyebrow, title, one-line summary, turnout meter. Turnout shown only while voting is open — results stay hidden until close to avoid bandwagon voting.

3

Role gating. The ＋ create action renders only for roles with proposal rights; RLS enforces the same rule server-side.

Governance · 05

Proposal detail & vote

Full proposal with a single, prominent ballot. One vote per learner enforced by unique constraint; the cast state replaces the ballot entirely so the learner always knows their vote landed.

Epic 2 · built: proposal-detail component · unique (proposal_id, user_id)

09:41RCL Hub · PWA

Proposed by RCL Sports Committee · 9 Jun

Water station at sports field

Install a filtered water point near the netball courts so learners don't miss practice walking to the tuck shop taps. Estimated cost R4,800 from the SGB maintenance line.

1

OpenCloses 17:00 todayQuorum 50%

2

Your vote

Support this proposal

Do not support

Abstain

Cast vote

You can vote once. Results show when voting closes.

3

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · ballot state (pre-vote)

1

Decision metadata. Status, deadline, quorum rule — the governance literacy is in the UI, not hidden in admin config.

2

Ballot. Three options, radio semantics, one clay action. After casting, this card becomes a confirmation ("You voted · 12 Jun 14:02") — vote choice is never re-displayed to keep ballots private on shared devices.

3

Traceability. Casting writes the vote plus an ActivityLog entry — feeds participation metrics in M&E without extra instrumentation.

Governance · 06

Submit proposal

Typed reactive form, deliberately short — title, category, motivation, optional budget. Drafts save locally so a learner on patchy data never loses a half-written proposal.

Epic 2 · built: submit-proposal component

09:41RCL Hub · PWA

Title

Library Saturday hours

Meetings & attendance

Upcoming meetings with RSVP, agenda preview and verified attendance — attendance is an M&E signal and a points event, so verification is explicit, not assumed.

Spec §13 — attendance verification · Epic 2

09:41RCL Hub · PWA

1

Today · 14:30 · School hall

RCL general meeting

Agenda: water station vote result · civvies day · term 3 plan

Going

Can't make it

Wed 18 Jun · 13:00 · Room 12

Sports committee

Committee members only · 2 agenda items

Committee

2

Past

RCL general meeting

29 May · Attendance verified by Ms Dlamini

✓ +20 pts

Exec planning

22 May · You were absent (apology recorded)

Apology

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · RCL member

1

RSVP. Going / can't make it writes an RSVP record. The teacher convener sees the count when preparing the venue.

2

Verified attendance. A teacher/coordinator confirms who was present after the meeting; only verified attendance pays points and counts in participation reporting — closing the gamification fraud loophole.

Governance · 08

Tasks

Lightweight task board scoped to the learner's memberships. Assignments come out of meetings and committees; completion is reviewable so task points stay credible.

Epic 2 · Task / TaskAssignment tables

09:41RCL Hub · PWA

Open · 2Done · 7Committee

1

Due tomorrow

Poster for civvies day

From: RCL general meeting · assigned by S. Khumalo

Mark done

Add note

Due Fri 20 Jun

Collect recycling quotes

From: Sports committee · shared with L. Pule

2

Awaiting review

Term 2 suggestion box summary

Submitted Tue · waiting for Ms Dlamini to confirm

Pending

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · RCL member

1

Task provenance. Every task names its source meeting/committee and assigner — accountability is legible to a 14-year-old.

2

Done ≠ verified. "Mark done" moves the task to a review state; the convener confirms before points land. Same verification grammar as attendance and submissions.

Learning · 09 · NEW MODULE

Learning hub

Entry point to Epic 3. Each lesson/theme card carries the three-level mastery rail — Knowledge → Application → Paying Forward → Badge — so the progression model is visible before a learner even opens a lesson. This rail is the signature element of the module and repeats on every learning screen.

Spec §7.2–7.3, §8 — Learning hub · Epic 3

09:41RCL Hub · PWA

1

Your mastery journey

3 of 8 themes mastered · 2 badges this term

3/8

2

In progress

Female Leadership

Level 2

L1

Knowledge

L2

Application

L3

Paying
forward

🏅

Badge

In progress

Governance Ethics

Level 1

L1

Knowledge

L2

Application

L3

Paying
forward

🏅

Badge

3

Mastered · 14 May

Public Speaking

🏅 Badge earned

L1

Knowledge

L2

Application

L3

Paying
forward

🏅

Badge

Conflict Resolution

Not started · 12 sections · ±40 min reading

Start

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · learner · UserLessonProgress states

1

Mastery summary. Headline ratio from uvwLessonMastery. "Mastered" means Level 3 approved — never just quiz completion.

2

The mastery rail. Four stops — L1 quiz, L2 application, L3 paying forward, badge. Solid = done, clay ring = current, dashed gold = badge pending. The same component renders in lesson detail, results, and the reviewer queue, so learners, teachers and officials all read progress in one visual language.

3

States covered. In progress, mastered, and not started in one list — sorted current-first to fight drop-off.

Learning · 10 · NEW MODULE

Lesson detail

Theme content split into short sections (cognitive accessibility), with the mastery rail pinned up top and the three assessment levels listed with their evidence type, review type and points weighting — exactly the spec's traceability table, rendered for a learner.

Spec §7.3 table — evidence / review / weighting per level

09:41RCL Hub · PWA

1

L1

Knowledge

L2

Application

L3

Paying
forward

🏅

Badge

2

Sections · 4 of 6 read

1 · Women who led before us

Read · 5 min · audio available

✓

5 · Leading in your school

6 min · audio available

Assessments

Level 1 · Quiz

10 questions from the pool · auto-marked · low points

Passed 8/10

Level 2 · Application

Written or PDF reflection · reviewed by a teacher · medium points

Submit

Level 3 · Paying forward

Evidence of a real initiative · verified · highest points + badge

Locked

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · L1 passed, L2 unlocked

1

Rail + text-to-speech. The 🔊 control reads the active section aloud — accessibility requirement, also serves low-literacy contexts. Captions/transcripts apply to any embedded media.

2

Short sections. 5–6 minute chunks, progress tracked per section, content cached for offline reading after first load (low-data principle).

3

Sequential unlock. Levels unlock strictly in order; each card states evidence type, review type and points weighting in plain words so the rules are never a surprise.

Learning · 11 · NEW MODULE

Level 1 — Knowledge quiz

Randomised questions drawn from the QuestionBank pool; the exact served set is persisted to UserAssessmentQuestion before the learner answers — traceability is written first, scored second.

Spec §7.3 L1 · randomised pool · auto-scored · served questions stored

09:41RCL Hub · PWA

1

Question 4 of 10

An RCL member is offered tuck-shop vouchers to vote a certain way on a proposal. What should they do?

2

Accept — it doesn't change the result

Decline and declare it to the RCL convener

Accept but vote how they planned to

Resign from the RCL immediately

3

Next question

Your answers save as you go — safe to lose signal.

mobile · full-screen assessment mode (no tab bar)

1

Familiar chrome. Same progress + count pattern as the registration wizard — one wizard grammar across the product.

2

Randomised pool. Each attempt serves a different subset/order; the served set is stored per learner per attempt for review and dispute handling.

3

Resilient by default. Per-question persistence: a dropped connection on question 7 resumes at question 7. Pass mark configurable per lesson; passing pays low-weight points and unlocks Level 2.

Learning · 12 · NEW MODULE

Level 2 — Application submission

Written or PDF reflection requiring human review. The file itself goes to cloud storage; the database stores the SubmissionAsset path and metadata only. Status is always visible after submission.

Spec §7.3 L2 · human review · SubmissionAsset · originality check optional

09:41RCL Hub · PWA

Female Leadership · medium points

Write about a woman leader in your community and one practice of hers you can use in your RCL role. 300–500 words, or upload a PDF.

1

Write here

Start typing your reflection…

— or —

2

Upload a PDFMax 5 MB · stays on your profile

Voice note, photo or other formats? Ask your teacher about alternative submissions.

3

Submit for review

Reviewed by your teacher · you'll get a notification

mobile · submission form

1

Write or upload. In-app text is the low-data default; PDF covers homework done elsewhere. Draft autosaves locally.

2

Alternative submissions. Disability-inclusion hook: voice note / photo / link routes can be enabled per learner as a reasonable accommodation (spec §9), surfaced here rather than buried in settings.

3

Review contract. Submission creates a pending UserAssessmentReview; learner sees Pending → Approved / Needs changes with reviewer feedback. Approval pays medium points and unlocks Level 3.

Learning · 13 · NEW MODULE

Level 3 — Paying forward

The leadership step: evidence of a real school or community initiative — audio, video, photos or links — verified by an authorised reviewer. This is what earns mastery and the badge, so the screen treats it with weight.

Spec §7.3 L3 · verified evidence · highest points · gateway to badge

09:41RCL Hub · PWA

What counts as evidence?

Show the lesson in action: an initiative you ran or helped run at school or in your community. A mentor circle, a talk, a clean-up, a campaign.

1

Describe your initiative

Started a Grade 8 girls' debate circle, 6 sessions this term…

2

Attach evidence

📷 Photos

2 added

🎙 Voice note

Record

▶ Video link

YouTube URL

🔗 Other link

Approved sites

3

Who can confirm this happened?

Ms Dlamini — Teacher liaison

Submit for verification

Verified evidence earns the highest points and your mastery badge.

mobile · evidence composer

1

Description first. The narrative is mandatory; media supports it. Keeps the bar reachable for learners without smartphone storage to spare.

2

Evidence types. Photos and voice notes upload to cloud storage (path stored in SubmissionAsset); video stays a moderated YouTube link per spec §10 — no native video hosting in Phase 1.

3

Named verifier. Learner nominates the authorised reviewer (teacher / coordinator / TO / official). Verification record stores who approved, when, and the outcome — the full traceability chain of spec §7.3.

Learning · 14 · NEW MODULE

Results & mastery

The payoff screen. Level 3 approved → lesson marked mastered → badge awarded → points and activity logs updated — the spec's progression sentence, rendered as a moment worth screenshotting (and showcasing at the 2026 Summit).

Spec §7.3 — badge = verified leadership mastery · KPI: Summit showcase

09:41RCL Hub · PWA

1

🏅

Lesson mastered

Female Leadership · verified 12 June 2026

L1

Knowledge

L2

Application

L3

Paying
forward

🏅

Badge

2

Points earned

Quiz +30 · Application +80 · Paying forward +150

+260

Verified by

Ms Dlamini · Teacher liaison · "Outstanding initiative, Thandi."

✓

3

Share as story

Next theme

mobile · mastery awarded state

1

Badge moment. Gold treatment is reserved exclusively for mastery — it appears nowhere else, so it stays meaningful.

2

Itemised points. Low / medium / high weighting shown per level — the incentive design teaches itself. Reviewer identity and comment close the trust loop.

3

Storytelling bridge. "Share as story" drafts a LearnerStory from this mastery (enters moderation) — feeding the media-relations KPI directly from the proudest moment in the journey.

Learning · 15 · NEW MODULE

Reviewer queue — teacher / coordinator

The human-review side of Levels 2 and 3. Desktop-first surface for teachers, coordinators and TOs: pending submissions, evidence preview, approve / request changes with a mandatory comment. Every decision writes a UserAssessmentReview record.

Spec §7.3 traceability · §13 "were activities verified?"

rclhub.org.za/review

📥 Review queue 7

✓ Reviewed

👥 My learners

📊 Class progress

1

Pending review · 7

Level 2 · 4Level 3 · 3

Learner	Lesson	Level	Type	Waiting
TMThandi M. · Gr 10	Female Leadership	L3	Photos + voice note	1 day	Open
SPSipho P. · Gr 11	Governance Ethics	L2	PDF · 420 words	2 days	Open
LNLerato N. · Gr 9	Public Speaking	L3	YouTube link	3 days ⚠	Open

2

Reviewing · Thandi M. · Female Leadership · Level 3

"Started a Grade 8 girls' debate circle, 6 sessions this term…" · 📷 2 photos · 🎙 1:40 voice note

Review comment (required)

Outstanding initiative, Thandi.

Approve — award masteryRequest changes3

desktop · teacher / coordinator / TO role

1

Queue hygiene. Sorted oldest-first, ageing flagged at 3 days — review latency is itself an M&E drop-off cause, so it's visible.

2

Inline evidence. Text, file previews and links open without leaving the queue. L3 approvals require the reviewer to hold an authorised role for that learner's governance unit (RBAC + RLS).

3

Decision = record. Approve/changes + comment writes reviewer id, timestamp and outcome; approval triggers points, badge, ActivityLog and the learner notification in one transaction.

Engagement · 16 · NEW MODULE

Badges & achievements

The learner's recognition shelf: mastery badges (earned only via Level 3), participation milestones, and the points ledger. Locked badges stay visible — aspiration is the point.

Epic 4 · Badge / UserBadge / PointsTransaction

09:41RCL Hub · PWA

1,240

Points

#4

In your school

1

Mastery badges

🗣

Public Speaking

14 May

🤝

Teamwork

28 Apr

♀

Female Leadership

At Level 2

2

Recent points

Meeting attendance verified

RCL general · 29 May

+20

Level 2 approved

Governance Ethics

+80

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · learner

1

Badge grid. Earned badges in gold; locked ones greyed with the current blocking level named — turning the shelf into a to-do list.

2

Points ledger. Every transaction names its verified source event. Nothing here is self-reported, so the leaderboard stays defensible to teachers and officials.

Engagement · 17 · NEW MODULE

Leaderboard

School, district, provincial and national tiers riding the GovernanceUnit hierarchy. Designed to motivate without humiliating: top performers celebrated, everyone else sees their own position privately framed.

Epic 4 · uvwLeaderboard · KPI: Summit national rankings

09:41RCL Hub · PWA

1

My schoolDistrictProvinceNational

1SK

S. Khumalo · Gr 12

4 masteries · 96% attendance

2,310

2LP

L. Pule · Gr 11

3 masteries

1,895

3BN

B. Nkosi · Gr 10

3 masteries

1,610

2

4TM

You

370 points to #3 — one Level 3 away

1,240

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · school tier

1

Hierarchy tabs. Same component, four scopes — school → national resolves through ParentGovernanceUnitID, no separate queries per tier to design.

2

"You" row. Pinned with a concrete next step ("one Level 3 away") instead of raw rank shame. Below top 10, only the learner's own neighbourhood of ranks is shown.

Engagement · 18 · NEW MODULE

Quote gallery

Curated, moderated quote cards — the Ubuntu storytelling layer. Cards are designed share-ready for communications use (Summit, social), which is the media-relations KPI in product form.

KPI: media relations & branding · quote gallery · featured content

09:41RCL Hub · PWA

1

"Umuntu ngumuntu ngabantu — I am because we are."

UBUNTU PROVERB · FEATURED THIS WEEK

"Leading my RCL taught me that listening is half the job."

LERATO N. · GR 9 · EASTERN CAPE

2

"Education is the most powerful weapon which you can use to change the world."

NELSON MANDELA

⇪ Share card

Suggest a quote

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · gallery feed

1

Two voices. Featured quotes (deep green card) and learner quotes (light card, attributed by first name + province only — minor-safe attribution).

2

Suggest → moderate. Learner suggestions enter the moderation queue (screen 25); nothing publishes unreviewed. Share renders the card as an image for WhatsApp-class sharing.

Engagement · 19 · NEW MODULE

Learner stories & blog

Approved learner stories, achievements and video links in a low-bandwidth feed. Stories can be born straight from a mastery moment (screen 14) and curated nationally for the Summit.

LearnerStory · moderated media links · KPI: storytelling & visibility

09:41RCL Hub · PWA

1

★ Featured · Limpopo

The debate circle that found 12 new voices

How Thandi's Grade 8 girls' debate circle grew from a Level 3 project into a weekly fixture…

Female Leadership3 min read

2

▶ Video · YouTube

Cleaning the Jukskei: RCL eco week

Captions available · transcript attached

▶

Gauteng · 6 Jun

From suggestion box to water station

A proposal, a vote, and three weeks of follow-through at Phomolong Secondary.

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · story feed

1

Story card. Text-first, image optional and lazy-loaded — readable on 2G. The lesson tag links the story back to the learning theme that produced it.

2

Video = link, not file. Moderated YouTube embeds with captions/transcripts required before approval (hearing accessibility, spec §9). The ✎ composer submits to moderation, never publishes directly.

Accessibility · 20 · NEW MODULE

Accessibility & language settings

Epic 6 as a first-class surface, not a footnote: language, text-to-speech, captions, text size, simplified navigation and data saver. Every control here changes behaviour platform-wide and persists to the profile.

Spec §9 · Epic 6 · en / zu / nso via ngx-translate

09:41RCL Hub · PWA

1

Language

EnglishisiZuluSepedi

2

Read aloud

Text-to-speech on lessons and stories

On

Captions & transcripts

Always show on video and audio

On

Larger text

Scales the whole app, reflows — no zooming

Off

3

Simplified mode

Fewer items per screen, plainer wording, bigger targets

Off

Data saver

No images on feeds, download lessons on Wi-Fi only

On

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · settings · persists to profile

1

Language. Switches runtime via ngx-translate — no reload, no per-locale builds. Same three options offered pre-login on screen 01.

2

Sensory supports. TTS and captions defaults; baseline WCAG 2.1 AA (contrast, focus, labels) is enforced in the codebase regardless of these toggles.

3

Cognitive + data. Simplified mode reduces density and vocabulary; data saver implements the low-bandwidth principle as a user choice, not just an engineering one.

Analytics & Reporting · 21

School analytics

The teacher/principal view of one school: participation, mastery, governance throughput and drop-off — each chart answering one of the M&E questions in spec §13.

Epic 5 · uvwParticipationSummary · reporting schema

rclhub.org.za/analytics/school

🏫 My school

👥 Learners

📘 Learning

🗳 Governance

⇩ Exports

Phomolong Secondary · Term 2

1

312

Active learners

71%

Weekly participation

94

Lessons mastered

86%

Voting turnout

2

Mastery funnel — where learners drop off

~~StartedL1 passedL2 submittedL2 approvedL3 verified~~

Bottleneck: Level 2 review latency

Median 4.2 days from submission to review · 11 items older than a week

Action

desktop · teacher / principal role

1

Four vitals. Activity, participation, learning and governance — one number each. Everything else is a drill-down, not a wall of charts.

2

Drop-off funnel. The five-stage mastery funnel makes "where are learners dropping off?" answerable at a glance — the clay bar marks the worst conversion, paired with a named, actionable bottleneck below.

Analytics & Reporting · 22

Provincial dashboard

District-level comparison within a province for DBE provincial officials — adoption, engagement and mastery rolled up through the GovernanceUnit hierarchy.

Epic 5 · GovernanceUnit recursion · DBE official role

rclhub.org.za/analytics/province/gp

🗺 Gauteng

🏫 Districts

📘 Learning

⇩ Exports

Gauteng · 15 districts · 2,067 schools onboarded

1

68%

Schools active

41,208

Active learners

6,114

Masteries this term

2

District	Schools active	Participation	Masteries	Trend
Johannesburg North	184 / 201	76%	1,043	▲
Tshwane South	149 / 178	71%	887	▲
Sedibeng East	61 / 122	44%	203	▼

desktop · provincial DBE official

1

Adoption first. Provincial officials care about coverage before depth — schools active leads the row.

2

District table. Sortable, with trend chips; a flagged district (red) drills into its school list to find non-adopting schools by EMIS code.

Analytics & Reporting · 23

National dashboard & M&E exports

The Summit screen: national reach, provincial rankings, showcase-ready achievement highlights, and the export library UNICEF/DBE M&E teams pull their evidence from.

KPI: National Learner Leadership Summit 2026 · M&E exports

rclhub.org.za/analytics/national

🇿🇦 National

🗺 Provinces

★ Showcase

⇩ M&E exports

1

14,612

Schools onboarded

214k

Active learners

38,902

Lessons mastered

9,150

Initiatives verified

Provincial participation ranking

GPWC~~KZN~~ECLPMPFSNWNC

2

M&E export library

Participation summary · Lesson mastery · Verified initiatives · Attendance · CSV / XLSX, term or custom range

Export

desktop · national / UNICEF stakeholder

1

Verified initiatives as a headline national number — Level 3 evidence is the platform's most defensible impact stat, so it sits beside reach.

2

Exports, not screenshots. Named datasets from the reporting views, scoped to the requester's role; every export is itself logged (auditability principle).

Administration · 24

Users & permissions

Admin management of accounts, roles and memberships across the governance hierarchy. UI is API/RLS-mediated — admins never touch the database directly (spec §11).

Spec §11 RBAC · UserAccount / Membership / Position

rclhub.org.za/admin/users

👥 Users

🛡 Roles

🏫 Schools

🧹 Moderation

⚙ Configuration

Search name, email or EMIS code…

Invite user

1

User	Type	Governance unit	Position	Status
TMThandi Mokoena	Learner	Phomolong Sec.	RCL Secretary	Active	Edit
PDMs P. Dlamini	Teacher	Phomolong Sec.	Teacher liaison	Active	Edit
KMK. Mahlangu	Official	JHB North district	District coordinator	Invited	Resend

2

Membership history — Thandi Mokoena

2026 · RCL Secretary, Phomolong Sec. · 2025 · Class rep, Gr 9B — role history preserved for progression tracking, never overwritten.

desktop · school / district admin

1

Scoped admin. A school admin sees their school; district sees their schools — same screen, RLS narrows the data. Bulk invite by CSV for onboarding waves of schools.

2

Membership as history. Positions are time-bound Membership rows, not a mutable role field — leadership progression becomes reportable (a Summit storyline).

Administration · 25

Content moderation & configuration

Every public-facing artifact — stories, quotes, video links — passes through this queue before learners or the public see it. Configuration covers points rules, badge definitions and quiz pass marks.

Spec §8 Administration · moderated submissions · PointsRule

rclhub.org.za/admin/moderation

👥 Users

🛡 Roles

🏫 Schools

🧹 Moderation 5

⚙ Configuration

1

Awaiting moderation · 5

Stories · 2Quotes · 2Video links · 1

Item	Type	Submitted by	School
The debate circle that found 12 new voices	Story	Thandi M.	Phomolong Sec.	Review
"Listening is half the job."	Quote	Lerato N.	Mthatha High	Review
youtube.com/watch?v=… · eco week	Video link	Sipho P.	Phomolong Sec.	Review

2

Configuration snapshot

Points — L1: 30 · L2: 80 · L3: 150 · verified attendance: 20 | Quiz pass mark: 70% | Badges: 8 defined | Changes versioned + logged.

desktop · national content admin

1

Safeguarding gate. Minor-generated content never auto-publishes. Reviewers check identity exposure (full names, faces, locations) before approving; rejections return with a reason, never silently.

2

Rules as config. Points weightings, pass marks and badge definitions are admin-editable data (PointsRule), not code — and every change is logged to EntityChangeLog so historical points stay explainable.

Notifications · 26

Alerts & notifications

The in-app inbox behind the bell on every screen: reminders, activity alerts and engagement nudges grouped by recency, with per-category preferences. Phase 1 is in-app only — the same notification records are the feed a future push channel will consume, so nothing here gets rebuilt for native (spec §1.2 future-ready).

Spec §6 — Notifications: in-app reminders, activity alerts, future push, engagement nudges

09:41RCL Hub · PWA

1

All · 6GovernanceLearningRecognition

Today

2

Recognition

Level 3 verified — badge earned 🏅

Ms Dlamini approved your Female Leadership evidence · tap to see your result

Governance

Voting closes in 2 hours

Water station at sports field · you haven't voted yet

Governance

Task due tomorrow

Poster for civvies day · from RCL general meeting

3

Earlier this week

Learning

Your Level 2 was reviewed

Governance Ethics · approved · +80 points

Nudge

Pick up where you left off?

Conflict Resolution has been waiting 5 days — section 1 is a 5-min read

Meetings

RSVP reminder

RCL general meeting today 14:30 · you said you're going

⌂Home 🗳Govern 📘Learn 🏅Engage ☰More

mobile · in-app inbox · unread state

09:41RCL Hub · PWA

4

Notify me about

Voting deadlines

Open proposals closing within 24 hours

On

Tasks & meetings

Due dates, RSVPs and agenda changes

On

Review outcomes

Level 2 and 3 decisions on your submissions

On

Points & badges

Recognition and leaderboard movement

On

5

Nudges

Gentle reminders for unfinished lessons

Off

Notifications appear in the app only. Push notifications to your phone are planned for a future release.

mobile · per-category preferences

1

Category filters. Governance, Learning and Recognition mirror the notification source modules — same vocabulary as the tab bar, nothing new to learn.

2

Actionable rows. Every notification deep-links to its subject (result screen, ballot, task). Unread = clay dot; opening the target marks it read. Badge count on the bell is capped at 9+.

3

Nudges are polite. Engagement nudges (drop-off recovery, spec §6) are rate-limited to one per week per lesson and individually dismissible — motivation, not nagging a teenager.

4

Preferences per category persist to a NotificationPreference record; review outcomes default on because they gate progression. The settings double as the consent surface when push arrives later.

5

Phase honesty. The footnote states plainly that Phase 1 is in-app only — keeps the stakeholder demo from over-promising push.