@tinya-code/gas-admin-ui 0.2.0-alpha.13 → 0.2.0-alpha.15

package/src/lib/core/testing/categories.schema.ts

@@ -0,0 +1,125 @@
+import type { ResourceSchema } from '../models/schema.model';
+
+/**
+ * Colección reordenable — base.md §11, api.md §3.1.
+ * `position` lo gestiona el backend (R3: nunca se expone como campo).
+ */
+export const categoriesSchema: ResourceSchema = {
+  id: 'categories',
+  label: 'Categoría',
+  labelPlural: 'Categorías',
+  kind: 'collection',
+  uiViews: {
+    list: { type: 'list' },
+    create: { type: 'form', path: 'new' },
+    edit: { type: 'form', path: ':key/edit' },
+  },
+  endpoint: {
+    list: '/admin/categories',
+    get: '/admin/categories/{key}',
+    create: '/admin/categories',
+    update: '/admin/categories/{key}',
+    remove: '/admin/categories/{key}',
+  },
+  keyField: 'slug',
+  titleField: 'name',
+  sortable: true,
+  positionField: 'position',
+  // Edición rápida del listado (plan 6.5): los dos campos que se repiten.
+  quickEdit: ['name', 'active'],
+  search: ['name'],
+  filters: [{ key: 'active', label: 'Activo', type: 'boolean' }],
+  listColumns: [
+    { key: 'image_url', label: 'Imagen', format: 'thumbnail' },
+    { key: 'name', label: 'Nombre' },
+    { key: 'active', label: 'Activo', format: 'boolean' },
+  ],
+  layout: {
+    mode: 'sections',
+    sections: [
+      { id: 'general', label: 'General' },
+      { id: 'seo', label: 'SEO' },
+      { id: 'contenido', label: 'Contenido' },
+      { id: 'estado', label: 'Estado' },
+    ],
+  },
+  fields: [
+    {
+      type: 'text',
+      key: 'name',
+      label: 'Nombre',
+      required: true,
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'slug',
+      key: 'slug',
+      label: 'Slug',
+      from: 'name',
+      lockAfterCreate: true,
+      required: true,
+      validators: { unique: true },
+      help: 'Se genera desde el nombre. Inmutable tras crear el registro.',
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'text',
+      key: 'seo_title',
+      label: 'Título SEO',
+      required: true,
+      help: 'Aparece en el resultado de buscadores.',
+      section: 'seo',
+      width: 12,
+    },
+    {
+      type: 'textarea',
+      key: 'seo_description',
+      label: 'Descripción SEO',
+      required: true,
+      rows: 3,
+      section: 'seo',
+      width: 12,
+    },
+    {
+      type: 'textarea',
+      key: 'intro',
+      label: 'Introducción',
+      required: true,
+      rows: 6,
+      help: 'Texto de la categoría en la portada (100–1000 caracteres).',
+      validators: { minLength: 100, maxLength: 1000 },
+      section: 'contenido',
+      width: 12,
+    },
+    {
+      type: 'image',
+      key: 'image_url',
+      label: 'Imagen',
+      required: true,
+      section: 'contenido',
+      width: 6,
+    },
+    {
+      type: 'text',
+      key: 'image_alt',
+      label: 'Texto alternativo',
+      help: 'Describe la imagen para lectores de pantalla.',
+      section: 'contenido',
+      width: 6,
+    },
+    {
+      type: 'boolean',
+      key: 'active',
+      label: 'Activo',
+      required: true,
+      default: true,
+      trueLabel: 'Activo',
+      falseLabel: 'Inactivo',
+      help: 'Si está inactivo, la categoría no sale en el sitio público.',
+      section: 'estado',
+      width: 6,
+    },
+  ],
+};

package/src/lib/core/testing/orders.schema.ts

