npm - @artilingo/artiframe-cli - Versions diffs - 1.3.0 → 2.0.0 - Mend

@artilingo/artiframe-cli 1.3.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (41) hide show

package/core-stubs/bin/SystemMethod.php +600 -521
package/core-stubs/bin/ViewMethod.php +591 -393
package/core-stubs/docs/de.html +853 -1172
package/core-stubs/docs/en.html +585 -904
package/core-stubs/docs/es.html +934 -1253
package/core-stubs/docs/fr.html +913 -1232
package/core-stubs/docs/tr.html +4212 -5021
package/package.json +1 -1
package/src/App.php +38 -0
package/src/Commands/AddCommand.php +1 -1
package/src/Commands/AuthCommand.php +219 -0
package/src/Commands/IssuesCommand.php +174 -0
package/src/Commands/ListCommand.php +2 -1
package/src/Commands/MakeApiCommand.php +1 -1
package/src/Commands/MakeClassCommand.php +1 -1
package/src/Commands/MakeViewCommand.php +1 -1
package/src/Commands/NewProjectCommand.php +37 -25
package/src/Commands/RemoveCommand.php +21 -10
package/src/Commands/ServeCommand.php +29 -9
package/src/Commands/SuggestCommand.php +143 -0
package/src/Commands/TableCommand.php +2 -1
package/src/Commands/UpgradeCommand.php +209 -0
package/src/Commands/VersionCommand.php +2 -1
package/src/Lang/de.php +9 -1
package/src/Lang/en.php +8 -0
package/src/Lang/es.php +9 -1
package/src/Lang/fr.php +8 -0
package/src/Lang/tr.php +10 -2
package/src/Services/Safeguard.php +25 -0
package/stubs/service/image.stub +334 -334
package/stubs/service/iyzico.stub +637 -637
package/stubs/service/jwt.stub +312 -312
package/stubs/service/phpmailer.stub +143 -143
package/stubs/service/pusher.stub +232 -232
package/stubs/service/qrcode.stub +169 -169
package/stubs/service/redis.stub +361 -361
package/stubs/service/s3.stub +377 -377
package/stubs/service/sentry.stub +76 -106
package/stubs/service/stripe.stub +526 -526
package/stubs/service/twilio.stub +361 -361
package/core-stubs/app/R2Manager.php +0 -130

package/core-stubs/docs/es.html CHANGED Viewed

@@ -1,18 +1,23 @@
-<!DOCTYPE html>
-<!DOCTYPE html>
+HTML
 <html lang="es">
 <head>
 <meta charset="utf-8"/>
 <meta content="width=device-width, initial-scale=1.0" name="viewport"/>
-<title>Marco artístico | Documentación oficial del desarrollador</title>
-<link rel="icon" type="image/png" href="../../public/assets/images/favicon-96x96.png" sizes="96x96" />
-<link rel="icon" type="image/svg+xml" href="../../public/assets/images/favicon.svg" />
-<link rel="shortcut icon" href="../../public/assets/images/favicon.ico" />
-<link rel="apple-touch-icon" sizes="180x180" href="../../public/assets/images/apple-touch-icon.png" />
-<link rel="manifest" href="../../public/assets/images/site.webmanifest" />
+<title>Documentación oficial para desarrolladores: marco PHP ArtiFrame</title>
+<meta content="ArtiFrame framework kullanım rehberi ve API referansları. En hızlı ve güvenli PHP framework'ünü öğrenin." name="description"/>
+<meta content="artiframe, artiframe framework, php framework, fast php framework, secure php framework, artilingo framework, php, framework, mvc" name="keywords"/>
+<meta content="Artilingo" name="author"/>
+Abrir gráfico / Redes sociales
+<meta content="Resmi Geliştirici Dokümantasyonu — ArtiFrame PHP Framework" property="og:title"/>
+<meta content="ArtiFrame framework kullanım rehberi ve API referansları. En hızlı ve güvenli PHP framework'ünü öğrenin." property="og:description"/>
+<meta content="website" property="og:type"/>
+<meta content="https://artiframe.artilingo.com/docs/tr.html" property="og:url"/>
+<meta content="ArtiFrame" property="og:site_name"/>
+<link href="../../public/assets/images/favicon-96x96.png" rel="icon" sizes="96x96" type="image/png"/>
+<link href="../../public/assets/images/favicon.svg" rel="icon" type="image/svg+xml"/>
+<link href="../../public/assets/images/favicon.ico" rel="shortcut icon"/>
+<link href="../../public/assets/images/apple-touch-icon.png" rel="apple-touch-icon" sizes="180x180"/>
+<link href="../../public/assets/images/site.webmanifest" rel="manifest"/>
 <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&amp;family=JetBrains+Mono:wght@400;500&amp;display=swap" rel="stylesheet"/>
 <style>
         :root {
@@ -33,9 +38,7 @@
             --sidebar-w:   280px;
         }
         *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
         html { scroll-behavior: smooth; }
         body {
             font-family: 'Inter', sans-serif;
             background: var(--bg);
@@ -43,7 +46,6 @@
             line-height: 1.75;
             display: flex;
         }
         /* ---- SIDEBAR ---- */
         .sidebar {
             width: var(--sidebar-w);
@@ -57,7 +59,6 @@
             display: flex;
             flex-direction: column;
         }
         .sb-logo {
             padding: 0 22px 24px;
             border-bottom: 1px solid var(--border);
@@ -75,7 +76,6 @@
             color: var(--muted);
             margin-top: 3px;
         }
                 .sb-subcat {
             padding: 12px 22px 4px;
             font-size: 0.62rem;
@@ -107,7 +107,6 @@
             background: var(--green-dim);
             border-left-color: var(--green);
         }
         /* ---- MAIN ---- */
         .content {
             margin-left: var(--sidebar-w);
@@ -115,7 +114,6 @@
             max-width: 1100px;
             width: 100%;
         }
         /* ---- TYPOGRAPHY ---- */
         h1 { font-size: 2.6rem; font-weight: 700; letter-spacing: -0.5px; margin-bottom: 16px; }
         h1 span { color: var(--green); }
