Contratos

Onde: menu › Organização › Contratos

Visão geral

Contratos é onde a organização escreve o contrato que o aluno aceita. O texto é escrito em Markdown — texto comum, com títulos, negrito, listas e tabelas marcados por símbolos simples — e, ao lado, a tela mostra como o aluno lê.

Cada contrato começa como rascunho. Quando o texto está pronto, você o publica: a publicação vira a versão 1, e ela não muda mais. Para mudar o contrato depois, você edita o rascunho e publica a versão 2, e assim por diante. As versões anteriores ficam guardadas, do jeito que eram.

📐 Regra de negócio

uma versão publicada nunca muda. Quem aceitar um contrato aceita uma versão específica, e o texto daquela versão precisa ser o mesmo para sempre. É o que a tela lembra: “Uma versão publicada não muda mais: quem aceitou, aceitou aquele texto.”

Nota

publicar não manda o contrato a ninguém. Quem leva o contrato ao aluno é a recepção, pela ficha dele em Alunos ou na Nova matrícula do Comercial: Enviar contrato gera um link, e o aluno lê e aceita a versão publicada no celular, sem entrar no app. Veja Do contrato ao aceite do aluno.

Nota

o texto é da organização. O Hub não traz cláusula pronta: o esqueleto do contrato novo tem só os títulos das seções. O que vai em cada uma é decisão do dono — de preferência, com quem cuida da parte jurídica da organização. A fidelidade e a multa de saída não saem do texto: saem do plano, em Matrículas › Planos, e aparecem para o aluno no quadro do plano, acima do texto.

Cuidado

o texto e o plano precisam dizer a mesma coisa. Se o contrato fala em fidelidade ou em multa, confira que os números batem com os planos da prateleira. O aluno lê os dois na mesma página, e o Hub calcula a multa pelo plano — pela cópia que a matrícula guardou na venda —, não pelo texto.

Quando usar

• Ao montar a organização no Hub, para escrever o contrato de matrícula.
• Quando uma regra muda — preço, cancelamento, uso de imagem —, para publicar a versão seguinte.
• Para conferir o que dizia uma versão antiga, em Versões publicadas.
• Quando um contrato sai de uso, para arquivá-lo.
• Para saber o que um aluno aceitou, abra a ficha dele, em Alunos — o aceite mora lá, não aqui.

Pré-requisitos

• Ser Dono ou Gestor no Hub. A Recepção e o Financeiro veem Acesso restrito: “Os contratos são do dono e do gestor. Peça ao dono se você precisa.” Enviar o contrato ao aluno é diferente: a Recepção também envia, pela ficha do aluno e na Nova matrícula.

📐 Regra de negócio

quem escreve é a gestão; quem envia é o balcão. Escrever, publicar, arquivar e restaurar são do Dono e do Gestor. A Recepção não abre esta tela, mas lê a lista dos contratos publicados — o título e a versão — para escolher qual enviar, na ficha do aluno e na Nova matrícula. Ela não vê os rascunhos nem os arquivados, e não muda nenhum.

---

Passo a passo (por região)

O alto da tela e a lista

📸 Screenshot pendente

assets/13-contratos-tela.png — a tela Contratos com a lista à esquerda (com os selos) e o editor à direita, o Markdown e a coluna “Como o aluno lê”.

Sob o título Contratos, a linha diz: “O texto que o aluno aceita, escrito em Markdown. Cada publicação vira uma versão que não muda mais.” No canto direito, Novo contrato.

À esquerda, a lista dos contratos, em ordem alfabética, com os arquivados no fim. Cada um mostra o título, um selo e editado em com a data:

Selo	O que quer dizer
Rascunho	nunca foi publicado
v2 publicada	a versão 2 está publicada, e o rascunho é igual a ela
v2 · alterado	o rascunho mudou desde a versão 2; ainda falta publicar
Arquivado	saiu de uso

A tela abre com o primeiro contrato da lista. Clique em outro para abri-lo.

Cuidado

se você trocar de contrato com alterações não salvas, a tela pergunta Descartar o que não foi salvo?. Descartar e trocar perde o que você escreveu desde o último salvamento; Voltar fica onde está. Sair da tela pelo menu ou fechar a aba também pergunta antes.

Escrever um contrato novo

📸 Screenshot pendente

assets/13-contratos-novo.png — a janela “Novo contrato” com o campo Título.

1. Clique em Novo contrato.
2. Na janela Novo contrato, escreva o Título — por exemplo, “Contrato de matrícula”.
3. Clique em Criar rascunho.

O contrato abre como Rascunho, já com um esqueleto de seções para preencher: o título “Contrato de prestação de serviços”, a linha das partes (com Nome da organização para você trocar pelo nome da sua) e as seções 1. O serviço, 2. Plano, valor e vencimento e 3. Cancelamento, vazias. Mude, apague ou acrescente seções à vontade.

O editor

O editor tem três partes:

