# Arquitetura 

O GMShop Edge utiliza o mesmo stack React/TanStack completo, seja na Cloudflare Workers ou no Bun/Nitro. Uma única implantação gerencia a loja pública, a área de contas do cliente, o processo de checkout, a gestão de pedidos, a integração com fornecedores, a integração com Telegram e o console de administração.

## Limites de aplicação compartilhados 

As rotas permanecem limitadas. As páginas de funcionalidades, os esquemas, as funções do servidor e o comportamento do domínio residem em `src/features`; a infraestrutura de tempo de execução entre domínios está localizada em `src/server`; os esquemas do Drizzle residem em `src/db/schema`.

A aplicação mantém informações de identidade, RBAC, catálogo, pedidos, inventário, direitos de acesso, estado dos fornecedores, registro da carteira, notificações, proteção contra reprodução, limites de taxa, outbox e dados de auditoria no banco de dados principal. O dinheiro é armazenado como strings de inteiros decimais nas unidades menores e nunca é calculado com ponto flutuante.

## Adaptadores Cloudflare Workers 

A implantação dos trabalhadores utiliza:

* `DB`: D1 para aplicação e estado comercial autoritário.
* `FILES`: armazenamento privado no R2 para mídias de produtos, downloads, artefatos de automação e exportações.
* `CACHE`: Armazenamento de chave-valor para caches de leitura validados, versionados e com limites definidos; os limites de segurança permanecem baseados no banco de dados.
* `COMMERCE_QUEUE`: Fila para tarefas de entrega, automação, notificação, fornecedores e reembolso, com uma fila de mensagens mortas.
* `EMAIL`: binding opcional do Cloudflare Send Email.
* Gatilhos de 60 segundos do Cron para processamento e manutenção agendados.

## Adaptadores Bun/Nitro 

O tempo de execução Bun fornece adaptadores equivalentes dentro de um único diretório de dados:

* SQLite como o banco de dados principal/oficial.
* Cache limitada em desenvolvimento.
* Armazenamento local de objetos privado.
* Uma fila robusta, baseada em SQLite.
* Um agendador em tempo real de um minuto.

`GMSHOP_DATA_DIR` contém o banco de dados, objetos, estado da fila e dados de execução. O Bun é intencionalmente **apenas para uma instância**: a implantação em réplica múltipla e o armazenamento em rede compartilhado não são suportados.

## Dados e trabalho de fundo 

Objetos privados são resolvidos através de registros de banco de dados autorizados; os clientes nunca selecionam chaves de objeto. A fila e o trabalho agendado lidam com a sincronização com fornecedores, compras, atendimento, notificações, reembolsos, tentativas, retenção, manutenção do Telegram e rotação de chaves fora das solicitações sincronizadas da loja.

A linha de base para a migração (limpeza) é `drizzle/0000_gmshop.sql`; as migrações subsequentes são aplicadas em ordem e seus checksums são validados pelas operações de dados do Bun.
