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)"),

mcp-server/tools/tables/updateField.js

@@ -29,7 +29,27 @@ Destructive cases:
    drops HTML). The backend returns 'warnings' in the response — surface them
    to the user.
 
-Table names WITHOUT 'cms_' prefix.`,
+Table names WITHOUT 'cms_' prefix.
+
+MULTITEXT FIELDS — when 'props' touches multitext config:
+ - descriptionjson: JSON STRING (not object) with the array of sub-fields.
+   Each: {id_campo, nombre_campo, tipo} where tipo is '0'(texto)|'1'(tabla)|
+   '3'(fecha)|'4'(color)|'5'(icono). For tipo='1' also include tabla,
+   campo_valor, campo_muestra.
+   ⚠ MUST be JSON-encoded string. Backend rejects objects directly.
+   Example: "descriptionjson":"[{\\"id_campo\\":\\"pregunta\\",\\"nombre_campo\\":\\"Pregunta\\",\\"tipo\\":\\"0\\"}]"
+
+LIST FIELDS — when 'props' touches list config:
+ - listType: 'pulldown' | 'radios' | 'pulldownMulti' | 'checkboxes' (NOT 'select').
+ - optionsType: 'text' | 'table' | 'query'.
+ - optionsText (for optionsType='text'): one option per LINE, separated by
+   '\\n' (real newline). Each line is 'value|Label' or just 'label'.
+   ⚠ Do NOT use commas as the option separator — commas are valid inside
+   a label. Example (correct): "indef|Indefinido\\ntemp|Temporal".
+ - optionsTablename / optionsValueField / optionsLabelField / filterField
+   for optionsType='table'.
+ - optionsQuery for optionsType='query' — column 0 is the value, column 1
+   the label (positional, 'AS value/label' aliases are ignored).`,
         withAuthParams({
             tableName: z.string().describe("Table name without 'cms_' prefix"),
             fieldName: z.string().describe("Current field name"),