mint-school

As a developer I want to align colors and theme across all pages per the SRD color palette so that the UI is visually consistent. Apply Accent #27AE60, Muted #BDC3C7, Background #F5F9FC, Surface #FFFFFF, and Text #2C3E50 across all components and pages. Ensure the Interactive Chalkboard signature design concept micro-interactions and chalk-dust animations are consistently applied across pages.

As a user I want to use the frontend Login page so that I can sign in to the mint-school platform with my credentials and be redirected to my role-specific dashboard. Implement the Login page based on the existing v2 JSX design. Page includes: school logo with mint-school branding, email/password fields, sign-in CTA button in primary green, role selector, forgot password link, and responsive layout. This page is the entry point for all user flows (Administrator, Teacher, Student, Parent).

As an Administrator, Teacher, Student, or Parent I want to use the frontend Dashboard page so that I can view my role-specific summary and quick-access widgets. Implement the Dashboard page based on the existing v2 JSX design. Supports 4 role views: Admin (school-wide KPIs, staff count, fee collections, recent activity), Teacher (class schedule, pending attendance, grade input shortcuts), Student (today's timetable, grades, attendance %, unread notices), Parent (child summary, fees due, attendance rate, messages). Navigates to: Staff, Admissions, Fees, Notices, Library, Attendance, Grades, Messages, Timetable.

As an Administrator I want to use the frontend Staff page so that I can manage staff profiles including viewing, creating, editing, and deactivating staff accounts with role, contact, and employment details. Implement the Staff page based on the existing v2 JSX design. Includes: staff list with search and filter, staff profile cards, create/edit staff modal, role assignment, and status management. Accessible from Dashboard.

As a Teacher or Student I want to use the frontend Timetable page so that I can view and manage class schedules. Implement the Timetable page based on the existing v2 JSX design. Supports: Teacher view (weekly timetable grid, update/request schedule changes, subject and classroom assignments), Student view (daily and weekly schedule, teacher names, room locations, upcoming classes). Accessible from Dashboard.

As a Teacher or Parent I want to use the frontend Messages page so that I can send and receive messages, manage conversation threads, and stay informed about student progress. Implement the Messages page based on the existing v2 JSX design. Includes: conversation list panel, message thread view, compose message modal, unread badge counts, search contacts, and role-based contact filtering (Teacher can message Parents; Parent can contact Teachers and Administrators). Accessible from Dashboard.

As a Teacher, Student, or Parent I want to use the frontend Attendance page so that I can mark, view, and monitor attendance records. Implement the Attendance page based on the existing v2 JSX design. Supports: Teacher view (class roster with present/absent/late marking, session selector, bulk actions), Student view (personal attendance calendar, monthly summary, subject-wise %, ), Parent view (child's daily attendance history and absence alerts). Accessible from Dashboard.

As an Administrator or Parent I want to use the frontend Fees page so that I can generate fee reports, view collections, pay fees online, and access payment history. Implement the Fees page based on the existing v2 JSX design. Supports: Admin view (fee collection reports, outstanding dues, export, analytics), Parent view (outstanding fees, online payment flow, payment history with receipts). Accessible from Dashboard. Includes IST locale for dates and INR (₹) for currency.

As an Administrator I want to use the frontend Admissions page so that I can manage admissions and enrollment including reviewing applications, approving or rejecting students, and tracking enrollment status across academic terms. Implement the Admissions page based on the existing v2 JSX design. Includes: admissions stats row, applications table with status badges, application detail drawer, new application form modal with multi-step wizard, bulk actions, and pagination. Accessible from Dashboard.

As a Teacher, Student, or Parent I want to use the frontend Grades page so that I can input, view, and track academic grades and progress. Implement the Grades page based on the existing v2 JSX design. Supports: Teacher view (grade input table per subject, bulk mark entry, progress analytics), Student view (subject-wise marks, exam results, report card download, class benchmark comparison), Parent view (child's grade tracking, subject performance, teacher feedback). Accessible from Dashboard.

As an Administrator I want to use the frontend Library page so that I can track library resources including managing book inventory, monitoring issued and returned items, and viewing overdue records. Implement the Library page based on the existing v2 JSX design. Includes: book inventory list, issue/return transaction management, overdue tracking, search and filter, and resource analytics. Accessible from Notices page and Dashboard.

As an Administrator, Teacher, Student, or Parent I want to use the frontend Notices page so that I can send, manage, and view school-wide announcements and notices. Implement the Notices page based on the existing v2 JSX design. Includes: filter bar with category tabs (All, Announcements, Events, Urgent, Drafts), notice list panel with read-receipt progress bars, notice detail panel with rich text body and attachments, compose notice modal with rich-text editor, audience targeting, scheduling, and priority. Accessible from Dashboard.

As a developer I want to build dashboard aggregation backend APIs so that role-specific summary data including attendance rates, recent grades, fee status, and notices are efficiently served to each user type. Endpoints should support Administrator, Teacher, Student, and Parent role filtering and return normalized JSON responses.

As a developer I want to build the admissions and enrollment backend API so that applications can be submitted, reviewed, approved or rejected, and enrollment status tracked across academic terms via FastAPI REST endpoints.

As a developer I want to build the library management backend API so that book inventory can be managed, issue and return transactions recorded, overdue tracking automated, and search and filter capabilities provided via FastAPI REST endpoints.

As a developer I want to build the grades and marks backend API so that teachers can submit marks, students and parents can retrieve results, and report generation is supported with filtering and aggregation via FastAPI REST endpoints.

As a developer I want to build the attendance backend API so that attendance records can be created, updated, retrieved, and summarized for students across all roles via secure FastAPI REST endpoints with IST timezone support.

As a developer I want to build the staff management backend API so that administrators can create, update, retrieve, and deactivate staff profiles including role assignment and employment details via secure FastAPI REST endpoints.

As a developer I want to build the fees backend API so that fee structures can be managed, payments processed and recorded in INR (₹), collection reports generated, and payment history retrieved per student via FastAPI REST endpoints.

As a developer I want to build the notices and announcements backend API so that administrators can create and publish notices targeted to specific roles, schedule delivery, and all users can retrieve relevant announcements with read-receipt tracking via FastAPI REST endpoints.

As a developer I want to build the messaging backend API so that teachers and parents can send and receive messages, conversation threads are maintained, and unread message counts are tracked per user via FastAPI REST endpoints.

As a developer I want to build the timetable backend API so that class schedules can be created and updated by administrators, and retrieved by teachers and students with filtering by class, subject, and day via FastAPI REST endpoints.

As a Student or Parent I want an AI-powered academic progress assistant so that I can receive personalized insights, study recommendations, and performance summaries generated using GPT, Claude, or Gemini via Litellm and Langchain routing.

As an Administrator I want AI-powered insights on fee collections and outstanding dues so that I can identify payment patterns, predict defaults, and generate natural language summaries of financial reports via Litellm and Langchain.

As an Administrator I want an AI assistant to help draft school notices and announcements so that I can generate professional and contextually appropriate content quickly using GPT, Claude, or Gemini via integrated Litellm and Langchain capabilities.