• Título, com Salvar rascunho e Publicar ao lado;
• à esquerda, Texto em Markdown, onde você escreve, com a contagem de caracteres embaixo;
• à direita, Como o aluno lê: o texto já formatado, atualizado enquanto você digita.

Para salvar sem publicar, clique em Salvar rascunho. O rascunho fica guardado, e ninguém fora do Hub o vê.

Publicar uma versão

1. Confira o texto em Como o aluno lê.
2. Clique em Publicar v1 — o botão diz o número da versão que vai nascer.
3. Leia a confirmação Publicar a versão 1? e clique em Publicar v1 — ou em Voltar.

A versão entra em Versões publicadas, e o selo da lista passa a v1 publicada.

Nota

o que é publicado é o que está na tela. Se houver alteração não salva, a publicação salva o rascunho primeiro e congela esse texto — a confirmação avisa.

📐 Regra de negócio

Publicar fica desligado quando não há nada de novo para publicar — o rascunho é igual à última versão —, quando o título ou o texto estão vazios e quando o contrato está arquivado.

Versões publicadas

📸 Screenshot pendente

assets/13-contratos-versoes.png — o quadro “Versões publicadas” com v1 e v2, o botão “Ler” e “Arquivar”.

O quadro Versões publicadas lista cada versão, com publicada em e a data, e o botão Ler, que abre o texto daquela versão, exatamente como foi publicado. Antes da primeira publicação, o quadro diz: “Nenhuma versão publicada ainda. Enquanto for rascunho, ninguém pode aceitar este contrato.”

Arquivar e restaurar

No canto do quadro Versões publicadas:

• Arquivar tira o contrato de uso. Ele vai para o fim da lista com o selo Arquivado, e o editor mostra a faixa “Arquivado: não é oferecido para aceite. As versões publicadas continuam guardadas.”
• Restaurar traz o contrato arquivado de volta.

📐 Regra de negócio

contrato não se apaga, se arquiva. As versões publicadas continuam guardadas, porque o aceite de alguém vai apontar para elas.

Nota

Arquivar e Restaurar valem na hora, sem confirmação. Num contrato arquivado, dá para salvar o rascunho, mas não publicar: restaure antes.

Cuidado

arquivar não cancela os links já enviados. O contrato arquivado sai de Enviar contrato, mas um link que estava aguardando aceite continua abrindo até vencer. Para tirá-lo do ar, use Cancelar link na ficha do aluno.

Do contrato ao aceite do aluno

📸 Screenshot pendente

assets/13-contratos-aceite.png — a página “Sua matrícula” no celular, com o plano (inclusive Fidelidade e Multa de saída), o contrato, o nome completo e os dois consentimentos.

O caminho inteiro, de quem escreve a quem aceita:

1. Escrever e publicar — o Dono ou o Gestor, aqui em Contratos. A publicação vira uma versão.
2. Enviar — o Dono, o Gestor ou a Recepção, na ficha do aluno, em Alunos: Enviar contrato, escolher o contrato e Gerar link. Ou, para quem está entrando, na Nova matrícula do Comercial. Vai sempre a última versão publicada, com o plano da matrícula do aluno naquele momento — e, se ela foi vendida com fidelidade, o fim da fidelidade e a multa de saída.
3. Aceitar — o aluno abre o link no celular, sem entrar no app: confere o plano, lê o contrato, escreve o nome completo como assinatura, marca o aceite do contrato e, à parte, se autoriza o uso de imagem. Se ele é menor de idade, quem aceita é o responsável, com o nome e o parentesco.
4. Acompanhar — na mesma ficha, a linha passa a Aceito, e Ver o aceite mostra o registro: quando, quem, de onde, o texto e a impressão do texto.

📐 Regra de negócio

o aluno aceita a versão que estava publicada quando o link foi gerado. Publicar a versão seguinte não toca em nenhum aceite: quem aceitou a v1 continua com a v1, com o texto da v1. Um link da v1 que ainda aguarda aceite continua sendo da v1 — para o aluno aceitar a v2, envie de novo pela ficha.

📐 Regra de negócio

o aceite guarda o plano como estava no envio. Acima do texto, o aluno vê o plano, o valor, o vencimento e o início da matrícula dele — e, se ela foi vendida com fidelidade, a Fidelidade e a Multa de saída. Trocar o plano depois não muda o que ele aceitou.

Nota

a reserva de aulas não espera o contrato. O aceite é registro, não trava: sem ele, o aluno reserva e treina do mesmo jeito. Quem cobra o aceite é a recepção.

---

Markdown em um minuto

O campo Texto em Markdown lembra o essencial na dica embaixo dele. O que cada marca faz:

Você escreve	O aluno lê
# Contrato de matrícula	um título
## 3. Cancelamento	o título de uma seção
**30 dias**	30 dias, em negrito
- item (uma linha por item)	uma lista com marcadores
1. item	uma lista numerada
uma linha em branco	um parágrafo novo

Uma tabela é escrita assim — a segunda linha separa o cabeçalho do resto:

