<div class="install-guide">
  <h2>Edupanel Installation and Deployment Guide</h2>
  <p>This guide takes you from a fresh clone to a running development setup, then to a production deployment on a VPS. It covers all three components: the Django backend, the Next.js dashboard, and the Flutter mobile app. A mid-level developer can follow this end to end.</p>

  <h3>Prerequisites</h3>
  <ul>
    <li>Python 3.11 or newer</li>
    <li>Node.js 18 or newer and npm</li>
    <li>Flutter 3.22 or newer (stable channel) for the mobile app</li>
    <li>Redis (only if you want async Celery tasks; optional in development)</li>
    <li>A Razorpay account with API keys for payments</li>
    <li>Git</li>
  </ul>

  <h3>Repository Layout</h3>
  <pre><code>coaching/
├── backend/     Django 5 + DRF REST API
├── frontend/    Next.js 14 admin dashboard
└── mobile/      Flutter teacher + parent app</code></pre>

  <h3>Step 1 — Backend Setup (Django REST API)</h3>
  <pre><code>cd backend
python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env</code></pre>
  <p>Open <code>.env</code> and set at minimum the <code>SECRET_KEY</code>. For payments and notifications, also fill in the Razorpay and provider keys (see the environment variables section below).</p>

  <h3>Step 2 — Database and Demo Data</h3>
  <pre><code>python manage.py migrate
python manage.py createsuperuser
python manage.py seed_demo</code></pre>
  <p>The <code>seed_demo</code> command creates one institute, five students, two batches, fee invoices, attendance records, and tests so you can explore a fully populated product right away.</p>

  <h3>Step 3 — Environment Variables</h3>
  <pre><code># Core
SECRET_KEY=change-me-to-a-long-random-string
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1

# Razorpay
RAZORPAY_KEY_ID=rzp_live_xxx
RAZORPAY_KEY_SECRET=xxx
RAZORPAY_WEBHOOK_SECRET=xxx

# Notifications: stub | gupshup | msg91
NOTIFICATION_PROVIDER=stub

# Celery (optional)
USE_CELERY=False
CELERY_BROKER_URL=redis://localhost:6379/0</code></pre>
  <p>Keep <code>NOTIFICATION_PROVIDER=stub</code> and <code>USE_CELERY=False</code> during development so you do not need Redis or live SMS credits. Notifications log to stdout and tasks run synchronously.</p>

  <h3>Step 4 — Run the Backend</h3>
  <pre><code>python manage.py runserver</code></pre>
  <ul>
    <li>API docs (Swagger): <code>http://localhost:8000/api/docs/</code></li>
    <li>ReDoc: <code>http://localhost:8000/api/redoc/</code></li>
    <li>Django admin: <code>http://localhost:8000/admin/</code></li>
  </ul>
  <p>Demo login after seeding: username <code>admin_sunrise</code>, password <code>Admin@1234</code>.</p>

  <h3>Step 5 — Frontend Setup (Next.js Dashboard)</h3>
  <pre><code>cd frontend
npm install
cp .env.example .env.local</code></pre>
  <p>Edit <code>.env.local</code> and point it at your backend:</p>
  <pre><code>NEXT_PUBLIC_API_URL=http://localhost:8000</code></pre>
  <pre><code>npm run dev
# → http://localhost:3000</code></pre>
  <p>Make sure the Django backend is running on port 8000 with CORS allowed for <code>localhost:3000</code>. Log in with the demo admin credentials above.</p>

  <h3>Step 6 — Mobile App Setup (Flutter)</h3>
  <pre><code>cd mobile
flutter pub get

# Android emulator (host loopback)
flutter run --dart-define=API_URL=http://10.0.2.2:8000

# iOS simulator
flutter run --dart-define=API_URL=http://localhost:8000

# Physical device (use your machine's LAN IP)
flutter run --dart-define=API_URL=http://192.168.1.x:8000</code></pre>
  <p>For Android, ensure <code>minSdkVersion 21</code> in <code>android/app/build.gradle</code> for Razorpay. To reach an HTTP backend from a real device during development, add <code>android:usesCleartextTraffic="true"</code> to the application tag in the manifest, and remove it for production.</p>

  <h3>Step 7 — Building for Production</h3>
  <p><strong>Backend:</strong> switch to the production settings module and run with Gunicorn.</p>
  <pre><code>pip install gunicorn
python manage.py collectstatic --noinput
gunicorn coaching_backend.wsgi:application --bind 127.0.0.1:8001 --workers 3</code></pre>
  <p><strong>Frontend:</strong> build the Next.js app for production.</p>
  <pre><code>npm run build
