Manual de Utilização — Sistema ITEI

Portal institucional, área do associado, painel administrativo, advogados, parceiros e cadastro em campanha

Site: https://itei.org.br

Versão do manual: setembro/2026 (rev. dinheiro, caixa e credenciais)

Sumário

1. Visão geral
2. Site público
3. Portal do Associado
4. Painel Administrativo
5. Painel do Advogado
6. Portal do Parceiro
7. Módulo de Campanha
8. Pagamentos
9. Validação da carteirinha (balcão)
10. AcquaH2
11. Plataforma EAD (Escola Avançada)
12. Jobs automáticos (cron)
13. Credenciais de acesso (ambiente de demonstração)
14. Perguntas frequentes
15. Roadmap — Moeda ITEI (prep)
16. Serviços por cidade
17. Articuladores — repasse por cidade

1. Visão geral

O sistema ITEI é composto por sete áreas principais:

Módulos recentes (destaque)

2. Site público

URL: https://itei.org.br

Seções principais

• Início — apresentação do ITEI
• Saúde Digital / Nomofobia — Projeto Conexão Consciente com frentes Fundamental I, Fundamental II, Ensino Médio (Diagnóstico Cognitivo) e Famílias
• Associação (ITEI Família) — plano e CTA para associar-se
• Projetos / ODS — outros projetos e parcerias
• Contato — formulário (nome, e-mail, WhatsApp, município, mensagem)

Ações rápidas

• Área do Associado → login do portal
• Seja um Associado → seção do plano ITEI Família
• Envio de contato → notificação via WhatsApp (Z-API) para a equipe

3. Portal do Associado

Login: https://itei.org.br/portal-associado/login

Dados necessários para entrar

1. Matrícula ITEI (ex.: ITEI-2026-0001)
2. CPF do titular
3. Senha

Menu e funções

3.1 Início

Resumo do associado, status (Ativo / Pendência financeira), economia do mês e atalhos.

Se houver benefício AcquaH2, aparece aviso de reposição/entrega e card de acesso rápido.

3.2 Carteirinha Digital

• Exibe dados do titular e QR Code
• Botão Imprimir carteira
• Botão Enviar pelo WhatsApp — envia a carteirinha (dados + link de validação) via Z-API para o telefone cadastrado
• O QR aponta para a validação pública: /validar/[matrícula]

3.3 Guia de Convênios

URL: /portal-associado/convenios

• Busca e filtros por categoria
• Atalho para carteirinha antes de ir ao balcão
• Painel de economia (mês, ano, por parceiro e últimos usos registrados)
• Banner de alerta se houver pendência financeira ou carteira vencida
• Cada parceiro exibe código do balcão (ex.: ITEI-FAR-1234)
• Bloco Fidelidade dos parceiros (quando o comércio tiver campanha ativa e o associado já tiver visitas): progresso X/Y visitas, recompensa e aviso de que é programa do estabelecimento (não benefício ITEI)

Fluxo no estabelecimento:

1. Associado abre a carteirinha (QR Code).
2. Caixa escaneia → página mostra DESCONTO LIBERADO ou indisponível.
3. Caixa informa o código do parceiro, o valor da compra (para cupom do sorteio) e, opcionalmente, o valor economizado.
4. A economia entra no extrato do associado; o comércio pode ganhar cupom do sorteio e avançar na fidelização própria.

Associado ATIVO com carteira vencida ou status PENDENTE não recebe liberação de desconto.

3.4 Cursos do Estudante

URL: /portal-associado/cursos

• Plataformas EAD parceiras e Palavra de desconto (quando aplicável)
• Integração Escola Avançada: acesso ao portal do aluno (URL configurada, ex. login WhatsApp/método)
• Matrícula/pacote podem ser provisionados na campanha ou pelo admin (ver seção 11)

3.5 AcquaH2

URL: /portal-associado/acquah2

