ROADMAP — Evolução do Produto
Sequenciamento documental das capacidades do Sistema Gastronômico para Operações com Mesas a partir das baselines aprovadas. Revisão v0.2: resolve dentro da ROAD-02 as decisões de isolamento multi-tenant (SaaS) — PRD TBD-003, ERD-TBD-001 e ERD-TBD-002. Revisão v0.3: resolve Mesa/QR Code (RF-041 a 043) e identifica três novos TBDs — cadastro de Organização (TBD-020), gateway de pagamento (TBD-021) e API de CNPJ (TBD-022).
Nota de Governança
Este Roadmap v0.1 organiza dependências e sequência lógica de evolução. Ele não estabelece datas, prazos comerciais, estimativas de desenvolvimento ou compromisso de lançamento. O status de uma fase neste documento representa seu estado dentro do planejamento documental. Não deve ser interpretado automaticamente como status real de desenvolvimento ou produção.
Fases de Evolução
BASELINE DOCUMENTAL
DECISÕES TÉCNICAS PRÉ-IMPLEMENTAÇÃO
NÚCLEO MVP: ACESSO E PEDIDO
OPERAÇÃO DA RECEPÇÃO
OPERAÇÃO DA COZINHA
ACOMPANHAMENTO E INTEGRAÇÃO OPERACIONAL
ESTABILIZAÇÃO OPERACIONAL E QUALIDADE
INSUMOS E ESTOQUE
LOTES E VALIDADE
FICHA TÉCNICA E CUSTOS
CMV
Princípios de Evolução
BASELINES ANTES DA IMPLEMENTAÇÃO
Implementações futuras devem respeitar PRD, ERD, RBAC/RLS e Fluxos UX aprovados.
MVP ANTES DOS MÓDULOS EVOLUTIVOS
O núcleo M01–M08 precede a expansão funcional de M09–M12.
DEPENDÊNCIAS EXPLÍCITAS
Nenhuma capacidade deve avançar sobre decisão TBD necessária à implementação.
ISOLAMENTO ORGANIZACIONAL
Toda implementação futura deve respeitar a separação conceitual entre Organizações.
SEGURANÇA POR FUNÇÃO
Implementações futuras devem respeitar RBAC/RLS v0.1 aprovado.
EXPERIÊNCIA DERIVADA DOS FLUXOS
Telas e interações futuras devem derivar dos Fluxos UX v0.1 aprovados.
REUTILIZAÇÃO ENTRE OPERAÇÕES
A evolução deve preservar a possibilidade de utilização por diferentes negócios.
Visão Macro
Detalhamento das Fases
Baseline Documental
Objetivo
Estabelecer a fonte de verdade documental anterior às decisões físicas de implementação.
Entregas
- PRD v0.1 — APROVADO
- ERD v0.1 — APROVADO
- RBAC/RLS v0.1 — APROVADO
- Fluxos UX v0.1 — APROVADO
Critério de Entrada
Existência das fontes documentais necessárias à consolidação das baselines v0.1.
Critério de Saída
Quatro baselines documentais aprovadas.
Governança
Não declara software implementado.
Decisões Técnicas Pré-Implementação
Objetivo
Identificar decisões necessárias para transformar a documentação conceitual em arquitetura implementável.
Escopo
Estratégia técnica de isolamento entre Organizações, Autenticação, Identidade/persistência do Cliente, Ciclo do QR Code, Relação QR Code ↔ Mesa, Estrutura Organizacional, Multiunidade.
Pendências / TBDs
PRD TBD-001, PRD TBD-004 (parcial), PRD TBD-017, PRD TBD-019 (novo, cobrança/assinatura), ERD-TBD-003 Identidade e persistência do Cliente (RN-001), ERD-TBD-005 Ciclo e cardinalidade Mesa ↔ QR Code — PRD TBD-003, ERD-TBD-001 e ERD-TBD-002 RESOLVIDOS em v0.2 (isolamento multi-tenant / SaaS)
Critério de Entrada
Baselines v0.1 aprovadas.
Critério de Saída
Decisões técnicas estritamente necessárias à implementação identificadas e resolvidas quando realmente bloqueadoras.
Governança
Não assume stack definitiva (Supabase/Postgres/etc). Isso NÃO significa resolver todos os TBDs nesta fase.
Núcleo MVP: Acesso e Pedido
Objetivo
Cobrir a jornada do Cliente desde acesso pelo QR Code até criação e acompanhamento do Pedido.
Módulos
M01, M02, M03, M04, M05
Fluxos UX
UX-001 a UX-006
Pendências / TBDs
PRD TBD-005, TBD-006, TBD-016, TBD-017, TBD-018
Critério de Entrada
Decisões técnicas ROAD-02 identificadas.
Critério de Saída
Jornada do Cliente (Acesso a Pedido) funcional conforme baselines.
Operação da Recepção
Objetivo
Acompanhamento operacional dos Pedidos e suporte ao atendimento.
Módulos
M06
Fluxos UX
UX-007, UX-008, UX-009
Critério de Entrada
Núcleo MVP ROAD-03 funcional.
Critério de Saída
Interface da Recepção validada operacionalmente.
Governança
A Recepção possui visão operacional mais ampla do Pedido que a Cozinha e pode consultar o Cardápio conforme o escopo aprovado, sem receber administração do catálogo.
Operação da Cozinha
Objetivo
Disponibilizar informações necessárias à produção e permitir acompanhamento do preparo.
Módulos
M07
Fluxos UX
UX-010, UX-011
Critério de Entrada
Fluxos de Pedido (ROAD-03/04) integrados.
Critério de Saída
Interface da Cozinha validada operacionalmente.
Governança
Nome, WhatsApp, E-mail e identificação da Mesa não são informações necessárias ao contexto de produção da Cozinha na baseline v0.1.
Acompanhamento e Integração Operacional
Objetivo
Consolidar a evolução operacional do Pedido entre Cliente, Recepção e Cozinha.
Módulos
M08
Fluxos UX
UX-006, UX-014 (Relacionados: 007, 009, 011, 012)
Critério de Entrada
Fases ROAD-03 a ROAD-05 concluídas documentalmente.
Critério de Saída
Fluxo integrado de acompanhamento operacional validado conforme as baselines aprovadas.
ROAD-M1 — MARCO DO MVP
Núcleo MVP documentalmente especificado (M01 a M08 possuem requisitos, modelo, acesso e fluxos).
Capacidades de Gestão no MVP
UX-012 — Supervisão
Acompanhamento e intervenção gerencial.
UX-013 — Administração
Gestão de Cardápio e Preços.
Estabilização Operacional e Qualidade
Objetivo
Validar o núcleo implementado futuramente antes da expansão funcional.
Escopo
Responsividade (RNF-001), Mobile First (RNF-002), Legibilidade Operacional (RNF-003), Segurança (RNF-004), Isolamento Organizacional (RNF-005), Privacidade (RNF-006), Performance (RNF-007), Manutenibilidade (RNF-008), Compatibilidade Web (RNF-009), Acessibilidade (RNF-010), Auditabilidade (RNF-011), Escalabilidade (RNF-012).
Critério de Entrada
Núcleo MVP ROAD-06 estabilizado funcionalmente.
Critério de Saída
Núcleo operacional validado qualitativamente quanto aos requisitos não funcionais aplicáveis da baseline v0.1.
Governança
Conformidade total com RNFs aprovados.
Insumos e Estoque
Módulos
M09
Fluxos UX
UX-015, UX-016
Pendências / TBDs
PRD TBD-008, TBD-010
Critério de Entrada
ROAD-07 concluído.
Critério de Saída
Gestão de Insumos e Estoque operacional.
Governança
SALDO DE ESTOQUE: DERIVADO. PERSISTÊNCIA FÍSICA: A DEFINIR. Não define baixa automática nem movimentação obrigatoriamente manual.
Lotes e Validade
Objetivo
Evoluir para controle conceitual de Lotes, Validade e identificação de itens próximos do vencimento.
Módulos
M10
Fluxos UX
UX-017
Critério de Entrada
ROAD-08 funcional.
Critério de Saída
Rastreabilidade de validade por Lote operacional.
Governança
FIFO/FEFO: PENDENTE. Não determina algoritmo de priorização.
Ficha Técnica e Custos
Módulos
M11
Fluxos UX
UX-018
Pendências / TBDs
PRD TBD-012
Critério de Entrada
Baselines de Insumos (ROAD-08) disponíveis.
Critério de Saída
Ficha Técnica e composição de custos validada.
Governança
CUSTO DA FICHA: DERIVADO. PERSISTÊNCIA FÍSICA: A DEFINIR. Não exige ROAD-09 como dependência cronológica obrigatória.
CMV
Objetivo
Permitir cálculo ou visualização do CMV quando os dados necessários estiverem disponíveis.
Módulos
M12
Fluxos UX
UX-019
Pendências / TBDs
PRD TBD-011, TBD-012, ERD-TBD-006 Persistência histórica do CMV
Critério de Entrada
Dados técnicos e de custos necessários ao cálculo disponíveis, incluindo as informações aplicáveis da Ficha Técnica (ROAD-10).
Critério de Saída
Cálculo de CMV validado.
Governança
CMV: DERIVADO. PERSISTÊNCIA FÍSICA: A DEFINIR. Não cria periodicidade, relatórios obrigatórios ou benchmarks.
Dependência dos Módulos Evolutivos
Esta sequência representa dependências conceituais de evolução e não define automações, persistência física ou ordem cronológica obrigatória de implantação.
Matriz do Roadmap
| ID | Fase | Escopo | Módulos | UX | Dependências | Status |
|---|---|---|---|---|---|---|
| ROAD-01 | Baseline Documental | PRD, ERD, RBAC, UX | — | — | — | CONCLUÍDA NA DOCUMENTAÇÃO v0.1 |
| ROAD-02 | Decisões Técnicas | Arquitetura, Autenticação | — | — | ROAD-01 + TBDs técnicos (PRD 001/003/004/017 + ERD 001/002/003/005) | PREVISTO PARA EVOLUÇÃO |
| ROAD-03 | Núcleo MVP | Acesso, Pedido | M01–M05 | 001–006 | PRD TBD-005, 006, 016, 017, 018 | PREVISTO |
| ROAD-04 | Recepção | Operação, Mesas | M06 | 007–009 | ROAD-03 | PREVISTO |
| ROAD-05 | Cozinha | Produção | M07 | 010–011 | ROAD-04 | PREVISTO |
| ROAD-06 | Acompanhamento e Integração Operacional | Acompanhamento e integração operacional do Pedido | M08 | 006, 014 | ROAD-05 | PREVISTO |
| ROAD-07 | Estabilização Operacional e Qualidade | Estabilização operacional e requisitos não funcionais | — | — | ROAD-06 | PREVISTO |
| ROAD-08 | Insumos e Estoque | Insumos e Estoque | M09 | 015, 016 | ROAD-07 + PRD TBD-008, 010 | EVOLUÇÃO PREVISTA |
| ROAD-09 | Lotes e Validade | Lotes e Validade | M10 | 017 | PRD TBD-009 | EVOLUÇÃO PREVISTA |
| ROAD-10 | Ficha Técnica e Custos | Ficha Técnica e Custos | M11 | 018 | PRD TBD-012 | EVOLUÇÃO PREVISTA |
| ROAD-11 | CMV | Cálculo / visualização do CMV | M12 | 019 | ROAD-10 + PRD TBD-011, 012 + ERD-TBD-006 | EVOLUÇÃO PREVISTA |
Mapa de Dependências
Decisões que Impactam o Roadmap
| ID | Tema Oficial | Impacto no Roadmap | Fase(s) Afetada(s) | Status |
|---|---|---|---|---|
| PRD TBD-001 | Autenticação | Condiciona a definição técnica de acesso. | ROAD-02 | PENDENTE |
| PRD TBD-003 | Estrutura Organizacional | Resolvido: isolamento multi-tenant via Postgres RLS (Supabase Cloud). | ROAD-02 | RESOLVIDO v0.2 |
| PRD TBD-004 | Multiunidade | Parcialmente resolvido: 1 Organização = 1 unidade nesta baseline. "Uma conta gerenciando várias unidades" segue fora de escopo. | ROAD-02 | PARCIAL v0.2 |
| PRD TBD-019 | Governança de cobrança/assinatura (novo) | Condiciona o gatilho de tenant_escrita_liberada(). | ROAD-02 | PENDENTE |
| PRD TBD-005 | Lifecycle definitivo do Pedido | Condiciona o lifecycle operacional do Pedido. | ROAD-03, ROAD-06 | PENDENTE |
| PRD TBD-006 | Alteração/cancelamento do Pedido após envio | Condiciona o lifecycle operacional do Pedido. | ROAD-03 | PENDENTE |
| PRD TBD-008 | Baixa automática de Estoque | Condiciona a estratégia de estoque. | ROAD-08 | PENDENTE |
| PRD TBD-009 | FIFO / FEFO ou regra equivalente | Condiciona a estratégia de estoque. | ROAD-09 | PENDENTE |
| PRD TBD-010 | Governança de Inventário | Condiciona a estratégia de estoque. | ROAD-08 | PENDENTE |
| PRD TBD-011 | Faixas oficiais de CMV | Condiciona a governança de cálculo do CMV. | ROAD-11 | PENDENTE |
| PRD TBD-012 | Método de atualização dos custos dos Insumos | Condiciona a governança de cálculo do CMV. | ROAD-10, ROAD-11 | PENDENTE |
| PRD TBD-016 | Retenção e exclusão de dados | Condiciona a governança de retenção e exclusão dos dados tratados pelo sistema. | ROAD-03 | PENDENTE |
| PRD TBD-017 | Ciclo do QR Code | Condiciona a definição técnica de acesso. | ROAD-02, ROAD-03 | PENDENTE |
| PRD TBD-018 | Disponibilidade / indisponibilidade de Produto | Condiciona o comportamento de disponibilidade de Produtos no Cardápio e no fluxo de criação do Pedido. | ROAD-03 | PENDENTE |
| ERD-TBD-001 | Estratégia técnica de isolamento entre organizações (SaaS) | Resolvido: Postgres RLS (Supabase Cloud), padrão current_org_id()/has_org_role()/platform_admin/tenant_escrita_liberada(). | ROAD-02 | RESOLVIDO v0.2 |
| ERD-TBD-002 | Cardinalidade Usuário Interno ↔ Organização | Resolvido: 1:N direto, contexto de Organização ativa único por vez. | ROAD-02 | RESOLVIDO v0.2 |
| ERD-TBD-003 | Identidade e persistência do Cliente | Condiciona a definição técnica de acesso. | ROAD-02 | PENDENTE |
| ERD-TBD-005 | Ciclo/cardinalidade Mesa ↔ QR Code | Condiciona a definição técnica de acesso. | ROAD-02 | PENDENTE |
| ERD-TBD-006 | Persistência histórica do CMV | Condiciona a governança de cálculo do CMV. | ROAD-11 | PENDENTE |
| PRD TBD-020 | Cadastro de Organização — autoatendimento ou onboarding manual | Condiciona ACESSO-TBD-012 e a existência (ou não) de um perfil Visitante. | ROAD-02 | PENDENTE |
| PRD TBD-021 | Gateway de pagamento do Pedido | Condiciona RF-047 e a visibilidade de dados de pagamento no RBAC. | Sem fase própria ainda — ver nota | PENDENTE |
| PRD TBD-022 | Provedor de API de consulta de CNPJ | Condiciona RF-046 (pré-preenchimento no cadastro de Organização). | ROAD-02 | PENDENTE |
Integrações Externas
Atualizado em v0.3 — duas integrações identificadas, nenhuma com provedor definido.
Gateway de pagamento (RF-047) — citados como referência InfinityPay/Stone, sem decisão. PRD TBD-021.
API de consulta de CNPJ (RF-046) — sem provedor definido. PRD TBD-022.
Nenhuma das duas é obrigatória para o funcionamento do núcleo MVP (ROAD-03 a ROAD-07) — ambas dependem de decisão explícita antes de virar dependência de fase.
Riscos para a Evolução
| Risco PRD | Tema Oficial | Impacto no Roadmap | Fases Afetadas | Tratamento Documental |
|---|---|---|---|---|
| RISK-001 | Privacidade e Proteção de Dados (PII) | Restringe a visibilidade de dados sensíveis entre atores. | TRANSVERSAL | RBAC/RLS v0.1 |
| RISK-002 | Isolamento de Dados (Multi-tenancy) | Crítico para garantir que uma organização não acesse dados de outra. | TRANSVERSAL | RNF-005, ROAD-P-004 |
| RISK-003 | Indisponibilidade de QR Code / Mesa | Afeta a entrada do cliente no fluxo de pedido. | ROAD-02, ROAD-03 | ERD-TBD-005 |
| RISK-004 | Concorrência de Pedidos na mesma Mesa | Pode gerar inconsistência no histórico de consumo da mesa. | ROAD-03 | RN-006 |
| RISK-005 | Lentidão na Atualização (Cozinha/Recepção) | Prejudica a eficiência operacional e a experiência do cliente. | ROAD-04, ROAD-05, ROAD-06 | RNF-007 |
| RISK-006 | Inconsistência de Estoque (Baixa Manual) | Gera divergência entre o estoque físico e o sistema. | ROAD-08 | PRD TBD-010 |
| RISK-007 | Uso de Insumos Vencidos | Risco sanitário e de qualidade do produto final. | ROAD-09 | RN-011 |
| RISK-008 | Divergência de CMV por Preço de Insumo | Afeta a precisão financeira da gestão. | ROAD-10, ROAD-11 | PRD TBD-012 |
| RISK-009 | Perda de Histórico Transacional | Afeta auditoria e análise de performance histórica. | ROAD-06, ROAD-07 | RNF-011 |
| RISK-010 | Escalabilidade da Arquitetura | Pode limitar o crescimento do volume de transações/organizações. | TRANSVERSAL | RNF-012 |