doc: first docs

doc/App Interno/App Interno - Visão Geral.md

@@ -0,0 +1,38 @@
+# GarçomApp - Visão Geral
+
+O **GarçomApp** é um aplicativo mobile de uso interno, exclusivo para a equipe de garçons do bar. Seu propósito é otimizar as operações diárias, agilizando o atendimento, o gerenciamento de pedidos e a interação com os clientes de forma eficiente.
+
+## Principais Funcionalidades:
+
+- **Validação de Tickets e Ingressos:** Leia e valide QR Codes de tickets de produtos e ingressos de eventos apresentados pelos clientes no BarApp.
+    
+- **Gestão da Fila do Karaokê:** Visualize, adicione, edite e remova pessoas da fila do karaokê em tempo real.
+    
+- **Gestão de Comandas:**
+    
+    - Visualize todas as comandas abertas e aguardando pagamento.
+        
+    - Abra novas comandas e associe-as a mesas ou clientes.
+        
+    - Adicione produtos às comandas.
+        
+    - Gere QR Codes para que os clientes paguem suas comandas (total ou parcial) via Pix no BarApp.
+        
+    - Feche comandas.
+        
+- **Acompanhamento de Pedidos:** Monitore o status dos pedidos enviados para a cozinha (na fila, preparando, pronto).
+    
+- **Notificações:** Receba alertas em tempo real sobre pagamentos de comandas efetuados pelos clientes e quando os pedidos da cozinha estiverem prontos.
+    
+
+## Documentos Relacionados:
+
+- [[Requisitos - Aplicativo Interno]]
+    
+- [[Casos de Uso - Aplicativo Interno]]
+    
+- [[Histórias de Usuário - Aplicativo Interno]]
+    
+- [[Modelagem de Banco de Dados]]
+    
+- [[Visão Geral do Projeto]]

doc/App Interno/Casos de Uso - Aplicativo Interno.md

@@ -0,0 +1,291 @@
+# 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.

doc/App Interno/Histórias de Usuário - Aplicativo Interno.md

