feat: funciones Go para API Metabase y tipo MetabaseClient

Añade funciones Go stub para la API de Metabase en dominio infra: auth, CRUD de cards, dashboards y users, execute_query y execute_card. Incluye tipo MetabaseClient y helper HTTP compartido. Todas las funciones son impuras con stubs not-implemented.
2026-03-28 20:32:24 +01:00
parent 49eecd0c87
commit 9e6bea681f
40 changed files with 1640 additions and 0 deletions
@@ -0,0 +1,71 @@
+---
+name: metabase_execute_card
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func MetabaseExecuteCard(client MetabaseClient, cardID int, parameters []map[string]any) (map[string]any, error)"
+description: "Ejecuta la query de una card/pregunta guardada en Metabase y retorna los resultados. Soporta parametros para queries parametrizadas. Endpoint: POST /api/card/:id/query."
+tags: [metabase, card, question, execute, query, api]
+uses_functions: []
+uses_types: [MetabaseClient_go_infra]
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [fmt]
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/infra/metabase_execute_card.go"
+---
+
+## Ejemplo
+
+```go
+// Ejecutar sin parametros
+result, err := MetabaseExecuteCard(client, 42, nil)
+if err != nil {
+    log.Fatal(err)
+}
+data := result["data"].(map[string]any)
+rows := data["rows"].([]any)
+fmt.Printf("Filas: %d\n", len(rows))
+
+// Ejecutar con parametros
+result, err := MetabaseExecuteCard(client, 42, []map[string]any{
+    {
+        "type":   "category",
+        "target": []any{"variable", []any{"template-tag", "status"}},
+        "value":  "active",
+    },
+})
+```
+
+## Notas
+
+### Estructura de la respuesta
+
+| Campo | Tipo | Descripcion |
+|-------|------|-------------|
+| status | string | "completed" o "failed" |
+| row_count | float64 | Numero de filas |
+| running_time | float64 | Tiempo de ejecucion en ms |
+| data.columns | []string | Nombres de columnas |
+| data.rows | [][]any | Filas de datos |
+| data.cols | []map | Metadata de columnas (name, base_type, display_name) |
+| data.native_form.query | string | SQL ejecutado |
+
+### Parametros para queries parametrizadas
+
+```go
+[]map[string]any{
+    {
+        "type":   "category",                                      // tipo del parametro
+        "target": []any{"variable", []any{"template-tag", "tag"}}, // referencia al template-tag
+        "value":  "valor",                                         // valor a inyectar
+    },
+}
+```
+
+Limite por defecto: 2000 filas. Para queries ad-hoc sin card, usar MetabaseExecuteQuery.