MOMEN186/Egypt-Aid

# Egypt-Aid Egypt-Aid is a backend system built with **Django Rest Framework (DRF)** to manage and organize aid distribution for underprivileged villages in Egypt. The platform helps NGOs, volunteers, and government bodies streamline data collection, aid requests, and distribution tracking. ## Features * User authentication & role-based access (Admin, Volunteer, Organization). * CRUD APIs for villages, households, and aid requests. * Tracking of aid distribution (financial, medical, food, etc.). * Real-time data on beneficiaries and resource allocation. * Integration-ready REST APIs for mobile or web frontends. ## Tech Stack * **Backend:** Django, Django Rest Framework * **Database:** PostgreSQL (hosted on Neon) * **Authentication:** JWT-based authentication * **Deployment:** Vercel + Docker (for production builds) ## Live Deployment * **API Base URL:** `egypt-aid.vercel.app` ## Installation (Local Setup) 1. Clone the repository: ```bash git clone github.com cd egypt-aid ``` 2. Create a virtual environment and activate it: ```bash python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate ``` 3. Install dependencies: ```bash pip install -r requirements.txt ``` 4. Set up environment variables in a `.env` file: ```env SECRET_KEY=your-secret-key DEBUG=True DATABASE_URL=postgres:// : @ / ``` 5. Run migrations: ```bash python manage.py migrate ``` 6. Start the development server: ```bash python manage.py runserver ``` ## API Endpoints ### Authentication * `POST /api/auth/register/` – Register a new user * `POST /api/auth/login/` – Login and get JWT token ### Villages * `GET /api/villages/` – List all villages * `POST /api/villages/` – Add a village (Admin only) ### Households * `GET /api/households/` – List households in a village * `POST /api/households/` – Add a household ### Aid Requests * `GET /api/aid-requests/` – List aid requests * `POST /api/aid-requests/` – Subm …