Skip to content

Fase 5: painel embutível (API), DashboardHost e ferramenta psr (specs 007 e 009) - #5

Merged
net0well merged 7 commits into
mainfrom
fase-5/dashboard
Oct 20, 2026
Merged

net0well merged 7 commits into
mainfrom
fase-5/dashboard

Conversation

@net0well

@net0well net0well commented Oct 20, 2026 •

Copy link
Copy Markdown
Collaborator

Fase 5 — Painel embutível (API), DashboardHost e ferramenta psr (specs 007 e 009)

O que entra

PythonScriptRunner.Dashboard (novo pacote, estilo Hangfire)

  • AddDashboard(...) + app.MapPythonScriptRunnerDashboard("/psr"). Sem o Map, não existe painel.
  • API interna em {prefix}/api: catálogo (Stages e trilhas: rascunhos, validação, teste pela fila, publicação, arquivamento, exclusão, exportação/importação), execuções (lista keyset, detalhe, logs, cancelar, reprocessar), arquivos, visão geral, agendamentos (CRUD e prévia do cron), auditoria, segredos (só status), configurações e tipos de campo.
  • Disparos e testes aceitam multipart/form-data (inputs + arquivos, até 50 MB por arquivo e 200 MB por requisição; acima disso, 413 sem criar execução) ou JSON quando não há arquivos.
  • Erros em ProblemDetails com code, concorrência otimista com ETag/If-Match (412 com current, 428 sem If-Match) e cabeçalho X-PSR-Request: 1 obrigatório nas requisições que alteram algo (CSRF).
  • Hub SignalR {prefix}/hubs/runs (SubscribeRun, SubscribePipeline, SubscribeStage, SubscribeAll), alimentado por uma fila exclusiva por instância em psr.events; não precisa de backplane.
  • Modos de acesso (um principal, ADR-0021):
    • login fixo: usuários e papéis na configuração, senha só como hash PBKDF2, cookie psr.session (8 h deslizantes, no máximo 24 h), bloqueio de 15 min após 5 falhas, 10 tentativas/min por IP, recarga sem reinício e chaves do cookie em psr.dashboard_keys;
    • filtro próprio (IDashboardAuthorizationFilter);
    • autenticação do host (políticas para os 4 papéis);
    • somente local, apenas em Development.
  • Papéis cumulativos Reader → Executor → Author → Admin em todos os endpoints. Ações e logins são auditados com o usuário do painel.
  • Página provisória do painel com <base href> do prefixo e CSP. A interface Vue entra na Fase 6.
  • OpenAPI interno só em Development ({prefix}/api/openapi/v1.json), fora dos documentos do host.

hosts/PythonScriptRunner.DashboardHost

  • Login fixo por padrão, com usuários por variáveis de ambiente.
  • OIDC opcional (Oidc__Authority, Oidc__ClientId, Oidc__ClientSecret), com claims de papel configuráveis.
  • Dashboard__PathPrefix, health checks e PSR_AUTO_MIGRATE.
  • Sem usuários e sem OIDC, a inicialização falha com uma mensagem clara.

PythonScriptRunner.Tool (7º pacote): dotnet tool psr com o comando psr hash-password, que lê a senha sem eco ou de --stdin.

Testes

O novo projeto tests/PythonScriptRunner.Dashboard.Tests (WebApplicationFactory/TestServer + Testcontainers) cobre:

  • spec 007: AC-1 a AC-25;
  • spec 009: AC-9 a AC-11.

Destaques:

  • matriz endpoint × papel nos modos login fixo e autenticação do host;
  • tempo simulado para bloqueio e sessão;
  • duas instâncias para a sessão compartilhada e para o tempo real;
  • desempenho com ~200 mil execuções em 90 dias (p95 local: /runs 10 ms, /runs/{id} 24 ms, /stages 12 ms, /overview 95 ms);
  • snapshot do OpenAPI.

O CS-2 pelo painel (weasyprint) roda só no Linux, como na Fase 4.

Observações

  • O snapshot do OpenAPI (AC-15) é comparado por um helper próprio (Snapshots/openapi-v1.verified.json; PSR_ACCEPT_SNAPSHOTS=1 aceita uma mudança revisada), em vez do Verify (D-137).
  • O teste da spec 006 AC-8 (Fase 4) passou a medir o pico real de processos simultâneos; a métrica antiga contava sobreposições indiretas e falhou no CI sem o limite ter sido violado.

