Dados, segurança e configuração¶
Onde cada dado fica¶
| Recurso | Conteúdo |
|---|---|
| PostgreSQL | Lojas, usuários, configurações, mensagens, registros operacionais e consumo de IA. |
| Redis | Sessões, estados de conversa, locks, cache e dados temporários. |
| MinIO | Imagens e arquivos utilizados pela plataforma. |
| Weaviate | Produtos e vetores para busca por significado, com contexto da loja. |
| WooCommerce | Catálogo comercial, estoque e pedidos da loja integrada. |
Volumes replicados não substituem backups. A existência de uma réplica PostgreSQL também não confirma failover automático ou recuperação validada.
Camadas de configuração¶
| Camada | Local | Exemplos |
|---|---|---|
| Infraestrutura | Manifests e ConfigMaps do ambiente | URLs internas, endpoints públicos, probes, recursos e logs. |
| Secrets de execução | Variáveis File do GitLab e Secrets do namespace | Banco, MinIO, chaves internas, sessões e chaves privadas. |
| Configuração administrável | Painel e PostgreSQL | Credenciais/modelos de IA, SMTP, aplicativo Meta e conta administrativa de WhatsApp. |
| Configuração da loja | Cadastro e onboarding do lojista | URL/chaves WooCommerce, conta WhatsApp e parâmetros comerciais. |
| Desenvolvimento local | .env e arquivos de exemplo por módulo |
Configuração local, sem copiar automaticamente valores reais. |
Trocar um Secret não apaga tokens já persistidos no banco. Confira de onde o código da versão implantada lê cada configuração. Em especial, o gateway de IA resolve as credenciais pelas configurações da plataforma; SMTP admite configurações do painel e fallback de ambiente.
Isolamento¶
flow-prdeflow-hmldevem ter dados e credenciais próprios.- Números de WhatsApp e lojas de teste precisam ser recursos diferentes dos reais.
- Kubeconfigs devem ter escopo adequado ao ambiente.
- NetworkPolicies e quotas precisam ser verificadas no cluster: um namespace sozinho não garante isolamento de rede ou capacidade.
- Não importar banco real para testes sem sanitizar credenciais, dados pessoais e tarefas pendentes antes da inicialização dos serviços.
Publicação e logs¶
Esta documentação pode ser hospedada publicamente. Não adicionar tokens, dumps, kubeconfigs, capturas com credenciais, dados reais de clientes ou conteúdo integral de logs. Exemplos devem usar placeholders ou dados fictícios.
Logs estruturados e correlação são descritos em observabilidade. Planos detalhados com dados privados de infraestrutura devem permanecer em local de acesso restrito.