# Arquitectura de Devkron 2.0
Esta página explica cómo se arman las piezas de Devkron: qué hace cada una, dónde vive en la instalación y cuándo interviene. Conocerla ayuda a ubicar un problema (¿es nginx, el servidor FastCGI, el programa o la base de datos?) y a decidir qué configurar.
## Un solo ejecutable: `dkl`
Todo Devkron se ejecuta con un solo programa, `dkl` (`dkl.exe` en Windows), autónomo: trae su propio runtime y no requiere instalar nada más:
| Modo | Comando | Para qué |
|---|---|---|
| Consola | `dkl programa.dkl [opciones]` | tareas, reportes, procesos por lotes, pruebas |
| Servidor FastCGI | `dkl -fastcgi fastcgi.json` | sitios y servicios web detrás de nginx o IIS |
| Licencia | `dkl -license` | ver la licencia instalada |
| Cifrar fuentes | `dkl -crypto archivo` | distribuir un programa sin su código legible |
Las opciones están en [Ejecutar programas de consola](/es/devkron/2.0/instalacion/consola.md).
## El intérprete
El intérprete lee el archivo `.dkl` y los que incluye con `#include`, los **analiza** (los convierte en un árbol de elementos, como un XML) y **ejecuta** la parte imperativa. Lo declarativo que se imprime forma la **salida** del programa: en la consola se muestra; en el servidor web es el cuerpo de la respuesta.
En 2.0 el intérprete hace tres cosas que lo vuelven mucho más rápido sin que usted cambie su código:
- **Caché del árbol analizado**: en el servidor FastCGI cada archivo se analiza una sola vez y se revalida si cambia. Editar un `.dkl` en caliente sigue funcionando.
- **Salida directa**: lo que el programa imprime se escribe directo a un búfer, en lugar de construir el árbol y serializarlo al final. La salida es idéntica byte por byte.
- **Compilación a código nativo** (opcional, apagada por omisión en el servidor): compila los programas a código nativo y los guarda en una caché firmada.
Detalle y cuándo encender cada una en [Rendimiento y compilación nativa](/es/devkron/2.0/migracion/rendimiento.md).
## El servidor FastCGI
FastCGI es el protocolo con el que un servidor web (nginx, IIS) le pasa cada petición a un proceso que la atiende. `dkl -fastcgi` abre un **socket Unix** o un **puerto TCP**, recibe las peticiones y las atiende en paralelo, cada una aislada de las demás.
El servidor de 2.0 es propio, sin dependencias de otros servidores web: soporta socket Unix e IPv6, límites de tamaño del cuerpo y de los encabezados, tiempos de espera reales y envía el código HTTP que fija el programa. Se configura con `fastcgi.json`: vea [Servidor FastCGI](/es/devkron/2.0/instalacion/fastcgi.md).
## El controlador HTTP
El servidor FastCGI no decide qué archivo ejecutar: eso lo hace un **programa DKL**, el controlador (`fastcgi/http.dkl`), que se ejecuta en cada petición. Con el host y la URI de la petición:
1. elige la carpeta del sitio (`web//`, o `web/` si no hay una para ese host);
2. aplica los alias de host (`fastcgi/alias.dkl`) y el enrutamiento (`fastcgi/routing.dkl`, `routes.map`, `ext.map`, `paths.map`);
3. busca el documento predeterminado (`index.dkl`, `index.html`…) y aplica la autorización (`auth.dk`);
4. entrega el archivo estático con su tipo MIME (`fastcgi/mime.dkl`) o **ejecuta** el `.dkl`;
5. si el programa falla, responde la página de error (`fastcgi/500.dkl`) con estado 500; si no existe, la de `fastcgi/404.dkl`.
Como el controlador está escrito en DKL, se puede adaptar. Cómo programar sobre este flujo (`@http_context`, mapas de rutas, respuestas HTML, JSON o archivos) está en [Servidor web](/es/devkron/2.0/marcos/servidor-web/).
## Las bibliotecas
Las bibliotecas son archivos `.dkh` que se incluyen con `#include` y, casi siempre, una DLL de .NET que hace el trabajo:
| Grupo | Ejemplos | Dónde |
|---|---|---|
| Del motor | `functions.dkh`, `serialize.dkh` (JSON y XML), `dbr.dkh` (bases de datos), `webcl.dkh` (HTTP y correo) | vienen con la distribución |
| Estándar nuevas de 2.0 | `http.dkh`, `threads.dkh`, `zip.dkh`, `time.dkh`, `hash.dkh`… | vienen con la distribución |
| De terceros | `csv.dkh`, `xlsx.dkh`, `image.dkh`, `markdown.dkh`… | se instalan aparte |
| Extensiones propias | cualquier DLL que su aplicación cargue con `_import_library` | junto a `dkl` |
Vea [Bibliotecas](/es/devkron/2.0/bibliotecas/) y, para instalarlas, [Extensiones .NET](/es/devkron/2.0/instalacion/extensiones-net.md) y [Bibliotecas de terceros y marcos](/es/devkron/2.0/instalacion/bibliotecas-y-marcos.md).
## Los marcos de trabajo
Un marco es un conjunto de programas DKL que resuelve un tipo de aplicación completo: **CRUD-L** (altas, bajas, cambios, consultas y listas sobre tablas), **FSO** (operaciones con archivos por HTTP), **webauth** (autenticación), **website** y los componentes de interfaz `uie`. Se publican en el repositorio `dkl-web` y se copian en la carpeta de Devkron. Vea [Marcos de trabajo](/es/devkron/2.0/marcos/).
## La capa de datos y los adaptadores
`dbr.dkh` es la biblioteca para bases de datos relacionales. No se conecta directamente: busca el **nombre cualificado** de la conexión (`ventas@miapp`) en el repositorio `connections.xml`, y el **adaptador** del motor correspondiente, registrado en `adapters.xml`, hace el trabajo:
| Motor | Adaptador | Versiones probadas en 2.0 |
|---|---|---|
| MySQL | `MySqlAdapter.dll` | 8.0 en adelante |
| SQL Server | `SQLSvrAdapter.dll` | 2017, 2019 y 2022 |
| PostgreSQL | `PostgreAdapter.dll` | 16 |
| Firebird | `FirebirdSqlAdapter.dll` | 2.5, 3.0, 4.0 y 5.0 |
Así, el mismo programa cambia de servidor de base de datos con solo editar `connections.xml`. Vea [Conexiones a bases de datos](/es/devkron/2.0/instalacion/conexiones.md).
## Dónde está cada pieza en la instalación
```text
/opt/devkron/ (C:\devkron en Windows; algunas instalaciones usan /usr/devkron)
├── dkl ejecutable: consola y servidor FastCGI
├── Devkron*.dll, *Adapter.dll motor, bibliotecas, adaptadores y drivers
├── System.*.dll, lib*.so runtime incluido en la distribución
├── dkli.dkh, functions.dkh … cabeceras DKL
├── fastcgi.json configuración del servidor FastCGI
├── fastcgi/ controlador HTTP en DKL
├── web/ sitios: web// o web/ para el sitio predeterminado
├── adapters.xml adaptadores registrados
├── connections.xml conexiones (lo crea usted)
└── devkron.license licencia (la instala usted)
```
La lista completa de archivos está en [Instalar en Linux](/es/devkron/2.0/instalacion/linux.md).