create-snapify-app 0.0.0-stage → 1.1.0

package/template/.github/workflows/release.yml

@@ -0,0 +1,67 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: 'Incrément de version'
+        required: true
+        type: choice
+        options: [patch, minor, major]
+        default: minor
+
+permissions:
+  contents: write
+
+jobs:
+  tag-from-dispatch:
+    if: github.event_name == 'workflow_dispatch'
+    runs-on: [self-hosted, linux, x64]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - env:
+          BUMP: ${{ inputs.bump }}
+        run: |
+          set -euo pipefail
+          git config user.name 'github-actions[bot]'
+          git config user.email '41898282+github-actions[bot]@users.noreply.github.com'
+          npm version "$BUMP" -m 'chore(release): %s'
+          git push origin HEAD:main --follow-tags
+
+  release:
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: [self-hosted, linux, x64]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - run: |
+          npm ci --no-audit --no-fund --legacy-peer-deps
+          npm run build
+      - run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          tar -czf "snapify-${VERSION}.tar.gz" dist package.json package-lock.json scripts/deploy.sh README.md CHANGELOG.md
+          sha256sum "snapify-${VERSION}.tar.gz" > "snapify-${VERSION}.tar.gz.sha256"
+      - run: |
+          python3 - <<'PY'
+          import pathlib, os, re
+          ver = os.environ["GITHUB_REF_NAME"].lstrip("v")
+          text = pathlib.Path("CHANGELOG.md").read_text(encoding="utf-8")
+          m = re.search(rf"## \[{re.escape(ver)}\][\s\S]*?(?=\n## |\Z)", text)
+          pathlib.Path("release-notes.md").write_text((m.group(0).strip() if m else f"Release Snapify v{ver}") + "\n", encoding="utf-8")
+          PY
+      - uses: softprops/action-gh-release@v2
+        with:
+          name: Snapify ${{ github.ref_name }}
+          body_path: release-notes.md
+          files: |
+            snapify-*.tar.gz
+            snapify-*.tar.gz.sha256
+          generate_release_notes: true
+          fail_on_unmatched_files: false

package/template/.snapify-install.json

@@ -0,0 +1,5 @@
+{
+  "package": "create-snapify-app",
+  "version": "1.1.0",
+  "packedAt": "2026-11-07T14:01:09.199Z"
+}

