Estes guias fazem corresponder os conceitos de um setor aos objetos que a plataforma tem hoje (bouquets, linhas, pacotes, contas de parceiro, nós, a API). São correspondências conceptuais, não funcionalidades específicas de um setor, e uma conta de parceiro é uma conta delegada, não um inquilino isolado.
Correspondência conceptual
Nada no painel se chama faculdade, semestre ou aluno. A tabela diz que objeto desempenha que papel; os capítulos abaixo configuram-nos por essa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Conta de faculdade ou departamento | Conta de revendedor (reseller): um painel delegado com créditos, permissões e as suas próprias linhas | Users → adicionar um revendedor; Groups para as suas permissões |
| Coleção da faculdade ou grelha 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 em direto | Canal em direto: um stream com as suas fontes, EPG e formatos de saída | Streams → adicionar um stream em direto (URL de origem ou envio RTMP) |
| Arquivo de aulas | Catálogo VOD: filmes e séries com temporadas e episódios, categorias e metadados | Movies e Series, ou a tarefa de ingestão VOD |
| Acesso de aluno ou funcionário | Linha: um acesso com o seu pacote, bouquets, validade, limite de ligações e saídas | Lines → adicionar, ou códigos de ativação, ou a Reseller API |
| Fim do semestre ou da inscrição | Data de validade da linha, renovada por um pacote, um crédito ou pela API | A data de validade da linha e a duração do pacote |
| Nó de campus ou residência universitária | Nós de streaming: servidores edge registados a partir do painel, um por local ou edifício | Servers → adicionar um nó, 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 campus e das residências universitárias, o instalador e um endereço interno ou um domínio atrás do seu proxy inverso.
- Os feeds 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: que faculdades recebem uma conta de parceiro, como as séries de aulas são nomeadas e quanto dura um pacote semestral.
Implementaçã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 inverso da universidade e defina os proxies de confiança para que os registos e as regras de IP vejam os endereços reais.
- Defina a base de reprodução para o endereço que os alunos acedem a partir do campus e das residências universitárias.
- Registe um nó por campus e por residência universitária em Servers; o painel instala-o por SSH e encaminha para ele os espectadores desse local.
- Defina a chave de licença no servidor; uma instituição com domínio académico pode pedir por e-mail a chave Professional gratuita do programa para a educação.
Organização do conteúdo
Coleções das faculdades e a grelha 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 receção.
- Crie pacotes para alunos e funcionários: 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 definições.
- Adicione cada faculdade ou departamento como conta de parceiro (revendedor) com esse grupo e os seus pacotes; os subrevendedores podem espelhar departamentos dentro de uma faculdade.
- Uma faculdade vê e gere apenas as suas próprias linhas; a equipa 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 inscrição, o sistema académico chama action=create_line com o pacote do aluno e um id de pedido; a duração do pacote, o semestre, é o período de acesso.
- Defina o máximo de ligações como o número de dispositivos que um aluno pode usar em simultâneo (normalmente dois: telemóvel e portátil).
- Para funcionários e para um piloto, adicione linhas em Lines → add e entregue as credenciais.
Arquivos de aulas
Gravações a pedido.
- Carregue cada gravação como fonte de um episódio ou ingira-a com a tarefa 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 em direto
Canais em direto para o campus.
- Adicione os feeds dos canais do campus como streams em direto em Streams e uma fonte EPG para o guia.
- Adicione um stream em direto por sala de aula ou evento, alimentado pelo codificador da sala por RTMP, e ative o catch-up para que quem chega tarde possa recuar.
- Coloque cada canal no bouquet certo; os nós nas residências universitárias obtêm-no uma só vez da origem e servem os alunos localmente.
Validade e renovação
O semestre como validade da linha.
- Uma linha expira no fim do período do seu pacote; na reinscrição, o sistema académico chama action=renew_line e outro período é somado.
- Quando um aluno desiste ou se licencia, o sistema académico chama action=disable_line.
- Subscreva o sistema académico nos webhooks para reconciliar as linhas prestes a expirar e expiradas com os seus registos.
Integração com o sistema de informação académica
O sistema académico controla o acesso; o leitor reproduz.
- O sistema académico cria, renova, ativa e desativa linhas através da Reseller API com uma chave e um id de pedido.
- Não há início de sessão único para espectadores nem integração nativa com LMS ou sistema académico: um aluno entra no leitor com as credenciais da linha, e a página de um curso no LMS pode apontar para o leitor web.
- Use chaves da Admin API com a opção só de 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 funcionários.
- Mantenha a plataforma na rede do campus ou atrás do proxy inverso com TLS; defina TRUSTED_PROXIES para o proxy.
- Início de sessão com dois fatores para todas as contas do painel e um grupo de permissões por função, para que uma faculdade não veja as linhas de outra.
- Ligações de reprodução assinadas e com expiração, um limite de ligações por linha e associação a um país ou endereço quando ajudar.
- Cópias de segurança cifradas da base de dados com cópia externa e o registo de auditoria para cada alteração de linhas e do catálogo.
Resolução de problemas
As primeiras verificações habituais.
- Um aluno não vê aulas: verifique a validade da linha e depois o pacote e os bouquets que ele concede.
- Um novo aluno está sem acesso: verifique no registo de chamadas da Reseller API se a chamada do sistema académico foi bem-sucedida e se o id de pedido é novo.
- Uma residência universitária bloqueia à noite: verifique o heartbeat do seu nó e se os espectadores estão encaminhados para ele.
- O registo de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES para o proxy e reinicie o painel.