Homeroom: Autonomous AI School Management System

**Homeroom** is a next-generation, global-level school management system powered by autonomous AI. It shifts the paradigm of school administration from manual task

tracking to intelligent, background execution.

## Core Architecture

- **Frontend:** Next.js (App Router), React, Tailwind CSS, Lucide Icons.
- **Backend/Database:** Supabase (PostgreSQL), Row Level Security (RLS), Realtime Subscriptions.
- **AI Brain:** Vercel AI SDK, Google Gemini (3.6 Flash), autonomous Node.js background workers.
- **Communications:** Nodemailer SMTP Integration for real-world stakeholder emails.

## Key Features & Capabilities

### 1. Autonomous AI Agent Worker
At the heart of Homeroom is a continuously running background agent. Unlike traditional CRON jobs, this agent *thinks* about school benefits. It independently

scans for pending tasks (e.g., overdue fee collection) and acts on them by sending emails or notifying admins—only asking for permission when a decision is critical.

### 2. Intelligent Operations & Missions
Admins can prompt the system with complex, high-level objectives (e.g., "Organize a District Science Competition").
- The AI deeply plans the mission, breaking it down into a comprehensive checklist of tasks (logistics, communications, budget).
- Subagents are spawned in the background to execute each step, completely end-to-end.

### 3. Vendor & Quotation Management (End-to-End AI)
- **Admin Control:** Admins can effortlessly add workers, contractors, and vendors to the directory.
- **Magic Worker Portal:** Vendors receive a secure, passwordless link to access their portal where they can submit PDF quotations for active school missions.
- **Instant AI Evaluation:** The moment a quotation is submitted, the AI Agent intercepts it. It evaluates the amount and details, cross-references it with the

mission requirements, and automatically Approves or Rejects the bid. - Automated Communication: Upon approval, the AI uses real SMTP credentials to immediately notify the relevant students or faculty that a vendor has been secured.

### 4. Real-time Live Activity Feed
As the background AI agent thinks, plans, emails, and evaluates, every single action is streamed in real-time to the dashboard. Admins can watch the AI work live,

providing unparalleled transparency into the system's decision-making process.

### 5. Robust Security & Infrastructure
- Complete Row Level Security (RLS) ensures data isolation between districts and schools.
- Granular role-based access control (RBAC) across authenticated admins and unauthenticated magic links.
- Graceful API rate-limit handling and fallback mechanisms to ensure the school's operations never halt.