Datos personalizados (app-data)

El storage de apps (app-data) te permite guardar JSON por organización para tu app, sin tocar el core de Gestiono. Piensa en esto como una “colección de documentos” multi-tenant.

Conceptos clave

• appId: Identifica la app.
• type: El “nombre de colección/tabla” dentro de la app (string sugerido con versión, ej: orders.v1).
• data: Tu payload JSON (libre). Gestiono lo guarda y lo devuelve como objeto JSON.
• Multi-tenant: Cada registro queda asociado a la organización activa; otras organizaciones no lo ven.

Diseño recomendado para tus tipos

• Usa versionado: miEntidad.v1, miEntidad.v2.
• Evita un “type” gigante: Separa por dominio (ej: orders.v1, orderEvents.v1, settings.v1).
• Incluye tus propios ids dentro del JSON si necesitas referencias estables (ej: orderId, externalId).

Operaciones

• Crear registros: POST /v1/apps/data
• Listar registros por type: GET /v1/apps/data filtrando por appId y type
• Obtener un registro por ID: GET /v1/apps/data/single con appId, appDataId y type
• Actualizar: PATCH /v1/apps/data con id y strategy (replace o merge; merge es superficial).
• Eliminar: DELETE /v1/apps/data

Patrones prácticos

1. “Settings” por organización — Guarda un solo registro por organización con type settings.v1 y un campo key dentro del JSON.
2. Documentos + índice — Si necesitas búsquedas rápidas del lado del cliente, crea un type índice (ej: ordersIndex.v1) con una lista resumida y usa replace para regenerarlo.

Para payloads y ejemplos de cada ruta, revisa Endpoints: Apps personalizadas.