Ajustes de estructura

mcp-server/tools/tables/createField.js

@@ -31,7 +31,48 @@ Field types:
  - separator: visual separator in the form (no data column)
 
 'initialProps' is optional; use it to override defaults (e.g. {isRequired:1, maxLength:100}).
-Table names WITHOUT 'cms_' prefix. Primary key is always 'num'.`,
+Table names WITHOUT 'cms_' prefix. Primary key is always 'num'.
+
+MULTITEXT FIELDS (type='multitext') — initialProps shape:
+A multitext field is a repeater of N sub-fields per row. Each row in the
+admin form gives the user a set of sub-fields to fill (e.g. a list of FAQ
+items where each one has 'question' + 'answer' + 'category').
+ - tablaAuxiliar (string, opcional): nombre de tabla auxiliar para el repeater.
+ - descriptionjson (REQUIRED): JSON STRING (not object) with the array of
+   sub-fields. Each sub-field is an object with:
+   - id_campo (string): clave tecnica, slug. Estable: NO se cambia despues.
+   - nombre_campo (string): etiqueta visible en la UI.
+   - tipo (string '0'..'5'): '0'=texto, '1'=tabla CMS, '3'=fecha, '4'=color, '5'=icono.
+   - When tipo='1': also pass tabla (target table without 'cms_'),
+     campo_valor (default 'num'), campo_muestra (label field).
+   Example (correct):
+     "descriptionjson": "[{\\"id_campo\\":\\"pregunta\\",\\"nombre_campo\\":\\"Pregunta\\",\\"tipo\\":\\"0\\"},{\\"id_campo\\":\\"respuesta\\",\\"nombre_campo\\":\\"Respuesta\\",\\"tipo\\":\\"0\\"}]"
+   ⚠ It MUST be a JSON-encoded string. If you pass an object the backend
+     rejects it. Strings, single-quoted JSON, or other formats break the editor.
+
+LIST FIELDS (type='list') — initialProps shape:
+ - listType (REQUIRED): one of 'pulldown' | 'radios' | 'pulldownMulti' | 'checkboxes'.
+   NOT 'select' nor 'dropdown' — use 'pulldown'.
+ - optionsType (REQUIRED): one of 'text' | 'table' | 'query'.
+
+ - When optionsType='text': pass 'optionsText' as a SINGLE string with one
+   option per line, separated by REAL NEWLINE CHARACTERS ('\\n' in JSON).
+   Each line is either 'value|Label' (preferred) or just 'label' (value=label).
+   ⚠ Do NOT separate options with commas. Commas inside an option are valid
+   data — Acai uses '\\n' as the option delimiter, period.
+   Example (correct):
+     "optionsText": "indefinido|Indefinido\\ntemporal|Temporal\\nfreelance|Freelance"
+   Example (WRONG, will store all 4 as a single option):
+     "optionsText": "Indefinido,Temporal,Prácticas,Freelance"
+
+ - When optionsType='table': pass 'optionsTablename' (target table without cms_),
+   'optionsValueField' (default 'num'), 'optionsLabelField'. Optional 'filterField'
+   is a SQL WHERE clause without the WHERE keyword (e.g. "visible=1").
+
+ - When optionsType='query': pass 'optionsQuery' as raw SQL. Acai uses POSITIONAL
+   columns: column 0 is the value, column 1 is the label. So write
+   "SELECT num, titulo FROM cms_xxx WHERE active=1" — the 'AS value/label'
+   aliases have NO effect.`,
         withAuthParams({
             tableName: z.string().describe("Table name without 'cms_' prefix"),
             fieldName: z.string().describe("New field name (SQL-safe identifier)"),