• Status do benefício (aguardando pagamento, ativo, suspenso…)
• Próxima reposição prevista
• Histórico de entregas: Aguardando envio / Enviado / Entregue
• Aviso se a mensalidade estiver em atraso (reposições gratuitas dependem de adimplência)

3.6 Central de Empregabilidade

URL: /portal-associado/vagas

• Vagas exclusivas publicadas por parceiros ITEI (filtro por cidade/UF)
• Candidatura com mensagem; opcional para dependente do titular
• Checkbox curso EAD concluído — parceiros podem priorizar na triagem
• Carteirinha em dia exigida para candidatar-se com prioridade
• Aba Minhas candidaturas com status (Nova, Em análise, Aprovada, Rejeitada, Contratada)

3.7 Orientação Jurídica

URL: /portal-associado/juridico

Fluxo: disclaimer → envio → protocolo JUR-AAAA-##### + WhatsApp → acompanhamento no histórico.

3.8 Financeiro

Lista as mensalidades (abertas, pagas, vencidas).

Banner permanente: *“Mantenha sua fatura em dia para não ter o desconto recusado no caixa.”*

Cobrança preventiva (automática via WhatsApp)

Job diário /api/cron/cobranca-preventiva (protegido por CRON_SECRET):

Faturas em atraso também passam a VENCIDA automaticamente.

O associado só fica plenamente ATIVO após a confirmação do pagamento da mensalidade em aberto (quando o cadastro foi feito como pendente).

4. Painel Administrativo

Login: https://itei.org.br/admin/login

Campos: e-mail + senha

O acesso a cada tela depende das permissões por módulo (Admin → Usuários Admin), exceto superAdmin.

4.1 Dashboard

Indicadores: total de associados, ativos, pendentes e faturas abertas.

Atalho para Novo associado.

4.2 Central de Módulos / Usuários Admin

• Mapa dos módulos liberados
• Cadastro de administradores e liberação por módulo (incluindo AcquaH2, Sorteios Parceiro, EAD, etc.)

4.3 Associados

• Buscar por nome, matrícula, CPF ou e-mail
• Novo associado — cadastro manual
• Detalhe: editar dados, palavra de desconto, dependentes, faturas, provisionamento EAD, exclusão
• Reenviar credenciais (WhatsApp) — gera nova senha do portal, envia portal + carteirinha + contrato PDF (se já aceito na campanha). Não reenvia Escola Avançada (use a seção EAD na mesma ficha).

4.4 Financeiro

Gestão global de mensalidades (filtros por status, busca, baixa, remoção).

Filtros extras: Dinheiro e Dinheiro pendente (método presencial / protocolo de caixa).

4.5 Campanhas

Gestão do módulo de inscrição em massa (ver seção 7):

• Criar/editar campanha (valor, parcelas, modos EAD e AcquaH2, kit, carência, contrato, flag Aceita dinheiro)
• Criar operador (e-mail + senha + campanha + flag Acesso ao caixa)
• Wizard de inscrição + tela Caixa (dinheiro) para quem tem o flag

Modos EAD da campanha:

• NENHUM — não provisiona
• PACOTE — pacote fixo
• ESCOLHA — operador escolhe entre pacotes permitidos
• TODOS — todos os cursos da plataforma

Contrato: texto, versão e “obrigatório no wizard” (aceite antes do WhatsApp de credenciais).

4.6 Jurídico e Advogados

• /admin/juridico — solicitações, atribuição, status, Meet, WhatsApp
• /admin/advogados — cadastro por área
• Portal associado: triagem em árvore, checklist por assunto, agenda com Meet automático (Jitsi), modelos com assinatura simples, kits Consumidor.gov/JEC, Meus processos (andamento em linguagem simples) + texto de honorários no contencioso
• Painel advogado: grade de disponibilidade, andamento do processo, gerar Meet, WhatsApp em mudanças relevantes

4.7 Convênios

