README
Sistema Gastronômico para Operações com Mesas
Visão Geral
Este sistema organiza a jornada completa de atendimento em operações gastronômicas que utilizam o modelo de mesas. A jornada parte do acesso ao Cardápio por QR Code associado ao contexto da Mesa, integrando o Cardápio Digital, a gestão do Carrinho e a criação do Pedido sem fricção. No backend operacional, as interfaces de Recepção e Cozinha apoiam o acompanhamento operacional do Pedido e da produção, enquanto o Cliente acompanha o andamento do próprio Pedido pelo dispositivo.
Desde a revisão v0.2, o sistema é oferecido como SaaS multi-tenant: a mesma aplicação atende múltiplas Organizações (restaurantes) com isolamento de dados garantido no banco de dados, não apenas no código. Restaurante Exemplo é a primeira Organização cliente, não o único cliente possível do produto.
Documentação Oficial
| Documento | Versão | Status | Rota |
|---|---|---|---|
| PRD | v0.3 | APROVADO | /docs/prd |
| ERD | v0.3 | APROVADO | /docs/erd |
| RBAC/RLS | v0.3 | APROVADO | /docs/rbac-rls |
| Fluxos UX | v0.2 | APROVADO | /docs/fluxos-ux |
| Roadmap | v0.3 | APROVADO | /docs/roadmap |
| README | v0.1 | EM VALIDAÇÃO | /docs/readme |
Escopo do Produto
MVP (Baseline v0.1)
Evolução Prevista
Jornada Principal (MVP)
* Gestão atua em supervisão/administração quando aplicável e não é uma etapa obrigatória do caminho normal do Pedido.
Dados do Cliente
Cliente pode visualizar e navegar pelo Cardápio sem cadastro prévio.
Não existe cadastro completo obrigatório de Cliente.
Estados do Pedido
* Lifecycle definitivo permanece pendente no PRD TBD-005.
Atores e Acesso
Perfis Internos
RECEPÇÃO
Atendimento e acompanhamento operacional.
COZINHA
Operação de produção.
GESTÃO
Gestão operacional e módulos evolutivos.
Privacidade Operacional
“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.”
Governança conforme RBAC/RLS v0.3 aprovado.
Estoque e Validade
Estoque
Validade
Controle conceitual de Lotes, Validade e identificação de itens próximos do vencimento conforme PRD TBD-009.
Ficha Técnica e CMV
Ficha Técnica
Relação entre Produto, Insumos, Quantidades, Custos, Rendimento e Perdas.
CMV
“O sistema deve permitir cálculo ou visualização do CMV quando os dados necessários estiverem disponíveis.”
Modelo de Dados (Visão Resumida)
Núcleo / Acesso
- Organização
- Usuário Interno
Atendimento
- Mesa
- QR Code
- Cliente
Cardápio
- Categoria Produto
- Produto
Venda
- Pedido
- Item Pedido
Estoque
- Categoria Insumo
- Insumo
- Movimentação de Estoque
- Lote
Ficha Técnica
- Ficha Técnica
- Item da Ficha Técnica
* Conforme ERD v0.3 aprovado. Conceitos derivados não constituem novas entidades.
Tecnologia e Estado de Implementação
TECNOLOGIAS PRESENTES NO FRONT-END ATUAL
DECISÕES ARQUITETURAIS AINDA NÃO FORMALIZADAS
A presença de bibliotecas no front-end não define a stack definitiva de backend ou as decisões de infraestrutura. O README descreve o estado documental do produto e não comprova que todas as funcionalidades estejam implementadas ou em produção.
Decisões Ainda Abertas
“A referência a uma pendência no README não representa sua resolução. Quando uma decisão não estiver formalmente definida nas baselines aprovadas, ela deve permanecer pendente até nova decisão explícita.”
Riscos Documentados
* Visão resumida dos riscos oficiais conforme PRD v0.3.
Integrações
“Duas integrações identificadas em v0.3 — gateway de pagamento (PRD TBD-021) e API de CNPJ (PRD TBD-022) — nenhuma com provedor definido nem obrigatória para o núcleo MVP.”
O que a Baseline v0.3 Não Define
Governança Documental
PRD, ERD, RBAC/RLS e Roadmap v0.3, e Fluxos UX v0.2, são baselines aprovadas. Alterações futuras nessas baselines devem ser explicitamente solicitadas, auditáveis e rastreáveis.
“O README consolida e referencia as baselines, mas não substitui nem modifica seus conteúdos.”
Como os documentos se relacionam
Define os requisitos e o que o produto precisa fazer, incluindo o modelo de negócio SaaS, Mesa/QR Code e Pagamento.
Organiza conceitualmente os dados, entidades e relacionamentos necessários ao produto, incluindo o isolamento multi-tenant.
Organiza atores, perfis, permissões conceituais, limites de acesso e o isolamento por Organização.
Organiza as jornadas e interações dos atores.
Organiza as fases, dependências e evolução conceitual do produto.
Funciona como visão consolidada e orientação para consulta das baselines.
“Nenhum desses documentos substitui os demais.”
Evolução do Produto
“Os status acima representam o planejamento documental do Roadmap e NÃO comprovam implementação ou produção.”
Dependência Conceitual 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.”
Como utilizar esta documentação
“A existência de uma referência no README não substitui a consulta ao documento de origem.”
Rotas da Documentação
Integridade Documental — v0.1
“O README consolida o estado documental da baseline v0.1. Ele não comprova, por si só, que todas as funcionalidades documentadas estejam implementadas ou em produção.”