@artilingo/artiframe-cli 1.2.1 → 1.4.0

package/src/Commands/TableCommand.php

@@ -0,0 +1,82 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+use ArtiFrame\Cli\Services\Safeguard;
+
+class TableCommand
+{
+    private Translator $translator;
+    private Safeguard  $safeguard;
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+        $this->safeguard  = new Safeguard($translator);
+    }
+
+    public function execute(array $args): void
+    {
+        $tableName = $args[0] ?? null;
+        $action    = $args[1] ?? null;
+
+        if (!$tableName) {
+            echo "❌ " . $this->translator->get('ERROR_TABLE_NAME_REQUIRED') . PHP_EOL;
+            return;
+        }
+
+        $stubPath  = \ARTIFRAME_CLI_ROOT . '/stubs/sql.stub';
+
+        if (!file_exists($stubPath)) {
+            echo "❌ " . $this->translator->get('ERROR_STUB_NOT_FOUND') . PHP_EOL;
+            return;
+        }
+
+        $stubContent = file_get_contents($stubPath);
+
+        // table list
+        if ($tableName === 'list') {
+            echo "\033[1;36m" . $this->translator->get('TABLE_LIST_HEADER') . "\033[0m" . PHP_EOL;
+            preg_match_all('/-- \[TABLE:(.*?)\]/s', $stubContent, $matches);
+            
+            if (!empty($matches[1])) {
+                foreach ($matches[1] as $table) {
+                    $descKey = 'TABLE_DESC_' . strtoupper($table);
+                    $desc = $this->translator->get($descKey);
+                    if ($desc === $descKey) {
+                        $desc = '-';
+                    }
+                    echo "  \033[0;32m" . str_pad($table, 20) . "\033[0m : " . $desc . PHP_EOL;
+                }
+            }
+            return;
+        }
+
+        $pattern = "/-- \[TABLE:{$tableName}\](.*?)-- \[\/TABLE:{$tableName}\]/s";
+
+        if (!preg_match($pattern, $stubContent, $matches)) {
+            echo "❌ " . sprintf($this->translator->get('ERROR_TABLE_NOT_IN_STUB'), $tableName) . PHP_EOL;
+            return;
+        }
+
+        $tableContent = trim($matches[1]);
+
+        // table:name check
+        if ($action === 'check') {
+            echo "\033[1;33m--- SQL FOR `{$tableName}` ---\033[0m" . PHP_EOL;
+            echo $tableContent . PHP_EOL;
+            echo "\033[1;33m---------------------------\033[0m" . PHP_EOL;
+            return;
+        }
+
+        $schemaPath = getcwd() . '/schema.sql';
+
+        if (!file_exists($schemaPath)) {
+            file_put_contents($schemaPath, "-- ArtiFrame DB Schema\n-- Created: " . date('Y-m-d') . "\n");
+        }
+
+        file_put_contents($schemaPath, "\n" . $tableContent . "\n", FILE_APPEND);
+
+        echo "✅ " . sprintf($this->translator->get('SUCCESS_TABLE_ADDED'), $tableName) . PHP_EOL;
+    }
+}

package/src/Lang/de.php