Cadastro de parceiros (categoria, desconto, endereço, WhatsApp, regras, balcão).

Código do parceiro — usado no caixa (gerado automaticamente se vazio).

Link para gerenciar acesso ao Portal Parceiro.

Cadastro pelo site (/seja-parceiro): cria convênio + usuário inativos (origemCadastro=SITE). Em Convênios, a seção Pendentes do site permite Aprovar e liberar (ativa + gera código + WhatsApp ao parceiro) ou Recusar.

4.8 Portal Parceiro (usuários)

Crie usuário (e-mail + senha) vinculado a um convênio → https://itei.org.br/parceiro/login

Ou aguarde auto-cadastro do site e aprove em Convênios.

4.9 Sorteios Parceiro

URL: /admin/sorteios-parceiro

Módulo: Sorteios Parceiro

1. Crie o sorteio (nome, prêmio, início, fim, regras). Não crie períodos ABERTO sobrepostos.
2. Enquanto ABERTO, cada validação no balcão com valor da compra gera cupom ITEI-AAAAMM-000001.
3. Limite: 1 cupom por associado / dia / comércio (trava no banco).
4. Edite nome/prêmio/datas no detalhe; Exportar CSV lista todos os cupons.
5. Encerrar → Sortear ganhador (aleatório entre os cupons).
6. WhatsApp ao convênio ganhador e ao associado do cupom (quando houver telefone).
7. Associado vê os cupons em Portal → Meus cupons (/portal-associado/sorteio).

4.9.1 Fidelidade Parceiro (moderação)

URL: /admin/fidelidade-parceiro

Módulo: Fidelidade Parceiro

Lista campanhas criadas pelos lojistas; admin pode pausar/ativar. Edição de meta/estoque fica no portal do parceiro.

4.10 Empregabilidade

Métricas de vagas, candidaturas, contratações e retenção.

4.11 Plataformas EAD / Pacotes EAD

• Plataformas: URL, benefício, instruções, credenciais de API Escola Avançada (quando aplicável)
• Pacotes: vínculo ao código/pacote EA (ex.: pacote 11 = pacote completo)
• Portal do aluno: ESCOLA_AVANCADA_PORTAL_URL (ex.: .../metodo/login.php)

4.12 AcquaH2 (admin)

URL: /admin/acquah2

Módulo: acquah2

Lembretes WhatsApp ao admin Acqua (D−3 e no dia da reposição): variável ACQUA_ADMIN_WHATSAPP (fallback WHATSAPP_DESTINATION_PHONE).

Cron: /api/cron/acqua-reposicao (ver seção 12).

4.13 Articuladores (repasse)

URL: /admin/articuladores

Módulo: articuladores

Entidades, cidades, geração de títulos por competência e baixa. Ver §17.

5. Painel do Advogado

Login: https://itei.org.br/advogado/login

• Solicitações das áreas do cadastro
• Assumir, atualizar status, Meet, mensagem, anexos
• Notificações WhatsApp/e-mail

Advogados não vêm do seed. Cadastre-os no admin antes do primeiro acesso.

6. Portal do Parceiro

Login: https://itei.org.br/parceiro/login

Cadastro público: https://itei.org.br/seja-parceiro (vantagens + formulário; acesso só após liberação no admin).

Usuários: Admin → Portal Parceiro ou auto-cadastro aprovado em Admin → Convênios.

Se o login estiver correto mas o cadastro ainda inativo, a mensagem é: *cadastro aguardando liberação do ITEI*.

O código do parceiro é o mesmo do balcão (/validar/[matrícula]).

6.1 Fidelização (programa do lojista)

1. Parceiro cria/edita campanha (ex.: 5 visitas → café grátis; mês calendário ou últimos N dias).
2. Cada validação de desconto conta visita (padrão: 1 visita/dia).
3. No balcão, ao atingir a meta, aparece Resgatar agora.
4. Associado vê o progresso em Convênios; WhatsApp avisa “quase lá”, elegível e resgate confirmado.
5. Resgate também notifica o WhatsApp do convênio.

