resavo

KO | EN

gitlite — search

#hacktoberfest #typescript #llm #go #android #machine-learning #rust #linux #nodejs #java #windows #awesome #security #pytorch

(★ 19)

Système de réservation open source "clef en main" #codeWithLove

resavo Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RESAVO
- Follow @ActuSenzo -- #CodeWithLove #Resavo

## PRÉSENTATION

RESAVO est un projet Open-Source, l'idée est de créer un système de réservation "clef en main" en y apportant des fonctionnalités avec les dernières technologies.<br>
Nous essayerons de répondre à un large éventail de cas d'usage possible. Nous essayerons de créer une UI & UX avancée.<br>
J'ai fait le choix de créer les ISSUES en français pour faciliter la compréhension aux développeurs débutants.<br>
Nous essayerons de rendre ce projet le plus générique possible et personnalisable (du choix de la couleur du thème, au choix entre Paypal ou Stripe…).

Le projet sous sa forme actuelle a été fait avec une personnalisation spécifique. Vous trouverez sûrement du code à jeter/modifier.

![Screenshot](https://raw.githubusercontent.com/senzowayne/resavo/master/screenshots/resa.png)
__(Ancien design)__

## COMMENT CONTRIBUER ?

Rendez-vous dans l'onglet "ISSUE". C'est ici qu'on liste les tâches à effectuer.

Une fois que vous avez repéré une ISSUE, assignez-vous celle-ci.
Ensuite, vous devez "fork" le repository "resavo" en cliquant sur le bouton `Fork` sur Github.

Puis, vous clonez le nouveau repository :

```
git clone git@github.com:USERNAME/resavo.git
```

Et ajoutez le référent, une fois dans le dossier "resavo" :

```
cd resavo
git remote add upstream git://github.com/senzowayne/resavo.git
```

Vous êtes prêt pour créer votre branche portant le nom de l'ISSUE.

Vous effectuerez votre travail dessus. Après avoir commit 
(en suivant toujours la convention de nommage ```ISSUE-#22 : <la tâche réalisée au sens précis>```) et push votre travail, vous pouvez passer à l'étape suivante, qui est d'ouvrir une Pull Request. On imposera une convention en la nommant ainsi :

`ISSUE-#22 : <la tâche réalisée au sens large>`

> **Concentrez-vous vraiment sur la tâche choisie. Ne mélangez pas une correction que vous auriez envie de faire dans une tâche qui n'a rien à voir.
> Il est souvent facile de s'éparpiller…**

Si vous estimez que vous avez fini votre travail vous pouvez le labelliser en "Prêt pour relecture".
Les contributeurs pourront relire et proposer des corrections ou suggestions à apporter à votre travail.
Une fois celui-ci validé par au moins 2 contributeurs votre travail sera en mesure d'être fusionné dans la branche "master".
Vous pourrez ensuite retourner sur votre branche "master" en local et effectuer un `git pull`.

Pensez à supprimer vos branches au fur et à mesure pour ne pas finir avec d'innombrables branches inutiles.

## INSTALLATION
(__pré-requis docker__)

Exécutez d'abord ces commandes :

```
$ git clone git@github.com:USERNAME/resavo.git
$ cd resavo/
$ make start
```

Vous pouvez executer la commande suivante pour voir la liste des commandes disponibles
```
$ make
```
Le temps que le projet s'initialise tu peux aller boire un café ☕️

Lien : http://127.0.0.1 ou http://localhost

Vous devriez à present voir la page d'accueil du projet, avec la possibilité de vous inscrire et de vous connecter.
Le chargement des fixtures nous aura créé quelques éléments pour commencer.

Créez ensuite un fichier `.env.local` avec comme variable d'environnement :

```
CLIENT_ID=
CLIENT_SECRET=
```

Ces variables contiendront les identifiants de vos systèmes de paiement.

### Installation sans docker

Exécutez d'abord ces commandes :

```
$ git clone git@github.com:USERNAME/resavo.git
$ cd resavo/
```

Assurez vous d'avoir les bonnes versions de Composer (2.2) et de Php (8.0). Pour vérifier :

```
$ composer -v
$ php -v
```

Il nous faut installer le projet avec composer. Vous pouvez exécuter cette commande afin de pouvoir exploiter le projet en ligne de commande :

```
$ composer install
```

Vous pouvez enfin exécuter la commande suivante pour voir la liste des commandes disponibles :

```
$ php bin/console
``` 
Pour lancer un serveur php, exécuter la commande suivante (pré-requis : Symfony CLI):

```
symfony server:start
```
Lancez enfin votre projet.

Lien : http://127.0.0.1 ou http://localhost

Pour mettre en place votre base de données, créez une fichier .env.local avec comme variable d'environnement :

```
DATABASE_NAME=resavo
DATABASE_HOST=localhost
DATABASE_PORT=3306
DATABASE_USER=!ChangeMe!
DATABASE_PASSWORD=!ChangeMe!

DATABASE_URL="mysql://USER:PASSWORD@HOST:3306/DBNAME?serverVersion=8.0"
```

Une fois les variables initialisées, vous pouvez commencer à créer la base de données :

```
$ php bin/console doctrine:database:create
$ php bin/console doctrine:migration:migrate
```

Nous allons maintenant générer les fixtures :

```
$ php bin/console doctrine:fixtures:load
$ yes
```

Petit rappel, toutes ces tâches sont à effectuer sur le projet cloné de votre fork.

Nous allons maintenant intégrer le gestionnaire de paquet qui n'est pas intégré automatiquement avec composer.

```
$ npm install
$ npm install yarn
$ yarn install
$ yarn encore dev
```
Et voilà ! Vous pouvez enfin lancer le projet et commencer à travailler sur les ISSUES !

### Paypal SANDBOX TEST

Créez votre SANDBOX (celle-ci vous permettra d'effectuer des faux paiements et avoir le réel comportement de l'application) :

Cf : https://developer.paypal.com/docs/api/overview/#create-sandbox-accounts

Vous pouvez dès à présent vous connecter avec un compte admin:

* Identifiant : `admin@resavo.fr`
* Mot de passe : `password`

## Technologies

* Symfony 5.2
* Api Platform Core
* Mercure
* Twig
* Vue Js
* ~~Jquery~~
* Bootstrap

## Credit

Merci à @Marlene78 pour la typo et félicitations pour sa première contribution.

Merci @Yanoucrea pour ses bonnes pratiques de conventions ;)

Merci à @Dev-Int pour ces belles contributions au projet.

resavo

resavo Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

resavo

resavo Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README