# Instalación y punto de entrada CRUD-L viene con la distribución de Devkron 2.0 LTS, en la carpeta `crudl/` de la instalación (junto a `web/` y `fastcgi/`). Todos los sitios del servidor comparten esos archivos; cada sistema que lo usa tiene su propio **punto de entrada** con su configuración. ## Archivos del marco | Archivo | Propósito | |---|---| | `crudl.dk` | Funciones de configuración y enrutamiento (`crudl.load_config`, `crudl.loadRoutesJSON`, `crudl.routes.*`, `crudl.database`). Se incluye desde el punto de entrada | | `controller.dkl` | Controlador principal: analiza la petición, elige modelo y vista, abre la conexión, ejecuta la operación y responde | | `entity.dk` | Modelo genérico: las cinco operaciones sobre tablas con el patrón de diseño de Devkron, más maestro-detalle | | `view.dk` | Selección y ejecución de vistas, redirección PRG y vista JSON | | `form.dk`, `list.dk`, `error.dk` | Vistas genéricas mínimas: muestran el contexto en JSON o el mensaje de error. Son de diagnóstico, no una interfaz | | `websencia.dk` | Ejecuta vistas definidas en archivos de Websencia (`.jsnwm`) | | `mysql.dbr.dkh` | Funciones de suplantación de identidad para MySQL (`dbr.check_alter_access`, `dbr.alter_id`) | | `entry-point.dkl` | **Plantilla** del punto de entrada: cópiela a su sistema, no la use en su lugar | `controller.dkl` incluye `entity.dk`, `view.dk`, `webauth.dkl` y `crudl/mysql.dbr.dkh`. ## El punto de entrada El punto de entrada es un `.dkl` dentro de la carpeta del sitio o del sistema (para que su configuración sea solo suya). Copie la plantilla: ```bash cp /opt/devkron/crudl/entry-point.dkl /opt/devkron/web/misitio.localhost/tienda/entry-point.dkl ``` y ajústela. Esta es una versión completa y probada: ```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 @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 @ws = @@(@http_context,"request/get/ws") @crudl.access_privilege = '{"access":[{"workspace":"' + @ws + '"}]}' #include "crudl/controller.dkl" } ``` **El orden importa:** 1. `crudl/crudl.dk` antes de llamar a sus funciones. 2. `@path_root` y `@base_path` antes de `crudl.load_config()` y `crudl.loadRoutesJSON()`, que los usan para buscar los archivos. 3. `#include "crudl/controller.dkl"` **al final**: su cuerpo se ejecuta al incluirse y atiende la petición. ## Variables del punto de entrada ### Rutas | Variable | Ejemplo | Significado | |---|---|---| | `@path_root` | `"web/misitio.localhost"` | Carpeta física del sitio, relativa a la carpeta de trabajo del servidor | | `@base_path` | `"tienda/entidades"` | Carpeta de las entidades, relativa a `@path_root`. Las entidades se buscan en `@path_root` + `@base_path` | | `@dbmvc_path` | `"crudl/"` | Carpeta de los archivos del marco (último lugar donde se buscan las vistas) | ### Conexión | Variable | Significado | |---|---| | `@crudl.qname` | Nombre cualificado de la conexión (`conexión@aplicación`, ver [Conexión](/es/devkron/2.0/marcos/crudl/conexion-y-sesion.md)) | | `@crudl.user`, `@crudl.pwd` | Usuario y contraseña de `tuser` para el modo de conexión constante | | `@ws` | Espacio de trabajo, de la URL (`?ws=`); su presencia, con sesión, activa la suplantación de identidad | | `@crudl.access_privilege` | Manifiesto de privilegios que debe cumplir el usuario para la suplantación | | `@db_engine` | Tipo de motor; `"MY_SQL"` (el único con funciones de suplantación incluidas) | Si no se define `@crudl.qname`, la conexión puede llegar en la URL con `_app_group` y `_connection`. ### Vistas y comportamiento | Variable | Valor de la plantilla | Significado | |---|---|---| | `@list_view`, `@form_view`, `@error_view` | `"list.dk"`, `"form.dk"`, `"error.dk"` | Nombres de las vistas ([Vistas](/es/devkron/2.0/marcos/crudl/vistas.md)) | | `@dkl_view_ext` | `".dk"` | Extensión que se agrega a un nombre de vista sin extensión | | `@websencia_ext` | `".jsnwm"` | Extensión de los archivos de Websencia | | `@entity_id_blank` | `"_new"` | Identificador que significa "entidad nueva". **Obligatoria**: sin ella falla toda lectura | | `@auto_crud` | `@true` | Si se atienden entidades sin `model.dk` propio. Vea la nota de abajo | | `@path_template_protected` | `{@base_path}/{@path_root}/_protected/default.htt` | Plantilla que envuelve las vistas cuando hay error ([Vistas](/es/devkron/2.0/marcos/crudl/vistas.md#plantilla-envolvente)) | | `@url_redir` | `""` | Plantilla de la URL de redirección tras guardar ([PRG](/es/devkron/2.0/marcos/crudl/prg-y-redireccion.md)) | | `@crudl_routes_json` | `"routes.json"` | Nombre del archivo de rutas declarativas | La plantilla define también `@crudl.enable_idreplacement=@true`; el marco no la usa. **Sobre `@auto_crud`.** `controller.dkl` vuelve a poner `@auto_crud=@true` justo antes de buscar el modelo, así que el valor del punto de entrada **no tiene efecto**: comprobado en 2.0, con `@auto_crud=@false` una entidad sin `model.dk` se sigue atendiendo. Si necesita que solo se publiquen entidades con modelo, limite las entidades con `routes.json` o con reglas explícitas en `routes.map`. ## Estructura de carpetas de una entidad ```text {@path_root}/{@base_path}/{_entities_type}/ ├── model.dk (opcional) ├── controller.dk (opcional) ├── form.dk (opcional) └── list.dk (opcional) ``` Si no existe `model.dk`, se usa `entity.dk`. Si no existe `controller.dk`, no se ejecuta ninguno. Las vistas se buscan en la carpeta de la entidad, luego en la de las entidades y al final en `crudl/`. ## La base de datos El modelo genérico trabaja sobre tablas con el patrón de diseño de Devkron: clave `sys_pk` entera autoincremental y los campos de control `sys_guid`, `sys_dtcreated`, `sys_timestamp`, `sys_recver`, `sys_deleted` y `sys_lock`. Las guarda `dbr.save` ([Biblioteca dbr](/es/devkron/2.0/bibliotecas/motor/dbr/)), que llena `sys_guid`, las fechas y la versión. Una tabla mínima para MySQL: ```sql create table cliente ( sys_pk int auto_increment primary key, sys_guid varchar(32), sys_dtcreated datetime, sys_timestamp datetime, sys_recver int default 0, sys_deleted tinyint default 0, sys_lock int null, codigo varchar(20) not null, nombre varchar(120) not null, estado varchar(20) default 'activo', saldo decimal(14,2) default 0 ); ``` El modo de conexión constante inicia sesión con `dbr.login`, así que la base necesita también las tablas de sistema `tuser` y `sys_session` (y `sys_catalog` y `sys_lockinfo` si usa bloqueos) con un usuario. La guía [CRUD completo con CRUD-L sobre MySQL](/es/devkron/2.0/guias/crud-mysql.md) trae el script. ## Otros motores de base de datos El controlador incluye siempre `crudl/mysql.dbr.dkh`, con las funciones que usa la suplantación de identidad: | Función | Propósito | |---|---| | `dbr.check_alter_access::&user` | Devuelve `@true` si el usuario cumple el manifiesto de `@crudl.access_privilege` | | `dbr.alter_id::qname, uid, uname, ids` | Devuelve una conexión abierta con la identidad indicada, creando en `tuser` y `sys_session` el usuario y la sesión locales si no existen | Los modos de conexión del IdP y constante funcionan con cualquier motor que soporte `dbr`. Para la suplantación con otro motor hay que escribir esas dos funciones para él (el SQL de `dbr.alter_id` es de MySQL) y cambiar la línea `#include "crudl/mysql.dbr.dkh"` de `controller.dkl`; la variable `@db_engine` todavía no selecciona el archivo. ## Errores típicos | Síntoma | Causa y solución | |---|---| | `Variable global '@entity_id_blank' no definida` | Falta esa variable en el punto de entrada: copie la plantilla completa | | `Error en 'dbr.login. (Error de inicio de sesión...` | `@crudl.user`/`@crudl.pwd` no corresponden a un usuario de `tuser`, o faltan `tuser` y `sys_session` | | `Vista de formulario no disponible` (500) | Con `Accept: text/html`, no se encontró la vista en ninguna de las ubicaciones; revise `@dbmvc_path` | | Todas las peticiones dan la entidad equivocada | `#include "crudl/controller.dkl"` no está al final o se cambió una variable después |