Turma escola: visão geral

Uma turma agrupa alunos e supervisores de uma instituição de ensino que usa o sistema no modo clínica escola. A turma organiza os atendimentos sob orientação, dentro de uma disciplina e de um período letivo.

Relação com o cadastro de profissionais. Alunos e supervisores são cadastrados antes do vínculo com a turma. O e-mail utilizado aqui é o mesmo emailLogin do cadastro em Profissional de saúde escola.

Seis operações

Operação	Finalidade
POST /turma/nova	Abrir uma turma com código, nome e coordenador
PUT /turma/{codigoTurma}	Atualizar nome, período, disciplina ou status
GET /turma/{codigoTurma}	Consultar os dados e os profissionais vinculados
POST /turma/{codigoTurma}/profissionais	Adicionar alunos e supervisores
DELETE /turma/{codigoTurma}/profissionais/{email}	Desvincular alguém da turma
GET /turma/profissional/{email}	Consultar as turmas de um profissional e o papel em cada uma

Os três tipos de vínculo

Uma turma se relaciona com os profissionais de três formas:

   TURMA  "ODO-2026-1"
   │
   ├── COORDENADOR  (campo da própria turma)
   │   └── definido ao criar ou alterar a turma
   │   └── precisa ser um orientador, não pode ser aluno
   │
   ├── SUPERVISORES  (lista, via vincular profissionais de saúde)
   │   └── tipo = SUPERVISOR
   │
   └── ESTAGIÁRIOS   (lista, via vincular profissionais de saúde)
       └── tipo = ESTAGIARIO

O coordenador é um campo da turma (coordenadorEmail). As operações de vínculo e remoção de profissionais não alteram o coordenador, que é trocado na alteração da turma.

O código da turma

O codigoTurma é um código definido na criação da turma, por exemplo ODO-2026-1, com até 50 caracteres. Ele é único na clínica e não pode ser alterado depois de criado.

Outras características

• O periodoLetivo é um campo de texto livre, por exemplo 2026/1 ou 1º semestre de 2026.

Próximo passo

Gerenciar turmas.