Dados, Segurança e Configuração
Esta página responde três perguntas práticas: onde cada dado fica, como o contexto de uma loja é separado e onde uma configuração deve ser alterada.
Onde os dados vivem
flowchart LR
services[Serviços de aplicação] --> pg[(PostgreSQL)]
services --> redis[(Redis)]
wrapper[WooCommerce Wrapper] --> minio[(MinIO)]
ai[GenAI Wrapper] --> weaviate[(Weaviate)]
pg --> records[Dados duráveis da plataforma]
redis --> context[Contexto temporário e sessões]
minio --> media[Mídias de produtos]
weaviate --> search[Índice de busca semântica]
| Componente | Guarda | Não deve ser usado para |
|---|---|---|
PostgreSQL (merchants-db) |
Lojas, usuários, configuração da plataforma, integrações, registros operacionais e uso de IA. | Estado efêmero de conversa ou arquivos de mídia. |
| Redis | Sessões, estado de máquinas de estados, locks, cache e dados temporários de jornadas. | Única cópia de informação que precisa sobreviver a reinícios. |
| MinIO | Arquivos e imagens usados pela plataforma e pelo catálogo. | Dados relacionais ou segredos. |
| Weaviate | Vetores e textos necessários para pesquisa semântica de produtos. | Fonte comercial definitiva de produto; o WooCommerce continua sendo a referência. |
Separação entre lojas
O merchant_id identifica o contexto da loja nas operações da plataforma. Ele é usado para buscar configurações, dados comerciais e registros de uso de IA.
No índice vetorial, cada loja é tratada como um tenant do Weaviate. Assim, uma consulta de produtos é executada no tenant correspondente, e não em um catálogo compartilhado. Essa separação precisa ser preservada sempre que uma nova integração, consulta ou cache for criada.
Regra de implementação
Nunca aceite um merchant_id sem verificar se ele pertence ao contexto autenticado ou ao evento recebido. Uma identificação incorreta pode expor dados ou executar ações na loja errada.
Camadas de configuração
flowchart TB
infra[infra/.env<br>rede e componentes compartilhados] --> compose[Docker Compose]
module[modules/<serviço>/.env<br>configuração do serviço] --> compose
db[Configuração administrável<br>PostgreSQL] --> services[Serviços em execução]
compose --> services
| Camada | Use para | Exemplos |
|---|---|---|
infra/.env |
Infraestrutura compartilhada e endereços públicos. | Token do Tunnel, domínio de desenvolvimento, banco e MinIO. |
modules/<serviço>/.env |
Dependências e comportamento exclusivo de um serviço. | URLs internas, chaves de integração, limites e parâmetros da aplicação. |
| Configuração administrável | Valores que a equipe precisa ajustar sem redeploy. | Dados da conta central do WhatsApp, configurações da plataforma e dados por loja. |
O arquivo .env.example existe como referência de nomes e formatos. Ele não deve receber valores reais de produção.
Regras de segurança essenciais
- Segredos não entram no Git. Tokens, senhas, chaves privadas, credenciais do WooCommerce e chaves de provedores de IA pertencem ao ambiente seguro de execução.
- Não exponha serviços internos. Nginx e Cloudflare Tunnel são a fronteira pública. Bancos, Redis e serviços internos devem permanecer na rede Docker.
- Mantenha chaves de Flow protegidas. O
whatsapp-entrypointusa uma chave privada RSA para processar interações de WhatsApp Flows. Ela deve ser tratada como segredo de alto impacto. - Use autenticação entre serviços. Rotas internas sensíveis exigem chave interna; chamadas administrativas usam sessão e autorização no
frontend-entrypoint. - Evite dados sensíveis em logs. Registre contexto suficiente para diagnosticar uma falha, como
request_ide identificadores técnicos, sem registrar tokens, senhas, payloads privados ou conteúdo desnecessário de clientes.
Antes de publicar uma mudança de configuração
- Confirme se a variável pertence à infraestrutura compartilhada ou a um único módulo.
- Atualize o respectivo
.env.exampleapenas com o nome e uma descrição segura, nunca com o valor de produção. - Verifique dependências e healthchecks após a publicação.
- Para mudanças de banco, siga o procedimento em Deploy e Migrações.
- Para uma falha de integração, consulte Observabilidade e Diagnóstico.
O que esta página não garante
Ela descreve os controles e limites presentes na arquitetura. Políticas de retenção, backups, criptografia em repouso, gestão de acesso da infraestrutura e resposta a incidentes devem ser formalizadas e validadas pela equipe responsável antes de serem tratadas como garantias de produção.