@@ -0,0 +1,217 @@
+# Histórias de Usuário do Aplicativo GarçomApp
+
+Este documento apresenta as histórias de usuário para o aplicativo GarçomApp, focando na perspectiva do garçom e no valor que cada funcionalidade entrega para a operação do bar.
+
+## 1. Autenticação
+
+- **HUG001 - Login:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** fazer login no aplicativo,
+        
+    - **Para que** eu possa acessar minhas ferramentas de trabalho.
+        
+    - **Critérios de Aceitação:**
+        
+        - Garçom insere usuário e senha.
+            
+        - Sistema valida as credenciais.
+            
+        - Garçom é redirecionado para a tela principal do aplicativo.
+            
+
+## 2. Gerenciamento de Tickets e Ingressos
+
+- **HUG002 - Validação de Ticket:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** ler o QR Code de um ticket de produto do cliente,
+        
+    - **Para que** eu possa validar a compra e entregar o produto.
+        
+    - **Critérios de Aceitação:**
+        
+        - Câmera é ativada para leitura do QR Code.
+            
+        - Sistema valida o ticket (existência, validade, não utilizado).
+            
+        - Sistema exibe mensagem de sucesso ou erro na validação.
+            
+        - Ticket é marcado como utilizado no sistema.
+            
+- **HUG003 - Validação de Ingresso:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** ler o QR Code de um ingresso de evento do cliente,
+        
+    - **Para que** eu possa validar a entrada do cliente no evento.
+        
+    - **Critérios de Aceitação:**
+        
+        - Câmera é ativada para leitura do QR Code.
+            
+        - Sistema valida o ingresso (existência, validade, não utilizado).
+            
+        - Sistema exibe mensagem de sucesso ou erro na validação.
+            
+        - Ingresso é marcado como utilizado no sistema.
+            
+
+## 3. Gerenciamento da Fila do Karaokê
+
+- **HUG004 - Visualização da Fila do Karaokê:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** visualizar a fila de pessoas para o karaokê,
+        
+    - **Para que** eu possa gerenciar a ordem das apresentações.
+        
+    - **Critérios de Aceitação:**
+        
+        - Fila é exibida em tempo real.
+            
+        - Nomes das pessoas na fila são visíveis.
+            
+- **HUG005 - Gerenciamento da Fila do Karaokê:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** adicionar, editar e remover pessoas da fila do karaokê,
+        
+    - **Para que** eu possa manter a fila organizada e justa.
+        
+    - **Critérios de Aceitação:**
+        
+        - É possível adicionar um novo nome à fila.
+            
+        - É possível arrastar e soltar nomes para mudar a posição na fila.
+            
+        - É possível remover um nome da fila.
+            
+        - A fila é atualizada instantaneamente para todos os usuários.
+            
+
+## 4. Gerenciamento de Comandas
+
+- **HUG006 - Visualização de Comandas:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** visualizar todas as comandas abertas e as aguardando pagamento,
+        
+    - **Para que** eu tenha controle sobre o consumo das mesas e pagamentos pendentes.
+        
+    - **Critérios de Aceitação:**
+        
+        - Listas de comandas abertas e aguardando pagamento são exibidas.
+            
+        - Informações básicas da comanda (mesa, nome do cliente, valor total) são visíveis.
+            
+- **HUG007 - Abrir Nova Comanda:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** abrir uma nova comanda,
+        
+    - **Para que** eu possa registrar o consumo de um novo cliente/mesa.
+        
+    - **Critérios de Aceitação:**
+        
+        - É possível associar a comanda a uma mesa e/ou nome de cliente.
+            
+        - A nova comanda é criada e aparece na lista de comandas abertas.
+            
+- **HUG008 - Adicionar Produto à Comanda:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** adicionar produtos à comanda de um cliente,
+        
+    - **Para que** o consumo seja registrado e o pedido enviado para a cozinha/bar.
+        
+    - **Critérios de Aceitação:**
+        
+        - É possível selecionar produtos do cardápio e suas quantidades.
+            
+        - O valor da comanda é atualizado automaticamente.
+            
+        - Pedidos são enviados para a cozinha/bar.
+            
+- **HUG009 - Gerar QR Code para Pagamento da Comanda:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** gerar um QR Code para o cliente pagar a comanda via Pix,
+        
+    - **Para que** o cliente possa pagar de forma autônoma e rápida.
+        
+    - **Critérios de Aceitação:**
+        
+        - É possível selecionar a comanda e a opção de gerar QR Code.
+            
+        - É possível definir se o pagamento é total ou parcial.
+            
+        - Um QR Code Pix válido é exibido na tela.
+            
+- **HUG010 - Fechar Comanda:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** fechar uma comanda,
+        
+    - **Para que** eu possa indicar que o consumo foi pago e a mesa está liberada.
+        
+    - **Critérios de Aceitação:**
+        
+        - A comanda só pode ser fechada se o valor total estiver pago.
+            
+        - A comanda é removida da lista de comandas abertas.
+            
+
+## 5. Acompanhamento de Pedidos e Notificações
+
+- **HUG011 - Visualização do Andamento de Pedidos da Cozinha:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** ver o status dos pedidos que enviei para a cozinha,
+        
+    - **Para que** eu saiba quando posso buscar os produtos para entregar aos clientes.
+        
+    - **Critérios de Aceitação:**
+        
+        - Lista de pedidos exibe o status ("na fila", "preparando", "pronto").
+            
+        - Informações da comanda associada ao pedido são visíveis.
+            
+- **HUG012 - Receber Notificação de Pagamento de Comanda:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** ser notificado quando uma comanda sob minha responsabilidade for paga pelo cliente,
+        
+    - **Para que** eu possa agilizar o fechamento da mesa ou verificar o pagamento.
+        
+    - **Critérios de Aceitação:**
+        
+        - Uma notificação (e.g., push, sonora) é exibida no aplicativo.
+            
+        - A notificação indica qual comanda foi paga.
+            
+- **HUG013 - Receber Notificação de Pedido Pronto:**
+    
+    - **Como um** garçom,
+        
+    - **Eu quero** ser notificado quando um pedido da cozinha estiver pronto,
+        
+    - **Para que** eu possa buscá-lo e entregar ao cliente sem demora.
+        
+    - **Critérios de Aceitação:**
+        
+        - Uma notificação (e.g., push, sonora) é exibida no aplicativo.
+            
+        - A notificação indica qual pedido está pronto e a qual comanda pertence.

doc/App Interno/Requisitos - Aplicativo Interno.md

