Estes guias mapeiam os conceitos de um setor para os objetos que a plataforma tem hoje (bouquets, lines, pacotes, contas de parceiro, nodes, a API). São mapeamentos conceituais, não recursos específicos de um setor, e uma conta de parceiro é uma conta delegada, não um tenant isolado.
Mapeamento conceitual
Nada no painel se chama faculdade, semestre ou aluno. A tabela diz qual objeto faz qual papel; os capítulos abaixo os configuram nessa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Conta de faculdade ou departamento | Conta de parceiro (revendedor): um painel delegado com créditos, permissões e suas próprias lines | Users → adicionar um revendedor; Groups para suas permissões |
| Coleção da faculdade ou grade do campus | Bouquet: um conjunto nomeado de canais, filmes ou séries que um pacote concede | Bouquets, a partir de Streams e Movies / Series |
| Canal do campus ou evento ao vivo | Canal ao vivo: um stream com suas fontes, EPG e formatos de saída | Streams → adicionar um stream ao vivo (URL de origem ou envio por RTMP) |
| Arquivo de aulas | Catálogo de VOD: filmes e séries com temporadas e episódios, categorias e metadados | Movies e Series, ou a tarefa de ingestão de VOD |
| Acesso de aluno ou servidor | Line: um acesso com seu pacote, bouquets, expiração, limite de conexões e saídas | Lines → adicionar, ou códigos de ativação, ou a Reseller API |
| Fim do semestre ou da matrícula | Data de expiração da line, renovada por um pacote, um crédito ou a API | A data de expiração da line e a duração do pacote |
| Node de campus ou residência estudantil | Nodes de streaming: servidores de borda registrados pelo painel, um por local ou prédio | Servers → adicionar um node, instalado por SSH |
| Integração com o sistema de informação acadêmica | Reseller API e webhooks: as operações do painel a partir do seu próprio sistema | Chaves da Reseller API e webhooks no painel do revendedor |
Pré-requisitos
O que ter antes de instalar.
- Um servidor no campus principal (Ubuntu 22.04 ou 24.04) acessível a partir dos outros campi e das residências estudantis, o instalador e um endereço interno ou um domínio atrás do seu proxy reverso.
- Os sinais dos canais do campus e as gravações de aulas (ou a exportação do sistema de captura de aulas) e a capacidade do sistema de informação acadêmica de chamar uma API HTTP.
- Uma decisão sobre a estrutura: quais faculdades recebem uma conta de parceiro, como as séries de aulas são nomeadas e quanto dura um pacote semestral.
Implantação da infraestrutura
Primeiro o campus principal, depois os outros locais.
- Execute o instalador no servidor do campus principal; coloque o painel atrás do proxy reverso da universidade e defina os proxies confiáveis para que os logs e as regras de IP vejam os endereços reais.
- Defina a base de reprodução como o endereço que os alunos acessam a partir do campus e das residências estudantis.
- Registre um node por campus e por residência estudantil em Servidores; o painel o instala por SSH e direciona os espectadores daquele local a ele.
- Defina a chave de licença no servidor; uma instituição com domínio acadêmico pode solicitar por e-mail a chave Professional gratuita do programa para educação.
Organização do conteúdo
Coleções das faculdades e a grade do campus.
- Crie categorias por faculdade e disciplina e uma série por curso, com uma temporada por período e um episódio por aula.
- Crie um bouquet por coleção de faculdade, um para os canais do campus e um para material comum, como vídeos de recepção.
- Crie pacotes para alunos e servidores: os bouquets de que cada um precisa, com o semestre como duração, de modo que o acesso termina com o período, a menos que seja renovado.
- Crie um pacote de teste curto para dias abertos ou alunos visitantes.
Configuração de parceiros (revendedores)
Faculdades como contas delegadas.
- Crie um grupo com permissões para linhas e para o catálogo da própria faculdade, sem acesso às configurações.
- Adicione cada faculdade ou departamento como conta de parceiro (revendedor) com esse grupo e seus pacotes; subrevendedores podem espelhar departamentos dentro de uma faculdade.
- Uma faculdade vê e gerencia apenas as próprias linhas; a equipe central mantém a visão completa. É uma conta delegada, não uma instalação isolada.
Configuração do acesso dos alunos
Uma linha por aluno, a partir do sistema acadêmico.
- Crie uma chave da Reseller API para o sistema de informação acadêmica e guarde-a nos segredos desse sistema.
- Na matrícula, o sistema acadêmico chama action=create_line com o pacote do aluno e um id de requisição; a duração do pacote, o semestre, é o período de acesso.
- Defina o máximo de conexões como o número de dispositivos que um aluno pode usar ao mesmo tempo (normalmente dois: celular e notebook).
- Para servidores e para um piloto, adicione linhas em Linhas → adicionar e entregue as credenciais.
Arquivos de aulas
Gravações sob demanda.
- Envie cada gravação como fonte de um episódio ou ingira-a com o job de ingestão de VOD; mantenha o título do curso e uma breve descrição.
- Associe a série ao bouquet da faculdade, para que apenas os alunos cujo pacote o conceda vejam o curso.
- Verifique a reprodução com uma linha de teste de cada pacote para confirmar quem vê o quê.
Canais do campus e eventos ao vivo
Canais ao vivo para o campus.
- Adicione os sinais dos canais do campus como streams ao vivo em Streams e uma fonte EPG para o guia.
- Adicione um stream ao vivo por sala de aula ou evento, alimentado pelo encoder da sala via RTMP, e ative o catch-up para que quem chega atrasado possa voltar no tempo.
- Coloque cada canal no bouquet certo; os nodes nas residências estudantis o pegam uma única vez da origem e atendem os alunos localmente.
Vencimento e renovação
O semestre como validade da linha.
- Uma linha expira no fim do período do seu pacote; na rematrícula, o sistema acadêmico chama action=renew_line e outro período é somado.
- Quando um aluno desiste ou se forma, o sistema acadêmico chama action=disable_line.
- Inscreva o sistema acadêmico nos webhooks para conciliar as linhas prestes a expirar e expiradas com os seus registros.
Integração com o sistema de informação acadêmica
O sistema acadêmico controla o acesso; o player reproduz.
- O sistema acadêmico cria, renova, ativa e desativa linhas pela Reseller API com uma chave e um id de requisição.
- Não há login único para espectadores nem integração nativa com LMS ou sistema acadêmico: um aluno entra no player com as credenciais da linha, e a página de um curso no LMS pode apontar para o player web.
- Use chaves da Admin API com a opção somente leitura, lista de IPs permitidos e data de expiração para ferramentas internas de relatório.
Considerações de segurança
Mantenha o acesso para alunos e servidores.
- Mantenha a plataforma na rede do campus ou atrás do proxy reverso com TLS; defina TRUSTED_PROXIES com o proxy.
- Login em duas etapas para toda conta do painel e um grupo de permissões por função, para que uma faculdade não veja as linhas de outra.
- Links de reprodução assinados e com expiração, um limite de conexões por linha e vínculo a um país ou endereço quando ajudar.
- Backups criptografados do banco de dados com cópia externa e o log de auditoria para cada alteração de linhas e do catálogo.
Solução de problemas
As primeiras verificações habituais.
- Um aluno não vê aulas: verifique o vencimento da linha e depois o pacote e os bouquets que ele concede.
- Um novo aluno está sem acesso: verifique no log de chamadas da Reseller API se a chamada do sistema acadêmico foi bem-sucedida e se o id de requisição é novo.
- Uma residência estudantil trava à noite: verifique o heartbeat do node dela e se os espectadores estão direcionados a ele.
- O log de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES com o proxy e reinicie o painel.