Skip to content

About

A Modern School Management System with Ai Features

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

πŸŽ“ CampusFlow

The modern, AI-powered school management system built for Bangladesh πŸ‡§πŸ‡©

Attendance Β· Results Β· Fees Β· Parent engagement β€” bilingual (বাংলা / English), offline-ready, and production-grade.


TypeScript Next.js React Node.js Prisma

PWA Tests Tailwind AI Status


πŸŽ“ A Modern School Management System with AI Features

For Bangladeshi schools & colleges - attendance, fees, results, AI chatbot.

TypeScript Next.js AI Prisma


Problem

90% Bangladeshi schools use paper registers. Parents don't know attendance, teachers waste 2hrs daily.

Solution

  • πŸ“Š AI attendance with face detection (optional)
  • πŸ’° Fee management with bKash/Nagad integration
  • πŸ“ˆ Auto result generation, transcript
  • πŸ€– AI chatbot: "How was my child today?" - RAG over school data
  • πŸ“± Parent app, SMS alerts in Bangla

Quick Start

git clone https://github.com/proffesergio/campus-flow.git
cd campus-flow
npm install
npx prisma migrate dev
npm run dev

Stack

  • Frontend: Next.js, TypeScript, Tailwind, shadcn/ui
  • Backend: NestJS/Next.js API, Prisma, PostgreSQL
  • AI: LangChain, OpenAI, Vector DB for school Q&A
  • Auth: NextAuth, role-based (Admin, Teacher, Parent, Student)

AI Features (Vibe Coding)

  • Basic CRUD
  • AI attendance anomaly: "Rahim absent 3 days"
  • RAG chatbot for parents
  • Auto timetable generator with AI

Demo

Admin: admin@demo.com / admin123 Teacher: teacher@demo.com / teacher123

Built for education in Bangladesh πŸŽ“

✨ Why CampusFlow

Many Bangladeshi schools still run on paper registers, WhatsApp groups, and manual fee ledgers. CampusFlow replaces all of it with one multi-tenant platform that works on a low-cost Android phone over a 3G connection β€” in Bangla or English, with AI woven into the daily workflow.

🏫 Multi-tenant SaaS One deployment, many schools, strict row-level isolation.

πŸ“± Mobile-first & offline-ready Installable PWA with an offline shell for poor connectivity.

πŸ‡§πŸ‡© Truly bilingual Full Bangla UI with Bengali numerals (০-ΰ§―), one-click toggle.

πŸ€– AI built in Report-card narratives, a student study assistant, and at-risk early warnings.


πŸš€ Feature Highlights

Area What you get
πŸ‘¨β€πŸŽ“ Students & Classes Enrolment, classes with sections, subjects, teacher assignment
πŸ—“οΈ Attendance Daily marking + automated 7 PM guardian absence alerts (SMS / email / in-app)
πŸ“ Exams & Results Bulk grading, class ranking & merit, AI report-card PDF with narratives
πŸ’³ Finance Fee structures, invoices, bKash / Nagad / cards via SSLCommerz, PDF receipts, automated due reminders
πŸ‘ͺ Parent Portal Guardians see each child's attendance, results & fees β€” strict per-family isolation
πŸŽ’ Student Portal Grades, attendance, fees, AI study assistant, practice generator
πŸ”” Communication Targeted broadcasts (SMS / email / in-app) with Bangla templates
πŸ›‘οΈ Security & Compliance RBAC (6 roles), audit logging, JWT httpOnly cookies, Sentry, privacy / ToS / DPA pages
πŸ“Š Early Warning Interpretable at-risk flags from attendance + grade trends
🌐 Infrastructure Installable PWA, Docker + docker-compose, GitHub Actions CI

🧱 Tech Stack

Layer Technologies
Frontend Next.js 15 (App Router) Β· React 19 Β· TypeScript Β· Tailwind Β· shadcn/ui Β· Framer Motion Β· next-intl Β· Sentry
Backend Node.js Β· Express Β· TypeScript (strict) Β· Prisma 5 Β· PostgreSQL Β· Zod Β· JWT Β· Swagger Β· Sentry
AI Anthropic Claude (report narratives) Β· OpenAI GPT-4o (study chat, practice, admin Q&A)
Payments SSLCommerz (bKash / Nagad / cards) Β· Stripe (international)
Notifications Resend (email) Β· Twilio (SMS) Β· in-app + Web Push-ready