🤖 Generated with Claude Code

net0well and others added 7 commits October 20, 2026 14:05
…chaves do painel (spec 007)

- Abstractions: IDs fortes, enums, FieldDefinition e BindingSource serializados no formato das
  specs (sem alterar opções JSON do host); FieldDefinitionJson e FieldCompatibility públicos.
- ICatalogAdmin: EnqueueStageDraftTestAsync/EnqueuePipelineDraftTestAsync (D-114); filtro por status
  nas listas; auditoria filtrável por ação e chave; ações LoginSucceeded/LoggedOut/UserLocked.
- Agendamentos: códigos INVALID_CRON e INVALID_TIME_ZONE (spec 007) e SchedulePreview público.
- Migration DashboardKeys: tabela psr.dashboard_keys para as chaves do cookie do login fixo (D-132).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…o configurável (spec 007)

- AddDashboard + MapPythonScriptRunnerDashboard(prefixo): API em {prefixo}/api,
  hub SignalR em {prefixo}/hubs/runs e página provisória com <base href> e CSP.
- Modos de acesso (ADR-0021): login fixo (hash PBKDF2, cookie psr.session 8 h/24 h,
  bloqueio 5 falhas/15 min, 10 tentativas/min por IP, recarga sem reinício, chaves em
  psr.dashboard_keys), filtro próprio, autenticação do host e somente local (Development).
- Papéis cumulativos por política, 401/403 em JSON só nos endpoints do painel,
  CSRF por X-PSR-Request, ETag/If-Match, ProblemDetails com code.
- Disparos e testes por multipart (50 MB por arquivo, 200 MB por requisição, 413) ou JSON;
  auditoria de disparos e logins; visão geral; OpenAPI interno só em Development.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…sword (spec 009)

- DashboardHost: login fixo por padrão com usuários por variáveis de ambiente; OIDC
  opcional (Oidc__Authority/ClientId/ClientSecret, cookie + PKCE, papéis por
  Dashboard__RoleClaim e Dashboard__Roles__*); a SPA é desafiada e a API responde 401.
  Sem usuários e sem OIDC a inicialização falha com mensagem clara. Dashboard__PathPrefix,
  health checks de banco e broker, PSR_AUTO_MIGRATE.
- PythonScriptRunner.Tool (7º pacote): dotnet tool `psr`; `psr hash-password` lê a senha
  sem eco (duas vezes) ou de --stdin e imprime o hash PBKDF2 do ASP.NET Identity v3.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Projeto PythonScriptRunner.Dashboard.Tests (TestServer/WebApplicationFactory +
  Testcontainers), reaproveitando por link a infraestrutura dos testes do worker.
- Spec 007 AC-1..AC-25: configuração inválida, matriz endpoint × papel (login fixo e host),
  CSRF, 412/428, sintaxe 422, upload/download e 413, keyset, 410, tempo real em duas
  instâncias (≤ 1 s), auditoria, desempenho com ~200 mil execuções (opt-in completo por
  PSR_PERF_RUNS_PER_DAY), prefixo customizado, snapshot do OpenAPI, segredos, login fixo
  (sessão, bloqueio, 429, recarga, chaves compartilhadas), filtro, localhost e visão geral.
- Spec 009 AC-9..AC-11: DashboardHost com login fixo e com OIDC; psr hash-password.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…OpenAPI igual em todo SO (spec 007)

- Partes de arquivo com "text/html; charset=utf-8" eram recusadas pelo contrato
  (contentTypes compara o tipo de mídia); o painel passa só o tipo de mídia.
- O documento OpenAPI servido normaliza fins de linha nas descrições.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…o OpenAPI (specs 006, 007)

- Spec 006 AC-8 contava sobreposições por tentativa (A cruza B e C mesmo quando B e C
  não rodam juntas); agora mede o pico simultâneo com varredura no tempo.
- O snapshot é localizado pela raiz do clone (builds determinísticos mapeiam o caminho
  do fonte para /_/) e a falha mostra as primeiras linhas diferentes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@net0well
net0well merged commit 9186beb into main Oct 20, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant