# CRUD-L Casi toda aplicación que maneja datos repite las mismas cinco operaciones sobre cada tabla: **C**rear, leer (**R**ead), actualizar (**U**pdate), borrar (**D**elete) y **L**istar. El marco **CRUD-L** de dkl-web las implementa una sola vez, siguiendo el patrón MVC (modelo, vista, controlador): usted publica una entidad con una regla de rutas y obtiene, sin escribir código, un servicio REST en JSON y, con dos vistas, una interfaz HTML con formularios. Sirve para cualquier sitio o servicio que trabaje con una base de datos. Esta sección documenta el marco genérico; una aplicación puede agregar encima su propio modelo de acciones, privilegios y eventos, que pertenece a esa aplicación y no al marco. Flujo del controlador CRUD-L: rutas, punto de entrada, análisis, modelo, conexión, operación y vista ## Alcance del marco **Lo que hace:** - Determina la operación (create, read, update, delete, list) por el método HTTP, la presencia del identificador y el encabezado `Accept`. - Abre la conexión a la base de datos, incluida la suplantación de identidad a partir de una sesión ya resuelta. - Implementa las cinco operaciones sobre tablas con el patrón de diseño de Devkron (`sys_pk`, `sys_guid`, `sys_recver`...). - Guarda entidades maestro-detalle dentro de una transacción. - Elige y ejecuta la vista: HTML (con el patrón PRG) o JSON. **Lo que no hace:** - No implementa autorización por operación, entidad o campo. Los permisos efectivos son los que la base de datos concede a la identidad de la conexión. - No obtiene el token de sesión: espera que el `auth.dk` del sitio ya haya armado `@http_context/session`. - No impone un modelo de acciones, eventos ni reglas de negocio. - No pone ni quita bloqueos pesimistas (los respeta al guardar). - No procesa archivos (`multipart/form-data`); para eso está la [API FSO](/es/devkron/2.0/marcos/fso/). ## Ejemplo mínimo Una entidad `cliente` sobre la tabla del mismo nombre, sin código propio. En el sitio `web/misitio.localhost/`: **`_protected/routes.map`** ```text /tienda/{_entities_type}/{_entity_id?} > tienda/entry-point.dkl ``` **`tienda/entry-point.dkl`** ```dkl #include "dkli.dkh" #! module "Configuración del CRUD-L de la tienda" { #include "functions.dkh" #include "serialize.dkh" #include "dbr.dkh" #include "crudl/crudl.dk" // Rutas @path_root = "web/misitio.localhost" @base_path = "tienda/entidades" @dbmvc_path = "crudl/" do crudl.load_config() do crudl.loadRoutesJSON() // Comportamiento y vistas (valores de la plantilla crudl/entry-point.dkl) @auto_crud = @true @db_engine = "MY_SQL" @list_view = "list.dk" @form_view = "form.dk" @error_view = "error.dk" @entity_id_blank = "_new" @dkl_view_ext = ".dk" @websencia_ext = ".jsnwm" // Conexión constante @crudl.qname = "principal@tienda" @crudl.user = "web" @crudl.pwd = "MiClave#2026" // Suplantación de identidad (solo si llega ?ws=...) @ws = @@(@http_context,"request/get/ws") @crudl.access_privilege = '{"access":[{"workspace":"' + @ws + '"}]}' #include "crudl/controller.dkl" } ``` Con eso quedan disponibles (respuestas reales con MySQL 8): ```text POST /tienda/cliente/ → {"sys_pk":1,"sys_guid":"3169...","sys_recver":0,...,"codigo":"CLI-0001","nombre":"Abarrotes López",...} GET /tienda/cliente/ → [ {...}, {...} ] GET /tienda/cliente/1 → {"sys_pk":1, ...} GET /tienda/cliente/_new → {} PATCH /tienda/cliente/1 → la entidad actualizada, con sys_recver + 1 DELETE /tienda/cliente/2 → 204 sin cuerpo ``` Para una interfaz HTML basta con agregar `tienda/entidades/cliente/form.dk` y `list.dk` ([Vistas](/es/devkron/2.0/marcos/crudl/vistas.md)). La receta completa, con la tabla, las pruebas y las vistas, está en la guía [CRUD completo con CRUD-L sobre MySQL](/es/devkron/2.0/guias/crud-mysql.md). **Defina todas las variables del ejemplo.** El ejemplo mínimo de la documentación 1.0 omitía `@entity_id_blank` y las variables de vistas; en 2.0, sin `@entity_id_blank`, toda lectura de una entidad (`GET /tienda/cliente/1`) falla con `Variable global '@entity_id_blank' no definida`. Copie siempre la plantilla `crudl/entry-point.dkl` de la instalación. ## Estructura de una entidad Cada tipo de entidad es una carpeta con su nombre bajo `@path_root` + `@base_path`: ```text web/misitio.localhost/tienda/entidades/ ├── routes.json (opcional) enmascaramiento de URL ├── list.dk (opcional) vista de lista común a todas las entidades ├── cliente/ │ ├── model.dk (opcional) modelo propio │ ├── controller.dk (opcional) controlador propio │ ├── form.dk (opcional) vista de formulario │ └── list.dk (opcional) vista de lista └── factura/ └── model.dk ``` Ninguno es obligatorio. Sin `model.dk` se usa el modelo genérico (`crudl/entity.dk`) sobre la tabla que se llama como la entidad; sin vistas se usan las genéricas de `crudl/`, que solo muestran el contexto en JSON (sirven para diagnóstico). ## Contenido | Página | Qué aprenderá | |---|---| | [Instalación y punto de entrada](/es/devkron/2.0/marcos/crudl/instalacion.md) | Archivos del marco, el `entry-point.dkl` y todas sus variables, otros motores de base de datos | | [Enrutamiento y enmascaramiento de URL](/es/devkron/2.0/marcos/crudl/enrutamiento.md) | Parámetros que reconoce el controlador, `routes.map`, `crudl.routes.pattern`, `crudl.routes.entity`, `routes.json` | | [El controlador](/es/devkron/2.0/marcos/crudl/controlador.md) | Cómo elige la operación, carga útil, campos de control `---`, `controller.dk`, subrecursos con `_view`, errores | | [Conexión a la base de datos y sesión](/es/devkron/2.0/marcos/crudl/conexion-y-sesion.md) | Los tres modos de conexión en cascada, nombre cualificado, suplantación de identidad | | [El modelo](/es/devkron/2.0/marcos/crudl/modelo.md) | Variables del modelo, punteros de función, filtros, transacciones, borrado lógico, concurrencia | | [Entidades maestro-detalle](/es/devkron/2.0/marcos/crudl/maestro-detalle.md) | `@childs`, `entity.child`, cómo se guardan y borran las partidas | | [Vistas](/es/devkron/2.0/marcos/crudl/vistas.md) | `@crud_context`, resolución de vistas, lista, formulario, error, plantilla envolvente, scripts, Websencia, JSON | | [Patrón PRG y redirección](/es/devkron/2.0/marcos/crudl/prg-y-redireccion.md) | Alta y edición con un solo formulario, destino de la redirección, `---from_url`, `_redirect=disabled` | | [Servicios REST](/es/devkron/2.0/marcos/crudl/rest.md) | Cada operación como servicio JSON: método, ruta, cuerpo, respuesta y códigos | | [Archivo de configuración .crudl](/es/devkron/2.0/marcos/crudl/configuracion.md) | Vistas, scripts y plantillas distintos por host sin tocar el código | | [Referencia](/es/devkron/2.0/marcos/crudl/referencia.md) | Todos los parámetros, variables, punteros, funciones y códigos en tablas |