Guia do Desenvolvedor — CRM Seguros

1 Primeiro Acesso

Conecte na VPS via terminal (PowerShell, Terminal do Mac, ou qualquer cliente SSH):

ssh seu-usuario@187.77.241.157

Seu usuário	Senha inicial
`seu-usuario`	`Alje#2610`

🔑 No primeiro login o sistema vai pedir para trocar a senha. Escolha uma senha pessoal e guarde bem.

2 Criar seu Workspace

Antes de codar, crie seu workspace isolado. Isso cria uma cópia do projeto numa branch só sua, com banco de dados e backend isolados.

ws create

O sistema automaticamente:

Cria seu workspace em /opt/workspaces/seu-nome/
Cria seu banco isolado (schema dev_seu-nome)
Atribui uma porta exclusiva para seu backend
Configura tudo no .env automaticamente

⚠️ Esse passo só precisa ser feito uma vez. Nas próximas vezes, basta rodar ws start.

🔒 O comando ws detecta quem você é automaticamente. Você só pode operar no seu próprio workspace.

3 Fluxo de Trabalho Diário

Iniciar o dia

# Iniciar seu ambiente (backend + frontend)
ws start

# Atualizar com as mudanças mais recentes da main
ws sync

O ws start mostra onde seu servidor está rodando:

🔌 Backend:  http://localhost:PORTA
🌐 Frontend: http://187.77.241.157:PORTA
🗄️  Schema:   dev_seu-nome

Codar e salvar

# Entrar no seu workspace
cd /opt/workspaces/seu-nome

# Ver o que mudou
git status

# Adicionar arquivos modificados
git add src/components/MeuComponente.tsx

# Commitar com mensagem descritiva
git commit -m "Adiciona filtro de estado no formulário"

Enviar para a main (quando terminar a tarefa)

ws merge

Parar o servidor

ws stop

4 Comandos Úteis

Comando	O que faz
`ws help`	Mostra seus dados (porta, URL, schema) e comandos
`ws create`	Cria seu workspace + banco isolado + backend
`ws start`	Inicia seu backend + frontend
`ws stop`	Para seu backend + frontend
`ws sync`	Atualiza seu workspace com a main
`ws merge`	Publica seu trabalho na main
`ws status`	Visão geral de todos os workspaces

💡 O comando ws funciona de qualquer diretório. Não precisa navegar para nenhuma pasta específica.

5 Regras Importantes

Nunca trabalhe direto na main — sempre use seu workspace. O sistema bloqueia commits diretos na main.
Commite frequentemente — commits pequenos são mais fáceis de resolver se der conflito.
Sincronize todo dia com sync — quanto mais atualizado, menos chance de conflito.
Faça merge quando terminar a tarefa — não acumule muitos commits na sua branch.

6 Se der conflito

Se ao fazer ws merge ou ws sync aparecer uma mensagem de conflito:

Abra os arquivos indicados na mensagem de erro
Procure as marcações <<<<<<<, =======, >>>>>>>
Escolha qual versão manter (ou combine as duas)
Salve o arquivo
Execute os comandos abaixo:

git add arquivo-resolvido.tsx
git commit -m "Resolve conflito em arquivo-resolvido.tsx"

🚨 Em caso de dúvida, pergunte antes de resolver. Resolver errado pode sobrescrever o trabalho de outro dev.

7 Estrutura de Pastas

/opt/cotacao-inteligente-crm/ ← repo principal (main) — NÃO editar aqui
/opt/workspaces/seu-nome/ ← seu workspace (trabalhe aqui)

8 Dev Server

Para iniciar seu ambiente completo (backend + frontend):

ws start

O comando mostra as URLs do seu servidor:

🔌 Backend:  http://localhost:SUA_PORTA
🌐 Frontend: http://187.77.241.157:SUA_PORTA_FRONTEND
🗄️  Schema:   dev_seu-nome

Para ver suas portas a qualquer momento:

ws help

🔒 Cada dev tem portas e banco de dados exclusivos. Suas alterações não afetam outros devs nem a produção.