RRBEC/doc/Banco de dados/Modelagem de Banco de Dados.md

# Modelagem de Banco de Dados para BarApp, GarçomApp e Gestão do Bar

Este documento apresenta a modelagem de banco de dados proposta para suportar as funcionalidades dos aplicativos BarApp (cliente), GarçomApp (interno) e o novo Aplicativo de Gestão do Bar, incluindo as entidades, seus atributos e os relacionamentos entre elas.

## 1. Visão Geral do Modelo

O modelo de dados é projetado para ser relacional, utilizando chaves primárias (PK) e chaves estrangeiras (FK) para estabelecer os relacionamentos. Os tipos de dados são genéricos e devem ser adaptados ao SGBD (Sistema Gerenciador de Banco de Dados) escolhido (e.g., PostgreSQL, MySQL, SQL Server).

## 2. Tabelas e Atributos

### 2.1. `Usuarios` (Clientes do BarApp)

Armazena as informações dos usuários que utilizam o aplicativo cliente.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_usuario`|UUID|PK (Chave Primária)|
|`nome_completo`|VARCHAR(255)|NOT NULL|
|`email`|VARCHAR(255)|NOT NULL, UNIQUE|
|`senha_hash`|VARCHAR(255)|NOT NULL (Armazenar hash da senha)|
|`id_google`|VARCHAR(255)|NULLABLE, UNIQUE (Para login social)|
|`data_cadastro`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`ultimo_login`|TIMESTAMP|NULLABLE|
|`limite_tickets_produto`|INTEGER|DEFAULT 10 (Regra de negócio: limite de tickets por produto)|

### 2.2. `Garcons` (Usuários do GarçomApp)

Armazena as informações dos funcionários do bar que utilizam o aplicativo interno.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_garcom`|UUID|PK|
|`nome_completo`|VARCHAR(255)|NOT NULL|
|`usuario`|VARCHAR(50)|NOT NULL, UNIQUE (Nome de usuário para login)|
|`senha_hash`|VARCHAR(255)|NOT NULL (Armazenar hash da senha)|
|`data_cadastro`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`ativo`|BOOLEAN|NOT NULL, DEFAULT TRUE|

### 2.3. `Produtos`

Armazena os itens do cardápio do bar.

| Atributo         | Tipo de Dado   | Restrições/Observações                                    |
| ---------------- | -------------- | --------------------------------------------------------- |
| `id_produto`     | UUID           | PK                                                        |
| `nome`           | VARCHAR(255)   | NOT NULL                                                  |
| `descricao`      | TEXT           | NULLABLE                                                  |
| `preco`          | DECIMAL(10, 2) | NOT NULL                                                  |
| `custo_unitario` | DECIMAL(10, 2) | NULLABLE (Para cálculo de lucratividade)                  |
| `estoque_atual`  | INTEGER        | NOT NULL, DEFAULT 0                                       |
| `estoque_minimo` | INTEGER        | DEFAULT 0 (Para alertas de estoque baixo)                 |
| `url_imagem`     | VARCHAR(255)   | NULLABLE                                                  |
| `disponivel`     | BOOLEAN        | NOT NULL, DEFAULT TRUE (Indica se está no cardápio ativo) |
| `id_categoria`   | UUID           | FK para `CategoriasProduto`                               |

### 2.4. `CategoriasProduto`

Armazena as categorias dos produtos do cardápio.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_categoria`|UUID|PK|
|`nome_categoria`|VARCHAR(100)|NOT NULL, UNIQUE|

### 2.5. `Tickets`

Armazena os tickets comprados pelos clientes.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_ticket`|UUID|PK|
|`id_usuario`|UUID|FK para `Usuarios` (Usuário que comprou o ticket)|
|`id_produto`|UUID|FK para `Produtos`|
|`data_compra`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`data_validade`|TIMESTAMP|NULLABLE (Prazo de validade do ticket)|
|`status`|ENUM|NOT NULL ('comprado', 'utilizado', 'transferido')|
|`data_uso`|TIMESTAMP|NULLABLE (Data e hora em que o ticket foi utilizado)|
|`id_comanda_origem`|UUID|NULLABLE, FK para `Comandas` (Se o ticket foi gerado de uma comanda paga)|

### 2.6. `HistoricoTickets`

Registra o histórico de eventos de cada ticket (compra, uso, transferência).

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_historico`|UUID|PK|
|`id_ticket`|UUID|FK para `Tickets`|
|`tipo_evento`|ENUM|NOT NULL ('compra', 'uso', 'transferencia_enviada', 'transferencia_recebida')|
|`data_evento`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`id_usuario_origem`|UUID|NULLABLE, FK para `Usuarios` (Usuário que enviou/usou)|
|`id_usuario_destino`|UUID|NULLABLE, FK para `Usuarios` (Usuário que recebeu)|
|`observacoes`|TEXT|NULLABLE|

### 2.7. `CestasCompras`

Representa a cesta de compras temporária de um usuário.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_cesta`|UUID|PK|
|`id_usuario`|UUID|FK para `Usuarios`|
|`data_criacao`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`status`|ENUM|NOT NULL ('ativa', 'finalizada', 'cancelada')|

