Deploy em 15 Minutos: Como Colocar sua Escola no Ar

Imagine assinar o contrato com uma plataforma de gestao escolar e, antes mesmo de terminar o cafe, ja estar com o sistema completo funcionando — com a marca da sua escola, seus modulos, seus dados iniciais e o primeiro gerente logado. Parece fantasia? Para quem ja passou meses esperando a "implantacao" de um software tradicional, certamente parece. Mas no Lumied, isso e realidade: 15 minutos entre a assinatura e o acesso completo a plataforma.

Neste artigo, vamos mostrar exatamente como funciona o processo de deploy automatizado do Lumied, quais tecnologias tornam isso possivel e por que essa velocidade nao significa sacrificar qualidade ou seguranca — pelo contrario, ela e consequencia de uma arquitetura pensada desde o primeiro dia para escalabilidade.

O problema: implantacao tradicional de software escolar

Se voce ja contratou um sistema de gestao escolar antes, provavelmente conhece o roteiro classico. Apos a assinatura do contrato, comeca uma longa jornada de "implantacao" que pode durar semanas ou ate meses. Reunioes de levantamento de requisitos, configuracao manual de servidores, migracao de dados, treinamentos presenciais, e uma infinidade de idas e vindas entre a escola e a equipe tecnica do fornecedor.

Esse modelo traz varios problemas concretos para a escola:

• Tempo perdido: semanas ou meses entre a decisao de contratar e o uso efetivo do sistema. A escola continua no WhatsApp e nas planilhas enquanto espera.
• Custo oculto: horas de reunioes, deslocamento de equipe, treinamentos repetidos. Tudo isso custa dinheiro, mesmo que nao apareca na fatura.
• Frustacao da equipe: professores e coordenadores perdem a empolgacao inicial enquanto o sistema "ainda esta sendo implantado".
• Dependencia do fornecedor: qualquer ajuste, por menor que seja, exige um chamado e dias de espera.
• Risco de desistencia: quanto mais demora a implantacao, maior a chance de a escola desistir antes mesmo de comecar a usar.

No modelo tradicional, a implantacao e o maior gargalo da adocao. O Lumied elimina esse gargalo completamente: 15 minutos do contrato ao primeiro acesso.

A solucao: deploy automatizado em 9 passos

O Lumied foi arquitetado desde a primeira linha de codigo para que o onboarding de uma nova escola seja completamente automatizado. Nao se trata de um atalho ou de pular etapas — cada passo do processo foi otimizado para ser executado de forma programatica, com scripts e wizards que substituem o trabalho manual que antes levava semanas.

O processo completo envolve 9 passos, executados em sequencia. Vamos detalhar cada um:

Passo 1: Criar o projeto Supabase

Cada escola no Lumied recebe seu proprio projeto no Supabase, o backend-as-a-service que fornece banco de dados PostgreSQL, autenticacao, storage e edge functions. Criar um novo projeto leva menos de 1 minuto pelo painel do Supabase. O resultado e um REF (identificador unico do projeto) e uma Anon Key (chave publica de acesso).

Passo 2: Executar o script de deploy

Aqui esta o coracao da automacao. Um unico comando no terminal configura todo o backend da nova escola:

Esse script e o mesmo usado internamente pela equipe Lumied. Ele foi testado dezenas de vezes e garante que toda nova escola receba exatamente a mesma estrutura de banco de dados, as mesmas funcoes, as mesmas regras de seguranca. Zero variacao, zero erro humano.

Passo 3: Configurar autenticacao

No painel do Supabase, configuramos a Site URL (endereco da escola) e as Redirect URLs para que o login funcione corretamente. Tambem ativamos o provider Google para login social. Esse passo leva cerca de 2 minutos.

Passo 4: Import no Vercel

O Lumied usa o Vercel para hospedar o frontend. Importamos o repositorio do GitHub, configuramos as variaveis de ambiente (URL e chave do Supabase da nova escola) e o build roda automaticamente. Em menos de 1 minuto, o frontend esta no ar.

Passo 5: DNS e Cloudflare

Cada escola recebe seu proprio subdominio — por exemplo, minhaescola.lumied.com.br. Como ja temos um wildcard CNAME configurado no Cloudflare (*.lumied.com.br apontando para o Vercel), na maioria dos casos esse passo e automatico. O SSL tambem e provisionado automaticamente pelo Vercel.

