A SolarOrbita centraliza toda a gestão do seu negócio de energia solar — do primeiro contato com o cliente até o pagamento final. Com transparência total e controle em cada etapa, você acompanha o ciclo completo do projeto numa única plataforma multi-tenant SaaS.
Conheça os módulos disponíveis na barra lateral e o que cada um faz:
Visão executiva com cascata de estados, KPIs em tempo real e BI integrado.
Gestão de leads, funil de vendas Kanban e clientes com código CLI-2026-XXXX.
Criação com dimensionamento automático, preços ocultos, FDI 1.0-1.5 e snapshot de cotação.
Simulação rápida de dimensionamento e retorno financeiro sem criar proposta.
Hierarquia Técnica→Prestador→Funcionário, OS, catálogo de equipamentos e prestadores.
5 processos (Engenharia, Compras, Instalação, Vistoria Pré/Pós) e Kanban de estados.
Gestão de contratos, conferência de documentos e liberação de OS.
OC nasce da cascata do aceite, gate financeiro, entrada de estoque e fornecedores.
10 abas: lançamentos, DRE, fluxo de caixa, balanço, conciliação, régua de cobrança.
Chat interno vinculado a projeto/OS/proposta com badges de não-lidas.
Comercial, Financeiro, Marketing e Exportação com visões departamentais.
Cadastro direto, níveis 0-7, ID MS-XXXX imutável e log de auditoria.
Convite obrigatório com token, Admin Geral, expiração 7d, permissões antes do envio.
Dados da empresa, regime fiscal (Simples/Presumido/Real), BDI e logo white-label.
Tickets TKT-2026-XXXX, SLA automático, prioridades e tradução bidirecional bilíngue.
Scanner de anomalias cross-tenant, correção 1-clique e monitoramento (super-admin).
SolarOrbita — Guia Completo da Plataforma
SolarOrbita · Português
A SolarOrbita centraliza toda a gestão do seu negócio de energia solar — do primeiro contato com o cliente até o pagamento final. Com transparência total e controle em cada etapa, você acompanha o ciclo completo do projeto numa única plataforma multi-tenant SaaS.
Conheça os módulos disponíveis na barra lateral e o que cada um faz:
Visão executiva com cascata de estados, KPIs em tempo real e BI integrado.
Gestão de leads, funil de vendas Kanban e clientes com código CLI-2026-XXXX.
Criação com dimensionamento automático, preços ocultos, FDI 1.0-1.5 e snapshot de cotação.
Simulação rápida de dimensionamento e retorno financeiro sem criar proposta.
Hierarquia Técnica→Prestador→Funcionário, OS, catálogo de equipamentos e prestadores.
5 processos (Engenharia, Compras, Instalação, Vistoria Pré/Pós) e Kanban de estados.
Gestão de contratos, conferência de documentos e liberação de OS.
OC nasce da cascata do aceite, gate financeiro, entrada de estoque e fornecedores.
10 abas: lançamentos, DRE, fluxo de caixa, balanço, conciliação, régua de cobrança.
Chat interno vinculado a projeto/OS/proposta com badges de não-lidas.
Comercial, Financeiro, Marketing e Exportação com visões departamentais.
Cadastro direto, níveis 0-7, ID MS-XXXX imutável e log de auditoria.
Convite obrigatório com token, Admin Geral, expiração 7d, permissões antes do envio.
Dados da empresa, regime fiscal (Simples/Presumido/Real), BDI e logo white-label.
Tickets TKT-2026-XXXX, SLA automático, prioridades e tradução bidirecional bilíngue.
Scanner de anomalias cross-tenant, correção 1-clique e monitoramento (super-admin).
O Ecossistema Orbita é o conjunto de agentes de IA que automatizam a jornada do lead ao recebível. Cada agente é especialista em uma etapa do ciclo e se conecta ao SolarOrbita para ler e gravar dados no banco do tenant, sempre respeitando o isolamento multi-tenant (RLS por organizacao_id).
Apresentar os 5 agentes do ecossistema e como cada um se conecta ao SolarOrbita.
Captação de leads via Instagram e e-mail. Gera plano de marketing, calendário editorial e conteúdo. Escreve no SolarOrbita via PlanoMarketing, ConteudoMarketing e CanalCaptacao.
Qualificação e nurturing de leads. Acompanha o funil, dispara follow-ups pela régua e mantém o lead aquecido. Atua sobre Cliente/Lead, ReguaFollowup e FollowupEnviado.
Criação de propostas e contratos. A Valentina busca contatos no Agendor via API e chama a função backend criarLeadsAgendor para criar/atualizar leads no CRM. A partir dos dados do cliente, gera a Proposta e o Contrato.
Cobrança, conciliação Asaas e DRE. Gera cobranças via gateway, concilia recebimentos e alimenta o DRE do tenant. Atua sobre LancamentoFinanceiro e CobrancaAsaas.
Segurança e compliance. Monitora acessos, registra requisições LGPD e garante o isolamento multi-tenant (RLS por organizacao_id). Atua sobre RegistroLGPD e SecurityLog.
A jornada automatizada do lead ao recebível:
Cada agente se conecta ao SolarOrbita:
O onboarding é o momento em que uma nova empresa se cadastra na plataforma. O primeiro usuário criado vira automaticamente o Admin Geral do tenant, com poder total para convidar a equipe e definir papéis.
Explicar o cadastro da empresa e como o primeiro usuário se torna Admin Geral automaticamente.
Tela de cadastro acessível via landing page ou link direto.
Abrir /cadastro-trialA empresa acessa a tela de cadastro (cadastro-trial) via landing page ou link direto. O país é detectado pelo navegador, definindo idioma e moeda.
Preenche: razão social, CNPJ (ou equivalente do país), e-mail do responsável, telefone. Esses dados criam a organização (tenant).
O e-mail do responsável cria o primeiro usuário do tenant. Ele ainda não é admin — é um usuário comum aguardando o primeiro login.
No primeiro login, o sistema promove automaticamente esse usuário a Admin Geral (Nível 1). Ele ganha poder total sobre o tenant.
Como Admin Geral, ele acessa "Usuários" e cadastra membros diretamente ou envia convites com token. Cada convite define o papel (role) e nível de acesso.
O Admin Geral define quem é admin, vendedor, técnico, financeiro ou operacional. Os papéis controlam o acesso a cada módulo via RBAC de 8 níveis.
O onboarding é o ponto de partida do tenant:
O Dashboard é o painel executivo que consolida toda a operação numa única visão. A cascata de estados mostra exatamente onde cada projeto está no ciclo: Lead → Proposta → Validação Técnica → Aceite → Contrato → OS → Homologação → Recebível.
Acompanhar KPIs em tempo real e visualizar a cascata de estados de todos os projetos do tenant.
Item "Dashboard" no topo da barra lateral.
Abrir /dashboardPropostas geradas, OS em andamento, recebido no mês, a receber. Cada KPI é clicável e leva à lista filtrada.
O tracker "Fluxo Integrado" mostra cada projeto navegando pelas etapas: Proposta → Validação → Contrato → OS → OC → Estoque → Instalação → Vistoria → Homologação → Recebível.
O FluxoIntegradoTracker mostra o progresso de cada projeto_id em uma barra horizontal com as etapas concluídas (verde) e pendentes (cinza).
Seções de BI com funil de conversão, evolução mensal, projeção de receita e alertas de negócio — alimentados pela função dadosRelatorioBI.
Filtros rápidos por departamento: CRM, Técnico, OS, Compras, Estoque e Financeiro — cada um com KPIs específicos.
O Dashboard conecta dados de todos os departamentos:
O cadastro de clientes é onde a jornada começa. Ao cadastrar um cliente, ele entra automaticamente no funil CRM na etapa "Em Contato" e recebe um código sequencial CLI-2026-XXXX imutável.
Registrar e organizar clientes no CRM, gerando funil de vendas e código CLI imutável para rastreabilidade.
Item "Clientes · CRM" na barra lateral.
Abrir /clientesClique em "Clientes · CRM" na barra lateral. Você verá o funil Kanban e a lista de clientes.
Clique no botão "Novo Lead" ou "Novo Cliente" no topo da página.
Preencha: nome, e-mail, telefone, cidade e estado. Esses dados são mínimos para iniciar o relacionamento.
Ao salvar, o sistema gera automaticamente um código sequencial CLI-2026-XXXX (ex: CLI-2026-0001). Este código é imutável e vincula o cliente a todas as etapas do ciclo.
O cliente entra automaticamente no funil Kanban na etapa "Em Contato". Arraste o card pelas etapas conforme avança: Em Contato → Negociação → Proposta → Fechado.
Se disponível, informe a UC (Unidade Consumidora) e o consumo mensal. Isso acelera o dimensionamento automático na proposta.
O cliente cadastrado alimenta todo o ciclo:
A proposta é o coração da operação. O dimensionamento é automático (consumo → potência via HSP → qtd de módulos), os preços ficam ocultos durante a seleção de equipamentos (só aparecem no resumo final), o FDI é mantido entre 1.0 e 1.5, e a cotação é travada em um snapshot imutável no envio.
Criar propostas técnicas com dimensionamento automático, preços ocultos na seleção, FDI controlado, parâmetros comerciais/BDI antes do fiscal e snapshot de cotação imutável.
Item "Propostas" → "Nova Proposta" na barra lateral.
Abrir /nova-propostaSelecione o cliente (vinculado ao CRM) ou crie um novo. Informe cidade, estado e grupo tarifário. A irradiância é obtida automaticamente da capital do estado.
Informe o consumo mensal (12 meses ou média). O sistema usa fallback entre consumo anual/mensal para o cálculo.
O sistema calcula automaticamente: potência necessária (kWp) = consumo_anual_kWh / (HSP × 365 × 1/perdas), e qtd de módulos = potência / potência_unitária (arredondado para cima). O rótulo de "Qtd. de Módulos" indica se é automático ou manual.
O Fator de Dimensionamento do Inversor (FDI) é automaticamente sugerido com base na faixa ABNT NBR 16149 (0.75x–1.30x) e mantido entre 1.0 e 1.5 como gate impeditivo.
Escolha módulos, inversores, acessórios, baterias, fixação, projeto e frete do catálogo. Os preços unitários ficam OCULTOS durante a seleção — só aparecem no resumo final.
Antes do fiscal, configure: BDI Material, BDI Serviço, Comissão, Financeiro, Desconto. Estes parâmetros comerciais são exibidos no resumo antes dos dados fiscais.
Revise impostos (Simples/Presumido/Real), ICMS, PIS, COFINS. O toggle "aplica_fiscal" define se os tributos são incluídos no valor total — congelado no snapshot imutável.
Ao enviar a proposta, a cotação é TRAVADA (cotacao_travada_proposta) e os parâmetros fiscais são congelados (parametros_fiscais_snapshot). Nada muda após o envio, protegendo contra variações.
Ao enviar, a proposta entra no estado "aguardando_tecnico" e vai para a fila do engenheiro. A cascata (Contrato + OS + Recebíveis) só dispara no aceite do cliente.
A proposta passa OBRIGATORIAMENTE por validação técnica antes de chegar ao cliente. Sem aprovação do engenheiro, nada avança.
A proposta é o nó central do ciclo:
O Simulador permite calcular dimensionamento e retorno financeiro rapidamente, sem precisar criar uma proposta formal. Ideal para atendimento rápido de clientes e pré-venda.
Simular dimensionamento solar e retorno financeiro (payback, ROI) de forma rápida, sem criar proposta.
Item "Simulador" na barra lateral.
Abrir /simuladorInforme nome, cidade e estado. A irradiância solar é obtida automaticamente da capital do estado.
Digite o consumo mensal médio (kWh) ou os 12 meses. O sistema aceita fallback entre anual e mensal.
Selecione módulo e inversor do catálogo. O dimensionamento é calculado automaticamente.
O sistema mostra: potência do sistema (kWp), qtd de módulos, geração anual (kWh), área ocupada, payback, ROI 10/25 anos e economia anual.
Se o cliente aceitar, você pode converter a simulação em uma proposta formal com um clique — os dados são pré-preenchidos.
O simulador é a porta de entrada para propostas:
O Departamento Técnico é o guardião da qualidade. Toda proposta passa por validação técnica. A hierarquia é: Engenheiro/Técnico → Prestador Terceirizado → Funcionário do Terceirizado. Fotos de instalação e fechamento de OS com kwp real são registados em campo.
Validar propostas tecnicamente, gerenciar prestadores e seus funcionários, executar OS em campo com fotos e checklists.
Item "Depto. Técnico" na barra lateral — com sub-módulos: Propostas, OS, Kanban, Calendário, Catálogo, Prestadores.
Abrir /departamento-tecnicoAcesse "Depto. Técnico" → "Propostas". Filtre por "Aguardando Validação". Confira dimensionamento, FDI (1.0-1.5), compatibilidade elétrica (Voc, Isc) e projeto financeiro.
Aprove ("aprovada_tecnico") para liberar o envio ao cliente, ou solicite revisão ("reprovada_tecnico") com observações.
Em "Prestadores", cadastre empresas terceirizadas: razão social, CNPJ, contato, especialidade (Instalação, Manutenção, Vistoria) e área de atuação.
Cada prestador pode indicar funcionários (técnicos de campo) que executarão as OS. A OS vincula: terceirizado_id (empresa) + funcionario_terceirizado_id (pessoa que executa).
Quando uma OS é gerada (cascata do contrato assinado), o engenheiro atribui ao prestador, que atribui ao funcionário. O prestador pode questionar via chat da OS antes de aceitar.
No campo, o funcionário reporta: check-in, fotos de pré e pós-instalação, checklists (materiais, vistoria pré/pós), observações técnicas e km rodado. Tudo registado em tempo real.
Ao concluir, o funcionário/prestador fecha a OS. O status muda para "Concluída" com o kwp real do sistema instalado. O fechamento dispara o retorno ao financeiro (pagamento do prestador).
O departamento técnico protege toda a operação:
A Ordem de Serviço percorre 5 processos: Engenharia, Compras, Instalação, Vistoria Pré e Vistoria Concessionária. O Kanban mostra todos os estados: Criada → Liberada → Em Execução → Aguardando Vistoria → Homologação → Concluída. Cada OS carrega o kwp real do sistema instalado.
Gerenciar o ciclo completo da OS, desde a criação (cascata do contrato) até a homologação, com 5 processos, Kanban de estados e kwp real.
Item "Ordens de Serviço" na barra lateral.
Abrir /ordens-servicoA OS nasce da cascata do contrato assinado. O engenheiro define escopo, cronograma, checklist de materiais e atribui ao prestador/funcionário.
A OC é gerada automaticamente com snapshot dos equipamentos. O estoque é verificado. Se faltar material, a OC vai para "aguardando_liberacao" até o gate financeiro.
O prestador/funcionário executa em campo: check-in, fotos pré/pós, checklists (materiais, vistoria pré/pós), observações e km rodado.
Antes de ligar o sistema, o técnico faz a vistoria pré-instalação (checklist_vistoria_pre): estrutura, cabeamento, aterramento, inversor.
Após a instalação, o sistema é submetido à vistoria da concessionária (protocolo_concessionaria) e à homologação. O status muda para "Homologação" e depois "Concluída".
A OS percorre estados sequenciais visíveis no Kanban do Departamento Técnico:
A OS é a ponte entre contrato e financeiro:
O contrato é gerado automaticamente no aceite da proposta, mas passa por conferência administrativa obrigatória antes de ir para assinatura do cliente.
Gerar contratos automaticamente e garantir a conferência de documentos antes da assinatura.
Item "Contratos" no grupo "Administrativo" da barra lateral.
Abrir /contratosO aceite da proposta gera o contrato automaticamente (cascata). Ele aparece com status "Aguardando Documentos".
O administrativo acessa "Contratos", abre o contrato e confere os documentos do cliente (identidade, comprovante, etc.).
Após conferência, libere o contrato. Um link de assinatura é gerado e enviado ao cliente.
O cliente assina via gov.br, Clicksign, ou impresso + foto. O PDF assinado é anexado ao contrato.
Após a assinatura do cliente, a Ordem de Serviço é gerada automaticamente e vai para o departamento técnico.
O contrato costura o ciclo entre comercial e operacional:
A Ordem de Compra (OC) nasce automaticamente da cascata do aceite da proposta. O fornecedor é selecionado via dropdown, a OC passa por um gate financeiro (Aguardando Liberação → Aprovada) e, ao ser entregue, registra a entrada no estoque.
Gerenciar ordens de compra, fornecedores e estoque, com OC automática da cascata, gate financeiro e entrada de estoque.
Item "Compras" na barra lateral.
Abrir /comprasQuando o contrato é liberado/assinado, a OC é gerada automaticamente com snapshot dos equipamentos da proposta. Ela nasce no status "aguardando_liberacao".
Na OC, selecione o fornecedor via dropdown (apenas fornecedores ativos do tenant). O fornecedor_nome é preenchido automaticamente.
A OC passa pelo gate financeiro: "Aguardando Liberação" → "Aprovada" (ou "Rejeitada"). Só o Financeiro/Admin pode aprovar. A função gateOrdemCompra valida o fluxo.
Após aprovação, a OC vai para "confirmado" e depois "em_transito". O campo estoque_verificado indica se o estoque foi conferido.
Quando a OC é marcada como "entregue", a entrada no estoque é registrada automaticamente (função registrarEntradaEstoque). O flag estoque_entrada_registrada garante idempotência — a entrada só acontece uma vez.
Na aba "Fornecedores", cadastre: razão social, CNPJ, contato, materiais fornecidos (módulos, inversores, estruturas) e observações.
A OC percorre estados sequenciais com gate financeiro obrigatório:
A OC conecta propostas ao estoque:
O módulo de Mensagens é o chat interno da equipe. As mensagens podem ser vinculadas a uma OS, projeto ou proposta, criando threads de equipe. Badges de não-lidas em tempo real mantêm todos sincronizados.
Comunicar internamente com threads vinculadas a entidades do ciclo (OS, projeto, proposta).
Item "Mensagens" na barra lateral.
Abrir /mensagensEnvie mensagens privadas entre membros da equipe. O remetente e destinatário veem a conversa.
Marque a mensagem como visibilidade "equipe" para que toda a organização veja. Ideal para threads de OS/projeto/proposta.
Ao preencher os_id, projeto_id ou proposta_id, a mensagem fica vinculada à entidade. Acesse a OS/proposta e veja a thread no contexto.
Categorize: Geral, Cobrança, Falta de Material, Vistoria, NF Solicitada, Interno.
O badge no sidebar e no topbar mostra mensagens não-lidas em tempo real. A função marcarMensagensLidas atualiza o status via backend.
As mensagens conectam a equipe no contexto do ciclo:
O módulo de Relatórios consolida BI comercial, financeiro e marketing com visões departamentais, ranking de vendedores, previsão de faturamento e exportação para Excel.
Analisar funil, financeiro, origem de leads e exportar dados para Excel.
Item "Relatórios" na barra lateral.
Abrir /relatoriosFunil de conversão, propostas por status, ranking de vendedores, conversão por origem do lead e previsão de faturamento.
DRE, fluxo de caixa projetado, margem de lucro por projeto, conciliação bancária com IA e métricas por projeto.
Origem de leads (landing, indicação, anúncio, evento), ROI por canal de aquisição e conversão por origem.
Visão executiva com paleta grafite/navy e detalhes dourados, tabelas densas tipo Power BI para o super-admin.
Exporte qualquer relatório para Excel com um clique. A função exportarLancamentosCSV gera CSV estruturado.
Os relatórios cruzam dados de todos os módulos:
O Financeiro é o módulo mais completo da plataforma. São 10 abas que cobrem desde lançamentos manuais até DRE, fluxo de caixa projetado, balanço patrimonial, conciliação bancária com IA, régua de cobrança, métricas por projeto e pagamento a prestadores. O motor automático contrato→lançamento gera recebíveis no aceite.
Gerenciar toda a vida financeira do tenant: lançamentos, DRE, fluxo de caixa, balanço, conciliação, cobrança, margem e pagamentos.
Item "Financeiro" na barra lateral.
Abrir /financeiroCRUD de LancamentoFinanceiro (receita/despesa). Campos: tipo, categoria, valor, competência mês/ano, centro de custo, conta contábil.
Demonstração do Resultado do Exercício. Consolida receitas, deduções, custos e despesas por competência. Gráficos de evolução mensal.
Projeção de recebimentos e pagamentos por período, com base nos lançamentos "a_receber" e "a_pagar" e nas parcelas do contrato.
Ativos, passivos e patrimônio líquido. Inclui gestão de PatrimonioAtivo (veículos, equipamentos, imóveis).
A IA cruza lançamentos com extratos bancários, identificando discrepâncias e sugerindo matches.
Cobrança de cliente final via Asaas (boleto/PIX/cartão). Motor de juros/multa para parcelas vencidas. Régua SaaS controla o acesso do tenant.
Receita, custo e margem de lucro por projeto_id. Rastreabilidade financeira completa do ciclo Proposta→Contrato→OS→Recebível.
Relatório de margem por projeto e por mês, com breakdown de custos (materiais, mão de obra, terceiros).
Consolidação mensal: receita, despesa, resultado, KPIs financeiros e comparativo com meses anteriores.
Visão de faturamento realizado vs. previsto e controle de despesas fixas/variáveis por centro de custo.
O motor automático gera lançamentos financeiros a partir do contrato:
O financeiro é o destino final do ciclo comercial:
O módulo de Usuários permite cadastrar membros diretamente (sem convite) ou via convite. Cada membro recebe um ID sequencial MS-XXXX imutável (ex: MS-0001). Os níveis de acesso RBAC vão de 0 (Super Admin) a 7 (Terceirizado). Toda alteração é registrada no log de auditoria.
Cadastrar membros, definir níveis de acesso (0-7), gerar IDs MS-XXXX imutáveis e manter log de auditoria.
Item "Usuários" na barra lateral.
Abrir /usuariosVisão unificada: Cadastrados + Convidados + Usuários logados, sem duplicidade (merge por email).
O Admin Geral pode cadastrar membros diretamente: nome, e-mail, telefone, cargo, departamento, role. O membro recebe status "cadastrado_direto" e fica aguardando o 1º login.
Ao cadastrar, o sistema gera um ID sequencial MS-XXXX (ex: MS-0001). Este ID é a chave de referência para TODOS os processos (propostas, OS, contratos, histórico). Nunca muda.
0=Super Admin Órbita, 1=Admin Geral, 2=Técnico Admin, 3=Gerente Vendas, 4=Vendedor, 5=Financeiro, 6=Operacional/Técnico, 7=Terceirizado. Os níveis controlam o acesso a cada módulo.
Quando o membro faz o 1º login (via convite ou cadastro direto), o sistema faz o merge com o User de auth. O status muda para "ativo" e user_id é preenchido.
Toda alteração (criar, editar, ativar/desativar, excluir) é registrada em LogAuditoriaMembro com: código_membro, admin_id, ação, alterações (JSON) e timestamp.
Toda edição de membros passa pela função gerenciarMembro (service role), que valida: nome do membro ≠ razão_social da organização, e impede rebaixamento do último Admin Geral (Nível 1).
Os usuários são governados por RBAC e auditoria:
O acesso ao tenant é permitido exclusivamente via fluxo de ConviteOrganizacao. Só o Admin Geral (Nível 1) pode convidar. O convite tem token, expira em 7 dias, e as permissões são definidas antes do envio (imutáveis após).
Convidar usuários para o tenant com token, expiração de 7d e permissões definidas antes do envio.
Item "Convites" na barra lateral.
Abrir /convitesSó usuários com nível Admin Geral (1) podem gerar/enviar convites. Outros níveis não veem a opção.
Antes de enviar, o Admin escolhe: papel_rbac (ex: "Gerente Vendas"), role (ex: "gerente"). Estas permissões são IMUTÁVEIS após o envio.
O sistema gera um convite com token único e data_expiracao = data_convite + 7 dias. O status começa como "pendente".
O e-mail é enviado ao convidado com o link de acesso. O campo convidado_por registra quem enviou (trilha de auditoria).
Quando o convidado faz o 1º login, o convite é consumido (status "consumido"). O usuário é vinculado ao tenant com o papel definido no convite.
Após 7 dias sem login, o convite expira (status "expirado"). O Admin pode cancelar convites pendentes (status "cancelado").
O Admin pode reenviar um convite, o que renova a data_expiracao (+7 dias) e atualiza o status para "pendente".
O fluxo de convites é blindado:
O convite é a única porta de entrada no tenant:
O módulo de Configurações centraliza: dados da empresa, regime tributário (Simples Nacional, Lucro Presumido ou Lucro Real), alíquotas e BDI, e a logo white-label por tenant (persistida via função backend dedicada).
Configurar dados da empresa, regime fiscal, parâmetros BDI e logo white-label.
Item "Configurações" na barra lateral.
Abrir /configuracoesRazão social, CNPJ, telefone, e-mail do responsável, endereço. Estes dados aparecem nas propostas e contratos.
Escolha: Simples Nacional (DAS unificado), Lucro Presumido (PIS 0.65% + COFINS 3%) ou Lucro Real (não-cumulativo). As alíquotas são usadas no cálculo de propostas.
Configure: ICMS %, PIS %, COFINS %, ISS %, IRPJ/CSLL %, margem de venda %, frete %, outros encargos %.
BDI Material %, BDI Serviço %, Comissão do vendedor %, Financeiro %, Desconto %. Estes parâmetros são exibidos no resumo da proposta antes dos dados fiscais.
Dois toggles independentes: "ativo" (parâmetros fiscais) e "comerciais_ativos" (BDI/comissão). Permitem incluir ou não tributos no valor total.
Upload da logo do tenant. Persistida via função backend salvarLogoOrganizacao (service role) para isolamento. A logo substitui a marca SolarOrbita em todo o app.
Abas: Auditoria, Segurança, Funis, Notificações e Permissões — cada um com controles específicos para o Admin Geral.
As configurações alimentam todo o sistema:
O módulo de Suporte é o sistema de tickets bidirecional com SLA automático. Cada ticket recebe um código TKT-2026-XXXX. As prioridades definem o SLA (Urgente 4h, Alta 24h, Média 72h, Baixa 7d). A tradução é bidirecional e bilíngue: cliente escreve em EN/FR, equipe vê em PT-BR, e vice-versa.
Gerenciar tickets de suporte com SLA automático, prioridades e tradução bidirecional bilíngue.
Item "Suporte" na barra lateral (visão da equipe) e "Painel de Suporte" para o super-admin.
Abrir /suporteClique em "Novo Ticket". Informe: título, categoria (Financeiro, Técnico, Proposta, Acesso, Outro), prioridade (Urgente, Alta, Média, Baixa), origem (Interno/Cliente) e descrição.
Ao criar, o sistema gera automaticamente o código sequencial TKT-2026-XXXX (ex: TKT-2026-0001). Imutável e vinculado ao tenant.
O SLA é calculado na criação: Urgente 4h, Alta 24h, Média 72h, Baixa 7d. O campo sla_prazo armazena o deadline. A função verificarSlaTickets marca sla_estourado=true quando o prazo vence.
Na conversa do ticket, atribua um responsável pelo atendimento. O status muda para "Em Atendimento".
A conversa é uma thread de MensagemTicket. Equipe e cliente trocam mensagens. Badge de não-lidas em tempo real.
Quando o cliente escreve em EN/FR, a mensagem é traduzida para PT-BR (mensagem_traduzida_pt) para a equipe. Quando a equipe responde em PT-BR, a mensagem é traduzida para o idioma do cliente (mensagem_traduzida). Badge "Tradução PT-BR" aparece na thread.
Mude o status para "Resolvido" ou "Fechado". A data_resolucao é registrada e o tempo médio de resolução é calculado nos KPIs.
O SLA é calculado automaticamente na criação do ticket:
O suporte integra tenant, SLA e i18n:
No modelo SaaS multi-tenant, cada cliente começa com o catálogo VAZIO e cadastra os próprios produtos. O catálogo é isolado por organização — nenhum tenant vê os produtos de outro.
Cadastrar produtos manualmente ou via importador PDF com IA e supervisão técnica obrigatória.
Item "Depto. Técnico" → "Catálogo" ou "Catálogo de Equipamentos".
Abrir /departamento-tecnico/catalogoCada tenant novo começa com catálogo vazio. O Admin Geral ou técnico cadastra os produtos da sua empresa.
Acesse "Depto. Técnico" → "Catálogo" e clique em "Novo Produto". Preencha: nome, marca, modelo, potência, preço, especificações técnicas.
Cadastre módulos, inversores, baterias, acessórios, fixações, projetos e fretes — cada um com seus campos específicos.
Envie um PDF do catálogo do fabricante. A IA extrai os produtos automaticamente (marca, modelo, potência, preço).
Após a extração, o técnico REVISA os dados extraídos antes de gravar no banco. Nenhum produto entra no catálogo sem revisão humana.
O catálogo é isolado por organizacao_id. As propostas só usam produtos do catálogo do próprio tenant.
O catálogo alimenta as propostas e é isolado por tenant:
A plataforma é bilíngue (PT-BR/EN-US). O idioma é detectado automaticamente pelo navegador. O câmbio é travado no envio da proposta com margem de +3%. O gateway de pagamento varia por país: Asaas no Brasil, Stripe no exterior.
Explicar o sistema de internacionalização: idiomas, detecção, câmbio travado e gateways por país.
Seletor de país no header. Configurações de moeda em "Configurações".
Abrir /configuracoesAo acessar a plataforma, o sistema detecta o idioma do navegador. Se for PT-BR, carrega em português; caso contrário, em inglês (EN-US). O usuário pode trocar manualmente via seletor de país.
No header, o seletor de país mostra bandeira, nome do país e moeda. Ao trocar, o idioma e a moeda mudam simultaneamente.
Toda a interface, manual, propostas e tickets de suporte suportam PT-BR e EN-US. O manual é exportável em PDF no idioma selecionado.
Ao enviar a proposta ao cliente, a cotação é TRAVADA (cotacao_travada_proposta) com margem de +3%. O cliente vê o preço na moeda escolhida, estável até o aceite. O valor BRL é preservado no banco.
Quando o país muda (ex: en-US), a ficha cadastral do cliente se adapta ao padrão do país (campos, formatação, moeda, documentos).
Brasil: cobrança via Asaas (boleto, PIX, cartão). Exterior: cobrança via Stripe (cartão, subscriptions). A escolha é automática baseada no país do tenant.
O snapshot de governança comercial (lei de proteção de dados, órgão regulador, regras de NF) é aplicado no cadastro do tenant conforme o país.
A internacionalização afeta todo o sistema:
A régua de cobrança controla o acesso do tenant à plataforma. Trial de 14 dias sem cartão, notificações de vencimento e bloqueio automático em D+15 — tudo transparente para o cliente.
Explicar o trial de 14 dias e o bloqueio automático em D+15 da assinatura SaaS.
Política de cobrança acessível via landing page. A régua roda automaticamente no backend.
Abrir /politica-cobrancaAo se cadastrar, o tenant entra em Trial por 14 dias. Sem cartão de crédito. Acesso completo a todos os módulos.
O sistema envia notificações D+3, D+7 e D+10 após o vencimento do trial, lembrando o cliente de assinar o plano.
Se o pagamento não for confirmado, o tenant é bloqueado automaticamente 15 dias após o vencimento (D+15). O acesso à plataforma é suspenso.
Quando o pagamento da assinatura é confirmado, o tenant é reativado e o acesso é restaurado.
Tenants com is_piloto=true são isentos de cobrança e não entram na régua de bloqueio.
A régua de cobrança controla o acesso de todos os tenants:
Do primeiro contato ao pagamento final, todo o ciclo é costurado por um único identificador: o projeto_id. Ele garante que proposta, contrato, OS, OC, estoque e recebíveis permaneçam sincronizados do início ao fim.
A jornada completa do cliente na plataforma — cada etapa conectada, com gates obrigatórios:
Todo o ciclo é costurado por um único identificador — o projeto_id. Ele garante que proposta, contrato, OS e recebíveis permaneçam sincronizados do início ao fim, permitindo rastreabilidade total em qualquer etapa do projeto.
Este manual é interativo e bilíngue (PT-BR/EN-US). Navegue pelos capítulos na barra lateral, troque o idioma no seletor de país, e exporte o PDF completo no idioma selecionado.
Ensinar a navegar, trocar idioma e exportar o manual em PDF.
Item "Manual" na barra lateral.
Abrir /manualNa barra lateral esquerda (desktop) ou no seletor superior (mobile), clique em qualquer capítulo para navegar. Os capítulos são numerados e seguem a ordem do ciclo de negócio.
Use o seletor de país no header para trocar entre PT-BR e EN-US. Todo o conteúdo do manual muda instantaneamente, incluindo títulos, passos e descrições.
Capítulos marcados com "Super-Admin" (Debug de Admin, Painel Global) só aparecem para usuários com role super_admin.
Clique no botão "Exportar PDF" no canto superior direito. O sistema gera um PDF completo (A4) com todos os capítulos no idioma atual. O arquivo é nomeado Manual_SolarOrbita_PT.pdf ou Manual_SolarOrbita_EN.pdf.
Cada capítulo tem um botão "Abrir" que leva direto ao módulo correspondente no sistema, para você praticar enquanto lê.
Alguns capítulos incluem mini-diagramas e fluxos visuais que mostram a jornada e a sincronização entre módulos.
O manual é parte do ecossistema SolarOrbita: