Maating

Alone and want to train ?
Find your mate !

Maating est une application mobile tourné autour de la pratique sportive, l'objectif est de favoriser les rencontres entre les passionnés de sport en participant à des évènements autour de chez vous.

Fonctionnalités principales

• Carte intéractive pour découvrir les évènements sportifs autour de chez vous
• Inscription simplifié
  • Vous ne venez pas tout seul ? Réservation de plusieurs places pour vous et vos amis
• Création d'évènements
• Controlle de l'accès aux évènements
  • Gestion d'évènements privés/publiques
• Système de notation et commentaires entre utilisateurs
  • Garantie de la bienveillance
• Cross platform
  • Supporté sous IOS, Android, Windows, macOS et Linux.

Technologies utilisées

• Flutter
• NodeJS
• Express
• MongoDB

Lancer l'application

# Cloner le repository
$ git clone https://github.com/ugo-prenat/maating.git

Lancer le frontend :

# Aller dans le répertoire frontend
$ cd maating/frontend

# Installer les dépendances
$ flutter packages get

# Lancer l'application
$ flutter run

Lancer le backend :

# Aller dans le répertoire backend
$ cd maating/backend

# Installer les dépendances
$ npm install

# Lancer le serveur
$ npm start

Les requêtes sont envoyées en local au backend via l'adresse http://10.0.2.2:4000

⚠️ Lancer le backend localement comme présenté ci-dessus ne fonctionnera que pour exécuter l'application depuis un émulateur sur votre ordinateur.

Pour exécuter l'application depuis un téléphone physique, il faut indiquer au frontend d'envoyer les requêtes vers un backend hébergé.

Pour lancer l'application depuis un téléphone physique :

# Aller dans le répertoire frontend
cd maating/frontend

# Lancer l'application avec la variable BACK_ENV égale à "remote"
flutter run --dart-define="BACK_ENV=remote" 

Désormais, les requêtes seront envoyées à l'adresse maating-api.up.railway.app

Note La version du backend disponible à cette adresse est celle de la branch main

Exécution des tests

Front

# Aller dans le répertoire frontend
cd frontend

# Exécuter les tests d'intégration
flutter test integration_test

# Exécuter les tests unitaires
flutter test test

Back

# Aller dans le répertoire backend
cd backend

# Exécuter les tests unitaires
npm test

Rapport d'incident

Pour nous signaler un bug ou un comportement anormal sur l'application, rendez-vous sur le Trello Maating disponible ici et créez une nouvelle carte dans la colonne ":beetle: Bugs".

Pour une meilleur compréhension du problème, il est important de préciser le contexte de votre bug ainsi que fournir des captures d'écrans ou des vidéos.

Note Chaque bug créé sera assigné à un développeur de l'équipe Maating et corrigé dans un délai le plus court possible.

⚽