### 2.8. `ItensCesta`

Armazena os produtos dentro de uma cesta de compras.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_item_cesta`|UUID|PK|
|`id_cesta`|UUID|FK para `CestasCompras`|
|`id_produto`|UUID|FK para `Produtos`|
|`quantidade`|INTEGER|NOT NULL, > 0|
|`preco_unitario`|DECIMAL(10, 2)|NOT NULL|

### 2.9. `MetodosPagamento`

Tabela de lookup para os métodos de pagamento aceitos.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_metodo`|INTEGER|PK|
|`nome_metodo`|VARCHAR(50)|NOT NULL, UNIQUE ('Pix', 'Credito', 'Debito')|

### 2.10. `CartoesCadastrados`

Armazena os tokens de cartões de crédito/débito para pagamentos futuros. **Importante: Nunca armazenar dados sensíveis do cartão diretamente.**

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_cartao`|UUID|PK|
|`id_usuario`|UUID|FK para `Usuarios`|
|`ultimos_digitos`|VARCHAR(4)|NULLABLE (Para exibição ao usuário)|
|`bandeira`|VARCHAR(50)|NULLABLE|
|`token_pagamento`|VARCHAR(255)|NOT NULL (Token gerado pelo gateway de pagamento)|
|`data_cadastro`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`ativo`|BOOLEAN|NOT NULL, DEFAULT TRUE|

### 2.11. `Eventos`

Armazena as informações dos eventos do bar.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_evento`|UUID|PK|
|`nome_evento`|VARCHAR(255)|NOT NULL|
|`data_evento`|TIMESTAMP|NOT NULL|
|`descricao`|TEXT|NULLABLE|
|`preco_ingresso`|DECIMAL(10, 2)|NOT NULL|
|`url_imagem`|VARCHAR(255)|NULLABLE|
|`ativo`|BOOLEAN|NOT NULL, DEFAULT TRUE|

### 2.12. `Ingressos`

Armazena os ingressos comprados pelos clientes para eventos.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_ingresso`|UUID|PK|
|`id_usuario`|UUID|FK para `Usuarios`|
|`id_evento`|UUID|FK para `Eventos`|
|`nome_ingresso`|VARCHAR(255)|NULLABLE (Ex: "Ingresso Pista", "Ingresso VIP")|
|`data_compra`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`data_uso`|TIMESTAMP|NULLABLE (Data e hora em que o ingresso foi validado)|
|`status`|ENUM|NOT NULL ('comprado', 'utilizado')|

### 2.13. `FilaKaraoke`

Gerencia a fila de pessoas para o karaokê.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_fila_karaoke`|UUID|PK|
|`nome_cantor`|VARCHAR(255)|NOT NULL|
|`nome_musica`|VARCHAR(255)|NULLABLE|
|`posicao`|INTEGER|NOT NULL, UNIQUE (Ordem na fila)|
|`data_entrada`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`status`|ENUM|NOT NULL ('na_fila', 'cantando', 'cantou')|

### 2.14. `Comandas`

Armazena as comandas de consumo dos clientes.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_comanda`|UUID|PK|
|`id_garcom`|UUID|FK para `Garcons` (Garçom que abriu a comanda)|
|`id_usuario_cliente`|UUID|NULLABLE, FK para `Usuarios` (Se o cliente for identificado no app)|
|`numero_mesa`|VARCHAR(50)|NULLABLE|
|`nome_cliente`|VARCHAR(255)|NULLABLE (Nome do cliente, se não for usuário do app)|
|`data_abertura`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`data_fechamento`|TIMESTAMP|NULLABLE|
|`status`|ENUM|NOT NULL ('aberta', 'aguardando_pagamento', 'paga', 'fechada')|
|`valor_total`|DECIMAL(10, 2)|NOT NULL, DEFAULT 0.00|

### 2.15. `ItensComanda`

Armazena os produtos adicionados a cada comanda.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_item_comanda`|UUID|PK|
|`id_comanda`|UUID|FK para `Comandas`|
|`id_produto`|UUID|FK para `Produtos`|
|`quantidade`|INTEGER|NOT NULL, > 0|
|`preco_unitario`|DECIMAL(10, 2)|NOT NULL|
|`status_cozinha`|ENUM|NOT NULL ('na_fila', 'preparando', 'pronto', 'entregue')|
|`observacoes`|TEXT|NULLABLE|

### 2.16. `PagamentosComanda`

