Roles & Permissions
There are six distinct roles in Scholiphi. Most features are gated by role; a few are gated by additional flags (e.g. AI Usage is super-admin only even though admins can do most other things).
The roles
| Role | Description |
|---|---|
| Super Admin | Platform-level. Sees all schools. Can create schools, view AI usage across schools. |
| Admin | Single-school admin. Sets up the school: students, teachers, sections, transport, plans. |
| Sub-Admin | Scoped admin with permission flags assigned by an admin. See Sub-Admin & Access Control. |
| Teacher | Class-level. Assigned to sections as either class teacher or subject teacher (or both). |
| Student | Belongs to a section. Has a parent account linked. |
| Parent | Linked to one or more students. Multi-child switcher in the parent app. |
| Independent Student | Student without a school affiliation (consumer use case). |
Capability matrix (high level)
| Capability | Super | Admin | Sub-Admin | Teacher | Student | Parent |
|---|---|---|---|---|---|---|
| Create school | ✅ | — | — | — | — | — |
| Add students/teachers | — | ✅ | scoped | — | — | — |
| AI Usage analytics | ✅ | — | — | — | — | — |
| Assign homework | — | — | — | ✅ | — | — |
| Submit homework | — | — | — | — | ✅ | — |
| View child's homework | — | — | — | — | — | ✅ |
| Take attendance | — | — | — | ✅ | — | — |
| View attendance | — | ✅ | scoped | ✅ | ✅ | ✅ |
| Live classes (host) | — | — | — | ✅ | — | — |
| Live classes (join) | — | — | — | — | ✅ | — |
| Buy coins | — | — | — | — | — | ✅ |
| Spend coins (AI tutor) | — | — | — | — | ✅ | — |
| Approve coin requests | — | ✅ | scoped | — | — | — |
| Moderate chat | — | ✅ | scoped | — | — | — |
This matrix is non-exhaustive — most Feature Flow pages have a "Who can do this" row at the top with the per-feature breakdown.
How roles get assigned
- Super admins are seeded directly in the database.
- Admins are created by super admins as part of School Creation.
- Sub-admins are created by admins via Sub-Admin & Access Control.
- Teachers are added by admins via Teacher Creation, then assigned to sections via Sections & Teacher Assignment.
- Students are added by admins manually or in bulk via Student Creation. Parent accounts are auto-linked from student records.