Refactor environment variables and enhance installation documentation. Updated DATABASE_URL, NEXT_PUBLIC_MEDUSA_BACKEND_URL, ADMIN_CORS, and STORE_CORS to align with the revised internal DNS structure. Included additional guidelines for DNS nomenclature and clarified Git deployment instructions in INSTALLATION.md.

1 files changed, 103 insertions, 0 deletions

diff --git a/INSTALLATION.md b/INSTALLATION.md
index 69bcd4c..359abe0 100644
--- a/INSTALLATION.md
+++ b/INSTALLATION.md
@@ -9,6 +9,24 @@ Assurez-vous d'avoir :
 - Une base de données **PostgreSQL** accessible (version 12+ recommandée).

 - **Apache** installé sur la machine hôte.

 

+## 1.1 Nomenclature DNS (ruka.lan)

+

+Objectif : utiliser des noms internes stables sur `ruka.lan`, puis ouvrir les mêmes

+noms en DNS public plus tard avec un minimum d'adaptations.

+

+Format recommande :

+```

+<service>.<projet>.<site>.ruka.lan

+```

+

+Exemples pour Lucien Sens Bon (projet `lsb`) sur `huitral` :

+- `www.lsb.huitral.ruka.lan` : storefront (site public)

+- `api.lsb.huitral.ruka.lan` : API Medusa

+- `admin.lsb.huitral.ruka.lan` : admin (optionnel, sinon /app sur l'API)

+

+Conseil : gardez cette nomenclature pour tous vos projets afin de pouvoir passer

+en DNS public sans changer les URLs dans l'application.

+

 ## 2. Configuration Initiale

 

 1. **Variables d'environnement** :

@@ -22,6 +40,43 @@ Assurez-vous d'avoir :
    

    *Note : Si votre Postgres est sur la machine hôte (hors Docker), utilisez `host.docker.internal` comme hôte dans l'URL de connexion, ou l'IP locale du serveur.*

 

+   Exemple de valeurs utilisées dans ce projet (PostgreSQL sur `npagnun`) :

+   ```ini

+   DATABASE_URL=postgres://luciensbdb:VOTRE_MOT_DE_PASSE_DB@192.168.99.35:5432/sens_bon_db

+   NEXT_PUBLIC_MEDUSA_BACKEND_URL=http://api.lucien-sens-bon.com

+   ADMIN_CORS=http://api.lucien-sens-bon.com

+   STORE_CORS=http://lucien-sens-bon.com

+   ```

+   

+   Édition avec `vim` :

+   ```bash

+   vim .env

+   ```

+

+## 2.1 Dépôt Git (Chillka) et récupération sur Huitral

+

+Cette section est à faire **avant** le reste si vous déployez depuis Git.

+

+### 2.1.1 Corriger le HEAD du dépôt bare (Chillka)

+

+Sur `chillka` :

+```bash

+git --git-dir=/var/data/git/repositories/lucien-sens-bon.git symbolic-ref HEAD refs/heads/main

+```

+

+### 2.1.2 Cloner le projet sur `huitral`

+

+Sur `huitral` :

+```bash

+cd /var/www

+git clone toshiro@chillka:/var/data/git/repositories/lucien-sens-bon.git

+cd lucien-sens-bon

+git fetch origin

+git checkout -b main origin/main

+```

+

+> Si votre branche distante est `master`, remplacez `main` par `master` dans les commandes ci‑dessus.

+

 ## 3. Installation et Démarrage

 

 Lancez les conteneurs (cela va construire les images Backend et Storefront) :

@@ -30,6 +85,8 @@ Lancez les conteneurs (cela va construire les images Backend et Storefront) :
 docker-compose up -d --build

 ```

 

+> Sur Debian 13, utilisez de préférence `docker compose` (sans tiret) si le plugin est installé.

+

 Cela va démarrer 3 conteneurs :

 - `medusa-backend` (API) sur le port 9000

 - `medusa-storefront` (Site Web) sur le port 8000

@@ -75,6 +132,52 @@ Pour rendre le site accessible depuis le web (port 80/443), configurez Apache su
 - **Storefront** : Accédez à `http://lucien-sens-bon.com` (ou votre domaine). Vous devriez voir la page d'accueil.

 - **Admin** : Accédez à `http://api.lucien-sens-bon.com/app` (le dashboard admin est servi par le backend). Connectez-vous avec l'utilisateur créé à l'étape 4.

 

+## 7. Dépôt Git (Chillka) et déploiement sur Huitral

+

+Cette section documente la mise en place du dépôt Git **bare** sur le serveur `chillka` et le déploiement du projet sur `huitral`.

+

+### 7.1 Créer le dépôt bare sur `chillka`

+

+Sur `chillka` (root ou sudo) :

+```bash

+sudo mkdir -p /var/data/git/repositories/lucien-sens-bon.git

+sudo git init --bare /var/data/git/repositories/lucien-sens-bon.git

+sudo chown -R toshiro:git-group-users /var/data/git/repositories/lucien-sens-bon.git

+```

+

+### 7.2 Corriger les permissions (si `Permission denied`)

+

+Le dossier parent doit être accessible au groupe `git-group-users` :

+```bash

+sudo chgrp -R git-group-users /var/data/git/repositories

+sudo chmod -R 2775 /var/data/git/repositories

+```

+

+### 7.3 Pousser le projet vers `chillka` (depuis votre machine locale)

+

+Dans le dossier du projet :

+```bash

+git init

+git add .

+git commit -m "Initial commit: Medusa Backend + Storefront + Config"

+git remote add origin toshiro@chillka:/var/data/git/repositories/lucien-sens-bon.git

+git push -u origin main

+```

+

+> Si votre branche locale s'appelle `master`, utilisez :

+> ```bash

+> git push -u origin master

+> ```

+

+### 7.4 Récupérer le projet sur `huitral`

+

+Sur `huitral` :

+```bash

+cd /var/www

+git clone toshiro@chillka:/var/data/git/repositories/lucien-sens-bon.git lucien-sens-bon

+cd lucien-sens-bon

+```

+

 ## 7. Paiements Crypto

 

 Pour activer les paiements Crypto, nous vous conseillons d'installer un plugin comme `medusa-payment-coinbase` ou d'utiliser une intégration Stripe Crypto si disponible.