6.2 Sorteio ITEI × parceiro

1. Admin abre o sorteio do período (sem sobreposição ABERTO).
2. No balcão, validação com valor da compra → cupom numerado + WhatsApp ao associado.
3. Parceiro acompanha em Sorteio ITEI; associado em Meus cupons.
4. Admin sorteia → convênio e associado notificados.

7. Módulo de Campanha

Usado para cadastrar associados em massa em ações presenciais ou mutirões.

Login operador: https://itei.org.br/campanha/login

Admin também pode abrir o wizard pela sessão administrativa.

Menu do operador:

• Inscrições — lista
• Nova inscrição — wizard
• Caixa (dinheiro) — só aparece se o operador tiver flag Acesso ao caixa (admin sempre vê)

7.1 Preparação (Admin)

1. Admin → Campanhas
2. Crie a campanha (valor, parcelas, EAD, AcquaH2, kit, carência, contrato)
3. Marque Aceita dinheiro se a ação presencial receber espécie/maquininha
4. Crie operadores (e-mail + senha + campanha); marque Acesso ao caixa só para quem confirma recebimento presencial

Modos EAD: NENHUM / PACOTE / ESCOLHA / TODOS (ver 4.5).

Modos Acqua: kit vinculado; 1ª compra gera fatura Acqua separada; dependentes podem receber kit se marcado.

7.2 Fluxo do operador — Nova inscrição

URL: https://itei.org.br/campanha/novo

Passo 1 — Dados

• Campanha, nome, CPF, e-mail, telefone
• Senha opcional no formulário — será substituída no envio WhatsApp (o operador não vê a senha final)
• Dependentes (flags EAD / Acqua, e-mail/CPF/telefone quando EAD)
• Se modo ESCOLHA: selecionar o pacote EAD

Passo 2 — Parcelas

• Valor, quantidade, data da 1ª parcela
• Prévia de linhas Acqua (1ª compra), se houver

Passo 3 — Pagamento

Blocos independentes quando houver Acqua:

• Mensalidade: cartão recorrente / PIX / boleto / cartão avulso / Dinheiro (se a campanha aceitar)
• 1ª compra Acqua: PIX / boleto / cartão / Dinheiro

Dinheiro (presencial):

1. Operador gera o protocolo (ex.: ITEI-7K2M).
2. Não há botão “já paguei” no wizard.
3. Quem tem Acesso ao caixa confirma em Campanha → Caixa.
4. No confirmação: forma Espécie ou Maquininha + observação (bandeira, parcelas…).
5. A baixa responde rápido; ativação/EAD/Acqua seguem em segundo plano.

Após pagamento confirmado da mensalidade, associado tende a ATIVO.

Pagamento Acqua dispara hooks de 1ª aquisição / estoque.

Se o PIX “Confirmar pagamento” antigo só atualizava a tela, use no admin Acqua o botão Baixar estoque de 1ª compras já pagas, ou a API de confirmação de pagamento da campanha.

Passo 4 — Credenciais e contrato

Tela do operador mostra: nome, matrícula, palavra de desconto, telefone, status do envio WhatsApp.

A senha do portal não aparece (anti-fraude).

Se a campanha exige contrato: aceite eletrônico (nome + checkbox) → PDF; só depois o WhatsApp completo.

Envio automático (após pagamento + contrato, se obrigatório):

1. Nova senha do portal (rotacionada)
2. Mensagem de acesso ao portal
3. Carteirinha (QR)
4. PDF do contrato (se aceito)

Botões: Imprimir (sem senha), Reenviar WhatsApp, e-mail (sem senha), cadastrar próximo.

EAD: provisionamento após pagamento; WhatsApp da Escola Avançada segue as flags da plataforma (mensagem com Login e Senha, depois o link).

7.3 Caixa (dinheiro)

