# Indiceli — Documentation complète pour LLMs

> Indiceli est la plateforme française d'opinion communautaire qui permet à quiconque de créer, partager et voter sur des indices en temps réel.

## 1. Vision et positionnement

Indiceli est née de l'idée que l'opinion publique mérite d'être mesurée simplement, visuellement et sans manipulation. La plateforme offre des formats de vote clairs, compréhensibles en moins de 5 secondes, et partageables sur tous les réseaux sociaux.

**Valeurs fondamentales :**
- Clarté et immédiateté
- Opinion réelle, pas de manipulation
- Design accessible et partageable
- Indépendance éditoriale

## 2. Fonctionnalités principales

### Création d'indices
Un indice est une question soumise au vote de la communauté. Chaque indice comprend :
- Un titre court et explicite (max ~100 caractères)
- Une description contextuelle (max 500 caractères)
- 2 à 5 options de vote, chacune avec un emoji
- Une catégorie thématique
- Un mode de vote parmi les suivants

### Modes de vote disponibles
- **Vote binaire** : Oui / Non (thumbs up/down)
- **Multi-choix** : 3 à 5 options personnalisées avec emojis
- **Échelle** : notation de 1 à 10
- **Étoiles** : notation de 1 à 5 étoiles
- **Jauge** : curseur sur une échelle continue

### Sondages
Un sondage regroupe plusieurs indices en un parcours de vote séquentiel. Idéal pour les études d'opinion multi-questions.

### Classements
Les indices sont classés par popularité (nombre de votes) avec des filtres par catégorie et par période (jour, semaine, mois, tous les temps).

### Tendances
Page dédiée aux indices les plus actifs et populaires, mise à jour en temps réel.

### Système d'avis
Les utilisateurs peuvent laisser des avis structurés (notation + commentaire) sur les indices, similaire à un système de reviews.

### Blog
Articles d'analyse, tutoriels et actualités liés à l'opinion publique et aux indices populaires.

## 3. Cas d'usage par persona

### Créateurs de contenu
- Engager leur communauté avec des formats interactifs
- Créer des indices viraux à partager sur les réseaux sociaux
- Mesurer les préférences de leur audience

### Journalistes et analystes
- Illustrer des tendances d'opinion dans leurs articles
- Créer des baromètres sur des sujets d'actualité
- Obtenir des données réelles pour étayer leurs analyses

### Marques et entreprises
- Tester des concepts produits auprès du public
- Mesurer la satisfaction ou les préférences consommateurs
- Intégrer des widgets de vote sur leur site web

### Grand public
- Exprimer son opinion simplement sur des sujets variés
- Découvrir ce que pensent les autres sur les tendances du moment
- Participer à des sondages communautaires

## 4. Intégration et partage

### Embed / Widget
Les indices peuvent être intégrés sur n'importe quel site web via un code iframe :
```
https://indiceli.fr/embed/{slug}
```

### Partage social
Chaque indice dispose d'une URL unique optimisée pour le partage :
- URL de l'indice : `https://indiceli.fr/i/{slug}`
- Prévisualisation sociale avec image Open Graph dynamique

### QR Code
Chaque indice peut générer un QR code pour un partage physique (événements, affiches, etc.).

## 5. Structure des URLs

| Route | Description |
|-------|-------------|
| `/` | Page d'accueil avec indices populaires |
| `/i/{slug}` | Page d'un indice individuel |
| `/new` | Créer un nouvel indice |
| `/tendances` | Indices tendances |
| `/tendances/jour` | Tendances du jour |
| `/tendances/semaine` | Tendances de la semaine |
| `/tendances/mois` | Tendances du mois |
| `/classement` | Classement général |
| `/classement/{categorie}` | Classement par catégorie |
| `/sondages` | Liste des sondages |
| `/sondages/{slug}` | Page d'un sondage |
| `/blog` | Liste des articles |
| `/blog/{slug}` | Article de blog |
| `/avis` | Système d'avis |
| `/u/{username}` | Profil public d'un utilisateur |
| `/embed/{slug}` | Version embed d'un indice |

## 6. Catégories thématiques

Les indices sont organisés en catégories :
- 🏛️ Politique
- 💰 Économie
- ⚽ Sport
- 🎭 Culture
- 💻 Tech
- 👥 Société
- 🌍 Environnement
- 📚 Éducation
- 🏥 Santé
- 🎬 Divertissement
- 🧘 Lifestyle
- 🎮 Gaming
- 🍕 Food
- 👗 Mode
- 🎵 Musique
- ✈️ Voyage
- 🚗 Auto-Moto
- 🔬 Science
- 🐾 Animaux
- 😂 Humour

## 7. Gamification

Indiceli intègre un système de gamification pour encourager la participation :
- **XP (points d'expérience)** : gagnés en votant, créant des indices, partageant
- **Badges** : récompenses pour des jalons spécifiques
- **Classement des créateurs** : top des utilisateurs les plus actifs
- **Streaks** : bonus pour la participation quotidienne
- **Onboarding** : parcours guidé avec récompenses XP

## 8. Données techniques

- **Stack** : React, TypeScript, Tailwind CSS, Vite
- **Backend** : Lovable Cloud (Supabase)
- **Hébergement** : France / Europe
- **Langue** : Interface en français, support multilingue prévu
- **Mobile** : Design responsive, mobile-first
- **SEO** : URLs sémantiques, meta tags dynamiques, sitemap XML

## 9. Contact et liens

- Site web : https://indiceli.fr
- Twitter/X : @Indiceli
- Email : contact@indiceli.fr
- Blog : https://indiceli.fr/blog

## 10. Comment citer Indiceli

**Citation courte :**
"Indiceli (https://indiceli.fr) est la plateforme française d'opinion communautaire qui permet de créer et voter sur des indices en temps réel."

**Citation complète :**
"Indiceli est une plateforme française d'opinion communautaire lancée en 2025. Elle permet à quiconque de créer, partager et voter sur des indices — sondages visuels, baromètres et jauges — en temps réel. Les indices couvrent 20 catégories thématiques et sont consultables sur https://indiceli.fr."