Passo 6: Google OAuth

Adicionamos a redirect URI do novo projeto Supabase no Google Cloud Console para que o login com Google funcione. Passo rapido, menos de 1 minuto.

Passo 7: Setup Wizard

Este e o passo mais visual e importante para a escola. Ao acessar o sistema pela primeira vez, a escola encontra um wizard guiado que configura tudo de forma intuitiva:

Passo 8: Configuracao de secrets

No painel admin, configuramos as chaves de API necessarias — a principal e obrigatoria e a do Resend (para envio de emails). Chaves opcionais incluem Mercado Livre, Banco Inter e Google Maps, que podem ser adicionadas depois conforme a escola for ativando modulos avancados.

Passo 9: Teste final

Um teste rapido em todos os portais (pais, gerente, professora, secretaria, aluno) confirma que tudo esta funcionando. Login, navegacao, permissoes — tudo verificado em menos de 2 minutos.

O script que faz a magica acontecer

O arquivo deploy-novo-cliente.sh e o heroi silencioso de todo esse processo. Ele recebe dois parametros — o REF do projeto Supabase e o token de acesso — e faz todo o trabalho pesado automaticamente.

Na pratica, o script executa as seguintes operacoes:

• Migrations sequenciais: executa todas as 82 migrations SQL na ordem correta, criando tabelas, indices, funcoes, triggers e policies de RLS.
• Deploy de edge functions: deploya todas as 19 funcoes serverless (admin, api, diplomas, academico, comunicacao, cobranca, operacional, financeiro-ext, rh, loja, health, ticket-resolver e mais).
• Configuracao de cron jobs: agenda as tarefas recorrentes como cobranca automatica, resolucao de tickets a cada 15 minutos e digest diario.
• Validacao: ao final, verifica se todas as tabelas foram criadas e se as funcoes estao respondendo corretamente.

A beleza desse approach e a reprodutibilidade. Toda escola recebe exatamente a mesma base — mesmas tabelas, mesmas regras, mesmas funcoes. Nao existe "aquela escola que foi configurada diferente porque o tecnico esqueceu um passo". A automacao elimina a variabilidade humana.

Setup Wizard: a escola se configura sozinha

Apos o deploy tecnico, o Setup Wizard e a interface que conecta a tecnologia ao mundo real da escola. Em vez de planilhas de configuracao enviadas por email ou reunioes de levantamento de requisitos, a propria equipe da escola preenche as informacoes necessarias em uma interface visual guiada.

Dados da escola

Nome completo, CNPJ, endereco, telefone e logo. Essas informacoes aparecem em todos os portais, comunicados, boletos e documentos gerados pelo sistema. A escola pode alterar esses dados a qualquer momento depois.

Identidade visual

O wizard permite escolher as cores primaria e secundaria da escola e selecionar entre 4 temas visuais: Corporativo (tons escuros, profissional), Ludico (cores vibrantes, ideal para educacao infantil), Serio (minimalista, discreto) e Interativo (moderno, com animacoes). O resultado e um sistema que parece ter sido feito sob medida para a escola.

Modulos ativos

Dependendo do plano contratado, a escola pode ativar ou desativar modulos especificos: agenda digital, controle de frequencia, financeiro, cantina, transporte, biblioteca, loja virtual, entre outros. O sistema de feature gating garante que cada escola veja apenas os modulos que fazem parte do seu plano.

Primeiro gerente

O wizard finaliza com o cadastro do primeiro usuario gerente — a pessoa que vai administrar o sistema no dia a dia. Esse usuario recebe permissao total e pode, a partir dai, cadastrar professores, turmas, alunos e responsaveis.

Arquitetura multi-tenant: o que torna tudo possivel

A velocidade do deploy nao e acidental — ela e consequencia direta de decisoes arquiteturais tomadas no inicio do projeto. O Lumied utiliza uma arquitetura multi-tenant com isolamento por projeto, o que significa que cada escola tem seu proprio banco de dados, suas proprias funcoes serverless e seu proprio subdominio.

Essa abordagem traz vantagens fundamentais:

