Home

Welcome to the AAAccueil wiki!

ℹ️ Vous trouverez ici toutes les ressources vous aidant à bien travailler sur le projet.

Veuillez vérifier que vous avez bien effectué tous les points de la mise en place de l'environnement de développement pour pouvoir travailler sur le projet avec nous.

La section Code décrit nos conventions afin d'uniformiser le code au sein de l'application ainsi que les outils développés en interne et comment s'en servir. En cas de question, prenez la bonne habitude de vous y référer en premier lieu 💙

Mise en place de l'environnement de développement/test en local

Installation de l'environnement de développement

Voir la page

Configuration de votre Serveur de Gestion de Bases de Données

Voir la page

Jeu de données de test

🚧 Work in progress

Connexion avec votre clé SSH à Github

🚧 Work in progress

Mise en marche du serveur web local

cd ~/development/aaaccueil
php bin/console server:run

Puis ouvrir http://127.0.0.1:8000 dans votre navigateur.

ℹ️ Vous pouvez à tout moment rajouter des idées au backlog du projet.

Procédure de développement

Mise en place du sprint

• On créé sur Github une Milestone et un Projet pour la version de l'AAAccueil.
• On vote pour les features en leur donnant une note de 0 à 10 calculée en faisant la moyenne des notes données par les gens (de 0 à 10 également) sur le backlog.
• On estime la difficulté des features les plus populaires (Easy money, Relativement ok, Relou.rar ou щ（ﾟДﾟщ）) sur le backlog.
• En fonction de la durée voulue pour le sprint et de la difficulté des features, on en choisit un certain nombre (parmi les plus populaires).
• Pour chacune d'entre elle, on crée une issue sur Github en lui appliquant le label i- amélioration (i- pour interne).
• On ajoute ces issues à la Milestone du sprint.
• On ajoute ces issues au Projet du sprint dans la colonne À faire.
• On annonce sur le Mattermost que c'est parti !

Développement et tests en local

Développement

• On va dans le Projet correspondant au sprint en cours.
• On choisit une issue dans la colonne À faire et on la déplace dans la colonne En cours de développement.
• On s'assigne à l'issue en cliquant sur le machin Assignees à droite de l'issue et en choisissant son pseudo dans la liste.
• On développe la feature (idéalement, on détaille les trucs en faisant des checklists) en pensant bien à mettre Ref #num_de_l_issue dans les messages de commit concernant l'issue en question.
• Une fois développée, on va dans le Projet correspondant au sprint en cours et on déplace l'issue de la colonne En cours de développement à la colonne À tester.

Tests

• On va dans le Projet correspondant au sprint en cours.
• On choisit une issue dans la colonne À tester et on clique dessus.
• À droite de l'issue se trouve un machin "Assignees" : on clique dessus et dans la liste qui s'ouvre, on clique sur son pseudo : on fait maintenant partie des gens assignés à l'issue.
• On exécute les commandes suivantes :

cd development/aaaccueil
git pull
composer install
php bin/console doctrine:shema:update --force

• On regarde ce qu'il y a écrit dans l'issue et on vérifie que chez soi, ça marche bien.

Si ça marche

=> on ajoute un commentaire sur l'issue "Testé : ça marche" et on clique sur "Close and comment"

=> on retourne dans le Projet correspondant au sprint en cours et on déplace l'issue dans la colonne "Validé"

Si ça ne marche pas

=> on ajoute un commentaire sur l'issue en suivant ce modèle : https://github.com/AAAsso/aaaccueil/issues/16

=> on retourne dans le Projet correspondant au sprint en cours et on déplace l'issue dans la colonne "À faire"

Validation du sprint par les utilisateurs

🚧 Work in progress

Mise en prod

🚧 Work in progress

Code

Conventions

Organisation des fichiers

Voir la page

Routes

Voir la page

Écriture

PHP 🚧 Work in progress

JS 🚧 Work in progress

CSS 🚧 Work in progress

Outils internes

Tableaux

Voir la page