Roadmap de implantação

Arquitetura Gendai Neofare

Plano validável para construir a marca Gendai com banco, API, endpoints e credenciais isolados, integrando Fare45 e Neo com segurança desde a loja piloto Gendai ABC.

GENDAI

FARE45

NEO

15etapas do projeto

150lojas previstas em 12 meses

30 milvendas por dia na rede

100%isolado da Patroni

Cronograma-base de 45 diasEtapas sobrepostas, validação conjunta e implantação assistida.

Início31/08/2026

Entrega prevista15/10/2026

Progresso de validação0 de 81 itens validados (0%)

Isolamento real

Supabase, API, endpoints, credenciais, Storage e IDs exclusivos da Gendai.

Fiscal por loja

Simples Nacional, Lucro Presumido ou Lucro Real com regras versionadas por produto.

Operação resiliente

Caixa, PDV, totem e KDS com idempotência, cache local e sincronização auditável.

Responsabilidades no projeto

Fare45Arquitetura, banco, APIs, aplicativos, segurança, versionamento e auditoria.

NeoPolling, vínculo dos IDs, processamento fiscal, XML, retornos e homologação da integração.

GendaiRegras de negócio, operação das lojas, catálogo, materiais e aceite funcional.

Fiscal GendaiRegime tributário, fichas fiscais, validações, vigências e aprovação contábil.

Confirmar que a Neo fará polling em endpoints exclusivos Gendai.Sem uso de URL, chave ou identificadores Patroni.Receber o exemplo atualizado efetivamente consumido hoje.Identificar campos ativos, legados e obrigatórios.Validar múltiplos regimes fiscais.Simples, Lucro Presumido e Lucro Real por loja.Definir identificação de marca, loja, CNPJ, produto e versão.Formalizar o mapeamento Fare45 ↔ Neo.Definir homologação, retorno de erros e confirmação.Estabelecer responsáveis e critérios de aceite.

Confirmar projeção de 150 lojas em 12 meses.Base: 200 vendas/dia por loja.Medir tamanho real de vendas e itens.Usar amostra anonimizada do ambiente atual.Definir disponibilidade e retenção.RPO, RTO e tempo de guarda dos dados.Definir módulos da primeira entrega.Admin, caixa, PDV, totem, KDS e integração Neo.

Criar organização Supabase Gendai.Equipe, faturamento e permissões próprios.Criar projeto gendai-homologacao.Dados exclusivamente de teste.Criar projeto gendai-producao.Dados reais, acesso restrito.Configurar RLS, SSL, MFA e responsáveis.Privilégio mínimo desde o início.Definir backup diário e cópia externa.PITR será avaliado na expansão.

Criar repositório privado fare45-gendai.Sem código ou segredo da Patroni.Organizar admin, PDV, totem, KDS e API.Contratos e componentes compartilhados.Versionar todas as migrations.Nenhuma mudança manual em produção.Configurar revisão e proteção da branch principal.Homologação antes de produção.Configurar segredos por ambiente.Nunca registrar chaves no repositório.

Criar subdomínios Gendai.Admin, PDV, totem, KDS, API e homologação.Configurar HTTPS, WAF e rate limit.Proteção específica da API Neo.Configurar CDN das imagens.Catálogo rápido para PDV e totem.Configurar R2 para arquivo e backup externo.Separado dos arquivos Patroni.Definir monitoramento de disponibilidade.Alertas para APIs e aplicações críticas.

Criar tenant e marca Gendai.UUIDs exclusivos no banco Gendai.Criar loja piloto Gendai ABC.Código GND-ABC-001 e UUID imutável.Criar usuários, perfis e vínculos por loja.Admin, gerente, operador e fiscal.Criar cadastro de dispositivos.PDV, totem, KDS, impressora e heartbeat.Criar auditoria campo a campo.Autor, origem, antes, depois e horário.

Criar categorias, produtos, variações e complementos.Estrutura independente da Patroni.Criar vínculos produto × loja.Ativação e disponibilidade próprias.Configurar canais PDV, Totem e Delivery.Visibilidade controlada por canal.Configurar preços na ordem oficial.Balcão, iFood, 99Food, Convênio e Lojista.Criar histórico, vigência e agendamento.Nenhum preço sobrescrito sem auditoria.Subir e vincular as fotos dos produtos.Cadastrar a imagem correta em cada produto do catálogo Gendai e validar sua entrega pela API para PDV e Totem. Responsável direto: Fare45. Critério de saída: todos os produtos comercializáveis da loja piloto possuem foto vinculada, URL acessível, proporção/qualidade adequada e retorno validado no snapshot da API; produtos técnicos internos e opções que não exigem imagem devem ser identificados explicitamente. Evidência esperada: relatório de cobertura de imagens, amostra visual no Preview Neo e teste das URLs retornadas.