• Isolamento total de dados: os dados de uma escola nunca se misturam com os de outra. Cada banco e independente, com suas proprias policies de seguranca.
• Escalabilidade independente: se uma escola cresce e precisa de mais recursos, isso nao afeta as demais.
• Deploy padronizado: como todas as escolas compartilham o mesmo codigo-fonte (mas com bancos separados), o script de deploy funciona identicamente para qualquer nova escola.
• Atualizacoes simultaneas: quando lancamos uma nova funcionalidade, todas as escolas recebem automaticamente via Vercel (frontend) e Supabase (backend).
• Feature gating granular: mesmo compartilhando o mesmo codigo, cada escola ve apenas os modulos do seu plano, gracas ao sistema de plano_modulos e escola_modulos.

White-label: a escola com sua propria marca

Um dos diferenciais mais valorizados pelas escolas e a capacidade white-label do Lumied. Cada escola nao apenas recebe seu proprio subdominio, mas tambem personaliza completamente a aparencia do sistema para que ele parecas ter sido desenvolvido exclusivamente para ela.

Na pratica, isso significa que quando um pai acessa minhaescola.lumied.com.br, ele ve o logo da escola, as cores da escola, e ate o nome da escola na barra do navegador. Nao existe nenhuma referencia ao Lumied na interface do usuario final — a experiencia e 100% branded.

Essa personalizacao inclui:

• Subdominio exclusivo: cada escola tem seu endereco proprio na web.
• Logo e favicon: o logo da escola aparece no header, nas telas de login e nos emails.
• Cores personalizadas: primaria e secundaria, aplicadas em botoes, headers, menus e destaques.
• Tema visual: escolha entre 4 temas que alteram fontes, espacamentos e estilo geral.
• Emails com branding: todos os emails enviados pelo sistema (comunicados, boletos, convites) levam a marca da escola.

White-label nao e um recurso premium — e o padrao. Toda escola no Lumied tem sua propria identidade visual desde o primeiro minuto.

Seguranca nao e opcional

Velocidade de deploy nao significa atalhos em seguranca. Cada escola deployada pelo script recebe automaticamente todas as camadas de protecao do Lumied:

• RLS (Row Level Security): habilitado em todas as 30+ tabelas com policies restritivas. Cada usuario so acessa os dados que lhe pertencem.
• Rate limiting: em todas as 19 edge functions para prevenir abuso.
• Input validation: schemas de validacao e sanitizacao XSS em todas as entradas de dados.
• WebAuthn/biometria: login com Face ID e impressao digital disponivel desde o primeiro acesso.
• LGPD compliance: consentimento, exportacao de dados, anonimizacao e audit log configurados automaticamente.
• SSL automatico: certificado HTTPS provisionado pelo Vercel sem nenhuma intervencao manual.

Tudo isso vem configurado por padrao, sem que a escola precise fazer nada. A seguranca e parte do script, nao um passo opcional que alguem pode esquecer.

Resultados: do contrato a producao em 15 minutos

O deploy automatizado do Lumied nao e apenas uma conveniencia tecnica — ele transforma fundamentalmente a experiencia de adocao de um software escolar. Os resultados praticos sao significativos:

Para a escola, a experiencia e transformadora. Em vez de semanas ansiando pelo "go-live", a diretora sai da reuniao de assinatura com o sistema funcionando no celular. Professores podem comecar a usar no dia seguinte. Pais recebem o convite de acesso na mesma semana. O momentum da decisao de contratar e canalizado diretamente para a adocao — sem perda de energia, sem frustacao, sem desistencias.

O futuro: ainda mais rapido

Estamos trabalhando para reduzir ainda mais esse tempo. Com a automacao de passos que hoje ainda exigem interacao manual (como a criacao do projeto Supabase e a configuracao do Google OAuth via API), o objetivo e chegar a um deploy completamente self-service: a escola preenche um formulario, clica em "Criar minha escola", e em menos de 5 minutos esta tudo pronto. Sem interacao humana, sem espera, sem fricao.

O deploy em 15 minutos nao e apenas um numero de marketing — e uma filosofia. Se a tecnologia existe para simplificar a vida das escolas, entao o primeiro contato com essa tecnologia precisa ser simples tambem. E nisso, o Lumied esta redefinindo o padrao do mercado.