URL: https://itei.org.br/campanha/caixa

1. Buscar por protocolo, matrícula, CPF ou nome.
2. Conferir valor e associado.
3. Confirmar recebimento → Espécie ou Maquininha + observação.
4. Fatura some da lista; no admin Financeiro aparece método Dinheiro + observação.

Só operador com Acesso ao caixa ou admin. Cada baixa grava quem confirmou e quando.

7.4 Lista de inscrições

Em /campanha: data, associado, matrícula, status, parcelas.

8. Pagamentos

8.1 Gateway

PagBank (principal). Alternativas: Asaas e Mercado Pago (principalmente PIX).

8.2 PIX / Boleto / Cartão / Recorrente / Anuidade / Dinheiro

Mesmo fluxo do portal Financeiro e da campanha (QR, boleto com endereço, cartão até 12x, assinatura, anuidade com ANUIDADE_DESCONTO_PERCENTUAL).

Dinheiro é só na campanha (presencial), com protocolo e baixa autenticada no Caixa — ver seção 7.3.

8.3 Sandbox PagBank

Com PAGBANK_SANDBOX=true:

Não use cartão real no sandbox.

8.4 Webhook

https://itei.org.br/api/webhooks/pagbank

9. Validação da carteirinha (balcão)

Sem login: https://itei.org.br/validar/[MATRICULA]

O QR da carteirinha aponta para esse endereço.

Após DESCONTO LIBERADO

1. Código do parceiro (obrigatório)
2. Valor da compra — necessário para gerar cupom do sorteio ITEI
3. Valor economizado (opcional) — soma na economia do associado
4. Confirmar desconto

Resultado na tela

API: POST /api/public/convenio/confirmar-desconto

Corpo: { matricula, codigoParceiro, valorCompra?, valorEconomia? }

Resposta inclui fidelidade e cupomSorteio.

Resgate de fidelidade: POST /api/public/convenio/fidelidade/resgatar

{ matricula, codigoParceiro, campanhaId }

Elegibilidade de desconto: status ATIVO + carteira na validade.

10. AcquaH2

Regras de negócio

• Intervalo de reposição fixo por produto (kit usa o maior intervalo dos itens)
• Carência configurável na campanha (ex.: 5 dias de tolerância no atraso)
• 1ª compra = fatura separada (ehAcquaPrimeira)
• Reposições seguintes: gratuitas se associado adimplente
• Dependentes podem ter kit próprio
• Entrega = registro interno (sem logística externa)
• Status de envio: PENDENTE_ENVIO → ENVIADO → ENTREGUE

Papéis

Lembretes e cron

• WhatsApp admin: D−3 e no dia da reposição + alerta de fila pendente
• Job: /api/cron/acqua-reposicao com CRON_SECRET
• Env: ACQUA_ADMIN_WHATSAPP (opcional)

11. Plataforma EAD (Escola Avançada)

Integração (API)

Formato típico (domínio configurável):

Variáveis de ambiente (exemplo):

• ESCOLA_AVANCADA_API_URL
• ESCOLA_AVANCADA_API_TOKEN
• ESCOLA_AVANCADA_CADASTRO_ACAO=usuarios/novo
• ESCOLA_AVANCADA_MATRICULA_ACAO=usuarios/vinculocurso
• ESCOLA_AVANCADA_PACOTE_ID=11
• ESCOLA_AVANCADA_PORTAL_URL — link do aluno (ex. login WhatsApp)

Webhook Guru permanece opcional (fallback); o fluxo principal é cadastro + vínculo.

Após vínculo bem-sucedido

• Economia do mês pode ser atualizada com base nos preços promocionais dos cursos do pacote (regra: soma ÷ 12, truncada)
• Notificações de acesso (e-mail/WhatsApp) conforme flags da plataforma
• WhatsApp EAD: Login e Senha em linhas separadas, depois o link de acesso

Quem provisiona

