Ronin Fight Team

Application mobile et web du club Ronin Fight Team. Elle centralise les membres, cours et présences, adhésions, documents, annonces, calendriers, compétitions, salons de discussion, grades, palmarès et covoiturages.

Le produit est actuellement en phase bêta. Le backend de production est hébergé sur Fly.io et utilise Neon PostgreSQL.

Architecture

• Application : Expo SDK 56, React Native 0.85, Expo Router et TypeScript.
• API : Hono sous Node.js.
• Authentification : Better Auth avec jetons Bearer.
• Base de données : Neon PostgreSQL avec Drizzle ORM et postgres-js.
• Notifications : centre persistant et Expo Push API.
• Cartographie : Apple Maps sur iOS, adresses et itinéraires via la GéoPlateforme IGN.
• Médias : stockage objet S3-compatible pour les avatars.
• Emails : fournisseur transactionnel Resend pour vérification et récupération.
• Déploiements : EAS pour l’application, Fly.io pour l’API.

La référence à utiliser pour toute évolution Expo est la documentation exacte de SDK 56.

Installation locale

Prérequis : Node.js 20.19 ou supérieur et npm.

npm install
npm --prefix server install

Créer un fichier .env à la racine :

EXPO_PUBLIC_API_URL=http://localhost:3001

Copier server/.env.example vers server/.env, puis renseigner une base Neon et un secret Better Auth.

Lancer l’API et l’application dans deux terminaux :

npm --prefix server run dev
npm start

Contrôles

# TypeScript, ESLint, backend TypeScript et tests backend
npm run check

# Vérification des versions compatibles Expo 56
npx expo install --check

# Export web de production
npx expo export --platform web

Les tests backend utilisent le runner natif de Node via tsx --test. Les tests d’intégration exigent exclusivement une base locale nommée rft_test :

TEST_DATABASE_URL=postgresql://postgres:postgres@localhost:5432/rft_test \
  npm --prefix server run test:integration

Migrations

Les réactions et réponses aux annonces, les états lu/non-lu, les préférences et les contraintes d’idempotence nécessitent la migration suivante :

psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260812_functional_completeness.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260812_production_readiness.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260814_geolocation.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260815_competition_results.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260818_result_validation_rankings.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260818_chat_media_receipts.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260823_club_management.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260824_messaging_ux.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260824_carpool_training.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f server/migrations/20260824_chat_polls.sql

La migration 20260823_club_management.sql ajoute les saisons, cours récurrents, réservations et listes d’attente, appels et essais, profils famille, formules d’adhésion et paiements, documents membres, page publique, formulaires de contact et campagnes email. Les migrations récentes activent aussi la soumission de résultats par les athlètes avec validation coach, les rappels automatiques à J+1, les classements par ceinture/P4P, les réponses/réactions et sondages dans le chat, ainsi que les covoiturages liés aux entraînements. Les rappels sont contrôlables avec DISABLE_RESULT_REMINDERS=true dans les environnements où un autre ordonnanceur est utilisé.

Après la migration de géolocalisation, compléter les coordonnées des données existantes :

npm --prefix server run backfill:geolocation

Avant toute exécution en production : effectuer une sauvegarde Neon, vérifier la cible de DATABASE_URL, puis relire le plan de migration. La migration supprime uniquement les doublons de réservations et de jetons push avant de créer leurs index uniques.

Structure principale

src/app/                 écrans et routes Expo Router
src/hooks/               chargement des données et logique applicative
src/context/             authentification et thème
src/lib/                 client API et contrats TypeScript
server/src/routes/       routes HTTP
server/src/db/           schéma Drizzle et connexion Neon
server/src/middleware/   contrôles de session et de rôle
server/test/             tests backend

Configuration de production restante

• Ajouter RESEND_API_KEY et EMAIL_FROM aux secrets Fly.io pour livrer réellement les emails.
• Ajouter les variables S3_* aux secrets Fly.io, puis exécuter npm run migrate:avatars --prefix server pour sortir les avatars historiques de PostgreSQL.
• Faire valider les mentions légales et la politique de confidentialité par le responsable du club ou son conseil.
• Traiter les alertes npm audit restantes uniquement avec des mises à jour compatibles Expo 56 ; ne pas utiliser npm audit fix --force.

Ne jamais exécuter db:push contre la production sans revue préalable du schéma et sauvegarde vérifiée.