Anonimatum 1.6.0 — API pública, onboarding, membros com âmbito Anonimatum, pacotes de páginas e fila por utilizador

A versão 1.6.0 representa um salto de produto: o Anonimatum deixa de ser apenas uma aplicação web e passa a ser também uma API de produto para os seus fluxos de trabalho, com onboarding por organização, ativação automática do plano após o pagamento no Stripe, gestão da equipa limitada ao Anonimatum (convites, desativação e reativação sem afetar outros serviços Politeia do mesmo utilizador), pacotes de páginas adicionais e uma fila em segundo plano que processa um documento de cada vez por utilizador, permitindo o paralelismo entre utilizadores. Data de lançamento: 2026-09-01.

Visão geral: o que muda na 1.6.0

Se vem da 1.5.0 (Word/Office nativo, visualizador de PDF corrigido, frontend mínimo único), a 1.6.0 acrescenta por cima a camada de produto SaaS: registo, pagamento, quota, equipa e integrações. O fio condutor: a mesma quota e os mesmos limites na SPA e através de chave de API, com isolamento multi-tenant por grupo.

• Chaves de API associadas a um utilizador do Auth e a um grupo Anonimatum: a mesma quota que a aplicação web.
• Integrações através do cabeçalho `X-API-Key` (além do JWT da SPA) em `/api/public/` e `/api/pdf/`.
• Onboarding configurável: destaque na Home, página com slug e acompanhamento da conclusão.
• Checkout no Stripe: planos mensais/anuais; o plano é ativado no grupo de quem paga após a cobrança.
• Membros com âmbito Anonimatum: `rolesProducto: ['anonimatum']`, e-mails com a marca e configuração em app.anonimatum.com.
• Um utilizador, um grupo Anonimatum (409 se já pertencer a outro).
• Pacotes de páginas de 2k / 6k / 17k com cartão ou SEPA.
• Fila: um documento em `PROCESSING` por utilizador; em paralelo entre utilizadores.

API pública e integrações

O Anonimatum 1.6.0 expõe uma superfície de API de produto documentada em Swagger/OpenAPI (`public-api` e `product-api`). As chaves são criadas a partir da Intranet, ficam associadas ao grupo Anonimatum e aparecem mascaradas nas listagens. O contexto de utilizador/grupo é unificado, quer a autenticação seja por JWT (SPA) ou por chave de API.

Cabeçalho X-API-Key e Gateway

• As integrações enviam `X-API-Key` em paralelo com o fluxo JWT da SPA.
• Rotas: `/api/public/` e `/api/pdf/` através do Gateway da Politeia.
• Biblioteca Angular: `provideAnonimatum({ baseUrl, apiKey })` para incorporação ou automatização.
• Documentação técnica dos endpoints, do Gateway e de boas práticas de segurança para chaves de API.

Onboarding e registo por organização

Cada organização pode ter o seu próprio percurso de boas-vindas. Os administradores ativam o onboarding do grupo e escolhem a página de boas-vindas/registo (slug configurável, por exemplo `af-tax-legal`). A Home mostra um destaque para rever o plano e concluir o onboarding.

Página de onboarding

• Mostra preços, quotas de páginas, documentação e a ligação para o checkout.
• Inclui PDF de exemplo para validar a ocultação antes de pagar.
• Série de vídeos de demonstração: o Tutorial 1 — Interface já está disponível no YouTube como primeiro episódio incorporado.
• Manual do utilizador para transferir a partir da mesma página.

Ativação e desativação do plano (Stripe)

O checkout utiliza o Stripe com faturação mensal ou anual. Após um pagamento bem-sucedido, o plano é ativado automaticamente no grupo associado ao e-mail de quem paga. Se a subscrição for cancelada ou os pagamentos pararem, o grupo fica sem plano (quota 0) até ser reposto; os pacotes de páginas comprados mantêm-se na renovação.

Membros, âmbito Anonimatum e e-mails com a marca

A partir de `/anonimo/perfil`, os administradores da empresa convidam membros com e-mail, nome e apelidos, e podem desativá-los e reativá-los. O destaque da 1.6.0 é o âmbito do produto: a ativação concede acesso apenas ao Anonimatum, e não a outros produtos da Politeia.

rolesProducto e configuração da SPA

• O payload do convite inclui `rolesProducto: ['anonimatum']`.
• `setupPasswordFrontendBaseUrl` aponta para a SPA (por exemplo `https://app.anonimatum.com`).
• Modelos de e-mail: `anonimatum_setup_password`, reativação e desativação com a marca Anonimatum.
• A desativação/reativação utiliza `productScope=anonimatum`, pelo que os outros serviços do Auth não são afetados.

Pacotes de páginas adicionais

Além da quota mensal do plano, pode comprar pacotes adicionais a partir do contador de quota (Home ou barra lateral): 2.000, 6.000 ou 17.000 páginas. Pague com cartão ou SEPA através do Stripe Checkout; após o pagamento, regressa a `/anonimo/compra-exito`. O saldo do grupo consome as páginas de forma uniforme (plano + pacotes).

Fila em segundo plano por utilizador

A fila processa os documentos em segundo plano: um documento em PROCESSING por utilizador, mas vários utilizadores em paralelo (com limite global configurável). As equipas grandes não se bloqueiam umas às outras e cada pessoa tem um fluxo previsível.

Resumo das capacidades da 1.6.0