# Manual de Utilizador — Dashboard Lokk
### Guia Completo para Administradores

---

## Índice

1. [Introdução à Plataforma](#1-introdução-à-plataforma)
2. [Acesso e Autenticação](#2-acesso-e-autenticação)
3. [Estrutura da Plataforma — Spots, Places e Locations](#3-estrutura-da-plataforma--spots-places-e-locations)
4. [Cacifos (Lockers)](#4-cacifos-lockers)
5. [Entregas (Deliveries)](#5-entregas-deliveries)
6. [Vending (Venda de Produtos em Cacifos)](#6-vending-venda-de-produtos-em-cacifos)
7. [Office (Aluguer Gratuito em Escritório)](#7-office-aluguer-gratuito-em-escritório)
8. [Transações e Pagamentos](#8-transações-e-pagamentos)
9. [Utilizadores](#9-utilizadores)
10. [Administradores](#10-administradores)
11. [Vouchers e Promoções](#11-vouchers-e-promoções)
12. [Pacotes e Tipos de Aluguer (Packs & Rental Types)](#12-pacotes-e-tipos-de-aluguer-packs--rental-types)
13. [Analytics e Relatórios](#13-analytics-e-relatórios)
14. [Configurações do Sistema](#14-configurações-do-sistema)
15. [Gestão de Conteúdo](#15-gestão-de-conteúdo)
16. [Auditoria e Logs](#16-auditoria-e-logs)
17. [Integrações Externas](#17-integrações-externas)
18. [Resolução de Problemas Comuns](#18-resolução-de-problemas-comuns)

---

## 1. Introdução à Plataforma

A **Lokk** é uma plataforma de gestão de cacifos inteligentes (*smart lockers*). Através do dashboard de administração tens controlo total sobre todas as operações: desde a gestão física dos cacifos até ao acompanhamento de entregas, pagamentos e utilizadores.

### O que podes gerir no dashboard

- **Cacifos físicos** — abrir, fechar, monitorizar estado da porta, atribuir a entregas ou a utilizadores
- **Entregas** — acompanhar o ciclo de vida completo de uma encomenda, desde a criação até ao levantamento
- **Vending** — gerir produtos armazenados em cacifos, acompanhar vendas e reabastecimentos
- **Office** — cacifos de aluguer gratuito para uso em escritórios, sem cobrança ao utilizador final
- **Pagamentos e transações** — consultar, corrigir e emitir faturas
- **Utilizadores** — criar e gerir clientes e os seus PINs
- **Administradores** — convidar e gerir outros utilizadores do dashboard
- **Configurações** — personalizar comportamentos do sistema por localização
- **Analytics** — consultar métricas de ocupação, entregas e receitas

---

## 2. Acesso e Autenticação

### 2.1 Primeiro Acesso — Ativação de Conta

Quando um administrador te convida para a plataforma, recebes um email com um link de ativação. Nesse link deves preencher:

- **Nome completo**
- **Nome de utilizador** (usado para login)
- **PIN numérico** (usado em algumas operações internas)
- **Número de telemóvel** (necessário para o código de verificação por SMS)
- **Palavra-passe**
- **País**

Após submeter, a conta fica ativa e podes fazer login.

### 2.2 Login com Verificação em Dois Passos (2FA)

O login na plataforma usa **verificação em dois passos** para maior segurança:

1. Introduz o teu **email** e **palavra-passe**
2. Recebes um **código por SMS** no número de telemóvel associado à conta
3. Introduzes o código recebido para concluir o acesso

> O código tem um tempo de expiração limitado. Se não o receberes, podes solicitar o reenvio.

### 2.3 Recuperação de Palavra-passe

Se esqueceste a tua palavra-passe:

1. Na página de login, clica em **"Recuperar palavra-passe"**
2. Introduz o teu email
3. Recebes um email com um link de redefinição
4. Segue o link e define uma nova palavra-passe

### 2.4 Alterar Palavra-passe ou PIN

Após o login, podes alterar a tua palavra-passe e o teu PIN nas definições do perfil. Para alterar a palavra-passe precisas sempre de confirmar a palavra-passe atual.

---

## 3. Estrutura da Plataforma — Spots, Places e Locations

A plataforma organiza os cacifos numa hierarquia de três níveis. Perceber esta estrutura é essencial para navegar corretamente no dashboard.

```
Spot (Localidade)
 └── Place (Ponto/Área)
      └── Location (Localização específica)
           └── Locker (Cacifo individual)
```

### 3.1 Spots

Um **Spot** representa uma localidade ou instalação, por exemplo: *"Hotel X"*, *"Centro Comercial Y"*, *"Condomínio Z"*.

**O que podes fazer com Spots:**

- **Criar** um novo spot com nome, país, e coordenadas GPS (latitude/longitude)
- **Editar** as informações de um spot existente
- **Ativar/Desativar** um spot (quando desativado, os cacifos associados ficam inacessíveis)
- **Definir a mensagem SMS** padrão que é enviada aos destinatários de entregas nesse spot
- **Eliminar** um spot — esta ação é irreversível e remove todos os dados associados em cascata

**Informações de um Spot:**
- Nome
- País
- Coordenadas geográficas (para localização no mapa)
- URL associado (ex: website do cliente)
- Tipos de utilização configurados (entrega, aluguer, vending, etc.)

> Cada spot pode ter configurações próprias que substituem as configurações globais do sistema — ver secção [Configurações](#12-configurações-do-sistema).

### 3.2 Places

Um **Place** representa uma zona ou ponto específico dentro de um spot. Por exemplo, dentro de um hotel pode haver *"Receção"*, *"Piso 2"*, *"Parque de Estacionamento"*.

**O que podes fazer com Places:**

- Criar, editar e eliminar places dentro de um spot
- Atribuir administradores específicos à gestão de um place

### 3.3 Locations

Uma **Location** representa a localização exata de um conjunto de cacifos dentro de um place. Cada location contém os cacifos físicos e tem tamanhos de cacifo associados.

**O que podes fazer com Locations:**

- Criar, editar e eliminar locations
- Associar ecrãs (*screens*) a uma location
- Configurar pacotes de preço por location
- Configurar vouchers específicos para a location

---

## 4. Cacifos (Lockers)

Os cacifos são o elemento central da plataforma. Cada cacifo está ligado fisicamente ao hardware e comunica com o sistema em tempo real.

### 4.1 Estados de um Cacifo

Cada cacifo pode estar num dos seguintes estados operacionais:

| Estado | Descrição |
|--------|-----------|
| **Livre** | Disponível para nova atribuição |
| **Reservado** | Pré-atribuído, aguarda confirmação |
| **Alugado** | Em uso por um utilizador |
| **Reservado para Entrega** | Atribuído a uma entrega, aguarda armazenamento |
| **Alugado para Entrega** | Entrega armazenada no interior |
| **Reservado para Ativo** | Atribuído para gestão de ativos |
| **Alugado para Ativo** | Ativo guardado no interior |
| **Reservado para Produto** | Atribuído a produto/vending |
| **Alugado para Produto** | Produto disponível no interior |
| **Reservado para Item** | Atribuído a item específico |
| **Alugado para Item** | Item guardado no interior |
| **Pendente** | Em processamento |
| **Tempo de Segurança** | Período de espera após libertação antes de ficar disponível |

Para além do estado operacional, o cacifo tem também um **estado do administrador**:
- **Ativo** — funcionamento normal
- **Inativo/Desativado** — fora de serviço
- **Necessita Limpeza** — marcado para intervenção de limpeza

E um **estado da porta** (hardware):
- **Fechada** — porta fisicamente fechada
- **Aberta** — porta fisicamente aberta
- **Alerta** — anomalia detetada

### 4.2 Tipos de Cacifo

Os cacifos podem ser configurados para diferentes finalidades:

| Tipo | Descrição |
|------|-----------|
| **Livre** | Uso geral, sem restrição de tipo |
| **Entrega** | Dedicado ao sistema de entregas |
| **Aluguer** | Para aluguer por utilizadores registados |
| **Vending** | Para distribuição de produtos |

### 4.3 Consultar e Monitorizar Cacifos

Na lista de cacifos podes:

- **Filtrar** por localização, estado, tipo e outras características
- **Ver detalhes** de cada cacifo: estado atual, histórico de ações, transação ativa, utilizador atribuído
- **Sincronizar estado** com o hardware — atualiza o estado real da porta (aberta/fechada) e sincroniza com o sistema
- **Ver cacifos com aluguer expirado** — lista dedicada de cacifos cuja transação passou do prazo
- **Ver cacifos com porta aberta** — lista de cacifos onde a porta ficou aberta sem ser fechada

### 4.4 Abrir um Cacifo Manualmente

Como administrador, podes abrir qualquer cacifo diretamente do dashboard:

1. Acede aos detalhes do cacifo
2. Clica em **"Abrir cacifo"**
3. O sistema envia o comando ao hardware e o cacifo abre

Podes também abrir **múltiplos cacifos** simultaneamente selecionando vários IDs.

Existem também modos específicos de abertura:
- **Abertura para entrega** — abre especificamente para o funcionário armazenar uma encomenda
- **Abertura para item** — abre para operações com itens/produtos

### 4.5 Fazer Checkout de um Cacifo

O **checkout** finaliza a utilização de um cacifo e processa o pagamento pendente:

1. Acede ao cacifo com uma transação ativa
2. Clica em **"Checkout"**
3. O sistema captura o valor em dívida através do gateway de pagamento configurado
4. O cacifo transita para o estado **"Tempo de Segurança"** e depois para **"Livre"**

### 4.6 Ativar/Desativar Cacifos

Podes ativar ou desativar um ou múltiplos cacifos de uma só vez. Um cacifo desativado não aparece disponível para novas utilizações.

### 4.7 Marcar para Limpeza

Se um cacifo necessita de intervenção, podes **marcá-lo para limpeza**. O cacifo fica assinalado com um estado visual específico no dashboard, facilitando a coordenação das equipas de manutenção.

### 4.8 Atributo de Acessibilidade

Cada cacifo pode ser marcado como **acessível** (PMC — Pessoa com Mobilidade Condicionada). Esta informação é tida em conta na atribuição automática de cacifos a utilizadores com necessidades especiais.

### 4.9 Atualização em Lote

É possível atualizar múltiplos cacifos ao mesmo tempo numa localização específica: adicionar novos cacifos, editar existentes, ou remover cacifos de forma massiva.

---

## 5. Entregas (Deliveries)

O módulo de entregas gere o ciclo de vida completo de uma encomenda, desde que o estafeta chega ao ponto de entrega até ao levantamento pelo destinatário.

### 5.1 Ciclo de Vida de uma Entrega

```
Criada → Cacifo Atribuído → Cacifo Aberto para Armazenamento
       → Armazenada → SMS Enviado ao Destinatário
       → Cacifo Aberto para Levantamento → Levantada
       → Arquivada
```

Detalhando cada estado:

| Estado | O que significa |
|--------|-----------------|
| **Criada** | A entrega foi registada no sistema |
| **Cacifo Atribuído** | Um cacifo foi reservado para esta entrega |
| **Cacifo Aberto para Armazenamento** | O estafeta abriu o cacifo para colocar a encomenda |
| **Armazenada** | A encomenda está no cacifo, porta fechada |
| **SMS Enviado** | O destinatário foi notificado por SMS |
| **SMS Reenviado** | A notificação foi enviada novamente |
| **SMS Entregue** | Confirmação de entrega do SMS |
| **Cacifo Aberto para Levantamento (PIN)** | O destinatário usou o PIN para abrir o cacifo |
| **Cacifo Aberto para Levantamento (QR)** | O destinatário usou o QR Code para abrir o cacifo |
| **Cacifo Aberto por Staff** | Um funcionário abriu para entregar ao destinatário |
| **Levantada** | A encomenda foi retirada com sucesso |
| **Cancelada** | A entrega foi cancelada |
| **Arquivada** | Registo histórico — entrega concluída e arquivada |
| **Libertada** | O cacifo foi libertado sem conclusão do processo |

### 5.2 Criar uma Entrega Manualmente

Para criar uma entrega:

1. Clica em **"Nova Entrega"**
2. Preenche os dados obrigatórios:
   - **Referência** — número de encomenda ou referência interna
   - **Nome do destinatário**
   - **Email do destinatário**
   - **Telefone do destinatário** (com indicativo de país)
   - **Tipo de entrega** (ex: 2 horas, 24 horas, etc.)
   - **Spot** — localização onde a entrega será depositada
3. Opcionalmente podes adicionar:
   - **Número de rastreamento** do transportador
   - **Transportadora**
   - **Observações**
   - **Dimensões** da encomenda
4. Após guardar, a entrega fica no estado **"Criada"**

### 5.3 Importar Entregas em Lote (CSV)

Se precisas de registar muitas entregas de uma vez, usa a funcionalidade de importação:

1. Prepara um ficheiro CSV com os dados das entregas
2. Usa a opção **"Importar"** no dashboard
3. O sistema processa o ficheiro e cria todas as entregas automaticamente

### 5.4 Atribuir um Cacifo a uma Entrega

Após a criação, é necessário atribuir um cacifo:

- O sistema pode **atribuir automaticamente** um cacifo disponível e compatível com as dimensões da encomenda
- Também podes **atribuir manualmente** escolhendo um cacifo específico da lista

Se precisares de **substituir o cacifo** atribuído (por avaria ou outro motivo), existe uma opção específica para isso sem perder o histórico da entrega.

### 5.5 Armazenamento da Encomenda

Quando o estafeta chega ao ponto de entrega:

1. O sistema envia o comando para **abrir o cacifo**
2. O estafeta coloca a encomenda e fecha a porta
3. O sistema deteta o fecho da porta e transita para o estado **"Armazenada"**
4. É automaticamente enviado um **SMS ao destinatário** com as instruções de levantamento

### 5.6 Levantamento pelo Destinatário

O destinatário pode levantar a encomenda de três formas:

**Por PIN:**
- Recebe um PIN por SMS
- Introduz o PIN no ecrã ou na app
- O cacifo abre e a entrega fica como levantada

**Por QR Code:**
- Recebe um QR Code no SMS
- Lê o QR code no leitor ou na app
- O cacifo abre e a entrega fica como levantada

**Por Staff (funcionário):**
- Um administrador ou funcionário pode fazer o levantamento em nome do destinatário diretamente pelo dashboard

### 5.7 Reenviar SMS

Se o destinatário não recebeu a notificação ou a perdeu, podes **reenviar o SMS** a partir dos detalhes da entrega. O histórico de tentativas de envio fica registado.

O dashboard também tem uma **lista de SMS não entregues**, onde podes ver todas as entregas cujas notificações falharam, facilitando o acompanhamento.

### 5.8 Cancelar e Arquivar Entregas

- **Cancelar** — interrompe o processo antes do levantamento. O cacifo é libertado e fica disponível novamente.
- **Arquivar** — move a entrega para o histórico. Útil para manter a lista de ativas limpa.

### 5.9 Entregas Expiradas

O sistema sinaliza automaticamente as entregas que ultrapassaram o prazo configurado. Podes consultar a lista de **entregas expiradas** e tomar as devidas ações (cancelar, estender prazo, contactar o destinatário).

### 5.10 Referências Duplicadas

A plataforma tem uma ferramenta de deteção de **referências duplicadas** — útil para identificar quando uma encomenda foi registada mais do que uma vez por erro de importação.

### 5.11 Verificação de Entrega

Como administrador, podes **verificar fisicamente** o conteúdo de um cacifo sem alterar o estado da entrega. O sistema abre o cacifo para verificação e regista a ação no histórico.

---

## 6. Vending (Venda de Produtos em Cacifos)

O módulo de **vending** transforma cacifos físicos em pontos de venda automática. Em vez de uma encomenda externa, são os próprios administradores que colocam produtos nos cacifos, que ficam disponíveis para compra pelos utilizadores finais — através da app ou de um ecrã instalado no local.

### 6.1 Conceito e Fluxo Geral

Cada cacifo configurado para vending alberga um **item** (produto). O utilizador vê os produtos disponíveis, escolhe um, paga e o cacifo abre para que possa levantar o produto. O ciclo de vida completo é:

```
Criar Item → Atribuir Cacifo → Armazenar (abrir cacifo para colocar produto)
           → Disponível para compra → Compra iniciada (Purchase criada)
           → Pagamento → Cacifo abre para entrega → Item levantado
           → (Quando esgotado) Aguarda reabastecimento → Reposto
```

### 6.2 Estados de um Item

| Estado | O que significa |
|--------|-----------------|
| **Criado** | Item registado, ainda sem cacifo atribuído |
| **Cacifo Atribuído** | Cacifo reservado, aguarda ser colocado |
| **Cacifo Aberto para Armazenamento** | Cacifo aberto para o staff colocar o produto |
| **Disponível** | Produto no cacifo, pronto para venda |
| **Pendente** | Compra iniciada pelo cliente, aguarda pagamento |
| **A Aguardar Levantamento** | Pagamento confirmado, cacifo a abrir |
| **Cacifo Aberto para Entrega (Ecrã)** | Cacifo aberto após compra no ecrã |
| **Cacifo Aberto para Entrega (App)** | Cacifo aberto após compra na app |
| **Cacifo Aberto para Entrega (Dashboard)** | Cacifo aberto manualmente pelo staff |
| **Vendido** | Produto levantado com sucesso |
| **A Aguardar Reabastecimento** | Produto consumido, cacifo a aguardar ser reposto |
| **Cacifo Aberto para Reabastecimento** | Cacifo aberto para staff repor produto |
| **Cacifo Aberto para Verificação** | Aberto para inspeção sem alterar estado de venda |
| **Cacifo Aberto para Cancelamento** | Aberto para remover produto e cancelar |
| **Cancelado** | Item retirado e cancelado |

### 6.3 Criar um Item (Produto)

1. Acede ao módulo **Itens** no dashboard
2. Clica em **"Novo Item"**
3. Preenche:
   - **Nome** do produto
   - **Preço** — valor de venda ao público
   - **Descrição** (opcional) — texto descritivo visível na app/ecrã
   - **Imagem** (opcional) — fotografia do produto
   - **Categorias** — agrupa produtos por tipo (ex: snacks, bebidas, eletrónicos)
   - **Spot** — localização onde o produto estará disponível
   - **Único** — define se, quando vendido, fica indisponível até ser reposto manualmente, ou se é um produto de stock ilimitado
4. Guarda o item — o estado inicial é **"Criado"**

### 6.4 Atribuir um Cacifo a um Item

Após criar o item, é necessário associá-lo a um cacifo físico:

1. Nos detalhes do item, clica em **"Atribuir Cacifo"**
2. Seleciona a **location**, o **tamanho** adequado ao produto, e opcionalmente um **cacifo específico**
3. Se não escolheres um cacifo específico, o sistema encontra automaticamente um disponível com o tamanho correto
4. O cacifo transita para o estado **"Reservado para Item"**

Para remover a atribuição (por exemplo se o cacifo avariar), usa **"Desatribuir Cacifo"** — o item volta ao estado "Criado" e o cacifo fica livre.

### 6.5 Armazenar o Produto (Colocar no Cacifo)

Quando o cacifo está atribuído e o staff vai colocar o produto fisicamente:

1. Clica em **"Armazenar"** nos detalhes do item
2. O sistema envia o comando de abertura ao hardware
3. O staff coloca o produto e fecha a porta
4. O item transita para o estado **"Disponível"** e fica visível para compra

### 6.6 Consultar a Lista de Vending

O dashboard tem uma vista dedicada **"Vending"** que mostra apenas os itens no estado **"Disponível"**, filtrados por location. Esta vista é útil para ver rapidamente o que está à venda em cada ponto.

Para uma visão mais completa (todos os estados), usa a lista geral de itens com filtro por estado.

### 6.7 Verificar um Item sem Vender

Se precisares de inspecionar o produto no cacifo (verificar estado, validade, etc.) sem iniciar uma venda:

1. Vai aos detalhes do item (deve estar **"Disponível"**)
2. Clica em **"Verificar"**
3. O cacifo abre, o estado transita para **"Cacifo Aberto para Verificação"**
4. Após fechar a porta, o item volta a **"Disponível"**

### 6.8 Cancelar um Item e Remover do Cacifo

Para retirar um produto do cacifo sem o vender:

1. Vai aos detalhes do item
2. Clica em **"Cancelar"**
3. O cacifo abre para o staff remover o produto
4. O item transita para **"Cancelado"** e o cacifo fica livre

### 6.9 Gerir Compras (Purchases)

Cada venda gera uma **Purchase** (compra) associada ao item e à transação de pagamento. No módulo de **Compras** podes:

| Ação | Descrição |
|------|-----------|
| **Listar compras** | Ver todas as compras com estado, item, custo e data |
| **Cancelar compra** | Anula a compra antes da entrega; o item volta a "Disponível" |
| **Devolver (refund)** | Processa o reembolso via Stripe e marca o item como disponível novamente |

**Estados de uma compra:**

| Estado | Descrição |
|--------|-----------|
| **Criada** | Compra registada, aguarda pagamento |
| **A Aguardar Pagamento** | Pagamento iniciado |
| **Paga** | Pagamento confirmado |
| **Cacifo Aberto para Entrega** | Cacifo a abrir para o cliente levantar |
| **Concluída** | Produto levantado com sucesso |
| **Reembolsada** | Valor devolvido ao cliente |
| **Cancelada** | Compra cancelada sem custo |

### 6.10 Reabastecimento de Produtos

Quando um produto é vendido e o item é marcado como **único**, o sistema transita para o estado **"A Aguardar Reabastecimento"**. Para repor o produto:

1. O item aparece na lista com estado **"A Aguardar Reabastecimento"**
2. Clica em **"Armazenar"** (o mesmo botão do armazenamento inicial)
3. O cacifo abre para o staff colocar um novo produto
4. Após fechar a porta, o item volta a **"Disponível"**

### 6.11 Entrega pelo Staff (sem self-service)

Se o modelo de negócio não usa self-service mas sim entrega assistida por um funcionário, o staff pode acionar a entrega diretamente do dashboard:

1. Localiza a compra no estado **"A Aguardar Levantamento"** ou similar
2. Clica em **"Entregar pelo Staff"**
3. O cacifo abre para o funcionário entregar o produto ao cliente

### 6.12 Categorias de Produtos

Os produtos podem ser organizados por **categorias** para facilitar a navegação nas apps e ecrãs (ex: "Snacks", "Bebidas", "Eletrónicos"). As categorias são geridas na secção [Gestão de Conteúdo](#15-gestão-de-conteúdo).

---

## 7. Office (Aluguer Gratuito em Escritório)

O modo **Office** é a vertente da plataforma desenhada para ambientes empresariais — escritórios, sedes corporativas, hospitais, universidades — onde os cacifos são disponibilizados aos colaboradores **sem qualquer cobrança**. O utilizador pode usar um cacifo para guardar os seus pertences durante o dia, sem passar por nenhum processo de pagamento.

### 7.1 O que distingue o modo Office

A principal diferença face ao aluguer standard é o **Modo Gratuito** (*free_mode*). Quando ativado numa location, o sistema omite completamente o processo de pagamento — não é criada nenhuma transação, não é solicitado cartão e não há checkout.

As outras diferenças práticas:
- Os utilizadores acedem tipicamente com **cartão físico** (reader), **app mobile** ou **ecrã** no local
- Não há cobrança por tempo de uso
- Os cacifos podem ser **dedicados a utilizadores específicos** (um cacifo fixo para cada colaborador) ou **partilhados** (qualquer colaborador pode usar qualquer cacifo livre)
- O foco da gestão passa a ser a **ocupação, disponibilidade e acessos**

### 7.2 Configurar um Spot para Office

Quando crias um spot configurado para modo office, o tipo do spot é definido como **"office"**. Isto orienta o sistema a usar as vistas e comportamentos adequados para este contexto.

### 7.3 Ativar o Modo Gratuito

O modo gratuito é uma **configuração de location** — pode ser ativado em algumas locations de um spot e não noutras. Para ativar:

1. Vai às **Configurações** do sistema
2. Filtra pela location pretendida
3. Localiza a configuração **"Modo Gratuito"**
4. Ativa a opção para o tipo de utilizador **"visitante"** (que abrange os utilizadores padrão)

Quando o modo gratuito está ativo, qualquer utilizador que inicie uma sessão nessa location não passa pelo fluxo de pagamento.

### 7.4 Formas de Acesso dos Utilizadores

Num ambiente de escritório, os colaboradores podem aceder aos cacifos de várias formas:

| Método | Descrição |
|--------|-----------|
| **Cartão físico** (Reader) | O colaborador passa o cartão num leitor instalado junto aos cacifos |
| **App mobile** | O colaborador abre o cacifo pela aplicação no smartphone |
| **Ecrã** | Interface touch no local que permite selecionar e abrir um cacifo |
| **Dashboard (staff)** | Um administrativo abre o cacifo em nome do colaborador |

### 7.5 Cacifos Dedicados vs. Cacifos Partilhados

**Cacifos dedicados:**
- Um cacifo específico é atribuído permanentemente a um utilizador
- O utilizador acede sempre ao mesmo cacifo
- A atribuição é feita no perfil do utilizador — ver secção [Utilizadores](#9-utilizadores)
- Útil quando cada colaborador tem o seu próprio cacifo pessoal

**Cacifos partilhados:**
- Todos os cacifos estão no pool de "livres"
- Qualquer utilizador pode ocupar qualquer cacifo disponível
- Quando termina o uso, o cacifo volta ao pool
- Mais eficiente em contextos onde a ocupação simultânea é parcial (ex: trabalho híbrido)

### 7.6 Horários de Funcionamento

Para ambientes de escritório é comum restringir o acesso a determinados horários (ex: segunda a sexta, 8h–20h). Esta configuração é feita em **"Horários"** (*schedule*) nas configurações da location. Fora do horário definido, os cacifos ficam inacessíveis para novos alugueres.

### 7.7 Tempo de Segurança (Safe Time)

Após um utilizador terminar o uso e fechar o cacifo, o sistema pode impor um **período de segurança** antes de o cacifo voltar a estar disponível. Este tempo é configurável por location e é útil para, por exemplo, garantir que o cacifo foi devidamente esvaziado antes de outro utilizador o poder usar.

### 7.8 Analytics de Office

O dashboard de **Analytics — Office** mostra métricas específicas para este contexto:

| Métrica | Descrição |
|---------|-----------|
| **Total de locations** | Número de zonas com cacifos |
| **Total de cacifos** | Cacifos instalados no conjunto de spots |
| **Cacifos disponíveis** | Livres e com porta fechada, prontos a usar |
| **Cacifos abertos** | Com porta fisicamente aberta neste momento |
| **Cacifos em alerta** | Com anomalia detetada pelo hardware |
| **Cacifos offline** | Sem comunicação com o hardware |
| **Cacifos desativados** | Fora de serviço (manutenção, avaria, etc.) |
| **Aberturas totais** | Total histórico de aberturas de cacifos |
| **Aberturas por mês** | Gráfico de evolução mensal nos últimos 12 meses |
| **Administradores** | Distribuição por role: Admin, Manager, Staff |

### 7.9 Monitorizar Cacifos com Porta Aberta

Uma funcionalidade especialmente útil em escritórios é a lista de **cacifos com porta aberta** (ver secção [Cacifos](#4-cacifos-lockers)). Como os utilizadores podem esquecer-se de fechar a porta, esta lista permite ao staff identificar rapidamente quais os cacifos a intervir.

### 7.10 Caso de Uso Típico — Dia de um Colaborador

1. O colaborador chega ao escritório e lê o seu cartão no reader junto à zona de cacifos
2. O sistema identifica o utilizador e abre o cacifo livre (ou o cacifo dedicado)
3. O colaborador coloca os seus pertences e fecha a porta
4. No final do dia, volta ao reader, lê o cartão novamente
5. O cacifo abre, o colaborador retira os pertences e fecha a porta
6. O cacifo transita para o estado "livre" (após o tempo de segurança, se configurado)
7. O log regista a abertura com a identificação do utilizador e o timestamp

---

## 8. Transações e Pagamentos

O módulo de transações regista todos os movimentos financeiros associados ao uso dos cacifos.

### 6.1 O que é uma Transação

Uma transação representa um pagamento ou tentativa de pagamento relacionado com o aluguer de um cacifo. Pode ser iniciada pela app do utilizador (via cartão ou MBWay) ou pelo dashboard.

### 6.2 Estados de uma Transação

| Estado | Descrição |
|--------|-----------|
| **Pendente** | Autorização iniciada, aguarda captura |
| **Captivo** | Valor retido no cartão do cliente |
| **Pago** | Pagamento concluído com sucesso |
| **Processando** | Em processamento pelo gateway |
| **Reembolso Parcial** | Parte do valor foi reembolsada |
| **Cancelada** | Transação anulada antes de ser cobrada |
| **Expirada** | Autorização expirou sem ser capturada |
| **Erro** | Falha no processamento |
| **Devolvida** | Valor integral reembolsado |

### 6.3 Métodos de Pagamento Suportados

| Método | Plataformas |
|--------|-------------|
| Cartão de crédito/débito | Stripe, NOQ |
| MBWay | NOQ |
| SEPA | Stripe |
| PayPal | Stripe |
| Klarna | Stripe |
| e muitos outros | Stripe |

### 6.4 Consultar uma Transação

Na lista de transações podes:

- Ver todas as transações, filtradas por estado, método, data ou utilizador
- Clicar em qualquer transação para ver os **detalhes completos**: valor, horário de início e fim, duração, cacifo utilizado, voucher aplicado, logs de todas as ações
- Consultar o **histórico cronológico** de cada transação (autorização, captura, erros, etc.)

### 6.5 Editar uma Transação

Algumas operações de edição estão disponíveis:

- **Alterar a descrição** da transação
- **Aplicar ou alterar um voucher** — aplica um código de desconto retroativamente
- **Remover um voucher** aplicado
- **Atualizar o NIF** do cliente (para faturação)
- **Corrigir o horário de início** — útil quando houve um atraso no registo do início do aluguer

### 6.6 Cancelar uma Transação

Podes cancelar uma transação que ainda não foi cobrada (estado "pendente" ou "captivo"). Isto liberta o cacifo e anula qualquer autorização de pagamento.

### 6.7 Sincronizar com o Gateway de Pagamento

Se houver alguma discrepância entre o estado da transação no dashboard e no gateway (Stripe ou NOQ), podes usar a função de **sincronização** para forçar a atualização do estado.

### 6.8 Faturação

#### Criar uma Fatura

Para uma transação paga, podes gerar uma fatura:

1. Acede à transação
2. Clica em **"Criar Fatura"**
3. Define os dados necessários:
   - Valor a faturar
   - NIF do cliente
   - Código de produto/serviço
   - Se é isento de pagamento (ex: aluguer gratuito)
4. A fatura é criada no sistema de faturação (Biziq) e fica associada à transação

#### Enviar uma Fatura por Email

Após criar a fatura, podes enviá-la por email diretamente do dashboard — basta indicar o endereço de email do destinatário.

#### Validar NIF

Antes de criar uma fatura, podes **validar o NIF** português do cliente para garantir que está correto.

### 6.9 Consultar Informações de Checkout

Antes de fazer o checkout de um cacifo, podes consultar o **resumo de valores**: duração, preço calculado, desconto de voucher e valor final a cobrar.

---

## 9. Utilizadores

Os **utilizadores** são os clientes que usam os cacifos — seja para receber entregas, alugar cacifos ou aceder a produtos.

### 7.1 Tipos de Utilizador

Cada spot pode ter tipos de utilizador configurados de forma personalizada. Exemplos comuns:
- Residente
- Hóspede
- Colaborador
- Visitante

### 7.2 Criar um Utilizador

Para criar um utilizador:

1. Clica em **"Novo Utilizador"**
2. Preenche:
   - **Tipo** (residente, hóspede, etc.)
   - **Nome completo** ou nome de faturação
   - **NIF** (opcional, para faturação)
   - **Email**
   - **Telefone** (com indicativo de país)
   - **PIN** — código numérico que o utilizador usa para abrir cacifos
   - **Género** (opcional)
   - **Observações** (opcional)
   - **Spot** ao qual o utilizador pertence
3. Guarda o utilizador

> Podes usar o gerador automático de PINs para criar um código único — basta escolher o comprimento desejado.

### 7.3 Editar um Utilizador

Podes editar qualquer campo do perfil de um utilizador: nome, contactos, tipo, PIN, etc.

### 7.4 Ativar/Desativar um Utilizador

Um utilizador desativado não consegue usar os cacifos. Podes ativar ou desativar com um único clique.

### 7.5 Eliminar um Utilizador

Ao eliminar um utilizador, o sistema **liberta automaticamente** todos os cacifos que lhe estejam atribuídos, garantindo que ficam disponíveis para nova utilização.

### 7.6 Atribuir e Desatribuir Cacifos

Podes atribuir um ou mais cacifos especificamente a um utilizador. Esses cacifos ficam dedicados a esse utilizador e só ele consegue abri-los com o seu PIN.

Para remover a atribuição, usa a opção de **desatribuir cacifo**.

### 7.7 Gerir o PIN do Utilizador

- **Atualizar PIN** — define um novo PIN para o utilizador
- **Gerar PIN aleatório** — o sistema cria um PIN único automaticamente com o comprimento definido

### 7.8 Gerir Cartão do Utilizador

Podes atualizar o **número de cartão** associado ao utilizador (para sistemas com leitores de cartão físico).

### 7.9 Histórico do Utilizador

A partir do perfil de um utilizador podes consultar:
- Todas as **transações** realizadas
- **Cacifos** atualmente atribuídos
- **Logs de atividade** (logins, alterações de PIN, etc.)

---

## 10. Administradores

Os **administradores** são as pessoas com acesso ao dashboard. Podem ter diferentes níveis de acesso consoante o seu papel (role).

### 8.1 Roles e Permissões

Cada administrador tem um **papel (role)** que define o que pode ver e fazer no dashboard. As permissões são configuradas ao nível do sistema e os roles são atribuídos na criação ou edição do administrador.

> Normalmente existe uma hierarquia: o administrador principal (*Super Admin*) tem acesso total e pode criar administradores com acesso mais restrito (ex: só ao seu spot, só às entregas, etc.).

### 8.2 Convidar um Novo Administrador

A forma mais simples de adicionar um administrador é através de **convite por email**:

1. Clica em **"Convidar Administrador"**
2. Insere o **email** do novo administrador
3. Seleciona o(s) **spot(s)** aos quais terá acesso
4. Escolhe o **papel (role)**
5. Envia o convite

O novo administrador recebe um email com um link de ativação onde pode definir os seus dados de acesso.

Se o convite não foi utilizado, podes **reenviar o email de ativação** a qualquer momento.

### 8.3 Criar um Administrador Diretamente

Podes também criar um administrador sem enviar convite, preenchendo todos os dados diretamente:
- Nome, username, email, telemóvel
- Palavra-passe
- País, género
- Role
- Observações
- Spots e places atribuídos

### 8.4 Editar um Administrador

Podes editar qualquer dado de um administrador: informações pessoais, contactos, role.

### 8.5 Ativar/Desativar um Administrador

Desativar um administrador impede-o de fazer login sem eliminar a sua conta e histórico.

### 8.6 Eliminar um Administrador

Remove definitivamente a conta do administrador do sistema.

### 8.7 Gerir Spots e Places de um Administrador

Podes controlar **exatamente quais os spots e places** a que um administrador tem acesso:

- **Atribuir spots** — o administrador passa a ver e gerir apenas os spots selecionados
- **Atribuir places** — permite uma granularidade ainda maior, restringindo o acesso a zonas específicas dentro de um spot

### 8.8 Alterar Palavra-passe ou PIN de um Administrador

Cada administrador pode alterar a sua própria palavra-passe (confirmando a atual) e o seu PIN nas definições do perfil.

---

## 11. Vouchers e Promoções

O sistema de vouchers permite criar códigos de desconto para aplicar em transações de aluguer.

### 9.1 Tipos de Desconto

| Tipo | Descrição |
|------|-----------|
| **Gratuito** | Acesso completamente gratuito |
| **Percentagem** | Desconto em percentagem sobre o valor total |
| **Valor fixo** | Desconto de um valor específico (ex: -5€) |
| **Preço fixo** | Define um preço final independentemente da duração |

### 9.2 Criar um Voucher

1. Clica em **"Novo Voucher"**
2. Preenche:
   - **Título** — nome identificativo (ex: "Promoção Verão 2025")
   - **Código** — o código que o utilizador vai introduzir (ex: "VERAO25")
   - **Descrição** — texto explicativo para uso interno
   - **Período de validade** — datas de início e fim
   - **Validade em dias** — número de dias de validade após ativação
   - **Limite de usos total** — quantas vezes o código pode ser usado no total
   - **Usos por dia** — limite diário de utilizações
   - **Tipo de desconto** e **valor do desconto**
   - **Tipo de aluguer** ao qual se aplica
   - **Location** específica (ou global)
   - **Pacotes** aos quais é aplicável
3. Guarda o voucher

### 9.3 Ativar/Desativar Vouchers

Podes ativar ou desativar um voucher sem o eliminar — útil para promoções sazonais que vão ser usadas novamente no futuro.

### 9.4 Editar ou Eliminar Vouchers

Todos os campos de um voucher podem ser editados após criação. A eliminação é permanente.

### 9.5 Aplicar um Voucher a uma Transação

Os vouchers são normalmente aplicados pelos utilizadores na app no momento do pagamento. Como administrador, podes também aplicar ou alterar o voucher de uma transação já existente diretamente no dashboard — ver secção [Transações](#8-transações-e-pagamentos).

---

## 12. Pacotes e Tipos de Aluguer

### 10.1 Tipos de Aluguer

Os **tipos de aluguer** definem as categorias de uso dos cacifos por spot. Exemplos: "Aluguer Hora", "Diária", "Mensal", "Entrega 2H", "Entrega 24H".

Para cada spot podes criar e gerir os teus próprios tipos de aluguer:
- Ativar/desativar tipos existentes
- Criar novos tipos com nome e código único
- Eliminar tipos não utilizados

### 10.2 Pacotes

Os **pacotes** definem os preços para cada tipo de aluguer numa location específica. Um pacote pode ter:

- **Nome** e **código** identificativo
- **Tipo de aluguer** associado
- **Localização** aplicável
- **Duração** (em minutos)
- **Preços** — definidos por moeda, permitindo preços diferentes para EUR, USD, etc.

#### Exemplo prático:
Podes criar um pacote *"Aluguer 1 Hora"* com:
- Duração: 60 minutos
- Preço: 2,00 €
- Associado ao tipo *"Aluguer Hora"*
- Válido na location *"Receção Hotel X"*

Os pacotes podem ser associados a vouchers, permitindo que um desconto só se aplique a determinados pacotes.

---

## 13. Analytics e Relatórios

### 11.1 Dashboard de Entregas

O módulo de analytics fornece uma visão agregada das operações de entrega:

- **Total de entregas** por estado (criadas, armazenadas, levantadas, canceladas, arquivadas)
- **Evolução temporal** — tendências por dia, semana ou mês
- **Filtros** por período, spot, tipo de entrega
- **Taxa de levantamento** — percentagem de entregas efetivamente levantadas vs canceladas

### 11.2 Métricas de Ocupação

Podes consultar a taxa de ocupação dos cacifos por localização e período. Isto é útil para identificar spots sobrecarregados ou subutilizados.

### 11.3 Relatórios Mensais

O sistema pode ser configurado para gerar relatórios mensais automáticos — ver secção [Configurações](#12-configurações-do-sistema).

### 11.4 Relatórios Manuais (Reports)

Os utilizadores e o público podem submeter **relatórios** de problemas ou ocorrências. Como administrador podes:

- Ver a lista de relatórios submetidos
- Consultar o assunto, mensagem e email do remetente
- Eliminar relatórios já tratados

### 11.5 Avaliações (Reviews)

Os utilizadores podem deixar **avaliações** da experiência de uso dos cacifos:

- Classificação por **estrelas**
- **Tags** de categorização (ex: "fácil de usar", "bom estado", etc.)
- **Comentário** livre

Como administrador podes consultar todas as avaliações e eliminá-las se necessário.

---

## 14. Configurações do Sistema

As configurações controlam o comportamento do sistema. Podem ser definidas **globalmente** (aplicam-se a todos os spots) ou **por spot** (sobrepõem-se às globais para esse spot específico).

### 12.1 Configurações de Notificações SMS

| Configuração | O que faz |
|--------------|-----------|
| **Serviço SMS** | Define o provedor de SMS (ex: Twilio) |
| **Mensagem SMS geral** | Texto da mensagem enviada aos destinatários |
| **Tentativas de reenvio** | Número de vezes que o sistema tenta reenviar um SMS falhado |
| **SMS retry** | Intervalo entre tentativas de reenvio |

### 12.2 Configurações de Segurança

| Configuração | O que faz |
|--------------|-----------|
| **2FA (Autenticação em 2 passos)** | Ativa/desativa a verificação por SMS no login |
| **Tempo de sessão** | Duração máxima de uma sessão de administrador |
| **Domínios** | Define os domínios autorizados a aceder à API |

### 12.3 Configurações de Cacifos

| Configuração | O que faz |
|--------------|-----------|
| **Tempo Seguro (Safe Time)** | Período de espera após um cacifo ser libertado antes de ficar disponível |
| **Tempo Pendente** | Duração máxima no estado pendente |
| **Taxa de ocupação** | Define o limiar de alerta de ocupação |
| **Horários (Schedule)** | Horários de funcionamento do sistema |
| **Ações de ecrã** | Define o que é possível fazer nos ecrãs instalados |

### 12.4 Configurações de Entregas

| Configuração | O que faz |
|--------------|-----------|
| **Tempo de expiração de entrega** | Após quantas horas/dias uma entrega expira automaticamente |
| **Limpeza de entregas** | Automatiza o arquivo/limpeza de entregas antigas |
| **API externa** | Configurações de integração com APIs externas de entregas |
| **Última chamada externa** | Registo e controlo da última sincronização com sistema externo |

### 12.5 Configurações de Pagamentos

| Configuração | O que faz |
|--------------|-----------|
| **Serviço de pagamento** | Define o gateway (Stripe, NOQ, EUPago) |
| **Chave de pagamento** | API key do gateway |
| **Método de pagamento** | Métodos aceites (cartão, MBWay, etc.) |
| **IVA** | Taxa de IVA aplicada |
| **Preço de cativação** | Valor pré-autorizado no momento do início do aluguer |
| **Modo Gratuito** | Ativa um modo sem cobrança (útil para testes ou promoções) |
| **Moeda** | Moeda padrão para o spot (EUR, USD, etc.) |
| **Pagamentos gerais** | Configurações globais de pagamento |

### 12.6 Configurações de Faturação

| Configuração | O que faz |
|--------------|-----------|
| **Serviço de faturação** | Define o provedor (ex: Biziq) |
| **Serviço de email** | Configura o envio de emails de fatura |

### 12.7 Configurações de Identidade Visual

| Configuração | O que faz |
|--------------|-----------|
| **Logo principal** | Logo do operador ou cliente |
| **Logo secundário** | Logo alternativo |
| **Certificado do dashboard** | Certificado de segurança para acesso ao dashboard |

### 12.8 Configurações de Integrações

| Configuração | O que faz |
|--------------|-----------|
| **WhatsApp** | Configurações do serviço de WhatsApp para notificações |
| **Socket** | Porta de comunicação WebSocket para atualizações em tempo real |
| **Addons** | Módulos adicionais ativados para o spot |
| **Menu mobile** | Configuração do menu da aplicação móvel |
| **Relatório mensal** | Ativa e configura o relatório mensal automático |
| **Alertas** | Define os alertas automáticos do sistema |

### 12.9 Estado do Sistema

| Configuração | O que faz |
|--------------|-----------|
| **Estado do sistema** | Liga/desliga o sistema (modo emergência) |
| **Reiniciar sistema** | Força um reinício do serviço |
| **Limpeza de webhooks** | Configura a limpeza automática de webhooks antigos |

---

## 15. Gestão de Conteúdo

### 13.1 Termos e Condições

Para cada spot podes gerir os **termos e condições** que os utilizadores aceitam ao usar os cacifos:

- Criar termos com título e conteúdo
- Ativar/desativar versões
- Cada spot pode ter os seus próprios termos

### 13.2 FAQ

Podes criar uma **base de perguntas frequentes** por spot, que pode ser apresentada nas aplicações e ecrãs:

- Pergunta e resposta
- Ativar/desativar cada entrada individualmente

### 13.3 Categorias

As **categorias** são usadas para organizar itens e produtos:

- Criar categorias com nome, tipo e ícone
- Associar categorias a spots específicos
- Ativar/desativar categorias

### 13.4 Itens

Os **itens** representam objetos guardados em cacifos do tipo vending ou asset management. Para cada item podes acompanhar:

- Estado atual (armazenado, disponível, vendido, cancelado, etc.)
- Cacifo onde se encontra
- Categoria
- Spot associado

### 13.5 Ecrãs (Screens)

Os ecrãs são os dispositivos físicos instalados junto aos cacifos que permitem interação ao utilizador. No dashboard podes:

- Listar e gerir ecrãs por localização
- Ativar/desativar ecrãs
- Associar um ecrã a uma location específica
- Ver o estado de cada ecrã (pendente ou autenticado)

### 13.6 Ficheiros e Pastas

O sistema tem uma gestão simples de ficheiros para armazenar documentos associados à plataforma:

- Criar pastas para organização
- Fazer upload de ficheiros
- Organizar em hierarquia de pastas

### 13.7 Menus

Os **menus** controlam a navegação nas aplicações móveis e ecrãs. Podes configurar quais as opções visíveis e em que ordem aparecem.

### 13.8 Terminais

Os **terminais** são dispositivos físicos de pagamento ou interação. Podes gerir os terminais associados a cada spot:

- Registar novos terminais com nome e identificador
- Ativar/desativar terminais
- Eliminar terminais

### 13.9 Leitores

Os **leitores** são dispositivos de leitura de cartões ou QR codes instalados nos pontos de acesso. Podem ser consultados e geridos no dashboard.

---

## 16. Auditoria e Logs

A plataforma regista de forma automática todas as ações realizadas. Estes registos são essenciais para auditoria, diagnóstico de problemas e responsabilização.

### 14.1 Logs de Administradores

Todas as ações realizadas por administradores ficam registadas:
- Criação, edição e eliminação de utilizadores
- Criação, edição e eliminação de administradores
- Logins no dashboard
- Alterações de configurações
- Criação e gestão de spots, places, locations
- Criação e gestão de eventos e subscrições
- E muito mais...

### 14.2 Logs de Utilizadores

As ações dos utilizadores finais são também registadas:
- Logins
- Alterações de PIN
- Alterações de email
- Alterações de NIF
- Recuperação de PIN
- Abertura de portas externas

### 14.3 Logs de Cacifos

Cada ação sobre um cacifo é registada com timestamp e identificação de quem executou:
- Aberturas (pelo dashboard, pelo ecrã, pela app, pelo leitor)
- Alertas
- Estados de porta
- Alugueres iniciados e terminados
- Checkouts

### 14.4 Logs de Transações

Cada evento do ciclo de pagamento fica registado:
- Autorização de cartão ou MBWay
- Cativação do valor
- Pagamento final
- Erros de pagamento
- Cancelamentos
- Reembolsos (parciais ou totais)
- Emissão de faturas

### 14.5 Logs de Configurações

Todas as alterações de configurações ficam registadas com o administrador que as efetuou, o valor anterior e o novo valor.

### 14.6 Logs de Entregas

Cada mudança de estado de uma entrega é registada no log da entrega, com timestamp e identificação do administrador quando aplicável.

---

## 17. Integrações Externas

### 15.1 Hardware

O sistema comunica com o hardware para controlar as fechaduras físicas dos cacifos. Esta comunicação é automática e transparente, mas como administrador podes:

- **Sincronizar o estado** de um cacifo com o hardware (atualiza o estado da porta no dashboard)
- **Enviar comandos de abertura** remotamente

### 15.2 Pagamentos — Stripe

O Stripe é o gateway de pagamento principal. Suporta uma vasta gama de métodos de pagamento. No dashboard podes:

- Consultar o estado de uma transação diretamente no Stripe
- Sincronizar transações divergentes
- Criar reembolsos (créditos)

### 15.3 Pagamentos — NOQ

NOQ é um gateway de pagamento alternativo. A integração permite:

- Processar pagamentos através de um TPA
- Cancelar transações

### 15.4 SMS — Twilio

O Twilio é o serviço de SMS utilizado para:

- Notificações de entrega (PIN de levantamento)
- Códigos de verificação 2FA para administradores
- Recuperação de palavra-passe

O dashboard regista o estado de entrega de cada SMS e os erros associados.

### 15.5 WhatsApp

O sistema tem integração com WhatsApp para notificações alternativas ao SMS. Inclui uma funcionalidade de **simulação** de entrega via WhatsApp — útil para demonstrações ou testes do fluxo completo.

### 15.6 Faturação — Biziq

A integração com o Biziq permite emitir faturas e recibos diretamente da plataforma, com os dados do cliente e o valor correto já preenchidos.

### 15.7 Webhooks

A plataforma suporta **webhooks** para integração com sistemas externos. Podes configurar endpoints que recebem notificações automáticas quando determinados eventos ocorrem (ex: entrega armazenada, entrega levantada, cacifo libertado).

Os webhooks têm gestão de falhas: se um webhook falhar, o sistema regista o erro e pode tentar novamente.

### 15.8 API Pública

O sistema expõe uma API que pode ser integrada com sistemas externos de gestão de entregas (transportadoras, plataformas de e-commerce). A configuração da API externa é feita nas configurações do sistema.

---

## 18. Resolução de Problemas Comuns

### O utilizador não recebeu o SMS de levantamento

1. Vai à entrega em questão
2. Verifica o estado — deve estar como **"Armazenada"**
3. Consulta o histórico de SMS — vê se houve tentativas e se falharam
4. Verifica se o número de telemóvel está correto (com indicativo de país)
5. Usa a opção **"Reenviar SMS"**
6. Se continuar a falhar, vai à lista de **"SMS não entregues"** para diagnóstico

### O cacifo não abre quando é enviado o comando

1. Vai aos detalhes do cacifo
2. Verifica se o cacifo está **ativo** (não desativado)
3. Clica em **"Sincronizar estado"** para verificar se o hardware está online
4. Tenta novamente a abertura
5. Se persistir, verifica a conectividade do hardware

### O estado do cacifo não corresponde à realidade física

1. Vai aos detalhes do cacifo
2. Clica em **"Sincronizar"**
3. O sistema atualiza o estado da porta com a leitura real do hardware

### Uma entrega ficou presa num estado intermédio

1. Consulta o log da entrega para perceber o que aconteceu
2. Para liberar um cacifo bloqueado, usa a opção **"Libertar cacifo"** da entrega
3. Se necessário, cancela a entrega — o cacifo é automaticamente libertado

### Um pagamento ficou no estado "Pendente" há muito tempo

1. Vai aos detalhes da transação
2. Usa **"Consultar no gateway"** para verificar o estado real no Stripe/NOQ
3. Se o pagamento foi processado mas o sistema não atualizou, usa **"Sincronizar"**
4. Se a autorização expirou, cancela a transação

### Não consigo aceder a um spot ou localização

- Verifica com o administrador principal se tens permissão atribuída para esse spot
- O teu role pode não ter acesso às funcionalidades que estás a tentar usar

### O sistema de 2FA não está a funcionar

- Verifica se o número de telemóvel da conta está correto
- Verifica se o serviço SMS está ativo nas configurações
- Contacta o administrador principal para verificar as configurações do serviço Twilio

---

*Manual de utilizador Lokk — Dashboard Admin | Versão 1.0 | Junho 2026*
