feat(crud): tipos y generador de DDL para recursos CRUD

Anade los tipos CRUDResource, CRUDField, CRUDListParams y CRUDListResult
que modelan un recurso CRUD sobre SQLite, junto con dos funciones puras:
- crud_define_resource valida nombre, tabla y campos (tipos SQLite validos,
  nombres reservados, duplicados) antes de retornar el CRUDResource.
- crud_generate_table_sql genera el DDL CREATE TABLE IF NOT EXISTS con
  id TEXT PRIMARY KEY, timestamps estandar y, si aplica, deleted_at para
  soft delete.

Primera capa de 0021 — el resto (handlers + registro de rutas) se apoya
sobre estas estructuras.
This commit is contained in:
2026-04-18 17:15:21 +02:00
parent 3bc2d2573d
commit 4c88adc183
10 changed files with 562 additions and 0 deletions
@@ -0,0 +1,47 @@
---
name: crud_generate_table_sql
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: pure
signature: "func CRUDGenerateTableSQL(res CRUDResource) string"
description: "Genera el DDL CREATE TABLE IF NOT EXISTS de un CRUDResource. Incluye id como PRIMARY KEY, timestamps created_at/updated_at y deleted_at si soft_delete. Cada campo aplica su tipo SQLite y constraints NOT NULL/UNIQUE/DEFAULT."
tags: [crud, sql, ddl, generate, sqlite, infra]
uses_functions: []
uses_types: [CRUDResource_go_infra]
returns: []
returns_optional: false
error_type: ""
imports: [fmt, strings]
params:
- name: res
desc: "CRUDResource con la definicion completa del recurso"
output: "string con el statement CREATE TABLE listo para ejecutar"
tested: true
tests: ["genera tabla basica con timestamps", "aplica NOT NULL y UNIQUE", "aplica DEFAULT", "anade deleted_at si soft_delete"]
test_file_path: "functions/infra/crud_test.go"
file_path: "functions/infra/crud_generate_table_sql.go"
---
## Ejemplo
```go
res, _ := CRUDDefineResource("project", "projects", []CRUDField{
{Name: "name", Type: "TEXT", Required: true, Unique: true},
{Name: "priority", Type: "INTEGER", Default: "0"},
}, false)
ddl := CRUDGenerateTableSQL(res)
// CREATE TABLE IF NOT EXISTS projects (
// id TEXT PRIMARY KEY,
// name TEXT NOT NULL UNIQUE,
// priority INTEGER DEFAULT 0,
// created_at TEXT NOT NULL,
// updated_at TEXT NOT NULL
// );
db.Exec(ddl)
```
## Notas
Funcion pura — solo manipula strings. Usa CREATE TABLE IF NOT EXISTS para ser idempotente. Las columnas id, created_at y updated_at siempre se generan. Si el CRUDResource es SoftDelete, se anade deleted_at TEXT nullable. El resultado se puede ejecutar directamente con db.Exec o envolver como migracion.