@artilingo/artiframe-cli 1.1.2 → 1.2.0

package/core-stubs/docs/fr.html

@@ -282,10 +282,13 @@
 <a href="#cli-go">go</a>
 <a href="#cli-remove">remove</a>
 <a href="#cli-version">version</a>
-<a href="#cli-serve">serve</a>
+<a href="#cli-mode">mode</a>
+        <a href="#cli-serve">serve</a>
 <a href="#cli-add">add</a>
 <div class="sb-cat">Services intégrés</div>
-<a href="#svc-iyzico">Iyzico <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></a>
+                <a href="#svc-qrcode">QR Code</a>
+        <a href="#svc-phpmailer">PHPMailer (Mail)</a>
+        <a href="#svc-iyzico">Iyzico <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></a>
 <a href="#svc-stripe">Stripe <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></a>
 <a href="#svc-jwt">JWT</a>
 <a href="#svc-image">Image Processing</a>
@@ -843,7 +846,16 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
 <pre><code>artiframe&gt; <span class="fn">version</span> upgrade minor
 <span class="cm">✔  Sürüm 1.2.0 → 1.3.0 olarak güncellendi.</span></code></pre>
 </section>
-<!-- serve -->
+    <!-- mode -->
+    <section id="cli-mode">
+        <h2><code>mode</code> <span class="tag b-cli">Commande CLI</span></h2>
+        <p>Permet de modifier le mode de fonctionnement du projet (Développement ou Production) avec une seule commande. Cela vous évite d'ouvrir et de modifier manuellement le fichier <code>config/app-version.php</code>.</p>
+        <pre><code>artiframe&gt; <span class="fn">mode</span> <span class="st">1</span>
+  ✅ Passé du mode Prod au mode Debug.</code></pre>
+        <p>Vous pouvez utiliser le paramètre <code>0</code> pour passer à la version de production :</p>
+        <pre><code>artiframe&gt; <span class="fn">mode</span> <span class="st">0</span></code></pre>
+    </section>
+    <!-- serve -->
 <section id="cli-serve">
 <h2><code>serve</code> <span class="tag b-cli">CLI Komutu</span></h2>
 <p>Démarre un serveur de développement local (localhost) pour tester le projet. Il lance votre projet en quelques secondes et l'ouvre automatiquement dans votre navigateur, sans avoir besoin d'installer un serveur web supplémentaire (XAMPP, Nginx, etc.).</p>
@@ -866,9 +878,11 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
 <tr><th>commande</th><th>Forfait Compositeur</th><th>Fichier de classe généré</th></tr>
 </thead>
 <tbody>
-<tr><td><code>add iyzico</code></td><td>iyzipay/iyzipay-php</td><td><span class="tag b-core">src/Service/Iyzico.php</span></td></tr>
+                    <tr><td><code>add phpmailer</code></td><td>phpmailer/phpmailer</td><td><span class="tag b-core">src/Service/Mailer.php</span></td></tr>
+                    <tr><td><code>add iyzico</code></td><td>iyzipay/iyzipay-php</td><td><span class="tag b-core">src/Service/Iyzico.php</span></td></tr>
 <tr><td><code>add stripe</code></td><td>bande/Stripe-php</td><td><span class="tag b-core">src/Service/Stripe.php</span></td></tr>
-<tr><td><code>add jwt</code></td><td>firebase/php-jwt</td><td><span class="tag b-core">src/Auth/JwtAuth.php</span></td></tr>
+                    <tr><td><code>add qrcode</code></td><td>endroid/qr-code</td><td><span class="tag b-core">src/Service/QrCode.php</span></td></tr>
+                    <tr><td><code>add jwt</code></td><td>firebase/php-jwt</td><td><span class="tag b-core">src/Auth/JwtAuth.php</span></td></tr>
 <tr><td><code>add image</code></td><td>intervention/image</td><td><span class="tag b-core">src/Service/ImageProcessor.php</span></td></tr>
 <tr><td><code>add s3</code></td><td>aws/aws-sdk-php</td><td><span class="tag b-core">src/Service/S3Storage.php</span></td></tr>
 <tr><td><code>add sentry</code></td><td>Sentry / Sentry</td><td><span class="tag b-core">config/sentry.php</span></td></tr>
@@ -890,7 +904,7 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
 <tr><td><code>add mpdf</code></td><td>mpdf/mpdf</td></tr>
 <tr><td><code>add dompdf</code></td><td>dompdf/dompdf</td></tr>
 <tr><td><code>add spreadsheet</code></td><td>phpoffice/phpspreadsheet</td></tr>
-<tr><td><code>add qrcode</code></td><td>endroid/qr-code</td></tr>
+
 <tr><td><code>add guzzle</code></td><td>avalerhttp/avaler</td></tr>
 <tr><td><code>add uuid</code></td><td>ramsey/uuid</td></tr>
 <tr><td><code>add carbon</code></td><td>nesbot/carbone</td></tr>