npm run start   # serves on port 3000</code></pre>
  <p><strong>Mobile:</strong> build a release APK or app bundle.</p>
  <pre><code>flutter build apk --release --dart-define=API_URL=https://api.yourdomain.com
flutter build appbundle --release --dart-define=API_URL=https://api.yourdomain.com</code></pre>

  <h3>Step 8 — Deploying to a VPS</h3>
  <p>The repository ships with deployment files under <code>backend/deploy/</code>: <code>gunicorn.service</code>, <code>celery.service</code>, <code>celery-beat.service</code>, and <code>nginx.conf</code>.</p>
  <pre><code># On the VPS
git clone your-repo.git /var/www/edupanel
cd /var/www/edupanel/backend
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt gunicorn
cp .env.example .env   # set DEBUG=False, real SECRET_KEY, ALLOWED_HOSTS, Razorpay keys
python manage.py migrate
python manage.py collectstatic --noinput</code></pre>
  <pre><code># Install systemd units
sudo cp deploy/gunicorn.service /etc/systemd/system/
sudo cp deploy/celery.service /etc/systemd/system/
sudo cp deploy/celery-beat.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now gunicorn celery celery-beat</code></pre>
  <pre><code># Configure Nginx
sudo cp deploy/nginx.conf /etc/nginx/sites-available/edupanel
sudo ln -s /etc/nginx/sites-available/edupanel /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx</code></pre>
  <p>For HTTPS, install Certbot and run <code>sudo certbot --nginx -d api.yourdomain.com</code>. Set <code>USE_CELERY=True</code> in <code>.env</code> so the daily fee reminders run through the worker and beat scheduler.</p>

  <h3>Step 9 — Razorpay Webhook</h3>
  <p>In the Razorpay dashboard, add a webhook pointing to <code>https://api.yourdomain.com/api/fees/webhook/</code>, set the same secret as <code>RAZORPAY_WEBHOOK_SECRET</code>, and subscribe to payment-captured events. The backend verifies the HMAC signature, marks the invoice paid, and sends the receipt notification.</p>

  <h3>Verifying the Deployment</h3>
  <ul>
    <li>Visit <code>https://api.yourdomain.com/api/docs/</code> and confirm Swagger loads.</li>
    <li>Log in through the dashboard and confirm the JWT refresh flow works.</li>
    <li>Run a test payment in Razorpay test mode and confirm the invoice flips to paid.</li>
  </ul>
</div>

