# Danalakshmi Stock — installation cPanel / Node.js

Version autonome préparée le 19 novembre 2026 à partir de la version 44 du site.
Code source de départ : 7840c62ec3a625b24da45e4ddcb2ec7fd0dce942.
Cette livraison n'effectue aucune modification du site actuellement en ligne.

## Ce qui est inclus

Interface et images, connexion par identifiant/mot de passe, gestion des utilisateurs,
catégories, produits et lots avec plusieurs dates, scan navigateur, gestion de casse,
photos, tableaux de bord, PDF, sauvegarde JSON des inventaires et archive des fiches.
Le partage utilise le même serveur ; les vues prévues pour cela se rafraîchissent toutes
les 5 secondes, ce n'est pas une diffusion instantanée par WebSocket.
Le contrôle des doublons conserve son périmètre actuel : par profil.

La connexion propriétaire ChatGPT a été retirée : l'administrateur utilise son propre
identifiant et mot de passe. Les images de connexion alternent comme sur le site.

## Base de données : oui, mais pas de MySQL à créer

Cette version utilise SQLite intégrée à Node.js. Le fichier `data/stock.sqlite` est créé
par la commande de configuration. Les photos vont dans `data/photos`. Le secret des
mots de passe et la configuration se trouvent dans `data/config.json`.
Ne supprime jamais ce dossier : c'est la partie persistante de ton application.
Le dossier doit être sur le disque local du serveur (pas un montage réseau NFS).

## Prérequis à vérifier dans cPanel

- Setup Node.js App avec Node.js **24**, ou **22.13 minimum**. Node 20 ne convient pas.
- Terminal cPanel ou accès SSH.
- Un sous-domaine dédié avec HTTPS actif, par exemple `stock.danalakshmi.fr`.
  Cet exemple n'est pas un domaine configuré par cette livraison.
- L'application doit être montée à la racine `/` de ce sous-domaine.
- Un dossier d'application situé **en dehors de public_html et du document root**.
  Ne dépose pas le code serveur et la base de données dans un dossier servi directement par Apache.

SQLite est fournie par Node.js : aucun paquet npm ni compilation native à installer.
Les installations cPanel varient : les essais de cette livraison ont été effectués
localement sur Node 24, pas sur ton hébergement réel.

## 1. Déposer le ZIP

Dans le Gestionnaire de fichiers cPanel, ouvre ton dossier personnel (`/home/TON_COMPTE`),
puis téléverse `DanalakshmiStock-cPanel.zip` et choisis Extraire.
Le ZIP crée un dossier `DanalakshmiStock-cPanel` contenant `app.js`.
Ne l'extrais pas par-dessus une ancienne installation contenant des données.

Ou, depuis le terminal cPanel si le ZIP est déjà dans ton dossier personnel :

```bash
cd ~
unzip -n DanalakshmiStock-cPanel.zip
cd ~/DanalakshmiStock-cPanel
```

## 2. Créer l'application Node.js

Dans cPanel → Setup Node.js App → Create Application :

| Champ | Valeur |
|---|---|
| Node.js version | 24, ou 22.13 minimum |
| Application mode | Production |
| Application root | DanalakshmiStock-cPanel |
| Application URL | ton sous-domaine HTTPS, chemin `/` |
| Application startup file | app.js |

Clique Create. Un premier démarrage peut échouer tant que l'étape suivante n'est pas faite.
Copie ensuite **la commande d'activation de l'environnement Node affichée par cPanel**
et exécute-la dans le terminal. Son chemin dépend de ton compte et de la version Node :
ne copie pas un chemin provenant d'un autre serveur.

## 3. Initialiser

Dans le terminal **cPanel**, après activation de l'environnement Node :

```bash
cd ~/DanalakshmiStock-cPanel
node --version
node -e "require('node:sqlite'); console.log('SQLite OK')"
node scripts/build.mjs
node scripts/setup.mjs https://stock.danalakshmi.fr
mkdir -p tmp
touch tmp/restart.txt
```

Remplace `https://stock.danalakshmi.fr` par ton vrai sous-domaine, sans chemin.
Si le test SQLite échoue, sélectionne Node 24 dans cPanel avant de continuer.
Un avertissement « ExperimentalWarning: SQLite » n'est pas une erreur.

La commande `setup.mjs` affiche un **lien privé valable une heure**. Ouvre ce lien
complet, y compris sa partie après `#`, après avoir redémarré l'application dans cPanel.
Choisis ton identifiant et ton mot de passe (12 caractères minimum).
Il n'existe aucun mot de passe administrateur prédéfini dans le ZIP.
Si le lien expire avant la création du compte, relance la même commande de setup.

Ensuite, l'équipe se connecte sur `https://TON-SOUS-DOMAINE/connexion`.
Crée ses comptes depuis les paramètres administrateur.

Si cPanel affiche un bouton Restart, utilise-le aussi après la configuration.
N'exécute pas `npm start` en parallèle de Passenger en production.
Le fichier `.htaccess` de gestion de Passenger est géré par cPanel ; conserve-le.

## 4. Activer les alertes e-mail

Les alertes instantanées à l'ajout sont conservées, mais **aucune clé d'envoi réelle
n'est fournie dans ce ZIP**. Dans les variables d'environnement de l'application cPanel,
ajoute :

