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
.envproduction à 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)
- Sauvegarder
.envetstorage/(uploads, apk, backups) existants. - Uploader l’archive via FTP, SFTP ou panel (cPanel, Plesk…).
- Extraire par-dessus l’installation Laravel (ne pas écraser
.env). - 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 --forceaprè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é :
- Activer Exiger la 2FA (optionnel)
- Configurer Whitelist IP (IPv4 ou CIDR, ex.
196.47.0.0/24) - Activer Alertes nouvelle IP si souhaité
- Chaque utilisateur : Mon compte → Configurer la 2FA (Google Authenticator)
Menu Administration → Historique connexions (permission security.login_logs.view).
8. APK mobile
- 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
- Télécharger l’APK depuis expo.dev, renommer en
shopmanager-pro.apk - Déposer :
storage/app/public/apk/shopmanager-pro.apk(voirstorage/app/public/apk/README.md) php artisan storage:linksi le lien public n’existe pas- Renseigner
MOBILE_APP_*(version 1.0.2 / code 3 alignés surpos-mobile/app.config.js) - Page publique :
https://app.shopmanagerpro.net/telechargement-apk - 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