DOMURA OS — Sistema de Tickets
Instruções de Instalação no cPanel
=======================================

ESTRUTURA DO PACOTE
-------------------
tickets-domura/
├── sql/
│   └── schema.sql              ← Importar no phpMyAdmin
├── tickets-api/
│   ├── config.php              ← EDITAR com dados da BD e Brevo
│   ├── get-tickets.php
│   ├── get-ticket.php
│   ├── create-ticket.php
│   ├── add-message.php
│   ├── update-status.php
│   └── deliver.php
├── pages/
│   └── tickets.php             ← Página a incluir no OS
└── uploads/
    └── tickets/                ← Pasta de uploads (deixar vazia)

=======================================
PASSO 1 — BASE DE DADOS
=======================================
1. Entrar no cPanel → phpMyAdmin
2. Seleccionar a base de dados do OS Domura
3. Clicar em "Importar"
4. Seleccionar o ficheiro: sql/schema.sql
5. Clicar "Executar"

=======================================
PASSO 2 — UPLOAD DOS FICHEIROS
=======================================
Via cPanel → Gestor de Ficheiros (ou FTP):

Copiar para public_html/ (ou a pasta raiz do OS):
  - tickets-api/  →  public_html/tickets-api/
  - pages/tickets.php  →  public_html/pages/tickets.php
  - uploads/tickets/  →  public_html/uploads/tickets/

Verificar permissões da pasta uploads/tickets/:
  - Deve ser 755

=======================================
PASSO 3 — CONFIGURAÇÃO
=======================================
Editar o ficheiro: tickets-api/config.php

  TK_DB_HOST  → normalmente 'localhost'
  TK_DB_NAME  → nome da base de dados (ex: domura_os)
  TK_DB_USER  → utilizador MySQL do cPanel
  TK_DB_PASS  → password MySQL
  TK_BREVO_KEY → chave API do Brevo (para emails)
  TK_UPLOAD_URL → URL pública da pasta uploads

=======================================
PASSO 4 — INTEGRAR NO OS
=======================================
No ficheiro onde o menu Tickets já existe,
adicionar na secção que carrega páginas:

  case 'tickets':
      include 'pages/tickets.php';
      break;

O item do menu deve apontar para:
  ?page=tickets

=======================================
PASSO 5 — LIGAR EMAILS (OPCIONAL)
=======================================
Em cada ficheiro da tickets-api/ existem
comentários com // Email de notificação.

Para activar, descomenta essas linhas e
adapta tkBuscarEmailUtilizador() à tua
tabela de utilizadores existente.

=======================================
SESSÃO NECESSÁRIA
=======================================
O sistema usa estas variáveis de sessão
(que o OS já deve ter):

  $_SESSION['user_id']    → ID do utilizador
  $_SESSION['name']       → Nome completo
  $_SESSION['role']       → 'consultor' | 'agencia' | 'master'
  $_SESSION['agencia']    → Nome da agência (ex: 'Évora')
  $_SESSION['agencia_id'] → ID da agência
  $_SESSION['email']      → Email do utilizador

=======================================
SUPORTE
=======================================
Em caso de dúvida, enviar o erro exacto
que aparece no ecrã.