Files
RRBEC/doc/App Interno/Casos de Uso - Aplicativo Interno.md
2025-06-06 13:59:52 -03:00

7.9 KiB

Casos de Uso do Aplicativo GarçomApp

Este documento descreve os principais casos de uso do aplicativo GarçomApp, detalhando as interações entre os atores (garçons) e o sistema.

Atores

  • Garçom: Funcionário do bar que utiliza o aplicativo.

  • Cliente (BarApp): Usuário do aplicativo do cliente que interage com o garçom via QR Codes.

  • Sistema de Cozinha: Sistema responsável pelo gerenciamento de pedidos na cozinha.

  • Sistema de Pagamento: Serviço externo para processamento de pagamentos.

Casos de Uso

1. Autenticação

CUG001: Realizar Login

  • Nome: Realizar Login

  • Ator: Garçom

  • Descrição: Permite que o garçom acesse o aplicativo com suas credenciais.

  • Fluxo Principal:

    1. Garçom acessa a tela de login.

    2. Garçom insere usuário e senha.

    3. Sistema valida as credenciais.

    4. Sistema autentica o garçom e o redireciona para a tela principal.

2. Gerenciamento de Tickets e Ingressos

CUG002: Validar Ticket de Produto

  • Nome: Validar Ticket de Produto

  • Ator: Garçom, Cliente (BarApp)

  • Descrição: Permite que o garçom valide um ticket de produto apresentado pelo cliente.

  • Fluxo Principal:

    1. Garçom seleciona a opção "Validar Ticket".

    2. Sistema ativa a câmera para leitura de QR Code.

    3. Garçom escaneia o QR Code do ticket no BarApp do cliente.

    4. Sistema valida o ticket (existência, validade, não utilizado).

    5. Sistema exibe confirmação de validação e marca o ticket como utilizado.

CUG003: Validar Ingresso de Evento

  • Nome: Validar Ingresso de Evento

  • Ator: Garçom, Cliente (BarApp)

  • Descrição: Permite que o garçom valide um ingresso de evento apresentado pelo cliente.

  • Fluxo Principal:

    1. Garçom seleciona a opção "Validar Ingresso".

    2. Sistema ativa a câmera para leitura de QR Code.

    3. Garçom escaneia o QR Code do ingresso no BarApp do cliente.

    4. Sistema valida o ingresso (existência, validade, não utilizado).

    5. Sistema exibe confirmação de validação e marca o ingresso como utilizado.

3. Gerenciamento da Fila do Karaokê

CUG004: Visualizar Fila do Karaokê

  • Nome: Visualizar Fila do Karaokê

  • Ator: Garçom

  • Descrição: Permite que o garçom veja a ordem das pessoas para cantar.

  • Fluxo Principal:

    1. Garçom acessa a tela do Karaokê.

    2. Sistema exibe a lista de pessoas na fila em tempo real.

CUG005: Gerenciar Fila do Karaokê

  • Nome: Gerenciar Fila do Karaokê

  • Ator: Garçom

  • Descrição: Permite que o garçom adicione, edite ou remova pessoas da fila do karaokê.

  • Fluxo Principal - Adicionar:

    1. Garçom seleciona "Adicionar à Fila".

    2. Garçom insere nome da pessoa e, opcionalmente, música.

    3. Sistema adiciona a pessoa ao final da fila.

  • Fluxo Principal - Editar/Mover:

    1. Garçom seleciona uma pessoa na fila.

    2. Garçom arrasta para mudar a posição ou edita os detalhes.

    3. Sistema atualiza a fila.

  • Fluxo Principal - Remover:

    1. Garçom seleciona uma pessoa na fila.

    2. Garçom confirma a remoção.

    3. Sistema remove a pessoa da fila.

4. Gerenciamento de Comandas

CUG006: Visualizar Comandas

  • Nome: Visualizar Comandas

  • Ator: Garçom

  • Descrição: Permite que o garçom veja o status de todas as comandas.

  • Fluxo Principal:

    1. Garçom acessa a tela de Comandas.

    2. Sistema exibe listas separadas de "Comandas Abertas" e "Comandas Aguardando Pagamento".

