Cerebro Studio · Backlog · Changelog
Cerebro • /root/cerebro/docs/BACKLOG.md
Abrir Studio Selecione um BK para aprovar, delegar curadoria ou encaminhar.

Backlog Unificado

Projeto: Cerebro. Fonte principal: /root/cerebro/docs/BACKLOG.md.

Especificações Disponíveis (fora da fila pendente)

Detalhe do BK Selecionado

/root/cerebro/docs/backlog/BK-194-vps-ip-admin-codex-accounts.md • 2026-04-09T23:23:18.797Z

BK-194 - Admin global da VPS no Cerebro Studio

Criado em: 2026-04-06

Escopo: plataforma

Projetos afetados: cerebro-studio

Responsável: codex

Prioridade: alta

Status: done


1. Objetivo

Criar uma superficie administrativa global da VPS dentro do Cerebro Studio, exposta depois em /VPS/ no IP 72.60.252.173, para alternar a conta default e a conta fallback do Codex sem mexer em auth.json.

O MVP precisava:

  • funcionar em HTTP no inicio, sem depender de certificado pronto;
  • continuar suportando HTTPS depois, se o vhost do IP passar a entregar TLS;
  • usar login simples com cookie assinado;
  • ler e gravar as contas em /root/.config/codex/accounts.env;
  • respeitar a allowlist de contas vaszionx e esseeulembro.

2. Implementacao entregue

  • studio/server.js ganhou a rota /VPS/ e os endpoints GET /VPS/api/session, POST /VPS/api/login, POST /VPS/api/logout, GET|POST /VPS/api/accounts.
  • O acesso ao admin foi restrito a 72.60.252.173 e hosts locais/loopback; outros hosts retornam 404.
  • O login usa cookie assinado com TTL, sem persistencia de sessao em banco.
  • O cookie de sessao funciona em modo automatico:
  • em HTTP, nasce sem Secure;
  • em HTTPS, ou quando x-forwarded-proto=https, nasce com Secure;
  • VPS_ADMIN_COOKIE_SECURE continua podendo forcar o comportamento explicitamente.
  • O arquivo de contas e gravado de forma atomica, com rename() no mesmo diretorio e permissao 600.
  • A UI mostra os caminhos externos esperados para o runtime:
  • /root/.config/codex/vps-admin.env
  • /root/.config/codex/accounts.env
  • O painel nao toca em auth.json; so altera default/fallback.

3. Guardrails

  • Nao acoplar o admin global da VPS ao sigaautobot.
  • Nao criar novo backend separado sem necessidade.
  • Nao expor segredos em resposta ou log.
  • Nao usar Git pull automatico.
  • Nao mexer em Nginx neste BK.

4. Path List (lock-files)

```

/root/cerebro/docs/LOCK.md

/root/cerebro/docs/BACKLOG.md

/root/cerebro/docs/CHANGELOG.md

/root/cerebro/docs/backlog/BK-194-vps-ip-admin-codex-accounts.md

/root/cerebro/docs/changelog/2026/CL-2026-04-06-BK-194.md

/root/cerebro/studio/server.js

```


5. Referencias

  • /root/cerebro/studio/server.js
  • /root/cerebro/docs/BACKLOG.md
  • /root/cerebro/docs/CHANGELOG.md
  • /root/cerebro/docs/LOCK.md