Fluxo no espírito do TortoiseSVN, design repaginado e os projetos e o servidor da equipe já pré-configurados.
Recursos · Telas · Instalação · Desenvolvimento · Arquitetura · Configuração · Atalhos · Problemas comuns
Subversa é um aplicativo de desktop para Linux que cobre todo o ciclo de trabalho em Subversion sem decorar comandos: detectar working copies, revisar e commitar alterações, criar e trocar branches, receber a linha principal, publicar (reintegrar), navegar pelo repositório, ler o histórico em lista ou em grafo e resolver conflitos num editor de três painéis.
Ele nasceu do GUIA_SVN.md e do fluxo_svn.sh da equipe e segue as mesmas regras: a mesma sequência de passos, a mesma convenção de branch (ISSUES <ano>/<NN - MÊS>/…), a mesma autenticação (svn+ssh com sshpass + ControlMaster) e os mesmos projetos prontos (sna, getran, getran160, trrenavam, sutil, sutil160).
Note
Por que não Git? O versionamento da equipe é SVN, e o Subversa abraça o modelo do SVN de verdade: não existe push (o svn commit já vai para o servidor), uma branch é uma cópia de diretório e trocar de branch é svn switch.
|
|
As imagens abaixo são geradas automaticamente a partir dos dados fictícios do mock de testes (
npm run docs:screenshots) — nenhum dado do servidor real.
Revise cada arquivo, escolha o que entra no commit e reverta só o trecho que não deveria ir.
| Histórico | Gráfico do projeto |
|---|---|
![]() |
![]() |
| Entrada (a receber) | Registro de comandos |
![]() |
![]() |
| Branches | Integração (sync / reintegrar) |
|---|---|
![]() |
![]() |
| Conflitos em 3 painéis | Editor de código |
|---|---|
![]() |
![]() |
| Navegador de repositórios | Pontos de restauração |
|---|---|
![]() |
![]() |
| Paleta de comandos | Configurações |
![]() |
![]() |
| No Git você faz… | No SVN é… | No Subversa |
|---|---|---|
git clone |
svn checkout |
Baixar projeto (preset ou URL) |
git pull |
svn update |
Botão Atualizar |
git stash |
— (não existe) | Guardar para depois |
| criar branch | svn copy + svn switch |
Criar branch (convenção ISSUES … automática) |
add + commit + push |
svn commit |
Aba Alterações (um passo só) |
| trazer a main para a branch | svn merge <trunk> + commit |
Integração → Receber e commitar |
| merge da branch na main | switch + update + merge + commit |
Integração → Publicar branch no trunk |
| apagar branch | svn delete <url> |
Branches → apagar (digitando o nome) |
O ciclo de vida de uma tarefa fica assim:
flowchart LR
A[Baixar projeto<br/><i>checkout do trunk</i>] --> B[Criar branch<br/><i>ISSUES ano/mês/issue</i>]
B --> C[Trabalhar e<br/>commitar na branch]
C --> D{O trunk andou?}
D -- sim --> E[Sync<br/><i>trunk → branch</i>]
E --> C
D -- não --> F[Publicar<br/><i>switch → update → merge</i>]
F --> G[Revisar em Alterações<br/>e commitar = publicar]
G --> H[Apagar a branch]
Important
Na publicação o Subversa não commita sozinho: ele faz o merge e te leva para a aba Alterações. O commit é a publicação — você revisa antes.
| Requisito | Para quê |
|---|---|
svn 1.8+ (testado com 1.14) |
todas as operações |
openssh-client |
transporte svn+ssh |
sshpass (opcional) |
autenticar por senha via $SSHPASS |
O pacote .deb já declara essas dependências, então o apt as instala junto:
sudo apt install ./Subversa_1.0.0_amd64.debA senha vem de $SSHPASS (por exemplo, em /etc/environment) ou de uma chave SSH/ssh-agent configurada no servidor. Na primeira execução uma tela de configuração pede o host SSH.
Note
Distribuição manual: não há auto-updater nem assinatura de binário. Atualizar = gerar e distribuir um novo pacote.
São duas categorias de dependência: toolchains (Node + Rust), geridas pelo mise, e bibliotecas de sistema do Tauri, que vêm do apt.
# 1. Bibliotecas de sistema + runtime (Ubuntu/Debian)
sudo apt install -y libwebkit2gtk-4.1-dev libsoup-3.0-dev build-essential \
libssl-dev libgtk-3-dev librsvg2-dev libayatana-appindicator3-dev \
subversion sshpass
# 2. Toolchains fixadas no mise.toml (Node 20.20.2 + Rust 1.96.0, com clippy e rustfmt)
mise trust && mise install
# 3. Dependências e app em modo dev (Vite com HMR + backend Rust em debug)
npm install
npm run tauri devTip
Sem mise, instale Node 20+ (nvm) e Rust stable ≥ 1.77 (rustup). Com mise, há atalhos: mise run dev, mise run build e mise run check.
Janela em branco no X11? Rode com WEBKIT_DISABLE_DMABUF_RENDERER=1 WEBKIT_DISABLE_COMPOSITING_MODE=1 npm run tauri dev.
| Comando | O que faz |
|---|---|
npm run tauri dev |
app completo em desenvolvimento |
npm run dev |
só o frontend (Vite em :1420, sem backend nativo) |
npm run check |
typecheck + build + Vitest + cargo fmt + clippy -D warnings + cargo test |
npm run test:unit |
testes unitários do frontend (Vitest) |
npm run e2e |
testes visuais com Playwright e IPC do Tauri mockado |
npm run e2e:update |
regenera os screenshots-baseline do e2e |
npm run docs:screenshots |
regenera as imagens deste README |
npm run tauri build |
binário de produção + pacotes (.deb, AppImage) |
npm run tauri build -- --bundles deb |
só o .deb |
Os artefatos saem em src-tauri/target/release/ (binário subversa) e src-tauri/target/release/bundle/.
- Frontend: TypeScript estrito (variáveis e parâmetros sem uso quebram o build) e Vitest para a lógica pura (parser de diff, diff3, grafo, busca do editor, indentação…).
- Backend:
cargo fmt --check,cargo clippy -D warningsecargo test(parser XML, reconstrução de hunks, validação de URL/caminho, codificação, cancelamento). - E2E: Playwright no Chrome do sistema dirigindo o frontend real com o IPC do Tauri mockado (
e2e/mock/tauri.ts) — asserts de conteúdo + regressão visual por screenshot. - CI (GitHub Actions): tudo acima + geração do
.deb.
O frontend nunca executa o svn. Ele chama comandos Tauri via invoke(); o backend Rust monta os argumentos, injeta a autenticação SSH, executa o svn, interpreta a saída --xml e devolve dados tipados.
flowchart LR
subgraph UI["Frontend · React 19 + TypeScript"]
V[Views] --> H[hooks/useActions]
H --> API[lib/api.ts<br/>invoke tipado]
V --> S[(stores zustand)]
end
subgraph Core["Backend · Rust / Tauri v2"]
CMD[commands.rs] --> RUN[runner.rs<br/>timeout · limite · cancelamento]
RUN --> CONN[conn.rs<br/>SVN_SSH + ControlMaster]
RUN --> AUD[audit.rs<br/>registro]
CMD --> PAR[parser.rs<br/>XML → structs]
CMD --> SAFE[backup · undo · shelf]
end
API -- IPC --> CMD
CONN --> SVN[[svn]] --> SRV[(servidor svn+ssh)]
Princípios que guiam o código:
- Saída
--xmle códigos de erro, nunca texto traduzido. Osvncontinua em português; a robustez vem do XML (independente de idioma) e de códigos comoE155011,E160013,E200007, mapeados para dicas amigáveis. - Operações longas transmitem progresso e podem ser canceladas; todo comando é registrado e tem limite de tempo e de tamanho de saída.
- Tema por variáveis CSS em tempo de execução (Tailwind v4
@theme), com as cores de status dofluxo_svn.sh: M âmbar, A verde, D vermelho, ? roxo, C vermelho forte.
| Camada | Stack |
|---|---|
| Desktop / backend | Tauri v2, Rust, Tokio, quick-xml + serde |
| Frontend | React 19, TypeScript, Vite 7, Tailwind CSS v4 |
| Estado e UI | Zustand, Framer Motion, Lucide |
| Editores | CodeMirror 6, Prettier (Java, XML, SQL…), jsdiff |
| Testes | Vitest, Playwright, cargo test |
Detalhes em docs/ARQUITETURA.md.
Estrutura de pastas
src/ frontend React
views/ uma tela por aba (Alterações, Histórico, Gráfico, …)
components/ ui, layout, diff, editor, merge, history, repos, dialogs…
hooks/ ações de alto nível (confirmação + toast + refresh)
store/ estado global (zustand)
lib/ api tipada, tipos e motores puros com testes
src-tauri/src/
svn/ comandos, runner, parser, conexão, backup, undo, shelf…
config.rs leitura/gravação atômica da configuração
e2e/ testes Playwright + mock do IPC + roteiro das imagens do README
docs/ arquitetura, imagens e base de aprendizado (docs/learning)
Na primeira execução é criado ~/.config/subversa/config.json. Tudo é editável na aba Configurações:
| Opção | Descrição |
|---|---|
| Pasta de trabalho | onde ficam as working copies (detecção automática) |
| Host SSH e URL base | servidor svn+ssh e raízes de repositório conhecidas |
| Modo de autenticação | auto, chave ou senha |
| Meus projetos | atalhos de checkout e URL da linha principal (usada no sync/reintegração e para reconhecer trunk × branch) |
| Backups | perguntar, sempre ou nunca; quantos manter por working copy |
| Preferências | confirmar operações no servidor, modo verboso (mostra o comando svn), ferramenta de diff externa (meld), editor externo, tema |
Reproduz a estratégia do fluxo_svn.sh: a variável SVN_SSH usa sshpass -e ssh … (lendo $SSHPASS) quando há senha, ou ssh puro com chave; e um ControlMaster persistente (~/.cache/subversa/ssh/) evita pedir a senha a cada comando. A conexão mestre é encerrada quando a janela fecha.
| Caminho | Conteúdo |
|---|---|
~/.config/subversa/config.json |
configuração |
~/.local/share/subversa/shelves |
itens de "guardar para depois" |
~/.cache/subversa/backups |
pontos de restauração (padrão) |
~/.cache/subversa/ssh/ |
socket do ControlMaster |
~/.cache/subversa/crash.log |
log em caso de crash |
|
Gerais
Editor de conflitos
|
Editor de código
|
- Operações que escrevem no servidor (commit, merge, switch, copy, delete) pedem confirmação (configurável).
- Commitar direto no trunk mostra um aviso destacado; apagar branch no servidor exige digitar o nome.
- O backend só aceita operações remotas nas localizações cadastradas (
repoRoots) ou nas URLs dos projetos configurados. - Checkouts e exports só gravam em caminhos absolutos dentro da pasta de trabalho; imports exigem uma pasta local existente.
- Saídas grandes do
svnsão limitadas para proteger a interface: 20 MiB para diff/log/status/list/info, 5 MiB para prévia de arquivo e 10 MiB para blame. - Nomes com
@são escapados corretamente (sem confusão com revisão-peg do SVN).
| Sintoma | O que fazer |
|---|---|
| "Falha de conexão / rede fechou" | verifique VPN/rede e o acesso SSH ao servidor |
| Pede senha o tempo todo | garanta $SSHPASS no ambiente ou uma chave SSH; instale o sshpass |
E155004 (locked) |
Limpar / destravar (cleanup) na paleta de comandos |
E155011 / E160024 (desatualizado) |
Atualizar antes de commitar |
Conflito (C) |
aba Alterações → Resolver conflito |
E200007 (sem mergeinfo) |
nada: o app cai para o merge clássico sozinho; o Gráfico fica sem as setas de merge |
meld não abre no AppImage |
já tratado: o app limpa o ambiente do AppImage antes de abrir programas externos |
| Janela em branco no Linux | rode com WEBKIT_DISABLE_DMABUF_RENDERER=1 |
- Código, interface, comentários e mensagens em português do Brasil.
- Commits no padrão Conventional Commits com tipo em inglês e assunto em pt-BR no presente:
fix(merge): aceita working copy de revisão mista. - Antes de abrir PR:
npm run checkenpm run e2e. Um comando novo no backend precisa de stub eme2e/mock/tauri.ts. - Mudou uma tela que aparece aqui? Rode
npm run docs:screenshots. - Instruções para agentes de IA em
AGENTS.md; aprendizados do projeto emLEARNING.md.
Projeto interno e proprietário (UNLICENSED), feito sob medida para o fluxo da equipe. Sem licença pública de distribuição.













