Base do projeto/docs/persistencia-e-arquivos

Persistência e Arquivos

Arquivos principais:

Recorte da seçãoBase estrutural do projeto

Nota de referência para contratos, arquitetura, runbook e organização do workspace. É a camada mais estável da documentação.

Atualizado19 de mar. de 2026

Seções8

Tags3

persistênciajsonruntime

Persistência administrativa local

Arquivos principais:

Espelho legado:

Modo atual:

ECOM_SITE_PERSISTENCE_MODE=files: painel usa só esses arquivos;
ECOM_SITE_PERSISTENCE_MODE=hybrid: painel prefere PostgreSQL, mas ainda mantém os arquivos e o snapshot publicados em sincronia;
ECOM_SITE_PERSISTENCE_MODE=database: o banco vira a fonte de verdade do painel, e os arquivos publicados continuam apenas como projeção de runtime da loja.

Arquivos principais:

Espelho legado:

Modo atual:

ECOM_STOREFRONT_PERSISTENCE_MODE=files: painel usa só esses arquivos;
ECOM_STOREFRONT_PERSISTENCE_MODE=hybrid: painel prefere PostgreSQL, mas ainda mantém os arquivos e o snapshot publicados em sincronia;
ECOM_STOREFRONT_PERSISTENCE_MODE=database: o banco vira a fonte de verdade do painel, e o snapshot publicado continua como projeção rápida da loja.

Arquivos principais:

Modo atual:

ECOM_PANEL_SETTINGS_PERSISTENCE_MODE=files: configurações administrativas ficam em arquivo;
ECOM_PANEL_SETTINGS_PERSISTENCE_MODE=hybrid: painel prefere PostgreSQL para essas configurações e mantém arquivos/snapshots necessários em sincronia;
ECOM_PANEL_SETTINGS_PERSISTENCE_MODE=database: PostgreSQL vira a fonte administrativa dessas configurações.

Arquivos publicados:

Se ECOM_CONTENT_PATH existir, a publicação vai para o diretorio compartilhado definido por essa variavel.

src/data/ecommpanel: fallback em arquivo e base local de desenvolvimento
PostgreSQL: fonte administrativa quando um domínio está em hybrid ou database
src/data/site-runtime: projeção publicada para consumo rápido do storefront

A estrutura atual já separa os domínios que podem viver em banco e ainda manter projeção publicada: