Aller à l'article
Aniq-UI

HollinaLancer l'activité de réservation en local

Lancer l'activité de réservation en local

Installez et démarrez chaque application avec Node.js et Yarn, un terminal par application.

Pour le pack Full Stack

DockerRecommandéInstallation manuelle

Avant de commencer : installez Node.js 22 ou plus récent et lancez corepack enable une fois (sous Node.js 25 et plus récent, qui n'inclut plus Corepack, lancez d'abord npm install -g corepack). Aucun serveur de base de données n'est nécessaire.

Voir la configuration requise

Ouvrez chaque terminal là où les commandes ci-dessous l'attendent : dans hollina-vacation-rental-full-stack pour la pile complète, ou à côté du dossier de l'application pour un pack à application unique.

ApplicationDossierAdresse
APIback-endlocalhost:8000Local
Site des séjoursstorefrontlocalhost:3030Local
Tableau de bord des réservationsadmin-dashboardlocalhost:3031Local

Démarrez l'API en premier : les deux frontends lisent toutes leurs données à partir de l'API.

Démarrez l'API

  1. Installez et configurez

    .env.example fonctionne tel quel pour le développement local : SQLite sur le port 8000, et aucune clé de paiement, donc le simulateur fourni accepte toute réservation par carte et par PayPal.

    Terminal
    corepack enable
cd back-end
yarn install
cp .env.example .env
    Un problème ?

  2. Créez la base de données

    yarn seed vérifie que chaque photographie du seed est présente, puis crée database.sqlite, ses tables et la société de démonstration : 32 permissions, les rôles Super Admin et Manager, les deux comptes, 15 paramètres de société, 18 équipements, 6 destinations, 14 séjours (12 publiés, 2 brouillons) avec 42 photographies, 6 questions pour la page d'accueil, 60 réservations, 8 plages bloquées, 12 demandes et 24 avis. Les dates sont stockées comme des décalages par rapport au jour du seed, donc il y a toujours des arrivées aujourd'hui.

    Terminaldans back-end
    yarn seed

  3. Démarrez le serveur

    Terminaldans back-end
    yarn dev

    Résultat attendu: localhost:8000/api/healthLocal répond avec "status":"ok" et "database":"up".

    Un problème ?

Démarrez l'API

  1. Installez et configurez

    .env.example fonctionne tel quel pour le développement local : SQLite sur le port 8000, et aucune clé de paiement, donc le simulateur fourni accepte toute réservation par carte et par PayPal.

    Terminal
    corepack enable
cd hollina-backend
yarn install
cp .env.example .env
    Un problème ?

  2. Créez la base de données

    yarn seed vérifie que chaque photographie du seed est présente, puis crée database.sqlite, ses tables et la société de démonstration : 32 permissions, les rôles Super Admin et Manager, les deux comptes, 15 paramètres de société, 18 équipements, 6 destinations, 14 séjours (12 publiés, 2 brouillons) avec 42 photographies, 6 questions pour la page d'accueil, 60 réservations, 8 plages bloquées, 12 demandes et 24 avis. Les dates sont stockées comme des décalages par rapport au jour du seed, donc il y a toujours des arrivées aujourd'hui.

    Terminaldans hollina-backend
    yarn seed

  3. Démarrez le serveur

    Terminaldans hollina-backend
    yarn dev

    Résultat attendu: localhost:8000/api/healthLocal répond avec "status":"ok" et "database":"up".

    Un problème ?

Relancer le seed

Il remet les lignes de démonstration en place

yarn seed identifie chaque ligne qu'il fournit par une clé stable (le S001 d'un séjour, le B0001 d'une réservation, le nom d'un paramètre). Le relancer n'ajoute rien en double et ne réinitialise jamais un mot de passe, mais il remet chaque séjour, destination, réservation, blocage, demande, avis, question d'accueil et paramètre de société fournis à leurs valeurs d'origine, avec les dates décalées au nouveau jour ; le nom de votre société, vos coordonnées et toute modification d'un séjour de démonstration sont donc remplacés. Les séjours, réservations et tout ce que vous avez créé vous-même sont conservés. Lancez-le une fois sur une base neuve, pas sur une base devenue la vôtre.

Démarrer le site des séjours

Dans un deuxième terminal :

  1. Installez et configurez

    Le .env copié fait pointer le site vers l'API sur le port 8000.

    Terminal
    cd storefront
yarn install
cp .env.example .env

  2. Démarrez l'application

    yarn dev copie d'abord le worker de la bibliothèque de cartes dans public/maplibre/, puis démarre le site.

    Terminaldans storefront
    yarn dev

    Résultat attendu: localhost:3030Local ouvre le site en anglais avec les séjours de démonstration ; l'arabe est sur /ar.

    Un problème ?

Démarrer le site des séjours

L'API ne fait pas partie de ce pack. Démarrez-la en premier ; le .env copié l'attend sur http://localhost:8000/api.

  1. Installez et configurez

    Si votre API tourne ailleurs, définissez NEXT_PUBLIC_API_BASE_URL dans .env avec son adresse, /api compris.

    Terminal
    corepack enable
