Plan de finition — ShopManager Pro
Plan global pour terminer le produit. Taux CDF : 1 USD = 2 300 CDF.
Dernière mise à jour : septembre 2026.
Vue d’ensemble des phases
| Phase | Objectif | Statut |
|---|---|---|
| 1 | Sécurité renforcée — compléter les 7 niveaux + paramètres branchés | ✅ Terminée |
| 2 | Mobile : UI 2FA login + sync capabilities | ✅ Terminée |
| 3 | Site & déploiement : APK, commit, prod, permissions | ⏳ Prêt localement (push / migrate / .env prod = manuel) |
| 4 | Documentation & grilles tarifaires alignées | ✅ Terminée |
| 5 | Add-ons restants (sauvegardes premium, SFN offline, rapports, prévisions) | ✅ Terminée (S3 cloud = config serveur optionnelle) |
| 6 | Qualité & durcissement (tests E2E, audit, perf) | ✅ Terminée (6.1–6.6) |
Phase 1 — Sécurité renforcée (complète)
| # | Tâche | Détail |
|---|---|---|
| 1.1 | ✅ 2FA TOTP | Web + API mobile otp_code |
| 1.2 | ✅ Verrouillage compte | 3 tentatives, déblocage admin |
| 1.3 | ✅ Historique connexions | login_logs + page admin |
| 1.4 | ✅ Expiration MDP | 90 j, password_changed_at, écran obligatoire |
| 1.5 | ✅ MDP compromis | Password::uncompromised() si module actif |
| 1.6 | ✅ Paramètres branchés | password_min_length, session_timeout boutique |
| 1.7 | ✅ Sessions strictes | Invalidation au changement MDP + « Déconnecter partout » |
| 1.8 | ✅ Alerte HTTPS | Bandeau paramètres si pas HTTPS en prod |
| 1.9 | ✅ Déblocage email | Lien signé 24 h à usage unique (token hashé) + page /account/unlock-request |
Livraison phase 1 : module sécurité commercialisable tel que décrit dans la doc agent IA.
Phase 2 — Application mobile POS
| # | Tâche |
|---|---|
| 2.1 | ✅ Écran login : champ code 2FA / vérification si otp_code requis |
| 2.2 | ✅ Message compte verrouillé + tentatives restantes (API déjà en place) |
| 2.3 | ✅ Lien « Configurer 2FA » → web login / paramètres |
| 2.4 | ✅ Sync capabilities (plan + security_module_enabled) au login / /me / subscription status + affichage Profil |
| 2.5 | ✅ Impression thermique Sunmi (ESC/POS natif + fallback expo-print) — voir docs/THERMAL_PRINT_MOBILE.md |
| 2.6 | ✅ pos-mobile/ versionné dans le dépôt (depuis sept. 2026) |
Phase 3 — Déploiement & site
| # | Tâche |
|---|---|
| 3.1 | ✅ Commit local — push Git optionnel (§2b ZIP si auth bloquée) |
| 3.2 | ⏳ php artisan migrate production (script serveur prêt) |
| 3.3 | ✅ Commande php artisan shop:addon + docs UI — activation par boutique (pas de mass-enable) |
| 3.4 | ✅ Permissions security.login_logs.view aux gérants (config + migration) |
| 3.5 | ✅ Page Téléchargement APK — /telechargement-apk + dossier storage/app/public/apk/ |
| 3.6 | ✅ .env.example + doc prod : WhatsApp, SECURITY_*, MOBILE_APP_* (appliquer sur serveur = manuel) |
| 3.7 | ✅ Scripts checklist `scripts/deploy-production-checklist.(ps1 |
| 3.8 | ✅ Pack ZIP sans Git : pack-deploy-release + deploy-server-post-upload.sh |
Phase 4 — Documentation
| # | Tâche |
|---|---|
| 4.1 | ✅ Aligner GRILLE_ABONNEMENTS.md (Starter→Illimité USD, taux 2300) |
| 4.2 | ✅ Mettre à jour ETAT_IMPLEMENTATION.md |
| 4.3 | ✅ Doc agent IA + HTML (sections sécurité à jour) |
| 4.4 | ✅ Archiver / cocher PREPARATION_MODULE_SECURITE.md |
Phase 5 — Fonctionnalités métier restantes
| Domaine | Tâches | Statut |
|---|---|---|
| Sauvegardes premium | Add-on premium_backups, rétention 30, cloud S3, alertes échec |
✅ Partiel |
| SFN | Facturation auto ventes sync offline (PosSaleService + sfn:backfill-offline-sales) |
✅ |
| Rapports | Comparaison sessions caisse (rapport caisse) | ✅ |
| Sécurité avancée | IP whitelist + alertes nouvelle IP | ✅ |
| Analytics | Prévisions stock (ML basique) — /reports/stock-forecast |
✅ |
Commandes :
php artisan sfn:backfill-offline-sales {shop_id}
php artisan audit:functional
Phase 6 — Qualité
| # | Tâche |
|---|---|
| 6.1 | ✅ Tests feature sécurité (verrouillage, expiration, 2FA mobile API) |
| 6.2 | ✅ Commande php artisan audit:functional (script scripts/functional-audit.php) |
| 6.3 | ✅ Index DB login_logs (shop + user/ip) |
| 6.4 | ✅ Bugbot / revue sécurité — 4 findings corrigés (verrouillage mobile, 2FA multi-boutique, token MDP) |
| 6.5 | ✅ Bandeau grâce 48 h sur accueil mobile + droits paiement alignés backend (can_manage_subscription_payment) |
| 6.6 | ✅ Portail boutique : montant mensuel / annuel dynamique (UI + initiate) + tests renouvellement |
Ordre d’exécution recommandé
Phase 1 (sécurité) → Phase 3 (déployer) → Phase 2 (mobile) → Phase 4 (docs) → Phase 5 → Phase 6
Phases 1, 2, 4 et 5 (code métier) terminées (sept. 2026). Phase 3 : préparation locale ✅ — reste push Git, migrate / .env / APK sur le serveur, activation add-on par boutique cliente. Phase 6 : 6.1–6.6 ✅ (qualité + polish réabonnement). S3 pour sauvegardes premium reste optionnel (config serveur).
Checklist déploiement production (Phase 3)
Doc complète : docs/DEPLOIEMENT_PRODUCTION.md
Rappel CLI : .\scripts\deploy-production-checklist.ps1
git pull origin main
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan shop:addon enable enhanced_security --shop=ID
.env prod minimal :
SAAS_SUPPORT_WHATSAPP=243828384820
SECURITY_MAX_LOGIN_ATTEMPTS=3
SECURITY_PASSWORD_MAX_AGE_DAYS=90
SECURITY_TOTP_ISSUER="ShopManager Pro"
SECURITY_UNLOCK_LINK_EXPIRES_HOURS=24
MOBILE_APP_LATEST_VERSION=1.0.0
MOBILE_APP_LATEST_ANDROID_VERSION_CODE=2
MOBILE_APP_DOWNLOAD_URL=https://app.shopmanagerpro.net/storage/apk/shopmanager-pro.apk
Puis : activer add-on Sécurité renforcée par boutique (shop:addon ou admin Boutiques).
Backlog — sans blocage Git
Le dépôt distant est sur Cursor (
origin.cursor.com). Il n’y a pas de username/password Git classique : la connexion se fait via votre compte Cursor (navigateur). Tant que le push n’est pas configuré, tout le développement continue en local (commits, tests, migrations locales).
| # | Tâche | Bloqué par Git ? | Notes |
|---|---|---|---|
| B1 | Push master → origin/main |
Oui | WSL : .\scripts\setup-cursor-origin-remote.ps1 puis connexion navigateur |
| B2 | migrate + .env prod |
Non | Scripts prêts ; exécution manuelle sur serveur |
| B3 | Déploiement sans Git | Non | ✅ pack-deploy-release + deploy-server-post-upload.sh |
| B4 | Analytics stock (ML basique) | Non | ✅ /reports/stock-forecast |
| B5 | Déblocage compte par email signé | Non | ✅ /account/unlock-request + lien 24 h single-use |
| B6 | Impression thermique mobile | Non | ✅ Sunmi natif + fallback (code local pos-mobile/) |
| B7 | Bugbot / revue sécurité | Non | ✅ 4 corrections appliquées |
| B8 | Intégrer pos-mobile/ au repo |
Non | ✅ Versionné (node_modules / .expo exclus) |
| B9 | Polish réabonnement (grâce / droits / portail) | Non | ✅ Phase 6.5–6.6 |
Ordre recommandé sans push : B2/B3 quand le serveur prod est accessible ; B8 (pos-mobile dans git) ensuite.
Auth Git Cursor (quand vous voudrez pousser)
- Installer WSL + Ubuntu (si absent) :
wsl --install -d Ubuntu - Lancer :
.\scripts\setup-cursor-origin-remote.ps1 - Se connecter dans le navigateur avec le compte Cursor du projet (pas de mot de passe à retenir)
git push origin master:main
Alternative : héberger le code sur GitHub/GitLab avec un remote secondaire, ou déployer par FTP/rsync sans git pull en prod.