Appearance
Troubleshooting
Sign-in
| Symptom | Likely cause | What to try |
|---|---|---|
| Invalid credentials | Wrong password or tenant | Confirm subdomain and ask admin to re-invite |
| No password reset link | Not implemented | Contact a school admin for a new temporary password |
| No Microsoft / Google button | SSO not activated | Use email/password; see SSO setup |
SCIM provisioning
| Symptom | Likely cause | What to try |
|---|---|---|
| 401 from IdP test | Wrong or revoked token | Generate a new token in Admin → SCIM provisioning |
| 403 SCIM not enabled | Feature flag off | Generate a token (auto-enables) or contact platform operator |
| User synced but cannot sign in | SCIM ≠ SSO | Send manual invite or wait for SSO activation |
| 409 duplicate user | Email already exists | Remove manual invite or deactivate old account |
| Groups not syncing | Not supported yet | Assign users directly in the IdP |
See SCIM provisioning.
Outlook calendar sync
| Symptom | Likely cause | What to try |
|---|---|---|
| Integration page missing | outlook_calendar flag off | Operator enables flag in /operator |
| Health check fails | Entra permissions / UPN | Verify app registration, admin consent, mailbox scope |
| Sync job failed | Graph throttling or worker down | Retry job in Admin; check CRON_SECRET, Redis, worker |
| No events for staff | Person sync off or no email | Enable per-person sync; add email in staff directory |
See Outlook calendar.
Setup and staff
| Symptom | Likely cause | What to try |
|---|---|---|
| No template slots | Day structure not saved | Save Mon–Fri window in Setup |
| Import tiers wrong | Missing column / fill colours | Use explicit Duty tier column in CSV |
| Person missing from assign list | Inactive / not imported | Check Staff directory |
Today and cover
| Symptom | Likely cause | What to try |
|---|---|---|
| Empty board | Not built yet | Select Build day |
| Cannot publish | Missing rota.publish | Sign in as duty lead / admin |
| Persistent gaps | Insufficient eligible staff | Adjust tiers, headcounts, or accept last resort |
| Board stale | SSE lag | Wait ~15s or reload |
Notifications
| Symptom | Likely cause | What to try |
|---|---|---|
| Empty inbox | No matching rule / no publish yet | Publish a day; check rule audience/channels |
| No email in local | EMAIL_PROVIDER=console | Read server console logs |
Exports
| Symptom | Likely cause | What to try |
|---|---|---|
| Empty file | Day not materialised | Build the day/week first |
| PDF missing colours | Browser print settings | Enable background graphics |
Still stuck?
- Check the Admin → Audit log for recent changes
- Developers: see Local setup and
docs/SYSTEM_PLAN.md