NextNest — Unified Platform

A unified Next.js platform bridging care gaps, connecting donors, orphanages, and administrators.

• Problem Statement — Vision, impact, and compliance (DPDP Act 2023, JJ Act 2015).
• Demo Script — Step-by-step demo flow for judges and stakeholders.

---

Team Structure & Working Areas

Role	Working Directory
🌐 Website / Public Portal	src/app/(portals)/public/
❤️ Donor Portal	src/app/(portals)/donor/
🏠 Orphanage Portal	src/app/(portals)/orphanage/
🌟 Super Admin Portal	src/app/(portals)/admin/
🤖 AI Engine Developer	src/app/api/ai/

Shared utilities are in src/lib/:

• supabase.ts — Database client (use in any component)
• groq.ts — AI inference client (use in server-side API routes only)

---

Setup (First Time)

1. Prerequisites

• Node.js 18+
• Git

2. Clone the repository

git clone https://github.com/adal3396/IIITnestnext.git
cd IIITnestnext

3. Install dependencies

npm install

4. Set up environment variables

# Copy the example file
cp .env.example .env.local

Then open .env.local and fill in values (ask team lead for the credentials):

• NEXT_PUBLIC_SUPABASE_URL — from Supabase Project Settings → API
• NEXT_PUBLIC_SUPABASE_ANON_KEY — from Supabase Project Settings → API
• GROQ_API_KEY — from https://console.groq.com/keys (AI Engine dev only)

5. Run the development server

npm run dev

Open http://localhost:3000 in your browser.

---

Git Workflow

Important: Only commit changes to your assigned directory. Coordinate with others on src/lib/ and shared components.

# 1. Always pull the latest code before starting work
git pull origin main

# 2. Create a branch for your feature
git checkout -b feat/donor-ai-advisor

# 3. Stage and commit your changes
git add src/app/(portals)/donor/
git commit -m "feat(donor): add AI advisor chat interface"

# 4. Push your branch and open a Pull Request
git push origin feat/donor-ai-advisor

---

System Architecture

flowchart TB

A["Orphanage Uploads Child Data and Documents"] --> B["Data Enters Secure Backend"]
B --> C["Data Sanitization Removes Personal Identifiers"]
C --> D["Data Encryption Layer Protects Stored Data"]
D --> E["AI Engine Processes Anonymized Indicators"]

E --> F{"AI Agents"}

F --> G["Predictive Risk Agent"]
F --> H["Government Scheme Matcher"]
F --> I["Document OCR Agent"]
F --> J["Philanthropy Advisor"]
F --> K["Transition Success Matcher"]

G --> L["AI Outputs Explainable Insights"]
H --> L
I --> L
J --> L
K --> L

L --> M{"Results Distribution"}

M --> N["Orphanage Dashboard Child Care Insights"]
M --> O["Donor Dashboard Anonymized Impact Metrics"]
M --> P["Super Admin Portal Bias Auditing and Oversight"]

N --> Q["Audit System Logs All Actions"]
O --> Q
P --> Q

style A fill:#e1f5ff
style B fill:#e1f5ff
style C fill:#fff3e0
style D fill:#fff3e0
style E fill:#f3e5f5
style F fill:#f3e5f5
style G fill:#f3e5f5
style H fill:#f3e5f5
style I fill:#f3e5f5
style J fill:#f3e5f5
style K fill:#f3e5f5
style L fill:#e8f5e9
style M fill:#e8f5e9
style N fill:#fce4ec
style O fill:#fce4ec
style P fill:#fce4ec
style Q fill:#eeeeee

Loading

---

Tech Stack

• Framework: Next.js 15 (App Router)
• Styling: Tailwind CSS
• Database & Auth: Supabase (PostgreSQL)
• AI Inference: Groq API
• Icons: Lucide React