# ODELPay HUB / OpenPayGB — User guides index

**Last updated:** 2026-10-31  
**Latest release:** [PLATFORM_UPDATE_2026-10-11](../platform/PLATFORM_UPDATE_2026-10-11.md) — workspace universe, Monetize + Workspaces home icons, Campus / Units dashboards for Primary · Secondary · Higher, one email connecting another workspace, dated class periods, academic-year fee ledgers, higher pay any amount.  
**Product:** Jurisdiction-aware **Software-as-a-Service (SaaS)** ecosystem for education payments — hosted institution workspaces, local rails (e.g. Uganda UGX MoMo), TON, OpenPayGB virtual card + **LiveStore / pay-links / bills**, Stars, On/Off, **Dex Hub**, **Play Hub**, **ODEI OS**, **AssessmentVerse OS**, and **ODEI School Agent**. See [/about](https://odelpay.vercel.app/about).  
**Last updated:** 2026-11-02 · Platform note: [PLATFORM_UPDATE_2026-11-02.md](../platform/PLATFORM_UPDATE_2026-11-02.md)

**HTML handbooks:** every guide in this folder also ships as printable `.html` (regenerate with `npm run docs:guides-html`). Category hub: [index.html](./index.html) · this index as HTML: [USER_GUIDE_INDEX.html](./USER_GUIDE_INDEX.html) · API e.g. `/api/docs/guides/USER_GUIDE_ADMIN_SCHOOLS.html`.

### Product roots (production)

| Product | Canonical | Alias |
|---------|-----------|-------|
| Public entry | `/` | — (unchanged) |
| ODEI OS | `/ODEI-OS` | `/odei-os` |
| ODELPay HUB | `/ODELPay` | `/odelpay` |
| AssessmentVerse OS | `/AssessmentVerseOS` | `/assessmentverseos` |
| ODEI School Agent | `/school-agent` | login `/school-agent/login` |

**Platform update pack:** [PLATFORM_UPDATE_2026-10-11](../platform/PLATFORM_UPDATE_2026-10-11.md) · [PLATFORM_UPDATE_2026-09](../platform/PLATFORM_UPDATE_2026-09.md) · [PLATFORM_VERIFY_2026-09-09](../platform/PLATFORM_VERIFY_2026-09-09.md) · [LOCAL_DEV_AND_CREDENTIALS](../platform/LOCAL_DEV_AND_CREDENTIALS.md)

Download from **Master Admin → Docs & downloads** (`/admin/master#project-download`) — organised catalogue:

| Category | Contents |
|----------|----------|
| **Whole project** | Full ZIP (data + demo logins + env + docs + source) |
| **Documentation & guides** | Project description, user guides pack, full `docs/` library |
| **Live platform data** | Tuition / orgs / programmes / payments / KB / notifications |
| **Access & credentials** | Master admins, demo Schools/Universities logins, environment |
| **Source code** | Repository archive |

Each category supports a one-click category ZIP plus individual part downloads.

---

## Choose your guide

| Role | Guide (Markdown · HTML) | Sign-in / entry URL |
|------|-------------------------|---------------------|
| **Platform master admin** (Master console only) | [USER_GUIDE_MASTER_ADMIN.md](./USER_GUIDE_MASTER_ADMIN.md) · [HTML](./USER_GUIDE_MASTER_ADMIN.html) · `/help/guide-master-admin` (requires master sign-in) | `/admin/login?master=1` → `/admin/master` |
| **School admin** (K–12 / primary–secondary) — **ODELPay fees** | [USER_GUIDE_ADMIN_SCHOOLS.md](./USER_GUIDE_ADMIN_SCHOOLS.md) · [HTML](./USER_GUIDE_ADMIN_SCHOOLS.html) · `/help/guide-admin-schools` | `/school/login` → `/admin/school-dashboard` · register `/admin/register?segment=schools` |
| **Higher institution admin** (university / tertiary) — **ODELPay fees** | [USER_GUIDE_ADMIN_HIGHER.md](./USER_GUIDE_ADMIN_HIGHER.md) · [HTML](./USER_GUIDE_ADMIN_HIGHER.html) · `/help/guide-admin-higher` | `/admin/login?segment=higher` → `/admin/campus-dashboard` · register `/admin/register?segment=higher` |
| **Pay Team University** (TEAM doors · ledger SSOT · per-audience desks) | [USER_GUIDE_PAY_TEAM_UNIVERSITY.md](./USER_GUIDE_PAY_TEAM_UNIVERSITY.md) · [HTML](./USER_GUIDE_PAY_TEAM_UNIVERSITY.html) · `/help/guide-pay-team-university` | https://payteamuniversity.vercel.app · `#team-login` · `/app` · Admin `/admin/login?segment=higher` on PTU |
| **AssessmentVerse schools admin** (marks / report cards) | [USER_GUIDE_ASSESSMENTVERSE_ADMIN_SCHOOLS.md](./USER_GUIDE_ASSESSMENTVERSE_ADMIN_SCHOOLS.md) · [HTML](./USER_GUIDE_ASSESSMENTVERSE_ADMIN_SCHOOLS.html) · `/help/guide-assessmentverse-admin-schools` | `/AssessmentVerseOS/admin/login?school=1` → stage hubs |
| **AssessmentVerse higher admin** (marksheets / transcripts) | [USER_GUIDE_ASSESSMENTVERSE_ADMIN_HIGHER.md](./USER_GUIDE_ASSESSMENTVERSE_ADMIN_HIGHER.md) · [HTML](./USER_GUIDE_ASSESSMENTVERSE_ADMIN_HIGHER.html) · `/help/guide-assessmentverse-admin-higher` | `/AssessmentVerseOS/admin/login?segment=higher` → `/AssessmentVerseOS/higher` |
| **Staff (schools)** | [USER_GUIDE_STAFF_SCHOOLS.md](./USER_GUIDE_STAFF_SCHOOLS.md) · [HTML](./USER_GUIDE_STAFF_SCHOOLS.html) · `/help/guide-staff-schools` | `/staff/login?segment=schools` |
| **Staff (higher institutions)** | [USER_GUIDE_STAFF_HIGHER.md](./USER_GUIDE_STAFF_HIGHER.md) · [HTML](./USER_GUIDE_STAFF_HIGHER.html) · `/help/guide-staff-higher` | `/staff/login?segment=higher` |
| **Workspace universe** | [PLATFORM_UPDATE_2026-10-11](../platform/PLATFORM_UPDATE_2026-10-11.md) | `/workspace` |
| **Teacher workspace** (Primary, Secondary, O Level, A Level, TW-… ID) | [USER_GUIDE_TEACHER_WORKSPACE.md](./USER_GUIDE_TEACHER_WORKSPACE.md) · [HTML](./USER_GUIDE_TEACHER_WORKSPACE.html) | `/workspace/teacher/primary` · `/secondary` · `/o-level` · `/a-level` |
| **Lecturer workspace** (undergraduate, postgraduate, both, LW-… ID) | [USER_GUIDE_LECTURER_WORKSPACE.md](./USER_GUIDE_LECTURER_WORKSPACE.md) · [HTML](./USER_GUIDE_LECTURER_WORKSPACE.html) | `/workspace/lecturer` · Freelancing · `/lecturer/t/<slug>` · OpenPayGB card |
| **Student / parent (schools)** | [USER_GUIDE_STUDENT_SCHOOLS.md](./USER_GUIDE_STUDENT_SCHOOLS.md) · [HTML](./USER_GUIDE_STUDENT_SCHOOLS.html) · `/help/guide-student-schools` | `/student/login?segment=schools` · pay `/pay` |
| **Student (higher institutions)** | [USER_GUIDE_STUDENT_HIGHER.md](./USER_GUIDE_STUDENT_HIGHER.md) · [HTML](./USER_GUIDE_STUDENT_HIGHER.html) · `/help/guide-student-higher` | `/student/login?segment=higher` · lobby `/OdelPayUniversities` |
| **Parent (fee dashboard + installments)** | [USER_GUIDE_PARENT.md](./USER_GUIDE_PARENT.md) · [HTML](./USER_GUIDE_PARENT.html) · `/help/guide-parent` | `/parent` |
| **Guest payer** (no account) | [USER_GUIDE_GUEST_PAYER.md](./USER_GUIDE_GUEST_PAYER.md) · [HTML](./USER_GUIDE_GUEST_PAYER.html) · `/help/guide-guest-payer` | `/pay` or `/pay/<orgSlug>` |
| **OpenPayGB consumer / merchant** | [USER_GUIDE_OPENPAYGB.md](./USER_GUIDE_OPENPAYGB.md) · [HTML](./USER_GUIDE_OPENPAYGB.html) · `/help/guide-openpaygb` | `/opgb` · `/opgb/livestore` · `/opgb/pay-links` · `/opgb/points` · `/opgb/token-desk` · `/opgb/bills` · `/card` · `/student/card` |
| **Telegram + OpenPayGB (bot, Mini App, points, token desk)** | [ODELPAY_TELEGRAM_AND_OPGB_GUIDE.md](./ODELPAY_TELEGRAM_AND_OPGB_GUIDE.md) · [HTML](./ODELPAY_TELEGRAM_AND_OPGB_GUIDE.html) · `/help/telegram-opgb-complete-guide` | @ODELHUBPayBot · `/tma` · `/os` |
| **Dex Hub user** (all users — inside + outside education ecosystem) | [USER_GUIDE_DEX.md](./USER_GUIDE_DEX.md) · [HTML](./USER_GUIDE_DEX.html) · `/help/guide-dex` | `/dex` |
| **Play Hub user** | [USER_GUIDE_PLAY.md](./USER_GUIDE_PLAY.md) · [HTML](./USER_GUIDE_PLAY.html) · `/help/guide-play` | `/play` |
| **AssessmentVerse OS** (lobby overview) | [USER_GUIDE_ASSESSMENTVERSE.md](./USER_GUIDE_ASSESSMENTVERSE.md) · [HTML](./USER_GUIDE_ASSESSMENTVERSE.html) · `/help/guide-assessmentverse` | `/AssessmentVerseOS` · login `/AssessmentVerseOS/login` — prefer tier admin guides above for dashboards |
| **ODEI School Agent** (pocket ledger · cash desk) | [USER_GUIDE_SCHOOL_AGENT.md](./USER_GUIDE_SCHOOL_AGENT.md) · [HTML](./USER_GUIDE_SCHOOL_AGENT.html) · `/help/guide-school-agent` | `/school-agent` · login `/school-agent/login` → desk / student / parent |
| **Partner / SIS integrator** | [USER_GUIDE_PARTNER_INTEGRATOR.md](./USER_GUIDE_PARTNER_INTEGRATOR.md) · [HTML](./USER_GUIDE_PARTNER_INTEGRATOR.html) · `/help/guide-partner-integrator` | `/developers/register` · `/opgb` |
| **AssessmentVerse hosting** (engine / Hub wiring) | [ASSESSMENTVERSE_HOSTING.md](./ASSESSMENTVERSE_HOSTING.md) · [HTML](./ASSESSMENTVERSE_HOSTING.html) | Engine `assessmentverse.vercel.app` · Hub `/AssessmentVerseOS` |
| **OpenPayGB no-code acceptance** | [OPENPAYGB_NO_CODE_INTEGRATION.md](./OPENPAYGB_NO_CODE_INTEGRATION.md) · [HTML](./OPENPAYGB_NO_CODE_INTEGRATION.html) | `/opgb/pay-links` · hosted checkout |
| **Local credentials** | [LOCAL_DEV_AND_CREDENTIALS](../platform/LOCAL_DEV_AND_CREDENTIALS.md) | Seed emails/passwords |
| **Sep 2026 update pack** | [PLATFORM_UPDATE_2026-09](../platform/PLATFORM_UPDATE_2026-09.md) | Commands, logins, OPGB recipes |

### Deprecated generic guides (pointers only)

These files remain for download compatibility and old links. Prefer the tier-specific guides above:

| Deprecated file | Redirects readers to |
|-----------------|----------------------|
| [USER_GUIDE_STUDENT.md](./USER_GUIDE_STUDENT.md) | [USER_GUIDE_STUDENT_SCHOOLS.md](./USER_GUIDE_STUDENT_SCHOOLS.md) · [USER_GUIDE_STUDENT_HIGHER.md](./USER_GUIDE_STUDENT_HIGHER.md) |
| [USER_GUIDE_SCHOOL_ADMIN.md](./USER_GUIDE_SCHOOL_ADMIN.md) | [USER_GUIDE_ADMIN_SCHOOLS.md](./USER_GUIDE_ADMIN_SCHOOLS.md) · [USER_GUIDE_ADMIN_HIGHER.md](./USER_GUIDE_ADMIN_HIGHER.md) |

---

## Quick URLs (all roles)

Local origin: `http://localhost:3000`. Production origin: **https://odelpay.vercel.app**.

| Purpose | Path |
|---------|------|
| Public home (visitors + Copilot) | `/` |
| About (SaaS + jurisdiction) | `/about` |
| OpenPayGB personal card (MoMo flag + global networks) | `/admin/my-card` · `/student/card` · `/help/openpay-card-momo-phone` |
| Owner billing & workspace SaaS plans | `/admin/billing` |
| Schools lobby | `/OdelPaySchools` |
| Higher institutions lobby | `/OdelPayUniversities` |
| OpenPayGB lobby | `/opgb` |
| LiveStore (merchant) | `/opgb/livestore` · public `/opgb/livestore/<slug>` |
| Payment links | `/opgb/pay-links` |
| Bills & airtime | `/opgb/bills` |
| Stars / On-Off (modular multi-card) / Wallets / Go / ODEI Wallet | `/opgb/stars` · `/opgb/onoff` · `/opgb/wallets` · `/opgb/go` · `/opgb/kit` |
| Monetize | `/monetize` |
| Workspaces (home icon → Universe) | `/workspace` · teacher `/workspace/teacher/{primary,secondary,o-level,a-level}` · lecturer `/workspace/lecturer/{undergraduate,postgraduate,both}` · school `/workspace/school` · higher `/workspace/higher` · business `/workspace/business` · Pay Tahafidh `/workspace/pay-tahafidh` · Diaspora Pay `/workspace/diaspora` |
| Campus / Units dashboards | School `/admin/school-dashboard` · Higher `/admin/campus-dashboard` · Units (all tiers) `/admin/units-dashboard` · Branches `/admin/academic-units` |
| Teacher / Lecturer desks (legacy entry, still redirects) | `/teacher` · `/lecturer` · register CTAs on `/admin/register` |
| Surface profile/cover + link-fetch | [SURFACE_MEDIA.md](../platform/SURFACE_MEDIA.md) |
| OpenPayGB holder hub | `/card` · `/card/get` · `/user` |
| Class billing (schools) | `/admin/class-billing` |
| Policies | `/policies/terms` · `/policies/terms-of-use` · `/policies/privacy` · `/policies/disclaimer` · `/policies/risk-disclosure` · `/policies/payment-providers` |
| Dex Hub | `/dex` |
| Play Hub | `/play` |
| ODEI OS product root | `/ODEI-OS` ≡ `/odei-os` |
| ODELPay HUB product root | `/ODELPay` ≡ `/odelpay` |
| AssessmentVerse lobby | `/AssessmentVerseOS` ≡ `/assessmentverseos` |
| AssessmentVerse login | `/AssessmentVerseOS/login` |
| AssessmentVerse student login | `/AssessmentVerseOS/student/login` |
| AssessmentVerse staff login | `/AssessmentVerseOS/staff/login` |
| AssessmentVerse admin login | `/AssessmentVerseOS/admin/login` |
| AssessmentVerse parent | `/AssessmentVerseOS/parent` |
| AV Students Register (example) | `/AssessmentVerseOS/lower-primary/students-register` |
| AV Staff desk (example) | `/AssessmentVerseOS/lower-primary/registration/staff` |
| ODEI School Agent lobby | `/school-agent` |
| ODEI School Agent login | `/school-agent/login` |
| Parent portal | `/parent` |
| Developers | `/developers` · `/developers/dashboard` |
| OPGB master console | `/admin/master/opgb-ops` |
| Monetization (master) | `/admin/master#monetization-packages` |
| Visitor analytics (master) | `/admin/master#visitor-analytics` |
| Pay tuition (pick school) | `/pay` |
| Pay tuition (one org) | `/pay/<orgSlug>` |
| Receipt | `/receipt/<paymentId>` |
| School workspace register | `/admin/register` |
| School / org admin login | `/school/login` |
| Student login | `/student/login` |
| Staff login | `/staff/login` |
| Master console | `/admin/master` |
| Tuition hub (org admin) | `/admin` |
| Help center | `/help` |
| Platform Terms of Service | `/policies/terms` |
| Terms of Use | `/policies/terms-of-use` |
| Platform Privacy Policy | `/policies/privacy` |
| Disclaimer | `/policies/disclaimer` |
| Risk Disclosure | `/policies/risk-disclosure` |
| Payment Provider Policy | `/policies/payment-providers` |

---

## Related operator docs

| Topic | Doc |
|-------|-----|
| Admission number customization | [../ADMISSION_NUMBER_FORMAT.md](../school/ADMISSION_NUMBER_FORMAT.md) |
| Dual receipt branding | [RECEIPT_BRANDING](../school/RECEIPT_BRANDING.md) |
| Product lines & Term vs Semester | [PRODUCT_LINES_AND_SCHOOL_TERMS](../platform/PRODUCT_LINES_AND_SCHOOL_TERMS.md) |
| OpenPayGB payment provider | [OPENPAYGB_PAYMENT_PROVIDER](../platform/OPENPAYGB_PAYMENT_PROVIDER.md) |
| Higher / Schools monetization | [ODELPay_HIGHER_SCHOOLS_MONETIZATION](../economics/ODELPay_HIGHER_SCHOOLS_MONETIZATION.md) |
| Header, footer, mobile nav | [FOOTER_AND_HEADER_NAV](../architecture/FOOTER_AND_HEADER_NAV.md) |
| Partner API | [PARTNER_API](../platform/PARTNER_API.md) |
| Developer ecosystem | [DEVELOPER_ECOSYSTEM](../platform/DEVELOPER_ECOSYSTEM.md) |
| Library map | [LIBRARY](../LIBRARY.md) |
| Platform update 2 Nov 2026 (product roots · AVOS IO · PTU) | [PLATFORM_UPDATE_2026-11-02](../platform/PLATFORM_UPDATE_2026-11-02.md) |
| Access surfaces (ODELPay · AV · School Agent) | [ACCESS_SURFACES](../architecture/ACCESS_SURFACES.md) |
| Holistic audit | [HOLISTIC_APP_AUDIT](../product/HOLISTIC_APP_AUDIT.md) |

---

## Support inside the product

- **Help center** — [/help](/help)
- **ODELPay HUB Copilot** — floating Help on most public pages including `/` (hidden on `/help` and `/clicker`).
- **Public visitor strip** — home `/` when Master enables show-public stats.
- **Talk to an agent** — when configured (Telegram / support links in platform social settings).
- **Receipt email** — after confirmed payment when Resend or Brevo is configured.
- **Policies** (16 Sep 2026) — [/policies/terms](/policies/terms) · [/policies/terms-of-use](/policies/terms-of-use) · [/policies/privacy](/policies/privacy) · [/policies/disclaimer](/policies/disclaimer) · [/policies/risk-disclosure](/policies/risk-disclosure) · [/policies/payment-providers](/policies/payment-providers)

For operators: see [../PROJECT_DESCRIPTION.md](../product/PROJECT_DESCRIPTION.md) and [../PRODUCTION_GO_LIVE.md](../deployment/PRODUCTION_GO_LIVE.md).
