ligbox-ops-platform/specs/028-openpanel-ce-ligbox-reengineering/CONFIRMACAO-TESTE-API.md
Ligbox Spec Hub 7dfdf5bc43 Restore prominent OpenPanel panel on Infra and add Spec 033.
Promote OpenPanel to a full-width featured panel with VM123 health metrics, add hero chip, and document Infra console UI layout in Spec 033 with cross-ref from Spec 028.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-19 22:29:29 +00:00

3.5 KiB

Spec 028 — Adendo: Teste de Confirmação API Multidomínio

Criado: 2026-06-19
Solicitado por: Roger
Status: Implementado
Relacionado: Spec 028 (OpenPanel CE Ligbox Re-engenharia)


Objetivo

Permitir validar quantas vezes quiser que a re-engenharia OpenPanel Ligbox está operacional:

  • Desk API → Bridge :18087opencli user-add + domains-add
  • Suporte multidomínio na plataforma (2 contas / 2 domínios via API)
  • Cleanup automático da conta de teste

Onde executar

Canal Como
Menu Infra (Desk) Infraestrutura → card OpenPanel APITestar multidomínio
Script CLI scripts/test-openpanel-multidomain-api.sh
API directa POST /api/v1/vm123/openpanel/test-confirm

Menu Infra (Desk VM122)

Layout UI: Spec 033 (specs/033-desk-infra-console-ui/spec.md) — painel largo OpenPanel API — Re-engenharia Ligbox · Spec 028 na grid Infra.

  1. Login em https://desk.ligbox.com.br
  2. Menu lateral → Infraestrutura
  3. Painel OpenPanel API — Re-engenharia Ligbox (chip VM123 no topo + painel orange largura total)
  4. Botão Testar multidomínio
  5. Modal com passo-a-passo e resultado (OK/FAIL por step)

Perfis autorizados: super_admin, devops, developer


Script CLI (repetível)

Via Desk API (recomendado)

cd /opt/ligbox-ops-platform   # ou clone local

DESK_PASS='sua_senha_desk' bash scripts/test-openpanel-multidomain-api.sh

Via bridge directo (sem Desk)

MODE=bridge bash scripts/test-openpanel-multidomain-api.sh

Variáveis opcionais:

Variável Default
API_URL http://10.10.10.122:8080
DESK_USER root
BRIDGE_URL http://10.10.10.123:18087
BRIDGE_TOKEN ligbox-community-bridge-token

Suite de testes (7 passos)

# Step O que valida
1 bridge_health Bridge :18087 responde ligbox-v2
2 list_users API lista contas existentes
3 get_reference_user Conta real diarissima + domínio
4 provision_domain_a Cria conta 1 + domínio A
5 provision_domain_b Cria conta 2 + domínio B
6 verify_multidomain_platform Ambas contas visíveis na listagem
7 cleanup_* Remove contas de teste

Senha teste: LbOpenTest805353 (nunca persiste — user apagado no fim)


Endpoint API

POST /api/v1/vm123/openpanel/test-confirm
Authorization: Bearer <desk_token>

Resposta (exemplo sucesso):

{
  "ok": true,
  "suite": "openpanel-multidomain-api-confirm",
  "spec": "028-openpanel-ce-ligbox-reengineering",
  "steps_passed": 7,
  "steps_total": 7,
  "message": "OpenPanel via API multidomínio Ligbox Re-engenharia — CONFIRMADO",
  "steps": [ ... ]
}

Critérios de aceite

  • Botão no Menu Infra Desk
  • Script CLI repetível em scripts/
  • Endpoint POST /openpanel/test-confirm
  • Multidomínio validado (2 contas / 2 domínios na plataforma)
  • Cleanup automático
  • Documentado como adendo Spec 028

Ficheiros

scripts/test-openpanel-multidomain-api.sh
api/app/vm123/openpanel_test.py
api/app/vm123/openpanel_client.py   # add_domain()
api/app/vm123/routes.py             # POST test-confirm
frontend/assets/app.js              # card Menu Infra

Referências