Guia de Instalação

/opt/api-unifi-controle/          # Diretório principal da aplicação
├── main.py                           # Entry point FastAPI
├── requirements.txt
├── alembic.ini
├── setup_wizard_server.py            # Servidor HTTP do wizard
├── src/                              # Módulos da aplicação
│   ├── api/                          # 15 routers FastAPI
│   ├── models/                       # SQLAlchemy models
│   └── services/                     # Lógica de negócio
├── alembic/                          # Migrations do banco
├── web/                              # Frontend estático
│   ├── index.html
│   └── setup_wizard.html             # Wizard de configuração
└── venv/                             # Virtualenv (criado no postinst)

/etc/api-unifi-controle/           # Configurações
└── .env                              # Variáveis (modo 0600 — gerado pelo wizard)

/var/log/api-unifi-controle/       # Logs da aplicação
├── access.log
└── error.log

/etc/systemd/system/
├── unifi-api.service                 # Serviço principal (porta 8000)
└── unifi-api-setup.service           # Wizard temporário (porta 8080)

/etc/apache2/sites-available/
└── unifi-api.conf                    # VirtualHost (proxy porta 80 → 8000)

# Adicionar repositório oficial InfluxData
$ wget -q -O- https://repos.influxdata.com/influxdata-archive_compat.key | \
    gpg --dearmor | \
    sudo tee /etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg > /dev/null

$ echo 'deb [signed-by=/etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg] https://repos.influxdata.com/debian stable main' | \
    sudo tee /etc/apt/sources.list.d/influxdata.list

$ sudo apt update && sudo apt install -y influxdb2

$ sudo systemctl enable --now influxdb

$ sudo ufw allow 8080/tcp comment 'Wizard setup (temporario)'
$ sudo ufw allow 80/tcp   comment 'Apache2 HTTP'
$ sudo ufw allow 443/tcp  comment 'Apache2 HTTPS'
$ sudo ufw enable

# Clonar repositório
$ git clone https://github.com/HigorMatos/api-unifi-controle.git
$ cd api-unifi-controle

# Criar e ativar virtualenv
$ python3 -m venv venv
$ source venv/bin/activate

# Instalar dependências
(venv) $ pip install -r requirements.txt

$ sudo systemctl start postgresql
$ sudo -u postgres psql -c "CREATE ROLE unifi_api WITH LOGIN PASSWORD 'sua_senha';"
$ sudo -u postgres createdb -O unifi_api unifi_api

# Importar schema inicial
$ sudo -u postgres psql -d unifi_api -f scripts/install_database.sql

$ sudo mkdir -p /etc/api-unifi-controle
$ sudo cp .env.example /etc/api-unifi-controle/.env
$ sudo nano /etc/api-unifi-controle/.env   # editar variáveis
$ sudo chmod 600 /etc/api-unifi-controle/.env

# Testar diretamente (desenvolvimento)
(venv) $ uvicorn main:app --host 0.0.0.0 --port 8000 --reload

# Produção com workers múltiplos
(venv) $ uvicorn main:app --host 0.0.0.0 --port 8000 --workers 4

# ── Aplicação ─────────────────────────────────────────────────
APP_NAME=API UniFi Controle Multi-Controller
VERSION=1.0.0
DEBUG=false
API_HOST=0.0.0.0
API_PORT=8000
API_WORKERS=4

# ── PostgreSQL ────────────────────────────────────────────────
DB_HOST=localhost
DB_PORT=5432
DB_NAME=unifi_api
DB_USER=unifi_api
DB_PASSWORD=<senha_gerada_pelo_wizard>

# ── InfluxDB ─────────────────────────────────────────────────
INFLUXDB_URL=http://localhost:8086
INFLUXDB_TOKEN=<token_do_influxdb>
INFLUXDB_ORG=unifi
INFLUXDB_BUCKET=unifi_metrics

# ── Segurança JWT ─────────────────────────────────────────────
SECRET_KEY=<64_chars_hex_gerado_pelo_wizard>
ENCRYPTION_KEY=<fernet_base64_44chars_gerado_pelo_wizard>
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30

# ── CORS ─────────────────────────────────────────────────────
ENABLE_CORS=true
ALLOWED_ORIGINS=http://localhost:8000,https://seu-dominio.com

# ── Caminhos ─────────────────────────────────────────────────
CONFIG_PATH=/etc/api-unifi-controle/.env
LOG_PATH=/var/log/api-unifi-controle

# Iniciar
$ sudo systemctl start unifi-api

# Parar
$ sudo systemctl stop unifi-api

# Reiniciar
$ sudo systemctl restart unifi-api

# Ver status detalhado
$ sudo systemctl status unifi-api

# Habilitar inicialização automática
$ sudo systemctl enable unifi-api

# Desabilitar inicialização automática
$ sudo systemctl disable unifi-api

