epas-phase-2

Automated Event Planner and Approval System - Phase 2

Executive Summary

This project aims to digitize institutional workflows at JNU Jaipur, replacing outdated paper-based approvals with a transparent, efficient digital system (referencing Section 3.2 of the project synopsis). This Phase 2 repository implements the core Event Submission Interface and the basic workflow logic, serving as the foundational module of the platform.

Phase 2 Scope

This repository specifically contains the Basic Event Submission Workflow. It includes:

• A comprehensive multi-section event form.
• Robust server-side validation.
• In-memory/SQLite storage logic for local testing.
• The foundational database schema ready for Supabase production migration. Note: Authentication (Phase 3) is prepared conceptually but is not yet strictly enforced in this specific build.

Tech Stack

• Backend Framework: Python 3.8+, Flask 2.x
• Templating: Jinja2
• Database/ORM: SQLAlchemy
• Frontend: HTML5, CSS3, JavaScript
• Production Server: Gunicorn

Installation Guide

Follow these step-by-step instructions to set up the project locally:

1. Clone the repository:

   git clone https://github.com/CyberSential22/epas-phase-2.git
   cd epas-phase-2
   

2. Set up a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

4. Environment Variables: Create a .env file in the root directory and add the following:

   SECRET_KEY=your_secret_key
   FLASK_ENV=development
   

5. Run the application locally:

   python run.py
   

   The application will be accessible at http://127.0.0.1:5000/.

Project Structure

epas-phase-2/
├── app/
│   ├── blueprints/    # Application modules (main, events)
│   ├── forms/         # WTForms definitions
│   ├── models/        # SQLAlchemy database models
│   ├── routes/        # Blueprint routing
│   ├── static/        # CSS, JS, Images
│   ├── templates/     # Jinja2 HTML templates
│   ├── utils/         # Helper functions (e.g., ip_utils)
│   ├── config.py      # App configurations
│   ├── errors.py      # Global error handlers
│   └── __init__.py    # App factory function
├── instance/          # Local database files
├── logs/              # Application logs
├── venv/              # Python virtual environment
├── .gitignore         # Untracked files configuration
├── requirements.txt   # Project dependencies
├── run.py             # Entry point for the application
└── vercel.json        # Vercel proxy configuration

Deployment Overview

The final production architecture is designed to be highly accessible and resilient:

• Vercel: Frontend proxy to manage global routing.
• Render: Backend hosting for the Python Flask application using Gunicorn.
• Supabase: PostgreSQL database for secure, scalable data storage.

Acknowledgments

• Project Team: Kashif Shaikh, Aditya Gond, Yaduvansh Singh Ranawat (JNU Jaipur)
• Project Guide: Ms. Saumya
• AI Ethics: This project adheres to Section 6.5 of the project report regarding the ethical use of AI-assisted tools for research and debugging, maintaining full student ownership of core design and business logic.

License

This project is licensed under the MIT License.