πŸ›οΈ Architecture

campusflow/
β”œβ”€β”€ backend/                 # Express + Prisma API (port 3001)
β”‚   β”œβ”€β”€ prisma/              # schema, baseline migration, seed.ts
β”‚   └── src/
β”‚       β”œβ”€β”€ modules/        # auth, students, classes, attendance, exams, finance,
β”‚       β”‚                   #   notifications, ai, schools, parents, audit, analytics
β”‚       β”‚                   #   (route + controller + service + validator each)
β”‚       β”œβ”€β”€ middleware/     # auth (JWT), tenant (X-School-Slug), audit, errors
β”‚       β”œβ”€β”€ services/       # pdf, receipt, notifications, claude, openai
β”‚       └── jobs/           # cron: fee reminders + absence alerts
β”œβ”€β”€ frontend/                # Next.js 15 (port 3000)
β”‚   └── app/                # (auth) (dashboard) (student) (parent) legal/ + PWA
β”œβ”€β”€ docker-compose.yml       # postgres + backend + frontend
β”œβ”€β”€ TESTING.md               # per-feature manual test guide + pre-deploy checklist
β”œβ”€β”€ API.md                   # REST API reference
└── showcase.md              # demo + pilot playbook

Multi-tenancy: shared PostgreSQL with a row-level schoolId on every record; the tenant is resolved from a subdomain (prod) or the X-School-Slug header (dev), and JWTs are bound to their school. RBAC: super_admin Β· school_admin Β· teacher Β· finance Β· student Β· parent.


⚑ Quickstart

# 1. Backend  β†’  http://localhost:3001  (API docs at /api/docs)
cd backend
cp .env.example .env                 # fill DATABASE_URL + JWT secrets
npm install
npx prisma generate && npx prisma db push
npm run prisma:seed                  # load the demo school "dhaka-model"
npm run dev

# 2. Frontend (new terminal)  β†’  http://localhost:3000
cd frontend
cp .env.example .env.local           # set NEXT_PUBLIC_API_URL=http://localhost:3001
npm install
npm run dev

πŸ”‘ Demo accounts Β Β·Β  slug dhaka-model Β Β·Β  password Password123

Role Email
πŸ›οΈ School Admin admin@dhaka-model.test
πŸ‘©β€πŸ« Teacher teacher@dhaka-model.test
πŸ’° Finance finance@dhaka-model.test
πŸ‘ͺ Parent (2 children) parent@dhaka-model.test
πŸŽ’ Student student@dhaka-model.test

🐳 Docker

cp .env.docker.example .env          # fill secrets
docker compose up --build            # postgres + backend + frontend

βœ… Testing

cd backend && npm test               # 71 unit/guard tests (no DB needed)
npx tsc --noEmit                     # strict type-check (backend & frontend)
npm run build                        # both apps build clean

See TESTING.md for per-feature manual test scripts, the daily-loop smoke test, and the full pre-deployment production checklist.


πŸ“š Documentation

Doc What's inside
README.md What the product is + quickstart (this file)
API.md REST endpoint reference (also live at /api/docs via Swagger)
TESTING.md How to test every feature before deploying
showcase.md Demo + client-pilot playbook (presentation β†’ real-school rollout)

πŸ—ΊοΈ Roadmap

βœ… Built β€” parent portal Β· BD payments + receipts Β· audit logging Β· Sentry Β· PWA Β· bilingual + Bengali numerals Β· legal docs Β· at-risk analytics.

πŸ”œ Next β€” facial-recognition attendance Β· education-board / IPEMIS integration Β· admissions CRM Β· deeper predictive ML Β· native mobile app.


Built with ❀️ for the schools of Bangladesh.

About

A Modern School Management System with Ai Features

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages