# Co-Sport - Sports Community Platform
> https://www.co-sport.com/

Co-Sport est une plateforme communautaire qui connecte des athlètes, organise des événements sportifs, et facilite les partenariats d'entraînement. Avec des fonctionnalités avancées de gamification, d'intégration Strava, et une interface de découverte innovante.

## 🏃‍♂️ Core Features

### Training Partner Discovery
- [Find Sports Partners](https://co-sport.com/annonces): Trouvez votre partenaire sportif idéal par sport, localisation et niveau
- [Advanced Swipe Interface](https://co-sport.com/annonces): Interface de swipe révolutionnaire avec pile de cartes réaliste
- [Smart Algorithm](https://co-sport.com/guide): Recommandations intelligentes basées sur les préférences, la proximité géographique et les performances

### Event Management
- [Sports Events](https://co-sport.com/events): Découvrez et participez à des événements sportifs officiels (compétitions, sorties club, formations)
- [Event Creation](https://co-sport.com/events/new): Créez vos propres événements avec modération admin
- Event Types: Compétitions, événements de club, sessions d'entraînement, formations

### Gamification System
- [Challenges](https://co-sport.com/challenges): Défis sportifs personnalisés avec intégration Strava (distance, vitesse, dénivelé, régularité)
- [Badges System](https://co-sport.com/dashboard/badges): Système de badges d'engagement et de performance
- Level System: Progression XP avec niveaux calculés automatiquement
- Leaderboards: Classements communautaires et par sport

### User Profile & Onboarding
- [Dashboard](https://co-sport.com/dashboard): Tableau de bord personnel avec statistiques et activités
- [Profile Management](https://co-sport.com/dashboard/profile): Gestion complète du profil utilisateur
- Progressive Onboarding: Processus en 4 étapes (email, genre, pays, Strava)
- User Types: Entraîneurs, athlètes, débutants avec expériences personnalisées

### Strava Integration
- [Connect Strava](https://co-sport.com/dashboard/strava): Synchronisation automatique des activités
- Auto Sport Detection: Détection automatique des sports pratiqués
- Performance Metrics: Badges basés sur les performances (distance, activités, régularité)
- Activity Tracking: Suivi des activités pour les défis

### Marketplace
- [Equipment Marketplace](https://co-sport.com/marketplace): Achetez et vendez du matériel sportif outdoor
- Categories: Running, cycling, hiking, climbing, swimming, etc.
- User-to-User Trading: Transactions directes entre utilisateurs
- Location-Based: Filtrage par proximité géographique

### Camp to Camp Integration
- [Mountain Routes](https://co-sport.com/camptocamp): Intégration des itinéraires de montagne Camptocamp
- Route Discovery: Recherche et découverte de parcours outdoor
- Difficulty Ratings: Niveaux de difficulté et informations techniques

## 🔍 Discovery & Search

### Advanced Filtering
- Multi-Dimensional Filters: Sport, niveau, localisation, nationalité, type de contenu
- Geographic Intelligence: Filtrage basé sur la distance avec calcul Haversine
- Badge Requirements: Filtres basés sur les badges de performance
- Content Types: Annonces d'entraînement vs événements officiels

### Smart Recommendations
- Sport Preferences Matching: Contenu priorisé selon vos sports favoris (100pts)
- Content Type Weighting: Événements priorisés sur annonces régulières (80pts)
- Geographic Proximity: Scoring basé sur la distance en 6 niveaux (0-50pts)
- View Analytics: Contenu moins vu priorisé (15-50pts)
- Recency Bonus: Contenu récent boosté (10-20pts)
- Gender & Cultural Filtering: Personnalisation démographique (15pts)

### Search Experience
- [Search Page](https://co-sport.com/annonces): Interface de recherche avec filtres avancés
- Real-Time Results: Résultats instantanés avec compteurs
- Pagination SEO: Navigation optimisée pour les moteurs de recherche
- Save Preferences: Filtres sélectionnés sauvegardés automatiquement

## 👥 Social Features

### Messaging System
- [Messages](https://co-sport.com/dashboard/messages): Système de messagerie privée
- Direct Chat: Conversations directes entre utilisateurs
- Event Discussions: Fils de discussion pour événements
- Real-Time Notifications: Notifications instantanées

### Reviews & Ratings
- [User Reviews](https://co-sport.com/reviews): Système d'avis et de notation
- Post-Activity Reviews: Évaluations après entraînements
- Trust Building: Construction de la réputation communautaire
- Moderation: Modération des avis inappropriés

### Community Engagement
- Join Requests: Système de demande d'adhésion avec validation
- Member Management: Gestion des membres pour annonces et événements
- Activity Feed: Flux d'activités des utilisateurs suivis
- Social Badges: Badges pour interactions sociales

## 🏆 Gamification Details

### XP System
XP sources:
- Created Annonces: 200 XP
- Created Events: 300 XP
- Joined Sessions: 150 XP
- Strava Activities: 50 XP per activity
- Completed Badges: 100 XP per badge
- Daily Login: 20 XP
- Messages Sent: 10 XP
- Reviews Left: 75 XP

Level Calculation: `Math.floor(Math.sqrt(totalXP / 100)) + 1`

### Badge Categories
1. **Onboarding Badges**: Profile completion, Strava connection, first photo
2. **Content Badges**: First annonce, prolific creator (10+ annonces)
3. **Social Badges**: First join, community leader (15+ activities)
4. **Strava Performance**: Active athlete, distance milestones (50km, 100km)
5. **Challenge Badges**: Challenge creator, winner, streak achievements
6. **Special Badges**: Referral master, group leader

### Challenge System
Types de défis:
- Distance: Objectifs de kilomètres parcourus
- Speed: Objectifs de vitesse moyenne
- Elevation: Objectifs de dénivelé positif
- Consistency: Objectifs de régularité (jours consécutifs)

Challenge Features:
- Personal Challenges: Défis personnels avec objectifs
- Community Challenges: Défis collectifs entre utilisateurs
- Strava Integration: Synchronisation automatique des progrès
- Leaderboards: Classements par défi

## 🛠️ Tools & Resources

### Sports Tools
- [Sports Tools](https://co-sport.com/outils): Collection d'outils sportifs (calculateurs, convertisseurs)
- BMI Calculator: Calculateur d'indice de masse corporelle
- Pace Calculator: Calculateur d'allure course/vélo
- Distance Converter: Convertisseur de distances
- Training Plans: Plans d'entraînement par sport et niveau

### Community Resources
- [Beginner's Guide](https://co-sport.com/guide): Guide complet pour débutants
- Sport Guides: Guides détaillés par sport
- Safety Tips: Conseils de sécurité
- Training Best Practices: Bonnes pratiques d'entraînement

## 📱 Platform Access

### Web Application
- Progressive Web App (PWA): Installation comme app native
- Offline Mode: Fonctionnalités hors ligne
- Responsive Design: Optimisé mobile-first
- Multi-Language: Français, anglais, espagnol

### Mobile App
- Native Experience: App mobile React Native
- Push Notifications: Notifications temps réel
- Geolocation: Localisation pour recherche proximité
- Camera Integration: Upload photos directement

## 🔐 User Management

### Authentication
- Google OAuth: Connexion via Google
- Email/Password: Authentification classique
- Magic Link: Connexion sans mot de passe
- Session Management: Sessions sécurisées

### Privacy & Settings
- [Privacy Policy](https://co-sport.com/privacy): Politique de confidentialité détaillée
- [Account Settings](https://co-sport.com/dashboard/settings): Paramètres de compte complets
- Data Export: Export de vos données
- Account Deletion: Suppression de compte avec processus sécurisé

## 💬 Support & Community

### Support Services
- [Support Center](https://co-sport.com/support): Centre d'aide et tickets
- [Contact](https://co-sport.com/contact): Contact direct avec l'équipe
- [FAQ](https://co-sport.com/faq): Questions fréquentes
- Community Forums: Discussions communautaires

### Business
- [Partnership Opportunities](https://co-sport.com/partnership): Partenariats commerciaux
- [Professional Accounts](https://co-sport.com/pro): Comptes professionnels pour entraîneurs et clubs
- Event Organization: Services d'organisation d'événements
- Sponsorship: Opportunités de sponsoring

## 🌍 Location Coverage

### Supported Regions
Main French Cities: Paris, Lyon, Marseille, Toulouse, Nice, Nantes, Strasbourg, Montpellier, Bordeaux, Lille, Rennes, Reims, Toulon, Saint-Étienne, Le Havre, Grenoble, Dijon, Angers, Nîmes, Villeurbanne

International: Major cities worldwide with growing community

Geographic Features:
- Haversine Distance Calculation: Calcul précis des distances
- City Coordinates Database: Base de coordonnées pré-configurées
- Proximity Scoring: Système de scoring à 6 niveaux de distance
- Location-Based Search: Recherche par proximité

## 🏃 Sports Supported

Running, Cycling, Swimming, Triathlon, Hiking, Trail Running, Mountain Biking, Road Cycling, Walking, Nordic Walking, Climbing, Mountaineering, Skiing, Snowboarding, Kayaking, Stand-Up Paddle, Surfing, Tennis, Badminton, Squash, Fitness, CrossFit, Yoga, Pilates, and more...

Each sport includes:
- Specific metadata (icons, descriptions, levels)
- Dedicated filters and search
- Sport-specific badges
- Leaderboards par sport

## 📊 Admin Features

### Event Moderation
- Event Approval System: Validation des événements avant publication
- Content Moderation: Modération des contenus inappropriés
- User Management: Gestion des utilisateurs et sanctions
- Analytics Dashboard: Statistiques de la plateforme

### Platform Management
- User Analytics: Métriques utilisateurs détaillées
- Content Analytics: Statistiques de contenu
- Performance Monitoring: Monitoring des performances
- Health Checks: Vérifications de santé système

## 🔗 Technical Information

### API Endpoints
Public APIs:
- `/api/search`: Recherche de contenu (annonces et événements)
- `/api/sports`: Liste des sports disponibles
- `/api/cities`: Liste des villes supportées
- `/api/health`: Health check endpoint
- `/api/health/status`: Statut système détaillé

Mobile APIs:
- `/api/mobile/config`: Configuration mobile
- `/api/mobile/discover`: Découverte de contenu pour mobile
- `/api/mobile/filters`: Filtres disponibles
- `/api/mobile/auth`: Authentification mobile

### Integration Options
- Strava API: Synchronisation activités fitness
- Google Maps API: Recherche de lieux et visualisation
- Camptocamp API: Intégration itinéraires montagne
- Resend Email: Envoi d'emails transactionnels

## 📝 Content Guidelines

### Creating Annonces
Best Practices:
- Clear Title: Titre descriptif avec sport et niveau
- Detailed Description: Description complète de l'activité
- Location: Lieu précis avec carte
- Schedule: Dates et horaires flexibles ou fixes
- Level Requirements: Niveau requis clairement indiqué
- Safety Information: Informations de sécurité si nécessaire

### Creating Events
Requirements:
- Event Type: Compétition, club, ou formation
- Official Venue: Lieu officiel avec adresse complète
- Registration Info: Lien d'inscription et modalités
- Pricing: Tarifs clairs (gratuit ou payant)
- Difficulty Level: Niveau de difficulté approprié
- Images: 1-3 images de qualité (auto-compressed en WebP)

## 🎯 SEO & Discovery

### Optimized Pages
All pages include:
- Dynamic Meta Tags: Balises meta adaptées au contenu
- Structured Data: Rich snippets pour SEO
- Open Graph: Partage optimisé sur réseaux sociaux
- Sitemap: [Sitemap XML](https://co-sport.com/sitemap.xml)
- Robots.txt: Directives pour crawlers

### Indexed Content
- User Profiles: Profils publics indexés
- Events: Événements approuvés indexés
- Annonces: Annonces publiques indexées
- Blog Content: Articles de blog SEO-optimisés
- Static Pages: Pages statiques (guide, about, etc.)

## 📱 Progressive Web App

PWA Features:
- Install Prompt: Installation comme app native
- App Icons: Icônes adaptées toutes tailles (72px-512px)
- Splash Screen: Écran de chargement personnalisé
- Offline Fallback: Mode hors ligne basique
- Service Worker: Cache intelligent des ressources
- Manifest: [Web Manifest](https://co-sport.com/manifest.json)

## 🌐 Internationalization

### Available Languages
- Français (fr): Langue par défaut
- English (en): Version anglaise complète
- Español (es): Version espagnole

Language Features:
- Smart Detection: Détection automatique de la langue
- Fallback System: Système de fallback gracieux
- URL Localization: URLs localisées (/fr/, /en/, /es/)
- Dynamic Loading: Chargement dynamique des traductions

## 🔔 Notification System

### Email Notifications
Types d'emails:
- Welcome Email: Email de bienvenue
- Magic Link: Lien de connexion magique
- Verification: Vérification d'email
- Event Approval: Validation d'événement
- Join Request: Demande d'adhésion
- New Message: Nouveau message
- Review Received: Nouvel avis reçu
- Partnership Request: Demande de partenariat
- Support Response: Réponse support

### In-App Notifications
- Real-Time Updates: Notifications temps réel
- Activity Feed: Flux d'activités
- Badge Unlocks: Déverrouillage de badges
- Level Up: Passage de niveau
- Challenge Progress: Progression défis

## 🎓 Getting Started

### For Athletes
1. [Create Account](https://co-sport.com/register): Créez votre compte gratuit
2. [Complete Profile](https://co-sport.com/dashboard/profile): Complétez votre profil
3. [Connect Strava](https://co-sport.com/dashboard/strava): Connectez Strava (optionnel)
4. [Browse Annonces](https://co-sport.com/annonces): Découvrez des partenaires
5. [Join Activities](https://co-sport.com/annonces): Rejoignez des entraînements

### For Coaches/Organizers
1. Create Professional Account: Compte professionnel
2. Set Up Profile: Profil avec certifications
3. [Create Events](https://co-sport.com/events/new): Créez des événements officiels
4. Create Training Groups: Groupes d'entraînement récurrents
5. Build Community: Développez votre communauté

### For Event Organizers
1. Register Organization: Enregistrez votre organisation
2. Submit Event: Soumettez votre événement
3. Await Approval: Attente validation admin
4. Promote Event: Promotion auprès de la communauté
5. Manage Participants: Gestion des participants

## 📖 Additional Resources

### Documentation
- [About Co-Sport](https://co-sport.com/about): À propos de la plateforme
- [How It Works](https://co-sport.com/guide): Guide de fonctionnement
- [Terms of Service](https://co-sport.com/privacy): Conditions d'utilisation
- [Privacy Policy](https://co-sport.com/privacy): Politique de confidentialité

### Community
- Active Community: Communauté active et bienveillante
- Inclusive Environment: Environnement inclusif tous niveaux
- Safety First: Sécurité et respect prioritaires
- Fair Play: Esprit sportif et fair-play

## 🚀 Platform Statistics

- 20+ Supported Sports
- 100+ Cities Covered
- Growing User Base
- Daily Active Events
- Thousands of Successful Partnerships
- High User Satisfaction Rate

---

## Technical Stack

Built with: Next.js 15, TypeScript, PostgreSQL, Prisma ORM, NextAuth.js, TailwindCSS, Shadcn/ui, React Query, React Hook Form, Zod, Resend Email, Google Maps API, Strava API, PWA

Deployed on: Vercel with PostgreSQL Database

---

*Last Updated: October 2025*
*For more information, visit [co-sport.com](https://co-sport.com) or [contact us](https://co-sport.com/contact)*