| Variable | Valeur |
|---|---|
| RESEND_API_KEY | ta clé API Resend |
| REMINDER_FROM | une adresse d'expéditeur autorisée dans ton compte Resend |
| REMINDER_TO | contact@danalakshmi.fr,danalakshmiaccueil@gmail.com |

Redémarre ensuite l'application. Le serveur doit pouvoir joindre l'API Resend en HTTPS.
Cette version conserve le fournisseur HTTP du projet d'origine ; elle ne configure pas
le SMTP cPanel. Les alertes concernent les nouveaux lots expirant dans moins de 3 mois,
si les rappels sont activés pour le profil. Un lot déjà périmé n'entre pas dans ce filtre.
Aucun e-mail de test n'a été envoyé par la livraison du ZIP.

## 5. Données existantes : transfert séparé

**Le ZIP ne contient pas les utilisateurs, mots de passe, stocks, catalogue importé,
historique ou photos privées de l'application actuellement en ligne.**
Il contient les définitions initiales des 39 catégories, pas les modifications éventuelles
faites ensuite en base. La nouvelle installation commence avec une base vide.

Pour un transfert simple d'inventaire actif :
1. Dans l'ancien site, chaque compte exporte sa sauvegarde JSON.
2. Dans le nouveau site, recrée les comptes et, si nécessaire, les catégories personnalisées.
3. Chaque utilisateur importe son JSON depuis les paramètres de son compte.

Limites de ce transfert simple : la sauvegarde JSON ne transporte pas les fichiers photo,
les comptes, l'historique des scans ou les fiches supprimées archivées. Les références de
photos dans le JSON ne rendent pas les anciennes images disponibles sur le nouveau serveur.
Il faudra réajouter ces photos. Le catalogue de suggestions préchargé doit aussi être réimporté.
Pour une migration complète conservant historique et pièces jointes, prévoir un export
séparé de la base et du stockage de l'ancien hébergement avant de basculer l'équipe.
Ne supprime pas l'ancien service avant d'avoir vérifié le transfert.

## 6. Sauvegarder le serveur

Dans le terminal cPanel avec l'environnement Node activé :

```bash
cd ~/DanalakshmiStock-cPanel
node scripts/backup.mjs
```

Cette commande crée `backups/DATE/` avec une copie SQLite cohérente, les photos et le
fichier secret de configuration. Télécharge ce dossier vers un stockage privé externe.
La copie des photos suit la copie de la base : les photos sont immuables et le surplus
éventuel est sans incidence. N'effectue pas de suppression manuelle des photos pendant la copie.

Pour archiver une sauvegarde :

```bash
cd ~/DanalakshmiStock-cPanel
# Remplace DATE par le dossier affiché par la commande précédente.
tar -czf ~/sauvegarde-stock-DATE.tar.gz -C backups DATE
```

Planifie des sauvegardes régulières via les tâches cron de cPanel avec le chemin Node
exact fourni par ton hébergement. L'archive des fiches conserve les données de l'application,
mais une conservation pendant 6 ans exige aussi des sauvegardes externes et un hébergement
maintenu : le ZIP ne garantit pas à lui seul six années de disponibilité.

Restauration : arrête l'application dans cPanel ; garde une copie du dossier `data` actuel ;
remplace-le par le contenu du dossier de sauvegarde choisi (stock.sqlite, config.json, photos).
Ne réutilise pas les anciens fichiers stock.sqlite-wal/stock.sqlite-shm. Redémarre l'application.
La configuration secrète est indispensable pour retrouver les mots de passe existants.

## 7. Récupérer l'accès administrateur

Uniquement depuis ton terminal cPanel :

```bash
cd ~/DanalakshmiStock-cPanel
node scripts/setup.mjs https://stock.danalakshmi.fr --reset-admin
touch tmp/restart.txt
```

Ouvre le nouveau lien privé affiché. Il permet de remplacer le mot de passe administrateur
et invalide ses anciennes sessions à la validation. Les stocks ne sont pas supprimés.

## Vérifications

```bash
cd ~/DanalakshmiStock-cPanel
npm test
```

Les tests utilisent une base temporaire, sans modifier les données de production.
Vérifie également sur ton hébergement : connexion depuis le téléphone, caméra en HTTPS,
ajout d'un lot, photo, rapport PDF, vue partagée depuis un autre compte et réception d'e-mail.

## Application Android / iPhone

Le site est utilisable dans le navigateur et installable comme application web sur le
nouveau domaine. L'ancien projet Android/Xcode continue à pointer vers son ancienne URL :
sa configuration devra être changée et l'application recompilée pour utiliser ce nouvel hébergement.

## Sources techniques

- SQLite dans Node 22 : https://nodejs.org/download/release/v22.23.0/docs/api/sqlite.html
- Setup Node.js App : https://support.cpanel.net/hc/en-us/articles/1500000004602-How-to-create-a-NodeJS-application-via-CloudLinux
- Redémarrage Passenger : https://support.cpanel.net/hc/en-us/articles/1500002443862-How-to-restart-an-application-that-s-using-cPanel-s-Application-Manager