Registra os pagamentos efetuados para as comandas (total ou parcial).

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_pagamento_comanda`|UUID|PK|
|`id_comanda`|UUID|FK para `Comandas`|
|`id_usuario`|UUID|NULLABLE, FK para `Usuarios` (Se pago via BarApp)|
|`valor_pago`|DECIMAL(10, 2)|NOT NULL|
|`id_metodo_pagamento`|INTEGER|FK para `MetodosPagamento`|
|`data_pagamento`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`tipo_pagamento`|ENUM|NOT NULL ('total', 'parcial')|
|`id_transacao_gateway`|VARCHAR(255)|NULLABLE (ID da transação no gateway de pagamento)|

### 2.17. `Notificacoes`

Armazena as notificações para usuários (clientes ou garçons).

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_notificacao`|UUID|PK|
|`id_usuario_destino`|UUID|NOT NULL (FK para `Usuarios` ou `Garcons` ou `Funcionarios`)|
|`tipo_usuario_destino`|ENUM|NOT NULL ('cliente', 'garcom', 'gestao')|
|`tipo_notificacao`|ENUM|NOT NULL ('pagamento_comanda', 'pedido_pronto', 'transferencia_ticket_recebida', 'estoque_baixo', 'novo_cadastro_cliente', 'novo_evento_criado')|
|`mensagem`|TEXT|NOT NULL|
|`data_envio`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`lida`|BOOLEAN|NOT NULL, DEFAULT FALSE|
|`referencia_id`|UUID|NULLABLE (ID do ticket, comanda, etc. relacionado)|

### 2.18. `Funcionarios` (Usuários do Aplicativo de Gestão)

Armazena informações de todos os funcionários, incluindo aqueles que usam o GarçomApp e os administrativos.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_funcionario`|UUID|PK|
|`nome_completo`|VARCHAR(255)|NOT NULL|
|`cpf`|VARCHAR(14)|NOT NULL, UNIQUE|
|`data_contratacao`|DATE|NOT NULL|
|`salario_base`|DECIMAL(10, 2)|NOT NULL|
|`cargo`|VARCHAR(100)|NOT NULL|
|`dados_bancarios`|TEXT|NULLABLE (Informações para pagamento, criptografadas)|
|`usuario_sistema`|VARCHAR(50)|NULLABLE, UNIQUE (Para login no app de gestão)|
|`senha_hash_sistema`|VARCHAR(255)|NULLABLE (Hash da senha para login no app de gestão)|
|`ativo`|BOOLEAN|NOT NULL, DEFAULT TRUE|
|`id_garcom_associado`|UUID|NULLABLE, FK para `Garcons` (Se for também um garçom)|

### 2.19. `PagamentosSalario`

Registra os pagamentos de salário efetuados aos funcionários.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_pagamento`|UUID|PK|
|`id_funcionario`|UUID|FK para `Funcionarios`|
|`valor_bruto`|DECIMAL(10, 2)|NOT NULL|
|`descontos`|DECIMAL(10, 2)|NOT NULL, DEFAULT 0.00|
|`valor_liquido`|DECIMAL(10, 2)|NOT NULL|
|`data_pagamento`|DATE|NOT NULL|
|`periodo_referencia`|VARCHAR(20)|NOT NULL (Ex: "2025-05")|
|`holerite_url`|VARCHAR(255)|NULLABLE (URL para PDF do holerite, se gerado)|

### 2.20. `Fornecedores`

Armazena informações dos fornecedores de mercadorias.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_fornecedor`|UUID|PK|
|`nome_fantasia`|VARCHAR(255)|NOT NULL|
|`razao_social`|VARCHAR(255)|NULLABLE|
|`cnpj`|VARCHAR(18)|NULLABLE, UNIQUE|
|`contato`|VARCHAR(255)|NULLABLE (Telefone, E-mail)|
|`endereco`|TEXT|NULLABLE|

### 2.21. `EntradasMercadoria`

Registra as entradas de mercadorias no estoque.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_entrada`|UUID|PK|
|`id_fornecedor`|UUID|FK para `Fornecedores`|
|`data_entrada`|TIMESTAMP|NOT NULL, DEFAULT CURRENT_TIMESTAMP|
|`numero_nota_fiscal`|VARCHAR(100)|NULLABLE|
|`valor_total`|DECIMAL(10, 2)|NOT NULL|
|`observacoes`|TEXT|NULLABLE|
|`id_funcionario_responsavel`|UUID|FK para `Funcionarios` (Quem registrou a entrada)|

### 2.22. `ItensEntradaMercadoria`