@@ -0,0 +1,178 @@
+# Documento de Requisitos do Aplicativo GarçomApp
+
+## 1. Introdução
+
+### 1.1. Propósito
+
+Este documento tem como objetivo detalhar os requisitos funcionais, não funcionais, regras de negócio e requisitos de sistema para o desenvolvimento do aplicativo mobile "GarçomApp". O aplicativo visa otimizar as operações internas do bar, permitindo que os garçons gerenciem tickets, ingressos, a fila do karaokê, comandas de consumo e acompanhem o status dos pedidos da cozinha.
+
+### 1.2. Escopo
+
+O aplicativo GarçomApp será uma solução mobile disponível para as plataformas Android e iOS (ou uma única plataforma, a ser definida), de uso exclusivo da equipe do bar (garçons). Ele permitirá a interação com os clientes através de QR Codes e a gestão de processos internos.
+
+### 1.3. Público-alvo
+
+- **Garçons/Atendentes:** Profissionais do bar que utilizarão o aplicativo para gerenciar as operações diárias.
+    
+
+## 2. Requisitos Funcionais (RF)
+
+Os requisitos funcionais descrevem as funcionalidades que o sistema deve oferecer aos garçons.
+
+### 2.1. Autenticação e Acesso
+
+- **RFG001 - Login de Garçom:** O sistema deve permitir que o garçom faça login utilizando suas credenciais de acesso (usuário e senha fornecidos pelo bar).
+    
+
+### 2.2. Gerenciamento de Tickets e Ingressos
+
+- **RFG002 - Leitura e Validação de Ticket:** O sistema deve permitir que o garçom leia o QR Code de um ticket gerado pelo cliente (no BarApp) e valide seu uso.
+    
+- **RFG003 - Leitura e Validação de Ingresso:** O sistema deve permitir que o garçom leia o QR Code de um ingresso gerado pelo cliente (no BarApp) e valide sua entrada no evento.
+    
+- **RFG004 - Registro de Uso:** Após a validação, o sistema deve registrar o ticket/ingresso como utilizado, com data e hora.
+    
+
+### 2.3. Gerenciamento da Fila do Karaokê
+
+- **RFG005 - Visualização da Fila do Karaokê:** O sistema deve exibir a fila atual de pessoas para o karaokê em tempo real.
+    
+- **RFG006 - Adicionar Pessoa à Fila:** O sistema deve permitir que o garçom adicione uma pessoa à fila do karaokê (e.g., nome, música).
+    
+- **RFG007 - Editar Posição na Fila:** O sistema deve permitir que o garçom altere a posição de uma pessoa na fila.
+    
+- **RFG008 - Remover Pessoa da Fila:** O sistema deve permitir que o garçom remova uma pessoa da fila.
+    
+- **RFG009 - Marcar Próximo a Cantar:** O sistema deve permitir que o garçom marque a próxima pessoa a cantar.
+    
+
+### 2.4. Gerenciamento de Comandas
+
+- **RFG010 - Visualização de Comandas Abertas:** O sistema deve exibir uma lista de todas as comandas abertas no bar.
+    
+- **RFG011 - Visualização de Comandas Aguardando Pagamento:** O sistema deve exibir uma lista de comandas que foram solicitadas para pagamento pelo cliente e estão aguardando confirmação.
+    
+- **RFG012 - Abrir Nova Comanda:** O sistema deve permitir que o garçom abra uma nova comanda, associando-a a um cliente (opcional) e/ou mesa.
+    
+- **RFG013 - Editar Informações da Comanda:** O sistema deve permitir que o garçom edite informações da comanda, como nome do cliente e número da mesa.
+    
+- **RFG014 - Adicionar Produto à Comanda:** O sistema deve permitir que o garçom adicione produtos do cardápio a uma comanda aberta.
+    
+- **RFG015 - Fechar Comanda:** O sistema deve permitir que o garçom marque uma comanda como fechada após o pagamento.
+    
+- **RFG016 - Gerar QR Code para Pagamento (Comanda):** O sistema deve permitir que o garçom gere um QR Code para que o cliente pague a comanda (total ou parcial) via Pix através do BarApp.
+    
+
+### 2.5. Acompanhamento de Pedidos da Cozinha
+
+- **RFG017 - Visualização do Andamento de Pedidos:** O sistema deve exibir o status dos pedidos enviados para a cozinha (e.g., "na fila", "preparando", "pronto").
+    
+- **RFG018 - Detalhes do Pedido:** O garçom deve poder visualizar os detalhes de cada pedido (itens, comanda associada).
+    
+
+### 2.6. Notificações
+
+- **RFG019 - Notificação de Pagamento de Comanda:** O sistema deve notificar o garçom quando o pagamento de uma comanda sob sua responsabilidade for efetuado pelo cliente via BarApp.
+    
+- **RFG020 - Notificação de Pedido Pronto:** O sistema deve notificar o garçom quando um prato/pedido da cozinha estiver pronto para ser entregue.
+    
+
+## 3. Requisitos Não Funcionais (RNF)
+
+Os requisitos não funcionais descrevem as qualidades do sistema.
+
+### 3.1. Usabilidade
+
+- **RNFG001 - Interface Otimizada para Garçons:** A interface deve ser projetada para uso rápido e eficiente em um ambiente de bar, com botões grandes e fluxo otimizado para as tarefas mais frequentes.
+    
+- **RNFG002 - Tempo de Resposta:** O tempo de resposta do aplicativo para todas as interações do garçom não deve exceder 2 segundos.
+    
+- **RNFG003 - Consistência Visual:** A interface deve seguir um padrão visual consistente.
+    
+- **RNFG004 - Feedback Visual e Sonoro:** O sistema deve fornecer feedback claro (visual e/ou sonoro) para ações importantes, como validação de QR Code ou recebimento de notificações.
+    
+
+### 3.2. Desempenho
+
+- **RNFG005 - Carregamento Rápido:** O aplicativo deve carregar em no máximo 3 segundos.
+    
+- **RNFG006 - Sincronização em Tempo Real:** As informações de fila do karaokê, status de pedidos da cozinha e comandas devem ser atualizadas em tempo real.
+    
+- **RNFG007 - Estabilidade:** O aplicativo deve ser estável e não apresentar travamentos ou falhas frequentes durante o uso contínuo.
+    
+
+### 3.3. Segurança
+
+- **RNFG008 - Autenticação de Garçons:** O sistema deve garantir que apenas garçons autorizados possam acessar o aplicativo.
+    
+- **RNFG009 - Controle de Acesso:** Diferentes níveis de permissão podem ser implementados para garçons, se necessário (e.g., apenas visualizar, ou também editar).
+    
+- **RNFG010 - Integridade dos Dados:** Os dados de tickets, ingressos e comandas devem ser protegidos contra manipulação indevida.
+    
+
+### 3.4. Confiabilidade
+
+- **RNFG011 - Disponibilidade:** O aplicativo deve estar disponível 99,9% do tempo durante o horário de funcionamento do bar.
+    
+- **RNFG012 - Tratamento de Erros:** O sistema deve lidar com erros de forma robusta, exibindo mensagens claras e permitindo a recuperação.
+    
+- **RNFG013 - Persistência de Dados:** Todas as informações de comandas, fila e status de pedidos devem ser armazenadas de forma persistente.
+    
+
+### 3.5. Manutenibilidade
+
+- **RNFG014 - Código Limpo:** O código-fonte deve ser bem documentado, modular e fácil de entender para futuras manutenções e evoluções.
+    
+- **RNFG015 - Atualizações:** O aplicativo deve permitir atualizações e novas funcionalidades de forma eficiente.
+    
+
+### 3.6. Compatibilidade
+
+- **RNFG016 - Compatibilidade Mobile:** O aplicativo deve ser compatível com as versões mais recentes dos sistemas operacionais Android e iOS (ou a plataforma escolhida).
+    
+- **RNFG017 - Responsividade:** A interface do aplicativo deve se adaptar a diferentes tamanhos de tela de dispositivos móveis.
+    
+
+## 4. Regras de Negócio (RN)
+
+As regras de negócio são as políticas e restrições que governam o funcionamento do bar e do aplicativo para garçons.
+
+### 4.1. Tickets e Ingressos
+
+- **RNG001 - Validação Única:** Cada QR Code de ticket ou ingresso só pode ser validado uma única vez.
+    
+- **RNG002 - Validação de Prazo:** O sistema deve verificar o prazo de validade do ticket/ingresso antes de permitir a validação.
+    
+
+### 4.2. Comandas
+
+- **RNG003 - Associação de Comanda:** Cada comanda deve estar associada a uma mesa ou cliente (se identificado).
+    
+- **RNG004 - Fechamento de Comanda:** Uma comanda só pode ser fechada após o pagamento total.
+    
+- **RNG005 - Pagamento Parcial:** O sistema deve permitir o registro de pagamentos parciais em uma comanda.
+    
+
+### 4.3. Karaokê
+
+- **RNG006 - Ordem da Fila:** A fila do karaokê deve seguir a ordem de adição, a menos que seja explicitamente alterada pelo garçom.
+    
+
+## 5. Requisitos de Sistema (RS)
+
+Os requisitos de sistema definem as necessidades de infraestrutura e tecnologia.
+
+### 5.1. Plataformas
+
+- **RSG001 - Desenvolvimento Mobile:** O aplicativo deve ser desenvolvido para dispositivos móveis (Android e/ou iOS).
+    
+
+### 5.2. Integrações
+
+- **RSG002 - Integração com BarApp (Cliente):** O GarçomApp deve ser capaz de ler QR Codes gerados pelo BarApp do cliente (tickets, ingressos, comandas).
+    
+- **RSG003 - Integração com Sistema de Cozinha:** O GarçomApp deve se comunicar com o sistema da cozinha para visualizar o status dos pedidos.
+    
+- **RSG004 - Integração com Sistema de Pagamento:** O GarçomApp deve interagir com o gateway de pagamento para gerar QR Codes de Pix para comandas.
+    
+- **RSG005 - Integração com Sistema de Gerenciamento do Bar:** O GarçomApp deve se integrar com o sistema de gerenciamento principal do bar para atualização de cardápio, registro de comandas e gerenciamento de usuários garçons.