Dados e persistência
Produção usa PostgreSQL como fonte de verdade dos domínios administrativos. Arquivos permanecem para mídia, projeções publicadas, defaults versionados e pacotes de backup.
Consulte contratos, decisões e comportamentos atuais do sistema com caminhos diretos para os detalhes relacionados.
Nesta página · 5 tópicos
Autoridade por classe
| Classe | Fonte principal | Projeção ou arquivo |
|---|---|---|
| usuários e sessões | PostgreSQL | nenhuma autoridade em arquivo |
| catálogo, logística e promoções | PostgreSQL | defaults apenas para desenvolvimento controlado |
| pedidos e clientes | PostgreSQL | snapshots dentro do próprio pedido |
| páginas, blog e template | PostgreSQL | projeção publicada regenerável |
| Data Studio | PostgreSQL | pacote de exportação e schema de apoio |
| clientes de API e tokens | PostgreSQL | segredo nunca persistido em texto puro |
| mídia | filesystem externo | metadados e backup com checksum |
| analytics | PostgreSQL quando configurado | modo híbrido apenas em transição |
Fluxo de escrita e leitura
Runtime externo
Em produção, ECOM_RUNTIME_ROOT e ECOM_CONTENT_PATH devem apontar para diretórios fora do checkout Git. Isso evita que git pull, build ou troca de release removam mídia, snapshots e metadados operacionais.
Modos de persistência
Variáveis ECOM_*_PERSISTENCE_MODE controlam a transição entre hybrid e database. O alvo de produção é database para site, storefront, catálogo, logística, analytics e configurações. O painel de saúde lista qualquer domínio que ainda não esteja nesse modo.
Backup não é fallback
Backup serve para recuperação e migração. Ele não deve participar da leitura normal da aplicação. O pacote de setup exporta tabelas de configuração e conteúdo; a biblioteca de mídia possui pacote separado devido ao volume e às características binárias.
Consulte 10 - Backup e Restauracao para procedimento e 02 - Ambiente e Runtime para variáveis.