moxer-mmh/Tweeza

Tweeza is a donation and resource sharing platform designed to connect donors, organizations, and beneficiaries in Algeria. By leveraging cutting-edge technology, Tweeza aims to combat food waste, optimize resource allocation, and improve humanitarian aid distribution # Tweeza **Empowering Community Solidarity & Volunteerism** Tweeza is a donation and resource sharing platform designed to connect donors, organizations, and beneficiaries in Algeria. By leveraging cutting-edge technology, Tweeza aims to combat food waste, optimize resource allocation, and improve humanitarian aid distribution—empowering community solidarity and volunteerism. This repository contains the complete source code for both the backend and frontend components developed for the Djezzy Code Fest hackathon. --- ## Table of Contents - Tweeza - Table of Contents - Overview - Architecture - Technical Documentation - Backend Architecture - Frontend Architecture - Features - Technologies - Installation - Backend Setup - Frontend Setup - Docker - Usage - Testing - Backend Testing - Contributing - License --- ## Overview Tweeza is a comprehensive platform that: * **Tracks Donations:** Securely handles user registration, authentication (JWT, OAuth, and two-factor authentication), and donation management. * **Manages Resources:** Facilitates the creation and tracking of resource requests, contributions, and allocation optimization. * **Coordinates Volunteers:** Supports volunteer registration and management, event creation, and real-time notifications. * **Optimizes Distribution:** Implements smart resource allocation algorithms to prioritize urgent needs and minimize waste. The platform is tailored to Algeria's unique context, with localization for Arabic, French, and English, and optimization for areas with limited connectivity. --- ## Architecture ### Technical Documentation Check : Technical Documentation ### Backend Architecture The backend is built with FastAPI and SQLAlchemy, following a layered architecture: ``` Client Layer → API Layer → Service Layer → Data Access Layer → Database Layer ``` Key components: * **FastAPI Application:** High-performance API server. * **SQLAlchemy ORM:** For database operations. * **SQLite Database:** Used dur …