@artilingo/artiframe-cli 1.2.1 → 1.3.0

package/core-stubs/docs/tr.html

@@ -276,7 +276,8 @@
         <a href="#cli-new">new</a>
         <a href="#cli-view">make:view</a>
         <a href="#cli-api">make:api</a>
-        <a href="#cli-class">make:class</a>
+        <a href="#cli-class">make:class</a>
+        <a href="#cli-table">table:</a>
         <a href="#cli-cliv">cli v</a>
         <a href="#cli-show">show</a>
         <a href="#cli-list">list</a>
@@ -310,7 +311,8 @@
         <a href="#vh-maskemail">maskEmail()</a>
         <a href="#vh-maskphone">maskPhone()</a>
         <a href="#vh-slugify">slugify()</a>
-        <a href="#vh-money">money()</a>
+        <a href="#vh-money">money()</a>
+        <a href="#vh-uuid">uuid()</a>
 
         
         <div class="sb-cat">System Helpers</div>
@@ -356,7 +358,8 @@
         <a href="#sh-formatid">formatId()</a>
         <a href="#sh-intid">intId()</a>
         <a href="#sh-bigintid">bigintId()</a>
-        <a href="#sh-stringer">stringer()</a>
+        <a href="#sh-stringer">stringer()</a>
+        <a href="#sh-otpcoder">OTP Coder</a>
         <div class="sb-cat">API Güvenliği</div>
         <a href="#api-methods">HTTP Metod Kontrolü</a>
         <a href="#api-cors">CORS</a>
@@ -484,6 +487,14 @@
             }
         </script>
 
+    
+        <h3 style="margin-top: 30px;">Ek Komutlar</h3>
+        <p><strong>Tabloları Listelemek:</strong> Mevcut tüm tablo şablonlarını ve açıklamalarını görmek için:</p>
+        <pre><code>artiframe&gt; <span class="fn">table</span> <span class="st">list</span></code></pre>
+        
+        <p><strong>Tablo İçeriğini Önizlemek:</strong> Bir tabloyu <code>schema.sql</code> dosyasına eklemeden önce SQL içeriğini terminalde incelemek için komutun sonuna <code>check</code> parametresini ekleyebilirsiniz:</p>
+        <pre><code>artiframe&gt; <span class="fn">table:</span><span class="st">users</span> <span class="st">check</span></code></pre>
+
     </section>
 
     <!-- ====== KURULUM ====== -->
@@ -828,6 +839,99 @@ Example: /src/Service/PaymentService</code></pre>
 
     
     
