# Guía de aprendizaje de DKL Esta guía ordena la documentación de Devkron 2.0 como un curso. Es la versión actualizada de los temarios *Fundamentos de programación con Devkron* y *Programación efectiva con Devkron*. **Para quién:** programadores con alguna formación previa que empiezan con Devkron. Al terminar la primera parte podrá escribir programas de consola, servicios JSON y sitios web con acceso a bases de datos; la segunda parte lo lleva a organizar y mantener un sistema web completo, con varios módulos sobre una misma base de datos. **Duración de referencia:** unas 22 horas para los fundamentos (11 sesiones de 2 horas). ## Parte 1. Fundamentos de programación con Devkron ### Sesión 1. Primeros pasos y lenguaje imperativo 1. Configure el entorno: [Instalación](/es/devkron/2.0/instalacion/). 2. Ejecute su primer programa "Hola mundo": [Primeros pasos](/es/devkron/2.0/lenguaje/declarativo/primeros-pasos.md). 3. Variables y tipos de datos: [Variables](/es/devkron/2.0/lenguaje/imperativo/variables.md). 4. Expresiones y operadores: [Expresiones y operadores](/es/devkron/2.0/lenguaje/imperativo/expresiones-y-operadores.md). 5. Control de flujo (`if`, `switch`, `break`, `return`, `do`), inclusión (`#include`, `include`) y ciclos (`for`, `while`, `repeat`): [Sentencias](/es/devkron/2.0/lenguaje/imperativo/sentencias.md). 6. Registros (`new`, `using`, morsa `:=`): [Registros](/es/devkron/2.0/lenguaje/imperativo/registros.md). Ejercicio: un programa que recibe una lista de partidas en JSON y calcula subtotal, IVA y total. ```dkl #include "dkli.dkh" #! program "totales" { #include "functions.dkh" #include "serialize.dkh" ref partidas = from.json("[{\"cant\":3,\"precio\":19.99},{\"cant\":1,\"precio\":1500}]") subtotal = 0 for i = 0; i < list.count(partidas) { ref p = list.obj(partidas, i) subtotal = subtotal + @@(p, "#cant") * @@(p, "#precio") } iva = round(subtotal * 0.16, 2) new res { @"subtotal": round(subtotal, 2) @"iva": iva @"total": round(subtotal, 2) + iva } do print(to.json(res)) } ``` ```text {"subtotal":1559.97,"iva":249.60,"total":1809.57} ``` ### Sesión 2. Funciones y organización 1. Funciones, parámetros, retorno y recursión: [Funciones](/es/devkron/2.0/lenguaje/imperativo/funciones.md). 2. Funciones abiertas (`go`, `expose`, `that`) y referencias a funciones (`point`): [Funciones](/es/devkron/2.0/lenguaje/imperativo/funciones.md). 3. Espacios de nombres, `alias`, `namespace` y bibliotecas propias: [Organización del programa](/es/devkron/2.0/lenguaje/imperativo/organizacion.md). 4. Manejo de errores: [Excepciones](/es/devkron/2.0/lenguaje/imperativo/excepciones.md). ### Sesión 3. Bibliotecas de funciones 1. [Funciones incorporadas](/es/devkron/2.0/lenguaje/funciones-incorporadas/). 2. `functions.dkh` (cadenas, listas, registros, archivos), `serialize.dkh` (JSON y XML) y `webcl.dkh` (HTTP y correo): [Bibliotecas](/es/devkron/2.0/bibliotecas/). 3. Listas y tablas: [Listas y tablas](/es/devkron/2.0/lenguaje/imperativo/listas-y-tablas.md). 4. Lo nuevo de 2.0 que simplifica el código: [Novedades](/es/devkron/2.0/lenguaje/novedades-2.0/) (bloques `$$`, flechas, `list.*`). ### Sesión 4. Acceso a bases de datos Con `dbr.dkh` ([Bibliotecas](/es/devkron/2.0/bibliotecas/)): - configurar conexiones (`connections.xml`); - conectarse a una base de datos; - obtener datos (consultas); - insertar y actualizar; - ejecutar SQL con parámetros (`@nombre`, nunca concatenar valores del cliente); - manejar transacciones. ### Sesión 5. Desarrollo web: fundamentos 1. La pila de Devkron Applications Server (nginx o IIS + FastCGI de `dkl`) y el flujo de una solicitud HTTP: [Desarrollo web](/es/devkron/2.0/marcos/). 2. Sintaxis declarativa, imperativa y la conmutación de contextos: [Lenguaje declarativo](/es/devkron/2.0/lenguaje/declarativo/), [Contextos](/es/devkron/2.0/lenguaje/declarativo/contextos.md), [Marcas de expresión](/es/devkron/2.0/lenguaje/declarativo/marcas-de-expresion.md). ### Sesión 6. Responder - Configurar Devkron como servidor de aplicaciones: [Instalación](/es/devkron/2.0/instalacion/). - Responder XML y HTML, texto y JSON, y un archivo, con [`@http_context`](/es/devkron/2.0/lenguaje/imperativo/temas-avanzados.md): [Desarrollo web](/es/devkron/2.0/marcos/). ### Sesión 7. Enrutamientos `routes.map`, `ext.map` y rutas amigables: [Desarrollo web](/es/devkron/2.0/marcos/). ### Sesiones 8 a 11. Proyecto integrador: buzón de quejas y sugerencias Una empresa necesita: - un sitio web público con un formulario para recibir quejas o sugerencias (`buzon.localhost`); - una aplicación interna (*backoffice*, `admin.localhost`) para administrar usuarios, consultar los mensajes recibidos y marcarlos como atendidos con una respuesta. Tablas: | `mensajes` | `usuarios` | |---|---| | `nombre varchar(100)` | `id varchar(32)` | | `correo varchar(80)` | `pwd varchar(32)` | | `telefono varchar(15)` | `nombre varchar(100)` | | `empresa varchar(100)` | | | `mensaje text` | | | `respuesta text` | | | `atendio varchar(32)` | | | `queja bool` | | Actividades: 1. Diseñar la base de datos (o describirla con [DDM](/es/devkron/2.0/bibliotecas/ddm/)). 2. Configurar los sitios `admin.localhost` y `buzon.localhost` en nginx. 3. Estructurar `buzon.localhost` y maquetar el formulario. 4. Estructurar `admin.localhost`: modelo y controlador de usuarios, lista y formulario de usuarios; modelo y controlador de mensajes, lista y formulario para atenderlos; inicio de sesión. Vea [CRUD-L](/es/devkron/2.0/marcos/crudl/). 5. Maquetar la página de inicio. 6. Programar `index.dkl`. ## Parte 2. Programación efectiva con Devkron Un sistema web que crece (clientes, productos, pedidos, usuarios con distintos permisos) se mantiene mejor si se arma con módulos que comparten conceptos comunes y una base de datos relacional central. Temario: 1. **Conceptos comunes**: enrutamiento, usuarios y privilegios, manejo de errores. Vea [Servidor web](/es/devkron/2.0/marcos/servidor-web/) y [Autenticación](/es/devkron/2.0/marcos/autenticacion/). 2. **Modelo de datos**: campos de control, sesiones, concurrencia y bloqueos. Vea [Modelo de datos de Devkron](/es/devkron/2.0/bibliotecas/motor/dbr/modelo.md) y [Transacciones](/es/devkron/2.0/bibliotecas/motor/dbr/transacciones.md). 3. **Devkron Data Model (DDM)**: abstracción, entidades, definición de columnas, definición de índices, y cómo evolucionar el esquema de una base con datos. Vea [DDM](/es/devkron/2.0/bibliotecas/ddm/). 4. **Aplicaciones**: modelo, vistas, controlador y servicios. Vea [CRUD-L](/es/devkron/2.0/marcos/crudl/) y [Marcos de trabajo](/es/devkron/2.0/marcos/). 5. **Procesos fuera de la petición web**: tareas programadas, trabajo en paralelo y bitácoras. Vea [Tarea programada](/es/devkron/2.0/guias/tarea-programada.md), [threads.dkh](/es/devkron/2.0/bibliotecas/estandar/threads.md) y [log.dkh](/es/devkron/2.0/bibliotecas/estandar/log.md). 6. **Integraciones**: consumir y publicar API JSON. Vea [API externa](/es/devkron/2.0/guias/api-externa.md) y [Servicio REST JSON](/es/devkron/2.0/guias/servicio-rest-json.md). 7. **Instalación y actualización**: datos iniciales, esquema de datos y despliegue de una versión nueva sin perder datos. Vea [DDM en producción](/es/devkron/2.0/bibliotecas/ddm/produccion.md). ## Consejos para no atorarse - Lea [Errores frecuentes](/es/devkron/2.0/lenguaje/errores-frecuentes.md) antes de su primer programa grande: casi todos los tropiezos de principiante están ahí. - Ejecute seguido. `dkl programa.dkl -hide-log` es rápido y el código de salida le dice si falló. - Use `print` y [`dump_vars()`](/es/devkron/2.0/lenguaje/funciones-incorporadas/depuracion.md) para ver qué tiene cada variable.