xQuery - Plateforme OSINT

Une plateforme OSINT puissante pour rechercher des informations dans 500+ bases de données de fuites via l'API BreachHub.

🚀 Déploiement en 1 clic sur Railway

OU suivez le guide détaillé : DEPLOY_RAILWAY.md

---

✨ Fonctionnalités

• 🔍 Multi-Search - Recherche simultanée sur 500+ bases de données
• 🔐 Sécurisé - Authentification JWT, connexions chiffrées
• 🤖 Intelligent - Détection automatique du type de requête
• 📊 Dashboard - Interface moderne avec stats en temps réel
• 👥 Multi-utilisateurs - Système de crédits et gestion des rôles
• 🌙 Mode Sombre - Interface adaptative
• 🔔 Historique - Sauvegarde de toutes vos recherches

---

🛠️ Stack Technique

Backend

• FastAPI - Framework Python moderne et rapide
• MongoDB - Base de données NoSQL
• JWT - Authentification sécurisée
• BreachHub API - 500+ sources OSINT

Frontend

• React - Library JavaScript moderne
• Tailwind CSS - Framework CSS utility-first
• Lucide Icons - Icônes modernes
• Axios - Client HTTP

---

🔧 Installation Locale

Prérequis

• Python 3.9+
• Node.js 18+
• MongoDB
• Clé API BreachHub

Backend

cd backend
pip install -r requirements.txt
cp .env.example .env
# Configurez vos variables dans .env
uvicorn server:app --reload --port 8000

Frontend

cd frontend
yarn install
cp .env.example .env
# Configurez REACT_APP_BACKEND_URL dans .env
yarn start

---

📝 Variables d'environnement

Backend (.env)

MONGO_URL=mongodb://localhost:27017
DB_NAME=xquery
BREACHHUB_API_KEY=votre_cle_api
JWT_SECRET=votre_secret_jwt
CORS_ORIGINS=*
ADMIN_EMAIL=456789ghj@gmail.com
ADMIN_PASSWORD=admin1234

Frontend (.env)

REACT_APP_BACKEND_URL=http://localhost:8000

---

🔑 Identifiants par défaut

• Email : 456789ghj@gmail.com
• Mot de passe : admin1234

⚠️ Changez-les en production !

---

📚 API Endpoints

Authentification

• POST /api/auth/register - Créer un compte
• POST /api/auth/login - Se connecter
• GET /api/auth/me - Obtenir l'utilisateur actuel
• POST /api/auth/logout - Se déconnecter

Recherche OSINT

• POST /api/search/execute - Lancer une recherche
• GET /api/search/history - Historique des recherches
• GET /api/search/{search_id} - Détails d'une recherche

Administration

• GET /api/admin/users - Liste des utilisateurs
• POST /api/admin/users/{user_id}/ban - Bannir un utilisateur
• POST /api/admin/users/{user_id}/credits - Ajouter des crédits

Documentation complète : http://localhost:8000/docs

---

🎨 Captures d'écran

Dashboard

Recherche OSINT

---

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

1. Fork le projet
2. Créer une branche (git checkout -b feature/AmazingFeature)
3. Commit vos changements (git commit -m 'Add AmazingFeature')
4. Push vers la branche (git push origin feature/AmazingFeature)
5. Ouvrir une Pull Request

---

📄 Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

---

🆘 Support

• 📧 Email : support@xquery.com
• 💬 Discord : discord.gg/xQuery
• 🐛 Issues : GitHub Issues

---

🙏 Remerciements

• BreachHub - API OSINT
• FastAPI - Framework backend
• React - Library frontend
• Tailwind CSS - Framework CSS

---

Fait avec ❤️ par l'équipe xQuery