@@ -0,0 +1,372 @@
+import type { ResourceSchema } from '../models/schema.model';
+
+export const ordersSchema: ResourceSchema = {
+  id: 'orders',
+  label: 'Pedido',
+  labelPlural: 'Pedidos',
+  kind: 'collection',
+  uiViews: {
+    list: { type: 'list' },
+    create: { type: 'form', path: 'new' },
+    detail: { type: 'detail', path: ':key' },
+    edit: { type: 'form', path: ':key/edit' },
+    // R9.8.5 — vistas de dominio declaradas sobre un recurso real.
+    // Cada una con su propio `path` para no colisionar con la raíz `orders`
+    // (que es la ruta de la vista `list`).
+    calendar: {
+      type: 'calendar',
+      path: 'calendario',
+      config: { startField: 'pickup_date', titleField: 'customer_name' },
+    },
+    board: {
+      type: 'kanban',
+      path: 'tablero',
+      config: {
+        groupField: 'status',
+        columns: [
+          { value: 'PENDIENTE', label: 'Pendiente' },
+          { value: 'ENTREGADO', label: 'Entregado' },
+          { value: 'CANCELADO', label: 'Cancelado' },
+        ],
+        titleField: 'customer_name',
+      },
+    },
+    // R9.9 — composición declarativa de referencia sobre vistas reales
+    // (fixture de integración, task 5.1): tres hojas de tipos distintos +
+    // un tabs anidado (profundidad 2, dentro del límite), con `initial`
+    // explícito y config POR INSTANCIA (cada hijo trae la suya).
+    resumen: {
+      type: 'tabs',
+      path: 'resumen',
+      config: {
+        initial: 'board',
+        children: [
+          {
+            id: 'cal',
+            label: 'Calendario',
+            type: 'calendar',
+            config: { startField: 'pickup_date', titleField: 'customer_name' },
+          },
+          {
+            id: 'board',
+            label: 'Tablero',
+            type: 'kanban',
+            config: {
+              groupField: 'status',
+              columns: [
+                { value: 'PENDIENTE', label: 'Pendiente' },
+                { value: 'ENTREGADO', label: 'Entregado' },
+                { value: 'CANCELADO', label: 'Cancelado' },
+              ],
+              titleField: 'customer_name',
+            },
+          },
+          { id: 'rows', label: 'Pedidos', type: 'list' },
+          {
+            id: 'panels',
+            label: 'Paneles',
+            type: 'tabs',
+            config: {
+              children: [
+                {
+                  id: 'inner-cal',
+                  label: 'Agenda interna',
+                  type: 'calendar',
+                  config: { startField: 'pickup_date', titleField: 'customer_name' },
+                },
+              ],
+            },
+          },
+        ],
+      },
+    },
+  },
+  endpoint: {
+    list: '/admin/orders',
+    get: '/admin/orders/{key}',
+    create: '/admin/orders',
+    update: '/admin/orders/{key}',
+    remove: '/admin/orders/{key}',
+  },
+  keyField: 'ref',
+  titleField: 'customer_name',
+  search: ['ref', 'customer_name', 'authorized_name'],
+  filters: [
+    {
+      key: 'status',
+      label: 'Estado',
+      type: 'select',
+      options: [
+        { label: 'Pendiente', value: 'PENDIENTE' },
+        { label: 'Entregado', value: 'ENTREGADO' },
+        { label: 'Cancelado', value: 'CANCELADO' },
+      ],
+    },
+    {
+      key: 'auth_state',
+      label: 'Autorización',
+      type: 'select',
+      options: [
+        { label: 'Ninguno', value: 'NINGUNO' },
+        { label: 'Activa', value: 'ACTIVA' },
+        { label: 'Revocada', value: 'REVOCADA' },
+      ],
+    },
+  ],
+  // listColumns ⊆ listProjection del back (contract-check regla 5). `pin` se
+  // proyecta pero NO se lista: el operador lo copia vía acción/share, no
+  // escaneando la tabla (R8.1).
+  listColumns: [
+    { key: 'ref', label: 'Ref' },
+    { key: 'customer_name', label: 'Cliente' },
+    { key: 'status', label: 'Estado' },
+    { key: 'pickup_date', label: 'Fecha de retiro' },
+    { key: 'auth_state', label: 'Autorización' },
+  ],
+  detail: {
+    enabled: true,
+    headerFields: ['ref', 'status', 'auth_state'],
+  },
+  postCreate: {
+    mode: 'modal',
+    title: '¡Pedido Registrado con Éxito!',
+    description:
+      'El pedido {ref} fue generado. Puede compartir el enlace de retiro con el cliente.',
+    // D11: `pin` queda FUERA del resumen — el modal no lo muestra porque la
+    // vía canónica es la acción copy-share, que lo incluye en el mensaje del
+    // cliente; duplicarlo en el modal expondría el PIN en una captura de
+    // pantalla que no viaja al cliente (R8.1).
+    summaryFields: ['ref', 'customer_name', 'pickup_date', 'status'],
+    actions: [
+      {
+        id: 'share_order',
+        type: 'copy-share',
+        label: 'Compartir con Cliente',
+        urlTemplate: '{public_base_url}/p/{ref}',
+        // Sin shareTextTemplate: cae al global `share_message_template`
+        // (pickpass), que el operador edita con los chips de tokens.
+      },
+    ],
+  },
+  actions: [
+    {
+      id: 'share_order',
+      type: 'copy-share',
+      label: 'Compartir Enlace',
+      urlTemplate: '{public_base_url}/p/{ref}',
+      // Mismo criterio que el modal: el mensaje lo define la plantilla
+      // global, no un hardcode del schema (R8.7).
+    },
+    // R8.8 (D14): regenera el PIN desde el detalle/listado — el remedio
+    // operativo de «pedido sin PIN recuperable» (R10) sin recrear el pedido.
+    // El back lo resuelve con `handlePinRegenerate` (orders.actions
+    // ['regenerate-pin']); el trigger sólo dispara la ruta y recarga.
+    {
+      id: 'regenerate_pin',
+      type: 'trigger',
+      name: 'regenerate-pin',
+      label: 'Regenerar PIN',
+      confirmMessage:
+        'Se generará un PIN nuevo para este pedido; el anterior dejará de verificar. ¿Continuar?',
+    },
+  ],
+  layout: {
+    mode: 'sections',
+    sections: [
+      { id: 'pedido', label: 'Datos del Pedido' },
+      { id: 'autorizado', label: 'Persona Autorizada' },
+      { id: 'historial', label: 'Historial de Eventos' },
+      { id: 'sistema', label: 'Sistema' },
+    ],
+  },
+  fields: [
+    {
+      type: 'text',
+      key: 'ref',
+      label: 'Código del Pedido',
+      // El back lo genera (`operations.create.computed`, transform `token`):
+      // es un código aleatorio, no una entrada del operador, de ahí el
+      // `readonlyOn: 'create'` y el `help`.
+      //
+      // `required` + `unique` SÍ se declaran acá para que coincidan con el
+      // back y no diverja el contract check. NO bloquean el guardado aunque el
+      // campo esté vacío en alta: Signal Forms salta la validación de un nodo
+      // readonly (`shouldSkipValidation = hidden || disabled || readonly`,
+      // _validation_errors-chunk.mjs:778). En update el campo sí se valida.
+      required: true,
+      validators: { unique: true },
+      // En alta no existe todavía (lo llena el transform `token`): no tiene
+      // sentido mostrarlo vacío con un help que explica que se genera solo.
+      // En edición sí aparece, pero como `immutableKey: true` lo rechaza en el
+      // back, el campo es de solo-lectura en TODOS los modos.
+      hiddenOn: 'create',
+      readonlyOn: 'always',
+      help: 'Se genera solo al guardar: 6 caracteres sin confundir 0 con O ni 1 con I.',
+      section: 'pedido',
+      width: 6,
+    },
+    {
+      type: 'text',
+      key: 'pin',
+      label: 'PIN de Autorización',
+      // Lo genera el transform `pin` al crear y queda en claro SÓLO en la fila
+      // del pedido, para copiarlo en el mensaje del cliente. Nunca se edita:
+      // cambiarlo a mano dejaría la fila sin correspondencia en `_pin`, que es
+      // lo que compara `pin-verify` (aunque no abre el retiro, el pin mostrado
+      // dejaría de verificar).
+      // Igual que `ref`: en alta no existe (lo llena el transform `pin`), así
+      // que se oculta. En edición SÍ aparece — es donde al operador le sirve
+      // ver el PIN de ese pedido para dictarlo por teléfono.
+      hiddenOn: 'create',
+      readonlyOn: 'always',
+      validators: { maxLength: 12 },
+      help: 'Se genera solo al guardar (6 dígitos) y no se puede modificar.',
+      section: 'pedido',
+      width: 6,
+    },
+    {
+      type: 'text',
+      key: 'customer_name',
+      label: 'Nombre del Cliente',
+      required: true, // titleField del recurso: siempre presente
+      placeholder: 'Ej. Ana Pérez',
+      validators: { maxLength: 80 },
+      section: 'pedido',
+      width: 6,
+    },
+    {
+      type: 'textarea',
+      key: 'description',
+      label: 'Descripción del Pedido',
+      required: true, // campo textil del negocio: sin descripción no hay pedido
+      help: 'Qué es el pedido: mínimo 3 palabras, máximo 120.',
+      validators: { minWords: 3, maxWords: 120 },
+      section: 'pedido',
+      width: 12,
+    },
+    {
+      type: 'date',
+      key: 'pickup_date',
+      label: 'Fecha Acordada de Retiro',
+      required: true, // es lo que el operador confirma por teléfono
+      help: 'Cuándo viene el cliente a retirarlo.',
+      section: 'pedido',
+      width: 6, // mitad de fila: date corto
+    },
+    {
+      type: 'select',
+      key: 'status',
+      label: 'Estado',
+      required: true,
+      default: 'PENDIENTE', // todo pedido nace pendiente (transform back)
+      options: [
+        { label: 'Pendiente', value: 'PENDIENTE' },
+        { label: 'Entregado', value: 'ENTREGADO' },
+        { label: 'Cancelado', value: 'CANCELADO' },
+      ],
+      section: 'pedido',
+      width: 6,
+    },
+    {
+      type: 'image',
+      key: 'reference_photo',
+      label: 'Foto de Referencia del Pedido',
+      section: 'pedido',
+      width: 6, // opcional: sólo si el cliente mandó foto
+    },
+    {
+      type: 'textarea',
+      key: 'customer_notes',
+      label: 'Notas Internas / Instrucciones',
+      placeholder: 'Ej. Entregar por el portón trasero, llamar antes',
+      validators: { maxLength: 500 },
+      section: 'pedido',
+      width: 12, // textarea libre: fila completa
+    },
+    {
+      type: 'text',
+      key: 'authorized_name',
+      label: 'Nombre de la Persona Autorizada',
+      help: 'Quién viene a retirar. Déjelo vacío si retira el propio cliente.',
+      validators: { maxLength: 80 },
+      section: 'autorizado',
+      width: 6, // opcional: vacío = retira el propio cliente
+    },
+    {
+      type: 'image',
+      key: 'authorized_photo',
+      label: 'Foto del Autorizado',
+      section: 'autorizado',
+      width: 6, // la usa el personal para chequear identidad en el retiro
+    },
+    {
+      type: 'textarea',
+      key: 'authorized_notes',
+      label: 'Notas sobre la Autorización',
+      validators: { maxLength: 300 },
+      section: 'autorizado',
+      width: 12, // textarea: fila completa
+    },
+    {
+      type: 'select',
+      key: 'auth_state',
+      label: 'Estado de Autorización',
+      help: 'Activa habilita el retiro por tercero con el código del pedido.',
+      default: 'NINGUNO', // sin persona autorizada al crear
+      options: [
+        { label: 'Ninguno', value: 'NINGUNO' },
+        { label: 'Activa', value: 'ACTIVA' },
+        { label: 'Revocada', value: 'REVOCADA' },
+      ],
+      section: 'autorizado',
+      width: 6,
+    },
+    {
+      type: 'readonly-text',
+      key: 'created_at',
+      label: 'Fecha de creación',
+      section: 'sistema',
+      width: 6, // auditoría del back, siempre readonly-text
+    },
+    {
+      type: 'readonly-text',
+      key: 'updated_at',
+      label: 'Última actualización',
+      section: 'sistema',
+      width: 6, // auditoría del back, siempre readonly-text
+    },
+    {
+      type: 'list',
+      key: 'history',
+      label: 'Historial',
+      min: 0,
+      max: 200, // lo appenda el back (history-append-only): el operador no lo edita
+      section: 'historial',
+      itemFields: [
+        {
+          type: 'readonly-text',
+          key: 'at',
+          label: 'Fecha/Hora',
+        },
+        {
+          type: 'select',
+          key: 'action',
+          label: 'Acción',
+          options: [
+            { label: 'Pedido Creado', value: 'PEDIDO_CREADO' },
+            { label: 'Autorizado', value: 'AUTORIZADO' },
+            { label: 'Autorización Cambiada', value: 'AUTORIZADO_CAMBIADO' },
+            { label: 'Revocado', value: 'REVOCADO' },
+            { label: 'Entregado', value: 'ENTREGADO' },
+          ],
+        },
+        {
+          type: 'text',
+          key: 'detail',
+          label: 'Detalle',
+          validators: { maxLength: 120 },
+        },
+      ],
+    },
+  ],
+};