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:
@@ -0,0 +1,44 @@
|
||||
---
|
||||
name: crud_define_resource
|
||||
kind: function
|
||||
lang: go
|
||||
domain: infra
|
||||
version: "1.0.0"
|
||||
purity: pure
|
||||
signature: "func CRUDDefineResource(name string, table string, fields []CRUDField, softDelete bool) (CRUDResource, error)"
|
||||
description: "Construye un CRUDResource validando nombre, tabla y campos. Rechaza nombres de campo reservados (id, created_at, updated_at, deleted_at), duplicados y tipos distintos de TEXT, INTEGER, REAL, BLOB."
|
||||
tags: [crud, resource, define, validation, infra]
|
||||
uses_functions: []
|
||||
uses_types: [CRUDResource_go_infra, CRUDField_go_infra]
|
||||
returns: [CRUDResource_go_infra]
|
||||
returns_optional: false
|
||||
error_type: ""
|
||||
imports: [fmt]
|
||||
params:
|
||||
- name: name
|
||||
desc: "nombre singular del recurso en snake_case (ej: 'project')"
|
||||
- name: table
|
||||
desc: "nombre de la tabla SQLite asociada (ej: 'projects')"
|
||||
- name: fields
|
||||
desc: "lista de CRUDField con los campos del recurso (sin id ni timestamps)"
|
||||
- name: softDelete
|
||||
desc: "si true, el recurso usa deleted_at en vez de borrado fisico"
|
||||
output: "CRUDResource validado listo para pasar a crud_generate_table_sql y crud_generate_handlers"
|
||||
tested: true
|
||||
tests: ["construye un recurso valido", "rechaza nombre vacio", "rechaza tabla vacia", "rechaza lista de campos vacia", "rechaza tipos invalidos", "rechaza nombres reservados", "rechaza duplicados"]
|
||||
test_file_path: "functions/infra/crud_test.go"
|
||||
file_path: "functions/infra/crud_define_resource.go"
|
||||
---
|
||||
|
||||
## Ejemplo
|
||||
|
||||
```go
|
||||
res, err := CRUDDefineResource("project", "projects", []CRUDField{
|
||||
{Name: "name", Type: "TEXT", Required: true, Unique: true},
|
||||
{Name: "priority", Type: "INTEGER", Default: "0"},
|
||||
}, false)
|
||||
```
|
||||
|
||||
## Notas
|
||||
|
||||
Funcion pura — no hace I/O. Valida antes de devolver. Los campos id, created_at, updated_at y deleted_at son gestionados por el generador de tabla y los handlers, por eso estan reservados. Los tipos aceptados son los tipos de almacenamiento nativos de SQLite.
|
||||
Reference in New Issue
Block a user