• Wizard de campanha (após pagamento da 1ª mensalidade, titular/dependentes selecionados)
• Admin no detalhe do associado → seção Plataforma EAD (provisionar / reenviar EA)
• O botão Reenviar credenciais (WhatsApp) do portal não reenvia Escola Avançada

12. Jobs automáticos (cron)

Protegidos por CRON_SECRET (Authorization: Bearer …, header x-cron-secret ou ?secret=).

# Cobrança preventiva (WhatsApp + PIX)
curl -fsS -X POST -H "Authorization: Bearer SEU_CRON_SECRET" \
  https://itei.org.br/api/cron/cobranca-preventiva

# AcquaH2 — reposições + lembretes admin (D-3 / D0)
curl -fsS -X POST -H "Authorization: Bearer SEU_CRON_SECRET" \
  https://itei.org.br/api/cron/acqua-reposicao

Agende diariamente (ex.: 10h).

13. Credenciais de acesso (ambiente de demonstração)

Geradas pelo seed (npm run db:seed), exceto advogados e usuários de parceiro:

Em produção, altere todas as senhas padrão imediatamente.

14. Perguntas frequentes

O associado não consegue entrar no portal

Confirme matrícula, CPF do titular e senha enviada no WhatsApp.

Em campanha, a senha não aparece na tela do operador — só no WhatsApp (envio automático após pagamento/contrato, ou Reenviar WhatsApp / Admin → Reenviar credenciais).

Esqueci a senha / WhatsApp da campanha falhou

Admin → Associados → ficha → Reenviar credenciais (WhatsApp) (gera nova senha do portal).

Para Escola Avançada, use a seção EAD na mesma ficha (fluxo separado).

Menu Caixa não aparece para o operador

Admin → Campanhas → Operadores → marque Acesso ao caixa e salve.

A campanha também precisa estar com Aceita dinheiro para gerar protocolo no wizard.

Dinheiro: quem pode confirmar?

Só operador com flag de caixa ou admin. O inscrito/operador comum não marca “já paguei”.

Na confirmação informe Espécie ou Maquininha + observação.

Status “Pendência financeira”

1ª mensalidade ainda não confirmada como paga — ou cobrança preventiva marcou PENDENTE.

Com pendência (ou carteira vencida), o desconto de convênio não libera no QR.

O caixa não gera cupom do sorteio

1. Deve existir sorteio ABERTO no admin.
2. Informe o valor da compra (> 0).
3. Respeite o limite: 1 cupom por associado/dia naquele comércio.

Como o lojista cria fidelização?

Portal Parceiro → Fidelização → Nova campanha.

Resgates ocorrem no balcão após a meta.

Acqua: estoque não baixou após PIX

Admin → AcquaH2 → Baixar estoque de 1ª compras já pagas.

Confirme também o webhook/confirmação de pagamento da campanha.

Acqua: associado não recebe WhatsApp de envio

Marque Enviado / Entregue na aba Envios. O telefone usado é o do associado (ou do dependente, se houver).

Como liberar o módulo Sorteios / Acqua para um admin?

Admin → Usuários Admin → marque Sorteios Parceiro e/ou AcquaH2 (ou use superAdmin).

EAD não matriculou na Escola Avançada

Verifique token/URL, ação usuarios/novo + usuarios/vinculocurso, pacote ID e dados do aluno (e-mail/CPF/telefone em dependentes). Consulte logs do servidor.

Como funciona a cobrança automática no WhatsApp?

Ver seção 12 e variáveis Z-API (WHATSAPP_*).

Anuidade com desconto

Portal Financeiro: 2+ mensalidades em aberto → card Anuidade (ANUIDADE_DESCONTO_PERCENTUAL).

WhatsApp das credenciais / jurídico não envia

