{"id":25972266,"url":"https://github.com/domenez-dev/event-checkins-app","last_synced_at":"2025-06-17T01:32:42.625Z","repository":{"id":278745912,"uuid":"899585056","full_name":"Domenez-dev/event-checkins-app","owner":"Domenez-dev","description":"A full-stack event check-ins app built with Django (backend) and React Native/Flutter (frontend).","archived":false,"fork":false,"pushed_at":"2025-03-04T12:47:08.000Z","size":677,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-05T00:34:09.602Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/Domenez-dev.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-12-06T15:14:24.000Z","updated_at":"2025-02-21T12:40:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"1fbe65db-3101-403f-8c43-3f05b57ab679","html_url":"https://github.com/Domenez-dev/event-checkins-app","commit_stats":null,"previous_names":["domenez-dev/event-checkins-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Domenez-dev/event-checkins-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Domenez-dev%2Fevent-checkins-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Domenez-dev%2Fevent-checkins-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Domenez-dev%2Fevent-checkins-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Domenez-dev%2Fevent-checkins-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Domenez-dev","download_url":"https://codeload.github.com/Domenez-dev/event-checkins-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Domenez-dev%2Fevent-checkins-app/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260271998,"owners_count":22984211,"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":[],"created_at":"2025-03-05T00:32:53.768Z","updated_at":"2025-06-17T01:32:42.613Z","avatar_url":"https://github.com/Domenez-dev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Event Check-ins App\n\n![React Native](https://img.shields.io/badge/Frontend-React%20Native-blue?style=flat-square\u0026logo=react) ![Django](https://img.shields.io/badge/Backend-Django-green?style=flat-square\u0026logo=django) ![PostgreSQL](https://img.shields.io/badge/Database-PostgreSQL-blue?style=flat-square\u0026logo=postgresql) ![Static Badge](https://img.shields.io/badge/Status-uncomplete-red?style=flat-square)\n\n## 🚀 Overview\n\nThis **Event Check-ins App** is a full-stack application built with **Django** and **React Native**. Designed for efficient event management, it enables organizers to:\n\n- Create events 🗓️\n- Generate and send participant QR codes 📧\n- Manage check-ins via QR code scanning ✅\n\nDeveloped as part of a **Google Developer Group (GDG) Club Algiers challenge**, it showcases full-stack development skills, including API creation, mobile app development, and deployment.\n\n---\n\n## 🎯 Features\n\n### 🔐 Authentication\n- **Admins**: Create and manage events.\n- **Organizers**: Scan QR codes to check in participants.\n\n### 🗓️ Event Management\n- Admins can create events.\n- Participants receive personalized emails with their unique QR codes and event details.\n\n### 📲 QR Code Check-ins\n- Organizers scan QR codes for instant participant check-ins.\n- Secure backend validation ensures smooth operation.\n\n### 📧 Email Notifications\n- Automated emails sent via **Gmail API** using OAuth2, containing QR codes and event information.\n\n### 🌐 Deployment\n- Backend hosted on **Render** with a **PostgreSQL** database.\n- Mobile app built with **React Native**.\n\n---\n\n## 🛠️ Tech Stack\n\n### **Backend**\n- ![Django](https://img.shields.io/badge/-Django-092E20?style=flat-square\u0026logo=django\u0026logoColor=white)\n- PostgreSQL\n- Gmail API (OAuth2 for secure email integration)\n- Django REST Framework\n\n### **Frontend**\n- ![React Native](https://img.shields.io/badge/-React%20Native-61DAFB?style=flat-square\u0026logo=react\u0026logoColor=black)\n\n### **Tools**\n- Postman for API testing\n- Render for deployment\n- OAuth2 for secure authentication\n\n---\n\n## 📂 Project Documentation\n\nCheck out the [📚 Official Docs](https://domenez-dev.gitbook.io/event-checkins-app) for complete details!\n\n---\n\n## 🛠️ Setup Instructions\n\n### Prerequisites\n- Python 3.x\n- Node.js and npm (for React Native)\n- PostgreSQL (database)\n- Google Cloud account (for Gmail API OAuth2 credentials)\n\n### Backend Setup\n\n1. Clone the repository:\n    ```bash\n    git clone https://github.com/domenez-dev/event-checkins-app.git\n    cd event-checkins-app\n    ```\n\n2. Install dependencies:\n    ```bash\n    cd backend/checkins-backend\n    pip install -r requirements.txt\n    ```\n\n3. Copy the environment variables from the .env.example file\n    ```bash\n    mv ../backend/.env.example .env\n    ```\n\n4. Apply migrations:\n    ```bash\n    python manage.py migrate\n    ```\n\n5. Run the server:\n    ```bash\n    python manage.py runserver\n    ```\n\n### Frontend Setup\n\n1. Navigate to the frontend directory:\n    ```bash\n    cd frontend\n    ```\n\n2. Install dependencies:\n    ```bash\n    npm install\n    ```\n\n3. Start the development server:\n    ```bash\n    npm start\n    ```\n\n4. Use Expo or a device emulator to run the app.\n\n---\n\n## 🧪 Testing the API\n\nUse **Postman** to test the API endpoints. Import the Postman collection from `docs/API-Documentation.json` and try endpoints like:\n\n- Create participant (`POST /api/participants/`)\n- Create event (`POST /api/events/`)\n- Check-in QR code (`POST /api/checkins/`)\n\n---\n\n## 🚀 Deployment\n\n1. Push your code to GitHub.\n2. On Render, set up:\n    - **Web Service** for the Django backend.\n    - **Database** for PostgreSQL.\n3. Add environment variables for database and Gmail API credentials.\n\nYour app is now live 🎉!\n\n---\n\n## 👥 Contributors\nAbdou2425\nbeskie04\nfbben\n\n### gdg Developers Integrating Program for 2024/2025 Team Dev 6:\n\n|\u003cimg src=\"https://avatars.githubusercontent.com/domenez-dev\" width=\"140\"\u003e|\u003cimg src=\"https://avatars.githubusercontent.com/Abdou2425\" width=\"140\"\u003e|\u003cimg src=\"https://avatars.githubusercontent.com/beskie04\" width=\"140\"\u003e|\u003cimg src=\"https://avatars.githubusercontent.com/fbben\" width=\"140\"\u003e\n|:---------------------------------------------------:|:---------------------------------------------------:|:---------------------------------------------------:|:---------------------------------------------------:|\n| [**Bouzara Zakaria**](https://github.com/domenez-dev) | [**Abed Abderrahmane**](https://github.com/Abdou2425) | [**bachferrag bouchra**](https://github.com/beskie04) | [**Fares Benziada**](https://github.com/fbben) |\n\n### gdg mentors and co-managers:\n\n\n|\u003cimg src=\"https://avatars.githubusercontent.com/Ayyoub-Kasmi\" width=\"140\"\u003e|\u003cimg src=\"https://avatars.githubusercontent.com/FaresMezenner\" width=\"140\"\u003e|\u003cimg src=\"https://avatars.githubusercontent.com/Ninou01\" width=\"140\"\u003e|\u003cimg src=\"https://avatars.githubusercontent.com/zcybrgd\" width=\"140\"\u003e|\u003cimg src=\"https://avatars.githubusercontent.com/ar-ilyes\" width=\"140\"\u003e|\u003cimg src=\"https://avatars.githubusercontent.com/NaDdjg\" width=\"140\"\u003e|\n|:---------------------------------------------------:|:---------------------------------------------------:|:---------------------------------------------------:|:---------------------------------------------------:|:---------------------------------------------------:|:---------------------------------------------------:|\n| [**Ayyoub Kasmi**](https://github.com/Ayyoub-Kasmi) | [**Fares Mezenner**](https://github.com/FaresMezenner) | [**Derdouche Abdelghani**](https://github.com/Ninou01) | [**Zaïneb Boukhetala:**](https://github.com/zcybrgd) | [**ar-ilyes:**](https://github.com/ar-ilyes) | [**Nada Djedjig:**](https://github.com/NaDdjg) |\n\n---\n\n## 📜 License\n\nThe app was created for **educational purposes** as part of a **challenge from the Google Developer Group (GDG) Club Algiers**. It demonstrates practical skills in full-stack development, including backend API creation, frontend mobile app development, and deployment.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomenez-dev%2Fevent-checkins-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdomenez-dev%2Fevent-checkins-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomenez-dev%2Fevent-checkins-app/lists"}