Iftar Platform (منصة إفطار)

A national system to register, manage and permit Iftar initiatives across cities. Owners publish initiatives and locations, Organizers request permits to host events, and the Government (Admin) reviews and issues time-limited permits (PDF + QR verification).

Highlights

• Role-based platform with Owner, Organizer and Government (Admin) personas.
• Owners create and manage Iftar initiatives (locations, capacity, schedules).
• Organizers browse initiatives and submit permit requests for events.
• Admin workflows for reviewing and approving/rejecting initiatives and permits.
• PDF permit generation with QR codes and time-limited validation.

Screenshots

Key Features

• Authentication and role management (Owner, Organizer, Government).
• Initiative creation & listing with filtering by city and status.
• Permit request flow with approval/rejection by Admin.
• Permit PDF generation and QR-based verification.
• Time-limited permits and permit status tracking.
• Responsive UI using Bootstrap 5.

Tech Stack

• Django (backend)
• Python
• Bootstrap 5 (frontend)
• SQLite (development)
• ReportLab / qrcode (PDF & QR generation)

Getting Started

Prerequisites

• Python 3.x
• A virtual environment tool (venv or similar)

Install

cd IftarPlatform
python -m venv .venv
source .venv/Scripts/activate
pip install -r requirements.txt

Environment variables

• Create an .env (or set system env vars) for values used in IftarPlatform/settings.py, for example:
  • SECRET_KEY
  • DEBUG
  • DATABASE settings (if not using the default sqlite)

Run locally

cd IftarPlatform
python manage.py migrate
python manage.py runserver

Project Structure

• IftarPlatform/: Django project settings and WSGI/ASGI entry points.
• accounts/: authentication, profiles, and role management.
• initiatives/: initiative models, views and templates for owners.
• permits/: permit requests, PDF/QR generation and admin workflows.
• main/: public pages, landing and shared templates/assets.
• media/: uploaded avatars, permit PDFs and QR images.

User Roles

• Owner — register initiatives and manage their content.
• Organizer — browse initiatives and request permits to host events.
• Government (Admin) — review incoming initiatives and permits, approve/reject and issue official permits.

Journey Summary

• Owner: sign up → create initiative → manage initiative.
• Organizer: discover initiative → request permit → receive PDF + QR on approval.
• Admin: review submissions → approve/reject → issue time-limited permit.