| Plano | Valor | Vencimento |
|---|---|---|
| Impacto 12 | R$ 249,00 por mês | dia 10 |

Dica

escreva com Como o aluno lê aberto ao lado. Se uma tabela não virou tabela, quase sempre falta a linha de traços (|---|---|) logo abaixo do cabeçalho, ou ela tem um número de colunas diferente do cabeçalho. Deixe também uma linha em branco antes da tabela. As barras no começo e no fim de cada linha são opcionais.

📐 Regra de negócio

o texto é mostrado, nunca executado. HTML e scripts colados no texto aparecem como texto comum, e links perigosos são descartados. O contrato não tem como rodar nada na tela de quem o lê.

Campos & validações

Novo contrato

Campo	O que é	Obrigatório	Regra
Título	o nome do contrato	sim	até 120 caracteres; sem ele, Criar rascunho fica desligado

Editor

Campo	O que é	Obrigatório	Regra
Título	o nome do contrato	sim	até 120 caracteres
Texto em Markdown	o texto do contrato	sim	até 50.000 caracteres; a contagem fica embaixo do campo

Estados

Situação	O que a tela mostra
Nenhum contrato	“Nenhum contrato ainda”, com Escrever o primeiro
Carregando	um bloco cinza no lugar da tela
Erro ao carregar a lista	“Não deu para ler os contratos”, com o motivo e Tentar de novo
Erro ao abrir um contrato	“Não deu para abrir o contrato”, com Tentar de novo
Texto vazio	Como o aluno lê diz “O texto aparece aqui.”
Salvando	o botão diz Salvando…
Criando	o botão diz Criando…
Erro numa ação	uma faixa no alto do editor com a mensagem
Contrato arquivado	a faixa “Arquivado: não é oferecido para aceite…” e Publicar desligado
Papel sem acesso (Recepção e Financeiro)	Acesso restrito, mesmo abrindo pelo endereço: “Os contratos são do dono e do gestor. Peça ao dono se você precisa.”

Dicas

Dica

salve o rascunho quantas vezes quiser. Só Publicar cria versão — e versão é para sempre. Revise com calma antes.

Dica

precisa mudar uma vírgula de uma versão publicada? Não há como mudar a versão: edite o rascunho e publique a próxima. É assim que quem aceitou a versão anterior continua com o texto que aceitou.

Erros comuns / troubleshooting

O que aconteceu	Por quê	O que fazer
Publicar está desligado	Nada mudou desde a última versão, o título ou o texto estão vazios, ou o contrato está arquivado	Edite o rascunho, preencha o que falta ou Restaurar
Salvar rascunho está desligado	Nada mudou desde o último salvamento, ou o título ou o texto estão vazios	Não há o que salvar
A tabela aparece como texto em Como o aluno lê	Falta a linha de traços logo abaixo do cabeçalho, ela tem outro número de colunas, ou a tabela está colada no parágrafo de cima	Confira o exemplo em Markdown em um minuto e deixe uma linha em branco antes da tabela
“Nada para publicar: o rascunho é igual à última versão.”	O rascunho não mudou desde a última versão — talvez outra pessoa tenha publicado em outra aba	Recarregue a tela; para uma versão nova, mude o rascunho antes
“Contrato arquivado não é publicado. Restaure-o antes.”	O contrato foi arquivado, talvez em outra aba	Restaurar e publique
“Este contrato não existe mais. Recarregue a tela.”	O contrato saiu da lista enquanto a tela estava aberta	Recarregue a tela
“Este contrato ainda não tem versão publicada. Publique em Contratos.” — na ficha do aluno	O contrato escolhido só tem rascunho	Publique a primeira versão aqui
“Este contrato está arquivado. Restaure em Contratos para enviar.” — na ficha do aluno	O contrato foi arquivado enquanto a janela Enviar contrato estava aberta	Restaurar aqui, ou envie outro
Colei HTML e ele apareceu como texto	De propósito: o contrato não roda código	Use as marcas do Markdown
O aluno diz que não recebeu o contrato	Publicar não envia nada	A recepção envia pela ficha dele, em Alunos
Publiquei a v2 e o aluno ainda vê a v1	O link foi gerado antes da v2	Na ficha do aluno, Enviar contrato de novo
Arquivei o contrato e o link ainda abre	Arquivar não cancela os links enviados	Cancelar link, na ficha do aluno
Não vejo Contratos no menu	O seu papel é Recepção ou Financeiro	Contratos é do Dono e do Gestor. A Recepção envia os publicados pela ficha do aluno

👉 O que o coach vê

nada. Contratos não existe no Coach.

Como o atleta vê

👤 Como o atleta vê

o contrato chega por um link, que a recepção manda pela ficha. Ele abre no navegador, sem login — o aluno pode nem ter o app: o plano, o contrato como você o escreveu (o mesmo Como o aluno lê), o nome completo como assinatura e os dois consentimentos, o do contrato e o do uso de imagem. Veja Aceitar o contrato, na documentação do atleta.