PartnR

Plateforme sociale pour trouver des partenaires d'activités sportives et de loisirs. Organisez des événements, rejoignez des sorties près de chez vous, et échangez avec les participants en temps réel.

Fonctionnalités

• Authentification — Inscription avec confirmation d'email, connexion JWT, mot de passe oublié, verrouillage après 5 échecs, bannissement effectif immédiatement
• Profils — Bio, ville (autocomplétion geo.api.gouv.fr), activités favorites, catégorie de profil, notation, suppression de compte
• Événements — Création (photo, géolocalisation, récurrence hebdomadaire), recherche par ville / catégorie / activité / texte / rayon, liste d'attente, verrou de place, cycle de vie automatique (Terminé)
• Vie privée — L'adresse exacte, les coordonnées précises et la liste des participants ne sont visibles que des inscrits ; les photos sont redimensionnées et débarrassées de leurs métadonnées EXIF/GPS
• Chat temps réel — Messagerie de groupe par événement via SignalR (web + mobile), avec notification des absents
• Notifications — In-app, push Expo (avec retries) et email : inscription, liste d'attente, annulation, report, rappel J-1
• Modération — Signalement d'un profil ou d'un événement, blocage d'utilisateurs, console admin (utilisateurs, événements, signalements)
• Fiabilité — L'organisateur note qui est venu ; le profil affiche le nombre de sorties et le taux de présence, et un absent récidiviste perd sa priorité sur les listes d'attente
• Notation — Évaluation post-activité entre participants (1-5 étoiles)
• Analytics — Tracking d'actions utilisateur (fire-and-forget), dashboard admin avec graphiques
• Application mobile — iOS/Android via Expo React Native, parité fonctionnelle avec le web
• 22 activités en 6 catégories — Sport, Boire & manger, Culture, Balades, Jeux, Engagement

Stack technique

Couche	Technologie
Frontend web	React 19, TypeScript, Tailwind CSS 4, Vite 7
Application mobile	Expo SDK 51, React Native 0.74, Expo Router v3
Backend API	ASP.NET Core 8, Entity Framework Core
Auth	ASP.NET Identity + JWT Bearer
Temps réel	SignalR (web + mobile)
Base de données	PostgreSQL (Supabase)
ORM	EF Core + Npgsql
Tests backend	xUnit + EF Core InMemory
Tests frontend	Vitest + Testing Library
Documentation	Swagger / OpenAPI

Structure du projet

partnr/
├── backend/
│   ├── PartnR.Api/
│   │   ├── Controllers/        # Endpoints REST
│   │   │   ├── ActivitiesController.cs
│   │   │   ├── AnalyticsController.cs
│   │   │   ├── AuthController.cs
│   │   │   ├── EventsController.cs
│   │   │   ├── ProfilesController.cs
│   │   │   └── RatingsController.cs
│   │   ├── DTOs/               # Objets de transfert + validations
│   │   │   ├── Auth/
│   │   │   ├── Events/
│   │   │   └── Profiles/
│   │   ├── Entities/           # Modèles de domaine
│   │   ├── Data/               # DbContext + configuration EF
│   │   ├── Services/           # Logique métier
│   │   │   ├── AnalyticsService.cs
│   │   │   ├── AnalyticsTracker.cs  # Singleton fire-and-forget
│   │   │   ├── AuthService.cs
│   │   │   ├── EventService.cs
│   │   │   ├── ProfileService.cs
│   │   │   └── RatingService.cs
│   │   ├── Hubs/               # SignalR (chat temps réel)
│   │   ├── Extensions/         # Méthodes d'extension (ClaimsPrincipal)
│   │   ├── Middleware/         # Gestion globale des erreurs
│   │   ├── Program.cs          # Point d'entrée + configuration
│   │   └── appsettings.json    # Configuration
│   └── PartnR.Api.Tests/       # Tests unitaires backend
│       ├── EventServiceTests.cs
│       └── RatingServiceTests.cs
├── frontend/
│   └── src/
│       ├── api/                # Couche API (Axios)
│       ├── components/         # Composants réutilisables
│       │   ├── EventChat.tsx
│       │   ├── Navbar.tsx
│       │   └── RatingForm.tsx
│       ├── context/            # State management (AuthContext)
│       ├── hooks/              # useAnalytics (batching + sendBeacon)
│       ├── pages/              # Pages de l'application
│       │   ├── EventList.tsx
│       │   ├── EventDetail.tsx
│       │   ├── CreateEvent.tsx
│       │   ├── EditEvent.tsx
│       │   ├── Profile.tsx
│       │   ├── Login.tsx
│       │   └── Register.tsx
│       ├── types/              # Types TypeScript
│       └── __tests__/          # Tests frontend
├── mobile/
│   ├── app/                    # Écrans (Expo Router file-based)
│   │   ├── (tabs)/             # Onglets principaux
│   │   │   ├── index.tsx       # Accueil — liste des événements
│   │   │   ├── messages.tsx    # Liste des chats
│   │   │   └── profile.tsx     # Profil utilisateur
│   │   ├── activity/[id].tsx   # Détail d'un événement
│   │   ├── chat/[id].tsx       # Chat temps réel (SignalR)
│   │   ├── create.tsx          # Créer un événement (3 étapes)
│   │   ├── onboarding.tsx      # Onboarding (3 étapes)
│   │   ├── login.tsx           # Connexion
│   │   └── register.tsx        # Inscription
│   ├── api/                    # Couche API (Axios, mêmes endpoints que web)
│   ├── components/             # Composants réutilisables (Avatar, BackBtn, CTAButton…)
│   ├── constants/              # Design tokens (tokens.ts)
│   ├── context/                # AppContext (JWT + user state)
│   ├── hooks/                  # useEventChat (SignalR)
│   └── config.ts               # API_URL
└── supabase/
    └── migrations/
        └── 00001_initial_schema.sql

