vscode-ia/GUIA_SETUP_OUTRA_MAQUINA.md

Guia de Setup em Outra Maquina

Objetivo

Este repositorio raiz foi preparado para versionar o que faz sentido do Vitruvio subir junto no git, sem levar acervo antigo

Bootstrap rapido de workspace

Se a necessidade for somente subir a base padrao de configuracoes em um workspace novo, use o bootstrap versionado da raiz:

bash bootstrap-workspace.sh /caminho/do/novo-workspace

Se preferir rodar pelo VS Code, execute a task Workspace: Bootstrap Base.

• No Linux, a task usa .vscode/automatizadores/bootstrap-workspace.sh.
• No Windows, a task usa .vscode/automatizadores/bootstrap-workspace.ps1.

Esse comando leva para o destino:

• .claude/agents
• .claude/settings.local.json em versao portavel, sem caminhos absolutos da maquina atual
• .vscode, incluindo o MCP Oracle local sem .env e sem node_modules
• .github
• CLAUDE.md
• .mcp.json
• Vitruvio/Documentação com todos os arquivos versionados

Tambem cria a estrutura inicial:

• Andamento/
• Concluidos/

Se o destino ja tiver arquivos e voce quiser sobrescrever, rode:

bash bootstrap-workspace.sh /caminho/do/novo-workspace --force

Pelo VS Code, a equivalente e a task Workspace: Bootstrap Base (Forcar).

Passo a passo

1. Instale o basico na nova maquina.

   • Git
   • VS Code
   • Node.js e npm, se for usar o MCP Oracle local

2. Clone o repositorio raiz.

git clone <URL_DO_REPOSITORIO> davinti
cd davinti

3. Abra a pasta no VS Code.

code .

4. Recrie os arquivos locais que nao sobem para o Git.

   • Copie mcp-oracle-custom/.env.example para mcp-oracle-custom/.env e preencha as credenciais necessarias.
   • Copie .vscode/mcp.example.json para .vscode/mcp.json.
   • Mantenha qualquer arquivo de acesso VPN fora do repositorio.

5. Se for usar consultas Oracle pelo VS Code, o bootstrap local do MCP instala as dependencias automaticamente quando necessario.

code .

• O .vscode/mcp.json do workspace chama ./mcp-oracle-custom/run-mcp.sh.
• O bootstrap procura node automaticamente e tenta usar o Node embutido do VS Code neste ambiente Linux quando necessario.
• Se node nao existir, o bootstrap informa isso explicitamente.
• Se as dependencias precisarem ser instaladas e npm nao existir, o bootstrap informa isso explicitamente.
• O servidor procura automaticamente o arquivo .env do workspace em mcp-oracle-custom/.env, sem depender de caminho absoluto no .vscode/mcp.json.

6. Atualize os artefatos do Vitruvio quando precisar.

   • No VS Code, execute a task Vitruvio: Baixar e Extrair ZIP.
   • No Linux, a task usa o script Bash em .vscode/automatizadores/sync_vitruvio_zip.sh.
   • No Windows, a mesma task usa a versao PowerShell em .vscode/automatizadores/sync_vitruvio_zip.ps1.
   • O conteudo sera extraido em Vitruvio/, incluindo Paineis, Libs, WebServices, Processos e Relatorios.

7. Se quiser usar o criador de casos como extensao local do VS Code, empacote e instale o VSIX.

   • Depois, no VS Code da nova maquina, use Extensions: Install from VSIX e selecione o arquivo que está na base do repositório na pasta .vscode/vsix/vitruviodeveloper-version.vsix.
   • O comando disponivel sera Vitruvio: Criar Estrutura Inicial de Caso.
   • Se necessario, ajuste a configuracao vitruvioCaseStarter.webServiceUrl nas configuracoes do VS Code.

8. Confira o que esta rastreado antes do primeiro push.

git status

9. Se quiser publicar no GitHub a partir desta maquina, conecte o remoto e envie.

git remote add origin <URL_DO_REPOSITORIO>
git branch -M main
git push -u origin main

Observacoes importantes

• Se quiser versionar alguma dessas pastas junto na raiz, o ideal e decidir isso conscientemente antes, para evitar repositorios aninhados e submodulos acidentais.
• Se realmente precisar subir algo, remova essas entradas do .gitignore antes de adicionar os arquivos.
• O bootstrap copia a pasta real de documentação do Vitruvio a partir do template, evitando criar manualmente caminhos com caracteres especiais.