System Requirements Document (SRD)

Project Name: Mammoth-School

1. Introduction

The Mammoth-School project is a multi-tenant SaaS platform designed to streamline school and college management. It provides a modern, friendly, and highly engaging user interface tailored for diverse user roles, including Super Admins, School Admins, Teachers, and Parents. The system supports multiple schools, each with its own subdomain (e.g., schoolname.mydomain.com), ensuring data isolation and scalability.

This document outlines the functional and non-functional requirements, user personas, design concepts, and technical specifications for the Mammoth-School platform. The platform is designed to cater to schools and colleges globally, with a focus on accessibility, automation, and premium user experience.

2. System Overview

Mammoth-School is a SaaS platform that simplifies school and college management by offering:

• Multi-tenant architecture with subdomain-based isolation for each school.
• Role-based dashboards for Super Admins, School Admins, Teachers, and Parents.
• Core features such as student and teacher management, attendance tracking, test and exam management, parent portals, and notifications.
• Subscription plans (Basic, Pro, Premium) with scalable features and pricing.
• Automation workflows for attendance alerts, test result notifications, and monthly PDF report generation.

The platform is designed to be mobile-friendly, visually appealing, and easy to use for non-technical users. It supports SMS and email notifications to ensure effective communication with parents.

3. Functional Requirements

As a Super Admin:

• I should be able to manage all schools, their subdomains, and subscription plans.
• I should be able to view system-wide analytics and reports.
• I should be able to manage billing and subscription upgrades for schools.

As a School Admin:

• I should be able to manage students, teachers, classes, and attendance.
• I should be able to configure automated notifications for parents.
• I should be able to generate and review monthly PDF reports for students.
• I should be able to manage subscription plans and view billing details.

As a Teacher:

• I should be able to mark attendance for students.
• I should be able to enter test results, grades, and remarks.
• I should be able to view class performance analytics.

As a Parent:

• I should be able to view my child’s attendance, test results, and monthly reports.
• I should be able to receive notifications about attendance and test results.
• I should be able to communicate with teachers and school admins.

4. User Personas

1. Super Admin

   • Role: Oversees the entire platform, manages schools, and handles subscriptions.
   • Needs: Comprehensive analytics, billing management, and system-wide control.

2. School Admin

   • Role: Manages a specific school’s operations, including students, teachers, and classes.
   • Needs: Tools for managing school data, generating reports, and configuring notifications.

3. Teacher

   • Role: Manages attendance, test results, and class performance.
   • Needs: Simple and efficient tools for marking attendance and entering test results.

4. Parent

   • Role: Monitors their child’s academic progress and receives notifications.
   • Needs: Easy access to attendance, test results, and communication tools.

5. Visuals Colors and Theme

Unique Color Palette:

• Background: #F4F9FF (Soft Sky Blue)
• Surface: #FFFFFF (Pure White)
• Text: #2D4059 (Deep Navy Blue)
• Accent: #4CAF50 (Fresh Green)
• Muted: #B0BEC5 (Soft Gray)

This palette ensures a clean, modern, and friendly aesthetic that aligns with the platform’s educational focus.

6. Signature Design Concept

Interactive Learning Galaxy Homepage

The homepage will feature an interactive galaxy map where each star represents a feature or section of the platform. Users can hover over stars to reveal tooltips and click to navigate to specific sections.

• Animations: Stars will twinkle subtly, and constellations will form dynamically as users hover over related features.
• Transitions: Smooth zoom-in and zoom-out effects when navigating between sections.
• Color Shifts: The galaxy background will transition between soft blue and green hues, creating a calming effect.
• Micro-interactions: Clicking a star will trigger a ripple animation, guiding users to their destination.

This design will make the platform’s landing page unforgettable and engaging, setting the tone for a premium user experience.

7. Non-Functional Requirements

• Scalability: Support for thousands of schools with isolated data environments.
• Performance: Sub-500ms response time for all major actions.
• Security: Role-based access control, encrypted data storage, and secure subdomain routing.
• Localization: Support for multiple languages and regional settings.
• Accessibility: WCAG 2.1 compliance for users with disabilities.

8. Tech Stack

Frontend:

• React for Web
• React Native for Mobile

Backend:

• Python
• FastAPI

Database:

• MySQL (with Alembic for migrations)

AI Models:

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work

AI Tools:

• LangChain
• LiteLLM for LLM Routing

Orchestration:

• Docker and Docker-Compose for local development
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

• Each school will have a unique subdomain (e.g., schoolname.mydomain.com).
• The platform will support both SMS and email notifications.
• Subscription plans will be billed in USD, with annual discounts applied automatically.
• The system will be hosted on a scalable cloud infrastructure.

10. Glossary

• Multi-Tenant Architecture: A software architecture where multiple schools share the same platform but have isolated data environments.
• Subdomain: A unique URL segment assigned to each school (e.g., schoolname.mydomain.com).
• WCAG: Web Content Accessibility Guidelines, ensuring accessibility for users with disabilities.
• LLM: Large Language Model, used for AI-driven features.

This concludes the updated System Requirements Document for Mammoth-School. Let me know if further refinements are needed!