9
Switch language to العربية

MVP

PreviousNext

Minimum Viable Product implementation roadmap for Hogwarts School Automation Platform - 9 core epics

Click badge readme and issue at epics below to know more.

A school can enroll students, manage classes, track attendance, grade assignments, collect fees, and communicate with parents—all within a single platform.

Infrastructure

Multi-tenant architecture, subdomain routing, and core technical setup.

Authentication

User management, role-based access control, and secure auth flows.

Configuration

School profile, academic structure, branding, and settings.

Student

Student lifecycle from enrollment to graduation with profiles.

Listings

Subjects, classes, teachers, parents, and staff records.

Attendance

Daily attendance tracking, reports, and absence management.

Exam

Exam scheduling, grading, results, and report cards.

Timetable

Class scheduling, period management, and conflict detection.

Admission

Application processing, enrollment workflow, and registration management.


Epic 01: Infrastructure

Set up the core foundation where each school gets its own subdomain with isolated data. Great for learning multi-tenant apps, middleware, and how to keep data separate and secure.

15 storiesreadmeissuehigh
  • Multi-tenant database schema with schoolId scoping done prisma
  • Subdomain routing (school.databayt.org) in progress middleware
  • Next.js 16 + React 19 + Prisma 6 configured done
  • CI/CD pipeline with automated tests backlog devops
  • Error monitoring (Sentry) operational done monitoring
  • Internationalization (Arabic/English) functional done i18n
  • Development/staging/production environments in progress devops
  • Database singleton pattern implemented done prisma
  • Testing infrastructure (Vitest, Playwright) backlog testing
  • Multi-tenant test suite with isolation verification backlog testing
  • Middleware for subdomain rewriting in progress middleware
  • Tenant context helper functional done core
  • Environment configuration type-safe done docs
  • Tailwind CSS 4 with RTL/LTR support done styling
  • Layout structure with font configuration done styling

Epic 02: Authentication

Build secure login with email, password, and social providers plus user roles for teachers, students, and parents. Perfect for learning tokens, protected routes, and modern auth patterns.

18 storiesreadmeissuehigh
  • NextAuth v5 configured with JWT strategy done auth
  • Email/password auth with bcrypt hashing done auth
  • OAuth providers (Google, Facebook) working in progress auth
  • Two-factor authentication (2FA) functional backlog security
  • DEVELOPER role implemented done rbac
  • ADMIN role implemented done rbac
  • TEACHER role implemented done rbac
  • STUDENT role implemented done rbac
  • GUARDIAN role implemented done rbac
  • ACCOUNTANT role implemented done rbac
  • STAFF role implemented done rbac
  • USER role (default) implemented done rbac
  • Role-based access control enforced on routes in progress middleware
  • Password reset flow complete bug auth
  • Session management with auto-renewal done auth
  • User profile management in progress ui
  • User invitation system backlog enhancement
  • Audit logging for sensitive operations backlog security

Epic 03: Configuration

Let each school customize their look with logos, colors, and branding that matches their identity. A great way to learn form handling, file uploads, and theme systems.

12 storiesreadmeissuemedium
  • School profile creation and management backlog priority
  • School information display backlog ui
  • Academic year setup with start/end dates backlog prisma
  • Term/period configuration backlog
  • Year level/grade configuration backlog
  • Department management backlog
  • School branding (logo upload) backlog upload
  • Color picker for school colors backlog styling
  • Timezone configuration backlog
  • School settings page functional backlog ui
  • School setup wizard for onboarding priority ux
  • Logo preview and management backlog upload

Epic 04: Student

Manage the full student journey from enrollment to graduation with rich profiles and guardian links. Ideal for learning complex forms, data relationships, and handling lots of records efficiently.

