Capacidades Transversais

┌──────── CAPACIDADES TRANSVERSAIS ────────┐
│                                            │
│  🏢 Companies (multi-tenant)               │
│     ├─ Branding (logo, cor, nome)          │
│     ├─ E-mail config (SMTP próprio)        │
│     ├─ Planos (módulos habilitados)        │
│     ├─ Billings (faturamento)              │
│     ├─ DB Connections                      │
│     └─ Backup (LGPD)                       │
│                                            │
│  👥 Identidade                             │
│     ├─ Users (/users)                      │
│     ├─ Groups (/groups)                    │
│     ├─ Roles / Cargos (/roles)             │
│     ├─ Permissions (/permissions)          │
│     └─ Social Login (/auth/:social)        │
│                                            │
│  🔍 Governança                             │
│     ├─ System Audit (/system-audit)        │
│     └─ Notifications Audit                 │
│                                            │
│  📚 Conhecimento                           │
│     ├─ Treinamentos                        │
│     ├─ Meu conteúdo                        │
│     └─ Content management                  │
│                                            │
│  💬 Comunicação                            │
│                                            │
│  📱 Mobile real                            │
│     └─ Capacitor (Android + iOS)           │
│                                            │
│  🎨 White-label profundo                   │
│     ├─ Logo no PWA                         │
│     ├─ Cor primária                        │
│     ├─ Nome em e-mails                     │
│     └─ Domínio próprio (opcional)          │
│                                            │
│  🧭 Menus customizáveis                   │
│     └─ /menus                              │
│                                            │
│  ⚙️ Settings                               │
│     └─ /settings                           │
└────────────────────────────────────────────┘

4.1. Companies (multi-tenant)

• URL: /companies (lista), /companies/new (criar), /companies/:id (detalhe), /companies/:id/edit (editar).
• Isolamento: dados, usuários, branding, permissões — tudo isolado por empresa.
• Detalhes da empresa:
• branding (logo, cor primária);
• razão social, CNPJ, contato;
• configurações operacionais;
• admins designados.

4.2. Planos comerciais

• URL: /companies/:id/plans (lista), /companies/:id/plans/:planId (editar).
• O que controla:
• quais módulos estão ativos (Field, Flow, Score, IA, Schedule, Sign);
• limites (nº usuários, formulários, agentes, execuções de IA);
• preço.
• Por que importa: permite pacotes comerciais distintos (Starter, Pro, Enterprise) com ativação automática.

4.3. Billings

• URL: /companies/:id/billings (lista), /companies/:id/billings/:billingId (editar).
• O que faz:
• emissão de cobrança;
• status (pago, vencido, contestado);
• histórico para reconciliação financeira.

4.4. Configuração de e-mail por empresa

• URL: /companies/:id/email-config.
• O que faz: cada empresa cliente envia e-mails da Ziinp do próprio domínio (SMTP/SendGrid/Mailgun configuráveis).
• Por que é diferencial: ninguém quer que notificações de operação cheguem como notificacoes@ziinp.app. Quer operacao@empresa-do-cliente.com.br.

4.5. Backup por empresa

• URL: /companies/:id/backup.
• O que faz: export completo dos dados da empresa, sob demanda.
• Compliance: LGPD (direito de portabilidade).

4.6. Database Connections (já detalhado em 08-integracoes-e-dados.md)

4.7. Identidade

4.8. Permissões granulares

• Conceito: cada ação no sistema tem uma permission (criar formulário, ver wallet, editar agente IA, ver dashboard X, etc.).
• Atribuição: permissions são associadas a cargos (roles). Usuário recebe cargo → herda permissões.
• Override pontual: permissions podem ser dadas/revogadas a usuários específicos.
• Auditoria: mudanças de permissão ficam em /system-audit.

4.9. System Audit

• URL: /system-audit.
• O que faz: registro imutável de tudo que acontece:
• quem logou e quando;
• quem mudou cargo de quem;
• quem editou agente IA;
• quem excluiu dado;
• quem rodou backup.
• Por que é diferencial: auditoria ISO/SOX/LGPD em 1 tela.

4.10. Notifications Audit

• URL: /notifications-audit.
• O que faz: prova de envio, leitura e ação de notificações por canal.

4.11. Treinamentos

• URL: /treinamentos (lista), /treinamentos/:topicId (detalhe), /treinamentos/:topicId/estatisticas (stats), /treinamentos/:topicId/novo-documento (criar conteúdo).
• Funcionalidades:
• estrutura em tópicos e documentos;
• documentos ricos (markdown, EditorJS, anexos, vídeo);
• estatísticas de leitura;
• eventos por usuário (/treinamentos/documentos/:id/usuarios/:userId/eventos).

