Rapport Technique, de Sécurité et
d'Architecture

01. Résumé Exécutif & Manifeste du Projet

Au-delà des étiquettes traditionnelles de "Micro Framework" dans le monde de l'open source ; il se positionne comme un Full-Stack Framework avec zéro dépendance externe, doté de boucliers de sécurité basés sur CLI, capable de générer du code de bout en bout (vertical-slice) depuis le schéma de base de données jusqu'aux composants UI.

02. Piliers Architecturaux et Philosophie "Safe Vibe Coding"

A. Points d'Entrée et Bootstrapping Isolé

ArtiFrame sépare les requêtes web de manière stricte en deux couches principales :

• ViewControl.php (Bootstrapping de la couche View) : Lance les processus HTML/Render. Charge les composants DotEnv, APP_ENV, APP_VERSION et ViewMethod.
• ApiControl.php (Bootstrapping de la couche API) : Gère les requêtes JSON API. Rend le contrôle $allowedMethods obligatoire avant d'être requis, bloquant instantanément les méthodes HTTP non autorisées. Masque les détails de l'Exception dans l'environnement de production.

B. Générateurs CLI et "Design by Contract" (Conception par Contrat)

Les outils CLI créent des garde-fous de sécurité autour du développeur :

• create:method auth : Génère le module Auth de bout en bout avec une seule commande, de la table de base de données schema.sql aux classes de contrôleur PHP en arrière-plan, aux terminaux API protégés par CSRF et aux formulaires HTML non stylisés.
• Écosystème de Services add : Connecte les services externes (S3, Redis, Stripe, Iyzico, JWT, Twilio, Pusher, Sentry, ImageProcessor) au projet derrière une enveloppe standard.

C. Contrat de Réponse Standard

Tous les wrappers add et assistants API renvoient le même contrat JSON sans exception :

{
  "status": "success | error",
  "message": "Human readable status message",
  "data": {}
}

Ainsi, les erreurs de bibliothèque qui éclatent dans les blocs try-catch sont interceptées proprement au lieu de faire planter le système et sont enregistrées dans le journal (error_log).

03. Moteur Principal et Boucliers de Données

A. Base de Données et Gestion d'Identité Haute Performance

• UUIDv7 Natif Intégré (byteId, makeId, formatId) : Génère un UUIDv7 binaire de 16 octets avec du PHP pur, sans nécessiter aucune bibliothèque Composer externe. Offre des performances d'indexation et de disque exceptionnelles dans les colonnes BINARY(16) de la base de données.
• Bouclier de Précision JavaScript (bigintId, stringer) : bigintId() génère 15 chiffres par défaut pour éviter la perte de données dans les ID BigInt dépassant la limite MAX_SAFE_INTEGER de JavaScript. L'utilisation de data-id="<?= stringer($id) ?>" est rendue obligatoire dans la couche View pour éviter les corruptions de données frontend-backend.

B. Sécurité Stricte et Protection des Types

• Bouclier de Sanétisation XSS (ViewMethod::display) : Nettoie toutes les données affichées à l'écran avec les indicateurs ENT_QUOTES | ENT_HTML5. Recourt à la valeur $default pour les entrées null ou vides, évitant ainsi les erreurs de type PHP 8.1+.
• Hachage de Mot de Passe Sécurisé (SystemMethod::hashPassword) : Lance une Exception au lieu de rester silencieux et de générer un hachage erroné lorsque le mot de passe est vide, rendant impossible la création d'un compte avec un mot de passe vide.
• Masquage Intégré KVKK / GDPR : Les données utilisateur sont censurées en une seule étape avec les fonctions maskEmail() et maskPhone() avant d'être affichées dans la couche View.

04. Performances Numériques et Analyse Benchmark

🖥️ Environnement de Test Benchmark (Test Environment)

• Caractéristiques du Serveur : 4 vCPU Intel Processor, 8 GB RAM, 80 GB NVMe/SSD, 20 TB Trafic Mensuel
• Système d'Exploitation & Logiciels : Ubuntu 24.04 LTS, Nginx 1.26, PHP 8.3 FPM (OPcache Aktif)
• Méthode de Test : wrk -t4 -c100 -d30s (4 Threads, 100 Connexions Simultanées, 30 Secondes de Charge Soutenue)
• Scénario de Test : Réponse JSON API Simple ({"status":"success","message":"OK"})

05. Matrice Détaillée de Sécurité et de Vulnérabilités

06. Efficacité de la Fenêtre de Contexte IA & Vibe Coding

Dans les processus de développement de code avec des agents d'intelligence artificielle (Cursor, Claude, Copilot), la taille du code du framework affecte directement le coût de la fenêtre de contexte (context window) de l'IA et la qualité de la génération de code.

07. Écosystème DevOps, CI/CD et Docker

08. Architecture de Mise à Jour Automatique et Sans Interruption (Zero-Shatter Upgrades)

Dans les frameworks traditionnels, les mises à jour de version majeure (par exemple, de Laravel 10 à 11) entraînent des ruptures (breaking changes) dans des centaines de fichiers, des conflits de dépendances et des processus de refactoring qui durent des jours.

Grâce à ses signatures de fonctions fixes et son mécanisme de synchronisation basé sur CLI, ArtiFrame se met à jour sans casser une seule ligne de code de la logique métier (business logic) dans votre projet.

🛠️ Flux de Travail de Mise à Jour Étape par Étape (Upgrade Workflow)

1. Mettez à Jour le Paquet CLI Global :

$ npm install -g @artilingo/artiframe-cli@latest

2. Accédez au Répertoire du Projet et Exécutez la Commande de Mise à Jour :

$ cd /var/www/my-artiframe-project
$ artiframe update

⚙️ Que se Passe-t-il en Arrière-Plan ?

• La CLI remplace automatiquement les fichiers du noyau (SystemMethod.php, ViewMethod.php, ViewControl.php, ApiControl.php) situés dans le dossier app/ ou bin/ à la racine du projet par leurs versions les plus récentes contenant des optimisations et des correctifs de sécurité adaptés à la nouvelle version de PHP.
• Étant donné que les signatures des méthodes telles que display() utilisées dans l'interface, apiResponse() côté API, maskPhone() dans le masquage des données ou verifyCsrf() dans la validation CSRF ne changent jamais, toutes vos vues, contrôleurs et classes de services continueront de fonctionner sans problème.
• Le développeur obtient instantanément les améliorations de performances et de sécurité de la dernière version de PHP (PHP 8.3/8.4/8.5) sans avoir à gérer la complexité de modifier du code dans des centaines de fichiers.

09. Coût Total de Possession (TCO & Analyse Financière)

Projection des coûts de serveur cloud pour un projet SaaS lourd, avec des opérations de base de données intensives, recevant en moyenne 150 Millions de Requêtes par mois (~60 opérations actives par seconde) :

10. Conclusion : Pourquoi ArtiFrame ?

ArtiFrame combine la puissance brute du Native PHP avec une architecture CLI disciplinée et à l'épreuve des balles, sans noyer le développement dans une soupe de paquets obscurs ou de lourdes couches d'abstraction.

• Rapide : Avec un temps de réponse de 0,46 ms par requête, il n'épuise pas les ressources du serveur.
• Sécurisé : Il ne laisse pas les mesures de sécurité optionnelles ; il les impose au niveau de l'architecture.
• Compatible IA : Avec son noyau de ~18.000 tokens, il permet aux agents d'intelligence artificielle de générer du code sans erreur.
• Durable : Avec la commande artiframe update, le noyau se met à jour instantanément sans casser le code de votre projet.