Anonimatum 1.6.0 — API pública, onboarding, miembros con alcance Anonimatum, bolsas de páginas y cola por usuario

Con la versión 1.6.0 Anonimatum da un salto de producto: deja de ser solo una aplicación web y pasa a ser también una API de producto integrable en vuestros flujos, con onboarding por organización, contratación y activación automática del plan tras el pago en Stripe, gestión de equipo acotada al producto Anonimatum (invitaciones, bajas y reactivaciones sin afectar otros servicios Politeia del mismo usuario), bolsas de páginas extras y una cola en segundo plano que procesa un documento a la vez por usuario pero permite paralelismo entre usuarios. Fecha de publicación: 01/09/2026.

Panorama general: qué cambia con la 1.6.0

Si venís de la 1.5.0 (Word/Office nativo, visor PDF corregido, frontend único minimal), la 1.6.0 no sustituye ese trabajo: lo completa con la capa de producto SaaS — alta, pago, cuota, equipo e integraciones. El hilo conductor es: misma cuota y mismos límites tanto en la SPA como vía API key, con aislamiento multi-tenant por grupo.

• API keys ligadas a usuario Auth + grupo Anonimatum: misma cuota que la aplicación web.
• Integraciones con cabecera `X-API-Key` (además del JWT de la SPA) sobre `/api/public/` y `/api/pdf/`.
• Onboarding configurable: teaser en Home, página por slug, marcado de completado.
• Contratación Stripe: planes mensual/anual; al cobrar se activa el plan en el grupo del correo pagador.
• Miembros con alcance Anonimatum: `rolesProducto: ['anonimatum']`, emails de marca, setup en app.anonimatum.com.
• Un usuario, un grupo Anonimatum (409 si ya pertenece a otro).
• Bolsas de páginas 2k / 6k / 17k con tarjeta o SEPA.
• Cola: un documento `PROCESSING` por usuario; varios usuarios en paralelo.

API pública e integraciones

Anonimatum 1.6.0 expone una superficie de API de producto documentada en Swagger/OpenAPI (`public-api` y `product-api`). Las claves se generan desde Intranet, asociadas al grupo Anonimatum, y en listados aparecen enmascaradas por seguridad. El contexto de usuario/grupo es unificado tanto si autenticáis con JWT (SPA) como con API key.

Cabecera X-API-Key y Gateway

• Las integraciones envían `X-API-Key` además del flujo JWT habitual de la SPA.
• Rutas cubiertas: `/api/public/` y `/api/pdf/` a través del Gateway Politeia.
• En la librería Angular: `provideAnonimatum({ baseUrl, apiKey })` para embeber o automatizar.
• Documentación técnica de endpoints, Gateway y buenas prácticas de seguridad por API key.

Casos de uso típicos

Despachos y departamentos que ya anonimizan en la web pueden automatizar lotes desde su DMS, un portal interno o un pipeline CI. La API key hereda el cupo del grupo: no hay «segunda cuota» oculta. Ideal para integraciones RGPD donde el documento nunca sale del perímetro acordado.

Onboarding y contratación por organización

Cada organización puede tener un recorrido de bienvenida distinto. El administrador habilita el onboarding del grupo y elige la página de bienvenida/contratación (slug configurable, p. ej. `af-tax-legal`). En Home aparece un teaser para revisar el plan y continuar hasta marcarlo como hecho.

Página de onboarding

• Muestra precios, cupos por páginas, documentación y enlace para contratar.
• Incluye PDFs de prueba (sentencia, adjudicación, contrato) para validar anonimización antes del pago.
• Serie de vídeos de demostración: el Tutorial 1 — Interfaz ya está publicado en YouTube e integrado como primer episodio.
• Manual de usuario descargable desde la misma página.

Activación y baja del plan (Stripe)

La contratación usa Stripe Checkout con cadencia mensual o anual. Al completar el cobro, el plan contratado se activa automáticamente en el grupo vinculado al correo con el que se pagó. Si la suscripción se cancela o deja de pagarse, el grupo pasa a sin plan (cupo 0) hasta regularizar; las bolsas de páginas extras ya compradas se conservan al renovar.

Catálogo de planes

• Básico: 1.300 páginas / mes — ideal para empezar.
• Profesional: 5.000 páginas / mes — equipos en crecimiento.
• Business: 15.000 páginas / mes — alto volumen.
• Todos incluyen usuarios ilimitados y las mismas funcionalidades; solo cambia el cupo.

Miembros, alcance Anonimatum y emails de marca

Desde `/anonimo/perfil`, el administrador de empresa puede invitar con email, nombre y apellidos, dar de baja y reactivar miembros. La novedad clave de la 1.6.0 es el alcance de producto: el alta concede solo acceso a Anonimatum, no a otros productos Politeia de la misma empresa (Facturatum, etc.).

rolesProducto y setup en la SPA

• El cuerpo del invite incluye `rolesProducto: ['anonimatum']`.
• `setupPasswordFrontendBaseUrl` apunta a la SPA (p. ej. `https://app.anonimatum.com`).
• Plantillas de email: `anonimatum_setup_password`, reactivación y baja, con marca Anonimatum y CTA a la app.
• Baja y reactivación usan `productScope=anonimatum` para no revocar otros servicios del mismo usuario Auth.

Compatibilidad con clientes anteriores

Si un cliente antiguo de la librería no envía `rolesProducto`, el backend Auth infiere solo Anonimatum cuando el frontend de invitación es la SPA Anonimatum. Esto evita errores 400 en producción mientras se despliegan versiones recientes de `ps-anonimatum-front`.

Un usuario, un grupo Anonimatum

Un usuario Auth solo puede pertenecer a un grupo Anonimatum. Si intentáis añadirlo a otro, recibiréis 409 Conflict. Esto protege la coherencia de cupo, facturación y permisos.

Alias anonimo en tokens legacy

En JWT y microservicios legacy, el alias `anonimo` se resuelve igual que `anonimatum` en SSO y redirecciones, para no romper integraciones existentes.

Bolsas de páginas extras

Además del cupo mensual del plan, podéis comprar bolsas adicionales desde el contador de cupo (Home o sidebar): 2.000, 6.000 o 17.000 páginas. Pago con tarjeta o SEPA vía Stripe Checkout; tras el éxito, retorno a `/anonimo/compra-exito`. El pool del grupo consume páginas de forma unificada (plan + bolsas).

Cola en segundo plano por usuario

La cola procesa documentos en segundo plano con una regla clara: un documento en estado PROCESSING por usuario, pero varios usuarios en paralelo (tope global configurable). Así un equipo grande no se bloquea mutuamente, pero cada persona tiene un flujo predecible.

Resumen de capacidades 1.6.0

Próximos pasos

Anonimatum 1.6.0 une la API de producto con el recorrido de alta y gestión de equipo: invitaciones acotadas al producto, emails y setup en app.anonimatum.com, y cuota activa en el grupo tras el pago. Consultad las notas anteriores (1.5.0 Word/Office, 1.4.0 motor IA ampliado) para el detalle de anonimización documental.