---

Une application web moderne et complète pour créer, gérer et partager vos listes de souhaits

🚀 Installation • 📖 Documentation • 🔧 API • 🏗️ Architecture • 🗺️ Roadmap

• English version •

---

⚡ Note : Cette application a été vibe‑codée — développée à l'aide de plusieurs agents et LLM.

Une application web moderne et complète pour créer, gérer et partager vos listes de souhaits. Wisherr permet aux utilisateurs de créer des listes de cadeaux, de les partager avec leurs proches (famille, amis, groupes), et d'éviter les doublons grâce aux réservations privées.

✨ Fonctionnalités principales

• 🔐 Authentification sécurisée : Locale (username/password) ou OIDC/SSO avec JWT
• 📝 Gestion de listes : CRUD complet avec permissions granulaires (owner/editor/viewer)
• 🎯 Articles détaillés : Scraping automatique, catégories, priorités, réservations privées
• 👥 Partage flexible : Interne (utilisateurs/groupes) ou externe (liens publics)
• 🏘️ Groupes & familles : Organisation des proches avec gestion de membres
• 🔔 Notifications temps réel : Réservations, partages, activités
• 🌍 Internationalisation : Français et Anglais
• 🎨 Interface moderne : Dark/Light mode, responsive, Glassmorphism
• 📊 Monitoring complet : Métriques Prometheus, health checks, logs
• 🛡️ Administration : Panel admin avec stats, gestion utilisateurs, config

📚 Documentation

• Installation & Démarrage - Guide complet d'installation (Docker recommandé)
• Utilisation - Premiers pas, guides par rôle, fonctionnalités avancées
• API Documentation - Tous les endpoints avec exemples
• Architecture - Vue d'ensemble technique et diagramme
• Roadmap - Fonctionnalités présentes et à venir
• Contributing - Guide de contribution et développement

🚀 Installation rapide

Prérequis

• Docker 20.10+ et Docker Compose 2.0+

Démarrage

# Récupérer les fichiers de configuration depuis le dépôt
curl -fsSL -o compose.yaml https://raw.githubusercontent.com/adenyrr/wisherr/refs/heads/master/compose.yaml
curl -fsSL -o .env.example https://raw.githubusercontent.com/adenyrr/wisherr/refs/heads/master/.env.example

# Copier et configurer
cp .env.example .env
nano .env

# Démarrer la stack (utilise les images Docker Hub définies dans compose.yaml)
docker compose up -d

Accès :

• Frontend : http://localhost:8080
• API Docs : http://localhost:8000/docs
• Métriques : http://localhost:8000/metrics

Premier utilisateur admin créé automatiquement (voir .env).

🔒 Sécurité

• Rate limiting sur endpoints sensibles
• Validation stricte des mots de passe
• JWT sécurisé avec SECRET_KEY obligatoire
• CORS configuré
• Logs structurés JSON
• Audit logs pour traçabilité

📞 Support

• 🐛 Issues : GitHub Issues
• 💬 Discussions : GitHub Discussions
• 📖 Documentation : Voir les liens ci-dessus

📄 Licence

CC BY-NC : adenyrr - Voir LICENCE

👥 Équipe

• Architecture & Backend : @architecte-logiciel
• DevOps & Infrastructure : @sre-devops
• Sécurité : @analyse-securite-code
• Documentation : @documentation-support

📸 Screenshots

Dashboard Créer une liste Ajouter un article Partage public / Lien API Backend (admin) Liste partagée

Cliquez sur une miniature pour ouvrir l'image en taille réelle.

---