Teacher: Getting Started
When you log in to Amal for the first time, a short guided walkthrough introduces the platform’s key ideas before your dashboard appears. It takes about 90 seconds and can be dismissed at any slide — your progress is saved either way.
The Day-1 walkthrough (6 slides)
The walkthrough covers the six concepts that matter most in week one:
| Slide | Topic | What you learn |
|---|---|---|
| 1 | What you see | The Skill-Group view is your main daily tool — students are grouped by skill. |
| 2 | What needs attention today | Red-dot students have a Student Alert or Intensive Review; orange-dot students have a Skill Alert. The platform suggests; you decide. |
| 3 | How to act on an alert | You can accept a support bundle, modify it, or dismiss it with a reason code from a closed list. There are no free-text fields — this protects students from being labelled in the system. |
| 4 | Smart Grouping & Bulk Activation | Students with the same need and support level can be activated together. Tasks are automatically differentiated per student within the same bundle. |
| 5 | Safety alerts | Two signals to know: “need more evidence” (no plan is forced until data is sufficient) and a progress-drop alert (a signal to review — never an automatic failure). |
| 6 | Where to find help | Tap any ⓘ icon for instant tooltip help. Download the cheat sheet from your account menu. |
The walkthrough appears once. After you complete or dismiss it, it will not reappear unless you choose “إعادة التهيئة” (Reset onboarding) from your account menu.
The ⓘ help icons
After the walkthrough, small ⓘ icons appear next to every new-vocabulary term in the platform. Tap or hover to see a one-to-two sentence explanation in Arabic.
When you no longer need a tooltip, tap “لا تظهر مرة أخرى” (Do not show again) to permanently dismiss that icon. Dismissed icons do not reappear unless you reset your onboarding.
The 11 help icons cover:
- Tier labels on student cards (Core / Targeted / Intensive)
- Alert chip types (Skill Alert / Student Alert / Intensive Review)
- Support bundle badge on a plan card
- Fidelity bar
- Anchor skill + Supporting threads + Asset bridge on the Recommendations Panel
- Smart Cluster card on the Smart Grouping Panel
- Support level badge on the Scaffold Distribution Preview
- Delivery option dropdown on Activation Review
- “Need more evidence” badge (the platform’s halt signal — لا توجد بيانات كافية بعد)
- Progress-drop review badge (a review signal, not a failure)
- Progress interpretation badge on the Monitoring Widget
Re-running the walkthrough
Open the account menu (your name in the top corner) and choose “إعادة التهيئة”. The six-slide walkthrough will appear the next time you reload the dashboard.
First-use tutorials (Smart Grouping, Acute Regression, Insufficient Evidence)
Three short four-slide tutorials appear the first time you encounter a specific platform moment. They appear once; after you complete or dismiss one, it will not reappear — unless you choose “إعادة التهيئة” to re-arm all tutorials.
| Tutorial | When it appears | What it covers |
|---|---|---|
| Smart Grouping | First time you open the Smart Grouping Panel | How the platform groups students by shared bundle, scaffold level, and delivery mode — and how to review the distribution before activating together |
| Acute Regression — مراجعة انخفاض الأداء | First time an acute-regression progress-drop badge appears in plan decisions | A progress-drop is a review signal, not a judgment of failure. The tutorial explains how to read the badge and what a review involves before any plan change |
| Insufficient Evidence — بيانات غير كافية | First time the engine returns a do_not_decide_yet halt in plan decisions | The platform holds the recommendation until enough comparable data exists. This tutorial explains the wait, why it protects students from premature plans, and that no override can bypass the data-sufficiency gate |
The acute-regression and insufficient-evidence tutorials are deliberately framed around teacher review, not automatic failure or system error — in line with the platform’s growth-language commitment. No tutorial slide ever implies a student has “failed” or that a plan must change immediately.
The cheat-sheet PDF
The cheat sheet is a two-page A4 Arabic reference card. It covers the alert vocabulary, the override-reason codes, the support-level labels, and the 17-step activation workflow on a single printable sheet.
To download it: open the account menu → “تحميل دليل التهيئة”.
The cheat sheet is generated fresh each time you download it, so it always reflects the latest version of the platform vocabulary.
Onboarding funnel dashboard (super-admin)
A super-admin PM view at /admin/onboarding aggregates funnel events across all organisations —
showing how many teachers have reached each tutorial step. This page is not accessible to
per-organisation admins or teachers.
Related guides
- Teacher Activation Workflow: the guided flow for reviewing recommendations and activating a support plan
- RTI Alerts Inbox & Tier Review: what alert types mean and how to act on them
- Language Safety: why the platform never stores free-text notes about students