@@ -75,6 +75,8 @@ return [
     'HELP_MAJOR_DOWN'        => 'Letzte Major-Version zurücksetzen.',
     'HELP_HELP_DESC'         => 'Diese Hilfemeldung anzeigen.',
     'HELP_EXIT_DESC'         => 'Die interaktive Shell beenden.',
+    'HELP_AUTH_DESC'         => 'Authentifizieren Sie sich bei GitHub, um Vorschläge einzureichen.',
+    'HELP_SUGGEST_DESC'      => 'Reichen Sie einen Funktionswunsch, Fehlerbericht oder Vorschlag direkt bei GitHub ein.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Aktuelle Sprache:',
@@ -166,4 +168,16 @@ return [
     'MODE_INVALID'             => 'Ungültiger Modus. Verwenden Sie 1 für Debug, 0 für Prod.',
     'MODE_NOT_PROJECT'         => 'ArtiFrame-Projekt nicht gefunden (config/app-version.php fehlt).',
     'HELP_MODE_DESC'           => 'Ändert den Anwendungsmodus (0=Prod, 1=Debug)',
+
+    // Table
+    'ERROR_TABLE_NAME_REQUIRED' => 'Tabellenname ist erforderlich.',
+    'ERROR_STUB_NOT_FOUND'      => 'sql.stub Datei konnte nicht gefunden werden.',
+    'ERROR_TABLE_NOT_IN_STUB'   => 'Tabellendefinition \'%s\' nicht in der Stub-Datei gefunden.',
+    'SUCCESS_TABLE_ADDED'       => 'Tabelle \'%s\' erfolgreich an schema.sql angehängt.',
+    'HELP_TABLE_DESC'           => 'Hängt ein Standard-Tabellenschema aus sql.stub an schema.sql an.',
+    'TABLE_LIST_HEADER' => 'Unterstützte Tabellen:',
+    'TABLE_DESC_USERS' => 'Basis-Benutzer- und Autorisierungstabelle (UUID).',
+    'TABLE_DESC_USER_SESSIONS' => 'Benutzersitzungen (IP, Gerät, Token) verfolgen.',
+    'TABLE_DESC_USER_PREFERENCES' => 'Benutzereinstellungen (Sprache, Thema, Benachrichtigungen).',
+
 ];

package/src/Lang/en.php

@@ -75,6 +75,8 @@ return [
     'HELP_MAJOR_DOWN'        => 'Roll back last major release.',
     'HELP_HELP_DESC'         => 'Show this help message.',
     'HELP_EXIT_DESC'         => 'Exit the interactive shell.',
+    'HELP_AUTH_DESC'         => 'Authenticate with GitHub to enable issue suggestions.',
+    'HELP_SUGGEST_DESC'      => 'Submit a feature request, bug report, or helper suggestion directly to GitHub.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Current language:',
@@ -166,4 +168,16 @@ return [
     'MODE_INVALID'             => 'Invalid mode. Use 1 for Debug, 0 for Prod.',
     'MODE_NOT_PROJECT'         => 'ArtiFrame project not found (config/app-version.php missing).',
     'HELP_MODE_DESC'           => 'Changes the application mode (0=Prod, 1=Debug)',
+
+    // Table
+    'ERROR_TABLE_NAME_REQUIRED' => 'Table name is required.',
+    'ERROR_STUB_NOT_FOUND'      => 'sql.stub file could not be found.',
+    'ERROR_TABLE_NOT_IN_STUB'   => 'Table definition \'%s\' not found in stub file.',
+    'SUCCESS_TABLE_ADDED'       => 'Table \'%s\' successfully appended to schema.sql',
+    'HELP_TABLE_DESC'           => 'Appends a standard table schema from sql.stub to schema.sql',
+    'TABLE_LIST_HEADER' => 'Supported Tables:',
+    'TABLE_DESC_USERS' => 'Basic user and authorization table (UUID).',
+    'TABLE_DESC_USER_SESSIONS' => 'User sessions (IP, device, token) tracking.',
+    'TABLE_DESC_USER_PREFERENCES' => 'User preferences (language, theme, notifications).',
+
 ];

package/src/Lang/es.php

@@ -75,6 +75,8 @@ return [
     'HELP_MAJOR_DOWN'        => 'Revertir la última versión mayor.',
     'HELP_HELP_DESC'         => 'Mostrar este mensaje de ayuda.',
     'HELP_EXIT_DESC'         => 'Salir del shell interactivo.',
+    'HELP_AUTH_DESC'         => 'Autentifícate con GitHub para habilitar las sugerencias de issues.',
+    'HELP_SUGGEST_DESC'      => 'Envía una solicitud de función, un informe de error o una sugerencia de ayuda directamente a GitHub.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Idioma actual:',
@@ -166,4 +168,16 @@ return [
     'MODE_INVALID'             => 'Modo no válido. Use 1 para Depuración, 0 para Producción.',
     'MODE_NOT_PROJECT'         => 'Proyecto ArtiFrame no encontrado (falta config/app-version.php).',
     'HELP_MODE_DESC'           => 'Cambia el modo de la aplicación (0=Prod, 1=Debug)',
+
+    // Table
+    'ERROR_TABLE_NAME_REQUIRED' => 'El nombre de la tabla es obligatorio.',
+    'ERROR_STUB_NOT_FOUND'      => 'No se pudo encontrar el archivo sql.stub.',
+    'ERROR_TABLE_NOT_IN_STUB'   => 'Definición de tabla \'%s\' no encontrada en el archivo stub.',
+    'SUCCESS_TABLE_ADDED'       => 'Tabla \'%s\' añadida con éxito a schema.sql',
+    'HELP_TABLE_DESC'           => 'Añade un esquema de tabla estándar de sql.stub a schema.sql',
+    'TABLE_LIST_HEADER' => 'Tablas compatibles:',
+    'TABLE_DESC_USERS' => 'Tabla básica de usuarios y autorización (UUID).',
+    'TABLE_DESC_USER_SESSIONS' => 'Seguimiento de sesiones de usuario (IP, dispositivo, token).',
+    'TABLE_DESC_USER_PREFERENCES' => 'Preferencias de usuario (idioma, tema, notificaciones).',
+
 ];

package/src/Lang/fr.php

@@ -75,6 +75,8 @@ return [
     'HELP_MAJOR_DOWN'        => 'Annuler la dernière version majeure.',
     'HELP_HELP_DESC'         => 'Afficher ce message d\'aide.',
     'HELP_EXIT_DESC'         => 'Quitter le shell interactif.',
+    'HELP_AUTH_DESC'         => 'Authentifiez-vous avec GitHub pour permettre les suggestions.',
+    'HELP_SUGGEST_DESC'      => 'Soumettez une demande de fonctionnalité, un rapport de bogue ou une suggestion d\'aide directement sur GitHub.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Langue actuelle :',
@@ -166,4 +168,16 @@ return [
     'MODE_INVALID'             => 'Mode invalide. Utilisez 1 pour Débogage, 0 pour Production.',
     'MODE_NOT_PROJECT'         => 'Projet ArtiFrame introuvable (config/app-version.php manquant).',
     'HELP_MODE_DESC'           => 'Modifie le mode de l\'application (0=Prod, 1=Debug)',
+
+    // Table
+    'ERROR_TABLE_NAME_REQUIRED' => 'Le nom de la table est requis.',
+    'ERROR_STUB_NOT_FOUND'      => 'Le fichier sql.stub est introuvable.',
+    'ERROR_TABLE_NOT_IN_STUB'   => 'La définition de la table \'%s\' est introuvable dans le fichier stub.',
+    'SUCCESS_TABLE_ADDED'       => 'Table \'%s\' ajoutée avec succès à schema.sql',
+    'HELP_TABLE_DESC'           => 'Ajoute un schéma de table standard de sql.stub à schema.sql',
+    'TABLE_LIST_HEADER' => 'Tables prises en charge :',
+    'TABLE_DESC_USERS' => 'Table de base pour les utilisateurs et l\'autorisation (UUID).',
+    'TABLE_DESC_USER_SESSIONS' => 'Suivi des sessions utilisateur (IP, appareil, token).',
+    'TABLE_DESC_USER_PREFERENCES' => 'Préférences de l\'utilisateur (langue, thème, notifications).',
+
 ];

package/src/Lang/tr.php

@@ -74,7 +74,9 @@ return [
     'HELP_MINOR_DOWN'        => 'Son minör sürümün geri alınması.',
     'HELP_MAJOR_DOWN'        => 'Son majör sürümün geri alınması.',
     'HELP_HELP_DESC'         => 'Bu yardım mesajını gösterir.',
-    'HELP_EXIT_DESC'         => 'İnteraktif kabuğu kapatır.',
+    'HELP_EXIT_DESC'         => 'Etkileşimli kabuktan çık.',
+    'HELP_AUTH_DESC'         => 'Issue önerileri için GitHub ile kimlik doğrulaması yapın.',
+    'HELP_SUGGEST_DESC'      => 'GitHub\'a doğrudan özellik isteği, hata bildirimi veya öneri gönderin.',
 
     // LangCommand
     'LANG_CURRENT'        => 'Mevcut dil:',
@@ -166,4 +168,16 @@ return [
     'MODE_INVALID'             => 'Hatalı mod. Debug için 1, Prod için 0 kullanın.',
     'MODE_NOT_PROJECT'         => 'ArtiFrame projesi bulunamadı (config/app-version.php eksik).',
     'HELP_MODE_DESC'           => 'Uygulama çalışma modunu değiştirir (0=Prod, 1=Debug)',
+
+    // Table
+    'ERROR_TABLE_NAME_REQUIRED' => 'Tablo adı gerekli.',
+    'ERROR_STUB_NOT_FOUND'      => 'sql.stub dosyası bulunamadı.',
+    'ERROR_TABLE_NOT_IN_STUB'   => '\'%s\' tablo şablonu stub dosyasında bulunamadı.',
+    'SUCCESS_TABLE_ADDED'       => '\'%s\' tablosu başarıyla schema.sql dosyasına eklendi.',
+    'HELP_TABLE_DESC'           => 'sql.stub dosyasındaki standart tablo yapılarını schema.sql\'e ekler.',
+    'TABLE_LIST_HEADER' => 'Desteklenen Tablolar:',
+    'TABLE_DESC_USERS' => 'Temel kullanıcı ve yetkilendirme tablosu (UUID).',
+    'TABLE_DESC_USER_SESSIONS' => 'Kullanıcı oturumları (IP, cihaz, token) takibi.',
+    'TABLE_DESC_USER_PREFERENCES' => 'Kullanıcı tercihleri (dil, tema, bildirimler).',
+
 ];

package/stubs/sql.stub

@@ -0,0 +1,46 @@
+-- [TABLE:users]
+CREATE TABLE `users` (
+  `id` binary(16) NOT NULL,
+  `email` varchar(255) NOT NULL,
+  `password` varchar(255) NOT NULL,
+  `name` varchar(255) DEFAULT NULL,
+  `role` enum('user','admin','moderator') NOT NULL DEFAULT 'user',
+  `status` tinyint(1) NOT NULL DEFAULT '1',
+  `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `email` (`email`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+-- [/TABLE:users]
+
+-- [TABLE:user_sessions]
+CREATE TABLE `user_sessions` (
+  `id` binary(16) NOT NULL,
+  `user_id` binary(16) NOT NULL,
+  `token` varchar(255) NOT NULL,
+  `ip_address` varchar(45) DEFAULT NULL,
+  `user_agent` varchar(255) DEFAULT NULL,
+  `expires_at` timestamp NULL DEFAULT NULL,
+  `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `token` (`token`),
+  KEY `user_id` (`user_id`),
+  CONSTRAINT `fk_user_sessions_user_id` FOREIGN KEY (`user_id`) REFERENCES `users` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+-- [/TABLE:user_sessions]
+
+-- [TABLE:user_preferences]
+CREATE TABLE `user_preferences` (
+  `id` binary(16) NOT NULL,
+  `user_id` binary(16) NOT NULL,
+  `language` varchar(10) NOT NULL DEFAULT 'tr',
+  `theme` varchar(20) NOT NULL DEFAULT 'light',
+  `push_notifications` tinyint(1) NOT NULL DEFAULT '1',
+  `email_notifications` tinyint(1) NOT NULL DEFAULT '1',
+  `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `user_id` (`user_id`),
+  CONSTRAINT `fk_user_prefs_user_id` FOREIGN KEY (`user_id`) REFERENCES `users` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+-- [/TABLE:user_preferences]