+    
+    <!-- table: -->
+    <section id="cli-table">
+        <h2><code>table:</code> <span class="tag b-cli">CLI Komutu</span></h2>
+        <p>Projenizdeki <code>schema.sql</code> dosyasına hızlıca standart ve ilişkisel veritabanı tablolarını eklemenizi sağlar. Şablonlar global <code>stubs/sql.stub</code> dosyasından okunur.</p>
+        <pre><code>artiframe&gt; <span class="fn">table:</span><span class="st">users</span></code></pre>
+        <p>Şu an desteklenen standart tablolar:</p>
+                <div class="table-tabs-container" style="margin-top: 20px;">
+            <div class="tabs-header" style="display: flex; gap: 10px; margin-bottom: 10px; overflow-x: auto; padding-bottom: 5px;">
+                <button class="table-tab-btn active" onclick="switchTableTab('tab-users', this)" style="white-space: nowrap; padding: 10px 20px; background: #00c88c; color: #000; font-weight: 600; border: none; border-radius: 5px; cursor: pointer;">users</button>
+                <button class="table-tab-btn" onclick="switchTableTab('tab-sessions', this)" style="white-space: nowrap; padding: 10px 20px; background: #1c2128; color: #fff; border: 1px solid #30363d; border-radius: 5px; cursor: pointer;">user_sessions</button>
+                <button class="table-tab-btn" onclick="switchTableTab('tab-prefs', this)" style="white-space: nowrap; padding: 10px 20px; background: #1c2128; color: #fff; border: 1px solid #30363d; border-radius: 5px; cursor: pointer;">user_preferences</button>
+            </div>
+
+            <!-- Tab: users -->
+            <div id="tab-users" class="table-tab-content" style="display: block;">
+                <pre><code><span class="kw">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;</span></code></pre>
+            </div>
+
+            <!-- Tab: user_sessions -->
+            <div id="tab-sessions" class="table-tab-content" style="display: none;">
+                <pre><code><span class="kw">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;</span></code></pre>
+            </div>
+
+            <!-- Tab: user_preferences -->
+            <div id="tab-prefs" class="table-tab-content" style="display: none;">
+                <pre><code><span class="kw">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;</span></code></pre>
+            </div>
+        </div>
+        
+        <script>
+            function switchTableTab(tabId, btn) {
+                const container = btn.closest('.table-tabs-container');
+                container.querySelectorAll('.table-tab-content').forEach(el => el.style.display = 'none');
+                container.querySelectorAll('.table-tab-btn').forEach(el => {
+                    el.style.background = '#1c2128';
+                    el.style.color = '#fff';
+                    el.style.border = '1px solid #30363d';
+                    el.style.fontWeight = '400';
+                });
+                
+                container.querySelector('#' + tabId).style.display = 'block';
+                btn.style.background = '#00c88c';
+                btn.style.color = '#000';
+                btn.style.fontWeight = '600';
+                btn.style.border = 'none';
+            }
+        </script>
+    
+        <h3 style="margin-top: 30px;">Ek Komutlar</h3>
+        <p><strong>Tabloları Listelemek:</strong> Mevcut tüm tablo şablonlarını ve açıklamalarını görmek için:</p>
+        <pre><code>artiframe&gt; <span class="fn">table</span> <span class="st">list</span></code></pre>
+        
+        <p><strong>Tablo İçeriğini Önizlemek:</strong> Bir tabloyu <code>schema.sql</code> dosyasına eklemeden önce SQL içeriğini terminalde incelemek için komutun sonuna <code>check</code> parametresini ekleyebilirsiniz:</p>
+        <pre><code>artiframe&gt; <span class="fn">table:</span><span class="st">users</span> <span class="st">check</span></code></pre>
+
+    </section>
+
     <!-- cli v -->
     <section id="cli-cliv">
         <h2><code>cli v</code> (veya <code>cli version</code>) <span class="tag b-cli">CLI Komutu</span></h2>
