This repository contains the code for a web application that allows NMIMS students to easily check their latest attendance records. The application fetches attendance data from the SVKM portal and displays it in a user-friendly format.
This web application has been hosted on Cloudflare Pages and Vercel for easy access.
Note: This project is for educational purposes only. Use it responsibly and at your own risk.
Try it out: https://report.adith.tech
- Fetches up to date attendance data from the SVKM portal.
- Displays attendance summary with subject-wise breakdown and graphical representation.
- Encrypts user credentials before sending them to the backend.
- Does not store user credentials or attendance data. Logs user agent only for debugging purposes.
- Simple and easy-to-use interface.
-
Frontend:
- The frontend is a simple HTML page with a form for user input (SAP ID and password).
- It uses JavaScript to handle user interaction and display the attendance data.
- Cloudflare Turnstile is used to prevent automated requests.
-
Backend:
- The backend is a Flask application that handles the requests from the frontend.
- It uses the
requests
library to fetch data from the SVKM portal. - User credentials are encrypted using RSA encryption before being sent to the portal.
- The
BeautifulSoup
library is used to parse the HTML content and extract the attendance data. - The attendance data is then processed and returned to the frontend in JSON format.
-
Clone the repository:
git clone https://github.com/ItsSpirax/MPSTME-Attendance-Report
-
Install the required packages:
pip install -r requirements.txt
-
Set up environment variables:
- Create a
.env
file in the backend directory. - Add your Cloudflare Turnstile Secret and Logging URL to the
.env
file:
TURNSTILE_SECRET = your_turnstile_secret WEBSITE_URL = your_website_url LOGGING_URL = your_logging_url
- Create a
-
Run the backend:
flask --app main.py run
-
Deploy the frontend:
- The frontend can be deployed to any web server.
- Go to the deployed frontend URL.
- Enter your SAP ID and portal password.
- Click on the "Get Attendance" button.
- Your attendance report will be displayed.
- This project is not affiliated with SVKM or MPSTME in any way.
- I am not responsible for any misuse of this application.
- Use this application at your own risk.
Contributions are welcome! Feel free to open issues and pull requests.
This project is licensed under the GPL 3.0 License - see the LICENSE file for details.