Criar perfil fiscal versionado da loja.Regime, CRT, UF, município e vigência.Criar ficha fiscal do produto por loja.NCM, origem, CEST, CFOP, PIS e COFINS.Separar CSOSN e CST ICMS.Campos e grupos XML coerentes com o CRT.Criar regras condicionais de ST, FCP e benefícios.Obrigatoriedade conforme o código escolhido.Preparar IBS, CBS e Imposto Seletivo.Com vigência e versão de regra.Criar fluxo rascunho → validação → publicação.Aprovação do responsável fiscal.

Criar origem dos produtos.Produção própria, revenda, central, fornecedor e terceirizado.Criar cadastro de itens e ingredientes.Unidade de medida, conversões, rendimento, validade e fornecedor.Criar lista de compras por loja.Necessidade, estoque atual, sugestão, fornecedor e status da compra.Criar fichas técnicas versionadas.Ingredientes, quantidades, perdas, rendimento, custo e modo de preparo.Vincular fichas técnicas ao cardápio.Produto de venda conectado à composição e ao custo real.Criar cardápio por loja e canal.Categorias, disponibilidade, preço e visibilidade no PDV e totem.Validar impacto no estoque e CMV.Baixa de insumos conforme cada venda e composição.

Criar abertura, sangria, suprimento e fechamento.Sessão por operador, terminal e loja.Criar pedidos, itens, descontos e pagamentos.Chave de idempotência em toda venda.Criar cancelamento, estorno e divergência.Permissões e motivos obrigatórios.Criar documentos e referências fiscais.ID Neo, cupom e status de processamento.Implementar cache e fila offline.Reconexão sem duplicar vendas.

Registrar e parear cada totem.Credencial limitada à própria loja.Baixar catálogo e preços por versão.Atualizar somente quando houver mudança.Implementar pedido com idempotência.Reenvio seguro após falha.Implementar modo degradado/offline definido.Último catálogo válido e sinalização.Validar impressão, pagamento e envio ao KDS.Teste de ponta a ponta.

Criar áreas e estações de produção.Cozinha, bebidas, expedição e outras.Vincular cada produto à área correta.Regras por loja.Criar tickets e eventos do KDS.Recebido, preparando, pronto e expedido.Tratar cancelamentos e alterações.Atualização visível e auditável.Medir tempo por item, área e pedido.Indicadores operacionais.

Publicar APIs Gendai de homologação e produção.URLs e chaves totalmente independentes. A infraestrutura de homologação pode ser publicada antes do preenchimento fiscal, mas a homologação funcional completa e a liberação para produção dependem da validação dos campos fiscais obrigatórios e do catálogo.Criar mapeamento explícito de lojas e produtos.IDs Fare45 e Neo preservados separadamente.Disponibilizar snapshot completo.Recuperação segura do estado da loja.Disponibilizar mudanças incrementais.Cursor, paginação, vigência e inativações.Registrar cada polling e request ID.Histórico para diagnóstico.Receber confirmação e rejeições.Versão aplicada e erros por produto/campo.

Executar venda completa no PDV.Caixa, pagamento, fiscal, KDS e fechamento.Executar venda completa no totem.Preço, pagamento, KDS e idempotência.Validar ficha fiscal e XML resultante.Aprovação conjunta com a Neo.Simular internet e serviços indisponíveis.Recuperação sem perda ou duplicidade.Executar teste de carga e segurança.Volume atual e margem de crescimento.Conferir relatórios e auditoria.Totais e rastreabilidade ponta a ponta.

Aplicar migrations em produção.Sem copiar IDs ou dados da homologação.Cadastrar novamente Gendai ABC.Novos UUIDs e credenciais de produção.Realizar operação assistida.Monitoramento intensivo no piloto.Revisar métricas e incidentes.Correções antes da expansão.Criar checklist de abertura de nova loja.Processo repetível e auditável.Expandir por ondas controladas.Uma loja só entra após todos os critérios.

Arquitetura Gendai Neofare

Isolamento real

Fiscal por loja

Operação resiliente

Responsabilidades no projeto

Contrato e governança com a Neo

Requisitos e capacidade

Organização Supabase Gendai

Repositório e entrega contínua

Cloudflare e endereços

Núcleo do banco

Catálogo e preços

Fiscal por loja e produto

Materiais e engenharia de cardápio

Caixa e PDV

Totem

KDS e produção

API e polling Neo Gendai

Homologação Gendai ABC

Produção e expansão