> ## Documentation Index
> Fetch the complete documentation index at: https://docs.queue.pt/llms.txt
> Use this file to discover all available pages before exploring further.

# Como funciona: uma visão geral completa para o utilizador

> Compreenda como a aplicação está estruturada — como as suas funcionalidades se interligam e como está organizada para apoiar o seu fluxo de trabalho diário.

## 1. Visao geral da app

O QUEUE esta organizado em modulos:

* `Painel`: visao geral das reparações em curso.
* `Clientes`: base de dados de clientes.
* `Reparacoes`: processos técnicos, estados, procedimentos, anexos e comunicação.
* `Orcamentos`: orçamentos ligados a reparações.
* `Inventario`: catálogo de modelos e serviços pré-definidos.
* `Agendamentos`: calendário de reparações agendadas.
* `Perfil`: conta, empresa, termos, utilizadores extra, PWA e subscrição.

## 2. Primeiro acesso e ativacao da conta

### Trial inicial

1. Aceda a `/signup`.
2. Introduza:
   * nome da empresa
   * NIF
   * nome do responsável
   * email do responsável
3. Aceite os termos e condições da plataforma.
4. Recebera um código por email.
5. Na pagina de verificação, introduza o código e defina a password.
6. A conta entra em trial de 10 dias, sem cartao na fase inicial.

### Iniciar sessao

1. Entre em `/login`.
2. Use o email e a password definidos.
3. A app abre no painel principal.

## 3. Instalar a app como PWA

A app pode ser instalada como aplicacao.

1. Va a `Perfil`.
2. Na secao `Instalar aplicacao`, clique em `Instalar aplicacao`.
3. Confirme o pedido do navegador.

Notas:

* O botao so e util quando o browser disponibiliza o pedido de instalacao.
* Depois de instalada, a app pode abrir em modo standalone, como app nativa.

## 4. Como configurar a empresa

Tudo isto e gerido em `Perfil`, na secao `Empresa`.

### Dados da empresa

1. Abra `Perfil`.
2. Na secao `Empresa`, preencha ou atualize:
   * nome
   * NIF
   * telefone
   * email
   * morada
   * codigo postal
   * localidade
3. Clique em `Guardar`.

### Logo

1. Na mesma secao, escolha um ficheiro de imagem.
2. Clique em `Enviar logo`.

O logo e usado na apresentacao da empresa e nos documentos gerados.

## 5. Termos e condicoes

Existem dois tipos de termos no fluxo atual.

### Termos da plataforma

* Sao aceites no registo inicial da empresa.
* Regulam o uso do QUEUE enquanto software.

### Termos da empresa para reparacoes

Sao configurados em `Perfil > Termos e condicoes`.

1. O administrador escreve os termos no editor.
2. Pode rever a pre-visualizacao antes de gravar.
3. Clica em `Guardar termos`.

Estes termos:

* aparecem na pagina publica da reparacao
* entram nos PDFs da reparacao
* podem ser assinados pelo cliente

Quando o cliente assina os termos na pagina publica, a assinatura fica guardada na reparacao. Se existir o estado `para-intervencao`, a app tambem move automaticamente a reparacao para esse estado.

## 6. Utilizadores extra

Geridos em `Perfil > Utilizadores`, apenas por administradores.

### Criar utilizador

1. Preencha nome, email e password.
2. Ative `Dar permissoes de administrador` se necessario.
3. Clique em `Criar utilizador`.

### Editar utilizador

Na tabela de utilizadores e possivel:

* editar permissoes
* redefinir password
* apagar utilizador

### Limite de utilizadores

* O plano define quantos utilizadores extra podem existir.
* A app mostra o consumo atual, por exemplo `X / Y utilizadores extra usados`.
* O primeiro utilizador da empresa nao conta como utilizador extra; o limite aplica-se aos adicionais.

## 7. Subscricoes disponiveis e como ativar

Na pagina `Perfil > Gerir subscricao` ou diretamente em `/billing`, a app mostra:

* plano atual
* estado da subscricao
* ultimo pagamento
* proximo pagamento
* ultimo evento de cobranca

### Planos apresentados na UI

#### Starter

* 1 utilizador extra
* etiquetas
* documentos PDF
* branding
* suporte tecnico

#### Base

* ate 5 utilizadores extra
* etiquetas
* documentos PDF
* branding
* envio de email integrado
* gestao de anexos
* servicos pre-definidos
* suporte tecnico

#### Pro

* ate 5 utilizadores extra
* etiquetas
* documentos PDF
* branding
* envio de email integrado
* gestao de anexos
* servicos pre-definidos
* agendamento
* integracao com faturacao
* envio de SMS/WhatsApp
* formacao
* suporte prioritario

### Como ativar um plano

1. Entre em `Billing`.
2. Escolha o plano pretendido.
3. Clique em `Ativar plano` ou `Continuar para pagamento`.
4. Conclua o checkout Stripe.
5. Depois da confirmacao da Stripe, o plano fica ativo.

Notas importantes:

* Durante o trial, pode antecipar a subscricao a qualquer momento.
* Se o trial expirar, a app pode bloquear acesso ate existir plano ativo.
* Se a empresa tiver acesso vitalicio/manual, a pagina de billing fica apenas informativa e sem selecao de planos.

## 8. O que aparece ou nao consoante o plano

A app ativa ou esconde funcionalidades consoante a subscricao:

* `Etiquetas`
* `PDF`
* `Portal do cliente`
* `Email`
* `Anexos`
* `WhatsApp`
* `Inventario`
* `Agendamentos`

Na pratica, isto afeta o menu lateral e tambem botoes dentro das paginas.

## 9. Painel principal

O `Painel` mostra:

* nome e logo da empresa
* lista de reparacoes nao agendadas
* filtros por pesquisa, estado e garantia
* ordenacao

Por defeito, as reparacoes terminadas ficam fora da vista principal quando nao ha filtro manual.

## 22. Fluxo recomendado de utilizacao

Para usar o QUEUE com menos friccao, o fluxo mais natural e:

1. configurar empresa, logo e termos
2. criar utilizadores extra, se necessario
3. criar clientes
4. preparar inventario de modelos e servicos
5. criar reparacao
6. deixar a app sugerir servico/preco quando houver inventario
7. gerar orcamento automatico ou manual
8. comunicar com o cliente por email / WhatsApp
9. acompanhar procedimentos
10. usar portal publico para aceitacao e assinatura
11. marcar `Pronto`
12. finalizar em `Terminado` com fatura e data de entrega

## 23. Resumo rapido das automatizacoes mais importantes

* historico automatico por serial / IMEI
* sugestoes de equipamento e servico com base no inventario
* orcamento automatico a partir de preco do servico ligado ao modelo
* aviso tecnico automatico por `flag notes`
* mudanca assistida para `Pronto`
* obrigatoriedade de fatura + entrega em `Terminado`
* assinatura publica dos termos
* aceitacao publica de orcamentos
* registo automatico de certos eventos em procedimentos
* historico de emails enviados e recebidos na reparacao