@@ -133,10 +131,8 @@
         li { margin-bottom: 8px; }
         a { color: var(--green-light); text-decoration: none; }
         a:hover { text-decoration: underline; }
         /* ---- LEAD ---- */
         .lead { font-size: 1.05rem; color: var(--muted); margin-bottom: 0; max-width: 720px; }
         /* ---- BADGES ---- */
         .badge { font-size: 0.68rem; padding: 3px 8px; border-radius: 4px; font-weight: 700; text-transform: uppercase; letter-spacing: .5px; white-space: nowrap; }
         .b-view   { background: rgba(88,166,255,.12); color: #58a6ff; border: 1px solid rgba(88,166,255,.3); }
@@ -144,7 +140,6 @@
         .b-cli    { background: rgba(0,200,140,.12);   color: #00c88c; border: 1px solid rgba(0,200,140,.3); }
         .b-core   { background: rgba(227,179,65,.12);  color: #e3b341; border: 1px solid rgba(227,179,65,.3); }
         .b-sec    { background: rgba(248,81,73,.12);   color: #f85149; border: 1px solid rgba(248,81,73,.3); }
         /* ---- CODE ---- */
         pre {
             background: var(--code-bg);
@@ -172,7 +167,6 @@
         .cm { color: #8b949e; }   /* comment */
         .nu { color: #79c0ff; }   /* number / bool */
         .var { color: #ffa657; }  /* variable */
         /* ---- CARDS ---- */
         .card {
             background: var(--surface);
@@ -182,21 +176,17 @@
             margin-bottom: 20px;
         }
         .card.highlight { border-left: 3px solid var(--green); }
         /* ---- ALERTS ---- */
         .alert { padding: 18px 22px; border-radius: 8px; margin: 24px 0; border-left: 3px solid; font-size: 0.95rem; }
         .a-info    { background: rgba(88,166,255,.08);  border-color: var(--blue);   color: #93c5fd; }
         .a-warn    { background: rgba(227,179,65,.08);  border-color: var(--yellow); color: #fbbf24; }
         .a-danger  { background: rgba(248,81,73,.08);   border-color: var(--red);    color: #fca5a5; }
         .a-success { background: rgba(0,157,108,.08);   border-color: var(--green);  color: #6ee7b7; }
         /* ---- RETURN TYPE ---- */
         .ret { display: inline-block; font-size: 0.78rem; color: var(--green); font-family: 'JetBrains Mono', monospace; background: rgba(0,157,108,.12); padding: 3px 10px; border-radius: 4px; border: 1px solid rgba(0,157,108,.25); margin-bottom: 12px; }
         /* ---- GRID ---- */
         .grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 18px; margin-bottom: 24px; }
         @media(max-width: 900px) { .grid-2 { grid-template-columns: 1fr; } }
         /* ---- DIR TREE ---- */
         .tree { background: var(--code-bg); border: 1px solid var(--border); border-radius: 8px; padding: 22px 24px; font-family: 'JetBrains Mono', monospace; font-size: 0.875rem; line-height: 1.9; white-space: pre; overflow-x: auto; }
         .tree .dir { color: var(--blue); font-weight: 600; }
@@ -204,7 +194,6 @@
         .tree .note { color: #8b949e; }
         .tree .warn { color: var(--yellow); }
         .tree .safe { color: var(--green); }
         /* ---- STEP LIST ---- */
         .steps { counter-reset: step; list-style: none; margin: 0 0 24px; padding: 0; }
         .steps li { counter-increment: step; display: flex; gap: 18px; margin-bottom: 20px; }
@@ -220,17 +209,14 @@
             font-weight: 700; font-size: 0.85rem;
             margin-top: 2px;
         }
         /* ---- SIGNATURE TABLE ---- */
         .sig-table { width: 100%; border-collapse: collapse; margin: 16px 0 24px; font-size: 0.87rem; }
         .sig-table th { text-align: left; padding: 10px 14px; background: var(--surface-2); color: var(--muted); font-weight: 600; border-bottom: 1px solid var(--border); }
         .sig-table td { padding: 10px 14px; border-bottom: 1px solid rgba(48,54,61,.5); vertical-align: top; }
         .sig-table td:first-child { font-family: 'JetBrains Mono', monospace; color: var(--yellow); white-space: nowrap; }
         .sig-table td:last-child { color: var(--muted); }
         /* ---- SCROLL SPY ---- */
         header#page-header { margin-bottom: 52px; }
         .table-wrapper {
             width: 100%;
             overflow-x: auto;
@@ -241,7 +227,6 @@
             margin-bottom: 0; /* Override default table margin if any */
             white-space: nowrap; /* Keep table cells on one line for better scroll */
         }
         @media(max-width: 900px) {
             body { flex-direction: column; }
             .sidebar { position: relative; width: 100%; height: auto; border-right: none; border-bottom: 1px solid var(--border); padding: 20px; z-index: 10; }
@@ -255,7 +240,7 @@
     </style>
 </head>
 <body>
-<!-- SIDEBAR -->
+BARRA LATERAL
 <aside class="sidebar">
 <div class="sb-logo">
 <strong>ArtiFrame</strong>
@@ -268,86 +253,90 @@
 <a href="#kurulum">Configuración</a>
 <a href="#dizin">Estructura del directorio</a>
 <div class="sb-cat">Arquitectónico</div>
+<a href="#v2-routing">Enrutamiento sin configuración (v2.0)</a>
 <a href="#bootstrapper">Arquitectura previa</a>
 <a href="#kurallar">Conjunto de reglas</a>
 <div class="sb-cat">Herramienta CLI</div>
-<a href="#cli-giris">CLI'ye Giriş</a>
-<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-table">table:</a>
-<a href="#cli-cliv">cli v</a>
-<a href="#cli-show">show</a>
-<a href="#cli-list">list</a>
-<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>
+<a href="#cli-giris">Introducción a la CLI</a>
+<a href="#cli-new">nuevo</a>
+<a href="#cli-upgrade">mejora</a>
+<a href="#cli-view">hacer:ver</a>
+<a href="#cli-api">hacer:api</a>
+<a href="#cli-class">hacer: clase</a>
+<a href="#cli-table">mesa:</a>
+<a href="#cli-cliv">cliv</a>
+<a href="#cli-show">espectáculo</a>
+<a href="#cli-list">lista</a>
+<a href="#cli-go">ir</a>
+<a href="#cli-remove">eliminar</a>
+<a href="#cli-version">versión</a>
+<a href="#cli-mode">modo</a>
+<a href="#cli-serve">atender</a>
+<a href="#cli-auth">autenticación</a>
+<a href="#cli-suggest">sugerir</a>
+<a href="#cli-add">agregar</a>
 <div class="sb-cat">Servicios Integrados</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>
-<a href="#svc-image">Image Processing</a>
-<a href="#svc-s3">AWS S3 <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">Código QR</a>
+<a href="#svc-phpmailer">PHPMailer (correo)</a>
+<a href="#svc-iyzico">Iyzico<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></a>
+<a href="#svc-stripe">Raya<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></a>
+<a href="#svc-jwt">J.W.T.</a>
+<a href="#svc-image">Procesamiento de imágenes</a>
+<a href="#svc-s3">AWS S3<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></a>
 <a href="#svc-redis">Redis</a>
-<a href="#svc-pusher">Pusher <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></a>
-<a href="#svc-twilio">Twilio <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></a>
-<a href="#svc-sentry">Sentry <span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Ücretli/Lisanslı Servis">$</span></a>
+<a href="#svc-pusher">arribista<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></a>
+<a href="#svc-twilio">Gorjeo<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></a>
+<a href="#svc-sentry">centinela<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></a>
 <div class="sb-cat">Ver ayudantes</div>
-<a href="#vh-display">display()</a>
-<a href="#vh-escapeurl">escapeUrl()</a>
-<a href="#vh-csrf">csrfField()</a>
-<a href="#vh-dates">Tarih Fonksiyonları</a>
-<a href="#vh-truncate">truncate()</a>
-<a href="#vh-activeclass">activeClass()</a>
-<a href="#vh-formatsize">formatSize()</a>
-<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-uuid">uuid()</a>
+<a href="#vh-display">mostrar()</a>
+<a href="#vh-escapeurl">URL de escape()</a>
+<a href="#vh-csrf">campocsrf()</a>
+<a href="#vh-dates">Funciones de fecha</a>
+<a href="#vh-truncate">truncar()</a>
+<a href="#vh-activeclass">clase activa()</a>
+<a href="#vh-formatsize">formatoTamaño()</a>
+<a href="#vh-maskemail">máscaraCorreo electrónico()</a>
+<a href="#vh-maskphone">máscaraTeléfono()</a>
+<a href="#vh-slugify">slugificar()</a>
+<a href="#vh-money">dinero()</a>
+<a href="#vh-uuid">UUID()</a>
 <div class="sb-cat">Ayudantes del sistema</div>
 <div class="sb-subcat">Respuesta y depuración</div>
-<a href="#sh-apiresponse">apiResponse()</a>
-<a href="#sh-json">jsonResponse()</a>
-<a href="#sh-redirect">redirect()</a>
+<a href="#sh-apiresponse">apiRespuesta()</a>
+<a href="#sh-json">jsonRespuesta()</a>
+<a href="#sh-redirect">redirigir()</a>
 <a href="#sh-dd">dd()</a>
 <div class="sb-subcat">Seguridad CSRF</div>
-<a href="#sh-generatecsrf">generateCsrf()</a>
-<a href="#sh-csrf">verifyCsrf()</a>
+<a href="#sh-generatecsrf">generarCsrf()</a>
+<a href="#sh-csrf">verificarCsrf()</a>
 <div class="sb-subcat">Desinfectar y validar</div>
-<a href="#sh-sanitizeint">sanitizeInt()</a>
-<a href="#sh-sanitizefloat">sanitizeFloat()</a>
-<a href="#sh-sanitizestring">sanitizeString()</a>
-<a href="#sh-sanitizeemail">sanitizeEmail()</a>
-<a href="#sh-verifyemail">verifyEmail()</a>
+<a href="#sh-sanitizeint">sanitizarInt()</a>
+<a href="#sh-sanitizefloat">desinfectarFloat()</a>
+<a href="#sh-sanitizestring">desinfectarString()</a>
+<a href="#sh-sanitizeemail">desinfectarcorreo electrónico()</a>
+<a href="#sh-verifyemail">verificarcorreo electrónico()</a>
 <div class="sb-subcat">Solicitud HTTP</div>
-<a href="#sh-ispost">isPost()</a>
-<a href="#sh-isget">isGet()</a>
-<a href="#sh-isput">isPut()</a>
-<a href="#sh-isdelete">isDelete()</a>
-<a href="#sh-isajax">isAjax()</a>
-<a href="#sh-getclientip">getClientIp()</a>
+<a href="#sh-ispost">espublicar()</a>
+<a href="#sh-isget">esObtener()</a>
+<a href="#sh-isput">esPut()</a>
+<a href="#sh-isdelete">es eliminar()</a>
+<a href="#sh-isajax">esAjax()</a>
+<a href="#sh-getclientip">obtenerIpCliente()</a>
 <div class="sb-subcat">Autenticación</div>
-<a href="#sh-generatetoken">generateToken()</a>
-<a href="#sh-hashpassword">hashPassword()</a>
-<a href="#sh-verifypassword">verifyPassword()</a>
+<a href="#sh-generatetoken">generarToken()</a>
+<a href="#sh-hashpassword">hashContraseña()</a>
+<a href="#sh-verifypassword">verificar contraseña()</a>
 <div class="sb-subcat">Utilidades de datos</div>
-<a href="#sh-slugify">slugify()</a>
-<a href="#sh-arrayonly">arrayOnly()</a>
+<a href="#sh-slugify">slugificar()</a>
+<a href="#sh-arrayonly">solomatriz()</a>
 <div class="sb-subcat">Generación de identificación y utilidades</div>
-<a href="#sh-byteid">byteId()</a>
-<a href="#sh-makeid">makeId()</a>
-<a href="#sh-formatid">formatId()</a>
-<a href="#sh-intid">intId()</a>
+<a href="#sh-byteid">ID de byte()</a>
+<a href="#sh-makeid">hacerId()</a>
+<a href="#sh-formatid">identificador de formato()</a>
+<a href="#sh-intid">identificadorint()</a>
 <a href="#sh-bigintid">bigintId()</a>
-<a href="#sh-stringer">stringer()</a>
-        <a href="#sh-otpcoder">OTP Coder</a>
+<a href="#sh-stringer">larguero()</a>
+<a href="#sh-otpcoder">Codificador OTP</a>
 <div class="sb-cat">Seguridad API</div>
 <a href="#api-methods">Control del método HTTP</a>
 <a href="#api-cors">CORS</a>
@@ -356,17 +345,17 @@
 <a href="#workflow">Flujo de trabajo completo</a>
 </nav>
 </aside>
-<!-- MAIN CONTENT -->
+CONTENIDO PRINCIPAL
 <main class="content">
-<!-- ====== GİRİŞ ====== -->
+====== INICIAR SESIÓN ======
 <header id="page-header">
-<h1>ArtiFrame <span>Documentación</span></h1>
+<h1>ArtiFrame<span>Documentación</span></h1>
 <p class="lead">Marco para proyectos PHP nativos escalables administrados sin dependencias externas, reglas estrictas y una potente CLI. Sin dependencias, un ecosistema ligero y rápido libre de sopa de paquetes de compositores, lo que le permite centrarse en su lógica empresarial.</p>
 </header>
-<!-- ====== GİRİŞ & FELSEFE ====== -->
+====== INTRODUCCIÓN Y FILOSOFÍA ======
 <section id="giris">
 <h2>Introducción y Filosofía</h2>
-<p>marco artístico, <strong>"Convención sobre configuración"</strong> Se basa en el principio de (Reglas antes de la configuración). El poder de un marco no proviene de la riqueza de las herramientas que ofrece, sino de la coherencia del orden que establece.</p>
+<p>marco artístico,<strong>"Convención sobre configuración"</strong>Se basa en el principio de (Reglas antes de la configuración). El poder de un marco no proviene de la riqueza de las herramientas que ofrece, sino de la coherencia del orden que establece.</p>
 <div class="grid-2">
 <div class="card highlight">
 <h3>Cero gastos generales</h3>
@@ -378,32 +367,30 @@
 </div>
 <div class="card highlight">
 <h3>Conjunto de reglas estrictas</h3>
-<p>Un desarrollador junior que acaba de unirse al proyecto, <code class="ic">data-js</code> Entiende la arquitectura y la estructura de directorios en minutos. La compatibilidad del equipo está garantizada a nivel de marco.</p>
+<p>Un desarrollador junior que acaba de unirse al proyecto,<code class="ic">data-js</code>Entiende la arquitectura y la estructura de directorios en minutos. La compatibilidad del equipo está garantizada a nivel de marco.</p>
 </div>
 <div class="card highlight">
 <h3>Prioridad CLI</h3>
-<p>No es necesario crear manualmente archivos de vista, API o clase. La CLI genera archivos resguardo, vincula activos y mantiene la coherencia del proyecto.</p>
+<p>No es necesario crear manualmente archivos de vista, API o clase. La CLI genera archivos resguardo, establece vínculos de activos y mantiene la coherencia del proyecto.</p>
 </div>
 </div>
 <div class="alert a-info">
-<strong>💡 Filosofía de las Adicciones:</strong> Al crear un nuevo proyecto, se instalan paquetes de compositores estándar mundial como phpmailer, redis, ramsey/uuid. Sin embargo, el núcleo de ArtiFrame no depende de ellos. Puedes eliminarlo cuando quieras, descargar tus propios paquetes y reescribir tus funciones de acuerdo con tu propia arquitectura. ArtiFrame preserva su libertad arquitectónica al tiempo que reduce la dependencia externa a cero.
-        </div>
+<strong>💡 Filosofía de las Adicciones:</strong>Al crear un nuevo proyecto, se instalan paquetes de compositores estándar mundial como phpmailer, redis, ramsey/uuid. Sin embargo, el núcleo de ArtiFrame no depende de ellos. Puedes eliminarlo cuando quieras, descargar tus propios paquetes y reescribir tus funciones de acuerdo con tu propia arquitectura. ArtiFrame preserva su libertad arquitectónica al tiempo que reduce la dependencia externa a cero.</div>
 <div class="alert a-info">
-<strong>ℹ️ Licencia AGPLv3:</strong> ArtiFrame es de código abierto. Las obras derivadas que usted produzca se pueden utilizar libremente, siempre que el código fuente permanezca abierto. El aviso de derechos de autor no se puede eliminar.
-        </div>
+<strong>ℹ️ Licencia AGPLv3:</strong>ArtiFrame es de código abierto. Las obras derivadas que usted produzca se pueden utilizar libremente, siempre que el código fuente permanezca abierto. El aviso de derechos de autor no se puede eliminar.</div>
 </section>
-<!-- ====== LİSANS VE KULLANIM ====== -->
+====== LICENCIA Y USO ======
 <section id="lisans">
 <h2>Licencia y términos de uso</h2>
 <p>ArtiFrame es un framework de código abierto con licencia AGPLv3. Sin embargo, se han diseñado escenarios de uso flexibles para que los desarrolladores puedan comercializar sus proyectos y venderlos como código cerrado.</p>
 <div class="grid-2">
 <div class="card highlight" style="border-left-color: var(--green);">
 <h3>🗽 Özgür Ticaret (Proyectos de usuario final)</h3>
-<p>En las webs de tus clientes, paneles internos B2B, infraestructuras de E-Commerce o cualquier proyecto SaaS/PaaS que sirva al usuario final. <strong>eres libre</strong> Puede ocultar su código, venderlo y protegerlo con derechos de autor.</p>
+<p>En las webs de tus clientes, paneles internos B2B, infraestructuras de E-Commerce o cualquier proyecto SaaS/PaaS que sirva al usuario final.<strong>eres libre</strong>Puede ocultar su código, venderlo y protegerlo con derechos de autor.</p>
 </div>
 <div class="card highlight" style="border-left-color: var(--yellow);">
 <h3>🔄 Bifurcación y nuevo marco</h3>
-<p>Los archivos principales de ArtiFrame (<code>bin/</code> Y <code>app/</code>) Si está produciendo un nuevo marco, infraestructura CMS o herramienta de codificación para usted o para otros, también puede utilizar este nuevo producto. <strong>Código abierto</strong> Tienes que publicarlo como .</p>
+<p>Los archivos principales de ArtiFrame (<code>bin/</code>Y<code>app/</code>) Si está produciendo un nuevo marco, infraestructura CMS o herramienta de codificación para usted o para otros, también puede utilizar este nuevo producto.<strong>Código abierto</strong>Tienes que publicarlo como .</p>
 </div>
 <div class="card highlight" style="border-left-color: var(--red); grid-column: span 2;">
 <h3>⚖️ Situación de aplicación e infracción legal</h3>
@@ -417,11 +404,11 @@
 <button class="tab-btn active" onclick="switchTab('tab-enduser', this)" style="white-space: nowrap; padding: 10px 20px; background: #00c88c; color: #000; font-weight: 600; border: none; border-radius: 5px; cursor: pointer;">Proyecto de usuario final</button>
 <button class="tab-btn" onclick="switchTab('tab-core', this)" style="white-space: nowrap; padding: 10px 20px; background: #1c2128; color: #fff; border: 1px solid #30363d; border-radius: 5px; cursor: pointer;">Cambio central (marco/CMS)</button>
 </div>
-<!-- Tab 1 -->
+pestaña 1
 <div class="tab-content" id="tab-enduser" style="display: block;">
 <div class="card highlight" style="border-left-color: var(--green);">
 <h3>✅ Eres completamente libre</h3>
-<p>Si utiliza la infraestructura ArtiFrame en los sitios web de sus clientes, paneles internos B2B, infraestructuras de comercio electrónico o proyectos SaaS <strong>No está sujeto a ninguna restricción de licencia.</strong></p>
+<p>Si utiliza la infraestructura ArtiFrame en los sitios web de sus clientes, paneles internos B2B, infraestructuras de comercio electrónico o proyectos SaaS<strong>No está sujeto a ninguna restricción de licencia.</strong></p>
 <ul>
 <li>Puede cifrar y ocultar su código.</li>
 <li>Puedes vender tu proyecto al precio que quieras.</li>
@@ -429,11 +416,10 @@
 </ul>
 </div>
 </div>
-<!-- Tab 2 -->
+pestaña 2
 <div class="tab-content" id="tab-core" style="display: none;">
 <div class="alert a-info">
-<strong>ℹ️ Modificación del kernel:</strong> Los propios códigos fuente de ArtiFrame (<code>bin/</code> Y <code>app/</code>) y cambiar esto <strong>un nuevo marco, CMS o herramienta de codificación</strong> Si utiliza as , se aplica el siguiente árbol de decisión:
-                </div>
+<strong>ℹ️ Modificación del kernel:</strong>Los propios códigos fuente de ArtiFrame (<code>bin/</code>Y<code>app/</code>) y cambiar esto<strong>un nuevo marco, CMS o herramienta de codificación</strong>Si utiliza as , se aplica el siguiente árbol de decisión:</div>
 <div class="card" style="padding: 0; overflow-x: auto; background: #0d1117; border-radius: 10px;">
 <canvas height="520" id="licenseCanvasCore" style="min-width: 800px; display: block;" width="1200"></canvas>
 </div>
@@ -448,87 +434,61 @@
                     el.style.border = '1px solid #30363d';
                     el.style.fontWeight = '400';
                 });
                 document.getElementById(tabId).style.display = 'block';
                 btn.style.background = tabId === 'tab-enduser' ? '#00c88c' : '#58a6ff';
                 btn.style.color = '#000';
                 btn.style.fontWeight = '600';
                 btn.style.border = 'none';
             }
         </script>
-        <h3 style="margin-top: 30px;">Comandos Adicionales</h3>
-        <p><strong>Listar Tablas:</strong> Para ver todas las plantillas de tablas disponibles y sus descripciones:</p>
-        <pre><code>artiframe&gt; <span class="fn">table</span> <span class="st">list</span></code></pre>
-        <p><strong>Vista previa del contenido de la tabla:</strong> Para inspeccionar el contenido SQL en la terminal antes de agregarlo al archivo <code>schema.sql</code>, puede agregar el parámetro <code>check</code>:</p>
-        <pre><code>artiframe&gt; <span class="fn">table:</span><span class="st">users</span> <span class="st">check</span></code></pre>
-    </section>
-<!-- ====== KURULUM ====== -->
+<h3 style="margin-top: 30px;">Comandos adicionales</h3>
+<p><strong>Tablas de listado:</strong>Para ver todas las plantillas y descripciones de tablas disponibles:</p>
+<pre><code>artiframe&gt; <span class="fn">mesa</span> <span class="st">lista</span></code></pre>
+<p><strong>Vista previa del contenido de la tabla:</strong>una pintura<code>schema.sql</code>al final del comando para examinar el contenido de SQL en la terminal antes de agregarlo al archivo.<code>check</code>Puedes agregar el parámetro:</p>
+<pre><code>artiframe&gt; <span class="fn">mesa:</span><span class="st">usuarios</span> <span class="st">controlar</span></code></pre>
+</section>
+====== INSTALACIÓN ======
 <section id="kurulum">
 <h2>Configuración</h2>
 <p>ArtiFrame CLI se instala como una herramienta PHP global. Instalado una vez, utilizado en cada proyecto.</p>
 <h3>1. Instale la herramienta CLI globalmente</h3>
-<pre><code><span class="cm"># NPM üzerinden global kurulum</span>
+<pre><code><span class="cm"># Instalación global a través de NPM</span>
 npm install -g @artilingo/artiframe-cli
-<span class="cm"># Kurulumu doğrula</span>
+<span class="cm"># Verificar la instalación</span>
 artiframe</code></pre>
 <h3>2. Shell interactivo</h3>
-<p>Solo a la terminal <code class="ic">artiframe</code> Escríbelo y presiona Enter. CLI no se cierra; Se abre un shell interactivo que escucha constantemente los comandos:</p>
+<p>Solo a la terminal<code class="ic">artiframe</code>Escríbelo y presiona Enter. CLI no se cierra; Se abre un shell interactivo que escucha constantemente los comandos:</p>
 <pre><code>==================================================
         ArtiFrame CLI Interactive Shell v1.0.0
 ==================================================
 Type 'help' for commands, or 'exit' to quit.
 artiframe&gt; </code></pre>
 <h3>3. Iniciar un nuevo proyecto</h3>
 <pre><code>artiframe&gt; new benim-projem</code></pre>
-<p>este comando <code class="ic">benim-projem/</code> directorio y copia toda la estructura del esqueleto en él: <code class="ic">app/</code>, <code class="ic">bin/</code>, <code class="ic">config/</code>, <code class="ic">public/</code>, <code class="ic">src/</code>, <code class="ic">.env.example</code> y primero <code class="ic">index.php</code> página.</p>
+<p>este comando<code class="ic">benim-projem/</code>directorio y copia toda la estructura del esqueleto en él:<code class="ic">app/</code>, <code class="ic">bin/</code>, <code class="ic">config/</code>, <code class="ic">public/</code>, <code class="ic">src/</code>, <code class="ic">.env.example</code>y primero<code class="ic">index.php</code>página.</p>
 <h3>4. Configuración del entorno</h3>
 <pre><code>cp .env.example .env</code></pre>
-<p><code class="ic">.env</code> Abra su archivo y complete la base de datos y la información de la solicitud. Este archivo nunca entra en control de versiones.</p>
+<p><code class="ic">.env</code>Abra su archivo y complete la base de datos y la información de la solicitud. Este archivo nunca entra en control de versiones.</p>
 <div class="alert a-warn">
-<strong>⚠️ Configuración del servidor web:</strong> Raíz del documento de Apache/Nginx <code class="ic">/public/</code> redirigir a la carpeta. Otros directorios nunca deben estar abiertos al exterior.
-        </div>
+<strong>⚠️ Configuración del servidor web:</strong>Raíz del documento de Apache/Nginx<code class="ic">/public/</code>redirigir a la carpeta. Otros directorios nunca deben estar abiertos al exterior.</div>
 </section>
-<!-- ====== DİZİN YAPISI ====== -->
+====== ESTRUCTURA DEL DIRECTORIO ======
 <section id="dizin">
 <h2>Estructura del directorio</h2>
 <p>La arquitectura creada cuando se inició el proyecto; Proporciona una clara separación de responsabilidades (SoC).</p>
 <div class="tree">
 <span class="dir">nombre-proyecto/</span>
-├── <span class="dir">aplicación/</span> <span class="note"># Capa de infraestructura</span>
-│ ├── <span class="file">VerControl.php</span> <span class="note"># Ver programa previo (página HTML)</span>
-│ ├── <span class="file">ApiControl.php</span> <span class="note"># Arrancador de punto final API</span>
-│ ├── <span class="file">base de datos.php</span> <span class="note"># Conexión de base de datos basada en PDO</span>
-│ ├── <span class="file">DotEnv.php</span> <span class="note"># lector .env</span>
-│ └── <span class="file">R2Manager.php</span> <span class="note"># Administrador de archivos Cloudflare R2</span>
+├── <span class="dir">aplicación/</span> <span class="note"># Capa de infraestructura</span>│ ├──<span class="file">VerControl.php</span> <span class="note"># Ver programa previo (página HTML)</span>│ ├──<span class="file">ApiControl.php</span> <span class="note"># Arrancador de punto final API</span>│ ├──<span class="file">base de datos.php</span> <span class="note"># Conexión de base de datos basada en PDO</span>│ └──<span class="file">DotEnv.php</span> <span class="note"># lector .env</span>
 │
-├── <span class="dir warn">mil/</span> <span class="note"># ⚠️ Sistema principal: no editar directamente</span>
-│ ├── <span class="file">MétodoSistema.php</span> <span class="note"># API/ayudantes globales de backend</span>
-│ ├── <span class="file">VerMetodo.php</span> <span class="note"># Ver/frontend ayudantes globales</span>
-│ └── <span class="dir">talones/</span> <span class="note"># Archivos de plantilla utilizados por CLI</span>
-│ ├── ver.stub
+├── <span class="dir warn">mil/</span> <span class="note"># ⚠️ Sistema principal: no editar directamente</span>│ ├──<span class="file">MétodoSistema.php</span> <span class="note"># API/ayudantes globales de backend</span>│ ├──<span class="file">VerMetodo.php</span> <span class="note"># Ver/frontend ayudantes globales</span>│ └──<span class="dir">talones/</span> <span class="note"># Archivos de plantilla utilizados por CLI</span>│ ├── ver.stub
 │ ├── api-estándar.stub
 │ ├── api-switch-case.stub
 │ └── clase.stub
 │
-├── <span class="dir">configuración/</span> <span class="note"># Archivos de configuración</span>
-│ └── <span class="file">versión-aplicación.php</span> <span class="note"># Constantes APP_VERSION y APP_ENV</span>
+├──<span class="dir">configuración/</span> <span class="note"># Archivos de configuración</span>│ └──<span class="file">versión-aplicación.php</span> <span class="note"># Constantes APP_VERSION y APP_ENV</span>
 │
-├── <span class="dir">público/</span> <span class="note"># ← El único directorio abierto del servidor web.</span>
-│ ├── <span class="dir safe">activos/</span>
-│ │ ├── <span class="dir">css/</span> <span class="note"># Ver archivos CSS específicos</span>
-│ │ └── <span class="dir">js/</span> <span class="note"># Ver archivos JS específicos</span>
-│ ├── <span class="dir">incluye/</span> <span class="note"># Componentes compartidos</span>
-│ │ ├── cabeza.php
-│ │ ├── encabezado.php
-│ │ └── pie de página.php
-│ ├── <span class="dir">API/</span> <span class="note"># archivos de punto final API</span>
-│ └── <span class="file">index.php</span> <span class="note"># Página de inicio</span>
+├── <span class="dir">público/</span> <span class="note"># ← El único directorio abierto del servidor web.</span>│ ├──<span class="dir safe">activos/</span>│ │ ├──<span class="dir">css/</span> <span class="note"># Ver archivos CSS específicos</span>│ │ └──<span class="dir">js/</span> <span class="note"># Ver archivos JS específicos</span>│ ├──<span class="dir">incluye/</span> <span class="note"># Componentes compartidos</span>│ │ ├── cabeza.php
+│ ├──<span class="file">cabeza.php</span>│ ├──<span class="file">encabezado.php</span>│ └──<span class="file">pie de página.php</span>│ ├──<span class="dir">API/</span> <span class="note"># archivos de punto final API</span>│ └──<span class="file">index.php</span> <span class="note"># Página de inicio</span>
 │
 ├── <span class="dir">src/</span> <span class="note"># Lógica empresarial y clases.</span>
 ├── <span class="file">.env</span> <span class="note"># Variables de entorno (no incluidas en git)</span>
@@ -536,65 +496,128 @@ artiframe&gt; </code></pre>
 └── <span class="file">guía.html</span> <span class="note"># Este documento</span>
 </div>
 <div class="alert a-danger">
-<strong>🚫 No toque el directorio bin/:</strong> <code class="ic">bin/</code> Los archivos internos son el núcleo del marco. Aquí no se agrega la lógica empresarial específica del proyecto. Clases y servicios que agregarás <code class="ic">src/</code> Bajo componentes de infraestructura <code class="ic">app/</code> se encuentra debajo.
-        </div>
+<strong>🚫 No toque el directorio bin/:</strong> <code class="ic">bin/</code>Los archivos internos son el núcleo del marco. Aquí no se agrega la lógica empresarial específica del proyecto. Clases y servicios que agregarás<code class="ic">src/</code>Bajo componentes de infraestructura<code class="ic">app/</code>se encuentra debajo.</div>
 </section>
-<!-- ====== BOOTSTRAPPER ====== -->
+====== V2.0 ENRUTAMIENTO Y ARQUITECTURA ======
+<section id="v2-routing">
+<h2>Enrutamiento sin configuración e innovaciones v2.0.0<span class="tag b-cli">NUEVO</span></h2>
+<p class="lead">Con ArtiFrame v2.0.0, la estructura central del marco ha obtenido una arquitectura de enrutamiento basada en archivos "Zero-Config" mucho más liviana, rápida y fácil de usar para los desarrolladores.</p>
+<h3>1. Enrutamiento automático basado en archivos (routeLink)</h3>
+<p>A diferencia de los frameworks tradicionales, ArtiFrame permite la configuración individual para cada ruta (por ejemplo:<code>web.php</code>No quiere que le agregues una ruta. Todas las solicitudes<code>public/index.php</code>en el archivo<strong>a una única puerta de enlace</strong>caídas y<code>routeLink()</code>Se gestiona mágicamente a través del método.</p>
+<div class="card highlight">
+<h4>¿Cómo funciona?</h4>
+<p>Si desde el navegador<code>/kategori/elektronik/15</code>Si se ingresa la dirección, el sistema<code>DOCUMENT_ROOT</code>Busca en el directorio de abajo hacia arriba el archivo PHP coincidente más largo:</p>
+<ol>
+<li><code>/kategori/elektronik/15.php</code>(Extraviado)</li>
+<li><code>/kategori/elektronik.php</code>(Extraviado)</li>
+<li><code>/kategori.php</code>(¡Encontró!)</li>
+</ol>
+<p>Al ejecutar el archivo coincidente, los fragmentos de URL restantes se eliminan automáticamente.<code>$_GET</code>convertido a parámetros:</p>
+<pre><code>$_GET['params'] = ['elektronik', '15'];
+$_GET['param1'] = 'elektronik';
+$_GET['param2'] = '15';</code></pre>
+</div>
+<div class="alert a-info">
+<strong>💡 Compatibilidad con versiones anteriores (ID):</strong>Para no romper con los hábitos de las versiones antiguas.<code>$_GET['param1']</code>Siempre<code>$_GET['id']</code>También está sincronizado en . Así, directamente en las páginas de detalles<code>$_GET['id']</code>puedes usar</div>
+<div class="card">
+<h4>Enlace (a) ¿Cómo deben ser las etiquetas?</h4>
+<p>En el nuevo sistema de enrutamiento, los parámetros de cadena de consulta de estilo antiguo (<code>?id=...&amp;token=...</code>) en su lugar<strong>Limpiar URL</strong>Se utiliza la estructura. De esta manera, tus enlaces serán más legibles y amigables con el SEO.</p>
+<pre><code><span class="cm">&lt;!-- ❌ EDIFICIO ANTIGUO (No debe usarse) --&gt;</span>
+&lt;a href="user.php?id=123456&amp;token=123j54m23k"&gt;Profili Gör&lt;/a&gt;
+<span class="cm">&lt;!-- ✅ NUEVA ESTRUCTURA (Estándar ArtiFrame) --&gt;</span>
+&lt;a href="/user/123456/123j54m23k"&gt;Profili Gör&lt;/a&gt;</code></pre>
+<p>En la nueva estructura anterior, acceder a los datos en la página correspondiente es bastante sencillo:</p>
+<pre><code><span class="cm">// en público/usuario.php:</span>
+$userId = sanitizeInt($_GET['param1']); <span class="cm">// 123456 (o $_GET['id'])</span>
+$token = sanitizeString($_GET['param2']); <span class="cm">// 123j54m23k</span></code></pre>
+</div>
+<h3>2. Ayudantes globales</h3>
+<p>En versiones anteriores<code>\Bin\SystemMethod::generateToken()</code>o<code>\Bin\ViewMethod::display()</code>Se requerían llamadas de espacios de nombres largos como este. Con v2.0.0, todas estas funciones están disponibles en el espacio de nombres global (<code>namespace { }</code>) fue incluido.</p>
+<p>Ahora puedes llamarlo desde cualquier lugar de tu aplicación así:</p>
+<pre><code>$token = generateToken();
+echo display($user['name']);
+echo csrfField();</code></pre>
+<h3>3. Cambios estructurales (cambios importantes)</h3>
+<div class="alert a-success">
+<strong>🕊️ No más miedo a la refactorización:</strong>A diferencia de otros marcos, no experimentará crisis de "refactorización" que duren días en sus proyectos cuando se publiquen las actualizaciones principales de ArtiFrame.<code>artiframe new</code>Tan pronto como usted lo diga, todos los archivos principales de esa versión se copian a su proyecto. Las nuevas versiones lanzadas (por ejemplo, v3, v4) nunca interrumpirán sus proyectos existentes; Sigue funcionando de forma estable durante años, independientemente de los requisitos de la versión instalada en el proyecto.</div>
+<div class="alert a-danger">
+<strong>⚠️ Importante:</strong>En tus viejos proyectos<code>public/index.php</code>una página de bienvenida contenía HTML. A partir de v2.0.0<code>index.php</code>Es sólo un archivo de enrutador. El antiguo diseño de tu página de inicio ahora es el predeterminado<code>public/landing.php</code>Se ofrece vía. (Cuando llega una URL vacía, el sistema utiliza de forma predeterminada<code>landing.php</code>redirige al archivo).</div>
+<p>También en nuevos proyectos<code>artiframe new</code>para que el sistema pueda retroceder automáticamente cuando lo ejecute.<code>public/404.php</code>Y<code>public/503.php</code>Se producen páginas de error.</p>
+<div class="card">
+<h4>Gestión inteligente de errores de API</h4>
+<p>Si hay errores 404 (Página no encontrada) o 503 (Modo de mantenimiento)<strong>al punto final API</strong>(Por ejemplo<code>/api/user/get</code>) llega; En lugar de mostrar una página HTML al cliente HTTP (aplicación móvil, interfaz), el sistema establece el código de estado y crea automáticamente un estándar.<strong>Error JSON</strong>regresa. Esto garantiza que su API siempre pueda responder JSON sin fallar.</p>
+<pre><code>{
+  "status": "error",
+  "message": "API Endpoint Not Found",
+  "data": []
+}</code></pre>
+<div class="alert a-warning" style="margin-top: 15px;">
+<strong>💡 Nota: captura de errores de interfaz</strong><br/>El código de error (404, 503, etc.) no está incluido en los datos JSON, sino directamente en el estándar.<strong>En respuesta de red HTTP (código de estado)</strong>giratorio. De esta manera, puedes detectar errores en la capa de red sin tener que analizar el contenido JSON:</div>
+<pre><code><span class="cm">// Obtener ejemplo de API:</span>
+fetch('/api/user/get').then(response =&gt; {
+    if (!response.ok) {
+        console.error("HTTP Hatası:", response.status); <span class="cm">// 404 o 503</span>
+    }
+});
+<span class="cm">// Ejemplo de Axios:</span>
+axios.get('/api/user/get').catch(error =&gt; {
+    console.error("HTTP Hatası:", error.response.status); <span class="cm">// 404 o 503</span>
+});</code></pre>
+</div>
+</section>
+====== BOTAS ======
 <section id="bootstrapper">
-<h2>Arquitectura previa <span class="tag b-core">Kritik</span></h2>
-<p>ArtiFrame utiliza dos bootstrappers completamente independientes. esta arquitectura <strong>Problemas de encabezado HTML y vulnerabilidades de seguridad</strong> lo impide radicalmente.</p>
+<h2>Arquitectura previa<span class="tag b-core">Crítico</span></h2>
+<p>ArtiFrame utiliza dos bootstrappers completamente independientes. esta arquitectura<strong>Problemas de encabezado HTML y vulnerabilidades de seguridad</strong>lo impide radicalmente.</p>
 <div class="grid-2">
 <div class="card highlight">
-<h3><span class="badge b-view">View</span> VerControl.php</h3>
-<p>Se utiliza para páginas HTML (ver archivos). Comienza la sesión, <code class="ic">ViewMethod</code>Se instala.</p>
-<pre><code><span class="cm">// public/profil.php — EN ÜSTE, HTML basmadan önce</span>
+<h3><span class="badge b-view">vista</span>VerControl.php</h3>
+<p>Se utiliza para páginas HTML (ver archivos). Comienza la sesión,<code class="ic">ViewMethod</code>Se instala.</p>
+<pre><code><span class="cm">// public/profile.php — HACIA ARRIBA, antes de imprimir HTML</span>
 <span class="kw">&lt;?php</span>
-<span class="fn">require_once</span> <span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>]
+<span class="fn">requerir_una vez</span> <span class="var">$_SERVIDOR</span>[<span class="st">'DOCUMENT_ROOT'</span>]
     . <span class="st">'/../app/ViewControl.php'</span>;
-<span class="kw">use</span> Bin\ViewMethod;
+<span class="kw">usar</span> Bin\ViewMethod;
 <span class="kw">?&gt;</span>
 <span class="kw">&lt;!DOCTYPE html&gt;</span>
 ...</code></pre>
 </div>
 <div class="card highlight">
-<h3><span class="badge b-api">API</span> ApiControl.php</h3>
-<p>Se utiliza para archivos de punto final API. Establece el encabezado JSON, realiza el control del método HTTP, <code class="ic">SystemMethod</code>Se instala.</p>
-<pre><code><span class="cm">// public/api/kullanici/getir.php</span>
+<h3><span class="badge b-api">API</span>ApiControl.php</h3>
+<p>Se utiliza para archivos de punto final API. Establece el encabezado JSON, realiza el control del método HTTP,<code class="ic">SystemMethod</code>Se instala.</p>
+<pre><code><span class="cm">// público/api/usuario/getir.php</span>
 <span class="kw">&lt;?php</span>
-<span class="cm">// $allowedMethods MUTLAKA require'dan önce tanımlanmalı</span>
-<span class="var">$allowedMethods</span> = [<span class="st">'GET'</span>];
-<span class="fn">require_once</span> <span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>]
+<span class="cm">// $allowedMethods DEBEN definirse antes de requerir</span>
+<span class="var">$métodos permitidos</span> = [<span class="st">'CONSEGUIR'</span>];
+<span class="fn">requerir_una vez</span> <span class="var">$_SERVIDOR</span>[<span class="st">'DOCUMENT_ROOT'</span>]
     . <span class="st">'/../app/ApiControl.php'</span>;
-<span class="kw">use</span> Bin\SystemMethod;</code></pre>
+<span class="kw">usar</span> Bin\SystemMethod;</code></pre>
 </div>
 </div>
 <div class="alert a-danger">
-<strong>🚫 ViewControl y ApiControl nunca se mezclan:</strong> Si se requiere ViewControl para un archivo API, es posible que se devuelva el encabezado HTML en lugar del encabezado JSON y se dañará toda la respuesta de la API. Si se requiere ApiControl en una página HTML, la sesión no se iniciará y la página se interrumpirá.
-        </div>
+<strong>🚫 ViewControl y ApiControl nunca se mezclan:</strong>Si se requiere ViewControl para un archivo API, es posible que se devuelva el encabezado HTML en lugar del encabezado JSON y se dañará toda la respuesta de la API. Si se requiere ApiControl en una página HTML, la sesión no se iniciará y la página se interrumpirá.</div>
 </section>
-<!-- ====== KURALLAR ====== -->
+====== REGLAS ======
 <section id="kurallar">
-<h2>Conjunto de reglas <span class="tag b-core">Standart</span></h2>
+<h2>Conjunto de reglas<span class="tag b-core">Estándar</span></h2>
 <div class="card">
-<h3>Regla 1: Arquitectura data-js <span class="badge b-sec">Kritik</span></h3>
-<p>Los eventos de JavaScript nunca son <code class="ic">class</code> o <code class="ic">id</code> No se puede escuchar por encima de él. Estas son identidades visuales/de estilo. Todas las interacciones JS <code class="ic">data-js</code> Está gestionado por el atributo. JavaScript nunca falla cuando CSS elimina una clase.</p>
-<pre><code><span class="cm">&lt;!-- ❌ Anti-Pattern — desteklenmez --&gt;</span>
+<h3>Regla 1: Arquitectura data-js<span class="badge b-sec">Crítico</span></h3>
+<p>Los eventos de JavaScript nunca son<code class="ic">class</code>o<code class="ic">id</code>No se puede escuchar por encima de él. Estas son identidades visuales/de estilo. Todas las interacciones JS<code class="ic">data-js</code>Está gestionado por el atributo. JavaScript nunca falla cuando CSS elimina una clase.</p>
+<pre><code><span class="cm">&lt;!-- ❌ Antipatrón — no compatible --&gt;</span>
 &lt;button id="submitBtn" class="btn"&gt;Gönder&lt;/button&gt;
 <span class="cm">// JS: document.getElementById('submitBtn').addEventListener(...)</span>
-<span class="cm">&lt;!-- ✅ ArtiFrame Standardı --&gt;</span>
-&lt;button class="btn btn-primary" <span class="var">data-js</span>="login-submit"&gt;Gönder&lt;/button&gt;
+<span class="cm">&lt;!-- ✅ Estándar ArtiFrame --&gt;</span>
+&lt;button class="btn btn-primary" <span class="var">datos-js</span>="login-submit"&gt;Gönder&lt;/button&gt;
 <span class="cm">// JS: document.querySelector('[data-js="login-submit"]').addEventListener(...)</span></code></pre>
 </div>
 <div class="card">
 <h3>Regla 2: Arquitectura temática</h3>
-<p>Modo y temas oscuro/claro, <code class="ic">&lt;html&gt;</code> de la etiqueta <code class="ic">data-theme</code> Y <code class="ic">data-mode</code> Se gestiona a través de sus atributos. No se utilizan clases de cuerpo.</p>
-<pre><code><span class="cm">&lt;!-- view.stub şablonundan gelen HTML açılış etiketi --&gt;</span>
+<p>Modo y temas oscuro/claro,<code class="ic">&lt;html&gt;</code>de la etiqueta<code class="ic">data-theme</code>Y<code class="ic">data-mode</code>Se gestiona a través de sus atributos. No se utilizan clases de cuerpo.</p>
+<pre><code><span class="cm">&lt;!-- Etiqueta de apertura HTML de la plantilla view.stub --&gt;</span>
 &lt;html lang="tr" data-theme="default" data-mode="light"&gt;
-<span class="cm">/* app.css içindeki tema tanımı */</span>
+<span class="cm">/* definición del tema en app.css */</span>
 html[data-theme="default"][data-mode="dark"] {
     --bg-color: #0b0c0e;
     --text-main: #ffffff;
@@ -606,80 +629,69 @@ html[data-theme="default"][data-mode="light"] {
 </div>
 <div class="card">
 <h3>Regla 3: flujo de datos seguro</h3>
-<p>Todos los datos provenientes de la base de datos se procesan antes de enviarse al DOM. <code class="ic">display()</code> Está envuelto con. Todos los datos que llegan a la API se procesan antes de procesarse. <code class="ic">sanitizeString()</code> o <code class="ic">sanitizeInt()</code> Se limpia con .</p>
+<p>Todos los datos provenientes de la base de datos se procesan antes de enviarse al DOM.<code class="ic">display()</code>Está envuelto con. Todos los datos que llegan a la API se procesan antes de procesarse.<code class="ic">sanitizeString()</code>o<code class="ic">sanitizeInt()</code>Se limpia con .</p>
 </div>
 <div class="card">
 <h3>Regla 4: Manejo de errores con APP_ENV</h3>
-<p><code class="ic">.env</code> en el archivo <code class="ic">APP_ENV</code> El valor determina la visibilidad del error. En producción, no se muestra ningún mensaje de error al usuario.</p>
-<pre><code><span class="cm">// config/app-version.php</span>
-define(<span class="st">'APP_ENV'</span>, (int)<span class="var">$_ENV</span>[<span class="st">'APP_ENV'</span>]); <span class="cm">// 1=Debug, 0=Production</span>
-<span class="kw">if</span> (APP_ENV === <span class="nu">1</span>) {
+<p><code class="ic">.env</code>en el archivo<code class="ic">APP_ENV</code>El valor determina la visibilidad del error. En producción, no se muestra ningún mensaje de error al usuario.</p>
+<pre><code><span class="cm">//config/app-version.php</span>
+define(<span class="st">'APP_ENV'</span>, (int)<span class="var">$_ENV</span>[<span class="st">'APP_ENV'</span>]); <span class="cm">// 1=Depurar, 0=Producción</span>
+<span class="kw">si</span> (APP_ENV === <span class="nu">1</span>) {
     ini_set(<span class="st">'display_errors'</span>, <span class="nu">1</span>);
     error_reporting(E_ALL);
-} <span class="kw">else</span> {
+} <span class="kw">demás</span> {
     ini_set(<span class="st">'display_errors'</span>, <span class="nu">0</span>);
 }</code></pre>
 </div>
 </section>
-<!-- ====== CLI GİRİŞ ====== -->
+====== INICIAR SESIÓN CLI ======
 <section id="cli-giris">
 <h2>Ecosistema CLI</h2>
-<p>ArtiFrame CLI al terminal <code class="ic">artiframe</code> Abre un shell interactivo cuando se escribe. Todos los comandos se ejecutan dentro de este shell. Los comandos también se pueden ejecutar una vez.</p>
-<pre><code><span class="cm"># İnteraktif mod (önerilen)</span>
+<p>ArtiFrame CLI al terminal<code class="ic">artiframe</code>Abre un shell interactivo cuando se escribe. Todos los comandos se ejecutan dentro de este shell. Los comandos también se pueden ejecutar una vez.</p>
+<pre><code><span class="cm"># Modo interactivo (recomendado)</span>
 artiframe
 artiframe&gt; make:view admin/kullanicilar.php
-<span class="cm"># Tek seferlik mod</span>
+<span class="cm"># Modo único</span>
 artiframe make:view admin/kullanicilar.php</code></pre>
 </section>
-<!-- new -->
+nuevo
 <section id="cli-new">
-<h2><code>new</code> <span class="tag b-cli">CLI Komutu</span></h2>
-<p>Crea un nuevo proyecto ArtiFrame. Cuando se ejecuta este comando, se inicia un asistente interactivo y su proyecto <code>composer.json</code> Le solicita la información básica requerida para su configuración (nombre del paquete, autor, tipo de licencia, etc.). Una vez que se copian todos los archivos, las dependencias se instalan automáticamente.</p>
-<pre><code>artiframe&gt; <span class="fn">new</span> <span class="st">benim-projem</span>
-<span class="cm">  ╔══════════════════════════════════════════════════╗
-  ║  ArtiFrame Project Builder                       ║
-  ╚══════════════════════════════════════════════════╝
-  Proje : benim-projem
-  Konum : C:/artiframe/benim-projem</span>
-  <span class="kw">?</span> Package name (e.g. vendor/project) <span class="st">[artiframe/benim-projem]</span>:
-  <span class="kw">?</span> Description <span class="st">[ArtiFrame Core PHP Application]</span>:
+<h2><code>new</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Crea un nuevo proyecto ArtiFrame. Cuando se ejecuta este comando, se inicia un asistente interactivo y su proyecto<code>composer.json</code>Le solicita la información básica requerida para su configuración (nombre del paquete, autor, tipo de licencia, etc.). Una vez que se copian todos los archivos, las dependencias se instalan automáticamente.</p>
+<pre><code>artiframe&gt; <span class="fn">nuevo</span> <span class="st">mi-proyecto</span>
+<span class="cm">╔═════════════════════════ ═════════════════════════╗
+  ║ Generador de proyectos ArtiFrame ║
+  ╚═════════════════════════ ═════════════════════════╝
+  Proyecto: mi-proyecto
+  Ubicación: C:/artiframe/mi-proyecto</span>
+  <span class="kw">?</span> Package name (e.g. vendor/project) <span class="st">[artiframe/mi-proyecto]</span>:
+  <span class="kw">?</span> Description <span class="st">[Aplicación PHP ArtiFrame Core]</span>:
   <span class="kw">?</span> Author name <span class="st">[Artilingo]</span>:
   <span class="kw">?</span> Author homepage <span class="st">[https://artilingo.com]</span>:
-  <span class="kw">?</span> Type (project, library, composer-plugin) <span class="st">[project]</span>:
-  <span class="kw">?</span> License (AGPL-3.0-or-later, MIT, Apache-2.0, GPL-2.0-or-later, GPL-3.0-or-later, BSD-2-Clause, BSD-3-Clause, ISC, proprietary, none) <span class="st">[AGPL-3.0-or-later]</span>:
-<span class="cm">  ┌─────────────────────────────────────────────────┐
-  │  📂  Faz 1/4 — Kopyalanıyor...                  │
-  │      İşlenecek Dosya: 42 Adet                   │
-  └─────────────────────────────────────────────────┘
-  [████████████████████] 100%  (42/42)  docs/kilavuz.html...
-  ┌─────────────────────────────────────────────────┐
-  │  📂  Faz 2/4 — Dizinler Oluşturuluyor...        │
-  │      İşlenecek Dosya: 10 Adet                   │
-  └─────────────────────────────────────────────────┘
-  [████████████████████] 100%  (52/52)  public/assets/images/...
-  ┌─────────────────────────────────────────────────┐
-  │  📂  Faz 3/4 — Dinamik Dosyalar Üretiliyor...   │
-  │      İşlenecek Dosya: 14 Adet                   │
-  └─────────────────────────────────────────────────┘
-  [████████████████████] 100%  (66/66)  .agents/AGENTS.md...
-  ┌─────────────────────────────────────────────────┐
-  │  📦  Faz 4/4 — Bağımlılıklar Kuruluyor (Composer)│
-  └─────────────────────────────────────────────────┘</span>
-<span class="cm">Installing dependencies from lock file (including require-dev)...</span>
-<span class="cm">  ╔══════════════════════════════════════════════════╗
-  ║  Tebrikler! Proje başarıyla oluşturuldu.         ║
-  ╚══════════════════════════════════════════════════╝</span>
+  <span class="kw">?</span> Type (project, library, composer-plugin) <span class="st">[proyecto]</span>:
+  <span class="kw">?</span> License (AGPL-3.0-or-later, MIT, Apache-2.0, GPL-2.0-or-later, GPL-3.0-or-later, BSD-2-Clause, BSD-3-Clause, ISC, proprietary, none) <span class="st">[AGPL-3.0 o posterior]</span>:
+<span class="cm">┌──────────────────────── ─────────────────────────┐
+  │ 📂 Fase 1/4 — Copiando... │
+  │ Archivos a Procesar: 42 Piezas │
+  └──────────────────────── ─────────────────────────┘
+  [████████████████████] 100% (42/42) docs/guide.html...
+  ┌──────────────────────── ─────────────────────────┐
+  │ 📂 Fase 2/4 — Creación de directorios... │
+  │ Archivos a Procesar: 10 Piezas │
+  └──────────────────────── ─────────────────────────┘
+  [████████████████████] 100% (52/52) público/activos/imágenes/...
+  ┌──────────────────────── ─────────────────────────┐
+  │ 📂 Fase 3/4 — Generando archivos dinámicos... │
+  │ Archivos a Procesar: 14 Piezas │
+  └──────────────────────── ─────────────────────────┘
+  [████████████████████] 100% (66/66) .agentes/AGENTES.md...
+  ┌──────────────────────── ─────────────────────────┐
+  │ 📦 Fase 4/4 — Instalación de dependencias (Composer)│
+  └──────────────────────── ─────────────────────────┘</span>
+<span class="cm">Instalando dependencias desde el archivo de bloqueo (incluido require-dev)...</span>
+<span class="cm">╔═════════════════════════ ═════════════════════════╗
+  ║ ¡Felicitaciones! El proyecto ha sido creado exitosamente.         ║
+  ╚═════════════════════════ ═════════════════════════╝</span>
   📂 benim-projem/
   │  ├── 📂 bin/
   │  ├── 📂 config/
@@ -693,247 +705,238 @@ artiframe make:view admin/kullanicilar.php</code></pre>
   │  └── 📄 kilavuz.html  [125 KB]
   │
   Sonraki Adım: Lütfen .env dosyasındaki ortam değişkenlerini yapılandırın.
 </code></pre>
-<p>Una vez creado el proyecto, ArtiFrame CLI lo ejecuta por usted. <strong>abre automáticamente una nueva ventana de terminal</strong>, va a ese directorio y reinicia la herramienta enfocada en ese proyecto. Puede cerrar la antigua ventana de terminal.</p>
+<p>Una vez creado el proyecto, ArtiFrame CLI lo ejecuta por usted.<strong>abre automáticamente una nueva ventana de terminal</strong>, va a ese directorio y reinicia la herramienta enfocada en ese proyecto. Puede cerrar la antigua ventana de terminal.</p>
 <p>Estructura esquelética creada:</p>
-<div class="tree" style="font-size:0.82rem; line-height:1.7">
-nombre-proyecto/
+<div class="tree" style="font-size:0.82rem; line-height:1.7">nombre-proyecto/
 ├── aplicación/ (ViewControl.php, ApiControl.php, Database.php, DotEnv.php)
 ├── bin/ (SystemMethod.php, ViewMethod.php, stubs/)
 ├── config/ (versión-aplicación.php)
 ├── público/ (index.php, activos/, incluye/, api/)
 ├── src/
 ├── .env.ejemplo
-└── guía.html
-        </div>
+└── guía.html</div>
+</section>
+mejora
+<section id="cli-upgrade">
+<h2><code>upgrade</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Le permite integrar de forma segura nuevas funciones en la herramienta ArtiFrame CLI que ha actualizado globalmente a través de NPM en su proyecto existente.</p>
+<pre><code>artiframe&gt; <span class="fn">mejora</span></code></pre>
+<ul style="margin-left: 20px; margin-bottom: 15px; line-height: 1.6;">
+<li>Solo<code>app/</code>Y<code>bin/</code>con carpetas principales<code>src/Service/</code>Actualiza las clases de servicios fijos (si las hay) bajo él.</li>
+<li>Dónde se encuentra su lógica de negocio<code>src/</code>, <code>public/</code>Y<code>config/</code>Definitivamente en tus directorios<strong>intocable</strong>(para que su proyecto no se dañe).</li>
+<li><strong>Cortafuegos:</strong>Si su proyecto es v1.x y<code>public/index.php</code>Si su archivo no se ajusta a la nueva estructura del enrutador, dará un error y le pedirá el nombre de su index.php existente.<code>landing.php</code>Te pide que lo cambies a .</li>
+<li><strong>Aviso de modificación:</strong>si antes<code>bin/</code>Si ha cambiado manualmente las funciones principales en<strong>ingresar</strong>Pide confirmación manual (aviso de respaldo) con el botón.</li>
+<li><strong>Informe de cambio inteligente (diferencia):</strong>Cuando finaliza la actualización, imprime en el terminal un informe detallado de los archivos recién agregados o modificados (actualizados) en su proyecto.</li>
+<li><strong>Análisis de nivel de función:</strong>Si el archivo actualizado es un<code>.php</code>El archivo compara los métodos del archivo antiguo y del nuevo. Si se agrega una nueva función, el informe<code>[YENİ FONKSİYON] ad()</code>Le indica que lea la documentación con una advertencia especial.</li>
+</ul>
 </section>
-<!-- make:view -->
+hacer:ver
 <section id="cli-view">
-<h2><code>make:view</code> <span class="tag b-cli">CLI Komutu</span></h2>
-<p>Crea un nuevo archivo de página (vista) y sus recursos CSS/JS personalizados. Los activos se vinculan automáticamente a la página y <code class="ic">?v=APP_VERSION</code> La eliminación de caché se aplica con .</p>
-<pre><code>artiframe&gt; <span class="fn">make:view</span> <span class="st">admin/kullanicilar.php</span></code></pre>
+<h2><code>make:view</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Crea un nuevo archivo de página (vista) y sus recursos CSS/JS personalizados. Los activos se vinculan automáticamente a la página y<code class="ic">?v=APP_VERSION</code>La eliminación de caché se aplica con .</p>
+<pre><code>artiframe&gt; <span class="fn">hacer: ver</span> <span class="st">administrador/usuarios.php</span></code></pre>
 <p>Archivos creados:</p>
-<pre><code><span class="cm">✔  public/admin/kullanicilar.php</span>
-<span class="cm">✔  public/assets/css/admin/kullanicilar.css</span>
-<span class="cm">✔  public/assets/js/admin/kullanicilar.js</span></code></pre>
+<pre><code><span class="cm">✔ público/admin/usuarios.php</span>
+<span class="cm">✔ público/activos/css/admin/users.css</span>
+<span class="cm">✔ público/activos/js/admin/users.js</span></code></pre>
 <p>Al comienzo del archivo de vista creado, se requiere ViewControl, se agregan inclusiones de encabezado/encabezado/pie de página y los enlaces CSS/JS están conectados con eliminación de caché.</p>
 </section>
-<!-- make:api -->
+hacer:api
 <section id="cli-api">
-<h2><code>make:api</code> <span class="tag b-cli">CLI Komutu</span></h2>
-<p>Crea un archivo de punto final API eligiendo una de dos plantillas diferentes. Con cada nuevo archivo API <code class="ic">$allowedMethods</code> variables y <code class="ic">ApiControl.php</code> Viene con el requisito listo.</p>
+<h2><code>make:api</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Crea un archivo de punto final API eligiendo una de dos plantillas diferentes. Con cada nuevo archivo API<code class="ic">$allowedMethods</code>variables y<code class="ic">ApiControl.php</code>Viene con el requisito listo.</p>
 <div class="card">
-<h3><span class="badge b-api">standart</span> — API de acción única</h3>
+<h3><span class="badge b-api">estándar</span>— API de acción única</h3>
 <p>Para puntos finales que realizan un solo trabajo (iniciar sesión, enviar, eliminar). La lógica empresarial se escribe directamente.</p>
-<pre><code>artiframe&gt; <span class="fn">make:api</span> <span class="st">standart</span> <span class="st">api/auth/giris.php</span></code></pre>
+<pre><code>artiframe&gt; <span class="fn">hacer:api</span> <span class="st">estándar</span> <span class="st">api/auth/login.php</span></code></pre>
 <pre><code><span class="kw">&lt;?php</span>
-<span class="var">$allowedMethods</span> = [<span class="st">'POST'</span>]; <span class="cm">// Sadece POST kabul et</span>
-<span class="fn">require_once</span> <span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/../app/ApiControl.php'</span>;
-<span class="kw">use</span> Bin\SystemMethod;
-<span class="cm">// İş mantığı buraya...</span>
-<span class="fn">jsonResponse</span>([<span class="st">'status'</span> =&gt; <span class="st">'success'</span>], <span class="nu">200</span>);</code></pre>
+<span class="var">$métodos permitidos</span> = [<span class="st">'CORREO'</span>]; <span class="cm">// Acepta solo POST</span>
+<span class="fn">requerir_una vez</span> <span class="var">$_SERVIDOR</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/../app/ApiControl.php'</span>;
+<span class="kw">usar</span> Bin\SystemMethod;
+<span class="cm">//Lógica de negocios aquí...</span>
+<span class="fn">jsonRespuesta</span>([<span class="st">'estado'</span> =&gt; <span class="st">'éxito'</span>], <span class="nu">200</span>);</code></pre>
 </div>
 <div class="card">
-<h3><span class="badge b-api">switch-case</span> — API de acción múltiple</h3>
-<p>Una estructura que gestiona las operaciones CRUD para un módulo en un único punto final. <code class="ic">action</code> El parámetro determina qué operación se realizará.</p>
-<pre><code>artiframe&gt; <span class="fn">make:api</span> <span class="st">switch-case</span> <span class="st">api/kullanici/yonet.php</span></code></pre>
+<h3><span class="badge b-api">caja de interruptor</span>— API de acción múltiple</h3>
+<p>Una estructura que gestiona las operaciones CRUD para un módulo en un único punto final.<code class="ic">action</code>El parámetro determina qué operación se realizará.</p>
+<pre><code>artiframe&gt; <span class="fn">hacer:api</span> <span class="st">caja de interruptor</span> <span class="st">api/usuario/admin.php</span></code></pre>
 <pre><code><span class="kw">&lt;?php</span>
-<span class="var">$allowedMethods</span> = [<span class="st">'POST'</span>];
-<span class="fn">require_once</span> <span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/../app/ApiControl.php'</span>;
-<span class="kw">use</span> Bin\SystemMethod;
-<span class="var">$action</span> = <span class="fn">sanitizeString</span>(<span class="var">$_POST</span>[<span class="st">'action'</span>] ?? <span class="st">''</span>);
-<span class="kw">switch</span> (<span class="var">$action</span>) {
-    <span class="kw">case</span> <span class="st">'create'</span>:
-        <span class="fn">jsonResponse</span>([<span class="st">'status'</span> =&gt; <span class="st">'success'</span>, <span class="st">'message'</span> =&gt; <span class="st">'Oluşturuldu.'</span>], <span class="nu">200</span>);
-        <span class="kw">break</span>;
-    <span class="kw">case</span> <span class="st">'update'</span>:
-        <span class="fn">jsonResponse</span>([<span class="st">'status'</span> =&gt; <span class="st">'success'</span>, <span class="st">'message'</span> =&gt; <span class="st">'Güncellendi.'</span>], <span class="nu">200</span>);
-        <span class="kw">break</span>;
-    <span class="kw">case</span> <span class="st">'delete'</span>:
-        <span class="fn">jsonResponse</span>([<span class="st">'status'</span> =&gt; <span class="st">'success'</span>, <span class="st">'message'</span> =&gt; <span class="st">'Silindi.'</span>], <span class="nu">200</span>);
-        <span class="kw">break</span>;
-    <span class="kw">default</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">'Geçersiz action.'</span>], <span class="nu">400</span>);
+<span class="var">$métodos permitidos</span> = [<span class="st">'CORREO'</span>];
+<span class="fn">requerir_una vez</span> <span class="var">$_SERVIDOR</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/../app/ApiControl.php'</span>;
+<span class="kw">usar</span> Bin\SystemMethod;
+<span class="var">$acción</span> = <span class="fn">desinfectarString</span>(<span class="var">$_POST</span>[<span class="st">'acción'</span>] ?? <span class="st">''</span>);
+<span class="kw">cambiar</span> (<span class="var">$acción</span>) {
+    <span class="kw">caso</span> <span class="st">'crear'</span>:
+        <span class="fn">jsonRespuesta</span>([<span class="st">'estado'</span> =&gt; <span class="st">'éxito'</span>, <span class="st">'mensaje'</span> =&gt; <span class="st">'Creado.'</span>], <span class="nu">200</span>);
+        <span class="kw">romper</span>;
+    <span class="kw">caso</span> <span class="st">'actualizar'</span>:
+        <span class="fn">jsonRespuesta</span>([<span class="st">'estado'</span> =&gt; <span class="st">'éxito'</span>, <span class="st">'mensaje'</span> =&gt; <span class="st">'Actualizado.'</span>], <span class="nu">200</span>);
+        <span class="kw">romper</span>;
+    <span class="kw">caso</span> <span class="st">'borrar'</span>:
+        <span class="fn">jsonRespuesta</span>([<span class="st">'estado'</span> =&gt; <span class="st">'éxito'</span>, <span class="st">'mensaje'</span> =&gt; <span class="st">'Eliminado'.</span>], <span class="nu">200</span>);
+        <span class="kw">romper</span>;
+    <span class="kw">por defecto</span>:
+        <span class="fn">jsonRespuesta</span>([<span class="st">'estado'</span> =&gt; <span class="st">'error'</span>, <span class="st">'mensaje'</span> =&gt; <span class="st">'Acción inválida.'</span>], <span class="nu">400</span>);
 }</code></pre>
 </div>
 </section>
-<!-- make:class -->
+hacer: clase
 <section id="cli-class">
-<h2><code>make:class</code> <span class="tag b-cli">CLI Komutu</span></h2>
-<p>Crea un nuevo archivo de clase PHP con el espacio de nombres y el modelo estándar de clase listos. El espacio de nombres se determina automáticamente según la ruta de clases. Si <strong>aplicación/</strong> Y <strong>src/</strong> afuera (por ejemplo <strong>privado/</strong>) si se utiliza un directorio, la herramienta CLI se ejecuta en segundo plano <code>composer dump-autoload</code> ejecuta automáticamente el script.</p>
-<pre><code>artiframe&gt; <span class="fn">make:class</span> <span class="st">src/Service/EmailService.php</span></code></pre>
+<h2><code>make:class</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Crea un nuevo archivo de clase PHP con el espacio de nombres y el modelo estándar de clase listos. El espacio de nombres se determina automáticamente según la ruta de clase. Si<strong>aplicación/</strong>Y<strong>src/</strong>afuera (por ejemplo<strong>privado/</strong>) si se utiliza un directorio, la herramienta CLI se ejecuta en segundo plano<code>composer dump-autoload</code>ejecuta automáticamente el script.</p>
+<pre><code>artiframe&gt; <span class="fn">hacer: clase</span> <span class="st">src/Servicio/EmailService.php</span></code></pre>
 <p>Si no se especifica el directorio de clase, el comando devuelve un error:</p>
-<pre><code>artiframe&gt; <span class="fn">make:class</span>
+<pre><code>artiframe&gt; <span class="fn">hacer: clase</span>
 ❌ Hata: Sınıfın oluşturulacağı dizin belirtilmeli! (örn: /app veya /src)
 Example: /src/Service/PaymentService</code></pre>
 </section>
-    <!-- table: -->
-    <section id="cli-table">
-        <h2><code>table:</code> <span class="tag b-cli">Comando CLI</span></h2>
-        <p>Le permite agregar rápidamente tablas de base de datos estándar y relacionales al archivo <code>schema.sql</code> de su proyecto. Las plantillas se leen desde el archivo global <code>stubs/sql.stub</code>.</p>
-        <pre><code>artiframe&gt; <span class="fn">table:</span><span class="st">users</span></code></pre>
-        <p>Tablas estándar actualmente compatibles:</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;">Comandos Adicionales</h3>
-        <p><strong>Listar Tablas:</strong> Para ver todas las plantillas de tablas disponibles y sus descripciones:</p>
-        <pre><code>artiframe&gt; <span class="fn">table</span> <span class="st">list</span></code></pre>
-        <p><strong>Vista previa del contenido de la tabla:</strong> Para inspeccionar el contenido SQL en la terminal antes de agregarlo al archivo <code>schema.sql</code>, puede agregar el parámetro <code>check</code>:</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 -->
+mesa:
+<section id="cli-table">
+<h2><code>table:</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>en tu proyecto<code>schema.sql</code>Le permite agregar rápidamente tablas de bases de datos estándar y relacionales al archivo. Plantillas globales<code>stubs/sql.stub</code>se lee del archivo.</p>
+<pre><code>artiframe&gt; <span class="fn">mesa:</span><span class="st">usuarios</span></code></pre>
+<p>Tablas estándar actualmente soportadas:</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;">usuarios</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;">sesiones_de_usuario</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;">preferencias_de_usuario</button>
+</div>
+Pestaña: usuarios
+<div class="table-tab-content" id="tab-users" style="display: block;">
+<pre><code><span class="kw">CREAR TABLA `usuarios` (
+  `id` binario(16) NO NULO,
+  `correo electrónico` varchar(255) NO NULO,
+  `contraseña` varchar(255) NO NULO,
+  `nombre` varchar(255) POR DEFECTO NULO,
+  `role` enum('usuario','admin','moderador') NOT NULL DEFAULT 'usuario',
+  `status` tinyint(1) NOT NULL DEFAULT '1',
+  Marca de tiempo `created_at` NULL DEFAULT CURRENT_TIMESTAMP,
+  Marca de tiempo `updated_at` NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  CLAVE PRIMARIA (`id`),
+  CLAVE ÚNICA `correo electrónico` (`correo electrónico`)
+) MOTOR=InnoDB CONJUNTO DE CARACTERES PREDETERMINADO=utf8mb4 COLLATE=utf8mb4_unicode_ci;</span></code></pre>
+</div>
+Pestaña: sesiones_usuario
+<div class="table-tab-content" id="tab-sessions" style="display: none;">
+<pre><code><span class="kw">CREAR TABLA `sesiones_usuario` (
+  `id` binario(16) NO NULO,
+  `user_id` binario(16) NO NULO,
+  `token` varchar(255) NO NULO,
+  `dirección_ip` varchar(45) POR DEFECTO NULO,
+  `user_agent` varchar(255) POR DEFECTO NULO,
+  `expires_at` marca de tiempo NULL DEFAULT NULL,
+  Marca de tiempo `created_at` NULL DEFAULT CURRENT_TIMESTAMP,
+  CLAVE PRIMARIA (`id`),
+  CLAVE ÚNICA `token` (`token`),
+  CLAVE `user_id` (`user_id`),
+  RESTRICCIÓN `fk_user_sessions_user_id` CLAVE EXTRANJERA (`user_id`) REFERENCIAS `usuarios` (`id`) AL ELIMINAR CASCADA AL ACTUALIZAR CASCADA
+) MOTOR=InnoDB CONJUNTO DE CARACTERES PREDETERMINADO=utf8mb4 COLLATE=utf8mb4_unicode_ci;</span></code></pre>
+</div>
+Pestaña: preferencias_usuario
+<div class="table-tab-content" id="tab-prefs" style="display: none;">
+<pre><code><span class="kw">CREAR TABLA `preferencias_usuario` (
+  `id` binario(16) NO NULO,
+  `user_id` binario(16) NO NULO,
+  `idioma` varchar(10) NO NULO POR DEFECTO 'tr',
+  `theme` varchar(20) NOT NULL DEFAULT 'ligero',
+  `push_notifications` tinyint(1) NOT NULL DEFAULT '1',
+  `email_notifications` tinyint(1) NOT NULL DEFAULT '1',
+  Marca de tiempo `created_at` NULL DEFAULT CURRENT_TIMESTAMP,
+  Marca de tiempo `updated_at` NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  CLAVE PRIMARIA (`id`),
+  CLAVE ÚNICA `user_id` (`user_id`),
+  RESTRICCIÓN `fk_user_prefs_user_id` CLAVE EXTRANJERA (`user_id`) REFERENCIAS `usuarios` (`id`) AL ELIMINAR CASCADA AL ACTUALIZAR CASCADA
+) MOTOR=InnoDB CONJUNTO DE CARACTERES PREDETERMINADO=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;">Comandos adicionales</h3>
+<p><strong>Tablas de listado:</strong>Para ver todas las plantillas y descripciones de tablas disponibles:</p>
+<pre><code>artiframe&gt; <span class="fn">mesa</span> <span class="st">lista</span></code></pre>
+<p><strong>Vista previa del contenido de la tabla:</strong>una pintura<code>schema.sql</code>al final del comando para examinar el contenido de SQL en la terminal antes de agregarlo al archivo.<code>check</code>Puedes agregar el parámetro:</p>
+<pre><code>artiframe&gt; <span class="fn">mesa:</span><span class="st">usuarios</span> <span class="st">controlar</span></code></pre>
+</section>
+mejora
+cliv
 <section id="cli-cliv">
-<h2><code>cli v</code> (o <code>cli version</code>) <span class="tag b-cli">CLI Komutu</span></h2>
-<p>ArtiFrame CLI controla su propia versión (global) de la herramienta. No solo muestra la versión actual, <strong>Registro del MNP</strong> También comprueba si está disponible la versión más actualizada. Si hay una nueva versión, puede actualizarse globalmente con un clic (sí/no).<code>npm install -g @artilingo/artiframe-cli@latest</code>).</p>
-<pre><code>artiframe&gt; <span class="fn">cli v</span>
-<span class="cm">  Mevcut Sürüm : v1.0.0
-  Güncel Sürüm : v1.0.1
-  Yeni bir güncelleme mevcut! v1.0.0 → v1.0.1
-  Şimdi güncellemek ister misiniz? (y/n)</span> <span class="st">y</span>
-<span class="cm">  Güncelleniyor...
-  ✅ CLI başarıyla güncellendi!</span></code></pre>
+<h2><code>cli v</code>(o<code>cli version</code>) <span class="tag b-cli">Comando CLI</span></h2>
+<p>ArtiFrame CLI controla su propia versión (global) de la herramienta. No solo muestra la versión actual,<strong>Registro del MNP</strong>También comprueba si está disponible la versión más actualizada. Si hay una nueva versión, puede actualizarse globalmente con un clic (sí/no).<code>npm install -g @artilingo/artiframe-cli@latest</code>).</p>
+<pre><code>artiframe&gt; <span class="fn">cliv</span>
+<span class="cm">Versión actual: v1.0.0
+  Versión actual: v1.0.1
+  ¡Hay una nueva actualización disponible! v1.0.0 → v1.0.1
+  ¿Quieres actualizar ahora? (t/n)</span> <span class="st">y</span>
+<span class="cm">Actualizando...
+  ✅ ¡CLI actualizado exitosamente!</span></code></pre>
 </section>
-<!-- show -->
+espectáculo
 <section id="cli-show">
-<h2><code>show</code> <span class="tag b-cli">CLI Komutu</span></h2>
+<h2><code>show</code> <span class="tag b-cli">Comando CLI</span></h2>
 <p>Muestra en qué directorio de trabajo se encuentra actualmente la CLI. Útil para la navegación.</p>
-<pre><code>artiframe&gt; <span class="fn">show</span>
+<pre><code>artiframe&gt; <span class="fn">espectáculo</span>
   📍  Mevcut Çalışma Dizini:
       C:\projeler\benim_projem</code></pre>
 </section>
-<!-- list -->
+lista
 <section id="cli-list">
-<h2><code>list</code> <span class="tag b-cli">CLI Komutu</span></h2>
+<h2><code>list</code> <span class="tag b-cli">Comando CLI</span></h2>
 <p>Enumera los archivos y carpetas en el directorio actual en una estructura de árbol en orden de prioridad. Muestra la cantidad de elementos dentro de las carpetas y los tamaños de los archivos.</p>
-<pre><code>artiframe&gt; <span class="fn">list</span>
+<pre><code>artiframe&gt; <span class="fn">lista</span>
   📂 benim_projem/
   │  ├── 📂 src/  (5 öğe)
   │  ├── 📂 public/  (4 öğe)
   │  ├── 📄 composer.json  [1.2 KB]
   │  └── 📄 README.md  [4.5 KB]</code></pre>
 </section>
-<!-- go -->
+ir
 <section id="cli-go">
-<h2><code>go</code> <span class="tag b-cli">CLI Komutu</span></h2>
+<h2><code>go</code> <span class="tag b-cli">Comando CLI</span></h2>
 <p>Le permite navegar entre directorios mientras se encuentra en el shell interactivo de la CLI. No tiene un efecto permanente a nivel del sistema operativo, pero cambia su directorio de trabajo siempre que la CLI permanezca abierta.</p>
-<pre><code>artiframe&gt; <span class="fn">go</span> <span class="st">public</span>
+<pre><code>artiframe&gt; <span class="fn">ir</span> <span class="st">público</span>
   ✅  Dizin başarıyla değiştirildi.
       C:\projeler\benim_projem\public
-artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
+artiframe&gt; <span class="fn">ir</span> <span class="st">atrás</span>
   ✅  Dizin başarıyla değiştirildi.
       C:\projeler\benim_projem</code></pre>
 </section>
-<!-- remove -->
+eliminar
 <section id="cli-remove">
-<h2><code>remove</code> <span class="tag b-cli">CLI Komutu</span></h2>
-<p>Elimina de forma segura un archivo específico. <code>make</code> Funciona de manera opuesta a los comandos y analiza las dependencias en el proyecto y da advertencias antes de la eliminación:</p>
+<h2><code>remove</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Elimina de forma segura un archivo específico.<code>make</code>Funciona de manera opuesta a los comandos y analiza las dependencias en el proyecto y da advertencias antes de la eliminación:</p>
 <ul>
-<li><strong>Si se elimina la vista:</strong> si archivo <code>public/</code> y archivos CSS/JS vinculados a este archivo <code>public/assets</code> Si los hay, te preguntará si quieres limpiarlos también.</li>
-<li><strong>Si se elimina la clase:</strong> si archivo <code>src/</code> o <code>app/</code> si está debajo, <code>public/api/</code> escanea el directorio. Le advierte imprimiendo los extremos de la API y los números de línea en los que se utiliza la clase que eliminó, pero no elimina las API automáticamente (por razones de seguridad, debe editar manualmente las API relevantes).</li>
+<li><strong>Si se elimina la vista:</strong>si archivo<code>public/</code>y archivos CSS/JS vinculados a este archivo<code>public/assets</code>Si los hay, te preguntará si quieres limpiarlos también.</li>
+<li><strong>Si se elimina la clase:</strong>si archivo<code>src/</code>o<code>app/</code>si está debajo,<code>public/api/</code>escanea el directorio. Le advierte imprimiendo los extremos de la API y los números de línea en los que se utiliza la clase que eliminó, pero no elimina las API automáticamente (por razones de seguridad, debe editar manualmente las API relevantes).</li>
 </ul>
-<pre><code>artiframe&gt; <span class="fn">remove</span> <span class="st">src/Auth/UserManager.php</span>
+<pre><code>artiframe&gt; <span class="fn">eliminar</span> <span class="st">src/Auth/UserManager.php</span>
 ⚠️  Bu dosyayı KÖKTEN silmek üzeresiniz. Emin misiniz? C:\...\src\Auth\UserManager.php [y/N]: y
 🚨 DİKKAT: Sildiğiniz UserManager sınıfı şu API dosyalarında kullanılıyor:
    -&gt; C:\...\public\api\auth\login.php (Satır: 12)
    -&gt; C:\...\public\api\auth\register.php (Satır: 15)
 📌 Yukarıdaki API dosyalarındaki ilgili satırları kendiniz düzenlemeli veya silmelisiniz.
 ✅ Dosya başarıyla silindi: C:\...\src\Auth\UserManager.php</code></pre>
 </section>
-<!-- version -->
+versión
 <section id="cli-version">
-<h2><code>version</code> <span class="tag b-cli">CLI Komutu</span></h2>
-<p><code class="ic">config/app-version.php</code> Actualiza el número de versión de acuerdo con las reglas de control de versiones semánticas (SemVer). Formato de versión: <strong>PARCHE.MAYOR.MENOR.</strong></p>
+<h2><code>version</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p><code class="ic">config/app-version.php</code>Actualiza el número de versión de acuerdo con las reglas de control de versiones semánticas (SemVer). Formato de versión:<strong>PARCHE.MAYOR.MENOR.</strong></p>
 <table class="sig-table">
 <thead>
 <tr><th>dominio</th><th>Explicación</th><th>Ejemplo</th></tr>
@@ -947,52 +950,76 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
 <tr><td>versión degradada mayor</td><td>Deshacer el último gran</td><td>2.0.0 → 1.0.0</td></tr>
 </tbody>
 </table>
-<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>
+<pre><code>artiframe&gt; <span class="fn">versión</span> upgrade minor
+<span class="cm">✔ Actualizado a la Versión 1.2.0 → 1.3.0.</span></code></pre>
 </section>
-    <!-- mode -->
-    <section id="cli-mode">
-        <h2><code>mode</code> <span class="tag b-cli">Comando CLI</span></h2>
-        <p>Le permite cambiar el modo de funcionamiento del proyecto (Desarrollo o Producción) con un solo comando. Esto le ahorra la molestia de abrir y editar manualmente el archivo <code>config/app-version.php</code>.</p>
-        <pre><code>artiframe&gt; <span class="fn">mode</span> <span class="st">1</span>
-  ✅ Cambiado del modo Prod al modo Debug.</code></pre>
-        <p>Puede utilizar el parámetro <code>0</code> para cambiar al lanzamiento de producción:</p>
-        <pre><code>artiframe&gt; <span class="fn">mode</span> <span class="st">0</span></code></pre>
-    </section>
-    <!-- serve -->
+modo
+<section id="cli-mode">
+<h2><code>mode</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Te permite cambiar el modo de trabajo del proyecto (Desarrollo o Live) con un solo comando. Este comando puede ser manualmente<code>config/app-version.php</code>Le ahorra la molestia de abrir y editar el archivo.</p>
+<pre><code>artiframe&gt; <span class="fn">modo</span> <span class="st">1</span>
+  ✅ Prod modundan Debug moduna geçiş yapıldı.</code></pre>
+<p>Para cambiar a la versión en vivo<code>0</code>Puedes usar el parámetro:</p>
+<pre><code>artiframe&gt; <span class="fn">modo</span> <span class="st">0</span></code></pre>
+</section>
+atender
 <section id="cli-serve">
-<h2><code>serve</code> <span class="tag b-cli">CLI Komutu</span></h2>
-<p>Inicia un servidor de desarrollo local (localhost) para probar el proyecto. Lanza tu proyecto en segundos y lo abre automáticamente en tu navegador, sin necesidad de instalar un servidor web adicional (XAMPP, Nginx, etc.).</p>
-<pre><code>artiframe&gt; <span class="fn">serve</span>
-  🚀  Geliştirme sunucusu başlatılıyor: http://localhost:8000
-      Durdurmak için CTRL+C tuşlarına basın.</code></pre>
+<h2><code>serve</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Para probar el proyecto, inicia un servidor de desarrollo local y lo abre en la red local (red local) a través de 0.0.0.0 (todas las interfaces de red). Lanza tu proyecto en segundos sin necesidad de instalar un servidor web adicional (XAMPP, Nginx, etc.), abre automáticamente la pestaña localhost en tu propia computadora e imprime la IP de conexión para otros dispositivos en la red (teléfono/tableta) en la pantalla.</p>
+<pre><code>artiframe&gt; <span class="fn">atender</span>
+  🚀  Geliştirme sunucusu başlatıldı: 0.0.0.0:8000
+      Durdurmak için CTRL+C tuşlarına basın.
+      Local:   http://localhost:8000
+      Network: http://192.168.1.34:8000</code></pre>
 <p>Puede especificar un número de puerto diferente si desea:</p>
-<pre><code>artiframe&gt; <span class="fn">serve</span> <span class="st">8080</span></code></pre>
+<pre><code>artiframe&gt; <span class="fn">atender</span> <span class="st">8080</span></code></pre>
+</section>
+autenticación
+<section id="cli-auth">
+<h2><code>auth</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>El problema autoriza a la CLI con su cuenta de GitHub (a través de OAuth Device Flow) a poder enviar sugerencias e informes de errores.</p>
+<pre><code>artiframe&gt; <span class="fn">autenticación</span></code></pre>
+<p>Este comando imprime un código de usuario y abre la página de autorización de GitHub en su navegador. Una vez confirmada la autorización, el token se almacena de forma segura.</p>
+</section>
+sugerir
+<section id="cli-suggest">
+<h2><code>suggest</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Le permite enviar solicitudes de funciones, informes de errores o sugerencias directamente a GitHub sin salir de la terminal. antes<code>auth</code>Es obligatorio iniciar sesión con el comando.</p>
+<pre><code>artiframe&gt; <span class="fn">sugerir</span></code></pre>
+<p>El script le solicita de forma interactiva que seleccione una categoría, escriba un título e ingrese una descripción detallada. Una vez completado, se publica como un Issue en el repositorio oficial de ArtiFrame.</p>
 </section>
-<!-- add -->
+asuntos
+<section id="cli-issues">
+<h2><code>issues</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Enumere los problemas que ha enviado y lea sus comentarios directamente desde su terminal.<code>auth</code>Requiere iniciar sesión con el comando.</p>
+<pre><code>artiframe&gt; <span class="fn">asuntos</span> [id]</code></pre>
+<p>Para ver una lista de sus problemas<code>issues</code>ejecutarlo. Para ver los detalles y comentarios del número 4<code>issues 4</code>ejecutarlo.</p>
+</section>
+agregar
 <section id="cli-add">
-<h2><code>add</code> <span class="tag b-cli">CLI Komutu</span></h2>
-<p>Es el comando más poderoso que le permite incluir módulos externos o integraciones listas para usar en su proyecto. Clásico <code>composer require</code> Yendo más allá del proceso, crea clases de servicio automáticas (stubs) para algunos módulos y <code>.env</code> Automáticamente realiza las definiciones necesarias para sus archivos.</p>
-<pre><code>artiframe&gt; <span class="fn">add</span> <span class="st">paket_kisa_adi</span></code></pre>
+<h2><code>add</code> <span class="tag b-cli">Comando CLI</span></h2>
+<p>Es el comando más poderoso que le permite incluir módulos externos o integraciones listas para usar en su proyecto. Clásico<code>composer require</code>Yendo más allá del proceso, crea clases de servicio automáticas (stubs) para algunos módulos y<code>.env</code>Automáticamente realiza las definiciones necesarias para sus archivos.</p>
+<pre><code>artiframe&gt; <span class="fn">agregar</span> <span class="st">paquete_nombre_corto</span></code></pre>
 <h3>1. Paquetes integrados (dependientes de la clase)</h3>
-<p>Cuando se instalan estos paquetes, se crea automáticamente una clase de servicio y <code>.env</code> Las claves de conexión se agregan a su archivo. A continuación se enumeran las ubicaciones de estos paquetes y las clases que crean:</p>
+<p>Cuando se instalan estos paquetes, se crea automáticamente una clase de servicio y<code>.env</code>Las claves de conexión se agregan a su archivo. Estos paquetes y las ubicaciones de las clases que crean se enumeran a continuación:</p>
 <div class="table-wrapper">
 <table class="sig-table">
 <thead>
 <tr><th>dominio</th><th>Paquete de compositor</th><th>Archivo de clase generado</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>base de fuego/php-jwt</td><td><span class="tag b-core">src/Auth/JwtAuth.php</span></td></tr>
-<tr><td><code>add image</code></td><td>intervención/imagen</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>
+<tr><td><code>add phpmailer</code></td><td>phpmailer/phpmailer</td><td><span class="tag b-core">src/Servicio/Mailer.php</span></td></tr>
+<tr><td><code>add iyzico</code></td><td>iyzipay/iyzipay-php</td><td><span class="tag b-core">src/Servicio/Iyzico.php</span></td></tr>
+<tr><td><code>add stripe</code></td><td>raya/raya-php</td><td><span class="tag b-core">src/Servicio/Stripe.php</span></td></tr>
+<tr><td><code>add qrcode</code></td><td>endroid/código qr</td><td><span class="tag b-core">src/Servicio/QrCode.php</span></td></tr>
+<tr><td><code>add jwt</code></td><td>base de fuego/php-jwt</td><td><span class="tag b-core">src/Auth/JwtAuth.php</span></td></tr>
+<tr><td><code>add image</code></td><td>intervención/imagen</td><td><span class="tag b-core">src/Servicio/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/Servicio/S3Storage.php</span></td></tr>
+<tr><td><code>add sentry</code></td><td>centinela/centinela</td><td><span class="tag b-core">src/Servicio/Sentry.php</span></td></tr>
 <tr><td><code>add redis</code></td><td>predis/predis</td><td><span class="tag b-core">src/Service/RedisCache.php</span></td></tr>
-<tr><td><code>add pusher</code></td><td>empujador/empujador-php-servidor</td><td><span class="tag b-core">src/Service/Pusher.php</span></td></tr>
-<tr><td><code>add twilio</code></td><td>twilio/sdk</td><td><span class="tag b-core">src/Service/Twilio.php</span></td></tr>
+<tr><td><code>add pusher</code></td><td>empujador/empujador-php-servidor</td><td><span class="tag b-core">src/Servicio/Pusher.php</span></td></tr>
+<tr><td><code>add twilio</code></td><td>twilio/sdk</td><td><span class="tag b-core">src/Servicio/Twilio.php</span></td></tr>
 </tbody>
 </table>
 </div>
@@ -1004,11 +1031,9 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
 <tr><th>dominio</th><th>Paquete de compositor</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/phphoja de cálculo</td></tr>
-<tr><td><code>add qrcode</code></td><td>endroid/código qr</td></tr>
 <tr><td><code>add guzzle</code></td><td>tragohttp/trago</td></tr>
 <tr><td><code>add uuid</code></td><td>ramsey/uuid</td></tr>
 <tr><td><code>add carbon</code></td><td>nesbot/carbono</td></tr>
@@ -1017,101 +1042,87 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
 </table>
 </div>
 <div class="alert a-info">
-<strong>ℹ️ Consejo:</strong> Para ver la lista completa de instalados o compatibles simplemente abra la terminal <code>add list</code> puedes escribir. Puede encontrar el uso del código de los módulos en el menú "Servicios integrados" a la derecha.
-        </div>
+<strong>ℹ️ Consejo:</strong>Para ver la lista completa de instalados o compatibles simplemente abra la terminal<code>add list</code>puedes escribir. Puede encontrar el uso del código de los módulos en el menú "Servicios integrados" a la derecha.</div>
 </section>
-<!-- ====== ENTEGRE SERVİSLER ====== -->
+====== SERVICIOS INTEGRADOS ======
 <section id="entegre-servisler">
-<h2>Servicios Integrados (Wrapper) <span class="tag b-core">Stubs</span></h2>
-<p>En lugar de utilizar paquetes populares directamente, ArtiFrame <strong>Envoltorio preconfigurado</strong> Ofrece clases para su uso.</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>📌 Clase contenedora (Wrapper):</strong> Al ejecutar <code>add qrcode</code>, se crea la clase <code>src/Service/QrCode.php</code>.</div>
-            <p>Una clase fluida que oculta el complejo proceso de creación de instancias de la biblioteca Endroid QR Code.</p>
-            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Métodos</h3>
-            <ul style="line-height: 1.6; margin-bottom: 20px;">
-                <li><code>->generate('Metin')</code> : Inicia la cadena.</li>
-                <li><code>->size(300)</code> : Tamaño en píxeles.</li>
-                <li><code>->margin(10)</code> : Margen blanco.</li>
-                <li><code>->color('#000000', '#ffffff')</code> : Colores en formato HEX.</li>
-                <li><code>->logo('/path/logo.png', 50, true)</code> : Incrusta un logotipo.</li>
-                <li><code>->format('png')</code> : png o svg.</li>
-                <li><code>->save('/path/save.png')</code> : Guarda el archivo.</li>
-                <li><code>->base64()</code> : Devuelve en base64.</li>
-                <li><code>->output()</code> : Salida directa al navegador.</li>
-            </ul>
-            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Ejemplos</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>📌 Configuración automática de .env:</strong> Cuando ejecuta el comando <code>add phpmailer</code>, la configuración SMTP se agrega automáticamente a su archivo <code>.env</code> y se crea la clase <code>src/Service/Mailer.php</code>.</div>
-            <p>Una clase contenedora (Wrapper) mucho más moderna, fluida y segura que funciona sobre la biblioteca PHPMailer. Todos los métodos de la clase se pueden encadenar (chainable).</p>
-            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Métodos y uso</h3>
-            <ul style="line-height: 1.6; margin-bottom: 20px;">
-                <li><code>->to('mail@adres.com', 'İsim')</code> : Establece a quién se enviará el correo electrónico.</li>
-                <li><code>->cc('mail@adres.com')</code> : Agrega destinatarios de copia de carbón (CC).</li>
-                <li><code>->bcc('mail@adres.com')</code> : Agrega destinatarios de copia oculta (BCC). Los destinatarios principales no pueden ver estas direcciones.</li>
-                <li><code>->subject('Konu')</code> : Establece el asunto (título) del correo electrónico.</li>
-                <li><code>->attach('/path/fatura.pdf', 'Isim.pdf')</code> : Agrega un archivo físico del servidor (o temporal) como archivo adjunto en el correo.</li>
-                <li><code>->embedImage('/path/logo.png', 'logo_cid')</code> : Incrusta una imagen en el correo electrónico para ser utilizada en HTML (<code>&lt;img src="cid:logo_cid"&gt;</code>).</li>
-                <li><code>->html('HTML Kodu')</code> : Establece el contenido HTML. Crea automáticamente una versión de texto sin formato (AltBody).</li>
-                <li><code>->text('Düz Metin')</code> : Se usa si desea enviar el correo electrónico estrictamente como texto sin formato.</li>
-                <li><code>->send()</code> : Completa todas las operaciones encadenadas y envía el correo electrónico a través de SMTP. Lanza una Excepción si hay un error.</li>
-            </ul>
-            <h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Ejemplo avanzado: Plantilla PHP (View) y archivo adjunto dinámico</h3>
-            <p>Si no desea escribir el contenido HTML directamente en cadenas, puede usar <code>ob_start()</code> para incluir un archivo de plantilla PHP externo (que contenga variables) y adjuntar un PDF:</p>
-            <pre><code><span class="kw">use</span> <span class="var">App\Service\Mailer</span>;
-<span class="cm">// 1. Tus datos dinámicos</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. Cargar plantilla HTML externamente (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. Enviar el correo</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">// El cliente no puede ver esto</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>📌 Membresía y claves API:</strong> Para utilizar la infraestructura de pagos de Iyzico <a href="https://www.iyzico.com" style="color: var(--green); font-weight: bold;" target="_blank">iyzico.com</a> (en vivo) o <a href="https://sandbox-merchants.iyzipay.com/" style="color: var(--green); font-weight: bold;" target="_blank">sandbox.iyzipay.com</a> Debe crear una cuenta de vendedor a través de (prueba) y obtener sus claves API/secretas.</div>
+<h2>Servicios Integrados (Wrapper)<span class="tag b-core">talones</span></h2>
+<p>En lugar de utilizar paquetes populares directamente, ArtiFrame<strong>Envoltorio preconfigurado</strong>Ofrece clases para su uso.</p>
+<div class="card" id="svc-qrcode">
+<h2>Código QR</h2>
+<div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Clase inmersiva:</strong> <code>add qrcode</code>cuando ejecutas el comando<code>endroid/qr-code</code>La biblioteca está cargada y<code>src/Service/QrCode.php</code>Se crea la clase contenedora.</div>
+<p>Es una clase moderna y fluida que oculta los difíciles procesos de producción de objetos (Constructor/Escritor) de la biblioteca de Códigos QR de Endroid, donde puedes crear un código QR en una sola línea e incrustar un logotipo en él.</p>
+<h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Métodos y usos</h3>
+<ul style="line-height: 1.6; margin-bottom: 20px;">
+<li><code>-&gt;generate('Metin')</code>: Especifica el texto o URL que se convertirá en un código QR e inicia la cadena.</li>
+<li><code>-&gt;size(300)</code>: Determina el ancho/alto del código QR en píxeles (por ejemplo: 300).</li>
+<li><code>-&gt;margin(10)</code>: Determina el espacio en blanco alrededor del código QR.</li>
+<li><code>-&gt;color('#000000', '#ffffff')</code>: Especifica los colores de primer plano (líneas) y de fondo como código HEX. (p.ej:<code>#000000, #ffffff</code>).</li>
+<li><code>-&gt;logo('/path/logo.png', 50, true)</code>: inserta una imagen (logotipo) en medio del código QR. Recupera la ruta física al logotipo, su tamaño y si se perforará el fondo.</li>
+<li><code>-&gt;format('png')</code>: Determina el formato de salida.<code>png</code>o<code>svg</code>es compatible. Predeterminado: png.</li>
+<li><code>-&gt;save('/path/save.png')</code>: Guarda el código QR creado en un archivo físico en el servidor.</li>
+<li><code>-&gt;base64()</code>: Código QR HTML<code>&lt;img src="..."&gt;</code>Lo devuelve como una cadena base64 para que puedas usarlo directamente dentro de la etiqueta.</li>
+<li><code>-&gt;output()</code>: imprime el código QR directamente en el navegador con los encabezados HTTP adecuados.</li>
+</ul>
+<h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Ejemplos de uso</h3>
+<pre><code><span class="kw">usar</span> <span class="var">Aplicación\Servicio\QrCode</span>;
+<span class="cm">// Ejemplo 1: Imprimir una imagen HTML en la pantalla</span>
+<span class="var">$base64</span> = <span class="var">Código QR</span>::generate(<span class="st">'https://artiframe.dev'</span>)
+    -&gt;<span class="fn">tú</span>(400)
+    -&gt;<span class="fn">logo</span>(<span class="var">$_SERVIDOR</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/activos/logo.png'</span>)
+    -&gt;<span class="fn">base64</span>();
+<span class="kw">eco</span> <span class="st">'&lt;img src="'</span> . <span class="var">$base64</span> . <span class="st">'"alt="QR"&gt;'</span>;
+<span class="cm">// Ejemplo 2: Guardar como PNG físico</span>
+<span class="var">Código QR</span>::generate(<span class="st">'Información VCARD'</span>)
+    -&gt;<span class="fn">color</span>(<span class="st">'#ff0000'</span>, <span class="st">'#ffffff'</span>)
+    -&gt;<span class="fn">ahorrar</span>(<span class="st">'/temp/user_card.png'</span>);
+<span class="cm">// Ejemplo 3: enviar una imagen al navegador como punto final API</span>
+<span class="var">Código QR</span>::generate(<span class="st">'https://artilingo.com'</span>)-&gt;<span class="fn">producción</span>();</code></pre>
+</div>
+<div class="card" id="svc-phpmailer">
+<h2>PHPMailer (correo)</h2>
+<div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Instalación automática de .env:</strong> <code>add phpmailer</code>Configuración de SMTP cuando ejecuta el comando<code>.env</code>agregado automáticamente a su archivo y<code>src/Service/Mailer.php</code>Se crea la clase.</div>
+<p>Es una clase Wrapper mucho más moderna, fluida y segura (protegida por CRLF) que se ejecuta en la biblioteca PHPMailer. Todos los métodos ofrecidos por la clase son encadenables.</p>
+<h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Métodos y usos</h3>
+<ul style="line-height: 1.6; margin-bottom: 20px;">
+<li><code>-&gt;to('mail@adres.com', 'İsim')</code>: determina a quién se enviará el correo electrónico.</li>
+<li><code>-&gt;cc('mail@adres.com')</code>: Agrega destinatarios de información (copia carbón).</li>
+<li><code>-&gt;bcc('mail@adres.com')</code>: Agrega destinatarios de Copia oculta. Los destinatarios principales no pueden ver estas direcciones.</li>
+<li><code>-&gt;subject('Konu')</code>: Determina el título (asunto) del correo electrónico.</li>
+<li><code>-&gt;attach('/path/fatura.pdf', 'Isim.pdf')</code>: Coloca un archivo físico en el servidor (o temporal) en el correo electrónico como archivo adjunto.</li>
+<li><code>-&gt;embedImage('/path/logo.png', 'logo_cid')</code>: Para ser utilizado en HTML dentro del correo electrónico (<code>&lt;img src="cid:logo_cid"&gt;</code>) incrusta imágenes.</li>
+<li><code>-&gt;html('HTML Kodu')</code>: establece el contenido HTML del correo electrónico. Crea automáticamente una versión de texto sin formato (AltBody) por seguridad.</li>
+<li><code>-&gt;text('Düz Metin')</code>: Se utiliza si desea enviar el correo electrónico sólo en texto sin formato.</li>
+<li><code>-&gt;send()</code>: Completa todas las transacciones en la cadena y envía el correo electrónico vía SMTP. Si hay un error, arroja una excepción.</li>
+</ul>
+<h3 style="margin-top:20px; margin-bottom:10px; font-size: 1.1em; color: var(--text-color);">Ejemplo avanzado: plantilla PHP (ver) y envío dinámico de archivos</h3>
+<p>Si no desea escribir el contenido HTML del correo electrónico en una cadena como código espagueti,<code>ob_start()</code>Puede importar un archivo de plantilla PHP externo (con variables dentro) e incrustar un PDF generado por el sistema directamente en el correo electrónico usando:</p>
+<pre><code><span class="kw">usar</span> <span class="var">Aplicación\Servicio\Correo</span>;
+<span class="cm">// 1. Tus datos dinámicos</span>
+<span class="var">$pedidoNo</span> = <span class="st">'#90210'</span>;
+<span class="var">$pdfArchivo</span> = <span class="var">$_SERVIDOR</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/temp/invoice_90210.pdf'</span>;
+<span class="cm">// 2. Cargando la plantilla HTML desde fuera (Búfer de salida)</span>
+<span class="fn">ob_start</span>();
+<span class="kw">requerir_una vez</span> <span class="var">$_SERVIDOR</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/vistas/correo electrónico/pedido.php'</span>;
+<span class="var">$htmlContenido</span> = <span class="fn">ob_get_clean</span>();
+<span class="cm">// 3. Envío del correo electrónico</span>
+<span class="var">Remitente</span>::create()
+    -&gt;<span class="fn">a</span>(<span class="st">'custeri@mail.com'</span>, <span class="st">'Ahmet Yilmaz'</span>)
+    -&gt;<span class="fn">bcc</span>(<span class="st">'archivo@empresa.com'</span>) <span class="cm">// El cliente no puede ver esto</span>
+    -&gt;<span class="fn">sujeto</span>(<span class="st">'Su pedido confirmado:'</span> . <span class="var">$pedidoNo</span>)
+    -&gt;<span class="fn">HTML</span>(<span class="var">$htmlContenido</span>)
+    -&gt;<span class="fn">adjuntar</span>(<span class="var">$pdfArchivo</span>, <span class="st">'Pedido_Factura.pdf'</span>)
+    -&gt;<span class="fn">enviar</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="Servicio pago/con licencia">$</span></h2>
+<div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Membresía y claves API:</strong>Para utilizar la infraestructura de pago de Iyzico<a href="https://www.iyzico.com" style="color: var(--green); font-weight: bold;" target="_blank">iyzico.com</a>(en vivo) o<a href="https://sandbox-merchants.iyzipay.com/" style="color: var(--green); font-weight: bold;" target="_blank">sandbox.iyzipay.com</a>Debe crear una cuenta de vendedor a través de (prueba) y obtener sus claves API/secretas.</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;">
 <strong>Ubicación de la clase:</strong> <code style="color: #4ade80;">src/Service/Iyzico.php</code>
 </div>
 <p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">Servicio de pago Iyzico<br/>Proporciona un contenedor limpio alrededor del SDK iyzipay-php para el procesamiento de pagos.<br/>Flujos 3D Secure, reembolsos, cancelaciones, bóveda de tarjetas y subcomerciantes del mercado.<br/>Variables de entorno requeridas:<br/>IYZICO_API_KEY — Su clave API de iyzico<br/>IYZICO_SECRET_KEY — Tu clave secreta de iyzico<br/>IYZICO_BASE_URL: URL base de API (https://sandbox-api.iyzipay.com o https://api.iyzipay.com)</p>
 <div class="alert a-info" style="margin-bottom: 20px;">
-<strong>ℹ️ Devolución estándar:</strong> Todos los métodos <code>['status' => 'success|error', 'message' => '...', 'data' => [...]]</code> Convierte una cadena estándar en el formato (con excepciones). <strong>en la matriz devuelta en la sección "Retorno esperado" a continuación. <code>data</code> Se muestra la estructura detallada de la clave.</strong>
+<strong>ℹ️ Devolución estándar:</strong>Todos los métodos<code>['status' =&gt; 'success|error', 'message' =&gt; '...', 'data' =&gt; [...]]</code>Convierte una cadena estándar en el formato (con excepciones).<strong>en la matriz devuelta en la sección "Retorno esperado" a continuación.<code>data</code>Se muestra la estructura detallada de la clave.</strong>
 </div>
 <h3>Métodos y ejemplos de uso</h3>
 <div class="accordion-group">
@@ -1153,7 +1164,6 @@ artiframe&gt; <span class="fn">go</span> <span class="st">back</span>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$iyzico = new \Service\Iyzico();
 $response = $iyzico-&gt;pay([
     'price'       =&gt; 150.50,
     'paidPrice'   =&gt; 160.00,
@@ -1186,7 +1196,6 @@ $response = $iyzico-&gt;pay([
         ]
     ]
 ]);
 if ($response['status'] === 'success') {
     $paymentId = $response['data']['paymentId'];
     echo "Ödeme başarılı! ID: " . $paymentId;
@@ -1219,7 +1228,6 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$iyzico = new \Service\Iyzico();
 $response = $iyzico-&gt;threeDSecureInit([
     'price'       =&gt; 500.00,
     'paidPrice'   =&gt; 500.00,
@@ -1253,7 +1261,6 @@ $response = $iyzico-&gt;threeDSecureInit([
         ]
     ]
 ]);
 if ($response['status'] === 'success') {
     // Bankanın 3D doğrulama sayfasına yönlendirecek HTML formu
     echo $response['data']['threeDSHtmlContent'];
@@ -1285,10 +1292,8 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$iyzico = new \Service\Iyzico();
 // Bankadan dönen POST verisi (paymentId ve conversationData vb.)
 $response = $iyzico-&gt;threeDSecureComplete($_POST);
 if ($response['status'] === 'success') {
     echo "3D Doğrulama başarılı, ödeme çekildi: " . $response['data']['paymentId'];
 }</code></pre>
@@ -1319,9 +1324,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$iyzico = new \Service\Iyzico();
 $response = $iyzico-&gt;refund('dummy_data', $price);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1350,9 +1353,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$iyzico = new \Service\Iyzico();
 $response = $iyzico-&gt;cancel('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1388,9 +1389,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$iyzico = new \Service\Iyzico();
 $response = $iyzico-&gt;saveCard($cardData, $email);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1421,9 +1420,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$iyzico = new \Service\Iyzico();
 $response = $iyzico-&gt;listCards($cardUserKey);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1452,9 +1449,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$iyzico = new \Service\Iyzico();
 $response = $iyzico-&gt;checkPayment('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1495,9 +1490,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$iyzico = new \Service\Iyzico();
 $response = $iyzico-&gt;createSubMerchant($data);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1515,14 +1508,14 @@ if ($response['status'] === 'success') {
 </div>
 </div>
 <div class="card" id="svc-stripe">
-<h2>Stripe <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>📌 Membresía y claves API:</strong> Para utilizar la infraestructura de pago global de Stripe <a href="https://stripe.com" style="color: var(--green); font-weight: bold;" target="_blank">Stripe.com</a> Debe crear una cuenta y obtener sus claves pública y secreta desde el panel de desarrollador.</div>
+<h2>Raya<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></h2>
+<div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Membresía y claves API:</strong>Para utilizar la infraestructura de pago global de Stripe<a href="https://stripe.com" style="color: var(--green); font-weight: bold;" target="_blank">raya.com</a>Debe crear una cuenta y obtener sus claves pública y secreta desde el panel de desarrollador.</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;">
 <strong>Ubicación de la clase:</strong> <code style="color: #4ade80;">src/Service/Stripe.php</code>
 </div>
-<p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">Servicio de pago de Stripes<br/>Proporciona un contenedor limpio alrededor del SDK stripe-php para el procesamiento de pagos.<br/>gestión de clientes, suscripciones, creación de productos y manejo de webhooks.<br/>Variables de entorno requeridas:<br/>STRIPE_SECRET_KEY: tu clave API secreta de Stripe<br/>STRIPE_PUBLISHABLE_KEY: tu clave publicable de Stripe (para referencia del front-end)<br/>STRIPE_WEBHOOK_SECRET — Secreto de firma del punto final del Webhook</p>
+<p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">Servicio de pago de rayas<br/>Proporciona un contenedor limpio alrededor del SDK stripe-php para el procesamiento de pagos.<br/>gestión de clientes, suscripciones, creación de productos y manejo de webhooks.<br/>Variables de entorno requeridas:<br/>STRIPE_SECRET_KEY: tu clave API secreta de Stripe<br/>STRIPE_PUBLISHABLE_KEY: tu clave publicable de Stripe (para referencia del front-end)<br/>STRIPE_WEBHOOK_SECRET — Secreto de firma del punto final del Webhook</p>
 <div class="alert a-info" style="margin-bottom: 20px;">
-<strong>ℹ️ Devolución estándar:</strong> Todos los métodos <code>['status' => 'success|error', 'message' => '...', 'data' => [...]]</code> Convierte una cadena estándar en el formato (con excepciones). <strong>en la matriz devuelta en la sección "Retorno esperado" a continuación. <code>data</code> Se muestra la estructura detallada de la clave.</strong>
+<strong>ℹ️ Devolución estándar:</strong>Todos los métodos<code>['status' =&gt; 'success|error', 'message' =&gt; '...', 'data' =&gt; [...]]</code>Convierte una cadena estándar en el formato (con excepciones).<strong>en la matriz devuelta en la sección "Retorno esperado" a continuación.<code>data</code>Se muestra la estructura detallada de la clave.</strong>
 </div>
 <h3>Métodos y ejemplos de uso</h3>
 <div class="accordion-group">
@@ -1541,12 +1534,10 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;createPaymentIntent(199.50, 'usd', [
     'order_id' =&gt; 'ORD-54321',
     'customer_email' =&gt; 'utku@artilingo.com'
 ]);
 if ($response['status'] === 'success') {
     $clientSecret = $response['data']['clientSecret'];
     echo json_encode(['clientSecret' =&gt; $clientSecret]);
@@ -1576,9 +1567,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;confirmPayment('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1597,7 +1586,7 @@ if ($response['status'] === 'success') {
 <details class="accordion" style="margin-bottom: 10px; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; padding: 5px; background: rgba(0,0,0,0.1); box-sizing: border-box; max-width: 100%;">
 <summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">charge(float $amount, string $source, string $currency = 'usd', string $description = '')</code></summary>
 <div class="accordion-content" style="padding: 15px; border-top: 1px solid rgba(255,255,255,0.05); box-sizing: border-box; max-width: 100%; overflow-x: hidden;">
-<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Crear un cargo directo (flujo heredado). Utilice createPaymentIntent() para nuevas integraciones. Este método se proporciona para compatibilidad con versiones anteriores de flujos basados en token/fuente.</p>
+<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Crear un cargo directo (flujo heredado). Utilice createPaymentIntent() para nuevas integraciones. Este método se proporciona para compatibilidad con versiones anteriores de flujos basados en tokens/fuentes.</p>
 <div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
 <div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
@@ -1610,9 +1599,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;charge($amount, $source);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1642,9 +1629,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;refund('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1675,9 +1660,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;createCustomer($email);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1706,9 +1689,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;subscribe('dummy_data', 'dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1737,9 +1718,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;cancelSubscription('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1770,9 +1749,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;createProduct('dummy_data', $price);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1802,9 +1779,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;webhook($payload, $signature);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1833,9 +1808,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$stripe = new \Service\Stripe();
 $response = $stripe-&gt;listPayments();
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1860,7 +1833,7 @@ if ($response['status'] === 'success') {
 </div>
 <p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">Servicio de autenticación JWT<br/>Proporciona un contenedor limpio alrededor de firebase/php-jwt para la generación de tokens,<br/>verificación, actualización e integración de middleware HTTP.<br/>Variables de entorno requeridas:<br/>JWT_SECRET_KEY — Clave secreta utilizada para firmar y verificar tokens<br/>JWT_ALGORITHM: algoritmo de firma (por ejemplo, HS256, HS384, HS512)<br/>JWT_EXPIRY: duración predeterminada del token en segundos (por ejemplo, 3600)</p>
 <div class="alert a-info" style="margin-bottom: 20px;">
-<strong>ℹ️ Devolución estándar:</strong> Todos los métodos <code>['status' => 'success|error', 'message' => '...', 'data' => [...]]</code> Convierte una cadena estándar en el formato (con excepciones). <strong>en la matriz devuelta en la sección "Retorno esperado" a continuación. <code>data</code> Se muestra la estructura detallada de la clave.</strong>
+<strong>ℹ️ Devolución estándar:</strong>Todos los métodos<code>['status' =&gt; 'success|error', 'message' =&gt; '...', 'data' =&gt; [...]]</code>Convierte una cadena estándar en el formato (con excepciones).<strong>en la matriz devuelta en la sección "Retorno esperado" a continuación.<code>data</code>Se muestra la estructura detallada de la clave.</strong>
 </div>
 <h3>Métodos y ejemplos de uso</h3>
 <div class="accordion-group">
@@ -1878,13 +1851,11 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$jwt = new \Auth\JwtAuth();
 $payload = [
     'user_id' =&gt; 1453,
     'role'    =&gt; 'admin',
     'email'   =&gt; 'utku@artilingo.com'
 ];
 $token = $jwt-&gt;generate($payload, 7200);
 echo "Bearer " . $token;</code></pre>
 </div>
@@ -1916,9 +1887,7 @@ echo "Bearer " . $token;</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$jwt = new \Auth\JwtAuth();
 $response = $jwt-&gt;verify('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1950,9 +1919,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$jwt = new \Auth\JwtAuth();
 $response = $jwt-&gt;payload('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -1982,9 +1949,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$jwt = new \Auth\JwtAuth();
 $response = $jwt-&gt;refresh('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2013,9 +1978,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$jwt = new \Auth\JwtAuth();
 $response = $jwt-&gt;isExpired('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2042,9 +2005,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$jwt = new \Auth\JwtAuth();
 $response = $jwt-&gt;getUserId('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2072,9 +2033,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$jwt = new \Auth\JwtAuth();
 $response = $jwt-&gt;generateRefreshToken($payload);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2097,9 +2056,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$jwt = new \Auth\JwtAuth();
 $response = $jwt-&gt;middleware();
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2124,7 +2081,7 @@ if ($response['status'] === 'success') {
 </div>
 <p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">ImageProcessor: contenedor para la imagen de intervención v3.<br/>Proporciona métodos simples para operaciones de imágenes comunes, como<br/>cambio de tamaño, recorte, marcas de agua, conversión de formato y compresión.<br/>Variables ENV requeridas:<br/>IMAGE_DRIVER — "gd" o "imagick" (predeterminado: gd)<br/>IMAGE_QUALITY: calidad JPEG/WebP predeterminada 1-100 (predeterminada: 80)</p>
 <div class="alert a-info" style="margin-bottom: 20px;">
-<strong>ℹ️ Devolución estándar:</strong> Todos los métodos <code>['status' => 'success|error', 'message' => '...', 'data' => [...]]</code> Convierte una cadena estándar en el formato (con excepciones). <strong>en la matriz devuelta en la sección "Retorno esperado" a continuación. <code>data</code> Se muestra la estructura detallada de la clave.</strong>
+<strong>ℹ️ Devolución estándar:</strong>Todos los métodos<code>['status' =&gt; 'success|error', 'message' =&gt; '...', 'data' =&gt; [...]]</code>Convierte una cadena estándar en el formato (con excepciones).<strong>en la matriz devuelta en la sección "Retorno esperado" a continuación.<code>data</code>Se muestra la estructura detallada de la clave.</strong>
 </div>
 <h3>Métodos y ejemplos de uso</h3>
 <div class="accordion-group">
@@ -2144,7 +2101,6 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$img = new \Service\ImageProcessor();
 $success = $img-&gt;resize(
     '/var/www/uploads/orijinal.jpg',
     '/var/www/uploads/resized.jpg',
@@ -2179,9 +2135,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$image = new \Service\ImageProcessor();
 $response = $image-&gt;crop($inputPath, $outputPath, 'dummy_data', $height);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2210,9 +2164,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$image = new \Service\ImageProcessor();
 $response = $image-&gt;thumbnail($inputPath, $outputPath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2250,9 +2202,7 @@ left, center, right, bottom-left, bottom, bottom-right.
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$image = new \Service\ImageProcessor();
 $response = $image-&gt;watermark($inputPath, $outputPath, $watermarkPath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2281,9 +2231,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$image = new \Service\ImageProcessor();
 $response = $image-&gt;toWebp($inputPath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2312,9 +2260,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$image = new \Service\ImageProcessor();
 $response = $image-&gt;compress($inputPath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2343,9 +2289,7 @@ Returns an array with an 'error' key on failure.</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$image = new \Service\ImageProcessor();
 $response = $image-&gt;info($path);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2378,9 +2322,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$image = new \Service\ImageProcessor();
 $response = $image-&gt;rotate($inputPath, $outputPath, $angle);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2408,9 +2350,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$image = new \Service\ImageProcessor();
 $response = $image-&gt;greyscale($inputPath, $outputPath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2427,14 +2367,14 @@ true</code></pre>
 </div>
 </div>
 <div class="card" id="svc-s3">
-<h2>AWS S3 <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>📌 Membresía y claves API:</strong> Para utilizar el depósito S3 <a href="https://aws.amazon.com/s3/" style="color: var(--green); font-weight: bold;" target="_blank">aws.amazon.com/s3</a> Debe abrir una cuenta de AWS a través de , crear un depósito y obtener una clave de acceso y una clave secreta con permiso de acceso programático a través de IAM.</div>
+<h2>AWS S3<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></h2>
+<div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Membresía y claves API:</strong>Para utilizar el depósito S3<a href="https://aws.amazon.com/s3/" style="color: var(--green); font-weight: bold;" target="_blank">aws.amazon.com/s3</a>Debe abrir una cuenta de AWS a través de , crear un depósito y obtener una clave de acceso y una clave secreta con permiso de acceso programático a través de IAM.</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;">
 <strong>Ubicación de la clase:</strong> <code style="color: #4ade80;">src/Service/S3Storage.php</code>
 </div>
 <p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">S3Storage: contenedor para AWS S3 SDK.<br/>Proporciona métodos sencillos para cargar, descargar, eliminar, enumerar,<br/>y administrar archivos en Amazon S3, MinIO, DigitalOcean Spaces o cualquier<br/>Almacenamiento de objetos compatible con S3.<br/>Variables ENV requeridas:<br/>AWS_ACCESS_KEY_ID: clave de acceso de IAM<br/>AWS_SECRET_ACCESS_KEY: clave secreta de IAM<br/>AWS_DEFAULT_REGION: p.ej. "eu-central-1"<br/>AWS_BUCKET: nombre del depósito predeterminado<br/>Variables ENV opcionales:<br/>AWS_ENDPOINT: URL de punto final personalizada (MinIO, Spaces, etc.)</p>
 <div class="alert a-info" style="margin-bottom: 20px;">
-<strong>ℹ️ Devolución estándar:</strong> Todos los métodos <code>['status' => 'success|error', 'message' => '...', 'data' => [...]]</code> Convierte una cadena estándar en el formato (con excepciones). <strong>en la matriz devuelta en la sección "Retorno esperado" a continuación. <code>data</code> Se muestra la estructura detallada de la clave.</strong>
+<strong>ℹ️ Devolución estándar:</strong>Todos los métodos<code>['status' =&gt; 'success|error', 'message' =&gt; '...', 'data' =&gt; [...]]</code>Convierte una cadena estándar en el formato (con excepciones).<strong>en la matriz devuelta en la sección "Retorno esperado" a continuación.<code>data</code>Se muestra la estructura detallada de la clave.</strong>
 </div>
 <h3>Métodos y ejemplos de uso</h3>
 <div class="accordion-group">
@@ -2453,9 +2393,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;upload($localPath, $remotePath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2487,9 +2425,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;uploadFromString($content, $remotePath, $contentType);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2519,9 +2455,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;download($remotePath, $localPath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2548,9 +2482,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;delete($remotePath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2571,15 +2503,13 @@ true</code></pre>
 <div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
 <div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
-<pre style="background: rgba(0,0,0,0.3); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #a78bfa; border: 1px solid rgba(255,255,255,0.05); margin: 0; box-sizing: border-box; max-width: 100%;"><code>@param  array<string> $remotePaths List of object keys to delete.</code></pre>
+<pre style="background: rgba(0,0,0,0.3); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #a78bfa; border: 1px solid rgba(255,255,255,0.05); margin: 0; box-sizing: border-box; max-width: 100%;"><code>@param  array<string>$remotePaths Lista de claves de objetos para eliminar.</string></code></pre>
 </div>
 <div style="display: flex; flex-wrap: wrap; gap: 15px; box-sizing: border-box; width: 100%;">
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;deleteMany($remotePaths);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2606,9 +2536,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;url($remotePath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2636,9 +2564,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;signedUrl($remotePath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2665,9 +2591,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;exists($remotePath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2694,9 +2618,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;list();
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2726,9 +2648,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;copy($from, $to);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2756,9 +2676,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;move($from, $to);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2785,9 +2703,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$s3 = new \Service\S3Storage();
 $response = $s3-&gt;size($remotePath);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2810,7 +2726,7 @@ if ($response['status'] === 'success') {
 </div>
 <p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">Servicio de caché de Redis<br/>Proporciona una interfaz limpia y sencilla para las operaciones de almacenamiento en caché de Redis.<br/>usando el SDK de predis/predis. Toda la configuración se lee desde $_ENV.<br/>Variables de entorno requeridas:<br/>REDIS_HOST: nombre de host del servidor Redis (predeterminado: 127.0.0.1)<br/>REDIS_PORT: puerto del servidor Redis (predeterminado: 6379)<br/>REDIS_PASSWORD: contraseña de autenticación de Redis (predeterminada: nula)<br/>REDIS_DATABASE: índice de la base de datos de Redis (predeterminado: 0)</p>
 <div class="alert a-info" style="margin-bottom: 20px;">
-<strong>ℹ️ Devolución estándar:</strong> Todos los métodos <code>['status' => 'success|error', 'message' => '...', 'data' => [...]]</code> Convierte una cadena estándar en el formato (con excepciones). <strong>en la matriz devuelta en la sección "Retorno esperado" a continuación. <code>data</code> Se muestra la estructura detallada de la clave.</strong>
+<strong>ℹ️ Devolución estándar:</strong>Todos los métodos<code>['status' =&gt; 'success|error', 'message' =&gt; '...', 'data' =&gt; [...]]</code>Convierte una cadena estándar en el formato (con excepciones).<strong>en la matriz devuelta en la sección "Retorno esperado" a continuación.<code>data</code>Se muestra la estructura detallada de la clave.</strong>
 </div>
 <h3>Métodos y ejemplos de uso</h3>
 <div class="accordion-group">
@@ -2828,9 +2744,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;get($key);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2859,9 +2773,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;set($key, $value);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2888,9 +2800,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;has($key);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2917,9 +2827,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;forget($key);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2948,9 +2856,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;remember($key, $ttl, $callback);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -2980,9 +2886,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;increment($key);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3010,9 +2914,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;decrement($key);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3035,9 +2937,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;flush();
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3064,9 +2964,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;keys();
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3095,9 +2993,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;ttl($key);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3125,9 +3021,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;expire($key, $seconds);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3156,9 +3050,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;hSet($hash, $field, $value);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3187,9 +3079,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;hGet($hash, $field);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3218,9 +3108,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;hGetAll($hash);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3250,9 +3138,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$redis = new \Service\RedisCache();
 $response = $redis-&gt;hDel($hash, $field);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3269,14 +3155,14 @@ true</code></pre>
 </div>
 </div>
 <div class="card" id="svc-pusher">
-<h2>arribista <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>📌 Membresía y claves API:</strong> Para comunicarse en tiempo real a través de WebSocket <a href="https://pusher.com" style="color: var(--green); font-weight: bold;" target="_blank">empujador.com</a> Debe crear una aplicación de Canales gratuita y obtener su ID de aplicación, clave e información secreta.</div>
+<h2>arribista<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></h2>
+<div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Membresía y claves API:</strong>Para comunicarse en tiempo real a través de WebSocket<a href="https://pusher.com" style="color: var(--green); font-weight: bold;" target="_blank">empujador.com</a>Debe crear una aplicación de Canales gratuita y obtener su ID de aplicación, clave e información secreta.</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;">
 <strong>Ubicación de la clase:</strong> <code style="color: #4ade80;">src/Service/Pusher.php</code>
 </div>
-<p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">Servicio de empuje en tiempo real<br/>Proporciona una interfaz limpia para Pusher Channels: transmisión de eventos,<br/>autenticar canales privados/de presencia y consultar el estado del canal.<br/>Utiliza el SDK pusher/pusher-php-server. Toda la configuración desde $_ENV.<br/>Variables de entorno requeridas:<br/>PUSHER_APP_ID — Su ID de aplicación Pusher<br/>PUSHER_APP_KEY — Tu clave de aplicación Pusher<br/>PUSHER_APP_SECRET — El secreto de tu aplicación Pusher<br/>PUSHER_CLUSTER — Región del clúster de impulsores (p. ej., 'eu', 'us2', 'ap1')</p>
+<p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">Servicio de empuje en tiempo real<br/>Proporciona una interfaz limpia para Pusher Channels: transmisión de eventos,<br/>autenticar canales privados/presencia y consultar el estado del canal.<br/>Utiliza el SDK pusher/pusher-php-server. Toda la configuración desde $_ENV.<br/>Variables de entorno requeridas:<br/>PUSHER_APP_ID — Su ID de aplicación Pusher<br/>PUSHER_APP_KEY — Tu clave de aplicación Pusher<br/>PUSHER_APP_SECRET — El secreto de tu aplicación Pusher<br/>PUSHER_CLUSTER — Región del clúster de impulsores (p. ej., 'eu', 'us2', 'ap1')</p>
 <div class="alert a-info" style="margin-bottom: 20px;">
-<strong>ℹ️ Devolución estándar:</strong> Todos los métodos <code>['status' => 'success|error', 'message' => '...', 'data' => [...]]</code> Convierte una cadena estándar en el formato (con excepciones). <strong>en la matriz devuelta en la sección "Retorno esperado" a continuación. <code>data</code> Se muestra la estructura detallada de la clave.</strong>
+<strong>ℹ️ Devolución estándar:</strong>Todos los métodos<code>['status' =&gt; 'success|error', 'message' =&gt; '...', 'data' =&gt; [...]]</code>Convierte una cadena estándar en el formato (con excepciones).<strong>en la matriz devuelta en la sección "Retorno esperado" a continuación.<code>data</code>Se muestra la estructura detallada de la clave.</strong>
 </div>
 <h3>Métodos y ejemplos de uso</h3>
 <div class="accordion-group">
@@ -3295,9 +3181,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$pusher = new \Service\Pusher();
 $response = $pusher-&gt;broadcast($channel, $event, $data);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3314,7 +3198,7 @@ true</code></pre>
 <details class="accordion" style="margin-bottom: 10px; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; padding: 5px; background: rgba(0,0,0,0.1); box-sizing: border-box; max-width: 100%;">
 <summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">broadcastToMany(array $channels, string $event, array $data)</code></summary>
 <div class="accordion-content" style="padding: 15px; border-top: 1px solid rgba(255,255,255,0.05); box-sizing: border-box; max-width: 100%; overflow-x: hidden;">
-<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Transmita un evento a múltiples canales simultáneamente. Activa el mismo evento con la misma carga útil en múltiples canales en una única llamada API. Pusher limita esto a un máximo de 100 canales por llamada.</p>
+<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Transmita un evento a múltiples canales simultáneamente. Activa el mismo evento con la misma carga útil en varios canales en una única llamada API. Pusher limita esto a un máximo de 100 canales por llamada.</p>
 <div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
 <div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
@@ -3326,9 +3210,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$pusher = new \Service\Pusher();
 $response = $pusher-&gt;broadcastToMany($channels, $event, $data);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3345,7 +3227,7 @@ true</code></pre>
 <details class="accordion" style="margin-bottom: 10px; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; padding: 5px; background: rgba(0,0,0,0.1); box-sizing: border-box; max-width: 100%;">
 <summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">toUser(string $userId, string $event, array $data)</code></summary>
 <div class="accordion-content" style="padding: 15px; border-top: 1px solid rgba(255,255,255,0.05); box-sizing: border-box; max-width: 100%; overflow-x: hidden;">
-<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Envía un evento a un usuario específico a través de su canal de usuario. Utiliza la función de eventos de usuario de Pusher para entregar un mensaje directamente a un único usuario autenticado, independientemente de a qué canales esté suscrito. El usuario debe haber sido autenticado con un ID de usuario en el lado del cliente.</p>
+<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Enviar un evento a un usuario específico a través de su canal de usuario. Utiliza la función de eventos de usuario de Pusher para entregar un mensaje directamente a un único usuario autenticado, independientemente de a qué canales esté suscrito. El usuario debe haber sido autenticado con un ID de usuario en el lado del cliente.</p>
 <div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
 <div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
@@ -3357,9 +3239,7 @@ true</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$pusher = new \Service\Pusher();
 $response = $pusher-&gt;toUser('dummy_data', $event, $data);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3387,9 +3267,7 @@ Returns empty array on failure</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$pusher = new \Service\Pusher();
 $response = $pusher-&gt;channelInfo($channel);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3419,9 +3297,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$pusher = new \Service\Pusher();
 $response = $pusher-&gt;channels();
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3451,9 +3327,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$pusher = new \Service\Pusher();
 $response = $pusher-&gt;auth('dummy_data', 'dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3483,9 +3357,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$pusher = new \Service\Pusher();
 $response = $pusher-&gt;presenceAuth('dummy_data', 'dummy_data', 'dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3502,14 +3374,14 @@ if ($response['status'] === 'success') {
 </div>
 </div>
 <div class="card" id="svc-twilio">
-<h2>Gorjeo <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>📌 Membresía y claves API:</strong> Para enviar mensajes SMS y WhatsApp <a href="https://www.twilio.com" style="color: var(--green); font-weight: bold;" target="_blank">twilio.com</a> Debe abrir una cuenta en , alquilar un número de teléfono disponible y obtener la información del SID de su cuenta y del token de autenticación del panel.</div>
+<h2>Gorjeo<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></h2>
+<div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Membresía y claves API:</strong>Para enviar mensajes SMS y WhatsApp<a href="https://www.twilio.com" style="color: var(--green); font-weight: bold;" target="_blank">twilio.com</a>Debe abrir una cuenta en , alquilar un número de teléfono disponible y obtener la información del SID de su cuenta y del token de autenticación del panel.</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;">
 <strong>Ubicación de la clase:</strong> <code style="color: #4ade80;">src/Service/Twilio.php</code>
 </div>
 <p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">Servicio de comunicaciones de Twilio<br/>Proporciona una interfaz simplificada para mensajería, voz,<br/>y API de verificación utilizando twilio/sdk. Toda la configuración<br/>se lee desde $_ENV.<br/>Variables de entorno requeridas:<br/>TWILIO_SID: SID de su cuenta Twilio<br/>TWILIO_AUTH_TOKEN: su token de autenticación de Twilio<br/>TWILIO_FROM_NUMBER: número de teléfono predeterminado "de" (formato E.164, por ejemplo, +15551234567)<br/>Variables de entorno opcionales:<br/>TWILIO_VERIFY_SID — Verificar SID del servicio (requerido para verificarStart/verifyCheck)</p>
 <div class="alert a-info" style="margin-bottom: 20px;">
-<strong>ℹ️ Devolución estándar:</strong> Todos los métodos <code>['status' => 'success|error', 'message' => '...', 'data' => [...]]</code> Convierte una cadena estándar en el formato (con excepciones). <strong>en la matriz devuelta en la sección "Retorno esperado" a continuación. <code>data</code> Se muestra la estructura detallada de la clave.</strong>
+<strong>ℹ️ Devolución estándar:</strong>Todos los métodos<code>['status' =&gt; 'success|error', 'message' =&gt; '...', 'data' =&gt; [...]]</code>Convierte una cadena estándar en el formato (con excepciones).<strong>en la matriz devuelta en la sección "Retorno esperado" a continuación.<code>data</code>Se muestra la estructura detallada de la clave.</strong>
 </div>
 <h3>Métodos y ejemplos de uso</h3>
 <div class="accordion-group">
@@ -3522,15 +3394,13 @@ if ($response['status'] === 'success') {
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
 <pre style="background: rgba(0,0,0,0.3); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #a78bfa; border: 1px solid rgba(255,255,255,0.05); margin: 0; box-sizing: border-box; max-width: 100%;"><code>@param  string $to      Recipient phone number in E.164 format (e.g., +905551234567)
 @param  string $message The SMS body text (max 1600 characters)
-On error: 'status' => 'error', 'message' => error description</code></pre>
+On error: 'status' =&gt; 'error', 'message' =&gt; error description</code></pre>
 </div>
 <div style="display: flex; flex-wrap: wrap; gap: 15px; box-sizing: border-box; width: 100%;">
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$twilio = new \Service\Twilio();
 $response = $twilio-&gt;sendSms($to, $message);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3560,9 +3430,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$twilio = new \Service\Twilio();
 $response = $twilio-&gt;sendWhatsApp($to, $message);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3581,7 +3449,7 @@ if ($response['status'] === 'success') {
 <details class="accordion" style="margin-bottom: 10px; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; padding: 5px; background: rgba(0,0,0,0.1); box-sizing: border-box; max-width: 100%;">
 <summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">call(string $to, string $twimlUrl)</code></summary>
 <div class="accordion-content" style="padding: 15px; border-top: 1px solid rgba(255,255,255,0.05); box-sizing: border-box; max-width: 100%; overflow-x: hidden;">
-<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Iniciar una llamada de voz. Realiza una llamada saliente al número especificado. El comportamiento de la llamada está definido por el documento TwiML en la URL proporcionada. La URL de TwiML debería devolver instrucciones como <say>, <play>, <gather>, etc.</gather></play></say></p>
+<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Iniciar una llamada de voz. Realiza una llamada saliente al número especificado. El comportamiento de la llamada está definido por el documento TwiML en la URL proporcionada. La URL de TwiML debería devolver instrucciones como<say>, <play>, <gather>, etc.</gather></play></say></p>
 <div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
 <div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
@@ -3592,9 +3460,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$twilio = new \Service\Twilio();
 $response = $twilio-&gt;call($to, $twimlUrl);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3625,9 +3491,7 @@ status will be 'pending' on success</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$twilio = new \Service\Twilio();
 $response = $twilio-&gt;verifyStart($to);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3658,9 +3522,7 @@ status will be 'approved' on successful verification</code></pre>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$twilio = new \Service\Twilio();
 $response = $twilio-&gt;verifyCheck($to, $code);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3679,7 +3541,7 @@ if ($response['status'] === 'success') {
 <details class="accordion" style="margin-bottom: 10px; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; padding: 5px; background: rgba(0,0,0,0.1); box-sizing: border-box; max-width: 100%;">
 <summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">getMessageStatus(string $messageSid)</code></summary>
 <div class="accordion-content" style="padding: 15px; border-top: 1px solid rgba(255,255,255,0.05); box-sizing: border-box; max-width: 100%; overflow-x: hidden;">
-<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Obtenga el estado de entrega de un mensaje específico. Obtiene el estado actual de un mensaje enviado previamente por su SID único. Posibles estados: en cola, enviando, enviado, entregado, no entregado, fallido</p>
+<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Obtenga el estado de entrega de un mensaje específico. Obtiene el estado actual de un mensaje enviado anteriormente por su SID único. Posibles estados: en cola, enviando, enviado, entregado, no entregado, fallido</p>
 <div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
 <div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
@@ -3690,9 +3552,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$twilio = new \Service\Twilio();
 $response = $twilio-&gt;getMessageStatus('dummy_data');
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3722,9 +3582,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$twilio = new \Service\Twilio();
 $response = $twilio-&gt;listMessages();
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3755,9 +3613,7 @@ if ($response['status'] === 'success') {
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
 <pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$twilio = new \Service\Twilio();
 $response = $twilio-&gt;sendBulkSms($recipients, $message);
 if ($response['status'] === 'success') {
     // Başarılı
 }</code></pre>
@@ -3776,85 +3632,25 @@ if ($response['status'] === 'success') {
 </div>
 </div>
 <div class="card" id="svc-sentry">
-<h2>Sentry <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>📌 Membresía y claves API:</strong> Para habilitar el seguimiento de errores y rendimiento <a href="https://sentry.io" style="color: var(--green); font-weight: bold;" target="_blank">Sentry.io</a> Debe crear su cuenta gratuita a través de, agregar un proyecto PHP y copiar la dirección DSN (Clave de cliente) que se le proporcionó.</div>
+<h2>centinela<span class="tag b-core" style="padding: 1px 5px; margin-left: 2px; font-weight: bold;" title="Servicio pago/con licencia">$</span></h2>
+<div class="alert a-info" style="margin-top: 10px; padding: 10px 15px; font-size: 0.85em;"><strong>📌 Membresía y claves API:</strong>Para habilitar el seguimiento de errores y rendimiento<a href="https://sentry.io" style="color: var(--green); font-weight: bold;" target="_blank">centinela.io</a>Debe crear su cuenta gratuita a través de, agregar un proyecto PHP y copiar la dirección DSN (Clave de cliente) que se le proporcionó.</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;">
-<strong>Ubicación de la clase:</strong> <code style="color: #4ade80;">config/sentry.php</code>
+<strong>Ubicación de la clase:</strong> <code style="color: #4ade80;">src/Service/Sentry.php</code>
 </div>
-<p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;"></p>
+<p style="margin-bottom: 15px; font-size: 0.95em; color: #a1a1aa;">Le permite recopilar errores y advertencias en su proyecto en un sistema de registro central. Al inicio de su solicitud (p. ej.<code>ApiControl.php</code>o<code>ViewControl.php</code>Se recomienda comenzar en .</p>
 <div class="alert a-info" style="margin-bottom: 20px;">
-<strong>ℹ️ Devolución estándar:</strong> Todos los métodos <code>['status' => 'success|error', 'message' => '...', 'data' => [...]]</code> Convierte una cadena estándar en el formato (con excepciones). <strong>en la matriz devuelta en la sección "Retorno esperado" a continuación. <code>data</code> Se muestra la estructura detallada de la clave.</strong>
-</div>
+<strong>ℹ️ Clase estática:</strong>Esta clase de servicio se usa directamente con métodos estáticos, no es necesario crear una nueva instancia.</div>
 <h3>Métodos y ejemplos de uso</h3>
 <div class="accordion-group">
 <details class="accordion" style="margin-bottom: 10px; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; padding: 5px; background: rgba(0,0,0,0.1); box-sizing: border-box; max-width: 100%;">
-<summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">captureError(\Throwable $e)</code></summary>
+<summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">init()</code></summary>
 <div class="accordion-content" style="padding: 15px; border-top: 1px solid rgba(255,255,255,0.05); box-sizing: border-box; max-width: 100%; overflow-x: hidden;">
-<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Configuración de seguimiento de errores de Sentry Inicializa el SDK de Sentry para informar errores y proporciona funciones de ayuda para capturar excepciones y mensajes. Variables ENV requeridas: SENTRY_DSN: nombre de fuente de datos de Sentry (proyecto DSN de sentry.io) Variables ENV opcionales: APP_ENV: "0" para producción, "1" para desarrollo (predeterminado: 0) APP_VERSION: cadena de versión de la aplicación, utilizada como etiqueta de lanzamiento de Sentry Uso: require_once __DIR__. '/sentry.php'; // Capturar una excepción try { ... } catch (\Throwable $e) { $eventId = captureError($e);</p>
+<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Inicializa el SDK de Sentry en función de las variables de entorno. Debe llamarse una vez al comienzo de la aplicación.</p>
 <div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
-<div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
-<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
-<pre style="background: rgba(0,0,0,0.3); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #a78bfa; border: 1px solid rgba(255,255,255,0.05); margin: 0; box-sizing: border-box; max-width: 100%;"><code>}
-// Capture an informational message
-captureMessage('Deployment completed', 'info');
-/
-// ---------------------------------------------------------------
-//  Guard — only initialize when a DSN is available
-// ---------------------------------------------------------------
-if (empty($_ENV['SENTRY_DSN'])) {
-/**
-No-op fallback when Sentry is not configured.
-@param  \Throwable $e The exception (ignored).</code></pre>
-</div>
 <div style="display: flex; flex-wrap: wrap; gap: 15px; box-sizing: border-box; width: 100%;">
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
-<pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$sentry = new \Service\sentry();
-$response = $sentry-&gt;captureError($e);
-if ($response['status'] === 'success') {
-    // Başarılı
-}</code></pre>
-</div>
-<div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
-<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Retorno esperado ($respuesta['datos']):</h4>
-<pre style="background: rgba(69,26,3,0.4); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #facc15; border: 1px solid rgba(250,204,21,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>[
-    'id'      =&gt; '...',
-    'success' =&gt; true
-]</code></pre>
-</div>
-</div>
-</div>
-</div>
-</details>
-<details class="accordion" style="margin-bottom: 10px; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; padding: 5px; background: rgba(0,0,0,0.1); box-sizing: border-box; max-width: 100%;">
-<summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">captureMessage(string $message, string $level = 'info')</code></summary>
-<div class="accordion-content" style="padding: 15px; border-top: 1px solid rgba(255,255,255,0.05); box-sizing: border-box; max-width: 100%; overflow-x: hidden;">
-<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Reserva no operativa cuando Sentry no está configurado.</p>
-<div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
-<div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
-<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
-<pre style="background: rgba(0,0,0,0.3); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #a78bfa; border: 1px solid rgba(255,255,255,0.05); margin: 0; box-sizing: border-box; max-width: 100%;"><code>@param  string $message The message (ignored).
-@param  string $level   Severity level (ignored).</code></pre>
-</div>
-<div style="display: flex; flex-wrap: wrap; gap: 15px; box-sizing: border-box; width: 100%;">
-<div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
-<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
-<pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$sentry = new \Service\sentry();
-$response = $sentry-&gt;captureMessage($message);
-if ($response['status'] === 'success') {
-    // Başarılı
-}</code></pre>
-</div>
-<div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
-<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Retorno esperado ($respuesta['datos']):</h4>
-<pre style="background: rgba(69,26,3,0.4); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #facc15; border: 1px solid rgba(250,204,21,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>[
-    'id'      =&gt; '...',
-    'success' =&gt; true
-]</code></pre>
+<pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>\Src\Service\Sentry::init();</code></pre>
 </div>
 </div>
 </div>
@@ -3863,36 +3659,20 @@ if ($response['status'] === 'success') {
 <details class="accordion" style="margin-bottom: 10px; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; padding: 5px; background: rgba(0,0,0,0.1); box-sizing: border-box; max-width: 100%;">
 <summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">captureError(\Throwable $e)</code></summary>
 <div class="accordion-content" style="padding: 15px; border-top: 1px solid rgba(255,255,255,0.05); box-sizing: border-box; max-width: 100%; overflow-x: hidden;">
-<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">$isProduction = ($_ENV['APP_ENV'] ?? '0') === '0'; /** @var string Nombre de entorno legible por humanos para Sentry */ $environment = $isProduction ? 'producción': 'desarrollo'; /** Frecuencia de muestreo: 1.0: captura el 100 % de los eventos en producción 0.0: no captura nada en desarrollo (use captureError/captureMessage explícitamente) / $sampleRate = $isProduction ? 1,0: 0,0; // ------------------------------------------------------------------------------- // Inicialización de Sentry // ------------------------------------------------------------------------------- $options = [ 'dsn' =&gt; $_ENV['SENTRY_DSN'], 'environment' =&gt; $environment, 'sample_rate' =&gt; $sampleRate, ]; // Adjunte la versión de lanzamiento cuando esté disponible if (!empty($_ENV['APP_VERSION'])) { $options['release'] = $_ENV['APP_VERSION'];</p>
+<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Envía una excepción capturada o un objeto arrojable a Sentry.</p>
 <div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
-<div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
-<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
-<pre style="background: rgba(0,0,0,0.3); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #a78bfa; border: 1px solid rgba(255,255,255,0.05); margin: 0; box-sizing: border-box; max-width: 100%;"><code>}
-\Sentry\init($options);
-// ---------------------------------------------------------------
-//  Helper functions
-// ---------------------------------------------------------------
-/**
-Capture a Throwable and send it to Sentry.
-@param  \Throwable $e The exception or error to report.</code></pre>
-</div>
 <div style="display: flex; flex-wrap: wrap; gap: 15px; box-sizing: border-box; width: 100%;">
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
-<pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$sentry = new \Service\sentry();
-$response = $sentry-&gt;captureError($e);
-if ($response['status'] === 'success') {
-    // Başarılı
+<pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>try {
+    // Hata yapabilecek işlemler...
+} catch (\Throwable $e) {
+    $eventId = \Src\Service\Sentry::captureError($e);
 }</code></pre>
 </div>
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
-<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Retorno esperado ($respuesta['datos']):</h4>
-<pre style="background: rgba(69,26,3,0.4); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #facc15; border: 1px solid rgba(250,204,21,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>[
-    'id'      =&gt; '...',
-    'success' =&gt; true
-]</code></pre>
+<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Retorno esperado (cadena|nulo):</h4>
+<pre style="background: rgba(69,26,3,0.4); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #facc15; border: 1px solid rgba(250,204,21,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>"dfb9370...b86" // Sentry Olay ID'si</code></pre>
 </div>
 </div>
 </div>
@@ -3901,30 +3681,12 @@ if ($response['status'] === 'success') {
 <details class="accordion" style="margin-bottom: 10px; border: 1px solid rgba(255,255,255,0.1); border-radius: 6px; padding: 5px; background: rgba(0,0,0,0.1); box-sizing: border-box; max-width: 100%;">
 <summary style="cursor: pointer; padding: 10px; font-weight: bold; background: rgba(255,255,255,0.05); color: #fff; border-radius: 4px; box-sizing: border-box; max-width: 100%; word-break: break-all;"><code style="background: transparent; color: #60a5fa; font-size: 1.1em; white-space: pre-wrap; word-break: break-all;">captureMessage(string $message, string $level = 'info')</code></summary>
 <div class="accordion-content" style="padding: 15px; border-top: 1px solid rgba(255,255,255,0.05); box-sizing: border-box; max-width: 100%; overflow-x: hidden;">
-<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Capture un mensaje de texto sin formato y envíelo a Sentry. Niveles de gravedad admitidos: fatal, error, advertencia, información, depuración.</p>
+<p style="color: #d1d5db; margin-bottom: 15px; word-wrap: break-word;">Envía un texto específico a Sentry como mensaje de información/advertencia. Niveles válidos:<code>fatal</code>, <code>error</code>, <code>warning</code>, <code>info</code>, <code>debug</code>.</p>
 <div style="display: flex; flex-direction: column; gap: 15px; box-sizing: border-box; width: 100%; max-width: 100%;">
-<div style="flex: 1; max-width: 100%; box-sizing: border-box; overflow: hidden;">
-<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Estructura de parámetros:</h4>
-<pre style="background: rgba(0,0,0,0.3); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #a78bfa; border: 1px solid rgba(255,255,255,0.05); margin: 0; box-sizing: border-box; max-width: 100%;"><code>@param  string $message Human-readable message to log.
-@param  string $level   Sentry severity level (default: info).</code></pre>
-</div>
 <div style="display: flex; flex-wrap: wrap; gap: 15px; box-sizing: border-box; width: 100%;">
 <div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
 <h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Uso de ejemplo:</h4>
-<pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$sentry = new \Service\sentry();
-$response = $sentry-&gt;captureMessage($message);
-if ($response['status'] === 'success') {
-    // Başarılı
-}</code></pre>
-</div>
-<div style="flex: 1; min-width: 250px; max-width: 100%; box-sizing: border-box; overflow: hidden;">
-<h4 style="margin-bottom: 8px; font-size: 0.9em; color: #9ca3af;">Retorno esperado ($respuesta['datos']):</h4>
-<pre style="background: rgba(69,26,3,0.4); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #facc15; border: 1px solid rgba(250,204,21,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>[
-    'id'      =&gt; '...',
-    'success' =&gt; true
-]</code></pre>
+<pre style="background: rgba(15,23,42,0.6); padding: 10px; border-radius: 4px; font-size: 0.85em; overflow-x: auto; color: #34d399; border: 1px solid rgba(52,211,153,0.2); margin: 0; height: 100%; box-sizing: border-box; max-width: 100%;"><code>$eventId = \Src\Service\Sentry::captureMessage('Sipariş başarıyla tamamlandı.', 'info');</code></pre>
 </div>
 </div>
 </div>
@@ -3933,63 +3695,55 @@ if ($response['status'] === 'success') {
 </div>
 </div>
 </section>
-<!-- ====== VIEW HELPERS ====== -->
+====== VER AYUDANTES ======
 <section id="vh-display">
-<h2>Ver ayudantes— <code>display()</code> <span class="tag b-view">ViewMethod</span></h2>
-<p>Al imprimir datos desde la base de datos o la entrada del usuario al DOM <strong>protección XSS obligatoria</strong> implementos. En lugar de generar un error en valores nulos o vacíos, se devuelve el valor predeterminado.</p>
-<span class="ret">string display(mixed $data, string $default = '')</span>
+<h2>Ver ayudantes—<code>display()</code> <span class="tag b-view">Ver método</span></h2>
+<p>Al imprimir datos desde la base de datos o la entrada del usuario al DOM<strong>protección XSS obligatoria</strong>implementos. En lugar de generar un error en valores nulos o vacíos, se devuelve el valor predeterminado.</p>
+<span class="ret">visualización de cadena ($datos mixtos, cadena $predeterminado = '')</span>
 <div class="alert a-info" style="margin-top: 10px; margin-bottom: 24px; padding: 12px 20px;">
-<strong>💡 Consejo: <code>$default</code> Uso</strong><br/>
-            Segundo parámetro (<code>$default</code>) es el texto de rescate que se imprimirá en pantalla cuando los datos provenientes de la base de datos estén vacíos (nulo, falso, cadena vacía). Por ejemplo, para un usuario cuyos datos de nombre no se ingresan <code>display($isim, 'İsimsiz')</code> Si lo usa, su página presentará contenido significativo en lugar de feos espacios en blanco.
-        </div>
-<pre><code><span class="cm">&lt;!-- ❌ Güvensiz — XSS açığı oluşturur --&gt;</span>
-&lt;h1&gt;&lt;?= <span class="var">$user</span>[<span class="st">'isim'</span>] ?&gt;&lt;/h1&gt;
-<span class="cm">&lt;!-- ✅ ArtiFrame Güvenli Kullanımı --&gt;</span>
-&lt;h1&gt;&lt;?= <span class="fn">display</span>(<span class="var">$user</span>[<span class="st">'isim'</span>], <span class="st">'İsimsiz Kullanıcı'</span>) ?&gt;&lt;/h1&gt;</code></pre>
+<strong>💡 Consejo:<code>$default</code>Uso</strong><br/>Segundo parámetro (<code>$default</code>) es el texto de rescate que se imprimirá en pantalla cuando los datos provenientes de la base de datos estén vacíos (nulo, falso, cadena vacía). Por ejemplo, para un usuario cuyos datos de nombre no se ingresan<code>display($isim, 'İsimsiz')</code>Si lo usa, su página presentará contenido significativo en lugar de feos espacios en blanco.</div>
+<pre><code><span class="cm">&lt;!-- ❌ Inseguro: crea una vulnerabilidad XSS --&gt;</span>
+&lt;h1&gt;&lt;?= <span class="var">$usuario</span>[<span class="st">'nombre'</span>] ?&gt;&lt;/h1&gt;
+<span class="cm">&lt;!-- ✅ Uso seguro de ArtiFrame --&gt;</span>
+&lt;h1&gt;&lt;?= <span class="fn">mostrar</span>(<span class="var">$usuario</span>[<span class="st">'nombre'</span>], <span class="st">'Usuario anónimo'</span>) ?&gt;&lt;/h1&gt;</code></pre>
 </section>
 <section id="vh-escapeurl">
-<h2>Ver ayudantes— <code>escapeUrl()</code> <span class="tag b-view">ViewMethod</span></h2>
-<p>Enlaces recibidos de los usuarios (por ejemplo, sitios web de perfiles) <code>&lt;a href="..."&gt;</code> o <code>&lt;img src="..."&gt;</code> Se utiliza al presionar hacia adentro. <code>javascript:alert(1)</code> Previene la ejecución de código a través de la conexión al hacer que cargas útiles peligrosas como (Stored XSS) sean inofensivas.</p>
-<span class="ret">string escapeUrl(string $url)</span>
-<pre><code><span class="cm">&lt;!-- ❌ Güvensiz — URL üzerinden JS kodu sızdırılabilir --&gt;</span>
-&lt;a href="&lt;?= <span class="var">$user</span>[<span class="st">'website'</span>] ?&gt;"&gt;Siteyi Ziyaret Et&lt;/a&gt;
-<span class="cm">&lt;!-- ✅ ArtiFrame Güvenli Kullanımı --&gt;</span>
-&lt;a href="&lt;?= <span class="fn">escapeUrl</span>(<span class="var">$user</span>[<span class="st">'website'</span>]) ?&gt;"&gt;Siteyi Ziyaret Et&lt;/a&gt;</code></pre>
+<h2>Ver ayudantes—<code>escapeUrl()</code> <span class="tag b-view">Ver método</span></h2>
+<p>Enlaces recibidos de los usuarios (por ejemplo, sitios web de perfiles)<code>&lt;a href="..."&gt;</code>o<code>&lt;img src="..."&gt;</code>Se utiliza al presionar hacia adentro.<code>javascript:alert(1)</code>Previene la ejecución de código a través de la conexión al hacer que cargas útiles peligrosas como (Stored XSS) sean inofensivas.</p>
+<span class="ret">cadena URL de escape(cadena $url)</span>
+<pre><code><span class="cm">&lt;!-- ❌ Inseguro: el código JS puede filtrarse a través de una URL --&gt;</span>
+&lt;a href="&lt;?= <span class="var">$usuario</span>[<span class="st">'sitio web'</span>] ?&gt;"&gt;Siteyi Ziyaret Et&lt;/a&gt;
+<span class="cm">&lt;!-- ✅ Uso seguro de ArtiFrame --&gt;</span>
+&lt;a href="&lt;?= <span class="fn">URL de escape</span>(<span class="var">$usuario</span>[<span class="st">'sitio web'</span>]) ?&gt;"&gt;Siteyi Ziyaret Et&lt;/a&gt;</code></pre>
 </section>
 <section id="vh-csrf">
-<h2>Ver ayudantes— <code>csrfField()</code> <span class="tag b-view">ViewMethod</span></h2>
-<p>Agrega un campo de token oculto a los formularios HTML contra ataques CSRF. <strong>Es obligatorio usarlo en cada página que contenga un formulario POST.</strong></p>
-<span class="ret">string csrfField()</span>
-<p>Este método imprime automáticamente el siguiente resultado HTML en su formulario: <code>&lt;input type="hidden" name="csrf_token" value="..."&gt;</code>. Si no desea utilizar el método, puede utilizar esta entrada oculta como valor. <code>display()</code> También puedes agregarlo manualmente envolviéndolo con .</p>
-<pre><code><span class="cm">&lt;!-- Frontend (HTML) --&gt;</span>
+<h2>Ver ayudantes—<code>csrfField()</code> <span class="tag b-view">Ver método</span></h2>
+<p>Agrega un campo de token oculto a los formularios HTML contra ataques CSRF.<strong>Es obligatorio usarlo en cada página que contenga un formulario POST.</strong></p>
+<span class="ret">cadena csrfField()</span>
+<p>Este método imprime automáticamente el siguiente resultado HTML en su formulario:<code>&lt;input type="hidden" name="csrf_token" value="..."&gt;</code>. Si no desea utilizar el método, puede utilizar esta entrada oculta como valor.<code>display()</code>También puedes agregarlo manualmente envolviéndolo con .</p>
+<pre><code><span class="cm">&lt;!-- Interfaz (HTML) --&gt;</span>
 &lt;form data-js="kaydet-form"&gt;
-    &lt;?= <span class="fn">csrfField</span>() ?&gt; <span class="cm">&lt;!-- Otomatik hidden input üretir --&gt;</span>
-    <span class="cm">&lt;!-- VEYA Manuel Kullanım:
-    &lt;input type="hidden" name="csrf_token" value="&lt;?= display($_SESSION['csrf_token'] ?? '') ?&gt;"&gt;
+    &lt;?= <span class="fn">campocsrf</span>() ?&gt; <span class="cm">&lt;!-- Genera automáticamente entradas ocultas --&gt;</span>
+    <span class="cm">&lt;!-- O Uso manual:
+    &lt;tipo de entrada="hidden" nombre="csrf_token" valor="&lt;?= display($_SESSION['csrf_token'] ?? '') ?&gt;"&gt;
     --&gt;</span>
     &lt;input type="text" name="ad" placeholder="Adınız"&gt;
     &lt;button type="submit"&gt;Kaydet&lt;/button&gt;
 &lt;/form&gt;
-<span class="cm">// Frontend (JavaScript) - Veriyi Yakalama ve Gönderme</span>
-<span class="fn">document</span>.<span class="fn">querySelector</span>(<span class="st">'[data-js="kaydet-form"]'</span>).<span class="fn">addEventListener</span>(<span class="st">'submit'</span>, (e) =&gt; {
-    e.<span class="fn">preventDefault</span>();
-    <span class="kw">const</span> <span class="var">formData</span> = <span class="kw">new</span> <span class="fn">FormData</span>(e.target);
-    <span class="cm">// csrf_token otomatik olarak formData içerisine dahil olur</span>
-    <span class="fn">fetch</span>(<span class="st">'/api/kaydet.php'</span>, {
-        <span class="kw">method</span>: <span class="st">'POST'</span>,
-        <span class="kw">body</span>: <span class="var">formData</span>
+<span class="cm">// Frontend (JavaScript): captura y envío de datos</span>
+<span class="fn">documento</span>.<span class="fn">selector de consulta</span>(<span class="st">'[datos-js="guardar-formulario"]'</span>).<span class="fn">agregarEventListener</span>(<span class="st">'entregar'</span>, (e) =&gt; {
+    e.<span class="fn">prevenir valor predeterminado</span>();
+    <span class="kw">constante</span> <span class="var">formularioDatos</span> = <span class="kw">nuevo</span> <span class="fn">Datos de formulario</span>(e.target);
+    <span class="cm">// csrf_token se incluye automáticamente en formData</span>
+    <span class="fn">buscar</span>(<span class="st">'/api/save.php'</span>, {
+        <span class="kw">método</span>: <span class="st">'CORREO'</span>,
+        <span class="kw">cuerpo</span>: <span class="var">formularioDatos</span>
     });
 });</code></pre>
 </section>
 <section id="vh-dates">
-<h2>Ver ayudantes: funciones de fecha <span class="tag b-view">ViewMethod</span></h2>
-<p>en la base de datos <code class="ic">Y-m-d H:i:s</code> Procesa cadenas de fecha o valores de marca de tiempo UNIX en formato. Toda la producción textual por idioma (<code class="ic">tr</code>, <code class="ic">en</code>, <code class="ic">de</code>, <code class="ic">fr</code>, <code class="ic">es</code>) está localizado.</p>
+<h2>Ver ayudantes: funciones de fecha<span class="tag b-view">Ver método</span></h2>
+<p>en la base de datos<code class="ic">Y-m-d H:i:s</code>Procesa cadenas de fecha o valores de marca de tiempo UNIX en formato. Toda la producción textual por idioma (<code class="ic">tr</code>, <code class="ic">en</code>, <code class="ic">de</code>, <code class="ic">fr</code>, <code class="ic">es</code>) está localizado.</p>
 <table class="sig-table">
 <thead><tr><th>Función</th><th>Ejemplo de salida</th><th>Explicación</th></tr></thead>
 <tbody>
@@ -4005,66 +3759,63 @@ if ($response['status'] === 'success') {
 </tbody>
 </table>
 <div class="alert a-info" style="margin-top: 0; margin-bottom: 24px;">
-<strong>💡 Comprensión de los parámetros: <code>$format</code> Y <code>$lang</code></strong>
+<strong>💡 Comprensión de los parámetros:<code>$format</code>Y<code>$lang</code></strong>
 <ul style="margin-top: 10px; margin-bottom: 0;">
-<li style="margin-bottom: 8px;"><strong><code>$format</code> (Formato):</strong> Solo <code>formatDate()</code> Se utiliza con la función. Acepta letras de fecha PHP estándar. (Por ejemplo: <code>'d/m/Y'</code> ➔ 24/07/2026, o <code>'H:i'</code> ➔ 15:30). Le permite crear su propio patrón de fechas cuando otras funciones ya preparadas (día, año, etc.) son insuficientes.</li>
-<li style="margin-bottom: 0;"><strong><code>$lang</code> (Idioma):</strong> Se utiliza en funciones que contienen texto (nombre del mes, palabra "antes") en su salida. Si deja este parámetro vacío, el sistema <strong>por defecto <code>'tr'</code> (Turco)</strong> funciona. Si está realizando un proyecto multilingüe, ingrese el código de idioma (<code>tr, en, de, fr, es</code>) es suficiente para entrar. (Ex: <code>timeAgo($tarih, 'en')</code> ➔ Hace 5 minutos)</li>
+<li style="margin-bottom: 8px;"><strong><code>$format</code>(Formato):</strong>Solo<code>formatDate()</code>Se utiliza con la función. Acepta letras de fecha PHP estándar. (Por ejemplo:<code>'d/m/Y'</code>➔ 24/07/2026, o<code>'H:i'</code>➔ 15:30). Le permite crear su propio patrón de fechas cuando otras funciones ya preparadas (día, año, etc.) son insuficientes.</li>
+<li style="margin-bottom: 0;"><strong><code>$lang</code>(Idioma):</strong>Se utiliza en funciones que contienen texto (nombre del mes, palabra "antes") en su salida. Si deja este parámetro vacío, el sistema<strong>por defecto<code>'tr'</code>(Turco)</strong>funciona. Si está realizando un proyecto multilingüe, ingrese el código de idioma (<code>tr, en, de, fr, es</code>) es suficiente para entrar. (Ex:<code>timeAgo($tarih, 'en')</code>➔ Hace 5 minutos)</li>
 </ul>
 </div>
-<pre><code><span class="cm">&lt;!-- time() fonksiyonu ile alınmış bir UNIX timestamp olduğunu varsayalım --&gt;</span>
-<span class="kw">&lt;?php</span> <span class="var">$tarih</span> = <span class="fn">time</span>(); <span class="kw">?&gt;</span>
-<span class="cm">&lt;!-- Dile göre tam tarih --&gt;</span>
-&lt;span&gt;&lt;?= <span class="fn">fulldateName</span>(<span class="var">$tarih</span>, <span class="st">'tr'</span>) ?&gt;&lt;/span&gt;
-<span class="cm">&lt;!-- Çıktı: 24 Temmuz 2026 --&gt;</span>
-<span class="cm">&lt;!-- Sosyal medya tarzı zaman gösterimi --&gt;</span>
-&lt;span&gt;&lt;?= <span class="fn">timeAgo</span>(<span class="var">$tarih</span>, <span class="st">'en'</span>) ?&gt;&lt;/span&gt;
-<span class="cm">&lt;!-- Çıktı: 5 minutes ago --&gt;</span>
-&lt;span&gt;&lt;?= <span class="fn">timeAgo</span>(<span class="var">$tarih</span>, <span class="st">'de'</span>) ?&gt;&lt;/span&gt;
-<span class="cm">&lt;!-- Çıktı: vor 5 Minuten --&gt;</span></code></pre>
+<pre><code><span class="cm">&lt;!-- Supongamos que es una marca de tiempo UNIX recuperada con la función time() --&gt;</span>
+<span class="kw">&lt;?php</span> <span class="var">$fecha</span> = <span class="fn">tiempo</span>(); <span class="kw">?&gt;</span>
+<span class="cm">&lt;!-- Fecha exacta por idioma --&gt;</span>
+&lt;span&gt;&lt;?= <span class="fn">nombrefechacompleta</span>(<span class="var">$fecha</span>, <span class="st">'tr'</span>) ?&gt;&lt;/span&gt;
+<span class="cm">&lt;!-- Publicado: 24 de julio de 2026 --&gt;</span>
+<span class="cm">&lt;!-- Visualización de la hora al estilo de las redes sociales --&gt;</span>
+&lt;span&gt;&lt;?= <span class="fn">hace tiempo</span>(<span class="var">$fecha</span>, <span class="st">'mayoría'</span>) ?&gt;&lt;/span&gt;
+<span class="cm">&lt;!-- Publicado: hace 5 minutos --&gt;</span>
+&lt;span&gt;&lt;?= <span class="fn">hace tiempo</span>(<span class="var">$fecha</span>, <span class="st">'también'</span>) ?&gt;&lt;/span&gt;
+<span class="cm">&lt;!-- Salida: durante 5 minutos --&gt;</span></code></pre>
 </section>
 <section id="vh-truncate">
-<h2>Ver ayudantes— <code>truncate()</code> <span class="tag b-view">ViewMethod</span></h2>
-<span class="ret">string truncate(string $text, int $length = 100, string $append = '...')</span>
+<h2>Ver ayudantes—<code>truncate()</code> <span class="tag b-view">Ver método</span></h2>
+<span class="ret">cadena truncada (cadena $texto, int $longitud = 100, cadena $append = '...')</span>
 <p>Recorta los textos largos hasta el límite de caracteres deseado sin cortar la última palabra y agrega el sufijo especificado al final.</p>
-<pre><code>&lt;p&gt;&lt;?= <span class="fn">truncate</span>(<span class="var">$post</span>[<span class="st">'icerik'</span>], <span class="nu">160</span>, <span class="st">'...'</span>) ?&gt;&lt;/p&gt;</code></pre>
+<pre><code>&lt;p&gt;&lt;?= <span class="fn">truncar</span>(<span class="var">$ publicación</span>[<span class="st">'contenido'</span>], <span class="nu">160</span>, <span class="st">'...'</span>) ?&gt;&lt;/p&gt;</code></pre>
 </section>
 <section id="vh-activeclass">
-<h2>Ver ayudantes— <code>activeClass()</code> <span class="tag b-view">ViewMethod</span></h2>
-<span class="ret">string activeClass(string $currentPath, string $targetPath, string $className = 'active')</span>
+<h2>Ver ayudantes—<code>activeClass()</code> <span class="tag b-view">Ver método</span></h2>
+<span class="ret">cadena activeClass(cadena $currentPath, cadena $targetPath, cadena $className = 'activo')</span>
 <p>Si la página actual y el enlace del menú marcado coinciden, devuelve la clase CSS. Perfecto para barra de navegación.</p>
-<pre><code>&lt;li class="&lt;?= <span class="fn">activeClass</span>(<span class="var">$current_url</span>, <span class="st">'/iletisim'</span>, <span class="st">'current-page'</span>) ?&gt;"&gt;</code></pre>
+<pre><code>&lt;li class="&lt;?= <span class="fn">clase activa</span>(<span class="var">$url_actual</span>, <span class="st">'/comunicación'</span>, <span class="st">'página actual'</span>) ?&gt;"&gt;</code></pre>
 </section>
 <section id="vh-formatsize">
-<h2>Ver ayudantes— <code>formatSize()</code> <span class="tag b-view">ViewMethod</span></h2>
-<span class="ret">string formatSize(int $bytes)</span>
+<h2>Ver ayudantes—<code>formatSize()</code> <span class="tag b-view">Ver método</span></h2>
+<span class="ret">formato de cadenaTamaño(int $bytes)</span>
 <p>Convierte el tamaño de archivo dado en bytes a unidades B, KB, MB, GB mediante cálculo logarítmico.</p>
-<pre><code>&lt;span&gt;&lt;?= <span class="fn">formatSize</span>(<span class="nu">10485760</span>) ?&gt;&lt;/span&gt; <span class="cm">&lt;!-- 10,00 MB --&gt;</span></code></pre>
+<pre><code>&lt;span&gt;&lt;?= <span class="fn">formatoTamaño</span>(<span class="nu">10485760</span>) ?&gt;&lt;/span&gt; <span class="cm">&lt;!-- 10,00 MB --&gt;</span></code></pre>
 </section>
 <section id="vh-maskemail">
-<h2>Ver ayudantes— <code>maskEmail()</code> <span class="tag b-view">ViewMethod</span></h2>
-<span class="ret">string maskEmail(?string $email)</span>
+<h2>Ver ayudantes—<code>maskEmail()</code> <span class="tag b-view">Ver método</span></h2>
+<span class="ret">máscara de cadenaCorreo electrónico(?cadena $correo electrónico)</span>
 <p>Enmascara direcciones de correo electrónico de acuerdo con el cumplimiento de KVKK/RGPD. Estrellas desde la primera letra hasta el signo @.</p>
-<pre><code>&lt;td&gt;&lt;?= <span class="fn">maskEmail</span>(<span class="st">'utku@artilingo.com'</span>) ?&gt;&lt;/td&gt; <span class="cm">&lt;!-- u***@artilingo.com --&gt;</span></code></pre>
+<pre><code>&lt;td&gt;&lt;?= <span class="fn">máscaracorreo electrónico</span>(<span class="st">'utku@artilingo.com'</span>) ?&gt;&lt;/td&gt; <span class="cm">&lt;!-- u***@artilingo.com --&gt;</span></code></pre>
 </section>
 <section id="vh-maskphone">
-<h2>Ver ayudantes— <code>maskPhone()</code> <span class="tag b-view">ViewMethod</span></h2>
-<span class="ret">string maskPhone(string $phone)</span>
+<h2>Ver ayudantes—<code>maskPhone()</code> <span class="tag b-view">Ver método</span></h2>
+<span class="ret">máscara de cadenaTeléfono(cadena $teléfono)</span>
 <p>Enmascaramiento avanzado de números de teléfono. Previene las filtraciones de datos al ocultar completamente los dígitos críticos.</p>
-<pre><code>&lt;td&gt;&lt;?= <span class="fn">maskPhone</span>(<span class="st">'05551234567'</span>) ?&gt;&lt;/td&gt; <span class="cm">&lt;!-- 0555 *** ** 67 --&gt;</span></code></pre>
+<pre><code>&lt;td&gt;&lt;?= <span class="fn">máscaraTeléfono</span>(<span class="st">'05551234567'</span>) ?&gt;&lt;/td&gt; <span class="cm">&lt;!-- 0555 *** ** 67 --&gt;</span></code></pre>
 </section>
 <section id="vh-slugify">
-<h2>Ver ayudantes— <code>slugify()</code> <span class="tag b-view">ViewMethod</span></h2>
-<span class="ret">string slugify(string ...$texts)</span>
+<h2>Ver ayudantes—<code>slugify()</code> <span class="tag b-view">Ver método</span></h2>
+<span class="ret">cadena slugify(cadena...$textos)</span>
 <p>Creador de enlaces SEO compatible con URL. No hay límite de parámetros (Variadic). Puede escribir la salida directamente en href.</p>
-<pre><code>&lt;a href="/yazi/&lt;?= <span class="fn">slugify</span>(<span class="var">$kat</span>, <span class="var">$baslik</span>) ?&gt;"&gt;Oku&lt;/a&gt; <span class="cm">&lt;!-- /yazi/teknoloji/yapay-zeka --&gt;</span></code></pre>
+<pre><code>&lt;a href="/yazi/&lt;?= <span class="fn">slugificar</span>(<span class="var">$kat</span>, <span class="var">$título</span>) ?&gt;"&gt;Oku&lt;/a&gt; <span class="cm">&lt;!-- /texto/tecnología/inteligencia-artificial --&gt;</span></code></pre>
 </section>
 <section id="vh-money">
-<h2>Ver ayudantes— <code>money()</code> <span class="tag b-view">ViewMethod</span></h2>
-<p>Formatea el monto con el símbolo de moneda. El código de moneda (ISO) determina automáticamente la ubicación del símbolo. Moneda predeterminada <code class="ic">usd</code>es.</p>
-<span class="ret">string money(float $amount, string $currency = 'usd')</span>
+<h2>Ver ayudantes—<code>money()</code> <span class="tag b-view">Ver método</span></h2>
+<p>Formatea el monto con el símbolo de moneda. El código de moneda (ISO) determina automáticamente la ubicación del símbolo. Moneda predeterminada<code class="ic">usd</code>es.</p>
+<span class="ret">cadena de dinero(flotante $cantidad, cadena $moneda = 'usd')</span>
 <table class="sig-table">
 <thead><tr><th>Código</th><th>Producción</th><th>Divisa</th></tr></thead>
 <tbody>
@@ -4080,449 +3831,397 @@ if ($response['status'] === 'success') {
 <tr><td>dea</td><td>1.250,00 د.إ</td><td>Dírham de los Emiratos Árabes Unidos</td></tr>
 </tbody>
 </table>
-<pre><code>&lt;span&gt;&lt;?= <span class="fn">money</span>(<span class="var">$urun</span>[<span class="st">'fiyat'</span>], <span class="st">'try'</span>) ?&gt;&lt;/span&gt;
-<span class="cm">&lt;!-- Çıktı: 1.250,00 ₺ --&gt;</span>
-&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 id="vh-uuid">
-        <h2>View Helpers - <code>uuid()</code> <span class="tag b-view">ViewMethod</span></h2>
-        <p>Convierte un UUID binario de 16 bytes de la base de datos a un formato de 36 caracteres y lo imprime con protección XSS.</p>
-        <pre><code><span class="cm">&lt;!-- Salida: 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 ====== -->
+<pre><code>&lt;span&gt;&lt;?= <span class="fn">dinero</span>(<span class="var">$producto</span>[<span class="st">'precio'</span>], <span class="st">'intentar'</span>) ?&gt;&lt;/span&gt;
+<span class="cm">&lt;!-- Salida: ₺ 1.250,00 --&gt;</span>
+&lt;span&gt;&lt;?= <span class="fn">dinero</span>(<span class="var">$producto</span>[<span class="st">'precio'</span>], <span class="st">'Dólar estadounidense'</span>) ?&gt;&lt;/span&gt;
+<span class="cm">&lt;!-- Salida: $1,250.00 --&gt;</span></code></pre>
+</section>
+<section id="vh-uuid">
+<h2>Ver ayudantes -<code>uuid()</code> <span class="tag b-view">Ver método</span></h2>
+<p>Convierte los datos UUID binarios de 16 bytes provenientes de la base de datos al formato de 36 caracteres y los imprime en la pantalla con protección XSS.</p>
+<pre><code><span class="cm">&lt;!-- Salida: 0190ed84-3f12-7a91-8bc4-91823741abcd --&gt;</span>
+&lt;div&gt;<span class="kw">&lt;?=</span> <span class="fn">UUID</span>(<span class="var">$tirar</span>[<span class="st">'IDENTIFICACIÓN'</span>]) <span class="kw">?&gt;</span>&lt;/div&gt;</code></pre>
+</section>
+====== AYUDANTES DEL SISTEMA ======
 <section id="sh-apiresponse">
-<h2>Ayudantes del sistema— <code>apiResponse()</code> <span class="tag b-api">SystemMethod</span></h2>
-<p>Esta función se utiliza entre el Frontend (JS/Mobile) y el Backend (PHP) de su aplicación. <strong>Es la constitución de la comunicación.</strong> Claves en los datos JSON devueltos como Respuesta <code>status</code>, <code>message</code> Y <code>data</code> aspecto <strong>está absolutamente arreglado (debe estar en inglés)</strong>.</p>
-<span class="ret">void apiResponse(string $status, string $message, array $data = [], \Throwable $exception = null)</span>
-<p style="margin-top: 15px;"><strong>Código de estado (código HTTP):</strong> En el lado de PHP, el primer parámetro <code>'success'</code> Si se escribe, se devuelve HTTP 200 automáticamente; para todo lo demás (por ejemplo: 'error', 'ok') se devuelve 400 Solicitud incorrecta.</p>
-<p><strong>Sensibilidad del entorno en vivo/de prueba (APP_ENV):</strong> Si el cuarto parámetro es <code>Exception</code> Si lo das y tu sistema está en modo Desarrollo (APP_ENV = 1), aplastará el mensaje que escribiste e imprimirá el error SQL/número de línea en la pantalla tal como está. Si está en modo en vivo (APP_ENV = 0), oculta los errores y muestra solo el mensaje claro que usted escribió.</p>
+<h2>Ayudantes del sistema—<code>apiResponse()</code> <span class="tag b-api">Método del sistema</span></h2>
+<p>Esta función se utiliza entre el Frontend (JS/Mobile) y el Backend (PHP) de su aplicación.<strong>Es la constitución de la comunicación.</strong>Claves en los datos JSON devueltos como Respuesta<code>status</code>, <code>message</code>Y<code>data</code>aspecto<strong>está absolutamente arreglado (debe estar en inglés)</strong>.</p>
+<span class="ret">void apiResponse(cadena $estado, cadena $mensaje, matriz $datos = [], \Throwable $excepción = nulo)</span>
+<p style="margin-top: 15px;"><strong>Código de estado (código HTTP):</strong>En el lado de PHP, el primer parámetro<code>'success'</code>Si se escribe, se devuelve HTTP 200 automáticamente, para todo lo demás (por ejemplo: 'error', 'ok') se devuelve 400 Solicitud incorrecta.</p>
+<p><strong>Sensibilidad del entorno en vivo/de prueba (APP_ENV):</strong>Si el cuarto parámetro es<code>Exception</code>Si lo das y tu sistema está en modo Desarrollo (APP_ENV = 1), aplastará el mensaje que escribiste e imprimirá el error SQL/número de línea en la pantalla tal como está. Si está en modo en vivo (APP_ENV = 0), oculta los errores y muestra solo el mensaje claro que usted escribió.</p>
 <h3>Envío PHP (backend)</h3>
-<pre><code><span class="cm">// 1. Standart Gönderim</span>
-<span class="fn">apiResponse</span>(<span class="st">'success'</span>, <span class="st">'İşlem başarıyla tamamlandı.'</span>, [<span class="st">'id'</span> =&gt; <span class="nu">1453</span>]);
-<span class="cm">// 2. Hata Gönderimi (Exception ile)</span>
-<span class="kw">try</span> {
-    <span class="cm">// Veritabanı sorguları...</span>
-} <span class="kw">catch</span> (\Exception <span class="var">$e</span>) {
-    <span class="fn">apiResponse</span>(<span class="st">'error'</span>, <span class="st">'Bir sorun oluştu.'</span>, [], <span class="var">$e</span>);
+<pre><code><span class="cm">// 1. Envío estándar</span>
+<span class="fn">apiRespuesta</span>(<span class="st">'éxito'</span>, <span class="st">"La operación se completó con éxito".</span>, [<span class="st">'IDENTIFICACIÓN'</span> =&gt; <span class="nu">1453</span>]);
+<span class="cm">// 2. Envío de error (con excepción)</span>
+<span class="kw">intentar</span> {
+    <span class="cm">// Consultas a la base de datos...</span>
+} <span class="kw">atrapar</span> (\Exception <span class="var">$e</span>) {
+    <span class="fn">apiRespuesta</span>(<span class="st">'error'</span>, <span class="st">"Algo salió mal".</span>, [], <span class="var">$e</span>);
 }</code></pre>
 <h3>Captura de JavaScript (frontend)</h3>
-<pre><code><span class="fn">fetch</span>(<span class="st">'/api/endpoint'</span>, { method: <span class="st">'POST'</span> })
+<pre><code><span class="fn">buscar</span>(<span class="st">'/api/punto final'</span>, { method: <span class="st">'CORREO'</span> })
   .then(res =&gt; res.json())
   .then(response =&gt; {
-      <span class="cm">// DİKKAT: response.durum veya response.mesaj ÇALIŞMAZ!</span>
-      <span class="cm">// PHP tarafından ne yollarsanız yollayın anahtarlar daima status, message ve data'dır.</span>
-      <span class="kw">if</span> (response.status === <span class="st">'success'</span>) { <span class="cm">// PHP'den ne gelirse ('success', 'ok', 'basarili' vs.)</span>
-          console.log(<span class="st">"Mesaj:"</span>, response.message);
-          console.log(<span class="st">"Gelen Veri:"</span>, response.data);
-      } <span class="kw">else</span> {
-          <span class="fn">alert</span>(<span class="st">"Hata oluştu: "</span> + response.message);
+      <span class="cm">// ADVERTENCIA: respuesta.status o respuesta.message ¡NO funcionarán!</span>
+      <span class="cm">// No importa lo que envíes desde PHP, las claves siempre son estado, mensaje y datos.</span>
+      <span class="kw">si</span> (response.status === <span class="st">'éxito'</span>) { <span class="cm">// Lo que sea que venga de PHP ('éxito', 'ok', 'éxito', etc.)</span>
+          console.log(<span class="st">"Mensaje:"</span>, response.message);
+          console.log(<span class="st">"Datos entrantes:"</span>, response.data);
+      } <span class="kw">demás</span> {
+          <span class="fn">alerta</span>(<span class="st">"Ocurrió un error: "</span> + response.message);
       }
   });</code></pre>
 </section>
 <section id="sh-json">
-<h2>Ayudantes del sistema— <code>jsonResponse()</code> <span class="tag b-api">SystemMethod</span></h2>
-<p>Establece el encabezado JSON, devuelve el código de estado HTTP e imprime de forma segura el resultado con json_encode y luego finaliza el script. <strong>Todas las respuestas de API deben darse a través de esta función.</strong></p>
-<span class="ret">void jsonResponse(array $data, int $statusCode = 200)</span>
-<pre><code><span class="cm">// Başarılı yanıt</span>
-<span class="fn">jsonResponse</span>([<span class="st">'status'</span> =&gt; <span class="st">'success'</span>, <span class="st">'data'</span> =&gt; <span class="var">$kullanici</span>], <span class="nu">200</span>);
-<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>
+<h2>Ayudantes del sistema—<code>jsonResponse()</code> <span class="tag b-api">Método del sistema</span></h2>
+<p>Establece el encabezado JSON, devuelve el código de estado HTTP e imprime de forma segura el resultado con json_encode y luego finaliza el script.<strong>Todas las respuestas de API deben darse a través de esta función.</strong></p>
+<span class="ret">void jsonResponse(matriz $datos, int $statusCode = 200)</span>
+<pre><code><span class="cm">// respuesta exitosa</span>
+<span class="fn">jsonRespuesta</span>([<span class="st">'estado'</span> =&gt; <span class="st">'éxito'</span>, <span class="st">'datos'</span> =&gt; <span class="var">$usuario</span>], <span class="nu">200</span>);
+<span class="cm">// respuesta de error</span>
+<span class="fn">jsonRespuesta</span>([<span class="st">'estado'</span> =&gt; <span class="st">'error'</span>, <span class="st">'mensaje'</span> =&gt; <span class="st">'Acceso no autorizado.'</span>], <span class="nu">401</span>);</code></pre>
 </section>
 <section id="sh-dd">
-<h2>Ayudantes del sistema— <code>dd()</code> <span class="tag b-api">SystemMethod</span></h2>
-<p>Volcar y morir. Durante la fase de desarrollo, las variables se mostraban en la pantalla en modo oscuro, legible y elegante. <code>&lt;pre&gt;</code> etiqueta y detiene la ejecución del código en esa línea (salida). Puede tomar parámetros ilimitados (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>
+<h2>Ayudantes del sistema—<code>dd()</code> <span class="tag b-api">Método del sistema</span></h2>
+<p>Volcar y morir. Durante la fase de desarrollo, las variables se mostraban en la pantalla en modo oscuro, legible y elegante.<code>&lt;pre&gt;</code>etiqueta y detiene la ejecución del código en esa línea (salida). Puede tomar parámetros ilimitados (Variadic).</p>
+<span class="ret">void dd(mixto...$vars)</span>
+<pre><code><span class="fn">dd</span>(<span class="var">$_POST</span>, <span class="var">$id_usuario</span>);
+<span class="cm">// Imprime los valores en pantalla y detiene el sistema.</span></code></pre>
 </section>
-<!-- ====== ID GENERATION & UTILITIES ====== -->
+====== GENERACIÓN DE ID Y UTILIDADES ======
 <section id="id-generation-utilities">
-</section>
+</section>
 <section id="sh-redirect">
-<h2>Ayudantes del sistema— <code>redirect()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">void redirect(string $url)</span>
-<p>a la página deseada <code>header("Location: ...")</code> Instantáneamente redirige y deja de funcionar con (<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>);
+<h2>Ayudantes del sistema—<code>redirect()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">redireccionamiento nulo (cadena $url)</span>
+<p>a la página deseada<code>header("Location: ...")</code>Instantáneamente redirige y deja de funcionar con (<code>exit</code>).</p>
+<pre><code><span class="kw">si</span> (!<span class="var">$ está iniciado sesión</span>) {
+    <span class="fn">redirigir</span>(<span class="st">'/acceso'</span>);
 }</code></pre>
-</section>
-    <section id="sh-generatecsrf">
-<h2>Ayudantes del sistema— <code>generateCsrf()</code> <span class="tag b-api">SystemMethod</span></h2>
-<p>Genera un nuevo token CSRF seguro basado en sesión, de 32 bytes de longitud. Para agregar como entrada oculta a formularios <code>csrfField()</code> Se recomienda utilizar (Ver ayudante).</p>
-<span class="ret">string generateCsrf()</span>
-<pre><code><span class="kw">if</span> (<span class="var">$_SESSION</span>[<span class="st">'kullanici'</span>]) {
-    <span class="fn">generateCsrf</span>(); <span class="cm">// Oturum başlatıldığında CSRF üretilir</span>
+</section>
+<section id="sh-generatecsrf">
+<h2>Ayudantes del sistema—<code>generateCsrf()</code> <span class="tag b-api">Método del sistema</span></h2>
+<p>Genera un nuevo token CSRF seguro basado en sesión, de 32 bytes de longitud. Para agregar como entrada oculta a formularios<code>csrfField()</code>Se recomienda utilizar (Ver ayudante).</p>
+<span class="ret">cadena generarCsrf()</span>
+<pre><code><span class="kw">si</span> (<span class="var">$_SESSION</span>[<span class="st">'usuario'</span>]) {
+    <span class="fn">generarCsrf</span>(); <span class="cm">// CSRF se genera cuando se inicia la sesión</span>
 }</code></pre>
 </section>
 <section id="sh-csrf">
-<h2>Ayudantes del sistema— <code>verifyCsrf()</code> <span class="tag b-api">SystemMethod</span></h2>
-<p>Verifica que la solicitud POST entrante proviene de un formulario legítimo. en el formulario <code class="ic">csrfField()</code> Devuelve falso si no se agrega o si el token no es válido.</p>
-<span class="ret">bool verifyCsrf(string $token)</span>
-<pre><code><span class="kw">if</span> (!<span class="fn">verifyCsrf</span>(<span class="var">$_POST</span>[<span class="st">'csrf_token'</span>] ?? <span class="st">''</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">'Geçersiz CSRF token.'</span>], <span class="nu">403</span>);
+<h2>Ayudantes del sistema—<code>verifyCsrf()</code> <span class="tag b-api">Método del sistema</span></h2>
+<p>Verifica que la solicitud POST entrante proviene de un formulario legítimo. en el formulario<code class="ic">csrfField()</code>Devuelve falso si no se agrega o si el token no es válido.</p>
+<span class="ret">bool verificarCsrf(cadena $token)</span>
+<pre><code><span class="kw">si</span> (!<span class="fn">verificarCsrf</span>(<span class="var">$_POST</span>[<span class="st">'csrf_token'</span>] ?? <span class="st">''</span>)) {
+    <span class="fn">jsonRespuesta</span>([<span class="st">'estado'</span> =&gt; <span class="st">'error'</span>, <span class="st">'mensaje'</span> =&gt; <span class="st">'Token CSRF no válido.'</span>], <span class="nu">403</span>);
 }</code></pre>
 </section>
 <section id="sh-sanitizeint">
-<h2>Ayudantes del sistema— <code>sanitizeInt()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">int sanitizeInt(mixed $value)</span>
-<p>Elimina todas las letras, símbolos y comas que contiene. <strong>solo entero</strong> deja los números. Se utiliza para ID o límites (valores int de base de datos).</p>
-<pre><code><span class="var">$id</span> = <span class="fn">sanitizeInt</span>(<span class="var">$_GET</span>[<span class="st">'id'</span>] ?? <span class="nu">0</span>);</code></pre>
+<h2>Ayudantes del sistema—<code>sanitizeInt()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">int sanitizeInt(valor $ mixto)</span>
+<p>Elimina todas las letras, símbolos y comas que contiene.<strong>solo entero</strong>deja los números. Se utiliza para ID o límites (valores int de base de datos).</p>
+<pre><code><span class="var">$identificación</span> = <span class="fn">sanitizarInt</span>(<span class="var">$_GET</span>[<span class="st">'IDENTIFICACIÓN'</span>] ?? <span class="nu">0</span>);</code></pre>
 </section>
 <section id="sh-sanitizefloat">
-<h2>Ayudantes del sistema— <code>sanitizeFloat()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">float sanitizeFloat(mixed $value)</span>
-<p>Borra todo excepto los números fraccionarios (decimales). Es seguro utilizarlo para cantidades monetarias, cálculos de ratios o métricas.</p>
-<pre><code><span class="var">$fiyat</span> = <span class="fn">sanitizeFloat</span>(<span class="var">$_POST</span>[<span class="st">'fiyat'</span>]);</code></pre>
+<h2>Ayudantes del sistema—<code>sanitizeFloat()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">float sanitizeFloat(valor $mixto)</span>
+<p>Borra todos excepto los números fraccionarios (decimales). Es seguro utilizarlo para cantidades monetarias, cálculos de ratios o métricas.</p>
+<pre><code><span class="var">$precio</span> = <span class="fn">desinfectarFlotador</span>(<span class="var">$_POST</span>[<span class="st">'precio'</span>]);</code></pre>
 </section>
 <section id="sh-sanitizestring">
-<h2>Ayudantes del sistema— <code>sanitizeString()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">string sanitizeString(string $value)</span>
-<p>Para prevenir XSS y ataques similares, todos <strong>Etiquetas HTML y PHP (<code>&lt;script&gt;</code>, <code>&lt;iframe&gt;</code> etc.) destruye</strong>. Debe usarse antes de guardar String en la base de datos.</p>
-<pre><code><span class="var">$isim</span> = <span class="fn">sanitizeString</span>(<span class="var">$_POST</span>[<span class="st">'isim'</span>]);</code></pre>
+<h2>Ayudantes del sistema—<code>sanitizeString()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">cadena sanitizeString(cadena $valor)</span>
+<p>Para prevenir XSS y ataques similares, todos<strong>Etiquetas HTML y PHP (<code>&lt;script&gt;</code>, <code>&lt;iframe&gt;</code>etc.) destruye</strong>. Debe usarse antes de guardar String en la base de datos.</p>
+<pre><code><span class="var">$nombre</span> = <span class="fn">desinfectarString</span>(<span class="var">$_POST</span>[<span class="st">'nombre'</span>]);</code></pre>
 </section>
 <section id="sh-sanitizeemail">
-<h2>Ayudantes del sistema— <code>sanitizeEmail()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">string sanitizeEmail(string $email)</span>
-<p>Filtra todos los caracteres no válidos y peligrosos que no cumplen con el formato del correo electrónico. (Atención: Sólo borra la corrección del formato. <code>verifyEmail()</code> Deberías consultar con ).</p>
-<pre><code><span class="var">$email</span> = <span class="fn">sanitizeEmail</span>(<span class="var">$_POST</span>[<span class="st">'email'</span>] ?? <span class="st">''</span>);</code></pre>
+<h2>Ayudantes del sistema—<code>sanitizeEmail()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">cadena sanitizeEmail(cadena $correo electrónico)</span>
+<p>Filtra todos los caracteres no válidos y peligrosos que no cumplen con el formato del correo electrónico. (Atención: Sólo borra la corrección del formato.<code>verifyEmail()</code>Deberías consultar con ).</p>
+<pre><code><span class="var">$correo electrónico</span> = <span class="fn">desinfectarCorreo electrónico</span>(<span class="var">$_POST</span>[<span class="st">'correo electrónico'</span>] ?? <span class="st">''</span>);</code></pre>
 </section>
 <section id="sh-ispost">
-<h2>Ayudantes del sistema— <code>isPost()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">bool isPost()</span>
+<h2>Ayudantes del sistema—<code>isPost()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">bool es publicación()</span>
 <p>Verifica si la solicitud entrante (Solicitud HTTP) se realiza con el método POST. Se utiliza para impedir el acceso directo a la página, especialmente en el envío de formularios.</p>
-<pre><code><span class="kw">if</span> (<span class="fn">isPost</span>()) {
-    <span class="cm">// İstek POST ise çalışır (Form gönderimi)</span>
+<pre><code><span class="kw">si</span> (<span class="fn">espublicar</span>()) {
+    <span class="cm">// Funciona si la solicitud es POST (envío de formulario)</span>
 }</code></pre>
 </section>
 <section id="sh-isget">
-<h2>Ayudantes del sistema— <code>isGet()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">bool isGet()</span>
+<h2>Ayudantes del sistema—<code>isGet()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">bool esGet()</span>
 <p>Verifica si la solicitud entrante se realiza con el método GET. Se utiliza únicamente con fines de control al leer parámetros o visualizar páginas a través de URL.</p>
-<pre><code><span class="kw">if</span> (<span class="fn">isGet</span>()) {
-    <span class="cm">// Sayfa normal olarak ziyaret edildiyse çalışır</span>
+<pre><code><span class="kw">si</span> (<span class="fn">es obtener</span>()) {
+    <span class="cm">// Funciona si la página se visita normalmente</span>
 }</code></pre>
 </section>
 <section id="sh-isput">
-<h2>Ayudantes del sistema— <code>isPut()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">bool isPut()</span>
+<h2>Ayudantes del sistema—<code>isPut()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">bool esPut()</span>
 <p>Verifica que la solicitud entrante se realice con el método PUT. Generalmente se prefiere para operaciones de actualización de datos en arquitecturas API REST.</p>
-<pre><code><span class="kw">if</span> (<span class="fn">isPut</span>()) {
-    <span class="cm">// API üzerinden bir kaynağı güncelleme isteği</span>
+<pre><code><span class="kw">si</span> (<span class="fn">es poner</span>()) {
+    <span class="cm">//Solicitud de actualización de un recurso mediante API</span>
 }</code></pre>
 </section>
 <section id="sh-isdelete">
-<h2>Ayudantes del sistema— <code>isDelete()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">bool isDelete()</span>
+<h2>Ayudantes del sistema—<code>isDelete()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">bool es eliminar()</span>
 <p>Verifica que la solicitud entrante se realizó con el método DELETE. Se utiliza para proteger rutas de eliminación en API REST.</p>
-<pre><code><span class="kw">if</span> (<span class="fn">isDelete</span>()) {
-    <span class="cm">// API üzerinden bir kaynağı silme isteği</span>
+<pre><code><span class="kw">si</span> (<span class="fn">es eliminar</span>()) {
+    <span class="cm">// Solicitud para eliminar un recurso a través de API</span>
 }</code></pre>
 </section>
 <section id="sh-isajax">
-<h2>Ayudantes del sistema— <code>isAjax()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">bool isAjax()</span>
-<p>Su solicitud entrante <code>XMLHttpRequest</code> Comprueba si se realiza a través de (AJAX) o de la moderna Fetch API (<code>HTTP_X_REQUESTED_WITH</code> mira el valor del encabezado).</p>
-<pre><code><span class="kw">if</span> (!<span class="fn">isAjax</span>()) {
-    <span class="fn">redirect</span>(<span class="st">'/hata'</span>); <span class="cm">// Sadece AJAX'a izin ver</span>
+<h2>Ayudantes del sistema—<code>isAjax()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">booleano esAjax()</span>
+<p>Su solicitud entrante<code>XMLHttpRequest</code>Comprueba si se realiza a través de (AJAX) o de la moderna Fetch API (<code>HTTP_X_REQUESTED_WITH</code>mira el valor del encabezado).</p>
+<pre><code><span class="kw">si</span> (!<span class="fn">esAjax</span>()) {
+    <span class="fn">redirigir</span>(<span class="st">'/error'</span>); <span class="cm">// Sólo permite AJAX</span>
 }</code></pre>
 </section>
 <section id="sh-getclientip">
-<h2>Ayudantes del sistema— <code>getClientIp()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">string getClientIp()</span>
+<h2>Ayudantes del sistema—<code>getClientIp()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">cadena getClientIp()</span>
 <p>Detecta la dirección IP real del usuario. Llamarada de nube (<code>HTTP_CF_CONNECTING_IP</code>), apoderado (<code>HTTP_X_FORWARDED_FOR</code>) y estándar (<code>REMOTE_ADDR</code>) resuelve todas las conexiones automáticamente.</p>
-<pre><code><span class="var">$ip</span> = <span class="fn">getClientIp</span>(); <span class="cm">// Örn: 192.168.1.1</span></code></pre>
+<pre><code><span class="var">$ip</span> = <span class="fn">obtenerIPCliente</span>(); <span class="cm">// Ej: 192.168.1.1</span></code></pre>
 </section>
 <section id="sh-verifyemail">
-<h2>Ayudantes del sistema— <code>verifyEmail()</code> <span class="tag b-api">SystemMethod</span></h2>
+<h2>Ayudantes del sistema—<code>verifyEmail()</code> <span class="tag b-api">Método del sistema</span></h2>
 <p>Verifica si la dirección de correo electrónico proporcionada es realmente una dirección de correo electrónico válida según el DNS o el formato.</p>
-<span class="ret">bool verifyEmail(string $email)</span>
-<pre><code><span class="kw">if</span> (!<span class="fn">verifyEmail</span>(<span class="var">$_POST</span>[<span class="st">'eposta'</span>])) {
-    <span class="fn">apiResponse</span>(<span class="st">'error'</span>, <span class="st">'Geçersiz e-posta adresi.'</span>);
+<span class="ret">bool verificar correo electrónico (cadena $ correo electrónico)</span>
+<pre><code><span class="kw">si</span> (!<span class="fn">verificarCorreo electrónico</span>(<span class="var">$_POST</span>[<span class="st">'correo electrónico'</span>])) {
+    <span class="fn">apiRespuesta</span>(<span class="st">'error'</span>, <span class="st">'Dirección de correo electrónico no válida.'</span>);
 }</code></pre>
 </section>
 <section id="sh-generatetoken">
-<h2>Ayudantes del sistema— <code>generateToken()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">string generateToken(int $length = 32)</span>
-<p>Genera un token aleatorio criptográficamente seguro (por ejemplo, restablecimiento de contraseña, clave API). <strong>Nota: Cada byte ingresado produce 2 caracteres (hexadecimales) de salida.</strong> La longitud predeterminada de 32 bytes devuelve una cadena que tiene exactamente 64 caracteres.</p>
-<pre><code><span class="var">$token</span> = <span class="fn">generateToken</span>(<span class="nu">16</span>); <span class="cm">// 32 karakterlik token</span></code></pre>
+<h2>Ayudantes del sistema—<code>generateToken()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">cadena generarToken(int $longitud = 32)</span>
+<p>Genera un token aleatorio criptográficamente seguro (por ejemplo, restablecimiento de contraseña, clave API).<strong>Nota: Cada byte ingresado produce 2 caracteres (hexadecimales) de salida.</strong>La longitud predeterminada de 32 bytes devuelve una cadena que tiene exactamente 64 caracteres.</p>
+<pre><code><span class="var">$ token</span> = <span class="fn">generarToken</span>(<span class="nu">16</span>); <span class="cm">// ficha de 32 caracteres</span></code></pre>
 </section>
 <section id="sh-hashpassword">
-<h2>Ayudantes del sistema— <code>hashPassword()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">string hashPassword(?string $password)</span>
-<p>PHP integrado <code>password_hash</code> Realiza un hash de contraseñas de forma segura con el algoritmo bcrypt utilizando el método. <strong>Verificación nula:</strong> Si el parámetro está vacío o <code>null</code> Si es así, lanza una excepción para evitar violar la seguridad.</p>
-<pre><code><span class="var">$hashed</span> = <span class="fn">hashPassword</span>(<span class="var">$_POST</span>[<span class="st">'sifre'</span>]);</code></pre>
+<h2>Ayudantes del sistema—<code>hashPassword()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">cadena hashContraseña(?cadena $contraseña)</span>
+<p>PHP integrado<code>password_hash</code>Realiza un hash de contraseñas de forma segura con el algoritmo bcrypt utilizando el método.<strong>Verificación nula:</strong>Si el parámetro está vacío o<code>null</code>Si es así, lanza una excepción para evitar violar la seguridad.</p>
+<pre><code><span class="var">$ hash</span> = <span class="fn">hashContraseña</span>(<span class="var">$_POST</span>[<span class="st">'contraseña'</span>]);</code></pre>
 </section>
 <section id="sh-verifypassword">
-<h2>Ayudantes del sistema— <code>verifyPassword()</code> <span class="tag b-api">SystemMethod</span></h2>
-<span class="ret">bool verifyPassword(?string $password, ?string $hash)</span>
-<p>Compara la contraseña en texto plano ingresada por el usuario con el hash en la base de datos. <strong>Verificación nula:</strong> O la contraseña o el hash están vacíos o <code>null</code> directamente sin ninguna acción <code>false</code> giratorio.</p>
-<pre><code><span class="kw">if</span> (<span class="fn">verifyPassword</span>(<span class="var">$_POST</span>[<span class="st">'sifre'</span>], <span class="var">$user</span>[<span class="st">'password'</span>])) {
-    <span class="cm">// Giriş başarılı</span>
+<h2>Ayudantes del sistema—<code>verifyPassword()</code> <span class="tag b-api">Método del sistema</span></h2>
+<span class="ret">bool verificarContraseña(?cadena $contraseña, ?cadena $hash)</span>
+<p>Compara la contraseña en texto plano ingresada por el usuario con el hash en la base de datos.<strong>Verificación nula:</strong>O la contraseña o el hash están vacíos o<code>null</code>directamente sin ninguna acción<code>false</code>giratorio.</p>
+<pre><code><span class="kw">si</span> (<span class="fn">verificar contraseña</span>(<span class="var">$_POST</span>[<span class="st">'contraseña'</span>], <span class="var">$usuario</span>[<span class="st">'contraseña'</span>])) {
+    <span class="cm">// Iniciar sesión exitosamente</span>
 }</code></pre>
 </section>
 <section id="sh-slugify">
-<h2>Ayudantes del sistema— <code>slugify()</code> <span class="tag b-api">SystemMethod</span></h2>
+<h2>Ayudantes del sistema—<code>slugify()</code> <span class="tag b-api">Método del sistema</span></h2>
 <p>Al registrarse en la base de datos en el backend, genera automáticamente una URL/Slug compatible con SEO a partir de campos como el título o el nombre. Requiere parámetros ilimitados (Variadic).</p>
-<span class="ret">string slugify(string ...$texts)</span>
-<pre><code><span class="var">$slug</span> = <span class="fn">slugify</span>(<span class="var">$_POST</span>[<span class="st">'baslik'</span>]); <span class="cm">// 'benim-guzel-yazim'</span></code></pre>
+<span class="ret">cadena slugify(cadena...$textos)</span>
+<pre><code><span class="var">$babosa</span> = <span class="fn">slugificar</span>(<span class="var">$_POST</span>[<span class="st">'título'</span>]); <span class="cm">// 'mi-hermosa-escritura'</span></code></pre>
 </section>
 <section id="sh-arrayonly">
-<h2>Ayudantes del sistema— <code>arrayOnly()</code> <span class="tag b-api">SystemMethod</span></h2>
-<p>Un gran conjunto de datos (p. ej. <code>$_POST</code>) filtra solo los datos con las claves especificadas (lista blanca). Se utiliza justo antes de las operaciones de registro de la base de datos para evitar vulnerabilidades de seguridad en asignaciones masivas.</p>
-<span class="ret">array arrayOnly(array $array, array $keys)</span>
-<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>
+<h2>Ayudantes del sistema—<code>arrayOnly()</code> <span class="tag b-api">Método del sistema</span></h2>
+<p>Un gran conjunto de datos (p. ej.<code>$_POST</code>) filtra solo los datos con las claves especificadas (lista blanca). Se utiliza justo antes de las operaciones de registro de la base de datos para evitar vulnerabilidades de seguridad en asignaciones masivas.</p>
+<span class="ret">matriz solo matriz (matriz $matriz, matriz $claves)</span>
+<pre><code><span class="var">$postData</span> = <span class="fn">solo matriz</span>(<span class="var">$_POST</span>, [<span class="st">'nombre de usuario'</span>, <span class="st">'contraseña'</span>, <span class="st">'correo electrónico'</span>]);
+<span class="cm">// Los valores manipulados externamente, como ID y rol, se destruyen automáticamente.</span></code></pre>
 </section>
-    <section id="sh-byteid">
-        <h2>Ayudantes del sistema - <code>byteId()</code> <span class="tag b-api">SystemMethod</span></h2>
-<div class="info-box">
-            16 bytes sin procesar nativos, de alto rendimiento y ordenados por tiempo <strong>UUIDv7</strong> produce.
-        </div>
-<p>Columnas de ID en la base de datos <code>BINARY(16)</code> Cuando desee obtener una gran indexación y un rendimiento de ÚNASE manteniéndolo como, cree nuevos registros con esta función.</p>
+<section id="sh-byteid">
+<h2>Ayudantes del sistema -<code>byteId()</code> <span class="tag b-api">Método del sistema</span></h2>
+<div class="info-box">16 bytes sin procesar nativos, de alto rendimiento y ordenados por tiempo<strong>UUIDv7</strong>produce.</div>
+<p>Columnas de ID en la base de datos<code>BINARY(16)</code>Cuando desee lograr una gran indexación y un rendimiento de ÚNASE manteniéndolo como, cree nuevos registros con esta función.</p>
 <div class="code-block">
 <div class="code-header">
 <span class="code-lang">PHP</span>
 </div>
-<pre><code><span class="kw">use</span> Bin\SystemMethod;
-<span class="var">$rawId</span> = SystemMethod::<span class="fn">byteId</span>();
-<span class="cm">// Veya global helper: byteId();</span>
-<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>
-</section>
-    <section id="sh-makeid">
-        <h2>Ayudantes del sistema - <code>makeId()</code> <span class="tag b-api">SystemMethod</span></h2>
-<div class="info-box">
-            Nativo, estándar 36 caracteres <strong>UUIDv7</strong> produce la cuerda.
-        </div>
-<p>en la base de datos <code>CHAR(36)</code> o <code>VARCHAR(36)</code> Si va a utilizarlo y no quiere tratar con datos binarios sin procesar, puede generar UUID directamente en formato de cadena con esta función.</p>
+<pre><code><span class="kw">usar</span> Bin\SystemMethod;
+<span class="var">$ ID crudo</span> = SystemMethod::<span class="fn">ID de byte</span>();
+<span class="cm">// O ayuda global: byteId();</span>
+<span class="var">$db</span>-&gt;<span class="fn">preparar</span>(<span class="st">"INSERTAR EN usuarios (id, nombre) VALORES (?,?)"</span>)-&gt;<span class="fn">ejecutar</span>([<span class="var">$ ID crudo</span>, <span class="st">'Triunfo'</span>]);</code></pre>
+</div>
+</section>
+<section id="sh-makeid">
+<h2>Ayudantes del sistema -<code>makeId()</code> <span class="tag b-api">Método del sistema</span></h2>
+<div class="info-box">Nativo, estándar 36 caracteres<strong>UUIDv7</strong>produce la cuerda.</div>
+<p>en la base de datos<code>CHAR(36)</code>o<code>VARCHAR(36)</code>Si va a utilizarlo y no quiere tratar con datos binarios sin procesar, puede generar UUID directamente en formato de cadena con esta función.</p>
 <div class="code-block">
 <div class="code-header">
 <span class="code-lang">PHP</span>
 </div>
-<pre><code><span class="kw">use</span> Bin\SystemMethod;
-<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>
-</section>
-    <section id="sh-formatid">
-        <h2>Ayudantes del sistema - <code>formatId()</code> <span class="tag b-api">SystemMethod</span></h2>
-<div class="info-box">
-            Convierte UUID binarios sin formato de 16 bytes en una cadena estándar de 36 caracteres.
-        </div>
-<p>Lo que sacaste de la base de datos <code>BINARY(16)</code> Pone los datos en un formato legible antes de enviarlos a la interfaz (API/JSON).</p>
+<pre><code><span class="kw">usar</span> Bin\SystemMethod;
+<span class="var">$identificador de cadena</span> = SystemMethod::<span class="fn">hacerId</span>();
+<span class="cm">// Salida de muestra: 0190ed84-3f12-7a91-8bc4-91823741abcd</span></code></pre>
+</div>
+</section>
+<section id="sh-formatid">
+<h2>Ayudantes del sistema -<code>formatId()</code> <span class="tag b-api">Método del sistema</span></h2>
+<div class="info-box">Convierte UUID binarios sin formato de 16 bytes en una cadena estándar de 36 caracteres.</div>
+<p>Lo que sacaste de la base de datos<code>BINARY(16)</code>Pone los datos en un formato legible antes de enviarlos a la interfaz (API/JSON).</p>
 <div class="code-block">
 <div class="code-header">
 <span class="code-lang">PHP</span>
 </div>
-<pre><code><span class="kw">use</span> Bin\SystemMethod;
-<span class="var">$user</span> = <span class="var">$db</span>-&gt;<span class="fn">query</span>(<span class="st">"SELECT id FROM users LIMIT 1"</span>)-&gt;<span class="fn">fetch</span>();
-<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>
-</section>
-    <section id="sh-intid">
-        <h2>Ayudantes del sistema - <code>intId()</code> <span class="tag b-api">SystemMethod</span></h2>
-<div class="info-box">
-            Seguro, aleatorio <code>INT</code> Genera identificación. (Máximo 9 dígitos)
-        </div>
+<pre><code><span class="kw">usar</span> Bin\SystemMethod;
+<span class="var">$usuario</span> = <span class="var">$db</span>-&gt;<span class="fn">consulta</span>(<span class="st">"SELECCIONAR identificación DE usuarios LÍMITE 1"</span>)-&gt;<span class="fn">buscar</span>();
+<span class="var">$identificador legible</span> = SystemMethod::<span class="fn">ID de formato</span>(<span class="var">$usuario</span>[<span class="st">'IDENTIFICACIÓN'</span>]);
+<span class="cm">// Salida de muestra: 0190ed84-3f12-7a91-8bc4-91823741abcd</span></code></pre>
+</div>
+</section>
+<section id="sh-intid">
+<h2>Ayudantes del sistema -<code>intId()</code> <span class="tag b-api">Método del sistema</span></h2>
+<div class="info-box">Seguro, aleatorio<code>INT</code>Genera identificación. (Máximo 9 dígitos)</div>
 <p>Es el generador de enteros tradicional que puede utilizar si no desea renunciar al rendimiento de la base de datos tradicional.</p>
 <div class="code-block">
 <div class="code-header">
 <span class="code-lang">PHP</span>
 </div>
-<pre><code><span class="var">$id</span> = <span class="fn">intId</span>(8);
-<span class="cm">// Örnek Çıktı: 49201834</span></code></pre>
-</div>
-</section>
-    <section id="sh-bigintid">
-        <h2>Ayudantes del sistema - <code>bigintId()</code> <span class="tag b-api">SystemMethod</span></h2>
-<div class="info-box">
-            Seguro, aleatorio <code>BIGINT</code> Genera identificación. (15 dígitos predeterminados: límite seguro para JS)
-        </div>
-<p>Si va a utilizar identificaciones numéricas enormes como Snowflake (Twilio), esta función le salvará la vida. Si desea tener más de 15 dígitos, puede importarlos como una cadena para evitar la pérdida de datos.</p>
+<pre><code><span class="var">$identificación</span> = <span class="fn">ID interno</span>(8);
+<span class="cm">// Salida de muestra: 49201834</span></code></pre>
+</div>
+</section>
+<section id="sh-bigintid">
+<h2>Ayudantes del sistema -<code>bigintId()</code> <span class="tag b-api">Método del sistema</span></h2>
+<div class="info-box">Seguro, aleatorio<code>BIGINT</code>Genera identificación. (15 dígitos predeterminados: límite seguro para JS)</div>
+<p>Si va a utilizar identificaciones numéricas enormes como Snowflake (Twitter), esta función le salvará la vida. Si desea tener más de 15 dígitos, puede importarlos como una cadena para evitar la pérdida de datos.</p>
 <div class="code-block">
 <div class="code-header">
 <span class="code-lang">PHP</span>
 </div>
-<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>
+<pre><code><span class="var">$identificación</span> = <span class="fn">bigintId</span>(); <span class="cm">// Devuelve INT de 15 dígitos</span>
+<span class="var">$Id masivo</span> = <span class="fn">bigintId</span>(18, <span class="kw">verdadero</span>); <span class="cm">// devuelve una CADENA de 18 dígitos (seguro para JS)</span></code></pre>
 </div>
-</section>
-    <section id="sh-stringer">
-        <h2>Ayudantes del sistema - <code>stringer()</code> <span class="tag b-api">SystemMethod</span></h2>
-<div class="info-box">
-            Envuelve valores en cadenas para proteger contra la insensibilidad a los números enormes (BIGINT) de Javascript.
-        </div>
+</section>
+<section id="sh-stringer">
+<h2>Ayudantes del sistema -<code>stringer()</code> <span class="tag b-api">Método del sistema</span></h2>
+<div class="info-box">Envuelve valores en cadenas para proteger contra la insensibilidad a los números enormes (BIGINT) de Javascript.</div>
 <p>Protege las variables numéricas (BigInt, etc.) de más de 15 dígitos de los errores de redondeo de Javascript (pérdida de precisión) al imprimirlas en el DOM en la capa Ver.</p>
 <div class="code-block">
 <div class="code-header">
 <span class="code-lang">HTML/PHP</span>
 </div>
-<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 id="sh-otpcoder">
-        <h2>System Helpers - OTP Coder <span class="tag b-api">SystemMethod</span></h2>
-        <div class="info-box">Genera contraseñas de un solo uso (OTP) aleatorias y criptográficamente seguras.</div>
-        <div class="code-block">
-            <pre><code><span class="cm">// Número aleatorio de 6 dígitos</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 dígitos solo letras ('c': minúscula, 'C': mayúscula, 'cC': mixto)</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 dígitos alfanuméricos</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İĞİ ====== -->
+<pre><code><span class="cm">&lt;!-- Lo envolvemos con un larguero para evitar que JS lo corrompa --&gt;</span>
+&lt;button data-id=<span class="st">"&lt;?=</span> <span class="fn">Larguero</span>(<span class="var">$datos</span>[<span class="st">'IDENTIFICACIÓN'</span>]) <span class="st">?&gt;"</span>&gt;Sil&lt;/button&gt;</code></pre>
+</div>
+<section id="sh-otpcoder">
+<h2>Ayudantes del sistema - Codificador OTP<span class="tag b-api">Método del sistema</span></h2>
+<div class="info-box">Genera códigos de autenticación (OTP) aleatorios y criptográficamente seguros.</div>
+<div class="code-block">
+<pre><code><span class="cm">// número aleatorio de 6 dígitos</span>
+<span class="var">$código</span> = <span class="fn">otpInt</span>(<span class="nu">6</span>); <span class="cm">// 482910</span>
+<span class="cm">// Solo letras de 8 dígitos ('c': minúscula, 'C': mayúscula, 'cC': mixta)</span>
+<span class="var">$código</span> = <span class="fn">otpStr</span>(<span class="nu">8</span>, <span class="st">'DO'</span>); <span class="cm">// PKLMDZRA</span>
+<span class="cm">// Letra de 6 dígitos+número (Alfanumérico)</span>
+<span class="var">$código</span> = <span class="fn">otpMix</span>(<span class="nu">6</span>, <span class="st">'DO'</span>); <span class="cm">//9A4X2Z</span></code></pre>
+</div>
+</section>
+</section>
+====== SEGURIDAD API ======
 <section id="api-methods">
-<h2>API: control de métodos HTTP <span class="tag b-sec">ApiControl</span></h2>
-<p><code class="ic">$allowedMethods</code> matriz de ApiControl requiere <strong>antes</strong> debe ser definido. ApiControl bloquea automáticamente las solicitudes de métodos no permitidos leyendo esta cadena. <code class="ic">405 Method Not Allowed</code> Lo rechaza con .</p>
-<pre><code><span class="cm">// Sadece GET ve POST kabul eden bir endpoint</span>
-<span class="var">$allowedMethods</span> = [<span class="st">'GET'</span>, <span class="st">'POST'</span>];
-<span class="fn">require_once</span> ... . <span class="st">'/../app/ApiControl.php'</span>;
-<span class="cm">// Sadece DELETE kabul eden bir endpoint</span>
-<span class="var">$allowedMethods</span> = [<span class="st">'DELETE'</span>];
-<span class="fn">require_once</span> ... . <span class="st">'/../app/ApiControl.php'</span>;</code></pre>
-<p>verificación previa <code class="ic">OPTIONS</code> solicitudes automáticas de CORS <code class="ic">200</code> regresa y el script finaliza; no se requiere intervención manual.</p>
+<h2>API: control de métodos HTTP<span class="tag b-sec">ApiControl</span></h2>
+<p><code class="ic">$allowedMethods</code>matriz de ApiControl requiere<strong>antes</strong>debe ser definido. ApiControl bloquea automáticamente las solicitudes de métodos no permitidos leyendo esta cadena.<code class="ic">405 Method Not Allowed</code>Lo rechaza con .</p>
+<pre><code><span class="cm">// Un punto final que acepta sólo GET y POST</span>
+<span class="var">$métodos permitidos</span> = [<span class="st">'CONSEGUIR'</span>, <span class="st">'CORREO'</span>];
+<span class="fn">requerir_una vez</span> ... . <span class="st">'/../app/ApiControl.php'</span>;
+<span class="cm">// Un punto final que solo acepta DELETE</span>
+<span class="var">$métodos permitidos</span> = [<span class="st">'BORRAR'</span>];
+<span class="fn">requerir_una vez</span> ... . <span class="st">'/../app/ApiControl.php'</span>;</code></pre>
+<p>verificación previa<code class="ic">OPTIONS</code>solicitudes automáticas de CORS<code class="ic">200</code>regresa y el script finaliza; no se requiere intervención manual.</p>
 </section>
 <section id="api-cors">
-<h2>API—CORS <span class="tag b-api">ApiControl (Yorum Satırı)</span></h2>
-<p>Si desea permitir el acceso a API desde otros dominios o aplicaciones móviles <code class="ic">ApiControl.php</code> Active el bloque CORS en él.</p>
-<pre><code><span class="cm">// ApiControl.php içinde — açıklama kaldırılarak aktifleştirilir</span>
-header(<span class="st">"Access-Control-Allow-Origin: https://sizin-domaininiz.com"</span>);
-header(<span class="st">"Access-Control-Allow-Methods: GET, POST, OPTIONS"</span>);
-header(<span class="st">"Access-Control-Allow-Headers: Content-Type, Authorization"</span>);</code></pre>
+<h2>API—CORS<span class="tag b-api">ApiControl (línea de comentarios)</span></h2>
+<p>Si desea permitir el acceso a API desde otros dominios o aplicaciones móviles<code class="ic">ApiControl.php</code>Active el bloque CORS en él.</p>
+<pre><code><span class="cm">// En ApiControl.php – se activa eliminando el comentario</span>
+header(<span class="st">"Control-de-acceso-permitir-origen: https://tu-dominio.com"</span>);
+header(<span class="st">"Métodos de permiso de control de acceso: OBTENER, PUBLICAR, OPCIONES"</span>);
+header(<span class="st">"Acceso-Control-Permitir-Encabezados: Tipo de contenido, Autorización"</span>);</code></pre>
 <div class="alert a-warn">
-<strong>⚠️</strong> En ambiente de producción <code class="ic">*</code> No utilizar (todos los dominios). Especifique claramente la dirección del dominio.
-        </div>
+<strong>⚠️</strong>En ambiente de producción<code class="ic">*</code>No utilizar (todos los dominios). Especifique claramente la dirección del dominio.</div>
 </section>
 <section id="api-rate">
-<h2>API: limitación de velocidad <span class="tag b-api">ApiControl (Yorum Satırı)</span></h2>
-<p>Para evitar que usuarios malintencionados o bots inunden la API <code class="ic">ApiControl.php</code> Puede activar el bloque de limitación de velocidad en él. Regla predeterminada: <strong>60 solicitudes/IP en 60 segundos</strong>.</p>
+<h2>API: limitación de velocidad<span class="tag b-api">ApiControl (línea de comentarios)</span></h2>
+<p>Para evitar que usuarios malintencionados o bots inunden la API<code class="ic">ApiControl.php</code>Puede activar el bloque de limitación de velocidad en él. Regla predeterminada:<strong>60 solicitudes/IP en 60 segundos</strong>.</p>
 <div class="alert a-warn" style="margin-top: 10px; margin-bottom: 20px;">
-<strong>⚠️ Se requiere servidor Redis:</strong> Función de limitación de velocidad <code>\Src\Service\RedisService::getInstance()</code> Funciona usando la clase Redis. Antes de abrir este bloque de código, asegúrese de haber configurado un servicio Redis en su proyecto y <code>src/Service/</code> Asegúrese de crear una clase de conexión en
-        </div>
-<pre><code><span class="cm">// Aynı IP'den 60 saniyede 60'tan fazla istek gelirse:</span>
-http_response_code(<span class="nu">429</span>); <span class="cm">// Too Many Requests</span>
-echo json_encode([<span class="st">'error'</span> =&gt; <span class="st">'Çok fazla istek. Lütfen bekleyin.'</span>]);</code></pre>
+<strong>⚠️ Se requiere servidor Redis:</strong>Función de limitación de velocidad<code>\Src\Service\RedisService::getInstance()</code>Funciona usando la clase Redis. Antes de abrir este bloque de código, asegúrese de haber configurado un servicio Redis en su proyecto y<code>src/Service/</code>Asegúrese de crear una clase de conexión en</div>
+<pre><code><span class="cm">// Si más de 60 solicitudes provienen de la misma IP en 60 segundos:</span>
+http_response_code(<span class="nu">429</span>); <span class="cm">//Demasiadas solicitudes</span>
+echo json_encode([<span class="st">'error'</span> =&gt; <span class="st">'Demasiadas solicitudes. Espere por favor.'</span>]);</code></pre>
 </section>
-<!-- ====== WORKFLOW ====== -->
+====== FLUJO DE TRABAJO ======
 <section id="workflow">
 <h2>Flujo de trabajo completo: formulario de contacto (de principio a fin)</h2>
-<p>Uno <strong>Formulario de contacto</strong> Examinemos paso a paso cómo desarrollar la función en los estándares ArtiFrame de principio a fin.</p>
+<p>Uno<strong>Formulario de contacto</strong>Examinemos paso a paso cómo desarrollar la función en los estándares ArtiFrame de principio a fin.</p>
 <ol class="steps">
 <li>
 <div>
 <strong>Crear Ver Archivo</strong>
-<pre><code>artiframe&gt; <span class="fn">make:view</span> <span class="st">iletisim.php</span>
-<span class="cm">✔  public/iletisim.php</span>
-<span class="cm">✔  public/assets/css/iletisim.css</span>
-<span class="cm">✔  public/assets/js/iletisim.js</span></code></pre>
+<pre><code>artiframe&gt; <span class="fn">hacer:ver</span> <span class="st">contacto.php</span>
+<span class="cm">✔ público/contacto.php</span>
+<span class="cm">✔ público/activos/css/contact.css</span>
+<span class="cm">✔ público/activos/js/contact.js</span></code></pre>
 </div>
 </li>
 <li>
 <div>
 <strong>Crear punto final API</strong>
-<pre><code>artiframe&gt; <span class="fn">make:api</span> <span class="st">standart</span> <span class="st">api/iletisim/gonder.php</span></code></pre>
+<pre><code>artiframe&gt; <span class="fn">hacer:api</span> <span class="st">estándar</span> <span class="st">api/contacto/enviar.php</span></code></pre>
 </div>
 </li>
 <li>
 <div>
 <strong>Formulario HTML de código</strong><br/>
-<code class="ic">public/iletisim.php</code> Agregue el siguiente formulario al archivo:
-                    <pre><code>&lt;form action="/api/iletisim/gonder.php" method="POST"&gt;
-    &lt;?= <span class="fn">csrfField</span>() ?&gt;
+<code class="ic">public/iletisim.php</code>Agregue el siguiente formulario al archivo:<pre><code>&lt;form action="/api/iletisim/gonder.php" method="POST"&gt;
+    &lt;?= <span class="fn">campocsrf</span>() ?&gt;
     &lt;input type="text"  name="ad"      placeholder="Adınız"&gt;
     &lt;input type="email" name="eposta"  placeholder="E-posta"&gt;
     &lt;textarea name="mesaj" placeholder="Mesajınız"&gt;&lt;/textarea&gt;
-    &lt;button type="submit" data-js="<span class="st">iletisim-gonder</span>"&gt;Gönder&lt;/button&gt;
+    &lt;button type="submit" data-js="<span class="st">contacto-enviar</span>"&gt;Gönder&lt;/button&gt;
 &lt;/form&gt;</code></pre>
 </div>
 </li>
 <li>
 <div>
 <strong>Conecte Fetch API con JavaScript</strong><br/>
-<code class="ic">public/assets/js/iletisim.js</code> para presentar:
-                    <pre><code>document.<span class="fn">querySelector</span>(<span class="st">'[data-js="iletisim-gonder"]'</span>).<span class="fn">addEventListener</span>(<span class="st">'click'</span>, async (e) =&gt; {
-    e.<span class="fn">preventDefault</span>();
-    <span class="kw">const</span> formData = <span class="kw">new</span> <span class="fn">FormData</span>(e.target.<span class="fn">closest</span>(<span class="st">'form'</span>));
-    <span class="kw">const</span> res = <span class="kw">await</span> <span class="fn">fetch</span>(<span class="st">'/api/iletisim/gonder.php'</span>, {
-        method: <span class="st">'POST'</span>,
+<code class="ic">public/assets/js/iletisim.js</code>para presentar:<pre><code>document.<span class="fn">selector de consulta</span>(<span class="st">'[datos-js="contacto-enviar"]'</span>).<span class="fn">agregarEventListener</span>(<span class="st">'hacer clic'</span>, async (e) =&gt; {
+    e.<span class="fn">prevenir valor predeterminado</span>();
+    <span class="kw">constante</span> formData = <span class="kw">nuevo</span> <span class="fn">Datos de formulario</span>(e.target.<span class="fn">más cercano</span>(<span class="st">'forma'</span>));
+    <span class="kw">constante</span> res = <span class="kw">esperar</span> <span class="fn">buscar</span>(<span class="st">'/api/contacto/remitente.php'</span>, {
+        method: <span class="st">'CORREO'</span>,
         body: formData
     });
-    <span class="kw">const</span> data = <span class="kw">await</span> res.<span class="fn">json</span>();
-    <span class="fn">console</span>.<span class="fn">log</span>(data);
+    <span class="kw">constante</span> data = <span class="kw">esperar</span> res.<span class="fn">json</span>();
+    <span class="fn">consola</span>.<span class="fn">registro</span>(data);
 });</code></pre>
 </div>
 </li>
 <li>
 <div>
 <strong>Lógica completa del servidor (backend)</strong><br/>
-<code class="ic">public/api/iletisim/gonder.php</code> en el archivo:
-                    <pre><code><span class="kw">&lt;?php</span>
-<span class="var">$allowedMethods</span> = [<span class="st">'POST'</span>];
-<span class="fn">require_once</span> <span class="var">$_SERVER</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/../app/ApiControl.php'</span>;
-<span class="kw">use</span> Bin\SystemMethod;
-<span class="cm">// 1. CSRF Doğrulama</span>
-<span class="kw">if</span> (!<span class="fn">verifyCsrf</span>(<span class="var">$_POST</span>[<span class="st">'csrf_token'</span>] ?? <span class="st">''</span>)) {
-    <span class="fn">jsonResponse</span>([<span class="st">'error'</span> =&gt; <span class="st">'Geçersiz token.'</span>], <span class="nu">403</span>);
+<code class="ic">public/api/iletisim/gonder.php</code>en el archivo:<pre><code><span class="kw">&lt;?php</span>
+<span class="var">$métodos permitidos</span> = [<span class="st">'CORREO'</span>];
+<span class="fn">requerir_una vez</span> <span class="var">$_SERVIDOR</span>[<span class="st">'DOCUMENT_ROOT'</span>] . <span class="st">'/../app/ApiControl.php'</span>;
+<span class="kw">usar</span> Bin\SystemMethod;
+<span class="cm">// 1. Verificación CSRF</span>
+<span class="kw">si</span> (!<span class="fn">verificarCsrf</span>(<span class="var">$_POST</span>[<span class="st">'csrf_token'</span>] ?? <span class="st">''</span>)) {
+    <span class="fn">jsonRespuesta</span>([<span class="st">'error'</span> =&gt; <span class="st">'Token no válido.'</span>], <span class="nu">403</span>);
 }
-<span class="cm">// 2. Veriyi Temizle</span>
-<span class="var">$ad</span>     = <span class="fn">sanitizeString</span>(<span class="var">$_POST</span>[<span class="st">'ad'</span>] ?? <span class="st">''</span>);
-<span class="var">$eposta</span> = <span class="fn">sanitizeEmail</span>(<span class="var">$_POST</span>[<span class="st">'eposta'</span>] ?? <span class="st">''</span>);
-<span class="var">$mesaj</span>  = <span class="fn">sanitizeString</span>(<span class="var">$_POST</span>[<span class="st">'mesaj'</span>] ?? <span class="st">''</span>);
-<span class="cm">// 3. İş Mantığı (Mail gönder, DB'ye kaydet vb.)</span>
-<span class="cm">// ...</span>
-<span class="cm">// 4. Yanıt Ver</span>
-<span class="fn">jsonResponse</span>([<span class="st">'status'</span> =&gt; <span class="st">'success'</span>, <span class="st">'message'</span> =&gt; <span class="st">'Mesajınız alındı.'</span>], <span class="nu">200</span>);</code></pre>
+<span class="cm">// 2. Borrar datos</span>
+<span class="var">$nombre</span>     = <span class="fn">desinfectarString</span>(<span class="var">$_POST</span>[<span class="st">'nombre'</span>] ?? <span class="st">''</span>);
+<span class="var">$correo electrónico</span> = <span class="fn">desinfectarCorreo electrónico</span>(<span class="var">$_POST</span>[<span class="st">'correo electrónico'</span>] ?? <span class="st">''</span>);
+<span class="var">$mensaje</span>  = <span class="fn">desinfectarString</span>(<span class="var">$_POST</span>[<span class="st">'mensaje'</span>] ?? <span class="st">''</span>);
+<span class="cm">// 3. Lógica empresarial (enviar correo electrónico, guardar en base de datos, etc.)</span>
+<span class="cm">//...</span>
+<span class="cm">// 4. Responder</span>
+<span class="fn">jsonRespuesta</span>([<span class="st">'estado'</span> =&gt; <span class="st">'éxito'</span>, <span class="st">'mensaje'</span> =&gt; <span class="st">'Su mensaje ha sido recibido.'</span>], <span class="nu">200</span>);</code></pre>
 </div>
 </li>
 </ol>
 <div class="alert a-success">
-<strong>✅ ¡Completado!</strong> Ha creado un flujo de formulario totalmente seguro y compatible con los estándares con protección XSS, validación CSRF, restricción de métodos HTTP y arquitectura data-js.
-        </div>
+<strong>✅ ¡Completado!</strong>Ha creado un flujo de formulario totalmente seguro y compatible con los estándares con protección XSS, validación CSRF, restricción de métodos HTTP y arquitectura data-js.</div>
 </section>
 </main>
 <script>
     const sections = document.querySelectorAll('section[id], header[id], div.card[id]');
     const links = document.querySelectorAll('.sidebar nav a');
     const observer = new IntersectionObserver((entries) => {
         entries.forEach(entry => {
             if (entry.isIntersecting) {
@@ -4532,7 +4231,6 @@ echo json_encode([<span class="st">'error'</span> =&gt; <span class="st">'Çok f
             }
         });
     }, { rootMargin: '-20% 0px -70% 0px' });
     sections.forEach(s => observer.observe(s));
 </script>
 <script>
@@ -4541,7 +4239,6 @@ echo json_encode([<span class="st">'error'</span> =&gt; <span class="st">'Çok f
         const ctx = canvas.getContext('2d');
         const cw = canvas.width;
         const ch = canvas.height;
         function drawRoundedRect(x, y, w, h, r, fill, stroke) {
             ctx.beginPath();
             ctx.moveTo(x + r, y);
@@ -4562,7 +4259,6 @@ echo json_encode([<span class="st">'error'</span> =&gt; <span class="st">'Çok f
                 ctx.stroke();
             }
         }
         function drawLine(x1, y1, x2, y2, color) {
             ctx.beginPath();
             ctx.moveTo(x1, y1);
@@ -4578,7 +4274,6 @@ echo json_encode([<span class="st">'error'</span> =&gt; <span class="st">'Çok f
             ctx.fillStyle = color;
             ctx.fill();
         }
         function drawPath(points, color) {
             if(points.length < 2) return;
             ctx.beginPath();
@@ -4599,7 +4294,6 @@ echo json_encode([<span class="st">'error'</span> =&gt; <span class="st">'Çok f
             ctx.fillStyle = color;
             ctx.fill();
         }
         function drawText(text, x, y, color, font = "14px Inter", align = "center") {
             ctx.fillStyle = color;
             ctx.font = font;
@@ -4607,40 +4301,31 @@ echo json_encode([<span class="st">'error'</span> =&gt; <span class="st">'Çok f
             ctx.textBaseline = "middle";
             ctx.fillText(text, x, y);
         }
         const nodes = [
-            { id: 'n1', x: 20, y: 220, w: 170, h: 50, text: "¿Dónde se ejecutará?", bg: "#1c2128", border: "#58a6ff", textColor: "#e6edf3" },
-            { id: 'n2_local', x: 250, y: 80, w: 220, h: 50, text: "Solo Localhost / Individual\n(Sin red externa)", bg: "#1c2128", border: "#30363d", textColor: "#e6edf3" },
-            { id: 'n2_net', x: 250, y: 320, w: 200, h: 50, text: "Abierto a la Red / Internet\n(SaaS, Intranet, Web)", bg: "#1c2128", border: "#30363d", textColor: "#e6edf3" },
-            { id: 'n3_free', x: 550, y: 85, w: 140, h: 40, text: "✅ Eres libre", bg: "rgba(0,157,108,0.12)", border: "#00c88c", textColor: "#00c88c" },
-            { id: 'n4_agpl', x: 510, y: 320, w: 180, h: 50, text: "¿Será publicado como\nOpen Source AGPLv3?", bg: "#1c2128", border: "#30363d", textColor: "#e6edf3" },
-            { id: 'n5_yes', x: 760, y: 220, w: 220, h: 50, text: "✅ Eres libre\n(Nombre y Github requeridos)", bg: "rgba(0,157,108,0.12)", border: "#00c88c", textColor: "#00c88c" },
-            { id: 'n6_no', x: 760, y: 400, w: 140, h: 40, text: "¿Cuál es el propósito?", bg: "#1c2128", border: "#30363d", textColor: "#e6edf3" },
-            { id: 'n7_sell', x: 960, y: 340, w: 160, h: 50, text: "❌ Imposible\n(Infracción de AGPLv3)", bg: "rgba(248,81,73,0.12)", border: "#f85149", textColor: "#f85149" },
-            { id: 'n8_corp', x: 960, y: 440, w: 180, h: 50, text: "💼 Licencia Dual Comercial\n(Contacto Artilingo)", bg: "rgba(227,179,65,0.12)", border: "#e3b341", textColor: "#e3b341" }
+            { id: 'n1', x: 20, y: 220, w: 170, h: 50, text: "Proje Nerede Çalışacak?", bg: "#1c2128", border: "#58a6ff", textColor: "#e6edf3" },
+            { id: 'n2_local', x: 250, y: 80, w: 220, h: 50, text: "Sadece Localhost / Bireysel\n(Dış Ağ Bağlantısı Yok)", bg: "#1c2128", border: "#30363d", textColor: "#e6edf3" },
+            { id: 'n2_net', x: 250, y: 320, w: 200, h: 50, text: "Ağa / İnternete Açık\n(SaaS, İntranet, Web)", bg: "#1c2128", border: "#30363d", textColor: "#e6edf3" },
+            { id: 'n3_free', x: 550, y: 85, w: 140, h: 40, text: "✅ Özgürsün", bg: "rgba(0,157,108,0.12)", border: "#00c88c", textColor: "#00c88c" },
+            { id: 'n4_agpl', x: 510, y: 320, w: 180, h: 50, text: "AGPLv3 Açık Kaynak\nYayınlanacak Mı?", bg: "#1c2128", border: "#30363d", textColor: "#e6edf3" },
+            { id: 'n5_yes', x: 760, y: 220, w: 220, h: 50, text: "✅ Özgürsün\n(İsim & Github Reposu Şart)", bg: "rgba(0,157,108,0.12)", border: "#00c88c", textColor: "#00c88c" },
+            { id: 'n6_no', x: 760, y: 400, w: 140, h: 40, text: "Amacı Nedir?", bg: "#1c2128", border: "#30363d", textColor: "#e6edf3" },
+            { id: 'n7_sell', x: 960, y: 340, w: 160, h: 50, text: "❌ İmkansız\n(AGPLv3 İhlali)", bg: "rgba(248,81,73,0.12)", border: "#f85149", textColor: "#f85149" },
+            { id: 'n8_corp', x: 960, y: 440, w: 180, h: 50, text: "💼 Ticari Çift-Lisans\n(Artilingo İletişim)", bg: "rgba(227,179,65,0.12)", border: "#e3b341", textColor: "#e3b341" }
         ];
         ctx.fillStyle = "#0d1117";
         ctx.fillRect(0, 0, cw, ch);
         drawPath([{x:190, y:245}, {x:220, y:245}, {x:220, y:105}, {x:250, y:105}], "#30363d");
         drawPath([{x:190, y:245}, {x:220, y:245}, {x:220, y:345}, {x:250, y:345}], "#30363d");
         drawLine(470, 105, 550, 105, "#30363d");
         drawLine(450, 345, 510, 345, "#30363d");
         drawPath([{x:690, y:345}, {x:725, y:345}, {x:725, y:245}, {x:760, y:245}], "#30363d");
-        drawText("Sí", 740, 235, "#00c88c", "12px Inter");
+        drawText("Evet", 740, 235, "#00c88c", "12px Inter");
         drawPath([{x:690, y:345}, {x:725, y:345}, {x:725, y:420}, {x:760, y:420}], "#30363d");
-        drawText("No", 740, 410, "#f85149", "12px Inter");
+        drawText("Hayır", 740, 410, "#f85149", "12px Inter");
         drawPath([{x:900, y:420}, {x:930, y:420}, {x:930, y:365}, {x:960, y:365}], "#30363d");
-        drawText("Vender/Distribuir", 945, 355, "#f85149", "11px Inter");
+        drawText("Satmak/Dağıtmak", 945, 355, "#f85149", "11px Inter");
         drawPath([{x:900, y:420}, {x:930, y:420}, {x:930, y:465}, {x:960, y:465}], "#30363d");
-        drawText("Mi propio proyecto (SaaS)", 945, 455, "#e3b341", "11px Inter");
+        drawText("Kendi Projem (SaaS)", 945, 455, "#e3b341", "11px Inter");
         nodes.forEach(n => {
             drawRoundedRect(n.x, n.y, n.w, n.h, 6, n.bg, n.border);
             const lines = n.text.split('\n');
@@ -4653,14 +4338,10 @@ echo json_encode([<span class="st">'error'</span> =&gt; <span class="st">'Çok f
         });
     }
 </script>
-        <a href="../../public/index.html" class="btn-back-home" style="position: fixed; bottom: 20px; left: 20px; z-index: 9999; background: var(--surface, #111); color: var(--text-primary, #fff); border: 1px solid var(--border, #333); padding: 10px 15px; border-radius: 8px; text-decoration: none; font-size: 14px; font-weight: 500; display: flex; align-items: center; gap: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.5); transition: all 0.2s;">
-            <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M19 12H5M12 19l-7-7 7-7"/></svg>
-            Home
-        </a>
-        <style>
+<a class="btn-back-home" href="../../public/index.html" style="position: fixed; bottom: 20px; left: 20px; z-index: 9999; background: var(--surface, #111); color: var(--text-primary, #fff); border: 1px solid var(--border, #333); padding: 10px 15px; border-radius: 8px; text-decoration: none; font-size: 14px; font-weight: 500; display: flex; align-items: center; gap: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.5); transition: all 0.2s;">
+<svg fill="none" height="16" stroke="currentColor" stroke-width="2" viewbox="0 0 24 24" width="16"><path d="M19 12H5M12 19l-7-7 7-7"></path></svg>Hogar</a>
+<style>
             .btn-back-home:hover { border-color: var(--accent, #00E599) !important; color: var(--accent, #00E599) !important; transform: translateY(-2px); }
         </style>
 </body>
 </html>