@@ -4461,7 +4565,15 @@ if ($response['status'] === 'success') {
 
 &lt;span&gt;&lt;?= <span class="fn">money</span>(<span class="var">$urun</span>[<span class="st">'fiyat'</span>], <span class="st">'usd'</span>) ?&gt;&lt;/span&gt;
 <span class="cm">&lt;!-- Çıktı: $1.250,00 --&gt;</span></code></pre>
-    </section>
+    </section>
+
+    <section id="vh-uuid">
+        <h2>View Helpers - <code>uuid()</code> <span class="tag b-view">ViewMethod</span></h2>
+        <p>Veritabanından gelen 16 byte'lık binary UUID verisini 36 karakterlik formata çevirip ekrana XSS korumalı olarak basar.</p>
+        <pre><code><span class="cm">&lt;!-- Çıktı: 0190ed84-3f12-7a91-8bc4-91823741abcd --&gt;</span>
+&lt;div&gt;<span class="kw">&lt;?=</span> <span class="fn">uuid</span>(<span class="var">$pull</span>[<span class="st">'id'</span>]) <span class="kw">?&gt;</span>&lt;/div&gt;</code></pre>
+    </section>
+
 
     
 
@@ -4519,6 +4631,31 @@ if ($response['status'] === 'success') {
 <span class="fn">jsonResponse</span>([<span class="st">'status'</span> =&gt; <span class="st">'error'</span>, <span class="st">'message'</span> =&gt; <span class="st">'Yetkisiz erişim.'</span>], <span class="nu">401</span>);</code></pre>
     </section>
 
+    
+<section id="sh-dd">
+        <h2>System Helpers — <code>dd()</code> <span class="tag b-api">SystemMethod</span></h2>
+        <p>Dump & Die. Geliştirme aşamasında değişkenleri ekrana koyu temalı (dark mode), okunabilir ve şık bir <code>&lt;pre&gt;</code> etiketi içinde basar ve kodun çalışmasını o satırda durdurur (exit). Sınırsız parametre (Variadic) alabilir.</p>
+        <span class="ret">void dd(mixed ...$vars)</span>
+        <pre><code><span class="fn">dd</span>(<span class="var">$_POST</span>, <span class="var">$kullanici_id</span>); 
+<span class="cm">// Değerleri ekrana basar ve sistemi durdurur.</span></code></pre>
+    </section>
+
+
+    <!-- ====== ID GENERATION & UTILITIES ====== -->
+    <section id="id-generation-utilities">
+
+        </section>
+
+    
+<section id="sh-redirect">
+        <h2>System Helpers — <code>redirect()</code> <span class="tag b-api">SystemMethod</span></h2>
+        <span class="ret">void redirect(string $url)</span>
+        <p>İstenilen sayfaya <code>header("Location: ...")</code> ile anında yönlendirme yapar ve çalışmayı durdurur (<code>exit</code>).</p>
+        <pre><code><span class="kw">if</span> (!<span class="var">$isLoggedIn</span>) {
+    <span class="fn">redirect</span>(<span class="st">'/login'</span>);
+}</code></pre>
+    </section>
+
     <section id="sh-generatecsrf">
         <h2>System Helpers — <code>generateCsrf()</code> <span class="tag b-api">SystemMethod</span></h2>
         <p>Oturum (Session) tabanlı 32 byte uzunluğunda yepyeni bir güvenli CSRF token üretir. Formlara gizli input olarak eklemek için <code>csrfField()</code> (View Helper) kullanılması önerilir.</p>
@@ -4623,14 +4760,7 @@ if ($response['status'] === 'success') {
         <pre><code><span class="var">$ip</span> = <span class="fn">getClientIp</span>(); <span class="cm">// Örn: 192.168.1.1</span></code></pre>
     </section>
 
-    <section id="sh-redirect">
-        <h2>System Helpers — <code>redirect()</code> <span class="tag b-api">SystemMethod</span></h2>
-        <span class="ret">void redirect(string $url)</span>
-        <p>İstenilen sayfaya <code>header("Location: ...")</code> ile anında yönlendirme yapar ve çalışmayı durdurur (<code>exit</code>).</p>
-        <pre><code><span class="kw">if</span> (!<span class="var">$isLoggedIn</span>) {
-    <span class="fn">redirect</span>(<span class="st">'/login'</span>);
-}</code></pre>
-    </section>
+    
 
     
 
@@ -4698,19 +4828,10 @@ if ($response['status'] === 'success') {
 <span class="cm">// ID, rol gibi dışarıdan manipüle edilmiş değerler otomatik yok edilir.</span></code></pre>
     </section>
 
-    <section id="sh-dd">
-        <h2>System Helpers — <code>dd()</code> <span class="tag b-api">SystemMethod</span></h2>
-        <p>Dump & Die. Geliştirme aşamasında değişkenleri ekrana koyu temalı (dark mode), okunabilir ve şık bir <code>&lt;pre&gt;</code> etiketi içinde basar ve kodun çalışmasını o satırda durdurur (exit). Sınırsız parametre (Variadic) alabilir.</p>
-        <span class="ret">void dd(mixed ...$vars)</span>
-        <pre><code><span class="fn">dd</span>(<span class="var">$_POST</span>, <span class="var">$kullanici_id</span>); 
-<span class="cm">// Değerleri ekrana basar ve sistemi durdurur.</span></code></pre>
-    </section>
-
-
-    <!-- ====== ID GENERATION & UTILITIES ====== -->
-    <section id="id-generation-utilities">
-
-        <h2 id="sh-byteid">System Helpers - <code>byteId()</code> <span class="tag b-api">SystemMethod</span></h2>
+    
+
+    <section id="sh-byteid">
+        <h2>System Helpers - <code>byteId()</code> <span class="tag b-api">SystemMethod</span></h2>
         <div class="info-box">
             Native, yüksek performanslı ve sıralı (Time-ordered) raw 16-byte <strong>UUIDv7</strong> üretir.
         </div>
@@ -4727,7 +4848,10 @@ if ($response['status'] === 'success') {
 <span class="var">$db</span>-&gt;<span class="fn">prepare</span>(<span class="st">"INSERT INTO users (id, name) VALUES (?, ?)"</span>)-&gt;<span class="fn">execute</span>([<span class="var">$rawId</span>, <span class="st">'Utku'</span>]);</code></pre>
         </div>
 
-        <h2 id="sh-makeid">System Helpers - <code>makeId()</code> <span class="tag b-api">SystemMethod</span></h2>
+        </section>
+
+    <section id="sh-makeid">
+        <h2>System Helpers - <code>makeId()</code> <span class="tag b-api">SystemMethod</span></h2>
         <div class="info-box">
             Native, standart 36 karakterlik <strong>UUIDv7</strong> string'i üretir.
         </div>
@@ -4742,7 +4866,10 @@ if ($response['status'] === 'success') {
 <span class="cm">// Örnek Çıktı: 0190ed84-3f12-7a91-8bc4-91823741abcd</span></code></pre>
         </div>
 
-        <h2 id="sh-formatid">System Helpers - <code>formatId()</code> <span class="tag b-api">SystemMethod</span></h2>
+        </section>
+
+    <section id="sh-formatid">
+        <h2>System Helpers - <code>formatId()</code> <span class="tag b-api">SystemMethod</span></h2>
         <div class="info-box">
             Raw 16-byte binary UUID'leri 36 karakterlik standart string'e dönüştürür.
         </div>
@@ -4758,7 +4885,10 @@ if ($response['status'] === 'success') {
 <span class="cm">// Örnek Çıktı: 0190ed84-3f12-7a91-8bc4-91823741abcd</span></code></pre>
         </div>
 
-        <h2 id="sh-intid">System Helpers - <code>intId()</code> <span class="tag b-api">SystemMethod</span></h2>
+        </section>
+
+    <section id="sh-intid">
+        <h2>System Helpers - <code>intId()</code> <span class="tag b-api">SystemMethod</span></h2>
         <div class="info-box">
             Güvenli, rastgele <code>INT</code> ID üretir. (Max 9 Hane)
         </div>
@@ -4771,7 +4901,10 @@ if ($response['status'] === 'success') {
 <span class="cm">// Örnek Çıktı: 49201834</span></code></pre>
         </div>
 
-        <h2 id="sh-bigintid">System Helpers - <code>bigintId()</code> <span class="tag b-api">SystemMethod</span></h2>
+        </section>
+
+    <section id="sh-bigintid">
+        <h2>System Helpers - <code>bigintId()</code> <span class="tag b-api">SystemMethod</span></h2>
         <div class="info-box">
             Güvenli, rastgele <code>BIGINT</code> ID üretir. (Varsayılan 15 hane - JS için güvenli sınır)
         </div>
@@ -4784,7 +4917,10 @@ if ($response['status'] === 'success') {
 <span class="var">$massiveId</span> = <span class="fn">bigintId</span>(18, <span class="kw">true</span>); <span class="cm">// 18 haneli STRING döner (JS için güvenli)</span></code></pre>
         </div>
 
-        <h2 id="sh-stringer">System Helpers - <code>stringer()</code> <span class="tag b-api">SystemMethod</span></h2>
+        </section>
+
+    <section id="sh-stringer">
+        <h2>System Helpers - <code>stringer()</code> <span class="tag b-api">SystemMethod</span></h2>
         <div class="info-box">
             Değerleri Javascript'in devasa sayı (BIGINT) duyarsızlığına karşı güvenli bir şekilde string'e sarmalar.
         </div>
@@ -4797,6 +4933,24 @@ if ($response['status'] === 'success') {
 &lt;button data-id=<span class="st">"&lt;?=</span> <span class="fn">stringer</span>(<span class="var">$data</span>[<span class="st">'id'</span>]) <span class="st">?&gt;"</span>&gt;Sil&lt;/button&gt;</code></pre>
         </div>
 
+    
+
+    <section id="sh-otpcoder">
+        <h2>System Helpers - OTP Coder <span class="tag b-api">SystemMethod</span></h2>
+        <div class="info-box">Rastgele, kriptografik olarak güvenli Doğrulama Kodları (OTP) üretir.</div>
+        <div class="code-block">
+            <pre><code><span class="cm">// 6 haneli rastgele sayı</span>
+<span class="var">$code</span> = <span class="fn">otpInt</span>(<span class="nu">6</span>); <span class="cm">// 482910</span>
+
+<span class="cm">// 8 haneli sadece harf ('c': küçük, 'C': büyük, 'cC': karışık)</span>
+<span class="var">$code</span> = <span class="fn">otpStr</span>(<span class="nu">8</span>, <span class="st">'C'</span>); <span class="cm">// PKLMDZRA</span>
+
+<span class="cm">// 6 haneli harf+sayı (Alphanumeric)</span>
+<span class="var">$code</span> = <span class="fn">otpMix</span>(<span class="nu">6</span>, <span class="st">'C'</span>); <span class="cm">// 9A4X2Z</span></code></pre>
+        </div>
+    </section>
+
+
     </section>
 
     <!-- ====== API GÜVENLİĞİ ====== -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artilingo/artiframe-cli",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "ArtiFrame — Zero-dependency native PHP framework with a powerful multilingual CLI. Scaffold projects, generate views, APIs and classes instantly.",
   "main": "bin/artiframe.js",
   "bin": {

package/src/App.php

@@ -170,6 +170,17 @@ class App
 
     private function routeCommand(string $commandName, array $commandArgs): void
     {
+        if (strpos($commandName, 'table:') === 0) {
+            $tableName = substr($commandName, 6);
+            (new \ArtiFrame\Cli\Commands\TableCommand($this->translator))->execute(array_merge([$tableName], $commandArgs));
+            return;
+        }
+
+        if ($commandName === 'table' && !empty($commandArgs) && $commandArgs[0] === 'list') {
+            (new \ArtiFrame\Cli\Commands\TableCommand($this->translator))->execute(['list']);
+            return;
+        }
+
         switch ($commandName) {
 
 
@@ -302,7 +313,13 @@ class App
         // make:class
         echo "  " . $g . "make:class" . $r . " " . $y . "<path>" . $r . PHP_EOL;
         echo "  " . $d . "│" . $r . "   " . $t->get('HELP_MAKECLASS_DESC') . PHP_EOL;
-        echo "  " . $d . "└── " . $r . "Example: " . $lg . "make:class app/Services/UserManager.php" . $r . PHP_EOL;
+        echo "  " . $d . "└─ " . $r . "Example: " . $lg . "make:class app/Services/UserManager.php" . $r . PHP_EOL;
+        echo PHP_EOL;
+
+        // table
+        echo "  " . $g . "table:<table>" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   " . $t->get('HELP_TABLE_DESC') . PHP_EOL;
+        echo "  " . $d . "└─ " . $r . "Example: " . $lg . "table:users" . $r . PHP_EOL;
         echo PHP_EOL;
 
         // cli v / cli version — CLI self-version

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

@@ -166,4 +166,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

@@ -166,4 +166,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

@@ -166,4 +166,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

@@ -166,4 +166,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

@@ -166,4 +166,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]