Attendance Β· Results Β· Fees Β· Parent engagement β bilingual (বাΰ¦ΰ¦²ΰ¦Ύ / English), offline-ready, and production-grade.
For Bangladeshi schools & colleges - attendance, fees, results, AI chatbot.
90% Bangladeshi schools use paper registers. Parents don't know attendance, teachers waste 2hrs daily.
- π 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
git clone https://github.com/proffesergio/campus-flow.git
cd campus-flow
npm install
npx prisma migrate dev
npm run dev- 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)
- Basic CRUD
- AI attendance anomaly: "Rahim absent 3 days"
- RAG chatbot for parents
- Auto timetable generator with AI
Admin: admin@demo.com / admin123 Teacher: teacher@demo.com / teacher123
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. |
| 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 |
| 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 |
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
schoolIdon every record; the tenant is resolved from a subdomain (prod) or theX-School-Slugheader (dev), and JWTs are bound to their school. RBAC:super_admin Β· school_admin Β· teacher Β· finance Β· student Β· parent.
# 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| Role | |
|---|---|
| ποΈ 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 |
cp .env.docker.example .env # fill secrets
docker compose up --build # postgres + backend + frontendcd backend && npm test # 71 unit/guard tests (no DB needed)
npx tsc --noEmit # strict type-check (backend & frontend)
npm run build # both apps build cleanSee TESTING.md for per-feature manual test scripts, the daily-loop smoke test, and the full pre-deployment production checklist.
| 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) |
β 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.