<div class="product-description">
  <p>If you are building software for coaching institutes, tuition centers, or test-prep academies, Edupanel gives you the entire stack on day one. It is a multi-tenant SaaS platform with a Django REST backend, a Next.js admin dashboard, and a Flutter mobile app for teachers and parents. One purchase, one codebase, three working surfaces. You own all of it.</p>

  <h2>What This Product Does</h2>
  <p>Edupanel runs the full operational side of a coaching business so the institute can stop juggling spreadsheets and WhatsApp groups. Admins manage batches, students, and staff from a clean web dashboard. Teachers mark attendance and enter test marks in seconds. Parents track their child's attendance percentage, fee dues, and results from a mobile app on their phone.</p>
  <p>The platform is multi-tenant from the ground up. Every institute that signs up gets its own isolated data, and a super admin can oversee the whole network. That means you can sell it as a hosted SaaS to dozens of institutes, or deploy a single white-labeled instance for one large academy. The tenant scoping is enforced at the query layer, so an institute admin never sees another institute's data by accident.</p>
  <p>Fees are wired to Razorpay end to end. An invoice creates a Razorpay order, the parent pays from the app or dashboard, the webhook verifies the signature, marks the invoice paid, and fires a WhatsApp and SMS receipt automatically. Exam results work the same way: a teacher enters marks, hits publish, and parents get notified.</p>

  <h2>Key Features</h2>
  <ul>
    <li><strong>Multi-tenant SaaS architecture</strong> with five roles: super admin, institute admin, teacher, parent, and student, each with its own permission boundary.</li>
    <li><strong>Batch and student management</strong> with admissions, enrollments, and per-batch fee plans.</li>
    <li><strong>Attendance tracking</strong> including bulk mark-the-whole-batch in one tap and per-student status toggles.</li>
    <li><strong>Fee collection with Razorpay</strong>, online and offline payment recording, installment plans, and automated receipts.</li>
    <li><strong>Exams and results</strong> with spreadsheet-style marks entry and one-click publish that notifies parents.</li>
    <li><strong>WhatsApp and SMS notifications</strong> through a pluggable provider layer (Gupshup or MSG91), with a safe stub mode for development.</li>
    <li><strong>Parent dashboard</strong> showing attendance percentage, fee dues, and published results for their children only.</li>
    <li><strong>Teacher and parent mobile app</strong> built in Flutter from a single codebase, role-aware at login.</li>
    <li><strong>JWT authentication</strong> with automatic token refresh on the web and mobile clients.</li>
    <li><strong>Daily fee-reminder automation</strong> through Celery and Redis, with a synchronous fallback when you do not want to run a worker.</li>
    <li><strong>OpenAPI documentation</strong> built in, with Swagger UI and ReDoc out of the box.</li>
    <li><strong>Production deployment files</strong> included: Gunicorn, Nginx, and systemd units for the API, Celery worker, and beat scheduler.</li>
  </ul>

  <h2>Who This Is Built For</h2>
  <p>Edupanel is built for people who want to ship a coaching product, not start a six-month build from scratch.</p>
  <ul>
    <li><strong>Edtech founders</strong> launching a coaching or tuition SaaS who need a working multi-tenant product to sell to institutes immediately.</li>
    <li><strong>Software agencies</strong> with a coaching-institute client who want a proven base to customize and ship on a tight deadline.</li>
    <li><strong>Coaching institute owners</strong> who want their own white-labeled software for attendance, fees, and parent communication instead of paying monthly to a third-party app.</li>
    <li><strong>Solo developers and freelancers</strong> who want a strong, documented codebase to deliver client projects faster and at a higher margin.</li>
  </ul>

  <h2>Real-World Applications and Use Cases</h2>
  <p>A test-prep academy uses the web dashboard to manage twelve batches across two centers, marks daily attendance in bulk, and sends fee reminders automatically every morning. Parents check results the moment a teacher publishes them, which cuts down the front-desk phone calls dramatically.</p>
  <p>An agency white-labels Edupanel for a regional tuition chain, swaps the branding to the client's navy-and-gold theme, points it at the client's Razorpay account, and deploys it on a single VPS. The chain runs forty institutes off one super-admin login.</p>
  <p>A founder hosts Edupanel as a subscription SaaS, onboards new institutes through the institute-admin registration flow, and charges a monthly fee per institute. Because tenant isolation is built in, every customer is sandboxed on the same deployment.</p>

  <h2>Why Buy This Instead of Building It</h2>
  <p>Building a multi-tenant coaching platform with a web dashboard and a mobile app from scratch is a serious project. A capable two-person team is looking at roughly four to six months to reach the feature set Edupanel already ships with: auth, tenant scoping, attendance, Razorpay billing with webhooks, exams, notifications, a full admin dashboard, and a Flutter app. At realistic Indian dev rates that is several lakh rupees in salary or contractor cost, plus the time you lose to going to market.</p>
  <p>Edupanel skips that. You get the working codebase today, customize the parts that matter to your buyer, and ship in days instead of months. The money you save on the build goes straight into sales and customization, which is where the actual margin lives. If you need the platform tailored to a specific institute's workflow or branding, our <a href="https://startup.codeaj.com/services/customization">product customization and white-labeling service</a> can take it the rest of the way.</p>

  <h2>What You Get on Purchase</h2>
  <ul>
    <li>Full source code for all three components: the Django REST backend, the Next.js admin dashboard, and the Flutter mobile app, in one monorepo.</li>
    <li>A demo seed command that creates a sample institute with students, batches, fees, attendance, and tests so you can see the whole product working in one command.</li>
    <li>Complete setup and deployment documentation, including the step-by-step installation guide for local development and VPS deployment.</li>
    <li>Production deployment files: Gunicorn, Nginx config, and systemd units for the API and Celery services.</li>
    <li>Built-in API documentation through Swagger UI and ReDoc.</li>
  </ul>
  <p>Edupanel is part of the <a href="https://startup.codeaj.com/categories/saas-platforms">SaaS platforms collection on CodeAj Startup</a>, where we publish production-ready software for founders and agencies. If you want a quick walkthrough before buying or have a customization question, <a href="https://startup.codeaj.com/contact">reach out to the CodeAj team</a> and we will get you sorted. You can read more about the company behind it on the <a href="https://codeaj.com/about">CodeAj about page</a>.</p>
</div>

Ready-made coaching institute management system with attendance, fees, Razorpay, and a parent app. Full source code from CodeAj Startup. Launch in days.

Coaching Institute Management System | CodeAj Startup

Multi-tenant coaching institute software with attendance, fees, Razorpay, exams, and a parent + teacher mobile app. Full source code.

Complete Your Purchase

Your Details

Add-Ons

Edupanel - Coaching Institute Management System (Web + Mobile SaaS)