SVOSoftware - Verificação & Operação🏠Passo a passoComo medirOrçamentoPedidoTeste grátisFalar sobre o meu escopoEnglish

Como medir o seu sistema antes de pedir orçamento.

O tamanho define a faixa de preço, e quem mede é você. O medidor é um script Python de leitura: baixe, rode na sua máquina e nos mande só os números.

o que o medidor faz, e onde ele para ver
· você pode ler o código antes de rodar — é um arquivo, sem dependências
· roda inteiro na sua máquina: o arquivo não tem uma única chamada de rede, e você pode conferir
· lê o seu código e escreve dois arquivos SEUS: o `escopo.txt`, para você editar, e o manifesto da medição
· conta o que existe; o preço vem depois, numa conversa
· o envio é seu, no último passo, e só do manifesto — o medidor mesmo não manda nada

Antes de começar

O projeto a ser auditado pode estar em qualquer lugar do seu computador — inclusive num pendrive. Você passa o caminho dele para o medidor, e ele lê ali mesmo.

Prefere apontar para uma cópia do projeto? ver

Se preferir, copie o projeto para outra pasta e aponte para a cópia — assim você tem a certeza de que o original fica intacto. O seu código nunca é alterado: o medidor lê o projeto e escreve apenas o `escopo.txt` e o manifesto; a auditoria lê o projeto e escreve apenas dentro da pasta dela — e isso está no código, aberto, para você conferir.

O que você aponta é o que será auditado. Se faltar uma pasta, o relatório não vai dizer "faltou": ele simplesmente não olha, e você recebe uma auditoria menor achando que recebeu a inteira. Aponte para o projeto inteiro — é isso que faz o preço, o escopo e a auditoria falarem todos da mesma árvore.

Passo 01

Confira se o Python está instalado. ver como

No terminal, rode o comando abaixo. Se responder Python 3.alguma coisa, está pronto. Testado em 3.11.

Windows     python --version
Windows     py --version      (se o de cima abrir a Microsoft Store)
Linux/macOS  python3 --version

Não tem? Instale em python.org/downloads. No Windows, marque "Add Python to PATH" na primeira tela do instalador — sem isso o comando python não é encontrado depois.

Passo 02

Crie a pasta da auditoria e baixe o medidor. ver como

É a gaveta da auditoria: o medidor fica aqui, e é para cá que você vai copiar o kit da auditoria depois. Pode ser qualquer lugar; este é apenas o que sugerimos.

Windows     mkdir C:\auditoria
Linux/macOS  mkdir ~/auditoria

Baixe o medir.py no botão abaixo e salve nesta pasta. O seu projeto pode ficar onde já está — você passa o caminho dele para o medidor.

O navegador salva na pasta de Downloads. Mova o arquivo para a pasta que você acabou de criar — é lá que ele precisa estar.

Prefere pelo terminal? Estando já dentro da pasta:

curl -L -O https://svo.com.br/medir.py

Prefere ler antes de baixar? O arquivo abre direto no navegador: medir.py

Passo 03

Abra o terminal nessa pasta. ver como

Windows: abra a pasta no Explorador, clique na barra de endereço, digite powershell e tecle Enter.

Linux / macOS: abra o terminal e entre na pasta.

cd ~/auditoria

Passo 04

Execute a medição pelo terminal. ver como

Passe o caminho do projeto que você quer auditar — ele pode estar em qualquer pasta do computador.

O medidor reconhece sozinho o que não é código seu — bibliotecas conhecidas, código gerado, arquivos duplicados, dados e pastas com cara de backup — e desconta tudo isso automaticamente. Na primeira execução ele grava um único arquivo na pasta, escopo.txt, para você acrescentar o que ele não adivinha — veja no passo seguinte.

Ao executar o medir.py ele gera um arquivo manifesto.json, que contém nomes de arquivo e contagens — nunca o conteúdo do seu código. Abra e confira antes de enviar; é JSON legível.

Quer auditar só um módulo? Aponte um arquivo.

Em vez da pasta, passe um arquivo do módulo que interessa (a emissão de boletos, o fechamento, a tela de pedidos). O medidor monta o recorte: quem usa esse arquivo, o que ele usa e o que esses também usam — e mostra as sequências de funcionamento inteiras, do começo ao fim.

Windows     python medir.py --lang pt --raiz C:\auditoria\meuprojeto --path C:\auditoria\meuprojeto\modulo\arquivo.php
Linux/macOS  python3 medir.py --lang pt --raiz ~/auditoria/meuprojeto --path ~/auditoria/meuprojeto/modulo/arquivo.php

Ele também informa o tamanho do repositório inteiro ao lado do recorte. Sem esse segundo número, um recorte pequeno seria indistinguível de um sistema pequeno.