CUG007: Abrir Nova Comanda

  • Nome: Abrir Nova Comanda

  • Ator: Garçom

  • Descrição: Permite que o garçom crie uma nova comanda para um cliente/mesa.

  • Fluxo Principal:

    1. Garçom seleciona "Abrir Nova Comanda".

    2. Garçom insere nome do cliente (opcional) e/ou número da mesa.

    3. Sistema cria e exibe a nova comanda.

CUG008: Adicionar Produto à Comanda

  • Nome: Adicionar Produto à Comanda

  • Ator: Garçom

  • Descrição: Permite que o garçom adicione itens do cardápio a uma comanda existente.

  • Fluxo Principal:

    1. Garçom seleciona uma comanda aberta.

    2. Garçom navega pelo cardápio e seleciona produtos e quantidades.

    3. Sistema adiciona os produtos à comanda e atualiza o total.

    4. Sistema envia o pedido para a cozinha (se aplicável).

CUG009: Editar Informações da Comanda

  • Nome: Editar Informações da Comanda

  • Ator: Garçom

  • Descrição: Permite que o garçom atualize o nome do cliente ou a mesa associada a uma comanda.

  • Fluxo Principal:

    1. Garçom seleciona uma comanda.

    2. Garçom edita o nome do cliente ou o número da mesa.

    3. Sistema atualiza as informações da comanda.

CUG010: Gerar QR Code para Pagamento da Comanda

  • Nome: Gerar QR Code para Pagamento da Comanda

  • Ator: Garçom, Cliente (BarApp), Sistema de Pagamento

  • Descrição: Permite que o garçom gere um QR Code para o cliente pagar a comanda via Pix.

  • Fluxo Principal:

    1. Garçom seleciona uma comanda.

    2. Garçom seleciona a opção "Gerar QR Code para Pagamento".

    3. Garçom pode escolher pagamento total ou parcial (informando o valor).

    4. Sistema gera um QR Code (e.g., Pix) e o exibe para o cliente.

    5. Cliente escaneia o QR Code e efetua o pagamento via BarApp.

    6. Sistema de Pagamento notifica o GarçomApp sobre o pagamento.

CUG011: Fechar Comanda

  • Nome: Fechar Comanda

  • Ator: Garçom

  • Descrição: Permite que o garçom marque uma comanda como paga e fechada.

  • Fluxo Principal:

    1. Garçom verifica que a comanda foi totalmente paga.

    2. Garçom seleciona a comanda e a opção "Fechar Comanda".

    3. Sistema marca a comanda como fechada e a remove da lista de comandas abertas.

5. Acompanhamento de Pedidos e Notificações

CUG012: Visualizar Andamento de Pedidos da Cozinha

  • Nome: Visualizar Andamento de Pedidos da Cozinha

  • Ator: Garçom, Sistema de Cozinha

  • Descrição: Permite que o garçom acompanhe o status dos pedidos enviados para a cozinha.

  • Fluxo Principal:

    1. Garçom acessa a tela de "Pedidos da Cozinha".

    2. Sistema exibe a lista de pedidos com seus status ("na fila", "preparando", "pronto").

CUG013: Receber Notificação de Pagamento de Comanda

  • Nome: Receber Notificação de Pagamento de Comanda

  • Ator: Garçom, Sistema de Pagamento

  • Descrição: O sistema notifica o garçom quando uma comanda sob sua responsabilidade é paga pelo cliente.

  • Fluxo Principal:

    1. Pagamento da comanda é efetuado pelo cliente via BarApp.

    2. Sistema de Pagamento envia notificação ao GarçomApp.

    3. GarçomApp exibe uma notificação (e.g., push notification, alerta no app) informando sobre o pagamento.

CUG014: Receber Notificação de Pedido Pronto

  • Nome: Receber Notificação de Pedido Pronto

  • Ator: Garçom, Sistema de Cozinha

  • Descrição: O sistema notifica o garçom quando um pedido da cozinha está pronto para ser entregue.

  • Fluxo Principal:

    1. Sistema de Cozinha marca um pedido como "pronto".

    2. Sistema de Cozinha envia notificação ao GarçomApp.

    3. GarçomApp exibe uma notificação informando que o pedido está pronto.