@@ -906,7 +920,86 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
 <section id="entegre-servisler">
 <h2>Services intégrés (Wrapper) <span class="tag b-core">Stubs</span></h2>
 <p>Au lieu d'utiliser directement les packages populaires, ArtiFrame <strong>Wrapper préconfiguré</strong> Il propose des cours pour votre usage.</p>
-<div class="card" id="svc-iyzico">
+                                <div class="card" id="svc-qrcode">
+            <h2>QR Code</h2>
+            <div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Classe d'encapsulation (Wrapper):</strong> En exécutant <code>add qrcode</code>, la classe <code>src/Service/QrCode.php</code> est créée.</div>
+            <p>Une classe fluide qui masque le processus d'instanciation complexe de la bibliothèque Endroid QR Code.</p>
+            
+            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Méthodes</h3>
+            <ul style="line-height: 1.6; margin-bottom: 20px;">
+                <li><code>->generate('Metin')</code> : Démarre la chaîne.</li>
+                <li><code>->size(300)</code> : Taille en pixels.</li>
+                <li><code>->margin(10)</code> : Marge blanche.</li>
+                <li><code>->color('#000000', '#ffffff')</code> : Couleurs au format HEX.</li>
+                <li><code>->logo('/path/logo.png', 50, true)</code> : Intègre un logo.</li>
+                <li><code>->format('png')</code> : png ou svg.</li>
+                <li><code>->save('/path/save.png')</code> : Enregistre le fichier.</li>
+                <li><code>->base64()</code> : Retourne en base64.</li>
+                <li><code>->output()</code> : Sortie directe vers le navigateur.</li>
+            </ul>
+
+            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Exemples</h3>
+            <pre><code><span class="kw">use</span> <span class="var">App\Service\QrCode</span>;
+
+<span class="cm">// Örnek 1: Ekrana HTML Img olarak basma</span>
+<span class="var">$base64</span> = <span class="var">QrCode</span>::generate(<span class="st">'https://artiframe.dev'</span>)
+    -&gt;<span class="fn">size</span>(400)
+    -&gt;<span class="fn">logo</span>(<span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/assets/logo.png'</span>)
+    -&gt;<span class="fn">base64</span>();
+
+<span class="kw">echo</span> <span class="st">'&lt;img src="'</span> . <span class="var">$base64</span> . <span class="st">'" alt="QR"&gt;'</span>;
+
+<span class="cm">// Örnek 2: Fiziksel PNG Olarak Kaydetme</span>
+<span class="var">QrCode</span>::generate(<span class="st">'VCARD Bilgileri'</span>)
+    -&gt;<span class="fn">color</span>(<span class="st">'#ff0000'</span>, <span class="st">'#ffffff'</span>)
+    -&gt;<span class="fn">save</span>(<span class="st">'/temp/kullanici_karti.png'</span>);
+
+<span class="cm">// Örnek 3: API Endpoint olarak resmi tarayıcıya basma</span>
+<span class="var">QrCode</span>::generate(<span class="st">'https://artilingo.com'</span>)-&gt;<span class="fn">output</span>();</code></pre>
+        </div>
+
+        <div class="card" id="svc-phpmailer">
+            <h2>PHPMailer (Mail)</h2>
+            <div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Configuration automatique de .env:</strong> Lorsque vous exécutez la commande <code>add phpmailer</code>, les paramètres SMTP sont automatiquement ajoutés à votre fichier <code>.env</code> et la classe <code>src/Service/Mailer.php</code> est créée.</div>
+            <p>Une classe d'encapsulation (Wrapper) beaucoup plus moderne, fluide et sécurisée fonctionnant avec la bibliothèque PHPMailer. Toutes les méthodes fournies sont chaînables.</p>
+            
+            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Méthodes et utilisation</h3>
+            <ul style="line-height: 1.6; margin-bottom: 20px;">
+                <li><code>->to('mail@adres.com', 'İsim')</code> : Définit à qui l'e-mail sera envoyé.</li>
+                <li><code>->cc('mail@adres.com')</code> : Ajoute des destinataires en copie (Carbon Copy).</li>
+                <li><code>->bcc('mail@adres.com')</code> : Ajoute des destinataires en copie cachée (BCC). Les destinataires principaux ne peuvent pas voir ces adresses.</li>
+                <li><code>->subject('Konu')</code> : Définit l'objet (le titre) de l'e-mail.</li>
+                <li><code>->attach('/path/fatura.pdf', 'Isim.pdf')</code> : Ajoute un fichier physique du serveur (ou temp) en tant que pièce jointe dans l'e-mail.</li>
+                <li><code>->embedImage('/path/logo.png', 'logo_cid')</code> : Intègre une image dans l'e-mail pour être utilisée en HTML (<code>&lt;img src="cid:logo_cid"&gt;</code>).</li>
+                <li><code>->html('HTML Kodu')</code> : Définit le contenu HTML. Crée automatiquement une version texte brut (AltBody) pour la sécurité.</li>
+                <li><code>->text('Düz Metin')</code> : Utilisé si vous souhaitez envoyer l'e-mail strictement en texte brut.</li>
+                <li><code>->send()</code> : Termine toutes les opérations chaînées et envoie l'e-mail via SMTP. Lance une Exception en cas d'erreur.</li>
+            </ul>
+
+            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Exemple avancé : Modèle PHP (View) et pièce jointe dynamique</h3>
+            <p>Si vous ne souhaitez pas écrire le contenu HTML de l'e-mail directement dans des chaînes, vous pouvez utiliser <code>ob_start()</code> pour inclure un fichier de modèle PHP externe (contenant des variables) et joindre un PDF :</p>
+            <pre><code><span class="kw">use</span> <span class="var">App\Service\Mailer</span>;
+
+<span class="cm">// 1. Vos données dynamiques</span>
+<span class="var">$siparisNo</span> = <span class="st">'#90210'</span>;
+<span class="var">$pdfDosyasi</span> = <span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/temp/fatura_90210.pdf'</span>;
+
+<span class="cm">// 2. Chargement du modèle HTML en externe (Output Buffering)</span>
+<span class="fn">ob_start</span>();
+<span class="kw">require_once</span> <span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/views/email/siparis.php'</span>;
+<span class="var">$htmlIcerik</span> = <span class="fn">ob_get_clean</span>();
+
+<span class="cm">// 3. Envoi de l'e-mail</span>
+<span class="var">Mailer</span>::create()
+    -&gt;<span class="fn">to</span>(<span class="st">'musteri@mail.com'</span>, <span class="st">'Ahmet Yılmaz'</span>)
+    -&gt;<span class="fn">bcc</span>(<span class="st">'arsiv@sirket.com'</span>) <span class="cm">// Le client ne peut pas voir cela</span>
+    -&gt;<span class="fn">subject</span>(<span class="st">'Siparişiniz Onaylandı: '</span> . <span class="var">$siparisNo</span>)
+    -&gt;<span class="fn">html</span>(<span class="var">$htmlIcerik</span>)
+    -&gt;<span class="fn">attach</span>(<span class="var">$pdfDosyasi</span>, <span class="st">'Siparis_Faturasi.pdf'</span>)
+    -&gt;<span class="fn">send</span>();</code></pre>
+        </div>
+
+        <div class="card" id="svc-iyzico">
 <h2>Iyzico <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></h2>
 <div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Adhésion et clés API :</strong> Pour utiliser l'infrastructure de paiement Iyzico <a href="https://www.iyzico.com" style="color: var(--green); font-weight: bold;" target="_blank">iyzico.com</a> (en direct) ou <a href="https://sandbox-merchants.iyzipay.com/" style="color: var(--green); font-weight: bold;" target="_blank">bac à sable.iyzipay.com</a> Vous devez créer un compte vendeur via (test) et obtenir vos clés API/Secret.</div>
 <div class="code-badge" style="margin-bottom: 15px; padding: 10px; background: rgba(0,0,0,0.2); border: 1px solid rgba(255,255,255,0.05); border-radius: 6px; font-family: monospace;">

package/core-stubs/docs/tr.html

@@ -283,9 +283,12 @@
         <a href="#cli-go">go</a>
         <a href="#cli-remove">remove</a>
         <a href="#cli-version">version</a>
+        <a href="#cli-mode">mode</a>
         <a href="#cli-serve">serve</a>
         <a href="#cli-add">add</a>
         <div class="sb-cat">Entegre Servisler</div>
+                        <a href="#svc-qrcode">QR Code</a>
+        <a href="#svc-phpmailer">PHPMailer (Mail)</a>
         <a href="#svc-iyzico">Iyzico <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></a>
         <a href="#svc-stripe">Stripe <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></a>
         <a href="#svc-jwt">JWT</a>
@@ -920,6 +923,15 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
     </section>
 
     
+        <!-- mode -->
+    <section id="cli-mode">
+        <h2><code>mode</code> <span class="tag b-cli">CLI Komutu</span></h2>
+        <p>Projenin çalışma modunu (Geliştirme veya Canlı) tek komutla değiştirmenizi sağlar. Bu komut, manuel olarak <code>config/app-version.php</code> dosyasını açıp düzenleme zahmetinden kurtarır.</p>
+        <pre><code>artiframe&gt; <span class="fn">mode</span> <span class="st">1</span>
+  ✅ Prod modundan Debug moduna geçiş yapıldı.</code></pre>
+        <p>Canlı sürüme geçmek için <code>0</code> parametresini kullanabilirsiniz:</p>
+        <pre><code>artiframe&gt; <span class="fn">mode</span> <span class="st">0</span></code></pre>
+    </section>
     <!-- serve -->
     <section id="cli-serve">
         <h2><code>serve</code> <span class="tag b-cli">CLI Komutu</span></h2>
@@ -947,8 +959,10 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
                     <tr><th>Komut</th><th>Composer Paketi</th><th>Üretilen Sınıf Dosyası</th></tr>
                 </thead>
                 <tbody>
+                                        <tr><td><code>add phpmailer</code></td><td>phpmailer/phpmailer</td><td><span class="tag b-core">src/Service/Mailer.php</span></td></tr>
                     <tr><td><code>add iyzico</code></td><td>iyzipay/iyzipay-php</td><td><span class="tag b-core">src/Service/Iyzico.php</span></td></tr>
                     <tr><td><code>add stripe</code></td><td>stripe/stripe-php</td><td><span class="tag b-core">src/Service/Stripe.php</span></td></tr>
+                                        <tr><td><code>add qrcode</code></td><td>endroid/qr-code</td><td><span class="tag b-core">src/Service/QrCode.php</span></td></tr>
                     <tr><td><code>add jwt</code></td><td>firebase/php-jwt</td><td><span class="tag b-core">src/Auth/JwtAuth.php</span></td></tr>
                     <tr><td><code>add image</code></td><td>intervention/image</td><td><span class="tag b-core">src/Service/ImageProcessor.php</span></td></tr>
                     <tr><td><code>add s3</code></td><td>aws/aws-sdk-php</td><td><span class="tag b-core">src/Service/S3Storage.php</span></td></tr>
@@ -969,11 +983,11 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
                     <tr><th>Komut</th><th>Composer Paketi</th></tr>
                 </thead>
                 <tbody>
-                    <tr><td><code>add phpmailer</code></td><td>phpmailer/phpmailer</td></tr>
+
                     <tr><td><code>add mpdf</code></td><td>mpdf/mpdf</td></tr>
                     <tr><td><code>add dompdf</code></td><td>dompdf/dompdf</td></tr>
                     <tr><td><code>add spreadsheet</code></td><td>phpoffice/phpspreadsheet</td></tr>
-                    <tr><td><code>add qrcode</code></td><td>endroid/qr-code</td></tr>
+                    
                     <tr><td><code>add guzzle</code></td><td>guzzlehttp/guzzle</td></tr>
                     <tr><td><code>add uuid</code></td><td>ramsey/uuid</td></tr>
                     <tr><td><code>add carbon</code></td><td>nesbot/carbon</td></tr>
@@ -996,6 +1010,85 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
         <p>ArtiFrame, popüler paketleri doğrudan kullanmak yerine <strong>önceden yapılandırılmış Sarmalayıcı (Wrapper)</strong> sınıflarla kullanımınıza sunar.</p>
 
 
+                                        <div class="card" id="svc-qrcode">
+            <h2>QR Code</h2>
+            <div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Sarmalayıcı Sınıf:</strong> <code>add qrcode</code> komutunu çalıştırdığınızda <code>endroid/qr-code</code> kütüphanesi yüklenir ve <code>src/Service/QrCode.php</code> sarmalayıcı sınıfı oluşturulur.</div>
+            <p>Endroid QR Code kütüphanesinin zorlu nesne üretim (Builder/Writer) süreçlerini gizleyen, tek satırda QR kod oluşturup içine logo gömebileceğiniz modern ve akıcı (fluent) bir sınıftır.</p>
+            
+            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Metodlar ve Kullanımları</h3>
+            <ul style="line-height: 1.6; margin-bottom: 20px;">
+                <li><code>->generate('Metin')</code> : QR koda dönüştürülecek metni veya URL'i belirleyip zinciri başlatır.</li>
+                <li><code>->size(300)</code> : QR kodun piksel cinsinden genişliğini/yüksekliğini belirler (örn: 300).</li>
+                <li><code>->margin(10)</code> : QR kodun etrafındaki beyaz boşluğu belirler.</li>
+                <li><code>->color('#000000', '#ffffff')</code> : Ön plan (çizgiler) ve Arka plan renklerini HEX kodu olarak belirler. (örn: <code>#000000, #ffffff</code>).</li>
+                <li><code>->logo('/path/logo.png', 50, true)</code> : QR kodun tam ortasına bir resim (logo) gömer. Logoya giden fiziksel yolu, boyutunu ve arka planının delinip delinmeyeceğini (punchout) alır.</li>
+                <li><code>->format('png')</code> : Çıktı formatını belirler. <code>png</code> veya <code>svg</code> desteklenir. Varsayılan: png.</li>
+                <li><code>->save('/path/save.png')</code> : Oluşturulan QR kodu sunucuda fiziksel bir dosyaya kaydeder.</li>
+                <li><code>->base64()</code> : QR kodu HTML <code>&lt;img src="..."&gt;</code> etiketi içinde doğrudan kullanabilmeniz için base64 string olarak döndürür.</li>
+                <li><code>->output()</code> : QR kodu uygun HTTP başlıklarıyla (header) doğrudan tarayıcıya basar.</li>
+            </ul>
+
+            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Kullanım Örnekleri</h3>
+            <pre><code><span class="kw">use</span> <span class="var">App\Service\QrCode</span>;
+
+<span class="cm">// Örnek 1: Ekrana HTML Img olarak basma</span>
+<span class="var">$base64</span> = <span class="var">QrCode</span>::generate(<span class="st">'https://artiframe.dev'</span>)
+    -&gt;<span class="fn">size</span>(400)
+    -&gt;<span class="fn">logo</span>(<span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/assets/logo.png'</span>)
+    -&gt;<span class="fn">base64</span>();
+
+<span class="kw">echo</span> <span class="st">'&lt;img src="'</span> . <span class="var">$base64</span> . <span class="st">'" alt="QR"&gt;'</span>;
+
+<span class="cm">// Örnek 2: Fiziksel PNG Olarak Kaydetme</span>
+<span class="var">QrCode</span>::generate(<span class="st">'VCARD Bilgileri'</span>)
+    -&gt;<span class="fn">color</span>(<span class="st">'#ff0000'</span>, <span class="st">'#ffffff'</span>)
+    -&gt;<span class="fn">save</span>(<span class="st">'/temp/kullanici_karti.png'</span>);
+
+<span class="cm">// Örnek 3: API Endpoint olarak resmi tarayıcıya basma</span>
+<span class="var">QrCode</span>::generate(<span class="st">'https://artilingo.com'</span>)-&gt;<span class="fn">output</span>();</code></pre>
+        </div>
+
+        <div class="card" id="svc-phpmailer">
+            <h2>PHPMailer (Mail)</h2>
+            <div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Otomatik .env Kurulumu:</strong> <code>add phpmailer</code> komutunu çalıştırdığınızda SMTP ayarları <code>.env</code> dosyanıza otomatik eklenir ve <code>src/Service/Mailer.php</code> sınıfı oluşturulur.</div>
+            <p>PHPMailer kütüphanesi üzerinde çalışan, çok daha modern, akıcı (fluent) ve güvenli (CRLF korumalı) bir Sarmalayıcı (Wrapper) sınıfıdır. Sınıfın sunduğu tüm metodlar zincirlenebilir (chainable) yapıdadır.</p>
+            
+            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Metodlar ve Kullanımları</h3>
+            <ul style="line-height: 1.6; margin-bottom: 20px;">
+                <li><code>->to('mail@adres.com', 'İsim')</code> : E-postanın kime gönderileceğini belirler.</li>
+                <li><code>->cc('mail@adres.com')</code> : Bilgi (Carbon Copy) alıcılarını ekler.</li>
+                <li><code>->bcc('mail@adres.com')</code> : Gizli (Blind Carbon Copy) alıcılarını ekler. Birincil alıcılar bu adresleri göremez.</li>
+                <li><code>->subject('Konu')</code> : E-postanın başlığını (konusunu) belirler.</li>
+                <li><code>->attach('/path/fatura.pdf', 'Isim.pdf')</code> : Sunucudaki (veya temp) fiziksel bir dosyayı mailin içine ek (attachment) olarak koyar.</li>
+                <li><code>->embedImage('/path/logo.png', 'logo_cid')</code> : E-posta içine HTML'de kullanılmak üzere (<code>&lt;img src="cid:logo_cid"&gt;</code>) resim gömer.</li>
+                <li><code>->html('HTML Kodu')</code> : E-postanın HTML içeriğini ayarlar. Güvenlik için düz metin (AltBody) versiyonunu otomatik oluşturur.</li>
+                <li><code>->text('Düz Metin')</code> : E-postayı sadece düz metin (Plain Text) olarak göndermek isterseniz kullanılır.</li>
+                <li><code>->send()</code> : Zincirdeki tüm işlemleri tamamlayıp SMTP üzerinden maili yollar. Hata varsa Exception fırlatır.</li>
+            </ul>
+
+            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Gelişmiş Örnek: PHP Şablonu (View) ve Dinamik Dosya Gönderme</h3>
+            <p>Eğer mailin HTML içeriğini spagetti kod gibi string içine yazmak istemiyorsanız, <code>ob_start()</code> kullanarak harici bir PHP şablon dosyasını (içinde değişkenler olan) içeri aktarabilir ve sistemde üretilen bir PDF'i direkt maile gömebilirsiniz:</p>
+            <pre><code><span class="kw">use</span> <span class="var">App\Service\Mailer</span>;
+
+<span class="cm">// 1. Dinamik verileriniz</span>
+<span class="var">$siparisNo</span> = <span class="st">'#90210'</span>;
+<span class="var">$pdfDosyasi</span> = <span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/temp/fatura_90210.pdf'</span>;
+
+<span class="cm">// 2. HTML Şablonunu dışarıdan yükleme (Output Buffering)</span>
+<span class="fn">ob_start</span>();
+<span class="kw">require_once</span> <span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/views/email/siparis.php'</span>;
+<span class="var">$htmlIcerik</span> = <span class="fn">ob_get_clean</span>();
+
+<span class="cm">// 3. Maili Gönderme</span>
+<span class="var">Mailer</span>::create()
+    -&gt;<span class="fn">to</span>(<span class="st">'musteri@mail.com'</span>, <span class="st">'Ahmet Yılmaz'</span>)
+    -&gt;<span class="fn">bcc</span>(<span class="st">'arsiv@sirket.com'</span>) <span class="cm">// Müşteri bunu göremez</span>
+    -&gt;<span class="fn">subject</span>(<span class="st">'Siparişiniz Onaylandı: '</span> . <span class="var">$siparisNo</span>)
+    -&gt;<span class="fn">html</span>(<span class="var">$htmlIcerik</span>)
+    -&gt;<span class="fn">attach</span>(<span class="var">$pdfDosyasi</span>, <span class="st">'Siparis_Faturasi.pdf'</span>)
+    -&gt;<span class="fn">send</span>();</code></pre>
+        </div>
+
         <div class="card" id="svc-iyzico">
             <h2>Iyzico <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></h2>
         <div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Üyelik & API Anahtarları:</strong> Iyzico ödeme altyapısını kullanmak için <a href="https://www.iyzico.com" target="_blank" style="color: var(--green); font-weight: bold;">iyzico.com</a> (canlı) veya <a href="https://sandbox-merchants.iyzipay.com/" target="_blank" style="color: var(--green); font-weight: bold;">sandbox.iyzipay.com</a> (test) üzerinden satıcı hesabı oluşturup API/Secret anahtarlarınızı almanız gerekmektedir.</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artilingo/artiframe-cli",
-  "version": "1.1.2",
+  "version": "1.2.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": {
@@ -15,6 +15,7 @@
     "bin/artiframe.php",
     "src/",
     "core-stubs/",
+    "stubs/",
     "assets/",
     "scripts/",
     "LICENSE"

package/src/App.php

@@ -206,6 +206,10 @@ class App
                 break;
 
 
+            case 'mode':
+                (new \ArtiFrame\Cli\Commands\ModeCommand($this->translator))->execute($commandArgs);
+                break;
+
             case 'remove':
                 (new \ArtiFrame\Cli\Commands\RemoveCommand($this->translator))->execute($commandArgs);
                 break;
@@ -341,6 +345,13 @@ class App
         echo "  " . $d . "└── " . $r . "Example: " . $lg . "remove src/Auth/UserManager.php" . $r . PHP_EOL;
         echo PHP_EOL;
 
+        // mode
+        echo "  " . $g . "mode" . $r . " " . $y . "<0|1>" . $r . PHP_EOL;
+        echo "  " . $d . "│" . $r . "   " . $t->get('HELP_MODE_DESC') . PHP_EOL;
+        echo "  " . $d . "├── " . $r . "Example: " . $lg . "mode 1" . $r . $d . "      (Debug)" . $r . PHP_EOL;
+        echo "  " . $d . "└── " . $r . "Example: " . $lg . "mode 0" . $r . $d . "      (Prod)" . $r . PHP_EOL;
+        echo PHP_EOL;
+
         // serve
         echo "  " . $g . "serve" . $r . " " . $y . "[port]" . $r . PHP_EOL;
         echo "  " . $d . "│" . $r . "   " . $t->get('HELP_SERVE_DESC') . PHP_EOL;

package/src/Commands/AddCommand.php

@@ -19,7 +19,7 @@ class AddCommand
     private array $registry = [
         // ── Entegrasyonlu Paketler (Composer + Servis Sınıfı + .env) ───
         'iyzico' => [
-            'composer' => 'iyzipay/iyzipay-php',
+            'composer' => 'iyzico/iyzipay-php',
             'type'     => 'integrated',
             'service'  => 'src/Service/Iyzico.php',
             'stub'     => 'iyzico.stub',
@@ -131,7 +131,19 @@ class AddCommand
         // ── Direkt Kullanılabilir Paketler (Sadece Composer) ───────────
         'phpmailer' => [
             'composer' => 'phpmailer/phpmailer',
-            'type'     => 'direct',
+            'type'     => 'integrated',
+            'service'  => 'src/Service/Mailer.php',
+            'stub'     => 'phpmailer.stub',
+            'env'      => [
+                '# ── mail (phpmailer) ──────────────────────',
+                'MAIL_HOST=smtp.mailtrap.io',
+                'MAIL_PORT=2525',
+                'MAIL_USERNAME=',
+                'MAIL_PASSWORD=',
+                'MAIL_ENCRYPTION=tls',
+                'MAIL_FROM_ADDRESS=hello@example.com',
+                'MAIL_FROM_NAME=ArtiFrame',
+            ],
         ],
         'mpdf' => [
             'composer' => 'mpdf/mpdf',
@@ -147,7 +159,9 @@ class AddCommand
         ],
         'qrcode' => [
             'composer' => 'endroid/qr-code',
-            'type'     => 'direct',
+            'type'     => 'integrated',
+            'service'  => 'src/Service/QrCode.php',
+            'stub'     => 'qrcode.stub',
         ],
         'guzzle' => [
             'composer' => 'guzzlehttp/guzzle',
@@ -269,7 +283,7 @@ class AddCommand
      */
     private function copyServiceStub(string $projectRoot, array $package, string $alias): void
     {
-        $stubPath = \ARTIFRAME_CLI_ROOT . '/core-stubs/stubs/service/' . $package['stub'];
+        $stubPath = \ARTIFRAME_CLI_ROOT . '/stubs/service/' . $package['stub'];
         $targetPath = $projectRoot . '/' . $package['service'];
 
         if (!file_exists($stubPath)) {

package/src/Commands/MakeApiCommand.php

@@ -46,7 +46,7 @@ class MakeApiCommand
         }
 
         $stubName = 'api-' . $type . '.stub';
-        $stubPath = $projectRoot . '/bin/stubs/' . $stubName;
+        $stubPath = \ARTIFRAME_CLI_ROOT . '/stubs/make/' . $stubName;
 
         if (!file_exists($stubPath)) {
             echo "❌ " . $this->translator->get('ERROR_STUB_NOT_FOUND', ['path' => $stubPath]) . PHP_EOL;

package/src/Commands/MakeClassCommand.php

@@ -42,7 +42,7 @@ class MakeClassCommand
             return;
         }
 
-        $stubPath = $projectRoot . '/bin/stubs/class.stub';
+        $stubPath = \ARTIFRAME_CLI_ROOT . '/stubs/make/class.stub';
         if (!file_exists($stubPath)) {
             echo "❌ " . $this->translator->get('ERROR_STUB_NOT_FOUND', ['path' => $stubPath]) . PHP_EOL;
             return;

package/src/Commands/MakeViewCommand.php

@@ -53,7 +53,7 @@ class MakeViewCommand
         $jsPath  = $projectRoot . '/public' . $jsRelative;
 
         // Stub path
-        $stubPath = $projectRoot . '/bin/stubs/view.stub';
+        $stubPath = \ARTIFRAME_CLI_ROOT . '/stubs/make/view.stub';
         if (!file_exists($stubPath)) {
             echo "❌ " . $this->translator->get('ERROR_STUB_NOT_FOUND', ['path' => $stubPath]) . PHP_EOL;
             echo $this->translator->get('ERROR_RUN_FROM_ROOT') . PHP_EOL;

package/src/Commands/ModeCommand.php

@@ -0,0 +1,71 @@
+<?php
+namespace ArtiFrame\Cli\Commands;
+
+use ArtiFrame\Cli\Services\Translator;
+
+class ModeCommand
+{
+    private Translator $translator;
+
+    public function __construct(Translator $translator)
+    {
+        $this->translator = $translator;
+    }
+
+    public function execute(array $args): void
+    {
+        $mode = $args[0] ?? null;
+
+        if ($mode !== '0' && $mode !== '1') {
+            echo "❌ " . $this->translator->get('MODE_INVALID') . PHP_EOL;
+            return;
+        }
+
+        $projectRoot = getcwd();
+        $configFile  = $projectRoot . '/config/app-version.php';
+
+        if (!file_exists($configFile)) {
+            echo "❌ " . $this->translator->get('MODE_NOT_PROJECT') . PHP_EOL;
+            return;
+        }
+
+        $content = file_get_contents($configFile);
+        
+        // Find current mode
+        $currentMode = null;
+        if (preg_match('/define\(\s*\'APP_ENV\'\s*,\s*(0|1)\s*\);/', $content, $matches)) {
+            $currentMode = $matches[1];
+        }
+
+        $modeNames = [
+            '0' => 'Prod',
+            '1' => 'Debug'
+        ];
+
+        if ($currentMode === $mode) {
+            if ($mode === '1') {
+                echo "ℹ️  " . $this->translator->get('MODE_ALREADY_DEBUG') . PHP_EOL;
+            } else {
+                echo "ℹ️  " . $this->translator->get('MODE_ALREADY_PROD') . PHP_EOL;
+            }
+            return;
+        }
+
+        // Replace the mode
+        if ($currentMode !== null) {
+            $newContent = preg_replace(
+                '/define\(\s*\'APP_ENV\'\s*,\s*(0|1)\s*\);/', 
+                "define('APP_ENV', {$mode});", 
+                $content
+            );
+            file_put_contents($configFile, $newContent);
+
+            $oldName = $modeNames[$currentMode] ?? 'Bilinmeyen';
+            $newName = $modeNames[$mode] ?? 'Bilinmeyen';
+
+            echo "✅ " . $this->translator->get('MODE_CHANGED', ['old' => $oldName, 'new' => $newName]) . PHP_EOL;
+        } else {
+            echo "❌ config/app-version.php içinde APP_ENV tanımı bulunamadı." . PHP_EOL;
+        }
+    }
+}

package/src/Lang/de.php

@@ -159,4 +159,11 @@ return [
     'HELP_SERVE_DESC'   => 'Startet den lokalen Entwicklungsserver.',
 
     'INVALID_PACKAGE_NAME' => 'Ungültiger Paketname. Das Format sollte wie folgt aussehen: vendor/project',
+
+    'MODE_ALREADY_DEBUG'       => 'Debug-Modus ist bereits aktiv.',
+    'MODE_ALREADY_PROD'        => 'Prod-Modus ist bereits aktiv.',
+    'MODE_CHANGED'             => 'Vom :old- in den :new-Modus gewechselt.',
+    '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)',
 ];

package/src/Lang/en.php

@@ -159,4 +159,11 @@ return [
     'HELP_SERVE_DESC'   => 'Starts the local development server.',
 
     'INVALID_PACKAGE_NAME' => 'Invalid package name. Format should look like: vendor/project',
+
+    'MODE_ALREADY_DEBUG'       => 'Debug mode is already active.',
+    'MODE_ALREADY_PROD'        => 'Prod mode is already active.',
+    'MODE_CHANGED'             => 'Switched from :old to :new mode.',
+    '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)',
 ];

package/src/Lang/es.php

@@ -159,4 +159,11 @@ return [
     'HELP_SERVE_DESC'   => 'Inicia el servidor de desarrollo local.',
 
     'INVALID_PACKAGE_NAME' => 'Nombre de paquete no válido. El formato debería ser: vendor/project',
+
+    'MODE_ALREADY_DEBUG'       => 'El modo de depuración ya está activo.',
+    'MODE_ALREADY_PROD'        => 'El modo de producción ya está activo.',
+    'MODE_CHANGED'             => 'Cambiado del modo :old al modo :new.',
+    '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)',
 ];

package/src/Lang/fr.php

@@ -159,4 +159,11 @@ return [
     'HELP_SERVE_DESC'   => 'Démarre le serveur de développement local.',
 
     'INVALID_PACKAGE_NAME' => 'Nom de package invalide. Le format doit ressembler à : vendor/project',
+
+    'MODE_ALREADY_DEBUG'       => 'Le mode de débogage est déjà actif.',
+    'MODE_ALREADY_PROD'        => 'Le mode de production est déjà actif.',
+    'MODE_CHANGED'             => 'Passé du mode :old au mode :new.',
+    '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)',
 ];

package/src/Lang/tr.php

@@ -159,4 +159,11 @@ return [
     'HELP_SERVE_DESC'   => 'Lokal geliştirme sunucusunu başlatır.',
 
     'INVALID_PACKAGE_NAME' => 'Geçersiz paket adı. Format şuna benzemeli: vendor/project',
+
+    'MODE_ALREADY_DEBUG'       => 'Zaten debug mode aktif.',
+    'MODE_ALREADY_PROD'        => 'Zaten prod mod aktif.',
+    'MODE_CHANGED'             => ':old modundan :new moduna geçiş yapıldı.',
+    '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)',
 ];

package/stubs/make/api-standart.stub

@@ -0,0 +1,20 @@
+<?php
+/**
+ * ArtiFrame Core Engine
+ *
+ * @package     ArtiFrame
+ * @author      Artilingo
+ * @license     AGPLv3 (Attribution-ShareAlike Required)
+ */
+
+// İzin verilen HTTP metodları (Örn: GET, POST, PUT, DELETE)
+$allowedMethods = ['POST'];
+
+require_once $_SERVER['DOCUMENT_ROOT'] . '/../app/ApiControl.php';
+
+use Bin\SystemMethod;
+
+// API İş Mantığı (Business Logic) Başlangıcı
+// ...
+
+jsonResponse(['status' => 'success', 'message' => 'İşlem başarılı.'], 200);