Windowspython medir.py --lang pt --path C:\auditoria\meuprojeto
Linux/macOSpython3 medir.py --lang pt --path ~/auditoria/meuprojeto

Passo 05

Leia a saída — principalmente o bloco das exclusões. ver como

O medidor separa o que é código seu do que não é, e mostra cada desconto com o número na frente: dados, bibliotecas de terceiro, código gerado, cópias idênticas e pastas com cara de backup. Nada sai da conta em silêncio.

🔴 Confira a lista de pastas excluídas, uma a uma. Pasta excluída não fica só mais barata — ela não é auditada, e nenhum problema de dentro dela será reportado. Excluímos por padrão para não cobrar por código morto. Se alguma delas ainda estiver publicada ou em uso, escreva !nome-da-pasta/ no escopo.txt (o ! reinclui) e rode de novo.

Por que insistimos: num sistema real que auditamos, a cópia antiga esquecida tinha menos proteção que a produção — e era por ela que se entrava.

Quer tirar mais alguma coisa? O escopo.txt é seu.

O medidor já descontou sozinho biblioteca, gerado, duplicado, dado e backup. O escopo.txt começa vazio e é onde você acrescenta o que ele não adivinha, com uma regra simples: a barra no fim indica pasta. saida_gerada/ tira toda pasta com esse nome, onde estiver; src/legacy/ tira só aquela; *.min.js casa arquivos; e !pasta/ reinclui algo que o medidor excluiria. Depois é só rodar de novo.

🔴 Vale a mesma regra: o que sai da conta sai da auditoria. O que você excluir não será olhado, e nenhum problema lá dentro será reportado. O medidor imprime a sua lista na tela e a grava no manifesto — para o relatório poder declarar o que ficou de fora. E se você escrever um caminho que não existe, ele avisa: caminho errado em silêncio seria indistinguível de ter funcionado.

🔴 Editou o escopo.txt? Rode o medidor de novo. O manifesto.json só muda quando o medidor roda — enviar o manifesto antigo faz o orçamento sair pelo escopo anterior.

Passo 06

Envie a medição.

Nome, e-mail e o manifesto.json que a medição gerou — ele leva o tamanho do projeto. A medição fica registrada, com número, no mesmo instante, e você recebe o orçamento do nível que pediu: ONE, Deep ou os dois. Com ele em mãos, você faz o pedido.

O manifesto leva nomes de arquivo e contagens — nunca o conteúdo do seu código. Abra e confira antes de enviar; é JSON legível.

ONE ou Deep? Saber mais ver

ONE — um agente procura e ele mesmo julga cada apontamento contra o código. Deep — vários agentes procuram em paralelo e outros agentes julgam, sem terem participado da descoberta.

O Deep alcança mais e custa mais — mas nem sempre entrega mais. Ele rende onde há fronteiras: subsistemas separados, cliente e servidor, um binário conversando com o host, código conversando com o banco. Num sistema plano, o ganho é pequeno. Medimos os dois casos: com muitas fronteiras o Deep achou 4,5× mais; numa pasta plana, 1,23×.

Na dúvida, peça os dois preços — é o padrão aqui, não custa nada e não compromete você a nada. Com os dois números na mão, e sabendo o seu sistema, a escolha fica sua. E se o seu caso for daqueles em que o Deep não compensa, nós dizemos.

E depois? Como o orçamento chega até você ver

Chega um e-mail com o assunto SVO — o seu orçamento (medição #N), com o preço de cada nível que você pediu e o número da medição. É esse número que abre o pedido — e enquanto você não fizer o pedido, nada é cobrado e nada é instalado. Se alguma faixa precisar de análise à mão, o e-mail diz isso em vez de arriscar um número.

Resumo — para quem já entendeu

  1. Confira se o Python está instalado no seu computador.
  2. Crie uma pasta para a auditoria no seu micro.
  3. Baixe nesta pasta o script medir.py.
  4. Abra um terminal apontando para essa pasta.
  5. Copie o endereço de onde está o seu projeto no micro.
  6. No terminal, escreva python medir.py --lang pt --path e cole o endereço do seu projeto.
  7. Aperte ENTER. No fim aparece um arquivo manifesto.json nesta pasta. É ele que será enviado para o orçamento — você pode abrir e conferir: ele traz o caminho do seu projeto e o número de linhas, já descontando bibliotecas e frameworks.
Windows     python medir.py --lang pt --path C:\auditoria\meuprojeto
Linux/macOS  python3 medir.py --lang pt --path ~/auditoria/meuprojeto

Travou em algum passo?

Não improvise nem tente contornar. Pare e escreva para a gente — se um passo não deu certo, o defeito é do nosso texto e nós o corrigimos. Uma instrução que só funciona para quem já sabe não serve.