Pages frontend

Route	Page	Description
/	EventList	Liste des événements avec filtres (ville, activité)
/events/new	CreateEvent	Créer un événement (auth requise)
/events/:id	EventDetail	Détail, participants, chat, notation
/events/:id/edit	EditEvent	Modifier un événement (créateur uniquement)
/profile/:id	Profile	Profil utilisateur (vue/édition)
/login	Login	Connexion
/register	Register	Inscription avec validation en temps réel

API Endpoints

Les erreurs sont renvoyées en JSON { "error": "…" } : 400 (validation, règle métier), 403 (droit insuffisant), 404 (introuvable), 429 (rate limit).

Authentification (10 req/min par IP)

Méthode	Route	Auth	Description
POST	/api/auth/register	Non	Créer un compte (email de confirmation)
POST	/api/auth/login	Non	Se connecter (retourne JWT) — 5 échecs = 15 min de verrouillage
GET	/api/auth/me	Oui	Profil de l'utilisateur connecté
POST	/api/auth/confirm-email	Non	Confirmer l'adresse email
POST	/api/auth/resend-confirmation	Non	Renvoyer l'email de confirmation
POST	/api/auth/forgot-password	Non	Demander un lien de réinitialisation
POST	/api/auth/reset-password	Non	Réinitialiser le mot de passe
POST	/api/auth/change-password	Oui	Changer le mot de passe

Profils

Méthode	Route	Auth	Description
GET	/api/profiles/{id}	Non	Voir un profil
GET	/api/profiles/{id}/ratings	Non	Avis reçus par un profil
GET	/api/profiles?city=&activity=	Non	Rechercher des profils
PUT	/api/profiles/me	Oui	Modifier son profil
DELETE	/api/profiles/me	Oui	Supprimer son compte (annule ses événements à venir)

Événements

