@artilingo/artiframe-cli 1.2.1 → 1.3.0

package/core-stubs/bin/SystemMethod.php

@@ -312,19 +312,31 @@ class SystemMethod
     }
 
     /**
-     * Converts a raw 16-byte binary UUID into its standard string representation.
-     * (e.g. 0190ed84-3f12-7a91-8bc4-91823741abcd)
-     *
-     * @param string $binaryUuid 16-byte binary string
-     * @return string 36-character hyphenated UUID string
+     * Bi-directional UUID formatter (String <-> Binary)
+     * 
+     * @param string $value 16-byte binary string OR 36-character UUID string
+     * @param string $to 'auto', 'binary', or 'string'
+     * @return string
      */
-    public static function formatId(string $binaryUuid): string
+    public static function formatId(string $value, string $to = 'auto'): string
     {
-        if (strlen($binaryUuid) !== 16) {
+        // Target: Binary conversion (String -> Binary)
+        if ($to === 'binary' || ($to === 'auto' && strlen($value) !== 16)) {
+            $cleanHex = str_replace('-', '', $value);
+            
+            if (strlen($cleanHex) !== 32) {
+                throw new \InvalidArgumentException("Invalid UUID string format.");
+            }
+            
+            return hex2bin($cleanHex);
+        }
+
+        // Target: String conversion (Binary -> String)
+        if (strlen($value) !== 16) {
             throw new \InvalidArgumentException("Invalid binary UUID length. Expected 16 bytes.");
         }
         
-        $hex = bin2hex($binaryUuid);
+        $hex = bin2hex($value);
         
         return sprintf(
             '%s-%s-%s-%s-%s',
@@ -378,6 +390,72 @@ class SystemMethod
         return $asString ? (string) $result : $result;
     }
 
+    /**
+     * Sadece sayılardan oluşan rastgele bir OTP (One-Time Password) kodu üretir.
+     * @param int $length Hanelerin sayısı (Varsayılan 6)
+     */
+    public static function otpInt(int $length = 6): int
+    {
+        if ($length < 1) $length = 1;
+        if ($length > 18) $length = 18; // PHP 64-bit safe max length
+        
+        $min = (int) str_pad('1', $length, '0');
+        $max = (int) str_pad('9', $length, '9');
+        
+        return random_int($min, $max);
+    }
+
+    /**
+     * Sadece harflerden oluşan rastgele bir OTP kodu üretir.
+     * @param int $length Hanelerin sayısı (Varsayılan 6)
+     * @param string $case 'c': Sadece küçük, 'C': Sadece büyük, 'cC'/'Cc': Karışık
+     */
+    public static function otpStr(int $length = 6, string $case = 'C'): string
+    {
+        $lower = 'abcdefghijklmnopqrstuvwxyz';
+        $upper = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+
+        $chars = match (strtolower($case)) {
+            'c'  => $lower,
+            'cc' => $lower . $upper,
+            default => $upper,
+        };
+        
+        $otp = '';
+        $maxIndex = strlen($chars) - 1;
+        for ($i = 0; $i < $length; $i++) {
+            $otp .= $chars[random_int(0, $maxIndex)];
+        }
+        
+        return $otp;
+    }
+
+    /**
+     * Harf ve sayılardan (Alphanumeric) oluşan rastgele bir OTP kodu üretir.
+     * @param int $length Hanelerin sayısı (Varsayılan 6)
+     * @param string $case 'c': Küçük+Sayı, 'C': Büyük+Sayı, 'cC'/'Cc': Karışık+Sayı
+     */
+    public static function otpMix(int $length = 6, string $case = 'C'): string
+    {
+        $numbers = '0123456789';
+        $lower   = 'abcdefghijklmnopqrstuvwxyz';
+        $upper   = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+
+        $chars = match (strtolower($case)) {
+            'c'  => $numbers . $lower,
+            'cc' => $numbers . $lower . $upper,
+            default => $numbers . $upper,
+        };
+        
+        $otp = '';
+        $maxIndex = strlen($chars) - 1;
+        for ($i = 0; $i < $length; $i++) {
+            $otp .= $chars[random_int(0, $maxIndex)];
+        }
+        
+        return $otp;
+    }
+
     /**
      * Gelen veriyi (özellikle BigInt ID'leri) güvenli bir şekilde string'e çevirir.
      * Javascript'te 15 haneyi aşan sayılardaki veri kaybını engellemek için
@@ -517,8 +595,8 @@ if (!function_exists(__NAMESPACE__ . '\\byteId')) {
 }
 
 if (!function_exists(__NAMESPACE__ . '\\formatId')) {
-    function formatId(string $binaryUuid): string {
-        return \Bin\SystemMethod::formatId($binaryUuid);
+    function formatId(string $value, string $to = 'auto'): string {
+        return \Bin\SystemMethod::formatId($value, $to);
     }
 }
 
@@ -545,3 +623,21 @@ if (!function_exists(__NAMESPACE__ . '\\stringer')) {
         return \Bin\SystemMethod::stringer($value);
     }
 }
+
+if (!function_exists(__NAMESPACE__ . '\\otpInt')) {
+    function otpInt(int $length = 6): int {
+        return \Bin\SystemMethod::otpInt($length);
+    }
+}
+
+if (!function_exists(__NAMESPACE__ . '\\otpStr')) {
+    function otpStr(int $length = 6, string $case = 'C'): string {
+        return \Bin\SystemMethod::otpStr($length, $case);
+    }
+}
+
+if (!function_exists(__NAMESPACE__ . '\\otpMix')) {
+    function otpMix(int $length = 6, string $case = 'C'): string {
+        return \Bin\SystemMethod::otpMix($length, $case);
+    }
+}

package/core-stubs/bin/ViewMethod.php

@@ -345,6 +345,16 @@ class ViewMethod
         $masked = $start . str_repeat('*', max($len - 5, 3)) . $end;
         return self::display($masked);
     }
+
+    /**
+     * Veritabanından gelen 16 byte'lık binary UUID verisini 36 karakterlik 
+     * okunabilir (HEX) formata dönüştürür ve ekrana basar.
+     */
+    public static function uuid(?string $binaryId): string
+    {
+        if (empty($binaryId)) return '-';
+        return self::display(\Bin\SystemMethod::formatId($binaryId));
+    }
 }
 
 // Geliştiriciler (Özellikle Juniorlar) için kullanımı en kolay global yardımcı fonksiyonlar
@@ -461,3 +471,9 @@ if (!function_exists(__NAMESPACE__ . '\\maskPhone')) {
         return \Bin\ViewMethod::maskPhone($phone);
     }
 }
