egutierrez
31708d0942
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.
45 lines
1.9 KiB
Markdown
45 lines
1.9 KiB
Markdown
---
|
|
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.
|