Suivi de prix intelligent propulse par l'IA
Fonctionnalités • Installation • Configuration • Utilisation
--- ## Description **PriceFlow** est une application auto-hébergée de suivi de prix utilisant l'intelligence artificielle. Elle analyse visuellement les pages produits grâce aux modèles de vision IA (OpenAI, Anthropic, Ollama, OpenRouter) pour détecter les prix et surveiller l'état des stocks. ## Fonctionnalités - **Analyse par IA** : Utilise les modèles de vision GenAI pour "voir" le prix et l'état du stock sur n'importe quelle page web - **Multi-fournisseurs IA** : Support de Ollama, OpenAI, Anthropic et **OpenRouter** avec filtres par catégorie (chat, vision, code, raisonnement) - **Scores de confiance** : L'IA fournit un score de confiance (0-1) pour chaque extraction - **Historique visuel** : Conserve l'historique des captures d'écran avec les métadonnées IA - **Défilement intelligent** : Scroll automatique pour charger le contenu différé - **Notifications** : Support multi-canaux (Discord, Telegram, Email, etc.) via [Apprise](https://github.com/caronc/apprise) - **Catalogues promotionnels** : Consultation des catalogues et prospectus discount (Gifi, Action, Centrakor, etc.) scrapés depuis Bonial.fr - **Interface en français** : Application entièrement traduite en français - **Mode sombre** : Interface moderne avec support du thème clair/foncé - **Dockerisé** : Déploiement facile avec Docker Compose ## Prérequis - **Docker** et **Docker Compose** - **Réseau Docker** : `nginx_default` (external) - **Fournisseur IA** : Clé API OpenAI, Anthropic, OpenRouter, OU une instance Ollama locale ## Installation ### 1. Cloner le dépôt ```bash git clone https://github.com/R0m1k3/Priceflow.git cd Priceflow ``` ### 2. Créer le réseau Docker (si non existant) ```bash docker network create nginx_default ``` ### 3. Configurer les variables d'environnement ```bash cp .env.example .env # Modifier .env selon vos besoins ``` ### 4. Lancer l'application ```bash docker compose up -d ``` ### 5. Accéder à l'interface Ouvrez votre navigateur sur : **http://localhost:8555** ## Architecture Docker | Service | Port | Description | |---------|------|-------------| | **PriceFlow App** | `8555:8555` | Application principale | | **PostgreSQL** | `5488:5432` | Base de données | | **Browserless** | `3012:3000` | Navigateur headless pour le scraping | **Réseau** : `nginx_default` (external) ## Configuration ### Variables d'environnement | Variable | Description | Défaut | |----------|-------------|--------| | `DATABASE_URL` | Chaîne de connexion PostgreSQL | `postgresql://priceflow:priceflow@db:5432/priceflow` | | `BROWSERLESS_URL` | URL WebSocket de Browserless | `ws://browserless:3000` | | `LOG_LEVEL` | Niveau de log (DEBUG, INFO, WARNING, ERROR) | `INFO` | | `CORS_ORIGINS` | Origines CORS autorisées | `*` | ### Configuration IA Toute la configuration IA se fait via la page **Paramètres** de l'interface : **Fournisseurs supportés :** - **Ollama** : Modèles locaux (gemma3, llava, etc.) - **OpenAI** : GPT-4o, GPT-4-vision, etc. - **Anthropic** : Claude 3.5 Sonnet, etc. - **OpenRouter** : Accès à +200 modèles avec filtres par catégorie **Paramètres avancés :** - Température (0.0 - 1.0) - Tokens maximum - Seuils de confiance (prix/stock) - Réparation JSON automatique ### Configuration OpenRouter 1. Sélectionnez **OpenRouter** comme fournisseur 2. Entrez votre clé API (`sk-or-...`) 3. Filtrez les modèles par catégorie : - **Chat** : Conversation générale - **Vision** : Analyse d'images - **Code** : Programmation - **Raisonnement** : Raisonnement avancé - **Gratuit** : Modèles gratuits 4. Sélectionnez un modèle avec affichage des coûts ### Notifications Créez des **Profils de notification** dans les Paramètres avec des URLs Apprise : ``` # Discord discord://webhook_id/webhook_token # Telegram tgram://bot_token/chat_id # Email mailto://user:password@gmail.com ``` ## Utilisation ### Ajouter un article à suivre 1. Cliquez sur **Ajouter un article** 2. Entrez l'URL de la page produit 3. (Optionnel) Définissez un prix cible 4. (Optionnel) Associez un profil de notification 5. Enregistrez ### Fonctionnement 1. PriceFlow capture une image de la page produit 2. L'IA analyse l'image pour extraire le prix et l'état du stock 3. Les données sont enregistrées avec un score de confiance 4. Si le prix atteint votre cible, vous êtes notifié ## Structure du projet ``` Priceflow/ ├── app/ # Backend FastAPI │ ├── routers/ # Endpoints API │ ├── services/ # Services métier │ └── models.py # Modèles SQLAlchemy ├── frontend/ # Frontend React │ ├── src/ │ │ ├── components/ # Composants React │ │ ├── pages/ # Pages (Dashboard, Settings) │ │ └── i18n/ # Traductions │ └── public/ # Assets statiques ├── docker-compose.yml # Configuration Docker ├── Dockerfile # Image Docker ├── init.sql # Script d'initialisation DB └── .env.example # Variables d'environnement ``` ## Personnalisation ### Changer le favicon Remplacez les fichiers dans `/frontend/public/` : - `favicon.ico` (32x32 ou 64x64) - `apple-touch-icon.png` (180x180) - `logo.png` (logo principal) ### Ajouter une langue 1. Créez un fichier dans `frontend/src/i18n/locales/` 2. Copiez la structure de `fr.json` 3. Modifiez `frontend/src/i18n/index.js` ## Développement ### Lancer en mode développement ```bash # Backend cd app uvicorn app.main:app --reload --port 8555 # Frontend cd frontend npm install npm run dev ``` ### Migrations de base de données ```bash # Créer une migration alembic revision --autogenerate -m "description" # Appliquer les migrations alembic upgrade head ``` ## Licence Ce projet est sous licence GNU General Public License v3.0 - voir le fichier [LICENSE](LICENSE) pour plus de détails. ---Développé avec ❤️ pour le suivi de prix intelligent