DAC Academy — System Inventory & Navigation Map

---

1. ROUTE HIERARCHY

1.1 Public Routes (No Authentication Required)

1.2 API Routes

1.3 Admin Routes ((admin) Route Group)

These routes share the Admin Layout with sidebar navigation. Accessible by: admin, counselor, warden (role-dependent).

1.3.1 Dashboard

Widgets:

• Total Leads — Count of all leads (admin, counselor)
• Hot Leads — Subset of leads marked "hot" (admin, counselor)
• Admissions — Total admissions count (admin, counselor)
• Students — Active student count (admin, counselor, warden)
• Revenue — Sum of all paid fees in paise (admin, counselor)
• Pending Outings — Outings awaiting approval (admin, warden)
• Pending Medical Requests — Medical requests awaiting acknowledgment (admin, warden)
• WhatsApp Messages — Total notification count (admin)
• Currently Out — Approved outings not yet returned (warden only)
• Charts Section:
  • Leads by Status — Pie/bar chart of lead distribution
  • Fee Collection — Time-series chart of fee collection
  • (Hidden for warden role)

1.3.2 Leads (CRM)

Components on Leads Page:

• Kanban Columns: New, Contacted, Interested, Registered, Admitted, Lost
• Filters: Branch, Date Range (from/to), Search
• Sortable Columns (table view): Student Name, Parent Name, Probability, Created Date

Components on Lead Detail Page:

• Student Information Card
• Parent Information Card
• Lead Status Card
• Registration Receipt Card (if registered)
• Phone Action Buttons (call/WhatsApp)
• Follow-up Timeline
• Edit Lead button
• Register button (if eligible)
• Convert to Admission button (if eligible)

1.3.3 Admissions

Filters on Admissions Page: Branch, Course, Date Range (from/to), Search

Admission Form Sections (New):

1. Student Details — Name, Class, Target Exam, Date of Birth, Gender
2. Contact Details — Phone (parent), Email, Father/Mother/Local Guardian phones
3. Academic Info — Course, Batch, Board, School, Medium
4. Address — State, Full Address
5. Hostel — Room, Bed, Locker selection (if hostel opted)
6. Fee Structure — Admission Fee, Hostel Fee, Installment schedule
7. Payment — Amount Paid, Payment Mode, Transaction ID, Screenshot
8. Documents — Document checklist items (photo upload per item)
9. Admission Items — Items to be given to student
10. Student Photo — Upload

1.3.4 Students

Filters on Students Page: Branch, Course, Batch, Class, Status, Hostel Status, Admission Type, Session, Search Actions: Export to Excel

Student Detail Page Sections:

• Header: Photo, Name, Batch, Branch, Status badge, Session status
• Action Buttons: Edit Profile, Batch Transfer, Promote, Re-enroll, Reinstate, Parent Password Reset, Parent Account Creation
• Personal Info Card: Name, DOB, Class, Target Exam, Board, Medium, School, Address, Aadhaar
• Contact Info Card: Parent name/phone/WhatsApp, Father/Mother/Guardian phones, Email
• Hostel Info Card: Room, Bed, Locker, Hostel name (if hostel opted)
• Admission Info Card: Admission type, date, fee snapshot, transaction details
• Documents Card: Checklist items with status and document links
• Admission Items Card: Items given/remaining
• Fee Card: Fee record, payment progress, installment timeline
• Payment History: Transaction table with Edit/Void/Pay actions
• Enrollment History Card: Session-by-session enrollment history
• Re-enroll Dialog — For students who left/completed
• Promote Dialog — Move to next session
• Status Transition Dialog — Mark as Left/TC Issued/Removed/Completed

1.3.5 Fees

Filters on Fees Page: Branch, Batch, Course, Due Date Range, Search Columns: Student Name, Batch, Total Fee, Paid, Outstanding, Status (Paid/Pending/Partial/Overdue), Last Payment

1.3.6 manual Receipts

1.3.7 Hostel

Hostel Page Tabs:

• Directory — Student hostel directory (room, name, contact, status)
• Outings — Outing requests list with status filter
• Medical Requests — Medical request queue

Outing Review Page: Request details, review form (Approve/Reject), student/branch info

1.3.8 Users (Admin Only)

Features: Create user, Edit user, Toggle active status, Reset password, Role assignment, Branch assignment, Hostel assignment

1.3.9 WhatsApp Log (Admin Only)

Filters: Status, Event Type, Date Range, Search by recipient/template

1.3.10 Audit Log (Admin Only)

Filters: Entity Type, Action, Date Range, Search Features: Human-readable summaries for each audit entry

1.3.11 Announcements (Admin Only)

1.3.12 Settings (Admin Only)

Settings Tabs:

• Academy — Academy name, GST settings
• Branches — Add/edit/toggle branches
• Courses — Add/edit/toggle courses
• Batches — Add/edit/toggle batches (with fee fields and payment schedule)
• Sessions — Create/activate/deactivate academic sessions
• Hostels — Add/edit/toggle hostels per branch
• Checklist — Document checklist items configuration
• WhatsApp — Notification settings (toggles for each event type)

1.3.13 Batches

1.4 Parent Routes (/parent/)

Parent Dashboard Widgets:

• Students linked to account
• Upcoming fee installments
• Recent receipts
• Recent outing requests
• Recent medical requests
• Announcements matching student profiles

1.5 Warden Routes (/warden/)

---

2. SIDEBAR NAVIGATION (Staff)

Additional Sidebar Elements:

• Parent Portal Link (bottom of sidebar) — shown when user has linked parent students; navigates to /parent/dashboard
• Branch Filter (in header) — shown only for admin/counselor roles

---

3. PARENT NAVIGATION

---

4. WARDEN NAVIGATION

---

5. DIALOGS, DRAWERS, AND MODALS

---

6. MOBILE NAVIGATION

The mobile sidebar is a slide-out Sheet component containing the same NAV_ITEMS as the desktop sidebar, role-filtered identically. Includes logo, branch-aware links, and optional Parent Portal link.

---

7. AUTHENTICATION FLOW

Login Page (/login) ↓ Email + Password + Remember Me ↓ Rate limited: 5 attempts/IP/60s ↓ Better Auth signInEmail API ↓ If parent → redirect /parent/dashboard ↓ If admin/counselor/warden → redirect /dashboard Forgot Password (/forgot-password) ↓ Email + Rate limited: 3 requests/email/120s ↓ Better Auth requestPasswordReset API ↓ Email sent with reset link → /update-password?token=X Update Password (/update-password) ↓ New Password + Token OR Existing Session ↓ Rate limited: 5 attempts/IP/60s ↓ If parent → redirect /parent/dashboard ↓ If staff → redirect /dashboard Logout (from header user menu) ↓ Better Auth signOut API ↓ Redirect /login

---

8. RECEPTION/Front-Desk WORKFLOW MAP

The front desk workflow spans multiple screens in a sequential flow:

/leads/new → /leads → /leads/[id] → /leads/[id]/edit ↓ (Register) Register Dialog → receipt generated ↓ (Convert to Admission) /admissions/new?leadId=X → Submit Admission ↓ Student created, parent account created, fee record, installments, receipt, document checklist ↓ /students/[id] → Student details