Déploiement production

Lien isolé Accueil docs Formation
Déploiement

Checklist prod : Git/WSL, ZIP/FTP, migrate, caches, add-ons.

Déploiement production — ShopManager Pro

Checklist opérationnelle pour https://app.shopmanagerpro.net
Dernière mise à jour : septembre 2026 (Phase 3)

Rappel rapide (affichage seul) :

.\scripts\deploy-production-checklist.ps1
# ou : bash scripts/deploy-production-checklist.sh

1. Prérequis

  • Accès SSH ou FTP/SFTP au serveur Laravel
  • Accès Git (optionnel — voir §2b si push impossible)
  • Sauvegarde BDD avant migration
  • Fichier .env production à jour (ne jamais committer)
  • Lien storage : php artisan storage:link (une fois)

2a. Pousser le code (Git — si auth OK)

Pas de mot de passe Git classique. Le dépôt est sur origin.cursor.com : l’auth se fait via votre compte Cursor (navigateur), pas email/mot de passe Git.

Windows (PowerShell) — souvent bloqué

Git Credential Manager peut refuser le token. Message typique : « your access token was not accepted ».

WSL/Ubuntu — méthode recommandée

# 1. Une fois : installer WSL + Ubuntu si besoin
wsl --install -d Ubuntu

# 2. Connexion Cursor (ouvre le navigateur — pas de username/password à saisir)
wsl bash -lc '/root/.local/bin/origin auth login'
# ou script complet :
.\scripts\setup-cursor-origin-remote.ps1

# 3. Push
wsl bash -lc "cd '/mnt/e/projet shopmanager pro/boutique-app_v2' && bash scripts/push-origin-main-wsl.sh"

Lors de origin auth login : cliquez sur le lien ou la fenêtre navigateur et connectez-vous avec le même compte Cursor que l’IDE. Aucun champ « username / password Git » à remplir.

cd "e:\projet shopmanager pro\boutique-app_v2"
git push origin master:main   # fonctionne seulement si GCM Windows est aussi à jour

Si Git Credential Manager bloque encore : utiliser le script WSL ci-dessus ou §2b (ZIP/FTP).

Puis sur le serveur : git pull origin main (§3).


2b. Déploiement sans Git (ZIP / FTP) — recommandé si push bloqué

Poste développeur — créer l’archive

cd "e:\projet shopmanager pro\boutique-app_v2"
.\scripts\pack-deploy-release.ps1
# Avec vendor/ pré-installé (connexion lente au serveur) :
.\scripts\pack-deploy-release.ps1 -IncludeVendor

Linux / macOS :

bash scripts/pack-deploy-release.sh
bash scripts/pack-deploy-release.sh --include-vendor

Archive générée : storage/app/releases/shopmanager-pro-deploy-YYYY-MM-DD_HHmmss.zip (ou .tar.gz).

Upload & extraction (serveur)

  1. Sauvegarder .env et storage/ (uploads, apk, backups) existants.
  2. Uploader l’archive via FTP, SFTP ou panel (cPanel, Plesk…).
  3. Extraire par-dessus l’installation Laravel (ne pas écraser .env).
  4. Conserver : .env, storage/app/public/, fichiers clients déjà uploadés.

Post-déploiement automatique (SSH)

cd /chemin/vers/boutique-app_v2
bash scripts/deploy-server-post-upload.sh

Variables : SKIP_COMPOSER=1 ou SKIP_MIGRATE=1 si besoin.


3. Sur le serveur — mise à jour (Git ou ZIP)

cd /chemin/vers/boutique-app_v2
git pull origin main
composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan queue:restart   # si workers actifs

Permissions gérant (historique connexions) si la migration n’a pas déjà tourné :

php artisan mobile:sync-manager-permissions

4. Variables .env production

Référence complète : voir .env.example (sections SECURITY_*, MOBILE_APP_*, SAAS_*, paiements).

APP_URL=https://app.shopmanagerpro.net
APP_ENV=production
APP_DEBUG=false

# Support commercial / agent IA
SAAS_SUPPORT_WHATSAPP=243828384820

# Sécurité renforcée (seuils globaux ; le module reste gated par add-on boutique)
SECURITY_MAX_LOGIN_ATTEMPTS=3
SECURITY_PASSWORD_MAX_AGE_DAYS=90
SECURITY_PASSWORD_MIN_LENGTH=8
SECURITY_TOTP_ISSUER="ShopManager Pro"
SECURITY_HSTS_ENABLED=true

