Ranim-alouii/tunisia-national-parks-api

RESTful API about Tunisian national parks, fauna, flora and emergencies using FastAPI # 🌿 Tunisia National Parks Platform **A comprehensive full-stack platform for Tunisia's national parks and protected areas, featuring biodiversity data, interactive maps, weather integration, and environmental monitoring.** **🚀 Production Ready - Deployed on Port 8000** ## 🌟 Overview This production-ready platform provides comprehensive access to Tunisia's national parks ecosystem, combining a REST API with a complete web frontend. Key features include: - **🏞️ Complete Park Database**: Detailed information on 18+ national parks and protected areas - **🦌 Biodiversity Management**: 250+ species of wildlife and plants with conservation status - **🗺️ Interactive Mapping**: OpenStreetMap integration with location services - **🌤️ Weather Integration**: Real-time weather data and forecasts for all park locations - **📸 Media Management**: Nature photography from Unsplash API with upload capabilities - **📰 Content Integration**: Environmental news and conservation updates - **⭐ User Engagement**: Reviews, ratings, and community features - **🎖️ Gamification**: Achievement system with badges and user statistics - **🔍 Advanced Search**: Multi-criteria filtering and search functionality - **🌐 Internationalization**: Multi-language support (French, English, Arabic) ## 🏗️ Architecture ``` tunisia-parks-api/ ├── 🐍 main.py # FastAPI application & routes ├── 🗄️ models.py # SQLAlchemy models ├── ⚙️ config.py # Environment configuration ├── 🗺️ routers/ # API route handlers │ ├── parks.py # Park management │ ├── species.py # Species & biodiversity │ └── auth.py # Authentication ├── 🌐 templates/ # Jinja2 HTML templates │ ├── base.html # Base template │ ├── index.html # Homepage │ ├── parks.html # Parks listing │ ├── park_detail.html # Park detail page │ ├── custom_docs.html # Enhanced API docs │ └── map.html …