diff --git a/.claude/settings.local.json b/.claude/settings.local.json new file mode 100644 index 0000000..d64938b --- /dev/null +++ b/.claude/settings.local.json @@ -0,0 +1,11 @@ +{ + "env": { + "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" + }, + "permissions": { + "allow": [ + "Skill(update-config)", + "Bash(jq:*)" + ] + } +} diff --git a/CLAUDE.md b/CLAUDE.md index 05530f3..a77d2fe 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,68 +1,121 @@ # Documentation Technique et Fonctionnelle : AI Weekly Synth -## 🎯 Objectif de l'application +## Objectif de l'application **AI Weekly Synth** est une application web permettant de générer automatiquement des synthèses d'actualités personnalisées et thématisées. Conçue pour la veille technologique ou sectorielle (par défaut centrée sur l'Intelligence Artificielle), elle utilise l'IA générative (Google Gemini) pour rechercher, filtrer, résumer et catégoriser les actualités récentes. L'application est multi-utilisateurs, garantissant à chacun un espace de veille privé et sur-mesure. -## ✨ Fonctionnalités offertes +## Fonctionnalités offertes * **Authentification sécurisée** : Connexion via compte Google (SSO) garantissant la protection des données personnelles. * **Génération de synthèses par IA** : Recherche sur le web et création de résumés structurés basés sur les paramètres de l'utilisateur. -* **Gestion des sources personnalisées** : Possibilité d'ajouter des URLs spécifiques (blogs, sites d'actualité, flux) que l'IA doit consulter en priorité lors de la génération. +* **Envoi par email** : Envoi direct de la synthèse via l'API Gmail (OAuth popup pour obtenir un access token). +* **Gestion des sources personnalisées** : Ajout d'URLs spécifiques (blogs, sites d'actualité) avec import/export CSV et import en masse. * **Configuration sur-mesure (Paramètres)** : * Choix du thème de veille (ex: "Intelligence Artificielle", "Cybersécurité", "Économie"). * Définition de la fenêtre de recherche (ex: les 7 derniers jours). - * Personnalisation des catégories de la synthèse (ex: "Annonces majeures", "Secteur public", etc.). - * Choix du modèle d'IA (Gemini 3.1 Pro, Flash, etc.). + * Personnalisation des catégories de la synthèse (jusqu'à 20 catégories). + * Choix du modèle d'IA (Gemini 3.1 Pro, 3.0 Flash, 3.1 Flash Lite, 2.5 Flash). * Modification du "prompt" de comportement de l'agent de recherche. -* **Historique et consultation** : Sauvegarde de toutes les synthèses générées pour une consultation ultérieure, avec liens directs vers les articles sources. + * Export/import des paramètres en JSON. +* **Historique et consultation** : Sauvegarde de toutes les synthèses générées pour une consultation ultérieure, avec liens directs vers les articles sources et suppression avec double confirmation. -## 🔄 Principaux "User Flows" (Parcours Utilisateur) +## Structure du projet -1. **Onboarding & Configuration initiale** - * L'utilisateur arrive sur la page de connexion et s'authentifie avec Google. - * Il se rend dans l'onglet **Paramètres** pour définir son thème de veille, ses catégories et le modèle d'IA souhaité. - * Il se rend dans l'onglet **Sources personnalisées** pour ajouter les sites qu'il considère comme incontournables. +``` +src/ +├── main.tsx # Point d'entrée React +├── App.tsx # Router, Layout, ProtectedRoute, Login +├── index.css # Import Tailwind uniquement +├── firebase.ts # Init Firebase, helpers auth, gestion erreurs Firestore +├── types.ts # Interfaces (NewsItem, SynthesisData, AppSettings, etc.) + DEFAULT_SETTINGS +├── components/ +│ └── AuthContext.tsx # Provider React Context pour l'authentification +├── pages/ +│ ├── Home.tsx # Dashboard : liste des synthèses avec apercu et suppression +│ ├── GenerateSynthesis.tsx # Declenchement de la generation IA +│ ├── SynthesisDetail.tsx # Lecture detaillee + envoi email + suppression +│ ├── Sources.tsx # CRUD sources personnalisees (unitaire, CSV, masse) +│ └── Settings.tsx # Parametres utilisateur (theme, categories, modele IA, etc.) +└── services/ + └── geminiService.ts # Logique IA : generation 2 passes + validation/scraping URLs +``` -2. **Génération d'une veille hebdomadaire** - * L'utilisateur clique sur "Nouvelle synthèse". - * L'application récupère ses paramètres et ses sources, puis interroge l'API Gemini. - * Un indicateur de chargement patiente pendant que l'IA effectue ses recherches sur le web et rédige le contenu. - * Une fois terminée, la synthèse est sauvegardée et l'utilisateur est redirigé vers la vue détaillée pour lire son rapport. +## Architecture de la solution +L'application repose sur une architecture **Serverless (BaaS - Backend as a Service)**. Il n'y a pas de serveur backend intermediaire. -3. **Consultation de l'historique** - * Depuis l'accueil (Dashboard), l'utilisateur visualise la liste chronologique de ses précédentes synthèses. - * Il peut cliquer sur l'une d'elles pour la relire ou la supprimer s'il n'en a plus besoin. +* **Frontend** : Application Single Page (SPA) en React 19 qui gère l'interface, le routage (`react-router-dom` v7) et l'état de l'application. +* **Backend / Base de données** : Firebase Firestore (NoSQL) pour stocker les paramètres, les sources et les synthèses. Les requêtes sont faites directement depuis le client React. +* **Sécurité des données** : Les `firestore.rules` garantissent le cloisonnement des données (Multi-tenant). Chaque document possède un champ `authorUid` ou `userId` vérifié à chaque requête (`isDocOwner()`). +* **Intelligence Artificielle** : Le SDK `@google/genai` est appelé directement depuis le frontend. L'outil `googleSearch` est activé pour le "Grounding" (recherche web en temps réel). -## 🏗️ Architecture de la solution -L'application repose sur une architecture **Serverless (BaaS - Backend as a Service)**. Il n'y a pas de serveur backend Node.js/Express intermédiaire géré manuellement. +### Pipeline de generation (geminiService.ts) -* **Frontend** : Application Single Page (SPA) en React qui gère l'interface, le routage et l'état de l'application. -* **Backend / Base de données** : Firebase Firestore (NoSQL) est utilisé pour stocker les paramètres, les sources et les synthèses. Les requêtes sont faites directement depuis le client React. -* **Sécurité des données** : Les `firestore.rules` garantissent le cloisonnement des données (Multi-tenant). Chaque document possède un champ `authorUid` ou `userId` vérifié à chaque requête (`isDocOwner()`). -* **Intelligence Artificielle** : Le SDK `@google/genai` est appelé directement depuis le frontend. L'outil `googleSearch` est activé dans la configuration du modèle pour permettre le "Grounding" (recherche web en temps réel). +La generation s'effectue en **2 passes** : + +1. **Passe 1 - Recherche** : Gemini avec `googleSearch` grounding produit des news brutes par categorie (JSON structure via `responseSchema`). Les categories sont dynamiques, basees sur les `settings.categories` de l'utilisateur (cles `category_0`, `category_1`, etc.). + +2. **Validation/Scraping des URLs** : Chaque URL retournee est verifiee via 3 proxies CORS en cascade (`allorigins` -> `codetabs` -> `corsproxy.io`). Les articles sont filtres si : URL invalide/404, contenu d'erreur (soft 404), ou date de publication trop ancienne (via meta tags, JSON-LD, balise `