Méthode	Route	Auth	Description
GET	/api/events?city=&category=&activityId=&status=&search=&lat=&lng=&radiusKm=&mine=&page=&pageSize=	Opt	Lister (paginé). Une série récurrente = une carte. Connecté : les événements des personnes bloquées sont masqués
GET	/api/events/{id}	Opt	Détail. Adresse exacte, coordonnées précises et participants réservés aux inscrits (locationHidden)
POST	/api/events	Oui	Créer (recurrenceWeeks pour une série hebdomadaire)
PUT	/api/events/{id}?applyToSeries=	Oui	Modifier (créateur). Un changement de date notifie les participants
DELETE	/api/events/{id}?applyToSeries=	Oui	Supprimer (créateur)
POST	/api/events/{id}/join	Oui	Rejoindre (liste d'attente si complet)
POST	/api/events/{id}/leave	Oui	Quitter (promeut le premier en attente, sauf les absents récidivistes)
POST	/api/events/{id}/attendance	Oui	Organisateur, après la date : { userId, present } note qui est venu
GET	/api/events/{id}/comments	Non	Questions / réponses publiques
POST	/api/events/{id}/comments	Oui	Poser une question
DELETE	/api/events/{id}/comments/{commentId}	Oui	Supprimer (auteur ou créateur)
POST	/api/events/{id}/photos	Oui	Ajouter une photo (participants)
DELETE	/api/events/{id}/photos/{photoId}	Oui	Retirer une photo
POST	/api/events/{id}/ratings	Oui	Noter un participant
GET	/api/events/{id}/ratings/user/{userId}

Notifications, blocages, signalements

Méthode	Route	Auth	Description
GET	/api/notifications	Oui	Mes notifications
POST	/api/notifications/read-all	Oui	Tout marquer lu
POST	/api/notifications/push-token	Oui	Enregistrer un token Expo push
GET	/api/blocks	Oui	Personnes que j'ai bloquées
POST	/api/blocks/{userId}	Oui	Bloquer (masque événements et messages, refuse les inscriptions, dans les deux sens)
DELETE	/api/blocks/{userId}	Oui	Débloquer
POST	/api/reports	Oui	Signaler un profil ou un événement
GET	/api/reports	Admin	Liste des signalements
POST	/api/reports/{id}/resolve	Admin	Clore un signalement

Fichiers, référentiels, santé

Méthode	Route	Auth	Description
POST	/api/uploads	Oui	Envoyer une image (≤ 5 Mo ; redimensionnée à 1600 px max, EXIF supprimé)
GET	/api/uploads/{id}	Non	Servir une image (cache 1 an)
GET	/api/activities	Non	Catalogue des activités (avec category)
GET	/api/cities	Non	Villes suggérées
GET	/api/health	Non	Liveness (sans accès DB) — utilisé par les clients pour réveiller l'API et par le pinger
GET	/api/health/ready	Non	Readiness : 200 si la base répond, 503 sinon — pour l'alerting

Admin et analytics

Méthode	Route	Auth	Description
GET	/api/admin/users	Admin	Utilisateurs
POST	/api/admin/users/{id}/ban · /unban	Admin	Bannir / réhabiliter (les sessions du banni tombent dans la minute)
GET	/api/admin/events	Admin	Événements
POST	/api/admin/events/{id}/cancel	Admin	Annuler un événement
DELETE	/api/admin/events/{id}	Admin	Supprimer un événement
POST	/api/analytics/track	Oui	Envoyer un lot d'actions utilisateur
GET	/api/analytics/dashboard	Admin	Données du dashboard

SignalR Hub — /hubs/event-chat

Méthode	Direction	Description
JoinEventChat(eventId)	Client → Serveur	Rejoindre le chat d'un événement
SendMessage(eventId, content)	Client → Serveur	Envoyer un message
LeaveEventChat(eventId)	Client → Serveur	Quitter le chat
MessageHistory(messages)	Serveur → Client	Historique des messages
NewMessage(message)	Serveur → Client	Nouveau message reçu

Base de données

PostgreSQL hébergé sur Supabase, schéma piloté par EF Core (tables AspNetUsers, Events, EventParticipants, Messages, Ratings, EventPhotos, EventComments, Notifications, PushTokens, Reports, UserBlocks, StoredImages, UserActions, Activities).

Toutes les règles d'accès sont dans les services de l'API (pas de RLS) : le schéma Supabase historique de 00001_initial_schema.sql est conservé pour référence.

Modèle de données

AspNetUsers ──1:N── Events (CreatorId)
AspNetUsers ──M:N── Events (via EventParticipants : Confirmed / Waitlisted / Cancelled, ReminderSentAt)
AspNetUsers ──1:N── Messages, EventComments, Notifications, PushTokens, Reports, StoredImages
AspNetUsers ──M:N── AspNetUsers (via UserBlocks)
AspNetUsers ──1:N── Ratings (RaterId / RatedUserId)
Events      ──N:1── Activities (catalogue, avec Category)
Events      ──1:N── Messages, Ratings, EventPhotos, EventComments
Events      ──N:1── Events (RecurrenceGroupId : occurrences d'une série)

Migrations

supabase/migrations/ contient un fichier SQL idempotent par changement de schéma, appliqué par l'API au démarrage (voir « Initialiser la base Supabase »). Chaque ajout de colonne ou de table côté EF Core doit être accompagné de son fichier ; les données de référence (HasData) y sont reproduites avec les mêmes identifiants.

Fichier	Contenu
00001 – 00003	Schéma initial, tables Identity, analytics
00004 – 00009	Modération admin, type de profil, photos, géolocalisation, images stockées, notifications
00010 – 00014	Rappel J-1, questions/réponses, récurrence, signalements, tokens push
00015	Catalogue de 22 activités en 6 catégories
00016	Retries push avec backoff
00017	Rappel J-1 par participant (EventParticipants.ReminderSentAt)
00018	Blocages (UserBlocks)
00019	Présences (EventParticipants.Attendance)

Installation

Prérequis

• .NET 8 SDK
• Node.js 20+
• PostgreSQL 15+ (ou compte Supabase)

Lancer le backend

cd backend/PartnR.Api

# Configurer la connexion DB dans appsettings.json
# "ConnectionStrings": { "DefaultConnection": "Host=...;Port=5432;Database=partnr;..." }

# Lancer l'API — les migrations SQL de supabase/migrations/ sont appliquées
# automatiquement au démarrage (aucune commande dotnet ef à lancer)
dotnet run

L'API sera disponible sur https://localhost:5001 avec Swagger UI sur /swagger.

Lancer le frontend

cd frontend

npm install
npm run dev

L'application sera disponible sur http://localhost:5173.

Lancer l'application mobile

cd mobile

npm install

# Lancer Metro Bundler
npx expo start

# Scanner le QR code avec l'app Expo Go (iOS/Android)
# ou appuyer sur 'a' pour Android Emulator, 'i' pour iOS Simulator

L'application se connecte par défaut à https://partnr-p3rv.onrender.com. Pour pointer vers un backend local, modifier mobile/config.ts :

export const API_URL = 'http://YOUR_LOCAL_IP:5001';

Builds natifs et notifications push (EAS)

Expo Go suffit pour développer, mais les notifications push ont besoin d'un projet EAS (un projectId dans app.json) et un build natif est nécessaire pour distribuer l'app. Les profils sont dans mobile/eas.json :

cd mobile
npm install -g eas-cli
eas login
eas init                     # crée le projet EAS et écrit extra.eas.projectId dans app.json (à committer)

eas build --profile preview --platform android   # APK installable, partageable par lien
eas build --profile development                   # dev client (hot reload + modules natifs)
eas build --profile production                    # store-ready, version auto-incrémentée

Sans projectId, registerForPush échoue silencieusement et l'app fonctionne sans push.

Tests

# Backend
cd backend/PartnR.Api.Tests
dotnet test

# Frontend
cd frontend
npm test

Initialiser la base Supabase

Rien à faire à la main : au premier démarrage, l'API applique dans l'ordre tous les fichiers de supabase/migrations/ et consigne ceux déjà passés dans la table __PartnrMigrations. Pour vérifier, cherchez Applied SQL migrations ou SQL migrations up to date dans les logs.

Éviter le cold start (Render free tier)

Render endort l'API après 15 minutes sans trafic ; le réveil prend ~30 s, que les clients masquent avec un écran d'attente. Pour que les visiteurs ne le voient jamais, faites pinger GET https://partnr-p3rv.onrender.com/api/health toutes les 10 minutes par un service gratuit (UptimeRobot, cron-job.org, Better Stack). Ce endpoint ne touche pas la base ; pour être alerté d'une vraie panne, surveillez GET /api/health/ready, qui renvoie 503 quand PostgreSQL ne répond plus.

Sécurité

• Rate limiting partitionné — par IP (10 req/min sur /api/auth/*) puis par utilisateur (60 req/min sur les endpoints marqués api, 300 req/min global). X-Forwarded-For est honoré sur un seul saut derrière le proxy Render
• Comptes — Verrouillage 15 min après 5 échecs de connexion ; bannissement et changement de mot de passe invalident les JWT existants dans la minute (claim sst comparé au SecurityStamp)
• Démarrage — L'API refuse de démarrer hors développement si Jwt__Key est absente, trop courte ou encore la valeur d'exemple ; une migration SQL invalide est fatale
• Uploads — Type déduit des octets (jamais du header client), image décodée, redimensionnée et ré-encodée : EXIF/GPS supprimés, nosniff à la lecture
• Vie privée — Détail d'événement dépendant du viewer (adresse, coordonnées arrondies à ~1 km, participants) ; blocage silencieux entre utilisateurs
• Concurrence — Inscription et désistement sérialisés par verrou consultatif PostgreSQL (pg_advisory_xact_lock)
• CORS — Origines configurables (+ *.vercel.app), méthodes et headers restreints
• Validation — DataAnnotations côté backend + validation inline côté clients ; les redirections post-login sont limitées aux chemins internes

Variables d'environnement

Backend (ASP.NET Core)

Variable	Description	Défaut
ConnectionStrings__DefaultConnection	Chaîne de connexion PostgreSQL	localhost
Jwt__Key	Clé secrète JWT (min 32 caractères)	À changer
Jwt__Issuer	Émetteur du token	PartnR.Api
Jwt__Audience	Audience du token	PartnR.Client
Jwt__ExpireMinutes	Durée de validité du token	1440 (24h)
Cors__AllowedOrigins__0	Origine CORS autorisée	http://localhost:5173

Frontend web

Variable	Description	Défaut
VITE_API_URL	URL du backend	http://localhost:5001

Mobile (Expo)

Fichier	Variable	Description
mobile/config.ts	API_URL	URL du backend (modifiable directement)

Licence

MIT