20 storiesreadmeissuehigh
  • Student enrollment form working done crud
  • Student profile page structure (7 tabs) in progress ui
  • Personal information tab complete in progress
  • Academic information tab complete backlog
  • Health records tab complete backlog
  • Documents tab with upload capability backlog upload
  • Achievements tab with tracking backlog
  • Disciplinary records tab backlog
  • Fees tab with payment history backlog finance
  • Student search functionality done table
  • Advanced filtering system in progress table
  • Guardian relationships and linking in progress prisma
  • Document upload and management backlog upload
  • Photo upload and display backlog upload
  • Batch operations (bulk actions) backlog enhancement
  • Student export (individual) done export
  • Student export (bulk CSV) done export
  • Status transitions (enrolled/transferred/graduated) backlog
  • Previous education records backlog
  • Emergency contact management backlog

Epic 05: Listings

Keep track of subjects, classes, teachers, parents, and staff with profile pages and data tables. Perfect for mastering crud operations and understanding how entities relate to each other.

18 storiesreadmeissuehigh
  • Subject catalog creation done crud
  • Subject management (CRUD operations) done crud
  • Class creation with details done crud
  • Class capacity management backlog
  • Student enrollment in classes done prisma
  • Student-class conflict detection backlog
  • Teacher assignment to classes in progress
  • Teacher-subject allocation in progress
  • Teacher profile creation form done crud
  • Teacher profile display page in progress ui
  • Qualifications management backlog
  • Parent/guardian profile management done crud
  • Staff profile creation backlog
  • Department assignment backlog
  • Class sections management backlog
  • Class roster export backlog export
  • Resource sharing within class backlog
  • Class analytics dashboard backlog analytics

Epic 06: Attendance

Track who shows up each day with simple marking or options like qr codes and location check-ins. Great for learning real-time updates, data visualization, and notification systems.

12 storiesreadmeissuehigh
  • Daily attendance marking interface done ui
  • Attendance status options (present/absent/late/excused) done
  • Bulk attendance marking in progress
  • Attendance reports by class in progress analytics
  • Attendance reports by student backlog analytics
  • Monthly attendance summary backlog
  • Absence notification to parents backlog notification
  • Late arrival tracking done
  • Attendance trends analytics in progress analytics
  • Export attendance data backlog export
  • Teacher attendance tracking backlog
  • Leave request integration backlog

Epic 07: Exam

Handle exams from scheduling to grading, calculating averages, and generating report cards as pdfs. A fun way to learn pdf generation, grade calculations, and working with educational data.

15 storiesreadmeissuemedium
  • Exam creation and scheduling in progress crud
  • Exam type configuration (midterm/final/quiz) backlog
  • Grade entry interface in progress ui
  • Grade scale configuration backlog
  • Result calculation (weighted averages) backlog
  • Report card generation priority export
  • Report card templates backlog
  • Result publication workflow backlog
  • Parent result notification backlog notification
  • Class performance analytics backlog analytics
  • Subject-wise performance reports backlog analytics
  • Grade history tracking backlog
  • Exam room allocation backlog
  • Exam schedule conflict detection backlog
  • Result export (PDF/CSV) backlog export

Epic 08: Timetable

Build a visual schedule builder with drag and drop, preventing double-booking of teachers or rooms. Excellent for learning drag-and-drop interfaces and solving real scheduling problems.

12 storiesreadmeissuemedium
  • Visual timetable builder done ui
  • Drag-and-drop scheduling done ux
  • Period-wise scheduling done
  • Break management in schedule in progress
  • Room allocation in progress
  • Teacher conflict detection done validation
  • Room conflict detection done validation
  • Student conflict detection backlog
  • Teacher timetable view done
  • Class timetable view done
  • Room timetable view done
  • Timetable export (PDF/print) in progress export

Epic 09: Admission

Guide new students through applications from filling out forms to getting accepted and enrolled. A great introduction to workflow systems and state machines in real applications.

10 storiesreadmeissuelow
  • Online application form priority ui
  • Application status tracking backlog
  • Document upload for applications backlog upload
  • Application review workflow backlog
  • Admission decision (accept/reject/waitlist) backlog
  • Enrollment confirmation backlog
  • Fee payment integration backlog finance
  • Admission reports backlog analytics
  • Bulk application import backlog
  • Application deadline management backlog