{"id":17442385,"url":"https://github.com/ahmedabougabal/iticafefooddeliveryapp","last_synced_at":"2026-01-23T00:28:31.977Z","repository":{"id":257998600,"uuid":"857469657","full_name":"ahmedabougabal/ITICafeFoodDeliveryApp","owner":"ahmedabougabal","description":"Hey Folks, so sad to say this but this is our final ITI graduation project, we wanted to leave bright foot prints on our graduation, we wanted to solve a real life problem we faced inside our respected institution , we decided to build a robust scalable web app to order food and help every student save huge time instead of waiting in stacked queues","archived":false,"fork":false,"pushed_at":"2024-10-19T09:22:55.000Z","size":58504,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-19T14:06:26.258Z","etag":null,"topics":["bashrc","database","django","full-stack-web-development","pycharm-ide","python3","scalability","testing","zsh"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahmedabougabal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-14T18:36:40.000Z","updated_at":"2024-10-19T09:22:59.000Z","dependencies_parsed_at":"2024-10-21T02:38:59.394Z","dependency_job_id":null,"html_url":"https://github.com/ahmedabougabal/ITICafeFoodDeliveryApp","commit_stats":null,"previous_names":["ahmedabougabal/iticafefooddeliveryapp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedabougabal%2FITICafeFoodDeliveryApp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedabougabal%2FITICafeFoodDeliveryApp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedabougabal%2FITICafeFoodDeliveryApp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedabougabal%2FITICafeFoodDeliveryApp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmedabougabal","download_url":"https://codeload.github.com/ahmedabougabal/ITICafeFoodDeliveryApp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249685193,"owners_count":21310564,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bashrc","database","django","full-stack-web-development","pycharm-ide","python3","scalability","testing","zsh"],"created_at":"2024-10-17T16:05:40.334Z","updated_at":"2026-01-23T00:28:31.959Z","avatar_url":"https://github.com/ahmedabougabal.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 👨‍💻 ITI Cafe Food Delivery/Ordering App - ITI Graduation Project [![Project Status](https://img.shields.io/badge/status-Complete-green)](https://github.com/yourusername/mernStackMilestoneProject_ITI)  [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)\n\nHellllloooooooooooooooooooo Folks! 👋\n\nIt's bittersweet to announce that this is our **final ITI graduation project**, but we are excited to share what we've built! 🎓✨ We wanted to leave a lasting impression and solve a real-life problem we encountered within our beloved institution, refer to the repo's description :D\n\n### Watch the Project Overview:\n[![Watch the video](https://img.shields.io/badge/Project%20Overview%20-%20Watch%20Now-blue?style=for-the-badge)](https://www.linkedin.com/posts/ahmed-abou-gabal_iti-activity-7255345194940702721-e9fV?utm_source=share\u0026utm_medium=member_desktop)\n\n---\n\n### Getting Started Guide 🚀\n\nWant to set up and run the project locally? Follow the detailed video guide to:\n\n- Start the Django server\n- Configure ports and WebSocket\n- Set up the database\n- Run migrations to fully initiate the project\n\n[![Watch the video](https://img.shields.io/badge/How%20to%20Start%20the%20Project-%20Watch%20Guide-brightgreen?style=for-the-badge)](https://drive.google.com/drive/folders/186V46_CallClqvyiAJqjni6_HRzmtDKW?usp=sharing)\n\n\n## 🎯 What actually is the Problem?\n\nStudents at our institution regularly face:\n- Long wait times in crowded queues\n- Valuable time lost from their busy academic schedules\n- Inefficient food ordering processes\n\n## 💡 How we came up with a Solution?\n\nWe developed a robust a web application that fully streamlines the whole food ordering process powered by a beautiful react frontend and django for the backend . \n\n\n\n\n\n\n\n# ITI Café Order System\n\n## Core Architecture \u0026 Administrative Capabilities\n\nOur project, a sophisticated and scalable **Café Order System**, is a true testament to the power of teamwork and modern web development. Built by a **dedicated team of 5 ITI developers**, this solution has been endorsed by **ITI's open source leaders, Eng. Cherry and Eng. Mina Nagy**, recognizing its potential for freelancing and real-world applications.\n\nThe **admin panel** is the cornerstone of this system, providing a **robust**, **elegant**, and **crispy** interface that ensures seamless management. This project was executed through **intensive meeting plans**, **late-night coding sessions**, and adherence to **Agile working methodologies**, supported by **JIRA** for task management, tracking, and deadline compliance.\n\n### Sales Statistics Functionality\nOne of the system's standout features is its **Sales Statistics** functionality, powered by **Python-written MySQL queries** that dynamically feed the backend data into the front-end to generate actionable insights. Key metrics visualized through our **interactive design** include:\n- **Daily sales totals** in real-time\n- **Rolling 7-day performance analytics**\n- **30-day comprehensive reports**\n- **Top customer rankings** and their purchases\n- **Most popular item analytics**\n\nThis functionality is presented through a polished, **sophisticated interface**, underscoring the professional finesse and attention to detail that went into the project. Every chart and metric is crafted to display vital business insights effortlessly.\n\n---\n\n## Revolutionary Order Management Workflow\n\nThe **order management system** is another hallmark of our project, built to optimize efficiency and deliver an intuitive, **breathtaking user experience**. The process operates in three seamless phases:\n\n### 1. Pending Orders Phase\nWhen a customer places an order through the visually stunning **client-side interface**, it lands in the **Pending Orders** section of the **admin panel**. Chiefs can:\n- **Accept** or **reject** orders, with every action triggering an immediate, automated notification:\n  - **Email alerts** sent directly to the customer\n  - **Real-time updates** in the user’s **notification center**\n\n### 2. Active Preparation Phase\nOnce accepted, orders enter the **Active Preparation Phase**, where our system incorporates:\n- **Real-time tracking** of the order's preparation\n- **Crisp visual countdown timers** in both the customer and admin interfaces\n- **Red-flag alerts** for orders exceeding preparation times\n- **Interactive progress bars** that display the order's status to the customer in real-time\n\n### 3. Completion Phase\nIn the **Completion Phase**, the order lifecycle is finalized with:\n- **Payment verification** for cash transactions, handled by the admin\n- **Automated status updates** reflected in the user’s **order history**\n- **Real-time synchronization** of payment statuses to ensure clarity and ease for both the user and the admin.\n\n---\n\n## Technical Innovation \u0026 User Experience\n\nOur platform stands as a **masterpiece of technology and design**, balancing cutting-edge functionality with an elegant user experience. Every feature was reviewed and refined through **intensive team meetings**, following strict **deadlines** and **timeframes** to ensure everything functioned as smoothly as possible. Additionally, we utilized **Git** and **GitHub** extensively for version control, navigating **intensive conflict resolution sessions** to ensure collaboration without disruption.\n\n### Multi-Branch Architecture\nThe system supports a **multi-branch structure**, allowing users to switch between **ITI branches** based on location without needing to log out. Each branch offers a unique menu and is managed independently, ensuring a customized user experience.\n\n### Real-Time Communication Hub\nOur **real-time communication hub** is built on a powerful **WebSocket integration**, enabling:\n- **Instant chat functionality** between customers and staff\n- **Live order updates** for both the customer and admin\n- An integrated **notification system** that seamlessly relays important updates\n\n### Payment Processing\nWe have implemented a **dual-payment system** that includes:\n- **PayPal integration** for digital transactions\n- **Cash payment tracking and verification**, ensuring smooth order processing\n- **Real-time payment status updates** visible to both customers and admins\n\n### Mobile-First Design\nThe entire platform follows **mobile-first design principles**, ensuring:\n- A **responsive, elegant experience** on mobile devices\n- Seamless functionality across all device types, with an **optimized touch interface**\n\n### Polling System Architecture\nOur system also employs a sophisticated **polling architecture**, ensuring:\n- Continuous **real-time order status monitoring**\n- **Automated notifications** dispatched promptly to users\n- **Dashboard updates** for both customers and admins, ensuring they always have the most up-to-date information\n\n---\n\n## Seamless Collaboration and Teamwork\n\nThis project reflects the strength of **collaborative development**. Throughout the project, our team followed **Agile methodologies**, with careful planning in **JIRA** for task tracking and deadline management. We utilized **Git** and **GitHub** for robust version control, ensuring smooth collaboration even during complex phases where we faced significant **merge conflicts**, all of which were handled with precision and expertise.\n\n---\n\n## Final Remarks\n\nThrough **dedicated collaboration**, **late-night coding**, and **extensive review cycles** with our supervisor, we've delivered a project that is more than just a collection of features—it's a **cohesive, professional-grade solution**. Designed for **scalability** and **configurability**, this system is ready to adapt to any business model while ensuring an exceptional user experience.\n\nBuilt on the latest tech stacks and following modern best practices, this project is a shining example of what can be achieved through **cutting-edge technology**, **thoughtful design**, and **teamwork**. It stands as a benchmark in professional web development and a proud testament to the skill and dedication of our team.\n\n\n\n## 🛠️ Tech Stack\nWe have chosen a **robust and scalable tech stack** to ensure our app runs smoothly and efficiently:\n\n- **Backend**: [Python](https://www.python.org/) / [Django](https://www.djangoproject.com/) / [TypeScript](https://www.typescriptlang.org/)\n- **Database**: [PostgreSQL](https://www.postgresql.org/) / [Redis](https://redis.io/)\n- **Package Management**: [Pipenv](https://pipenv.pypa.io/en/latest/)\n- **Frontend**: [React](https://react.dev/) / [TailWind](https://v2.tailwindcss.com/docs) / [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript)\n- **Deployment**: Coming soon!\n\n## 📊 Repository Stats\n![GitHub repo size](https://img.shields.io/github/repo-size/ahmedabougabal/ITICafeFoodDeliveryApp)\n![GitHub contributors](https://img.shields.io/github/contributors/ahmedabougabal/ITICafeFoodDeliveryApp)\n![GitHub last commit](https://img.shields.io/github/last-commit/ahmedabougabal/ITICafeFoodDeliveryApp)\n![GitHub forks](https://img.shields.io/github/forks/ahmedabougabal/ITICafeFoodDeliveryApp?style=social)\n\n## 🧩 Setup \u0026 Installation   **Update: a video will be released demostrating how to fully install the project on your ubuntu machine. Coming Soon!!**\n\nTo get started with the project, you'll need **Pipenv** as the primary tool for managing dependencies and the virtual environment.\n\n### Prerequisites:\n- Python 3.8+\n- PostgreSQL\n\n### Installation Steps:\n1. Clone the repository:\n    ```bash\n    git clone https://github.com/ahmedabougabal/ITICafeFoodDeliveryApp.git\n    cd ITICafeFoodDeliveryApp\n    ```\n\n2. Set up the virtual environment using `pipenv`:\n    ```bash\n    pipenv install\n    ```\n\n3. Apply the migrations to set up the database:\n    ```bash\n    python manage.py migrate\n    ```\n\n4. Run the development server:\n    ```bash\n    python manage.py runserver\n    ```\n\nYou're all set! 🎉\n\n## 📈 Project Stats\n\n| Contributors               | Last Update | Views |\n|----------------------------|-------------|-------|\n| ![Contributors](https://img.shields.io/github/contributors/ahmedabougabal/ITICafeFoodDeliveryApp) | ![Last Commit](https://img.shields.io/github/last-commit/ahmedabougabal/ITICafeFoodDeliveryApp) | ![Repo View](https://komarev.com/ghpvc/?username=ahmedabougabal\u0026style=flat-square) |\n\n## 👥 Collaborators\n- [Ahmed Abou Gabal](https://github.com/ahmedabougabal) - **Collaborator**\n- [KareemMMorsy](https://github.com/KareemMMorsy) - **Collaborator**\n- [Mahmoud Wafi](https://github.com/Mahmoud-Wafi) - **Collaborator**\n- [MoatazSobhy](https://github.com/MoatazSobhy) - **Collaborator**\n- [AhmedFadl](https://github.com/ahmedootta) - **Collaborator**\n\n\n## 🔗 Useful Links\n- [Python Docs](https://docs.python.org/3/)\n- [Django Docs](https://docs.djangoproject.com/en/stable/)\n- [Pipenv Docs](https://pipenv.pypa.io/en/latest/)\n- [PostgreSQL Docs](https://www.postgresql.org/docs/)\n\n## 🙏 Acknowledgements\nWe thank **ITI** for the wonderful journey, and our instructors for their constant guidance. This project is a small contribution to the learning experiences we’ve had.\n\n---\n\n\u003e \"If it is easy, leave it to somebody else.\" – **Abou Gabal**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmedabougabal%2Fiticafefooddeliveryapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmedabougabal%2Fiticafefooddeliveryapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmedabougabal%2Fiticafefooddeliveryapp/lists"}