Escopo do MVP
Este documento registra o que foi implementado, como validar e o que ainda não está coberto, conectando os critérios de aceite ao código atual.
Tese entregue
O Reqlivo MVP demonstra que é possível ter um cliente HTTP útil, local e sem conta, com:
- projeto em arquivo legível e versionável;
- CLI e interface desktop sobre o mesmo modelo Rust;
- execução HTTP previsível e observável, com prévia incremental no envio interativo;
- ambientes, variáveis, auth e scripts;
- runner com relatório e hash determinístico;
- importação/exportação com relatório de perdas;
- segredos por referência, redaction, offline real e acessibilidade de teclado no fluxo principal.
O produto não tenta ser um substituto completo de Insomnia/Bruno nesta fase.
Dentro do MVP implementado
| Área | Entrega |
|---|---|
| Projeto | OpenCollection 1.0.0, manifesto, pastas, requisições, tags, docs e settings. |
| HTTP | Métodos, query/path, headers, JSON/texto/XML/SPARQL, form-urlencoded e multipart. |
| Resposta | Status, headers, corpo, tempo, tamanho, URL final, redirects, truncamento e prévia incremental no envio interativo. |
| Ambientes | Herança extends, ambiente padrão, precedência e edição pela UI/CLI. |
| Auth | Basic, Bearer, API key (header/query) e herança de pasta/coleção. |
| Scripts | Pré, pós e testes em QuickJS, com timeout, limites e rq.*. |
| Testes | test/expect e asserções declarativas. |
| Runner | Filtros, status, relatório, logs, histórico, cancelamento e hash determinístico. |
| Importação | cURL, Postman v2.1 (subconjunto), OpenCollection (arquivo/diretório). |
| Exportação | cURL, Postman, OpenCollection bundled e projeto sanitizado. |
| Segurança | Segredo por provider: env, redaction em logs/relatórios/exportações, IPC local. |
| Persistência | Rascunhos versionados, reconciliação de alterações externas, lixeira restaurável e migração com rollback. |
| Offline | Bloqueio de destinos externos e de redirects externos. |
| Acessibilidade | Foco visível, navegação por teclado na árvore, atalhos e diálogos nativos. |
Fora do MVP
- gRPC, WebSocket, SSE, Socket.IO e MCP.
- OAuth2 completo, certificados/client certificates e proxy configurável.
- Git integrado, sync, colaboração, contas e nuvem.
- Mock server, OpenAPI/Swagger/HAR/WSDL completos.
- Plugins de terceiros, IA e temas avançados.
- Insomnia v4/v5 como formato de importação nativo.
- Execução de scripts
pm.*do Postman. - Streaming no runner/CLI e progresso de upload; a prévia incremental existe apenas no envio interativo da interface.
Critérios de aceite
Legenda: Entregue = há implementação e teste automatizado ou validação manual registrada; Parcial = o fluxo principal funciona, mas falta uma parte observável; Fora = não pertence ao MVP.
| Critério | Status | Evidência/observação |
|---|---|---|
| AC-01 — primeiro uso sem conta | Parcial | Coleção inicial e IPC implementados; validação interativa nas plataformas ainda pendente. |
| AC-02 — HTTP 200 | Entregue | http_success_metadata_assertions_and_scripts. |
| AC-03 — HTTP 404 | Entregue | no_tests_is_executed_not_passed_and_404_is_preserved. |
| AC-04 — erro de rede | Entregue | connection_error_is_classified_without_panicking. |
| AC-05 — variável ausente | Entregue | Resolver retorna Variable com nome/escopo; UI mostra o erro. |
| AC-06 — precedência | Entregue | variable_precedence_request_then_folder_then_environment. |
| AC-07 — herança de auth | Entregue | auth_inherits_from_folder_and_redacts_secret_values. |
| AC-08 — segredo não aparece | Entregue | Teste de auth verifica ausência no JSON; logs/exportações redigem. |
| AC-09 — script com timeout | Entregue | script_timeout_is_enforced (loop infinito interrompido). |
| AC-10 — teste falhando | Entregue | Status failed, esperado/obtido no relatório. |
| AC-11 — 404 sem teste | Entregue | Status executed, HTTP 404 visível. |
| AC-12 — runner determinístico | Entregue | deterministic_hash_is_stable_across_runs. |
| AC-13 — persistência/reabertura | Entregue | Store lê/grava YAML; testes de importação/projeto reabrem a coleção. |
| AC-14 — rascunho não salvo | Parcial | Autosave, recuperação, órfãos e guardião implementados e testados no núcleo/IPC, em fluxos headless e em D-02/D-03 na WebView real; matriz manual no Windows pendente. |
| AC-15 — edição externa | Parcial | Hash/geração, recarga assistida, conflito 409 e comparação com o disco; a UI consulta ao focar/ficar visível, sem watcher nativo. D-04/D-05/D-07/D-08 cobrem a WebView real; Windows pendente. |
| AC-16 — importação com perdas | Entregue | Relatório de contagem/avisos/perdas; scripts Postman não executam. |
| AC-17 — exportação segura | Entregue | Auth/headers/query/variáveis sensíveis literais omitidos; projeto sanitizado; conteúdo da lixeira não é exportado. |
| AC-18 — modo offline | Entregue | Bloqueio antes da conexão e em redirects; testes de offline. |
| AC-19 — migração | Parcial | Inspeção, confirmação, backup, hashes, rollback e recuperação implementados/testados no núcleo, CLI, IPC e D-11 na WebView real; bloqueio de edição posterior e matriz visual no Windows pendentes. |
| AC-20 — acessibilidade | Parcial | Fluxo principal por teclado; foco visível; árvore com setas/Home/End; diálogos auditados em headless (incluindo aria-live) e em D-09 na WebView real (foco, Tab e Escape); sem leitor de tela real ou conformidade WCAG. |
| AC-21 — resposta grande | Parcial | Limite configurável, prévia binária e progresso incremental no envio interativo; runner/CLI seguem bufferizados. |
| AC-22 — CLI consistente | Entregue | Mesmo modelo; run/send retornam códigos coerentes. |
Verificação automatizada
cargo test
A suíte do núcleo cobre:
- metadados HTTP, 404 “executado”, erro de conexão;
- precedência de variáveis, auth herdada e redaction de segredo;
- hash determinístico e timeout de script;
- bloqueio offline e redirect externo;
- importação/exportação cURL, Postman, OpenCollection e projeto;
- sanitização de credenciais na exportação;
- ambiente padrão em
execute_single; - API do servidor, incluindo validação e cancelamento de envio com ID do cliente;
- rascunhos: roundtrip sem tocar no YAML, gerações, conflitos, isolamento por coleção, órfãos, corrupção/versão futura e segredo resolvido ausente;
- alterações externas: detecção por geração, conflito de recarga e revisão esperada;
- lixeira: bytes/ID, pasta vazia, destino ocupado, hash/symlink, legado, ID duplicado e restauração interrompida;
- migração: inspeção sem escrita, reuso de plano, backup/hashes, falha/interrupção, schema futuro, rollback e bloqueio de edições;
- interface headless (teste, não produto): reabertura de rascunho, guardião, autosave e falha, criação/movimento/rename/remoção externos, comparação e aplicação, YAML inválido, salvar sem recarga, cursor antigo, ID duplicado, manifesto alterado, foco/teclado e renderização incremental com substituição pela resposta final;
- progresso de resposta: ordem headers → chunks, primeiro bloco antes da conclusão, UTF-8 dividido entre blocos, truncamento no limite e cancelamento após o primeiro bloco.
Validação automatizada no desktop real (Linux)
O script desktop-acceptance.mjs executa o binário de release em WebKitGTK real, via tauri-driver, com coleções temporárias e servidor sintético. Em 2026-10-27, os 11 casos D-01 a D-11 passaram (HTTP 200/404, autosave e reinício, guardião, alteração externa/comparação, YAML inválido, lixeira, manifesto, cursor antigo, foco/Tab/Escape, cancelamento e migração/rollback). O benchmark de 1.000 requisições mediu changes em ~12–13 ms, abertura/recarga em ~137–143 ms e snapshot/tree abaixo de 1 ms. Evidências: desktop e benchmark. Isso não cobre Windows, leitor de tela/WCAG, instalação limpa, seleção de pasta por diálogo nativo, importação/exportação por diálogo nem fechamento com rascunho.
Para a 0.4.0, o caso D-12 de resposta incremental foi adicionado ao mesmo script, mas não foi executado: o ambiente local não possui WebKitWebDriver. A validação da versão ficou restrita ao núcleo/IPC, ao build de release e ao renderer no Chrome headless (S-01). A release foi publicada em 2026-11-02 na tag v0.4.0, com instaladores Linux/Windows e SHA256SUMS; o workflow remoto passou em ubuntu-22.04 e windows-latest. Consulte as notas da 0.4.0.
Validação manual da demonstração
- Suba
examples/servidor_demo.py. - Rode
reqlivo --collection examples/demo validate. - Rode
run --env deve confira 3 requisições, 3 passagens e hash determinístico. - Rode
run --env segurocomREQLIVO_DEMO_TOKENdefinido e confira que o valor não aparece. - Abra
npm run desktop:dev -- -- --collection examples/demoe execute (roteiro manual complementar; D-01 a D-11 já foram automatizados no Linux):- abrir uma requisição;
- enviar e ver status/tempo/tamanho;
- abrir testes e logs;
- abrir ambientes e conferir o badge do segredo;
- abrir configurações e o runner;
- usar Validar e conferir “Coleção válida”;
- cancelar um envio lento (por exemplo, alterar a URL para
/delay); - navegar pela árvore apenas com teclado.
Próximos passos sugeridos
- Executar D-12 no desktop real assim que
WebKitWebDriverestiver disponível e validar a 0.4.0 no Windows; a matriz D-01 a D-11 da 0.3.0 continua sendo a última execução completa em WebView real. - Executar a matriz manual no Windows e os itens nativos restantes no Linux (seleção de pasta, importação/exportação por diálogo e fechamento com rascunho); a 0.4.0 já tem instaladores publicados, mas não houve instalação manual em máquina limpa.
- O benchmark de 1.000 requisições foi executado; decidir se um watcher nativo é necessário. O polling atual mediu ~12–13 ms por consulta e atende ao prazo de três segundos nesta medição.
- Levar o progresso de resposta ao runner/CLI e adicionar progresso de upload (AC-21).
- Ampliar importação (OpenAPI/HAR) e tradução de scripts Postman.
- Adicionar OAuth2, certificados e proxy como evolução pós-MVP.
- Realizar auditoria com leitor de tela/WCAG e validar manualmente a instalação em máquinas limpas; a matriz Linux automatizada e o benchmark já foram executados.