Repository navigation
Fase 5: painel embutível (API), DashboardHost e ferramenta psr (specs 007 e 009) - #5
Merged
Merged
Conversation
…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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 oMap, não existe painel.{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.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.ProblemDetailscomcode, concorrência otimista comETag/If-Match(412 comcurrent, 428 semIf-Match) e cabeçalhoX-PSR-Request: 1obrigatório nas requisições que alteram algo (CSRF).{prefix}/hubs/runs(SubscribeRun,SubscribePipeline,SubscribeStage,SubscribeAll), alimentado por uma fila exclusiva por instância empsr.events; não precisa de backplane.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 empsr.dashboard_keys;IDashboardAuthorizationFilter);<base href>do prefixo e CSP. A interface Vue entra na Fase 6.{prefix}/api/openapi/v1.json), fora dos documentos do host.hosts/PythonScriptRunner.DashboardHostOidc__Authority,Oidc__ClientId,Oidc__ClientSecret), com claims de papel configuráveis.Dashboard__PathPrefix, health checks ePSR_AUTO_MIGRATE.PythonScriptRunner.Tool(7º pacote): dotnet toolpsrcom o comandopsr hash-password, que lê a senha sem eco ou de--stdin.Testes
O novo projeto
tests/PythonScriptRunner.Dashboard.Tests(WebApplicationFactory/TestServer + Testcontainers) cobre:Destaques:
/runs10 ms,/runs/{id}24 ms,/stages12 ms,/overview95 ms);O CS-2 pelo painel (weasyprint) roda só no Linux, como na Fase 4.
Observações
Snapshots/openapi-v1.verified.json;PSR_ACCEPT_SNAPSHOTS=1aceita uma mudança revisada), em vez do Verify (D-137).🤖 Generated with Claude Code