+
+if (!function_exists(__NAMESPACE__ . '\\uuid')) {
+    function uuid(?string $binaryId): string {
+        return \Bin\ViewMethod::uuid($binaryId);
+    }
+}

package/core-stubs/docs/de.html

@@ -275,7 +275,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>
@@ -308,7 +309,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">Systemhelfer</div>
 <div class="sb-subcat">Antwort und Fehlerbehebung</div>
 <a href="#sh-apiresponse">apiResponse()</a>
@@ -344,7 +346,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-Sicherheit</div>
 <a href="#api-methods">HTTP-Methodensteuerung</a>
 <a href="#api-cors">CORS</a>
@@ -454,7 +457,15 @@
                 btn.style.border = 'none';
             }
         </script>
-</section>
+
+        <h3 style="margin-top: 30px;">Zusätzliche Befehle</h3>
+        <p><strong>Tabellen auflisten:</strong> Um alle verfügbaren Tabellenvorlagen und ihre Beschreibungen anzuzeigen:</p>
+        <pre><code>artiframe&gt; <span class="fn">table</span> <span class="st">list</span></code></pre>
+        
+        <p><strong>Tabelleninhalt in der Vorschau anzeigen:</strong> Um den SQL-Inhalt im Terminal zu überprüfen, bevor Sie ihn zur <code>schema.sql</code>-Datei hinzufügen, können Sie den <code>check</code> Parameter anhängen:</p>
+        <pre><code>artiframe&gt; <span class="fn">table:</span><span class="st">users</span> <span class="st">check</span></code></pre>
+
+    </section>
 <!-- ====== KURULUM ====== -->
 <section id="kurulum">
 <h2>Aufstellen</h2>
@@ -762,7 +773,100 @@ Projektname/
 ❌ Hata: Sınıfın oluşturulacağı dizin belirtilmeli! (örn: /app veya /src)
 Example: /src/Service/PaymentService</code></pre>
 </section>
-<!-- cli v -->
+
+    <!-- table: -->
+    <section id="cli-table">
+        <h2><code>table:</code> <span class="tag b-cli">CLI-Befehl</span></h2>
+        <p>Ermöglicht das schnelle Anhängen von standardmäßigen und relationalen Datenbanktabellen an die <code>schema.sql</code>-Datei Ihres Projekts. Die Vorlagen werden aus der globalen Datei <code>stubs/sql.stub</code> gelesen.</p>
+        <pre><code>artiframe&gt; <span class="fn">table:</span><span class="st">users</span></code></pre>
+        <p>Derzeit unterstützte Standardtabellen:</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;">Zusätzliche Befehle</h3>
+        <p><strong>Tabellen auflisten:</strong> Um alle verfügbaren Tabellenvorlagen und ihre Beschreibungen anzuzeigen:</p>
+        <pre><code>artiframe&gt; <span class="fn">table</span> <span class="st">list</span></code></pre>
+        
+        <p><strong>Tabelleninhalt in der Vorschau anzeigen:</strong> Um den SQL-Inhalt im Terminal zu überprüfen, bevor Sie ihn zur <code>schema.sql</code>-Datei hinzufügen, können Sie den <code>check</code> Parameter anhängen:</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> (oder <code>cli version</code>) <span class="tag b-cli">CLI Komutu</span></h2>
 <p>ArtiFrame CLI steuert seine eigene (globale) Version des Tools. Zeigt nicht nur die aktuelle Version, <strong>NPM-Registrierung</strong> Außerdem wird geprüft, ob die aktuellste Version verfügbar ist. Wenn es eine neue Version gibt, kann diese sich mit einem Klick global aktualisieren (j/n).<code>npm install -g @artilingo/artiframe-cli@latest</code>).</p>
@@ -3981,7 +4085,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>Konvertiert eine binäre 16-Byte-UUID aus der Datenbank in ein 36-Zeichen-Format und druckt sie mit XSS-Schutz auf den Bildschirm.</p>
+        <pre><code><span class="cm">&lt;!-- Ausgabe: 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>
+
 <!-- ====== SYSTEM HELPERS ====== -->
 <section id="sh-apiresponse">
 <h2>Systemhelfer— <code>apiResponse()</code> <span class="tag b-api">SystemMethod</span></h2>
@@ -4024,7 +4136,29 @@ if ($response['status'] === 'success') {
 <span class="cm">// Hata yanıtı</span>
 <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-generatecsrf">
+
+<section id="sh-dd">
+<h2>Systemhelfer— <code>dd()</code> <span class="tag b-api">SystemMethod</span></h2>
+<p>Dump &amp; Die. Während der Entwicklungsphase wurden die Variablen im dunklen Modus, lesbar und stilvoll auf dem Bildschirm angezeigt. <code>&lt;pre&gt;</code> Tag und stoppt die Ausführung des Codes in dieser Zeile (Exit). Es können unbegrenzte Parameter angenommen werden (Variadic).</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>Systemhelfer— <code>redirect()</code> <span class="tag b-api">SystemMethod</span></h2>
+<span class="ret">void redirect(string $url)</span>
+<p>zur gewünschten Seite <code>header("Location: ...")</code> Es leitet sofort um und funktioniert nicht mehr mit (<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>Systemhelfer— <code>generateCsrf()</code> <span class="tag b-api">SystemMethod</span></h2>
 <p>Es generiert ein brandneues sitzungsbasiertes sicheres CSRF-Token mit einer Länge von 32 Bytes. Zum Hinzufügen als versteckte Eingabe zu Formularen <code>csrfField()</code> Es wird empfohlen, (View Helper) zu verwenden.</p>
 <span class="ret">string generateCsrf()</span>
@@ -4110,14 +4244,7 @@ if ($response['status'] === 'success') {
 <p>Erkennt die tatsächliche IP-Adresse des Benutzers. Wolkenflare (<code>HTTP_CF_CONNECTING_IP</code>), Proxy (<code>HTTP_X_FORWARDED_FOR</code>) und Standard (<code>REMOTE_ADDR</code>) löst alle Verbindungen automatisch auf.</p>
 <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>Systemhelfer— <code>redirect()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">void redirect(string $url)</span>
-<p>zur gewünschten Seite <code>header("Location: ...")</code> Es leitet sofort um und funktioniert nicht mehr mit (<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-verifyemail">
 <h2>Systemhelfer— <code>verifyEmail()</code> <span class="tag b-api">SystemMethod</span></h2>
 <p>Es überprüft anhand von DNS oder Format, ob die angegebene E-Mail-Adresse tatsächlich eine gültige E-Mail-Adresse ist.</p>
@@ -4159,16 +4286,10 @@ if ($response['status'] === 'success') {
 <pre><code><span class="var">$postData</span> = <span class="fn">arrayOnly</span>(<span class="var">$_POST</span>, [<span class="st">'kullanici_adi'</span>, <span class="st">'sifre'</span>, <span class="st">'email'</span>]);
 <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>Systemhelfer— <code>dd()</code> <span class="tag b-api">SystemMethod</span></h2>
-<p>Dump &amp; Die. Während der Entwicklungsphase wurden die Variablen im dunklen Modus, lesbar und stilvoll auf dem Bildschirm angezeigt. <code>&lt;pre&gt;</code> Tag und stoppt die Ausführung des Codes in dieser Zeile (Exit). Es können unbegrenzte Parameter angenommen werden (Variadic).</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">Systemhelfer - <code>byteId()</code> <span class="tag b-api">SystemMethod</span></h2>
+
+
+    <section id="sh-byteid">
+        <h2>Systemhelfer - <code>byteId()</code> <span class="tag b-api">SystemMethod</span></h2>
 <div class="info-box">
             Native, leistungsstarke und zeitlich geordnete 16-Byte-Rohdaten <strong>UUIDv7</strong> produziert.
         </div>
@@ -4184,7 +4305,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">Systemhelfer - <code>makeId()</code> <span class="tag b-api">SystemMethod</span></h2>
+</section>
+
+    <section id="sh-makeid">
+        <h2>Systemhelfer - <code>makeId()</code> <span class="tag b-api">SystemMethod</span></h2>
 <div class="info-box">
             Nativ, Standard 36 Zeichen <strong>UUIDv7</strong> erzeugt die Zeichenfolge.
         </div>
@@ -4198,7 +4322,10 @@ if ($response['status'] === 'success') {
 <span class="var">$stringId</span> = SystemMethod::<span class="fn">makeId</span>();
 <span class="cm">// Örnek Çıktı: 0190ed84-3f12-7a91-8bc4-91823741abcd</span></code></pre>
 </div>
-<h2 id="sh-formatid">Systemhelfer - <code>formatId()</code> <span class="tag b-api">SystemMethod</span></h2>
+</section>
+
+    <section id="sh-formatid">
+        <h2>Systemhelfer - <code>formatId()</code> <span class="tag b-api">SystemMethod</span></h2>
 <div class="info-box">
             Konvertiert rohe 16-Byte-Binär-UUIDs in eine Standardzeichenfolge mit 36 ​​Zeichen.
         </div>
@@ -4213,7 +4340,10 @@ if ($response['status'] === 'success') {
 <span class="var">$readableId</span> = SystemMethod::<span class="fn">formatId</span>(<span class="var">$user</span>[<span class="st">'id'</span>]);
 <span class="cm">// Örnek Çıktı: 0190ed84-3f12-7a91-8bc4-91823741abcd</span></code></pre>
 </div>
-<h2 id="sh-intid">Systemhelfer - <code>intId()</code> <span class="tag b-api">SystemMethod</span></h2>
+</section>
+
+    <section id="sh-intid">
+        <h2>Systemhelfer - <code>intId()</code> <span class="tag b-api">SystemMethod</span></h2>
 <div class="info-box">
             Sicher, zufällig <code>INT</code> Erzeugt eine ID. (Max. 9 Ziffern)
         </div>
@@ -4225,7 +4355,10 @@ if ($response['status'] === 'success') {
 <pre><code><span class="var">$id</span> = <span class="fn">intId</span>(8);
 <span class="cm">// Örnek Çıktı: 49201834</span></code></pre>
 </div>
-<h2 id="sh-bigintid">Systemhelfer - <code>bigintId()</code> <span class="tag b-api">SystemMethod</span></h2>
+</section>
+
+    <section id="sh-bigintid">
+        <h2>Systemhelfer - <code>bigintId()</code> <span class="tag b-api">SystemMethod</span></h2>
 <div class="info-box">
             Sicher, zufällig <code>BIGINT</code> Erzeugt eine ID. (Standard 15 Ziffern – sichere Grenze für JS)
         </div>
@@ -4237,7 +4370,10 @@ if ($response['status'] === 'success') {
 <pre><code><span class="var">$id</span> = <span class="fn">bigintId</span>(); <span class="cm">// 15 haneli INT döner</span>
 <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">Systemhelfer - <code>stringer()</code> <span class="tag b-api">SystemMethod</span></h2>
+</section>
+
+    <section id="sh-stringer">
+        <h2>Systemhelfer - <code>stringer()</code> <span class="tag b-api">SystemMethod</span></h2>
 <div class="info-box">
             Verpackt Werte in Zeichenfolgen, um sie vor der Unempfindlichkeit gegenüber riesigen Zahlen (BIGINT) von Javascript zu schützen.
         </div>
@@ -4249,7 +4385,25 @@ if ($response['status'] === 'success') {
 <pre><code><span class="cm">&lt;!-- JS'in bozmasını engellemek için stringer ile sarmalıyoruz --&gt;</span>
 &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>
+
+
+    <section id="sh-otpcoder">
+        <h2>System Helpers - OTP Coder <span class="tag b-api">SystemMethod</span></h2>
+        <div class="info-box">Generiert zufällige, kryptografisch sichere Einmalpasswörter (OTP).</div>
+        <div class="code-block">
+            <pre><code><span class="cm">// 6-stellige Zufallszahl</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-stellige reine Buchstaben ('c': klein, 'C': groß, 'cC': gemischt)</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-stellig alphanumerisch</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İĞİ ====== -->
 <section id="api-methods">
 <h2>API – HTTP-Methodensteuerung <span class="tag b-sec">ApiControl</span></h2>