# Logs em tempo real (journal)
$ sudo journalctl -u unifi-api -f

# Últimas 100 linhas
$ sudo journalctl -u unifi-api -n 100

# Logs do dia
$ sudo journalctl -u unifi-api --since today

# Arquivos de log da aplicação
$ sudo tail -f /var/log/api-unifi-controle/access.log
$ sudo tail -f /var/log/api-unifi-controle/error.log

$ curl -s http://localhost:8000/health | python3 -m json.tool
{
  "status": "ok",
  "version": "1.0.0",
  "database": "connected",
  "influxdb": "connected"
}

# Habilitar módulos necessários
$ sudo a2enmod proxy proxy_http headers rewrite

# Habilitar VirtualHost gerado pelo instalador
$ sudo a2ensite unifi-api

# Desabilitar site padrão (opcional)
$ sudo a2dissite 000-default

$ sudo systemctl reload apache2

<VirtualHost *:80>
    ServerName api-unifi.seu-dominio.com

    # Proxy reverso para Uvicorn
    ProxyPreserveHost On
    ProxyPass        /  http://127.0.0.1:8000/
    ProxyPassReverse /  http://127.0.0.1:8000/

    # Suporte a WebSocket
    RewriteEngine On
    RewriteCond %{HTTP:Upgrade} websocket [NC]
    RewriteCond %{HTTP:Connection} upgrade [NC]
    RewriteRule /(.*) "ws://127.0.0.1:8000/$1" [P,L]

    # Headers de segurança
    Header always set X-Content-Type-Options "nosniff"
    Header always set X-Frame-Options "DENY"

    ErrorLog  /var/log/api-unifi-controle/apache-error.log
    CustomLog /var/log/api-unifi-controle/apache-access.log combined
</VirtualHost>

$ sudo apt install -y certbot python3-certbot-apache
$ sudo certbot --apache -d api-unifi.seu-dominio.com

# Renovação automática (já configurada pelo certbot)
$ sudo systemctl status certbot.timer

# Verificar versão atual
$ dpkg -s api-unifi-controle | grep Version

# Fazer backup do .env antes do upgrade
$ sudo cp /etc/api-unifi-controle/.env /etc/api-unifi-controle/.env.bak

# Instalar nova versão (preinst para o serviço automaticamente)
$ sudo dpkg -i api-unifi-controle_1.1.0_amd64.deb

# Verificar que o serviço reiniciou
$ systemctl is-active unifi-api

$ cd /opt/api-unifi-controle
$ sudo -u unifi-api venv/bin/alembic upgrade head

$ sudo -u postgres dropdb unifi_api
$ sudo -u postgres dropuser unifi_api

// 1. Obter o access_token via login
const token = "eyJ...";

// 2. Conectar ao WebSocket
const ws = new WebSocket("wss://api-unifi.seu-dominio.com/ws/status");

ws.onopen = () => {
  // 3. Autenticar: enviar token como primeira mensagem
  ws.send(JSON.stringify({ token: token }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  // data = array de controladores com status em tempo real
  data.forEach(ctrl => {
    console.log(`${ctrl.name}: ${ctrl.online ? '✅' : '❌'} — ${ctrl.wlan_clients} clientes`);
  });
};

ws.onclose = (event) => {
  if (event.code === 4008) console.error("Limite de conexões por IP atingido");
};

# pip install websockets
import asyncio, json, websockets

async def monitor():
    uri = "wss://api-unifi.seu-dominio.com/ws/status"
    token = "eyJ..."
    async with websockets.connect(uri) as ws:
        # Autenticar
        await ws.send(json.dumps({"token": token}))
        async for message in ws:
            data = json.loads(message)
            for ctrl in data:
                print(f"{ctrl['name']}: {'Online' if ctrl['online'] else 'Offline'}")

asyncio.run(monitor())

# ── SMTP (Reset de Senha) ──────────────────────────────────────
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=noreply@sua-empresa.com
SMTP_PASSWORD=<app_password>
SMTP_FROM=noreply@sua-empresa.com
SMTP_TLS=true
PASSWORD_RESET_EXPIRE_MINUTES=30

# Passo 1 — Solicitar reset (sempre retorna 200)
$ curl -s -X POST https://<host>/api/v1/auth/password-reset/request \
  -H "Content-Type: application/json" \
  -d '{ "email": "usuario@empresa.com" }'

# Passo 2 — Confirmar reset com token recebido no e-mail
$ curl -s -X POST https://<host>/api/v1/auth/password-reset/confirm \
  -H "Content-Type: application/json" \
  -d '{ "token": "abc123...", "new_password": "NovaSenha@2025" }'

# Enviar e-mail de teste (requer role superadmin)
$ curl -s -X POST https://<host>/api/v1/settings/smtp/test \
  -H "Authorization: Bearer $TOKEN"