SACC AppEngine Project: Poly411

Team members :

- Bounouas Nassim
- Cancela Vaz Joël
- Mortara Johann
- Novac Pierre-Emmanuel
- Rousseau Nikita

Main link

https://polar-winter-218511.appspot.com/

What's done

• Chaque utilisateur doit créer un compte (email comme identifiant). Lien: https://polar-winter-218511.appspot.com/signup.jsp

• Un utilisateur se rend sur une page d'accueil où il peut uploader des fichiers. Lien: https://polar-winter-218511.appspot.com/upload.jsp

• Upload:

  • Chaque fichier uploadé a un identifiant unique qui peut être utilisé par d'autres utilisateurs pour le télécharger.

  • À chaque fois qu'un fichier est uploadé, un email récapitulatif avec un lien de téléchargement est envoyé à l'utilisateur

  • 1MB uploadé = 1 pt gagné

• Download:

  • Une requête est envoyée et par retour d'email on reçoit un lien vers le fichier demandé
  • Ce lien est valide 5 minutes

• Un système de score permet de récompenser les utilisateurs qui uploadent des fichiers populaires

• Un leaderboard est accessible sous forme de page web. Lien: https://polar-winter-218511.appspot.com/users

Scénarios de test

• Le fichier Poly411.postman_collection.json contient l'ensemble des requêtes possibles vers l'API du projet
• Les scénarios utilisent une suite de tests pour vérifier le fonctionnement attendu
  • Chaque Dossier de la Collection est un Scénario.
  • API est un dossier spécial contenant des requêtes particulières. Ce n'est pas un scénario.
• Pour paramétriser les requêtes, des variables de collection sont disponibles.
  • Sur la collection, Edit, puis Variables
  • Nota bene : ne pas confondre les dossiers et les collections.
  • La variable USERNAME2 permet de télécharger le fichier sous un autre homonyme, de sorte à éviter la restriction de l'utilisateur ayant uploadé le fichier.
  • Les fichiers à UPLOADER doivent être spécifiés en amont de l'exécution du scénario !
    • On suggère d'utiliser pikathor.png à la racine du projet
    • Il faut s'assurer que le fichier à uploader est spécifié dans les requêtes d'upload. Passé un temps, Postman remet à zéro le body de la requête.

Execution

Utiliser l'option Runner de Postman, pour chaque scénario, dérouler les requêtes par Dossier.

S'assurer que les fichiers à upload sont spécifiés dans les requêtes.

Création de 6 utilisateurs, 2 Noob, 2 Casual, 2 Leet

Scénario : UsersCreation

Upload et Montée du score d'un Casual vers Leet

Scénario : UploadRewardLevelUpLeet

Download et gain de points à l'uploader

Scénario : DownloadReward

Rate limiter et Téléchargement en parallèle pour différents utilisateurs

Scénario : DownloadLimiter

Notes/Bugs

• L'identifiant utilisé dans toutes les requêtes pour identifier l'utilisateur est son nom (au lieu de son email)
• L'identifiant utilisé pour identifier un fichier est son nom avec son extension
• Possibilité de "s'auto-boost" en téléchargeant ses propres fichiers.
• Ne pas utiliser de fichiers contenant des espaces.

TODO

• Déduplication des fichiers

Commands

Launch DB

gcloud beta emulators datastore start # Local only

Launch server

launch_server.cmd

Create Bucket on Google Cloud Storage

gsutil mb gs://polar-winter-218511
gsutil defacl set public-read gs://polar-winter-218511

Push an update to AppEngine

mvn appengine:update