EduPortal is not just another management system; it is an Intelligent Academic Operating System. Built with a modern, high-performance stack (Flask + TailwindCSS), it bridges the gap between Administration, Faculty, and Students through a seamless, responsive, and data-driven interface.
It features AI-powered analytics, automated scheduling algorithms, and a robust permission system, all wrapped in a premium, glassmorphism-inspired UI.
- AI-Driven Insights: Dashboard with predictive analytics for Student Retention (Truancy Risk) and Faculty Performance archetypes.
- Automated Scheduling: One-click Timetable Generation using a greedy constraint-satisfaction algorithm. Avoids conflicts automatically.
- Examination Lifecycle: Manage Exam Events, Schedule Papers, and auto-generate Result Matrices (CSV) for thousands of students.
- Targeted Announcements: Send notices to the entire university, specific courses, or individual faculty members.
- Batch Operations: Mark attendance for 60+ students in seconds using our "Sticky Form" batch interface.
- Result Entry: Rapid-fire marks entry system with auto-validation and "Fail" flagging (Marks < 33%).
- Mentorship Hub: Dedicated dashboard to track and edit profiles for assigned mentees.
- Smart Attendance: Visual indicators for low-attendance students directly in the marking view.
- Live Dashboard: Real-time SPI (Semester Performance Index) calculation and Attendance percentages.
- Bunk Recovery Calculator: "You need to attend next 5 classes to reach 75%."
- Digital Services: Apply for Scholarships, Register for Events, and Pay Fees online (simulated gateway).
- Ticket System: Direct query channel to faculty for academic doubts.
We believe code should be self-documenting, but we documented it anyway— in extreme detail.
- Architecture & Design: The masterplan, user personas, and system vision.
- Database Schema: Full ER Diagram and relationship details.
- Deployment Guide: Production setup updates.
- AI & Analytics Engine: How we predict careers and classify faculty.
- Scheduler Algorithm: The logic behind the timetable generator.
- Grading Logic: Breakdowns of SPI, CGPA, and Attendance Recovery formulas.
- Exam System: How dynamic result CSVs are built.
- Core Models: Deep dive into the
Course,Subject, andAttendancetables.
- Python 3.8+
- Node.js (for TailwindCSS compilation)
- PostgreSQL
Backend Setup
# Clone the repo
git clone https://github.com/your-org/edu-portal.git
cd EDU-PORTAL
# Create Virtual Env
python -m venv .venv
# Windows: .venv\Scripts\activate
# Mac/Linux: source .venv/bin/activate
# Install Deps
pip install -r requirements.txtFrontend Setup
npm install- Copy
.env.exampleto.env. - Update your Database credentials.
- Run the Seeder to populate the DB with realistic test data:
python manage.py seed
You need two terminals:
Terminal 1 (CSS Compiler)
npm run devTerminal 2 (Flask Server)
flask runVisit: http://127.0.0.1:5000
- Framework: Flask (Blueprints architecture)
- ORM: SQLAlchemy (Relational mapping)
- Auth: Flask-Login (RBAC: Admin, Faculty, Student)
- Exports: Python CSV, ReportLab (PDFs)
- Styling: TailwindCSS v3 (Utility-first)
- Components: Jinja2 Templates (Server-Side Rendering)
- Charts: Chart.js (Data Visualization)
- Icons: FontAwesome & HeroIcons
| Role | Password | |
|---|---|---|
| Admin | admin@edu.com |
123 |
| Faculty | faculty1@edu.com |
123 |
| Student | student1@edu.com |
123 |
Made with ❤️ by the EduPortal Team.