4.12. Meu conteúdo

• URL: /my-content, /my-content/new, /my-content/:id.
• O que faz: base pessoal de conhecimento do colaborador (rascunhos, anotações, materiais salvos).

4.13. Content management

• URL: /content-management.
• Para que: curadoria de conteúdo institucional.

4.14. Mobile real

• Capacitor (@capacitor/*) — empacotamento para Android e iOS nativos.
• Câmera, GPS, sensores acessíveis nativamente.
• PWA também disponível.

4.15. White-label profundo

• Logo, cor primária, nome da empresa visíveis em:
• cabeçalho do app;
• tela de login;
• e-mails enviados;
• documentos gerados (Z-Sign);
• PWA instalado no celular.
• Suporte a domínio próprio (com configuração).

4.17. Menus customizáveis

• URL: /menus.
• O que faz: customiza menu lateral por cargo/empresa.

4.18. Settings

• URL: /settings.
• O que controla: configurações globais por empresa (idioma, fuso, branding, notificações padrão).

[ 1. Time comercial cria company em /companies/new ]
              │
              ▼
[ 2. Configura branding (logo, cor, nome) ]
              │
              ▼
[ 3. Atribui plano comercial /companies/:id/plans ]
              │  (ativa módulos contratados)
              ▼
[ 4. Configura SMTP do cliente /companies/:id/email-config ]
              │
              ▼
[ 5. Cadastra admin do cliente em /users ]
              │
              ▼
[ 6. Cliente recebe e-mail de boas-vindas COM A MARCA DELE ]
              │
              ▼
[ 7. Cliente faz login → vê PWA com logo dele ]
              │
              ▼
[ 8. Cria primeiro formulário, primeiro fluxo, primeiro usuário ]
              │
              ▼
[ 9. Em 1 dia, está em produção, com identidade visual própria ]

Cenário A — Empresa SaaS revendendo Ziinp como produto próprio

A empresa "Acme Vistorias" usa Ziinp como base para seu produto "Acme Inspect". Cada cliente da Acme é uma company. Cada um vê "Acme Inspect" — nunca vê "Ziinp". A Acme cobra dos seus clientes, gerencia planos, e a Ziinp é invisível.

Cenário B — Grupo empresarial com 12 empresas

Holding com 12 razões sociais. Cada uma é uma company. Cada uma tem branding próprio, equipe própria, mas a corporate consegue ver consolidado por permissão master.

Cenário C — Compliance pedindo auditoria

Auditor externo solicita: "quem alterou o agente IA que aprova reembolsos nos últimos 90 dias?". /system-audit filtra, exporta, entrega em 2 minutos.

Cenário D — LGPD: usuário pede portabilidade

Cliente solicita seus dados. /companies/:id/backup exporta tudo, em formato estruturado, com metadados.

Cenário E — Treinamento obrigatório de SST

Empresa cadastra documento de "Treinamento de altura" em /treinamentos. Define que é obrigatório para o cargo "Eletricista". Stats mostram quem leu, quanto tempo, e quem ainda não leu. Cruza com Z-Score para pontuar conclusão.

7.1. Pitch 5 minutos

7.2. Apresentação 15 minutos

Objetivos

• Criar uma company nova com branding completo.
• Definir 3 cargos com permissões diferenciadas.
• Atribuir usuários e validar acesso.
• Auditar uma ação.
• Realizar backup e validar exportação.

Agenda

Exercícios

1. Criar company: "Empresa Teste 2026" com logo, cor, plano Pro, SMTP custom. 2. Cargos: crie "Gestor", "Operador", "Auditor". Atribua permissions distintas. Crie 3 usuários, um por cargo, e valide que cada um só vê o que pode. 3. Auditoria: edite o agente IA com usuário Gestor. Faça login como Auditor e busque essa edição em /system-audit. Execute backup e abra o arquivo.

Quiz

1. O que isola uma company da outra?
2. Como ativar/desativar módulo por plano?
3. Cargo (role) vs grupo: diferença prática?
4. Onde rastreio mudança de permissão?
5. Como o e-mail sai com o domínio do cliente?
6. Como atendo a um pedido LGPD de portabilidade?
7. O operador final percebe que é Ziinp?
8. Posso ter domínio próprio?

Setup inicial (de cada company nova)

• [ ] Logo, cor primária, nome.
• [ ] SMTP configurado e testado.
• [ ] Plano atribuído com módulos corretos.
• [ ] Pelo menos 2 admins designados.
• [ ] Cargos básicos criados.
• [ ] DB connections, se aplicável.
• [ ] Backup agendado.

Revisão trimestral

• [ ] Há usuários inativos? Desativar.
• [ ] Há cargos com permissão excessiva? Revisar.
• [ ] System Audit sem alerta vermelho?
• [ ] Backup testado (restauração validada)?
• [ ] Treinamentos obrigatórios lidos pela equipe?

Quantas companies a plataforma suporta? Multi-tenant escalável — depende da infra contratada.

Posso ter usuário que pertence a 2 empresas? Sim — vínculo multi-company com cargo distinto em cada.

Como apago um dado por solicitação LGPD? Procedimento documentado — soft delete + anonimização. Auditoria registra.

Suporta SSO corporativo? Social login nativo (Google, Microsoft). SAML/OIDC via parceiros.

O cliente final percebe que é Ziinp? Não — white-label completo (PWA, e-mails, documentos).

Posso ter idiomas diferentes por company? Sim — configuração por empresa.

Posso ter fuso diferente por company? Sim — fuso por usuário, herda da company.

E se 2 companies querem compartilhar um dashboard? Permissões cruzadas controladas, ou view consolidada por user com acesso a ambas.

Esta galeria revela as capacidades que tornam a plataforma governável e vendável: isolamento entre empresas, personalização, faturamento, backup, identidade, permissão, auditoria e treinamento. Ao final, a experiência white-label demonstra como a tecnologia permanece consistente enquanto a marca do cliente ocupa a linha de frente.

As telas administrativas foram capturadas no sandbox em 24/05/2026. Os quadros de PWA e e-mail de domínio próprio são ilustrações identificadas na legenda, criadas para representar entregas externas ao navegador.

Print 01 - Lista multi-tenant

Ampliar

Leitura do print: A administração apresenta tenants existentes e ações de detalhe/edição.

Evidência capturada; desktop / 1440 x 980; origem: `/companies`.

Print 02 - Detalhe da empresa

Ampliar

Leitura do print: A página real do tenant CSRT centraliza sua configuração.

Evidência capturada; desktop / 1440 x 980; origem: `/companies/:id`.

Print 03 - Branding e cadastro

Ampliar

Leitura do print: O editor inclui identidade e configurações do tenant.

Evidência capturada; desktop / 1440 x 980; origem: `/companies/:id/edit`.

Print 04 - SMTP customizado

Ampliar

Leitura do print: A tela mostra configuração ativa, volume enviado e parâmetros SMTP.

Evidência capturada; desktop / 1440 x 980; origem: `/companies/:id/email-config`.

Print 05 - Plano e modulos

Ampliar

Leitura do print: O tenant capturado possui plano ativo e limites visiveis.

Evidência capturada; desktop / 1440 x 980; origem: `/companies/:id/plans`.

Print 06 - Cobrança

Ampliar

Leitura do print: A área de cobrança está disponível, ainda vazia neste tenant.

Evidência capturada; desktop / 1440 x 980; origem: `/companies/:id/billings`.

Print 07 - Backup LGPD

Ampliar

Leitura do print: A exportação selecionavel torna concreto o controle de portabilidade de dados.

Evidência capturada; desktop / 1440 x 980; origem: `/companies/:id/backup`.

Print 08 - Usuários

Ampliar

Leitura do print: A lista administrativa documenta governança de usuários.

Evidência capturada; desktop / 1440 x 980; origem: `/users`.

Print 09 - Cargos e permissoes

Ampliar

Ampliar

Leitura do print: As duas telas comprovam o controle granular de direitos por papel administrativo.

Evidência capturada; desktop / 1440 x 980; origem: `/roles + /permissions`.

Print 10 - Auditoria do sistema

Ampliar

Leitura do print: A auditoria registra operações para conformidade e investigação.

Evidência capturada; desktop / 1440 x 980; origem: `/system-audit`.

Print 11 - Auditoria de notificações

Ampliar

Leitura do print: A evidência de envio complementa a trilha de auditoria.

Evidência reutilizada; desktop / 1440 x 980; origem: `/notifications-audit`.

Print 12 - Treinamentos corporativos

Ampliar

Leitura do print: A área de Documentos é a entrada real do conteúdo de treinamento.

Evidência capturada; desktop / 1440 x 980; origem: `/treinamentos`.

Print 13 - PWA white-label

Ampliar

Leitura do print: O aplicativo instalado assume a marca do cliente enquanto preserva a assinatura discreta da plataforma ZIINP, ilustrando a entrega white-label.

Imagem ilustrativa gerada com GPT Image a partir da marca oficial ZIINP; não representa instalação real em tenant do sandbox.

Print 14 - E-mail com domínio do cliente

Ampliar

Leitura do print: A notificação chega com identidade e remetente do cliente, incluindo confirmação da inspeção e acesso ao relatório, com assinatura de plataforma no rodapé.

Imagem ilustrativa gerada com GPT Image a partir da marca oficial ZIINP; não representa envio SMTP efetivo pelo sandbox.

🏢 Empresa SaaS revendendo Ziinp (white-label)

Cliente "Acme Inspect" usa Ziinp como plataforma base, vende para 200 empresas com o nome próprio. Cada cliente final é uma company. Nunca vê "Ziinp" — PWA com logo Acme, e-mail @acme.com, documentos Z-Sign com header Acme. Modelo: Acme paga Ziinp por consumo, fatura suas 200 empresas.

🏛️ Holding com 12 razões sociais

Cada razão social = uma company. Cada uma com identidade, planos, equipe. Acima de tudo: um "company holding" com permissão para enxergar consolidado das 12.

🌐 Grupo multinacional

Cada subsidiária por país é uma company. Idioma, fuso, moeda, branding e SMTP por país. Auditoria consolidada na matriz.

💼 Consultoria implantando para múltiplos clientes

Consultoria gerencia 30 companies (= 30 clientes). Cada cliente tem o seu time, seus formulários, sua marca. A consultoria tem cargo "Implementador" cross-company para configurar.

🏆 Franqueador

Franqueador é uma company "mãe". Cada franqueado é uma company. Padronização de formulários pela mãe, customização pelo franqueado.

🎯 Cliente único, multi-departamento

Para empresa que prefere separação rígida, cada departamento (Operações, Comercial, Manutenção) pode ser uma company com permissão controlada cross-departamento.

Receita 1 — Onboarding de novo cliente white-label (1h)

1. Em /companies/new
   Razão social: Cliente X Ltda
   CNPJ, dados fiscais
   Logo (PNG transparente)
   Cor primária (hex)
   Idioma, fuso

2. Em /companies/:id/plans
   Atribuir plano Pro (Field+Flow+Score+Sign+Schedule)

3. Em /companies/:id/email-config
   SMTP do cliente OU sender do cliente em provider compartilhado
   Domínio remetente: notificacoes@cliente.com.br

4. Em /users (no contexto do cliente)
   Criar admin master (2 pessoas mínimo)

5. Em /roles
   Cargos Default: Gestor, Operador, Auditor (com permissões pré-definidas)

6. Em /menus
   Customizar menu lateral por cargo

7. Envia e-mail de boas-vindas
   → cliente faz login, vê logo dele, sente que é "o sistema dele"

Receita 2 — Matriz de permissão padrão (template)

Cargo "Diretor":
  - read/write em tudo
  - ver wallet de qualquer um
  - editar agentes IA

Cargo "Gestor":
  - read/write em formulários da sua área
  - aprovar workflow
  - ver dashboards da área

Cargo "Operador":
  - read/write em sua resposta
  - preencher form
  - ver seu próprio score

Cargo "Auditor":
  - read em tudo
  - sem write
  - acesso total a /system-audit

Cargo "Visitante" (cliente final):
  - somente o que o link público der

Receita 3 — Política de auditoria mensal

Cron mensal dia 1:
  Agente "Auditor de Acesso" rola:
    - usuários sem login há 60+ dias → desativar
    - cargos sem usuários → revisar
    - mudanças de permissão no mês → relatório
    - backups feitos? → confirmação

  Envia relatório para CISO.

Receita 4 — Backup LGPD agendado

Trigger: cron mensal (último dia)
Action: /companies/:id/backup com export completo
Destino: bucket S3 da empresa (não da Ziinp)
Retenção: 7 anos (compliance fiscal)

Receita 5 — Treinamento obrigatório

Em /treinamentos
  Criar tópico "NR-35 — Trabalho em altura"
  Anexar documentos, vídeos
  Marcar obrigatório para cargo "Eletricista" e "Técnico de Altura"

Z-Schedule cria booking auto:
  conclusão até D+30 da contratação
  renovação anual

Z-Score:
  +50 ao concluir no prazo
  -10/dia atrasado

Painel:
  /treinamentos/documentos/estatisticas/empresa
  mostra status por colaborador, alerta vermelho se vencido

• Documentar a política de permissões da empresa (matriz cargo × módulo).
• Implantar backup automatizado (cron mensal).
• Migrar treinamentos internos para /treinamentos.
• Configurar domínio próprio para clientes premium.