Detalha os itens de cada entrada de mercadoria.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_item_entrada`|UUID|PK|
|`id_entrada`|UUID|FK para `EntradasMercadoria`|
|`id_produto`|UUID|FK para `Produtos`|
|`quantidade`|INTEGER|NOT NULL, > 0|
|`custo_unitario_compra`|DECIMAL(10, 2)|NOT NULL (Custo na data da compra)|

### 2.23. `Permissoes`

Define os tipos de permissão para os usuários do aplicativo de gestão.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_permissao`|UUID|PK|
|`nome_permissao`|VARCHAR(100)|NOT NULL, UNIQUE (Ex: 'gerenciar_produtos', 'ver_dashboard_vendas')|
|`descricao`|TEXT|NULLABLE|

### 2.24. `FuncionarioPermissoes`

Tabela de ligação para atribuir permissões a funcionários.

|Atributo|Tipo de Dado|Restrições/Observações|
|---|---|---|
|`id_funcionario_permissao`|UUID|PK|
|`id_funcionario`|UUID|FK para `Funcionarios`|
|`id_permissao`|UUID|FK para `Permissoes`|

## 3. Relacionamentos

Abaixo estão os principais relacionamentos entre as tabelas, incluindo as novas adições:

- **`Usuarios`**
    
    - `Usuarios.id_usuario` 1:N `Tickets.id_usuario`
        
    - `Usuarios.id_usuario` 1:N `CartoesCadastrados.id_usuario`
        
    - `Usuarios.id_usuario` 1:N `Ingressos.id_usuario`
        
    - `Usuarios.id_usuario` 1:N `HistoricoTickets.id_usuario_origem`
        
    - `Usuarios.id_usuario` 1:N `HistoricoTickets.id_usuario_destino`
        
    - `Usuarios.id_usuario` 1:N `CestasCompras.id_usuario`
        
    - `Usuarios.id_usuario` 1:N `Comandas.id_usuario_cliente` (Opcional)
        
    - `Usuarios.id_usuario` 1:N `PagamentosComanda.id_usuario` (Opcional)
        
    - `Usuarios.id_usuario` 1:N `Notificacoes.id_usuario_destino` (quando `tipo_usuario_destino` é 'cliente')
        
- **`Garcons`**
    
    - `Garcons.id_garcom` 1:N `Comandas.id_garcom`
        
    - `Garcons.id_garcom` 1:N `Notificacoes.id_usuario_destino` (quando `tipo_usuario_destino` é 'garcom')
        
    - `Garcons.id_garcom` 1:1 `Funcionarios.id_garcom_associado` (Opcional, se um garçom também for um funcionário de gestão)
        
- **`Produtos`**
    
    - `Produtos.id_produto` 1:N `Tickets.id_produto`
        
    - `Produtos.id_produto` 1:N `ItensCesta.id_produto`
        
    - `Produtos.id_produto` 1:N `ItensComanda.id_produto`
        
    - `Produtos.id_produto` 1:N `ItensEntradaMercadoria.id_produto`
        
    - `Produtos.id_categoria` N:1 `CategoriasProduto.id_categoria`
        
- **`Tickets`**
    
    - `Tickets.id_ticket` 1:N `HistoricoTickets.id_ticket`
        
- **`CestasCompras`**
    
    - `CestasCompras.id_cesta` 1:N `ItensCesta.id_cesta`
        
- **`Eventos`**
    
    - `Eventos.id_evento` 1:N `Ingressos.id_evento`
        
- **`Comandas`**
    
    - `Comandas.id_comanda` 1:N `ItensComanda.id_comanda`
        
    - `Comandas.id_comanda` 1:N `PagamentosComanda.id_comanda`
        
    - `Comandas.id_comanda` 1:N `Tickets.id_comanda_origem` (Opcional)
        
- **`MetodosPagamento`**
    
    - `MetodosPagamento.id_metodo` 1:N `PagamentosComanda.id_metodo_pagamento`
        
- **`Funcionarios`**
    
    - `Funcionarios.id_funcionario` 1:N `PagamentosSalario.id_funcionario`
        
    - `Funcionarios.id_funcionario` 1:N `EntradasMercadoria.id_funcionario_responsavel`
        
    - `Funcionarios.id_funcionario` 1:N `FuncionarioPermissoes.id_funcionario`
        
    - `Funcionarios.id_funcionario` 1:N `Notificacoes.id_usuario_destino` (quando `tipo_usuario_destino` é 'gestao')
        
- **`Fornecedores`**
    
    - `Fornecedores.id_fornecedor` 1:N `EntradasMercadoria.id_fornecedor`
        
- **`EntradasMercadoria`**
    
    - `EntradasMercadoria.id_entrada` 1:N `ItensEntradaMercadoria.id_entrada`
        
- **`Permissoes`**
    
    - `Permissoes.id_permissao` 1:N `FuncionarioPermissoes.id_permissao`
        

Esta modelagem expandida fornece uma base robusta para o desenvolvimento de todos os três aplicativos, garantindo a integridade, a organização e a escalabilidade dos dados para as operações do bar.