feat: navegacion por niveles, intencion pendiente y NLU que aterriza en el informe

- "atras"/"volver"/"regresar" suben un nivel via mapa 'back' declarativo en el
  seed, en vez de saltar siempre al menu principal.
- "finca"/"cambiar finca" como comandos directos a reset_finca.
- requires/resolver: si el NLU rutea a un informe sin el dato que necesita, el
  bot lo pide y vuelve al informe original, no al submenu. Asi "informe de
  mantenimiento de plateo" entrega el PDF sin pasos intermedios.
- ciclo_mantenimiento consulta el catalogo completo cuando hay entities: los
  grupos fuera del top 3 tambien matchean.
- ask_finca con skip_if_set: deja de repreguntar la finca despues de cada
  informe; para cambiarla esta reset_finca.
- Boton "Otro grupo" en el submenu de mantenimiento.
- Fix: el auto-select por entities no mergeaba per_type y mandaba a cat 3 al
  menu equivocado al nombrar una finca.

validate_config.php verifica el grafo (back/resolver/botones/endpoints) y
test_navegacion.php recorre en seco los escenarios de ruteo.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

setup/seed_palmas.php

@@ -13,15 +13,20 @@ $configJson = [
     'fallback'    => 'No entendí. Escribe *menu* para ver las opciones disponibles.',
     'nlu_enabled' => true,
     'commands'    => [
-        'menu'      => 'show_main_menu',
-        'informes'  => 'descargar_informes',
-        'info'      => 'enviar_informacion',
-        'inicio'    => 'show_main_menu',
-        'volver'    => 'show_main_menu',
-        'salir'     => 'show_main_menu',
-        'atras'     => 'show_main_menu',
-        'cancelar'  => 'show_main_menu',
-        'regresar'  => 'show_main_menu',
+        // Al menú principal
+        'menu'     => 'show_main_menu',
+        'inicio'   => 'show_main_menu',
+        'salir'    => 'show_main_menu',
+        'cancelar' => 'show_main_menu',
+        // Un nivel arriba (__back lo resuelve con el mapa 'back' del nodo actual)
+        'atras'    => '__back',
+        'volver'   => '__back',
+        'regresar' => '__back',
+        // Atajos
+        'informes' => 'descargar_informes',
+        'info'     => 'enviar_informacion',
+        'finca'         => 'reset_finca',
+        'cambiar finca' => 'reset_finca',
     ],
     // ── Menus globales ──────────────────────────────────────────────────────
     'menus' => [
@@ -135,6 +140,7 @@ $configJson = [
         'submenu_ciclo_mantenimiento' => ['type'=>'button','body'=>'Ciclos de Mantenimiento — ¿Qué deseas ver?','buttons'=>[
             ['id'=>'ciclo_mantenimiento_top',   'title'=>'🏆 Más largos'],
             ['id'=>'ciclo_mantenimiento_todos', 'title'=>'📋 Todos los lotes'],
+            ['id'=>'reset_grupo_mant',          'title'=>'🔄 Otro grupo'],
         ]],
 
         // Submenú sanidad vegetal (orden: Censo, Plagas, Rincofurus, Tratamiento)
@@ -208,6 +214,7 @@ $configJson = [
             'meta_group'          => 'finca',
             'meta_key'            => 'finca_id',
             'next_node'           => 'show_main_menu',
+            'skip_if_set'         => true,
             'nlu_description'     => 'Seleccionar o cambiar la finca de trabajo',
         ],
 
@@ -218,6 +225,13 @@ $configJson = [
             'nlu_description' => 'Cambiar de finca o seleccionar una finca diferente',
         ],
 
+        // Vuelve a pedir el grupo de mantenimiento (el grupo persiste entre informes)
+        'reset_grupo_mant' => [
+            'type'            => 'function',
+            'function'        => 'reset_grupo_mant',
+            'nlu_description' => 'Cambiar el grupo de mantenimiento (plateo, corona, poda, etc.)',
+        ],
+
         // Producción (texto del mes + PDF encadenado)
         'produccion_total' => ['type' => 'function', 'function' => 'api_report', 'nlu_description' => 'Producción total facturada del mes actual con PDF del año', 'params' => [
             'endpoint_key'      => 'produccion_total_bot_dn',
@@ -249,18 +263,19 @@ $configJson = [
         ]],
 
         // Menus de sección (nlu_skip: navegación interna, no exponer al NLU)
-        'submenu_produccion'     => ['type' => 'menu', 'menu' => 'submenu_produccion',     'nlu_skip' => true],
-        'submenu_ciclos'         => ['type' => 'menu', 'menu' => 'submenu_ciclos',         'nlu_skip' => true],
-        'submenu_ciclos_sanidad' => ['type' => 'menu', 'menu' => 'submenu_ciclos_sanidad', 'nlu_skip' => true],
-        'submenu_ausentismos'    => ['type' => 'menu', 'menu' => 'submenu_ausentismos',    'nlu_skip' => true],
+        // 'back' = a dónde sube el comando "atrás" desde cada nivel
+        'submenu_produccion'     => ['type' => 'menu', 'menu' => 'submenu_produccion',     'nlu_skip' => true, 'back' => 'show_main_menu'],
+        'submenu_ciclos'         => ['type' => 'menu', 'menu' => 'submenu_ciclos',         'nlu_skip' => true, 'back' => 'show_main_menu'],
+        'submenu_ciclos_sanidad' => ['type' => 'menu', 'menu' => 'submenu_ciclos_sanidad', 'nlu_skip' => true, 'back' => 'submenu_ciclos'],
+        'submenu_ausentismos'    => ['type' => 'menu', 'menu' => 'submenu_ausentismos',    'nlu_skip' => true, 'back' => 'show_main_menu'],
 
         // Ciclos — cada uno abre un sub-menú de 3 opciones
-        'ciclo_cosecha'      => ['type' => 'menu', 'menu' => 'submenu_ciclo_cosecha',      'nlu_description' => 'Ver ciclos de cosecha (lotes más largos o todos)'],
-        'ciclo_polinizacion' => ['type' => 'menu', 'menu' => 'submenu_ciclo_polinizacion', 'nlu_description' => 'Ver ciclos de polinización'],
-        'ciclo_plagas'       => ['type' => 'menu', 'menu' => 'submenu_ciclo_plagas',       'nlu_description' => 'Ver ciclos de plagas'],
-        'ciclo_censo'        => ['type' => 'menu', 'menu' => 'submenu_ciclo_censo',        'nlu_description' => 'Ver ciclos de censo'],
-        'ciclo_palm'         => ['type' => 'menu', 'menu' => 'submenu_ciclo_palm',         'nlu_description' => 'Ver ciclos de Palmarum (Rhynchophorus)'],
-        'ciclo_tratamiento'  => ['type' => 'menu', 'menu' => 'submenu_ciclo_tratamiento',  'nlu_description' => 'Ver ciclos de tratamientos'],
+        'ciclo_cosecha'      => ['type' => 'menu', 'menu' => 'submenu_ciclo_cosecha',      'back' => 'submenu_ciclos',         'nlu_description' => 'Ver ciclos de cosecha (lotes más largos o todos)'],
+        'ciclo_polinizacion' => ['type' => 'menu', 'menu' => 'submenu_ciclo_polinizacion', 'back' => 'submenu_ciclos',         'nlu_description' => 'Ver ciclos de polinización'],
+        'ciclo_plagas'       => ['type' => 'menu', 'menu' => 'submenu_ciclo_plagas',       'back' => 'submenu_ciclos_sanidad', 'nlu_description' => 'Ver ciclos de plagas'],
+        'ciclo_censo'        => ['type' => 'menu', 'menu' => 'submenu_ciclo_censo',        'back' => 'submenu_ciclos_sanidad', 'nlu_description' => 'Ver ciclos de censo'],
+        'ciclo_palm'         => ['type' => 'menu', 'menu' => 'submenu_ciclo_palm',         'back' => 'submenu_ciclos_sanidad', 'nlu_description' => 'Ver ciclos de Palmarum (Rhynchophorus)'],
+        'ciclo_tratamiento'  => ['type' => 'menu', 'menu' => 'submenu_ciclo_tratamiento',  'back' => 'submenu_ciclos_sanidad', 'nlu_description' => 'Ver ciclos de tratamientos'],
 
         // Sub-opciones: cosecha
         'ciclo_cosecha_top'      => ['type'=>'function','function'=>'api_report','nlu_description'=>'Lotes de cosecha con ciclos más largos','params'=>['endpoint_key'=>'cosecha_top_texto_bot_dn','date_mode'=>'last_30']],
@@ -296,6 +311,10 @@ $configJson = [
         'ciclo_mantenimiento' => [
             'type'                => 'dynamic_list',
             'source_endpoint_key' => 'mantenimiento_grupos_top3_dn',
+            // Con entities del NLU se busca en el catálogo completo: "plateo" puede
+            // no estar entre los 3 grupos más frecuentes.
+            'source_endpoint_key_all' => 'mantenimiento_grupos_all_dn',
+            'back'                => 'submenu_ciclos',
             'value_field'         => 'id',
             'label_field'         => 'label',
             'header'              => '🔧 Mantenimiento',
@@ -321,17 +340,31 @@ $configJson = [
             'nlu_skip'            => true,
         ],
 
-        // Sub-opciones: mantenimiento
-        'ciclo_mantenimiento_top'   => ['type'=>'function','function'=>'api_report','nlu_description'=>'Lotes de mantenimiento con ciclos más largos (texto)','params'=>['endpoint_key'=>'mantenimiento_top_texto_bot_dn','date_mode'=>'today']],
-        'ciclo_mantenimiento_todos' => ['type'=>'function','function'=>'api_report','nlu_description'=>'PDF de mantenimiento todos los lotes del grupo seleccionado','params'=>['endpoint_key'=>'mantenimiento_todos_bot_dn','date_mode'=>'today','filename'=>'mantenimiento_todos.pdf','caption'=>'Mantenimiento — todos los lotes']],
+        // Sub-opciones: mantenimiento.
+        // requires/resolver: si el grupo aún no está elegido, el bot lo pide primero
+        // y al resolverlo vuelve a este informe (no al submenú).
+        'ciclo_mantenimiento_top'   => [
+            'type'=>'function','function'=>'api_report',
+            'requires'=>['grupo_mant'=>'grupo_id'], 'resolver'=>'ciclo_mantenimiento',
+            'back'=>'submenu_ciclo_mantenimiento',
+            'nlu_description'=>'Lotes de mantenimiento con los ciclos más largos, por grupo (plateo, corona, poda...)',
+            'params'=>['endpoint_key'=>'mantenimiento_top_texto_bot_dn','date_mode'=>'today'],
+        ],
+        'ciclo_mantenimiento_todos' => [
+            'type'=>'function','function'=>'api_report',
+            'requires'=>['grupo_mant'=>'grupo_id'], 'resolver'=>'ciclo_mantenimiento',
+            'back'=>'submenu_ciclo_mantenimiento',
+            'nlu_description'=>'Informe PDF de mantenimiento de todos los lotes de un grupo (plateo, corona, poda...)',
+            'params'=>['endpoint_key'=>'mantenimiento_todos_bot_dn','date_mode'=>'today','filename'=>'mantenimiento_todos.pdf','caption'=>'Mantenimiento — todos los lotes'],
+        ],
 
         // Upload
-        'enviar_informacion'  => ['type' => 'menu', 'menu' => 'submenu_subir_ciclos', 'nlu_skip' => true],
+        'enviar_informacion'  => ['type' => 'menu', 'menu' => 'submenu_subir_ciclos', 'nlu_skip' => true, 'back' => 'show_main_menu'],
         'subir_ciclo_cosecha' => ['type' => 'function', 'function' => 'upload_ciclo', 'nlu_description' => 'Subir o enviar un ciclo de cosecha', 'params' => ['ciclo' => 'cosecha']],
 
         // Alias globales (nlu_skip: son alias de navegación)
         'show_main_menu'     => ['type' => 'menu', 'menu' => 'show_menu_cat2', 'nlu_skip' => true],
-        'descargar_informes' => ['type' => 'menu', 'menu' => 'show_menu_cat2', 'nlu_skip' => true],
+        'descargar_informes' => ['type' => 'menu', 'menu' => 'show_menu_cat2', 'nlu_skip' => true, 'back' => 'show_main_menu'],
     ],
 
     // ── Per-type config ─────────────────────────────────────────────────────
@@ -397,7 +430,7 @@ $configJson = [
             'flows' => [
                 'show_menu_cat2'     => ['type' => 'menu', 'menu' => 'show_menu_cat2'],
                 'show_main_menu'     => ['type' => 'menu', 'menu' => 'show_menu_cat2'],
-                'descargar_informes' => ['type' => 'menu', 'menu' => 'show_menu_cat2'],
+                'descargar_informes' => ['type' => 'menu', 'menu' => 'show_menu_cat2', 'back' => 'show_main_menu'],
             ],
         ],
 
@@ -411,8 +444,8 @@ $configJson = [
             'menus'    => [],
             'flows'    => [
                 'show_main_menu'     => ['type' => 'menu', 'menu' => 'menu_modo_trabajo'],
-                'descargar_informes' => ['type' => 'menu', 'menu' => 'show_menu_cat2'],
-                'enviar_informacion' => ['type' => 'menu', 'menu' => 'submenu_subir_ciclos'],
+                'descargar_informes' => ['type' => 'menu', 'menu' => 'show_menu_cat2',      'back' => 'show_main_menu'],
+                'enviar_informacion' => ['type' => 'menu', 'menu' => 'submenu_subir_ciclos', 'back' => 'show_main_menu'],
             ],
         ],
     ],
@@ -451,6 +484,7 @@ $endpoints = [
     ['key' => 'tratamiento_todos_dn',   'dir' => 'download', 'url' => $BASE . '?peticion=ciclos_tratamientos_dn&finca_id={finca_id}'],
     ['key' => 'mantenimiento_grupos_top3_dn',  'dir' => 'download', 'url' => $BASE . '?peticion=grupos_mantenimiento&limit=3'],
     ['key' => 'mantenimiento_grupos_otros_dn', 'dir' => 'download', 'url' => $BASE . '?peticion=grupos_mantenimiento&limit=10&offset=3'],
+    ['key' => 'mantenimiento_grupos_all_dn',   'dir' => 'download', 'url' => $BASE . '?peticion=grupos_mantenimiento&limit=200'],
     ['key' => 'mantenimiento_top_bot_dn',      'dir' => 'download', 'url' => $BASE . '?peticion=mantenimiento_dn&top_lotes=10&grupo={grupo_id}&finca_id={finca_id}'],
     ['key' => 'mantenimiento_top_texto_bot_dn','dir' => 'download', 'url' => $BASE . '?peticion=mantenimiento_top_texto_bot&grupo={grupo_id}&finca_id={finca_id}'],
     ['key' => 'mantenimiento_todos_bot_dn',    'dir' => 'download', 'url' => $BASE . '?peticion=mantenimiento_dn&grupo={grupo_id}&finca_id={finca_id}'],