cd hollina-website
yarn install
cp .env.example .env
    Un problème ?

  2. Démarrez l'application

    yarn dev copie d'abord le worker de la bibliothèque de cartes dans public/maplibre/, puis démarre le site.

    Terminaldans hollina-website
    yarn dev

    Résultat attendu: localhost:3030Local ouvre le site avec les séjours de votre API ; l'arabe est sur /ar.

    Un problème ?

Démarrer le tableau de bord des réservations

Dans un troisième terminal :

  1. Installez et configurez

    Le .env copié fait pointer le tableau de bord vers l'API et ses notifications en direct sur le port 8000.

    Terminal
    cd admin-dashboard
yarn install
cp .env.example .env

  2. Démarrez-le et connectez-vous

    Terminaldans admin-dashboard
    yarn dev

    Résultat attendu: localhost:3031Local ouvre le formulaire de connexion. Connectez-vous avec admin@hollina.example et le mot de passe Admin@123.

    Un problème ?

Démarrer le tableau de bord des réservations

L'API ne fait pas partie de ce pack. Démarrez-la en premier ; le .env copié l'attend sur http://localhost:8000/api.

  1. Installez et configurez

    Si votre API tourne ailleurs, définissez dans .env NEXT_PUBLIC_API_BASE_URL (avec /api) et NEXT_PUBLIC_WEBSOCKET_BASE_URL (sans) avec son adresse.

    Terminal
    corepack enable
cd hollina-booking-dashboard
yarn install
cp .env.example .env
    Un problème ?

  2. Démarrez-le et connectez-vous

    Terminaldans hollina-booking-dashboard
    yarn dev

    Résultat attendu: localhost:3031Local ouvre le formulaire de connexion. Connectez-vous avec admin@hollina.example et le mot de passe Admin@123, qu'accepte une API avec seed.

    Un problème ?

Autres ports

Sans Docker, les ports sont fixés dans les fichiers. Les scripts dev et start du site dans package.json passent -p 3030, et ceux du tableau de bord passent -p 3031 : changez le nombre à cet endroit pour en déplacer un, puis ajoutez la nouvelle adresse à CORS_ORIGIN dans le .env de l'API ; pour le tableau de bord, définissez-y aussi FRONTEND_URL avec cette adresse, et pour le site SITE_URL. Pour déplacer l'API, définissez PORT et PUBLIC_MEDIA_URL dans son .env avec le même nombre, et NEXT_PUBLIC_API_BASE_URL dans les deux frontends (ainsi que NEXT_PUBLIC_WEBSOCKET_BASE_URL pour le tableau de bord).

Build de production

Les mêmes dossiers, construits une fois puis démarrés. Commencez par régler le .env de l'API pour la production : avec NODE_ENV=production, l'API ne modifie jamais les tables au démarrage, et elle refuse de démarrer tant que JWT_SECRET est vide ou encore à la valeur de l'exemple, ou tant que CORS_ORIGIN est vide.

Le .env de l'API
NODE_ENV=production
JWT_SECRET=paste-the-generated-secret-here
CORS_ORIGIN=http://localhost:3030,http://localhost:3031
FRONTEND_URL=http://localhost:3031
SITE_URL=http://localhost:3030
PUBLIC_MEDIA_URL=http://localhost:8000/media

Générez le secret avec node -e "console.log(require('crypto').randomBytes(48).toString('hex'))". Ensuite, dans le dossier de l'API, construisez-la, créez ses tables une fois, puis démarrez-la. yarn seed:prod ajoute la société de démonstration et ses comptes ; yarn db:sync:prod à sa place crée des tables vides sans compte.

Terminal
yarn build
yarn seed:prod
yarn start:prod

Build de production des frontends

Dans le dossier de chaque frontend, lancez le build une fois puis démarrez. Le site répond sur 3030 et le tableau de bord sur 3031.

Terminal
yarn build
yarn start

Les frontends compilent leur .env au moment du build : relancez donc yarn build après l'avoir modifié. Avant de déployer quoi que ce soit de public, lisez le guide de déploiement.

Repartir de données de démonstration neuves

Arrêtez l'API, puis, dans le dossier de l'API, supprimez le fichier de la base de données et recréez-la avec les données de démonstration. Cela supprime tout ce que vous avez créé.

Terminal
rm -f database.sqlite* && yarn seed

Dans PowerShell :

Terminal
Remove-Item database.sqlite*; yarn seed

Étapes suivantes

Cette page vous a-t-elle aidé ?

Vérifié sur la version 2026-10-16

Bloqué sur une étape ?

Trouvez une solution avant de tout recommencer.

Dépannage

Préférences des Cookies

Nous utilisons des cookies pour améliorer votre expérience de navigation, analyser le trafic du site et personnaliser le contenu. En cliquant sur "Accepter Tout", vous consentez à notre utilisation des cookies pour l'analyse et la publicité personnalisée.