package/template/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+Toutes les versions notables de Snapify sont documentées ici.
+Format inspiré de [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/),
+versionnement [SemVer](https://semver.org/lang/fr/).
+
+## [1.1.0] — 2026-10-20
+
+### Ajouté
+- Marketplace backoffice en cartes (logo, captures, galerie)
+- Achat de modules payants depuis le backoffice (Flouci + licence auto)
+- Superadmin ops (newsletter, tickets, factures, Flouci, paramètres)
+- Community, marketplace publique, portail développeurs
+- Widgets CMS (zones sidebar/footer), menus dynamiques, aperçu articles
+- Blocs group/columns et modèles de blocs sauvegardés
+- CI/CD GitHub Actions (lint, build, déploiement SSH, releases)
+
+### Modifié
+- Sidebar admin : sections **Éditorial** / **Applications** / **Messagerie**
+- Catalogue modules (prix, galerie, captures)
+
+### Sécurité
+- `.env` retiré du suivi Git ; secrets uniquement via `.env` serveur / GitHub Secrets
+
+## [1.0.0] — 2026-10-01
+
+### Ajouté
+- Première version publique Snapify (CMS, thèmes, modules, marketplace locale)

package/template/LICENSE

@@ -0,0 +1,14 @@
+Snapify — Licence propriétaire
+
+Copyright © 2026 NOVALABS WEB DESIGN — Tunisie
+Contact : contact@novalabs.tn · +216 24 734 647
+
+Tous droits réservés.
+
+Ce logiciel, son code source, sa documentation et ses éléments graphiques sont
+la propriété exclusive de NOVALABS WEB DESIGN. Toute reproduction, modification,
+distribution, publication, sous-licence ou utilisation, totale ou partielle, sans
+l'autorisation écrite préalable de NOVALABS WEB DESIGN est strictement interdite.
+
+CE LOGICIEL EST FOURNI « EN L'ÉTAT », SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU
+IMPLICITE.

package/template/README.md

@@ -0,0 +1,287 @@
+<div align="center">
+
+<img src="docs/logo.svg" alt="Snapify" width="88" height="88" />
+
+# Snapify
+
+**CMS et plateforme e-commerce modulaire : pages par blocs, thèmes, modules signés et back-office complet.**
+
+[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react&logoColor=white)](https://react.dev)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org)
+[![Vite](https://img.shields.io/badge/Vite-8-646CFF?logo=vite&logoColor=white)](https://vite.dev)
+[![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-4-06B6D4?logo=tailwindcss&logoColor=white)](https://tailwindcss.com)
+[![Express](https://img.shields.io/badge/Express-4-000000?logo=express&logoColor=white)](https://expressjs.com)
+[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-17-4169E1?logo=postgresql&logoColor=white)](https://www.postgresql.org)
+[![Licence](https://img.shields.io/badge/licence-propri%C3%A9taire-lightgrey)](LICENSE)
+
+[Fonctionnalités](#fonctionnalités) · [Démarrage rapide](#démarrage-rapide) · [Architecture](#architecture) · [Modules et thèmes](#modules-et-thèmes) · [Déploiement](#mise-en-production) · [Documentation](#documentation)
+
+</div>
+
+---
+
+<p align="center">
+  <img src="docs/screenshots/storefront-home.jpg" alt="Boutique Snapify avec le thème Mahdia" width="49%" />
+  <img src="docs/screenshots/admin-dashboard.jpg" alt="Tableau de bord de l'administration" width="49%" />
+</p>
+
+## Présentation
+
+Snapify est un système de gestion de contenu auto-hébergé, conçu pour créer et administrer des sites vitrines et des boutiques en ligne sans écrire de code. Le site public et l'administration (`/administrator`) partagent une même base React ; le serveur Express gère le rendu, le référencement, la sécurité et l'exécution des modules.
+
+Deux plateformes complémentaires tournent sur le même serveur (routage par `Host`) :
+
+- **Community** (`community.snapify.tn`) — forum pour la communauté Snapify
+- **Marketplace** (`marketplace.snapify.tn`) — thèmes & modules, inscription développeur 100 DT (Flouci), commission configurable
+
+Voir [docs/PLATFORM_DEPLOY.md](docs/PLATFORM_DEPLOY.md).
+
+Le cœur reste léger : l'apparence vient des **thèmes**, les fonctionnalités métier (boutique, panier, commandes, espace client, chat IA…) viennent des **modules**. Thèmes et modules sont distribués sous forme de paquets **signés** et s'installent depuis la marketplace intégrée.
+
+## Fonctionnalités
+
+### Contenu et édition
+- **Éditeur de pages par blocs** : 25 types de blocs (héros, galerie, témoignages, FAQ, tableaux, appels à l'action…), glisser-déposer, aperçu en direct sur ordinateur, tablette et mobile.
+- **Blog** avec éditeur de texte riche et publication planifiée.
+- **Révisions** (50 par contenu) avec restauration, brouillons et workflow de relecture.
+- **Médiathèque**, menus imbriqués, formulaires personnalisables, newsletter en double opt-in, boutons flottants.
+
+### E-commerce
+- **Catalogue** : produits avec galerie, prix barrés et promotions, stock, catégories, recherche, tri et filtres.
+- **Panier** latéral et page panier, **codes promo** (pourcentage, montant fixe, livraison offerte).
+- **Tunnel de commande** en une page : adresses en Tunisie (gouvernorats), modes de livraison, paiement à la livraison ou par virement, e-mails de confirmation et suivi de commande.
+- **Espace client** : inscription, connexion, commandes, carnet d'adresses, favoris, profil et photo.
+- **Back-office commerce** : tableau des ventes, gestion des commandes et de leurs statuts, fiches clients, export CSV.
+
+### Apparence
+- **Thèmes interchangeables** à chaud, avec options de personnalisation (couleurs, typographie, en-tête, pied de page) et identité visuelle.
+- Trois thèmes fournis : **Mahdia** (e-commerce), **SidiBou** et **Dogga** (vitrines).
+
+### Référencement et audience
+- Métadonnées par page, `sitemap.xml`, `robots.txt`, redirections 301 et analyse SEO avec score.
+- Assistant de connexion **Google Search Console**.
+- **Statistiques de visite** intégrées et respectueuses de la vie privée (pages vues, visiteurs, pays, temps moyen par page), bandeau de consentement aux cookies.
+
+### Administration et sécurité
+- **Rôles et permissions** fins (26 permissions, rôles personnalisables), invitations par e-mail.
+- **Double authentification (TOTP)**, gestion des sessions actives, limitation de débit, liste d'IP autorisées.
+- **Journal d'audit** de toutes les actions sensibles, rétention configurable des données.
+- **Secrets chiffrés en base** (mot de passe SMTP, clés 2FA).
+- **Mode maintenance** (réponse HTTP 503 avec `Retry-After`).
+
+## Aperçu de l'administration
+
+<p align="center">
+  <img src="docs/screenshots/admin-orders.jpg" alt="Gestion des commandes" width="49%" />
+  <img src="docs/screenshots/admin-products.jpg" alt="Catalogue produits" width="49%" />
+</p>
+<p align="center">
+  <img src="docs/screenshots/storefront-catalog.jpg" alt="Catalogue de la boutique" width="70%" />
+</p>
+
+## Stack technique
+
+| Couche | Technologies |
+| --- | --- |
+| Interface | React 19, React Router 7, Tailwind CSS 4, Motion, Lucide, TipTap, Recharts, dnd-kit |
+| Build | Vite 8, TypeScript, tsx |
+| Serveur | Node.js, Express 4, Nodemailer, geoip-lite |
+| Données | PostgreSQL 17, Drizzle ORM (migrations SQL versionnées) |
+| IA | Google Gemini (module Chat IA, clé côté serveur uniquement) |
+
+## Démarrage rapide
+
+### Installateur npm (recommandé)
+
+```bash
+npx create-snapify-app@latest mon-site
+```
+
+Le wizard demande le **domaine**, les identifiants **PostgreSQL** et le compte **admin**, puis installe le code source complet, écrit `.env`, lance `npm install` et `npm run build`.
+
+```bash
+cd mon-site
+NODE_ENV=production npm start
+# Admin : https://votre-domaine/administrator
+```
+
+### Prérequis
+
+- **Node.js 22** ou plus récent
+- **PostgreSQL 17** : via Docker (fourni) ou une installation locale
+
+### Installation depuis ce dépôt
+
+```bash
+# 1. Dépendances
+npm install
+
+# 2. Configuration : copier puis compléter les valeurs
+cp .env.example .env
+
+# 3. Base de données (conteneur Docker, port local 5433)
+npm run db:up
+
+# 4. Construction du site public et de l'administration
+npm run build
+
+# 5. Lancement
+npm run dev
+```
+
+Le site est servi sur le port défini par `PORT`, l'administration sur **`/administrator`**. Les migrations sont appliquées automatiquement au démarrage, et le premier compte administrateur est créé à partir de `ADMIN_EMAIL` et `ADMIN_PASSWORD`.
+
+> [!NOTE]
+> Avec `NODE_ENV=production`, le serveur sert les fichiers compilés de `dist/` : relancez `npm run build` après chaque modification du front. Sans cette variable, Vite fonctionne en mode développement avec rechargement à chaud.
+
+### Restaurer la base de démonstration
+
+Le dossier [`database/`](database) contient un dump PostgreSQL complet (pages, produits, commandes de test, réglages, modules installés) :
+
+```bash
+pg_restore -d "$DATABASE_URL" --clean --if-exists --no-owner database/snapify-20261013-124021.dump
+```
+
+Les fichiers des modules installés (`data/modules/`) et les fichiers déposés (`public/uploads/`) sont versionnés avec le dépôt pour que la restauration soit complète.
+
+## Configuration
+
+Toute la configuration passe par le fichier `.env` (modèle commenté : [`.env.example`](.env.example)).
+
+| Variable | Rôle |
+| --- | --- |
+| `PORT`, `NODE_ENV` | Port d'écoute et mode d'exécution (`production` sert `dist/`) |
+| `DATABASE_URL`, `SNAPIFY_DB_PASSWORD` | Connexion PostgreSQL et mot de passe du conteneur Docker |
+| `ADMIN_EMAIL`, `ADMIN_PASSWORD` | Premier compte super administrateur |
+| `ADMIN_JWT_SECRET` | Signature des sessions de l'administration |
+| `SNAPIFY_SECRET_KEY` | Chiffrement des secrets en base. **Ne plus la modifier une fois définie** |
+| `SNAPIFY_ADMIN_URL` | Adresse de l'administration utilisée dans les e-mails |
+| `SNAPIFY_ADMIN_IP_BYPASS` | Secours : ignore la liste d'IP autorisées |
+| `GEMINI_API_KEY` | Clé Google Gemini du module Chat IA |
+| `MARKETPLACE_URL` | Catalogue distant HTTPS (vide : catalogue local `marketplace/`) |
+| `SNAPIFY_MODULES_DEV_MODE` | Autorise les paquets non signés (développement uniquement) |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `GOOGLE_REDIRECT_URI` | OAuth Google Search Console (également configurable dans l'admin) |
+| `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASS`, `SMTP_FROM` | Envoi d'e-mails (le réglage de l'admin est prioritaire) |
+
+## Architecture
+
+```text
+.
+├── server.ts                 Point d'entrée Express (rendu, API, assets)
+├── server/
+│   ├── cms/                  Contenu, blocs, révisions, SEO, planification, permissions
+│   ├── db/                   Schéma Drizzle, client et dépôt PostgreSQL
+│   ├── modules/              Gestionnaire de modules et thèmes, marketplace, signatures
+│   ├── routes/               API publique, administration, comptes, Google OAuth
+│   ├── security/             Sessions, 2FA, limitation de débit, audit, secrets, IP
+│   └── media/                Traitement et validation des images
+├── src/
+│   ├── admin/                Application d'administration (pages, éditeur, UI)
+│   ├── themes/, modules/     Hôtes de rendu des thèmes et modules côté client
+│   └── views/, components/   Rendu des pages et composants partagés
+├── sdk/                      SDK des modules et thèmes (API 1.3, build, paquets, UI commerce)
+├── modules/                  Sources des modules officiels
+├── themes/                   Sources des thèmes officiels
+├── marketplace/              Catalogue local et paquets signés (.snapmod, .snaptheme)
+├── drizzle/                  Migrations SQL
+├── database/                 Dump PostgreSQL de référence
+├── scripts/                  Sauvegarde, restauration, outil de build des modules
+└── docs/                     Documentation technique et fonctionnelle
+```
+
+**Principes clés**
+
+- **Rendu côté serveur des métadonnées** : titre, description et balises de partage sont injectés dans le HTML de chaque page pour le référencement, puis React prend le relais.
+- **Modules isolés** : chaque module déclare ses permissions (routes HTTP, base de données, e-mails, fichiers, accès réseau…) dans son manifeste. Le serveur ne lui expose que ce qui a été accordé et vérifie l'intégrité de ses fichiers à chaque démarrage.
+- **Styles cloisonnés** : la feuille de style de chaque module est limitée à son conteneur pour ne jamais altérer le thème ni l'administration.
+
+## Modules et thèmes
+
+### Modules officiels
+
+| Module | Version | Description |
+| --- | --- | --- |
+| **Boutique** `novalabs.shop` | 1.0.0 | Catalogue, catégories, fiches produit, stock, widgets de mise en avant |
+| **Panier** `novalabs.cart` | 1.0.0 | Panier latéral, page panier, codes promo |
+| **Commande** `novalabs.checkout` | 1.0.0 | Tunnel de commande, livraison, paiement, e-mails, gestion des commandes |
+| **Espace client** `novalabs.customers` | 1.1.0 | Comptes clients, tableau de bord, adresses, favoris, photo de profil |
+| **Chat IA** `novalabs.ai-chat` | 1.0.1 | Assistant conversationnel Gemini avec quotas par visiteur |
+| **WhatsApp** `novalabs.whatsapp` | 1.0.1 | Bouton de contact WhatsApp configurable |
+
+### Thèmes officiels
+
+| Thème | Style |
+| --- | --- |
+| **Mahdia** `novalabs.mahdia` | Boutique en ligne : sable, bleu Méditerranée et touches dorées, en-tête e-commerce |
+| **SidiBou** `novalabs.sidibou` | Vitrine lumineuse, sections animées, cartes arrondies |
+| **Dogga** `novalabs.dogga` | Vitrine éditoriale, titres à empattements, palette pierre et terre cuite |
+
+### Créer et publier un paquet
+
+```bash
+# Construire et signer (sortie : marketplace/packages/<id>-<version>.snapmod)
+SNAPIFY_SIGNING_KEY=~/.snapify/keys/<cle>.pem npm run module -- build modules/mon-module
+
+# Vérifier un paquet (signature, empreintes, manifeste)
+npm run module -- verify marketplace/packages/editeur.mon-module-1.0.0.snapmod
+
+# Régénérer le catalogue local
+npm run module -- catalog
+```
+
+La clé privée de signature se conserve **hors du dépôt**. Le guide complet (manifeste, API serveur, permissions, format des paquets, licences) est dans [docs/MODULES.md](docs/MODULES.md).
+
+## Rôles par défaut
+
+| Rôle | Périmètre |
+| --- | --- |
+| Super administrateur | Accès complet, y compris rôles, sécurité et paramètres avancés |
+| Éditeur | Contenu, menus, médias, contacts, apparence, données des modules |
+| Contributeur | Rédaction de pages et d'articles en brouillon |
+| Référenceur SEO | Référencement et statistiques |
+| Lecteur | Consultation des statistiques et des messages |
+
+Les rôles sont modifiables et de nouveaux rôles peuvent être créés depuis **Utilisateurs › Rôles**.
+
+## Scripts
+
+| Commande | Rôle |
+| --- | --- |
+| `npm run dev` | Démarre le serveur (Vite en développement, `dist/` en production) |
+| `npm run build` | Compile le site public et l'administration |
+| `npm run lint` | Vérification TypeScript |
+| `npm run db:up` | Démarre le conteneur PostgreSQL |
+| `npm run db:generate` | Génère une migration après modification de `server/db/schema.ts` |
+| `npm run db:studio` | Explorateur de base Drizzle Studio |
+| `npm run db:backup` | Sauvegarde de la base dans `backups/db/` |
+| `npm run db:restore -- <fichier>` | Restaure une sauvegarde |
+| `npm run module -- <commande>` | Outil des paquets : `build`, `verify`, `catalog`, `license`, `keygen` |
+
+## Mise en production
+
+1. Définir `NODE_ENV=production` et des valeurs fortes et uniques pour `ADMIN_PASSWORD`, `ADMIN_JWT_SECRET` et `SNAPIFY_SECRET_KEY`.
+2. Renseigner `SNAPIFY_ADMIN_URL`, le SMTP et, si besoin, Google Search Console.
+3. `npm ci && npm run build`, puis lancer le serveur sous un gestionnaire de processus (pm2, systemd).
+4. Placer un reverse proxy HTTPS (Nginx, Caddy) devant le port de l'application.
+5. Programmer `npm run db:backup` quotidiennement (conservation de 14 jours par défaut).
+
+> [!WARNING]
+> Ce dépôt contient le fichier `.env` et un dump de la base. Il doit rester **privé**. Avant toute ouverture ou tout partage, retirez ces fichiers et renouvelez l'ensemble des secrets.
+
+## Documentation
+
+| Document | Contenu |
+| --- | --- |
+| [docs/BACKOFFICE_SNAPIFY.md](docs/BACKOFFICE_SNAPIFY.md) | Guide complet de l'administration, paramètres, base de données, configuration |
+| [docs/MODULES.md](docs/MODULES.md) | Guide développeur des modules et thèmes : SDK, manifeste, sécurité, publication |
+
+## Licence
+
+Logiciel propriétaire. © 2026 **NOVALABS WEB DESIGN**, Tunisie. Tous droits réservés.
+Toute reproduction, modification ou diffusion sans autorisation écrite est interdite. Voir [LICENSE](LICENSE).
+
+<div align="center">
+
+**NOVALABS WEB DESIGN** · [contact@novalabs.tn](mailto:contact@novalabs.tn) · +216 24 734 647
+
+</div>

package/template/administrator.html

@@ -0,0 +1,23 @@
+<!doctype html>
+<!--
+  Snapify
+  © 2026 NOVALABS WEB DESIGN — Tunisie
+  Contact : contact@novalabs.tn · +216 24 734 647
+  Tous droits réservés. Toute reproduction, modification ou diffusion sans autorisation écrite est interdite.
+-->
+<html lang="fr">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="robots" content="noindex, nofollow" />
+    <title>Snapify — Backoffice</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
+    <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 40 40'%3E%3Crect width='40' height='40' rx='10' fill='%230B1528'/%3E%3Crect x='7' y='9' width='26' height='22' rx='4' fill='none' stroke='%23fff' stroke-width='2.4'/%3E%3Cpath d='M7 15.5H33' stroke='%23fff' stroke-width='2.4'/%3E%3Ccircle cx='11' cy='12.3' r='1.1' fill='%23ff7300'/%3E%3Ccircle cx='14.4' cy='12.3' r='1.1' fill='%23ff7300'/%3E%3Cpath d='M20 18.2L21.6 22L25.4 23.6L21.6 25.2L20 29L18.4 25.2L14.6 23.6L18.4 22Z' fill='%23ff7300'/%3E%3C/svg%3E" />
+  </head>
+  <body class="bg-slate-950 text-slate-100 antialiased">
+    <div id="root"></div>
+    <script type="module" src="/src/admin/main.tsx"></script>
+  </body>
+</html>