ahmed0ty/Pharaoh-s_Guide_Backend

🏺 AI-powered Egyptian tourist companion. Get personalized itineraries, hear immersive historical stories, and identify monuments via camera. Explore Egypt like never before. 🇪🇬✨ | Python · Flask · Claude AI # 🏺 Pharaoh's Guide — Backend **Your AI-powered gateway to ancient Egypt 🇪🇬** --- ## 📖 About **Pharaoh's Guide** is an intelligent AI-powered tourist companion that transforms how visitors experience Egypt's ancient wonders. > *"You now stand before the temple where Ramses II declared his eternal glory…"* 🎬 Instead of boring info dumps, Pharaoh's Guide delivers **immersive AI storytelling**, **personalized itineraries**, and **real-time monument recognition** — making every tourist feel like the hero of their own historical adventure. --- ## ✨ Features | Feature | Description | |---|---| | 🗺️ **Smart Trip Planner** | Personalized day-by-day plans based on days, budget & interests | | 🤖 **AI Storytelling** | Immersive narratives powered by Google Gemini & OpenAI | | 📸 **Monument Recognition** | Upload a photo and get the full story of any landmark | | 💬 **Real-time Chat** | Live communication via Socket.io | | ❤️ **Favorites** | Save and manage your favorite places | | 👤 **User Profiles** | Full auth system with JWT | --- ## 🛠️ Tech Stack | Layer | Technology | |---|---| | **Runtime** | Node.js | | **Framework** | Express.js | | **Database** | MongoDB + Mongoose | | **AI Engine** | Google Generative AI (Gemini) + OpenAI | | **Auth** | JWT + bcryptjs | | **Image Upload** | Cloudinary + Multer | | **Real-time** | Socket.io | | **Caching** | Redis (ioredis) | | **Containerization** | Docker + Docker Compose | | **Testing** | Jest | | **Validation** | Zod | | **Security** | Helmet + Rate Limiting | | **API Docs** | Swagger / OpenAPI 3.0 | --- ## 🔒 Security | Feature | Details | |---------|---------| | 🛡️ **Helmet** | Secure HTTP headers | | 🚦 **Rate Limiting** | Redis-based, 100 req/min globally, 10 req/15min on auth | | ✅ **Zod Validation** | Input validation on all endpoints | | 🧹 **XSS Sanitization** | Sanitize all incoming requests | | 🔐 **JWT Auth** | Access + Refresh token system | --- ## 🤖 AI Integration | Feature | Details | |------ …