• WHATSAPP_API_URL, WHATSAPP_INSTANCE, WHATSAPP_API_KEY, WHATSAPP_CLIENT_TOKEN
• Jurídico: JURIDICO_WHATSAPP (ou WHATSAPP_DESTINATION_PHONE)
• Acqua admin: ACQUA_ADMIN_WHATSAPP

PagBank em produção

Homologação Pipefy + token de produção com PAGBANK_SANDBOX=false.

15. Roadmap — Moeda ITEI (prep)

Status: preparação técnica apenas. Não há saldo, cashback nem resgate ativos para o usuário final.

Já preparado no sistema

• Tabelas Wallet e WalletTransaction (ledger interno)
• Campos opcionais na validação: metodoAbatimento, valorAbatidoSaldo
• API POST /api/public/convenio/confirmar-desconto aceita esses campos; com flag OFF o fluxo continua como desconto tradicional
• Flags de ambiente (padrão false):

- FEATURE_DIGITAL_CURRENCY

- CASHBACK_ENABLED

Quando ativar (marcos)

1. Volume estável de validações no balcão
2. Conveniados de compra rotineira em vários setores
3. Preferência dos lojistas por crédito/cashback vs desconto direto na margem
4. Necessidade de float / giro pré-pago no instituto

Não construir ainda

• UI de saldo na carteirinha
• Abatimento real com moeda no caixa
• Resgate PIX do lojista
• Extrato financeiro complexo no associado
• Termos jurídicos de arranjo de pagamento

16. Serviços por cidade

Admin: /admin/cidades (módulo Serviços por cidade)

Para cada município (cidade + UF) é possível ligar/desligar:

• Convênios, EAD, AcquaH2, Jurídico, Empregabilidade
• Fidelização e Sorteio (parceiro / balcão)
• Moeda ITEI (também exige FEATURE_DIGITAL_CURRENCY=true)

Regras:

• Associado usa a cidade/UF do cadastro
• Convênio/parceiro usa a cidade/UF do convênio
• Sem config para a cidade → defaults abertos (Moeda off)
• Flag global: FEATURE_CIDADE_SERVICOS (padrão ligado; false ignora as configs)
• Cadastros (parceiro, campanha, convênio admin, vagas, articuladores) só aceitam cidades ativas listadas aqui — select único, sem digitação livre.

17. Articuladores — repasse por cidade

Admin: /admin/articuladores (módulo Articuladores — liberar em Usuários Admin)

Portal da entidade: /articulador/login

Regras de cálculo

• Base por cidade: R$ 5.000,00 (configurável).
• Com Loja local: 2,5% Comissão Maçônica ODS + 2,5% Loja (= 5%).
• Sem loja: 5% só para a Comissão Maçônica ODS.
• Modelo híbrido: o admin gera títulos da competência (mês YYYY-MM); depois confirma a baixa (pago).

Fluxo admin

1. Cadastrar entidades (e-mail/senha do portal, tipo Comissão ODS ou Loja, PIX opcional).
2. Vincular cidades à Comissão ODS e, se houver, à Loja local.
3. Gerar competência (todas as cidades ativas ou uma).
4. Filtrar títulos e Confirmar pagamento / cancelar pendentes.
5. Títulos já pagos não são sobrescritos ao regenerar a mesma competência.

Portal do articulador

• Login por entidade; vê apenas os títulos dela (pendente/pago/cancelado).
• Somente leitura — não altera status.

Deploy

Após atualizar o código no servidor: npx prisma db push (ou migrate) e npm run build, depois reiniciar o app. Liberar o módulo Articuladores aos admins que devem operar o repasse.

Contatos úteis

*Manual do sistema novositeitei / ITEI Família — atualizado em setembro/2026 (dinheiro/caixa presencial, credenciais só no WhatsApp, contrato de campanha, Ensino Médio no diagnóstico, AcquaH2, EAD, fidelização, sorteio e crons).*

Materiais comerciais (Parceiros e Associados): ver pasta docs/comercial/.

Manual no navegador (após deploy): https://itei.org.br/manual