📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados na Matriz de 20 Capítulos de Aplicações Full Stack. Recomendado revisar antes de iniciar a execução.

🍣 PI 03 — ChefPoint (DoThi Sushi): Gestão Gastronômica & KDS

v1.0 — Projeto Integrador Full Stack para salão de restaurantes, comandas digitais por mesa, sistema de exibição de cozinha (KDS) em tempo real e controle de insumos.

Trilha de Especialização Pedagógica — Série Projetos Integradores (PI 3 de 6)

• PI 01: ParkManager (Gestão de Vagas, Tarifação e Caixa)
• PI 02: SafePass Corporate (Cofre de Senhas, Criptografia e LGPD)
• PI 03 (este): ChefPoint (Comandas Digitais, Mesas e KDS)
• PI 04: TechBorrow (Empréstimo de Dispositivos de TI)
• PI 05: StockFlow (Almoxarifado e Ponto de Pedido)
• PI 06: QuickDrop (Roteamento Expresso de Delivery)

🎓 Nível Profissional Simulado: Desenvolvedor Full Stack Sênior / Arquiteto de Software Gastronômico. A operação de restaurantes exige sincronismo veloz e sem atrito entre o garçom no salão e a cozinha (sushiman). Dominar layouts reativos, filas operacionais (KDS), divisão inteligente de conta e fechamento financeiro consolida competências essenciais de engenharia de produto.

🏛️ Galeria Arquitetural & Diagramas de Engenharia

Arquitetura de Comunicação e Camadas da Solução Gastronômica

Diagrama de Casos de Uso Formal (UML)

📁 Estrutura Canônica de Pastas Anti-Colisão

O projeto adota a convenção padronizada de subpastas por camada e tecnologia <camada>-<tecnologia>:

catalogo_projetos/fullstack_pi_03_chefpoint/
├── web-react/                  # SPA em React 18, Vite e TailwindCSS
│   ├── src/
│   │   ├── components/         # TableMap, DigitalOrder, KDSQueue, BillSplitter
│   │   ├── types/              # Definições TypeScript de ItemMenu, Pedido, Mesa
│   │   ├── utils/              # Cálculo de serviço, taxa de desperdício e divisão
│   │   ├── App.tsx             # Estado reativo unificado de mesas e cozinha
│   │   └── main.tsx            # Ponto de inicialização da SPA
│   ├── package.json            # Scripts de build, ícones e dependências
│   └── vite.config.ts          # Configuração do Vite
├── assets/                     # Galeria de diagramas vetoriais SVG autorais
├── README.md                   # Resumo do projeto integrador
└── Pedidos_DoThi_Sushi_Documentacao_Final.md # Especificação acadêmica e DDL de dados

🧑‍💼 Especificação Formal de Engenharia de Software

1. Histórias de Usuário (User Stories)

• US-CP01: Como garçom no salão, quero abrir a comanda de uma mesa e lançar itens rapidamente com observações especiais (sem glúten, sem wasabi).
• US-CP02: Como sushiman na cozinha, quero visualizar na tela KDS os pedidos organizados por ordem cronológica com sinalização visual de tempo decorrido.
• US-CP03: Como sushiman, quero alterar o status do prato de “Em Preparo” para “Pronto para Servir” com um toque na tela.
• US-CP04: Como cliente no encerramento da refeição, quero dividir o valor total da conta de forma igualitária ou por consumo individual de itens.
• US-CP05: Como gerente do restaurante, quero acompanhar o faturamento do turno e a contagem de pratos mais vendidos em tempo real.

2. Requisitos Funcionais (RF)

• RF-CP01: O mapa de mesas deve exibir os estados Livre (verde), Ocupada (amarelo) e Em Fechamento (vermelho).
• RF-CP02: O lançamento de itens deve agrupar por categorias (Entradas, Temakis, Combinados, Bebidas) com busca por código e nome.
• RF-CP03: O módulo KDS (Kitchen Display System) deve atualizar a lista de preparo sem necessidade de recarregamento manual da página.
• RF-CP04: O checkout de mesa deve calcular subtotal, taxa opcional de serviço de 10% e oferecer cálculo de divisão para até 20 pessoas.
• RF-CP05: O fechamento da conta deve liberar a mesa no mapa retornando seu status para Livre.

3. Requisitos Não-Funcionais (RNF)

• RNF-CP01 (Latência de Comanda): Um item lançado pelo garçom deve ser exibido no monitor KDS em menos de 200 milissegundos.
• RNF-CP02 (Resiliência): A aplicação deve reter os itens da comanda em armazenamento local persistente protegendo contra quedas pontuais de conexão.
• RNF-CP03 (Ergonomia Visual): A interface da cozinha KDS deve adotar esquema de alto contraste (Dark Theme) legível a 2 metros de distância.
• RNF-CP04 (Compatibilidade Touch): Todos os botões e seletores devem possuir dimensões mínimas de 48x48px para toque confortável em tablets de garçom.
• RNF-CP05 (Precisão Financeira): Os rateios de centavos na divisão de contas não devem gerar sobras ou déficits no somatório final.

📐 Diagrama de Casos de Uso (Mermaid)

flowchart LR
    subgraph Atores
        Garcom["👤 Garçom"]
        Sushiman["👨‍🍳 Sushiman (Cozinha)"]
        Gerente["💼 Gerente"]
    end

    subgraph "Sistema ChefPoint (DoThi Sushi)"
        UC01["UC01: Gerenciar Status de Mesas"]
        UC02["UC02: Lançar Pedidos na Comanda"]
        UC03["UC03: Operar Painel KDS de Cozinha"]
        UC04["UC04: Ratear e Liquidar Conta"]
        UC05["UC05: Monitorar Faturamento e Estoque"]
    end

    Garcom --> UC01
    Garcom --> UC02
    Sushiman --> UC03
    Garcom --> UC04
    Gerente --> UC05

📊 Matriz de Rastreabilidade de Requisitos (RTM)

🚀 Roteiro de Execução & Homologação no Laboratório

1. Inicialização do Frontend ChefPoint (web-react)

cd catalogo_projetos/fullstack_pi_03_chefpoint/web-react

# Instalação das dependências
npm install

# Inicialização do servidor Vite
npm run dev

• A interface estará disponível em: http://localhost:5173.

2. Leitura da Documentação Técnica

• Consulte o documento completo em: Pedidos_DoThi_Sushi_Documentacao_Final.html para esquemas relacionais de comandas e itens.

🧪 Matriz de Checkpoints de Homologação (CP-01 a CP-05)