# Application mobile (page /telechargement-apk)
MOBILE_APP_LATEST_VERSION=1.0.2
MOBILE_APP_LATEST_ANDROID_VERSION_CODE=3
MOBILE_APP_FORCE_UPDATE=false
MOBILE_APP_DOWNLOAD_URL=https://app.shopmanagerpro.net/storage/apk/shopmanager-pro.apk
MOBILE_APP_RELEASE_NOTES=Corrections et améliorations.

# Sauvegardes premium (optionnel — add-on par boutique)
BACKUP_RETENTION_COUNT=10
BACKUP_PREMIUM_RETENTION_COUNT=30
# BACKUP_CLOUD_ENABLED=true
# BACKUP_CLOUD_DISK=s3

Après modification :

php artisan config:cache

5. Migrations récentes (sept. 2026)

Migration Contenu
2026_09_04_160000_backfill_saas_support_whatsapp WhatsApp support SaaS
2026_09_04_170000_add_security_module_tables 2FA, login_logs, champs sécurité users
2026_09_04_180000_add_sessions_invalidated_and_backfill_password_changed Sessions invalidées, MDP
2026_09_04_190000_add_security_login_logs_permission_to_manager Permission security.login_logs.view gérant
2026_09_04_200000_add_login_logs_performance_indexes Index perf login_logs
2026_09_04_210000_add_unlock_token_to_users_table Token hashé déblocage email (usage unique)

Vérifier :

php artisan migrate:status

Local : ces migrations sont déjà appliquées sur l’environnement de développement. En prod, migrate --force après backup.


6. Activation add-ons par boutique (contrôlée)

Ne pas activer toutes les boutiques en masse. Passer les IDs clientes explicitement.

CLI (recommandé en prod)

# Voir l’état
php artisan shop:addon list
php artisan shop:addon list --shop=3

# Simulation puis activation Sécurité renforcée
php artisan shop:addon enable enhanced_security --shop=3 --dry-run
php artisan shop:addon enable enhanced_security --shop=3

# Plusieurs boutiques clientes
php artisan shop:addon enable enhanced_security --shop=3,7,12

# Désactiver
php artisan shop:addon disable enhanced_security --shop=3

Clés utiles : enhanced_security, premium_backups, expenses, hr, sfn, subdomain.

UI

Admin plateforme (super-admin) → Boutiques → édition → cases add-ons :

Add-on Clé Usage
Sécurité renforcée enhanced_security 2FA, verrouillage, journaux, whitelist IP
Sauvegardes premium premium_backups Rétention 30 j, alertes échec, S3 optionnel

Sans add-on activé, le module sécurité reste invisible pour la boutique.


7. Configuration boutique (gérant)

Paramètres → Sécurité :

  1. Activer Exiger la 2FA (optionnel)
  2. Configurer Whitelist IP (IPv4 ou CIDR, ex. 196.47.0.0/24)
  3. Activer Alertes nouvelle IP si souhaité
  4. Chaque utilisateur : Mon compte → Configurer la 2FA (Google Authenticator)

Menu Administration → Historique connexions (permission security.login_logs.view).


8. APK mobile

  1. Build EAS (depuis pos-mobile/) :
cd pos-mobile
npm install
npm run eas:login    # si besoin
npm run build:apk    # profil production → APK, API https://app.shopmanagerpro.net/api/mobile
  1. Télécharger l’APK depuis expo.dev, renommer en shopmanager-pro.apk
  2. Déposer : storage/app/public/apk/shopmanager-pro.apk (voir storage/app/public/apk/README.md)
  3. php artisan storage:link si le lien public n’existe pas
  4. Renseigner MOBILE_APP_* (version 1.0.2 / code 3 alignés sur pos-mobile/app.config.js)
  5. Page publique : https://app.shopmanagerpro.net/telechargement-apk
  6. Alias : /download/apk

Détails : pos-mobile/BUILD_APK.md. Ne pas committer les .apk.


9. Vérifications post-déploiement

php artisan audit:functional
php artisan test --filter=AccountSecurityTest
php artisan test --filter=ShopAddonCommandTest
php artisan test --filter=Phase5AddonsTest

Manuel :

  • Login web avec compte test
  • Login mobile avec 2FA (otp_code)
  • Page téléchargement APK accessible + lien APK
  • Add-on sécurité actif uniquement sur les boutiques ciblées
  • Rapport caisse — comparaison 2 sessions
  • Whitelist IP bloque une IP non autorisée
  • Cron sauvegarde (backup:auto) si planifié

10. Rollback (urgence)

git checkout <commit_precedent>
composer install --no-dev
php artisan migrate:rollback --step=1   # avec prudence
php artisan config:cache

Restaurer la BDD depuis la sauvegarde si migration destructive.


11. Contacts

  • Support WhatsApp : +243 828 384 820
  • Doc agent IA : /docs/agent-ia-support-client.html