Admin & Operations
Administrators have a bird's-eye view of the platform via the tile-based admin dashboard.
Core Management Areas
- Users: Invite new users, suspend accounts, or edit profiles. You can also "Pause" a user (same as the "Taking a Break" feature).
- Lessons: Oversee the entire lesson catalog, run database migrations, or seed default templates.
- Emails: Monitor the logs of all sent emails (transactional and marketing).
- Settings: Configure global settings, point values, and feature flags.
- Cron: Manually trigger system jobs (like "Start Date" notifications) or simulate time for testing.
- Profile: View your own profile with extra admin controls.
System Jobs (Cron)
LessonHub runs automatic jobs to keep things moving:
- Hourly: Sends "Start Date" notifications (runs daily at 10:00 UTC on some plans).
- Daily (09:00 UTC): Sends assignment reminders and weekly summaries.
Testing: You can use the Cron Test page to simulate specific times and ensure emails are firing correctly.
Database & Maintenance
- Migrations: Always run via the provided
npmscripts to ensure safety. - Seeding: If default templates or badges are missing, the seed script restores them without deleting existing data.
Security & Best Practices
- Secrets: All sensitive keys (database passwords, API keys) are stored in
.env.localand never shared. - Data: Financial values (like prices) are handled with high precision.
- Leaderboards: Savings are displayed clearly with color-coding (Green for positive, Red for negative) to avoid confusion.
Support Playbook
Common admin tasks:
- Hub Guide Access: If a student claims they paid but can't see guides, check their payment status in their Profile.
- Lyric Errors: If teachers report issues with lyric lessons, it often means a database migration is needed.
- Timezones: Encourage all users to set their timezone. Incorrect timezones are the #1 cause of "missed" deadlines.