Etapa do Funil
Status
📐
— px/m
Sem imagem de fundo
Digite o caminho no campo 🖼 Caminho da imagem
ou coloque o arquivo na pasta Sistema/imagens/
Lotes
0Dispon.
0Vendidos
0Reserv.
0Indisp.
⊞ Criar Vários Lotes
Configure os lotes abaixo, clique em Criar Lotes e depois clique no mapa para
posicionar.
Disponível
Vendido
Reservado
Indisp.
＋ Novo Lote
⚠️ Configure a escala (📐 Escala) para inserir medidas em metros
Disponível
Vendido
Reservado
Indisp.
Pré-visualização
📁 Loteamentos Salvos
🛣 Nome da Rua
Digite o nome e clique em Posicionar.
Depois clique no mapa para colocar o texto.
Depois clique no mapa para colocar o texto.
⬤ Marcador de Quadra
Configure e clique em Posicionar. Depois clique no mapa para colocar o círculo.
Duplo clique no círculo seleciona todos os lotes da quadra.
Duplo clique no círculo seleciona todos os lotes da quadra.
Disponível
Quadra
Tamanho
Cima
Baixo
Lat. Esq
Lat. Dir
Preço
📋 Reservar Lote
💰 Reajuste de Preços
Atualize os preços em massa. Lotes já vendidos nunca são alterados.
% Percentual
R$ Valor Absoluto
▲ Aumentar
▼ Reduzir
Configure o reajuste acima para ver o preview.
Financeiro
Gerencie parcelamentos, contas a receber e a pagar.
Parcelamentos em Aberto
0
Agrupar
Período
Total a Receber
R$ 0,00
Total a Pagar
R$ 0,00
Contas a Receber
0
Contas a Pagar
0
Período
Tipo
0 selecionadas
| Data | Tipo | Extrato | Banco | Descrição | Categoria | Valor |
|---|
Nenhuma movimentação registrada.
Período
0 selecionadas
Período
Tipo
| Data | Tipo | Extrato | Pessoa | Banco | Descrição | Categoria | Valor |
|---|
Nenhuma movimentação registrada.
Período
Agenda
Compromissos, visitas e reuniões.
—
Manuais
Automáticos
Documentação
Script de vendas, guia de uso e manual técnico do sistema.
Fluxo comercial padrão — Construtora 3M.
Link dos Materiais de Apoio
(fotos, plantas, mapa de disponibilidade e tabela de preços por loteamento)
Modo edição: clique dentro do texto e edite livremente. Ctrl+B negrito, Ctrl+I itálico. Clique em Salvar quando terminar (ou Cancelar pra descartar). Evite apagar os títulos das seções — o Sumário ao lado usa eles como âncora.
1. Materiais de Apoio
Fotos do loteamento (drone e entorno), plantas, mapa de disponibilidade e tabela de preços ficam centralizados em um link por loteamento, salvo no CRM. (Ver campo de link acima.)
2. Prospecção
Recebeu a primeira mensagem.
- Perguntar o nome e cidade se não tiver, e se apresentar.
Ex: "Olá, tudo bem, aqui é o Maycon da Construtora 3M" Atualizar CRM: nome, cidade - Identificar a origem do lead — deduzir pelo contexto da mensagem, ou perguntar depois. Atualizar CRM: origem do lead
3. Qualificação
Avaliar se o lead é bom ou não, se realmente tem interesse.
Obrigatórios
- Perguntar a intenção básica.
"Você está pensando em construir ou seria mais para investimento?"
Se der abertura, aprofundar: vai casar, filho vai nascer, ganhou herança, etc. Atualizar CRM: finalidade - Perguntar o prazo.
"Tem algum prazo em mente ou ainda está no começo do planejamento?" Atualizar CRM: prazo - Perguntar o orçamento.
"Para eu te mostrar as melhores opções: você já tem ideia de quanto quer investir no lote?" Atualizar CRM: orçamento - Avaliar a forma de pagamento.
"Prefere pagar à vista ou parcelado? A gente financia direto, sem banco."
(Pode fazer o passo 3 e 4 juntos) Atualizar CRM: forma de pagamento - Definir quem é o decisor.
"A decisão seria só sua ou tem alguém da família junto — cônjuge, sócios?" Atualizar CRM: decisor
Se possível
- Tipo de lote desejado.
"Você tem preferência de localização na cidade? Algum loteamento já te interessa ou não tem problema ser mais afastado?" Atualizar CRM: preferência de localização - Valor da entrada.
"[nome], só para garantir que vou te mostrar a opção certa: você comentou que quer construir e prefere pagar parcelado. Tem algum valor de entrada que já teria disponível, ou prefere começar só com parcelas?" Atualizar CRM: valor de entrada
Antes de perguntar qualquer coisa, conferir no CRM: tem orçamento? Tem finalidade? Tem decisor? Se falta algo, perguntar naturalmente na conversa. Nunca perguntar o que o cliente já respondeu.
Rapport na qualificação
- Usar o nome da pessoa.
- Validar o interesse antes de perguntar qualquer coisa.
- "Que bom que entrou em contato, temos ótimas opções aqui."
- "Boa escolha pesquisar agora — os lotes centrais costumam sair rápido."
- "Legal, é uma região muito boa essa."
- Espelhar o jeito que a pessoa escreve.
Cliente: "Oi, vi q vcs tem lotes, ainda tem?"
Errado: "Olá! Seja bem-vindo à Construtora 3M. Temos sim, diversas opções disponíveis..."
Certo: "Oi! Tem sim, temos boas opções ainda. Me conta, você está pensando em construir ou investir?" - Se a pessoa é conhecida, mencione isso.
"João! Você não é filho do Seu Antônio da padaria? Que bom que entrou em contato."
Padrão RVP — Reage → Valida → Pergunta
- Reage — mostre que você leu e entendeu o que o cliente disse.
"Boa", "Faz sentido", "Perfeito", "Que bom que entrou em contato", "Legal, está em um momento bom pra isso" - Valida — ecoa ou confirma o que o cliente disse.
- Cliente falou algo positivo → reforce: "Construir casa própria é um investimento que vale muito."
- Cliente falou algo limitante (orçamento baixo, sem entrada) → tire a pressão: "Sem problema, a gente tem bastante flexibilidade."
- Cliente deu uma informação → ecoe: "Então você quer construir para a família..."
- Pergunta — a pergunta da qualificação como continuação natural da conversa.
- Uma pergunta por vez no início da conversa — nunca duas ou três de cara.
- A partir da segunda resposta do cliente, pode agrupar 2 perguntas do mesmo assunto.
- Quando agrupar, contextualize antes: "Para montar a simulação certa pra você..."
- Nunca pergunte o que o cliente já respondeu — consulte o CRM antes.
Definir temperatura
QUENTE
Os 3 critérios precisam estar presentes ao mesmo tempo:
- Prazo definido — quer fechar em até 60 dias
- Orçamento compatível com pelo menos um loteamento disponível
- Decisor confirmado — decide sozinho, ou cônjuge também engajado
MORNO
Interesse claro, mas pelo menos um critério incompleto:
- Orçamento compatível com algum loteamento
- ✗ Sem prazo definido — "ainda estou avaliando", "não sei quando"
- ✗ Decisor não confirmado — cônjuge não mencionado ou não engajado
FRIO
Sem engajamento real ou orçamento incompatível com tudo disponível:
- ✗ Sem prazo nenhum — "só estou pesquisando"
- ✗ Orçamento abaixo de todos os loteamentos (incluindo Loteamento C ~R$60k)
- ✗ Não responde ou dá respostas muito vagas
4. Proposta
Identificar a melhor opção com base na qualificação (orçamento, preferências etc.).
- Mensagem 1 — contexto personalizado, usando o que o cliente contou na qualificação.
- Mensagem 2 — mapa do loteamento com disponibilidade (gerado pelo ERP). O visual de "poucos disponíveis" cria urgência real.
- Mensagem 3 — foto de drone + foto do entorno, para o cliente imaginar o lugar.
- Mensagem 4 — condições gerais de pagamento (faixa de preço, entrada mínima, prazo máximo, juros) — não simulação de um lote específico, já que ele ainda não foi escolhido.
- Mensagem 5 — convite para visita.
Exemplo — à vista:
João, com esse orçamento tenho uma ótima opção pra você — o Loteamento Santo Antônio, que é o melhor ponto que temos em Cristais agora. Vou te mandar o mapa e umas fotos.
📍 [mapa do loteamento com lotes disponíveis]
🛸 [foto de drone do loteamento]
🏘️ [foto do entorno / rua principal]
Os lotes estão entre R$100k e R$115k à vista, dependendo da posição. São poucos disponíveis ainda — a maioria já foi vendida, dá pra ver no mapa.
Para vocês dois terem uma ideia real do terreno e da localização, vale muito a pena dar uma passada lá — é rápido, uns 20 minutinhos. Que dia funcionaria melhor: quinta de tarde ou sábado de manhã?
📍 [mapa do loteamento com lotes disponíveis]
🛸 [foto de drone do loteamento]
🏘️ [foto do entorno / rua principal]
Os lotes estão entre R$100k e R$115k à vista, dependendo da posição. São poucos disponíveis ainda — a maioria já foi vendida, dá pra ver no mapa.
Para vocês dois terem uma ideia real do terreno e da localização, vale muito a pena dar uma passada lá — é rápido, uns 20 minutinhos. Que dia funcionaria melhor: quinta de tarde ou sábado de manhã?
Parcelado = financiamento direto com a Construtora 3M, sem banco. Financiado = via banco. O exemplo abaixo é do caso Parcelado (direto).
Se for parcelado:
- Perguntar quanto quer pagar por mês / perguntar a renda.
- Pedir CPF (para consultar no Serasa).
Exemplo — parcelado:
João, com esse orçamento tenho uma ótima opção pra você — o Loteamento Santo Antônio, que é o melhor ponto que temos em Cristais agora. Vou te mandar o mapa e umas fotos.
📍 [mapa do loteamento com lotes disponíveis]
🛸 [foto de drone do loteamento]
🏘️ [foto do entorno / rua principal]
Os lotes ficam em torno de R$85k. Parcelado, com entrada de R$15k a R$20k, as parcelas ficam aproximadamente entre R$800 e R$950 por mês em 72 meses — dentro do que você me falou que teria disponível. Os juros são 12% ao ano com reajuste anual pelo IPCA, financiamento direto com a gente, sem banco.
Os lotes têm 200m² — dá bem pra construir uma casa de 3 quartos confortável e ainda ter quintal. Para você ter uma ideia real do terreno e da localização, vale muito a pena dar uma passada lá. É rápido, uns 20 minutinhos. Que dia funcionaria melhor: quinta de tarde ou sábado de manhã?
📍 [mapa do loteamento com lotes disponíveis]
🛸 [foto de drone do loteamento]
🏘️ [foto do entorno / rua principal]
Os lotes ficam em torno de R$85k. Parcelado, com entrada de R$15k a R$20k, as parcelas ficam aproximadamente entre R$800 e R$950 por mês em 72 meses — dentro do que você me falou que teria disponível. Os juros são 12% ao ano com reajuste anual pelo IPCA, financiamento direto com a gente, sem banco.
Os lotes têm 200m² — dá bem pra construir uma casa de 3 quartos confortável e ainda ter quintal. Para você ter uma ideia real do terreno e da localização, vale muito a pena dar uma passada lá. É rápido, uns 20 minutinhos. Que dia funcionaria melhor: quinta de tarde ou sábado de manhã?
5. Visita
1 dia antes
- Confirmar visita pelo WhatsApp — data, hora e local.
- Confirmar que todos os decisores vêm (cônjuge, se for o caso).
- Revisar o CRM: finalidade, orçamento, forma de pagamento.
- Verificar quais lotes estão disponíveis no momento.
- Separar os materiais que vai levar.
1 hora antes
- Mandar mensagem rápida de confirmação.
- Sair com antecedência — chegar 10 min antes do cliente.
- Verificar se o lote está acessível: sem entulho, cerca identificável.
O que levar
- Mapa do loteamento (impresso ou no celular) com lotes disponíveis marcados.
- Tabela de preços e condições de pagamento.
- Simulação aproximada de parcelamento (se cliente for parcelado).
- Fita métrica.
- Água para oferecer se a visita durar mais.
Dica: registre a visita como compromisso na aba Agenda (tipo "Visita ao Lote").
6. Negociação
Objeções comuns — o padrão RVP (Reage → Valida → Pergunta) também se aplica aqui:
"Tá caro"
- Reagir: "Entendo, é um investimento importante mesmo."
- Validar: reforçar o que o lote oferece (localização, potencial de valorização, parcelamento sem banco).
- Perguntar: "Pra te ajudar a decidir, o que pesa mais pra você: o valor total ou o valor da parcela?"
"Vou pensar"
- Reagir: "Sem problema, decisão importante mesmo merece calma."
- Perguntar o que falta: "Só pra eu entender melhor, tem alguma dúvida específica que eu possa esclarecer agora?"
- Definir prazo de retorno: "Posso te chamar [dia] pra saber se surgiu alguma dúvida?"
"Preciso falar com minha esposa/marido/sócio"
- Reagir: "Faz todo sentido, decisão de vocês dois."
- Tentar envolver o decisor ausente: "Vocês topariam ver o lote juntos, ou prefere que eu te mande o material pra vocês conversarem?"
Desconto
[DEFINIR: quem pode dar desconto e até quantos %. Ex: "Tal pessoa pode dar desconto de até X% sozinho, acima disso precisa aprovação de [pessoa]."]
Atualizar CRM: objeção levantada, resposta dada, resultado
7. Fechamento
(depende do caso/cliente — mas alguns pontos valem pra qualquer formato)
Checklist de documentos antes de fechar
- CPF e RG do(s) comprador(es) [e do cônjuge, se for decisor conjunto].
- Comprovante de residência.
- Se parcelado: comprovante de renda + consulta Serasa já feita na etapa de qualificação/proposta.
Formalização
[DEFINIR: quando será presencial com assinatura física e quando será digital/eletrônica — por enquanto, decidir caso a caso]
- Confirmar o lote exato reservado no CRM (evitar vender o mesmo lote duas vezes).
- Definir data de assinatura e comunicar claramente o prazo de validade da proposta (ex: "essa condição fica reservada por X dias").
Depois de assinado
- No card do lead (CRM), marcar Status do Lead → Vendido. O card some do Kanban automaticamente (fica só visível pelo filtro "Mostrar Vendidos").
- Dar baixa do lote no mapa de disponibilidade (Gerenciador de Lotes).
- Registrar forma de pagamento definitiva e cronograma de parcelas (se aplicável).
8. Pós-venda
Acompanhamento de parcelas
[DEFINIR: quem cobra parcela atrasada — corretor, financeiro, ou mensagem automática do CRM antes de envolver uma pessoa.]
- Reajuste anual pelo IPCA: comunicar o cliente com antecedência (ex: 30 dias antes) sobre o novo valor da parcela, evitando surpresa.
- Emissão do Instrumento de Garantia e demais documentos legais conforme o processo já mapeado.
Relacionamento pós-venda
- Manter contato pontual (aniversário, datas comemorativas, atualização sobre o loteamento) — pode gerar indicação.
- Perguntar sobre indicações depois que o cliente já estiver satisfeito com o processo (ex: 3-6 meses após a compra).
9. Pós Não-Venda / Follow-up
Trata dos leads que passaram pelo funil mas não fecharam — para não deixá-los se perderem.
Regras de follow-up
[DEFINIR: prazo — ex. se o lead não responder à Mensagem 5 (convite pra visita) em X dias, disparar novo contato]
[DEFINIR: quantas tentativas de reengajamento antes de classificar como "perdido"]
[DEFINIR: cadência de reativação de leads frios/perdidos — ex. campanha trimestral, novo loteamento lançado, etc.]
Motivo da perda
Sempre registrar por que o lead não fechou (preço, prazo, escolheu concorrente, sumiu sem responder etc.) — ajuda a identificar padrões.
No card do lead, marcar Status do Lead → Perdido e preencher o motivo. O card some do Kanban (visível só pelo filtro "Mostrar Perdidos") — a etapa do funil em que ele parou fica registrada, ótimo pra ver onde o funil mais vaza.
Atualizar CRM: status "perdido", motivo, data da última tentativa10. Melhoria Contínua
Sempre que surgir uma situação nova que o script ainda não cobre, atualize o documento na seção correspondente.
Guia de uso do ERP — pra quem usa no dia a dia, não pra quem mexe no código.
Modo edição: clique dentro do texto e edite livremente. Ctrl+B negrito, Ctrl+I itálico. Clique em Salvar quando terminar (ou Cancelar pra descartar). Evite apagar os títulos das seções — o Sumário ao lado usa eles como âncora.
1. Primeiros passos
- Login: ao abrir o sistema pela primeira vez, se não tiver dados salvos, aparece uma tela pedindo login. Use o e-mail e senha cadastrados pelo admin. Sem conexão, dá pra continuar sem logar (clicando em "trabalhar offline"), mas os dados não sincronizam com a nuvem até você logar.
- Sidebar (menu lateral): é onde você troca de aba — Dashboard, CRM, Gerenciador de Lotes, Financeiro, Agenda e Documentação (que reúne Script de Vendas, Como Usar — aqui — e Manual Admin em sub-abas). No celular, o menu vira uma gaveta lateral — toque no ícone de três linhas no canto superior esquerdo pra abrir.
- Sincronização: o sistema não atualiza sozinho quando outra pessoa muda algo — dê um F5 (recarregar a página) de vez em quando, principalmente antes de mexer em algo que outra pessoa da equipe também usa.
2. Dashboard
Visão executiva com números — três sub-abas no topo:
- Vendas — VGV (valor total vendido), % de lotes vendidos, ticket médio, gráfico de vendas por mês, tabelas por loteamento.
- CRM — quantidade de leads, funil de conversão (quantos passam de etapa em etapa), de onde vêm os leads (Instagram, indicação, etc.).
- Financeiro — saldo em caixa, receita/despesa do mês, projeção dos próximos 6 meses, inadimplência, gastos por categoria. É a visão mais "gerencial" do sistema.
3. CRM (funil de vendas)
Kanban e Lista
Cada lead é um "card". Os cards ficam organizados em colunas por etapa do funil (ex: Apenas Consulta → Interesse Parcial → Lead Quente → Cliente). Duas formas de mover um lead pra outra etapa:
- No computador: arraste o card e solte na coluna certa.
- No celular (ou no computador também, se preferir): use o seletor "Mover para outra etapa" que aparece dentro do próprio card — é só tocar e escolher a etapa nova.
Cadastrando um lead
Botão "Registrar Novo Cliente". Preencha o que souber — nome é o único campo obrigatório. Os campos de Qualificação (BANT: orçamento, decisor, finalidade, prazo) ajudam a definir se o lead é Quente, Morno ou Frio.
Status do Lead: Vendido / Perdido
Quando um lead compra ou desiste, marque o Status do Lead no card (ícones de ✓ verde / ✕ vermelho no rodapé, ou dentro do formulário de edição). Isso tira o card do Kanban automaticamente — pra não acumular lead antigo poluindo a tela. Se quiser ver os Vendidos/Perdidos de novo, use o botão Filtrar no topo e marque "Mostrar Vendidos" / "Mostrar Perdidos".
Cliente antigo que você não quer no funil (já comprou há anos, por exemplo) pode ser cadastrado direto como Vendido, com o Funil marcado como "Nenhum (Base Geral)" — ele fica só na Base de Clientes, sem aparecer em nenhum Kanban.
Base de Clientes / Base de Pessoas
No dropdown do topo (onde mostra o nome do funil), tem a opção Base de Clientes — mostra todo mundo cadastrado, de qualquer funil, inclusive quem não está em funil nenhum.
Mensagens (WhatsApp)
Botão Mensagens na barra de ferramentas — cadastra modelos de mensagem prontos (por tarefa, por etapa do funil, ou globais). No card do lead, o botão verde do WhatsApp abre a lista de sugestões já com os dados do cliente preenchidos automaticamente (nome, valor da parcela, etc.).
Fluxo de Cadência
Define tarefas automáticas que aparecem quando um lead entra numa etapa (ex: "ligar em 2 dias"). Configurável no botão Fluxo de Cadência.
4. Gerenciador de Lotes
- Cada loteamento é um projeto separado — use o botão de pasta (📁) pra trocar entre projetos ou criar um novo.
- Os lotes aparecem desenhados sobre a imagem/mapa do loteamento. Clique num lote pra ver detalhes, marcar como Vendido / Reservado / Disponível, vincular a um cliente do CRM, etc.
- A matrícula (número de registro) é calculada automaticamente a partir de um número inicial que você configura — não precisa digitar uma por uma.
- Dá pra exportar a lista de lotes pra Excel.
5. Financeiro
Três seções (alterne no topo): Construtora 3m, Família e visão Geral.
Parcelamentos (Construtora)
Cada dívida (parcelamento de lote) tem seu cronograma de parcelas, com data de vencimento, multa por atraso e reajuste anual. Marcar uma parcela como paga é só clicar nela.
Movimentações (Construtora e Família)
Lançamentos de entrada/saída, categorizados. Dá pra importar extrato do banco em OFX — o sistema detecta duplicatas automaticamente e sugere categoria com base no histórico.
Interna (transferência entre contas)
Uma transferência entre duas contas suas não deve contar como receita/despesa de verdade — marque como Interna (botão de bulk ou individual) pra ela não distorcer os números de análise.
Contas Futuras
Contas a pagar/receber que ainda não aconteceram — aparecem também na Agenda automaticamente, com aviso de quantos dias faltam.
6. Agenda
Calendário mensal (ou lista) que junta compromissos manuais (visita, reunião, ligação) com eventos automáticos: tarefas do CRM, tarefas do Financeiro, contas a pagar/receber. Use os filtros no topo pra mostrar só o que interessa.
7. Script de Vendas e Manual Admin
São as outras duas sub-abas aqui dentro de Documentação (o mesmo botão de troca que tem "Como Usar" no topo):
- Script de Vendas — o passo a passo de vendas da equipe comercial (prospecção, qualificação, proposta, fechamento etc.). Editável — clique em "Editar" no topo do documento.
- Manual Admin — documentação técnica pra quem mexe no código/configuração do sistema (só aparece pra admin e operador). Se você é vendedor(a), provavelmente não precisa entrar lá.
8. Dicas gerais
- Nunca use os pop-ups nativos do navegador pra confirmar nada — o sistema sempre usa as próprias janelinhas de confirmação, então se algo pedir confirmação, é normal (não é vírus nem erro).
- Se algo sumir ou parecer errado depois que outra pessoa mexeu, dê F5 antes de se preocupar — provavelmente é só sincronização.
- Ficou em dúvida sobre um campo ou uma tela? Fale com o admin — ele pode ajustar textos, campos e até pedir alterações no sistema via Claude Code (ver Manual Admin).
Como o sistema funciona por baixo do capô, como editar e como publicar.
Modo edição: clique dentro do texto e edite livremente. Ctrl+B negrito, Ctrl+I itálico. Clique em Salvar quando terminar (ou Cancelar pra descartar). Evite apagar os títulos das seções — o Sumário ao lado usa eles como âncora.
1. O que é este sistema
O ERP Loteamento é o sistema interno da Construtora 3M: CRM de vendas, gerenciador de lotes/loteamentos, financeiro (construtora, família e roça), agenda e dashboards. Não tem instalação nem servidor de aplicação — é só HTML/CSS/JavaScript, aberto direto no navegador ou publicado como site estático.
Os dados ficam salvos no navegador de cada pessoa (localStorage) e são sincronizados em segundo plano com o Firebase (Google), que funciona como backup na nuvem e ponte entre os dispositivos da equipe.
2. Estrutura dos arquivos
Tudo mora dentro da pasta Sistema/, dentro do repositório ERP Loteamento/:
- index.html — a "casca" do sistema: sidebar, todas as abas e todos os modais (formulários em janela).
- styles.css — toda a aparência visual (cores, espaçamentos, layout).
- script.js — toda a lógica: o que acontece quando você clica em um botão, salva um cliente, muda de aba, etc. É o arquivo mais importante e mais longo.
- firebase-init.js — cuida só da sincronização com o Firebase (login, subir/baixar dados). Fica separado dos outros de propósito.
- tests/ — testes automatizados (abrir
tests/test_runner.htmlno navegador pra rodar).
Regra do projeto: tudo fica nesses arquivos. Já tentamos separar pedaços em arquivos extras antes e isso causou dessincronia — não vale a pena repetir.
3. Editando com VS Code + Claude Code
Abrindo o projeto
- Abra o VS Code.
- Arquivo → Abrir Pasta → selecione
C:\Users\mayco\Downloads\ERP Loteamento(a pasta raiz do projeto — não aSistema\por dentro dela). - Abra o terminal integrado (Terminal → Novo Terminal, ou
Ctrl+ `).
Pedindo uma alteração pro Claude
- Com a extensão/CLI do Claude Code aberta no terminal, descreva o que você quer em português normal — não precisa saber programar. Ex: "Quero adicionar um campo de WhatsApp separado do telefone no cadastro de cliente".
- O Claude vai localizar os arquivos certos, explicar o que pretende mudar e aplicar as edições.
- Depois de qualquer alteração, abra o
index.htmlno navegador e teste na prática antes de aceitar como pronto — clique nos botões, preencha um formulário de teste, etc. - Se algo saiu errado, é só pedir pra desfazer ou corrigir — nada é definitivo até você fazer o deploy.
[DEFINIR: quem além de você tem acesso pra pedir alterações via Claude Code / editar o repositório diretamente]
4. Testando antes de publicar
- Sempre abra o
Sistema/index.htmldireto no navegador (duplo clique, ou arrastar pro Chrome) depois de qualquer alteração. - Teste o "caminho feliz" da funcionalidade alterada (o uso normal) e pelo menos um caso de borda (campo vazio, muitos itens, etc.).
- Se a alteração mexeu em telas existentes, dê uma olhada rápida nas abas próximas — CRM, Financeiro, Agenda — pra garantir que nada quebrou por tabela.
- Só depois de validar visualmente é que vale rodar o deploy.
5. Deploy (Firebase Hosting)
Publicar é subir a versão nova do sistema pro endereço público que a equipe usa no dia a dia:
https://erp-construtora-3m.web.app
Passo a passo, no terminal (do VS Code ou qualquer terminal):
1. Entrar na pasta raiz do projeto:
2. Rodar o deploy:
cd "C:\Users\mayco\Downloads\ERP Loteamento"2. Rodar o deploy:
firebase deploy --only hosting
Isso sobe todo o conteúdo da pasta Sistema/ — não precisa selecionar arquivo por arquivo. Em alguns segundos o site público já reflete a mudança.
--only hosting só publica os arquivos estáticos (HTML/CSS/JS). Regras de segurança do Firestore/Auth/Storage são um deploy separado — ver seção 6.
6. Usuários, permissões e regras
- Login e contas de usuário ficam no Firebase Authentication (email/senha).
- Cada usuário tem um papel (role): admin, operador ou leitor — e pode ter abas específicas bloqueadas. Isso se gerencia dentro do próprio sistema, no painel Usuários (visível só pra admins).
- O primeiro admin do sistema precisa ser promovido manualmente direto no Firebase Console (não tem como fazer isso pela própria interface — é o ponto de partida).
- Passo a passo completo de configuração inicial (criar projeto Firebase, ativar Auth, publicar regras de segurança) está no arquivo
FIREBASE_SETUP.md, na raiz do repositório.
7. Backup e recuperação
- Os dados de verdade (clientes, dívidas, lotes, etc.) ficam guardados no Firestore — é o backup real, não o navegador de ninguém.
- Se um computador for formatado ou trocado, basta logar de novo no sistema num navegador limpo — os dados voltam automaticamente do Firebase.
- Migração inicial de dados antigos (quando o sistema ainda não usava Firebase) é feita rodando
migrarParaCloud()no console do navegador — só relevante uma vez, na configuração inicial.
[DEFINIR: rotina de backup adicional fora do Firebase — export manual periódico, por exemplo]
8. Problemas comuns
- "Mudei o código mas não vejo a alteração no site publicado" — o cache do navegador pode estar segurando a versão antiga. Force um recarregamento completo (Ctrl+Shift+R) ou verifique se o deploy realmente terminou sem erro no terminal.
- "Mudança some depois que outra pessoa usa o sistema" — o sistema não sincroniza em tempo real entre pessoas; cada um precisa dar F5 pra puxar os dados mais recentes do Firebase. Isso é proposital (evita conflito de duas pessoas editando o mesmo cliente ao mesmo tempo).
- "Erro de permissão no Firebase" — geralmente é sessão expirada ou o usuário não tem o papel certo. Confirme o login e o papel no painel Usuários.
- "firebase: comando não encontrado" no terminal — o Firebase CLI precisa estar instalado globalmente (
npm install -g firebase-tools) e você precisa ter feitofirebase loginuma vez.