← Voltar ao painel

Conectar seu espaço maker

A prévia local já permite testar o painel. Para compartilhar produtos e receber estatísticas e pedidos de todos os visitantes, siga estes passos.

  1. Crie sua conta no Supabase e um projeto. Guarde a senha do banco em local seguro; não a envie no chat.
  2. Abra o SQL Editor do projeto. Copie o conteúdo do arquivo de instalação do painel e execute uma vez no projeto novo. O arquivo reúne as migrações 001 e 002 e cria também o armazenamento privado das cópias baixadas. Se já instalou a versão anterior, execute somente a migração 002 fornecida pelo responsável pela publicação.
  3. Em Authentication → Users, crie sua conta de administrador com e-mail e senha. Desative cadastros públicos nas configurações de Authentication. Copie o ID do usuário criado.
  4. No SQL Editor execute insert into public.admin_users(id) values ('ID-DO-SEU-USUARIO'); substituindo pelo ID real. Somente contas nessa lista podem administrar produtos, ler pedidos e consultar estatísticas.
  5. Em Project Settings → API, copie a URL do projeto e a chave pública anon ou publishable. Informe esses dois dados ao responsável pela publicação para preencher public/platform-config.json no repositório e publicar novamente. Essas duas informações são públicas. Nunca envie senha do banco, chave secret ou service_role.
  6. Depois da publicação, entre no painel com o e-mail e senha da conta criada. Cadastre um produto de teste, publique e abra o site em outro navegador. Autorize as estatísticas, faça um download e envie um orçamento para confirmar o recebimento.

Ativar o assistente de IA

A versão 2 ajuda com textos e prepara ações revisáveis: criar rascunhos, editar parâmetros e cadastros, publicar/ocultar quando solicitado e atualizar situações de orçamento. Não modifica o código do site. A revisão local de cadastros não precisa de IA.

  1. No projeto Supabase, abra Edge Functions. Se maker-assistant já existir, abra-a para atualizar o código. Se não existir, use Deploy a new function → Via Editor e nomeie maker-assistant.
  2. Abra o código completo da função, copie tudo e substitua o conteúdo do arquivo index.ts no editor. O arquivo já reúne todos os módulos necessários. Clique em Deploy. Mantenha a verificação de autenticação da função.
  3. Em Edge Functions → Secrets, crie OPENAI_API_KEY com uma chave da API da OpenAI. Faça isso diretamente no Supabase; não cole a chave no chat ou no site. A API é cobrada separadamente da assinatura do ChatGPT. Opcional: OPENAI_MODEL escolhe o modelo; o padrão é gpt-4.1.
  4. Volte ao painel → Assistente de IA → Verificar configuração. Esse botão consulta a função sem gerar texto e sem chamar a OpenAI. Depois faça um pedido pequeno para testar o serviço completo.

O assistente recebe o catálogo do projeto, os modelos disponíveis, indicadores dos últimos 30 dias e referências de situação de até 20 pedidos. Não enviamos contatos ou mensagens dos clientes nesse contexto. O histórico recente da conversa fica em memória durante a sessão. Cada proposta só muda os dados depois do seu clique para aplicar. Novos produtos começam como rascunhos.

O que as estatísticas significam

Acessos contam carregamentos da página com autorização. Downloads contam acionamentos do navegador, sem confirmar que o arquivo foi salvo. Não há dados anteriores à ativação, nem contagem de pessoas únicas. Pedidos aparecem somente depois do envio explícito pelo formulário. As estatísticas públicas podem incluir automação; não são uma auditoria de tráfego.

Emissão de orçamentos

No projeto já instalado, abra o SQL Editor e execute somente o conteúdo de pricing-schema.sql. Essa atualização cria as tabelas privadas de orçamentos e padrões de preços. Não repita o script inicial. Depois, entre no painel e clique em Emitir orçamento. Sem essa atualização, o módulo guarda os documentos apenas no navegador; use a exportação JSON para fazer uma cópia de segurança.

Materiais, clientes, cópias e Kanban

Em um projeto já instalado, execute o conteúdo de database-update.sql no SQL Editor. É uma atualização repetível: preserva os dados anteriores. Ela cria as tabelas de orçamentos, cópias de trabalho e projetos identificados de clientes. Não execute novamente o script inicial. Após o sucesso, recarregue o site e o painel. A identificação obrigatória antes de salvar, exportar ou pedir orçamento é ativada somente quando esta atualização estiver instalada. Até lá o site mantém o fluxo anterior, sem capturar esses dados.

E-mail obrigatório antes dos downloads

Se já executou a atualização anterior do banco, execute somente customer-email-required.sql no SQL Editor para exigir e-mail também no banco. Não remove registros nem tabelas. O popup do site pede nome e e-mail, com telefone opcional.

Financeiro: despesas e relatórios

Os recebimentos são derivados dos orçamentos marcados como pagos e usam a data de pagamento. Para registrar despesas, execute o conteúdo de finance-update.sql no SQL Editor do Supabase e recarregue o painel. A atualização cria somente a tabela privada de despesas e suas permissões; preserva os dados existentes. A composição de custos das máquinas é uma estimativa e não representa despesas já pagas. No painel, use Financeiro para fluxo de caixa e Relatórios de trabalhos para exportar os dados dos orçamentos em PDF ou Excel.