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 departamento ou colaborador. A tabela indica que objeto desempenha que papel; os capítulos seguintes configuram-nos por essa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Coleção de formação do departamento | Bouquet: um conjunto nomeado de canais, filmes ou séries que um pacote concede | Bouquets, a partir de Streams e Movies / Series |
| Materiais de formação | 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 do colaborador | 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 |
| Sessão de formação interna | 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) |
| Integração com RH ou LMS | 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 |
| Dispositivos por colaborador | Máximo de ligações da linha: quantos dispositivos podem ver em simultâneo | O máximo de ligações da linha |
Pré-requisitos
O que ter antes de instalar.
- Um servidor da empresa (Ubuntu 22.04 ou 24.04) acessível a partir dos escritórios, o instalador e um endereço interno ou um domínio atrás do seu reverse proxy.
- As gravações de formação, o codificador do auditório para as sessões em direto e a capacidade do sistema de RH ou LMS de chamar uma API HTTP.
- Uma decisão sobre confidencialidade: que material vai para que coleção de departamento e quem nos RH e na equipa de formação recebe uma conta de painel.
Implementação da infraestrutura
Primeiro a sede, depois os escritórios.
- Execute o instalador no servidor da sede; coloque o painel atrás do reverse proxy da empresa e defina os proxies de confiança para que o registo de auditoria veja endereços reais.
- Defina a base de reprodução para o endereço interno; os colaboradores fora da rede chegam a ela pela VPN ou pelo proxy.
- Registe um nó por escritório em Servers; o painel instala-o por SSH e encaminha para ele os espectadores desse escritório.
- Crie uma conta de parceiro para a equipa de formação com permissões para o catálogo e nenhuma para as linhas dos colaboradores.
Organização do conteúdo
Coleções por departamento, cursos como séries.
- Crie categorias por tema e uma série por curso em várias partes, com um episódio por sessão.
- Crie um bouquet por coleção de formação de departamento e um bouquet para todos os colaboradores com o material que todos veem.
- Crie um pacote por função: os bouquets de que essa função precisa e nenhuns outros, com uma duração longa (um ano, por exemplo) como período de acesso; uma renovação acrescenta outro período e os RH desativam a linha quando o contrato termina.
- Assinale claramente as coleções confidenciais nos seus nomes; uma linha só vê os bouquets que o seu pacote concede.
Configuração de parceiros (revendedores)
A equipa de formação e, num grupo empresarial, cada subsidiária.
- Crie um grupo com permissões de catálogo para a equipa de formação e um grupo com permissões de linhas para os RH.
- Adicione a equipa de formação e os RH como revendedores com esses grupos; nenhum precisa de créditos numa implementação interna.
- Uma subsidiária com biblioteca própria recebe o seu próprio revendedor, os seus próprios bouquets e os seus próprios pacotes.
Configuração do acesso dos colaboradores
Uma linha por colaborador, a partir dos RH.
- Crie uma chave da Reseller API para o sistema de RH e guarde-a nos segredos do sistema de RH.
- Na contratação, o sistema de RH chama action=create_line com o pacote da função e um identificador de pedido (a duração do pacote é o período de acesso); na saída, chama action=disable_line.
- Defina o máximo de ligações como o número de dispositivos que um colaborador pode usar (normalmente dois: secretária e telemóvel).
- Para um piloto, adicione linhas em Lines → adicionar e entregue as credenciais a alguns colaboradores.
Materiais de formação
Gravações a pedido.
- Carregue cada gravação como fonte de um episódio ou ingira-a com a tarefa de ingestão VOD; mantenha o título e uma descrição curta.
- Associe a gravação ao bouquet de departamento certo através da sua série.
- Verifique a reprodução com uma linha de teste de cada função para confirmar quem vê o quê.
Sessões de formação internas
Uma sessão como canal em direto.
- Adicione um stream em direto para o codificador do auditório (envio RTMP); coloque-o no bouquet de todos os colaboradores ou no de um departamento.
- Ative o catch-up para que quem chega tarde possa recuar e carregue a gravação para a biblioteca depois.
- Os nós nos escritórios recebem a sessão uma só vez da origem e servem localmente os seus colaboradores.
Expiração do acesso
O acesso termina com o contrato.
- Uma linha expira no fim do período do seu pacote; enquanto o contrato decorre, os RH renovam-na com action=renew_line e, quando o contrato termina, os RH desativam-na.
- Subscreva os webhooks no sistema de RH para reconciliar as linhas a expirar e expiradas com os seus próprios registos.
- Para acessos temporários (prestadores, semana de integração) use uma validade curta em vez de um pacote separado.
Integração com RH ou um LMS
Os sistemas gerem o acesso; o leitor reproduz.
- Os RH criam, renovam e desativam linhas através da Reseller API; o LMS pode ligar ao leitor web a partir da página de um curso.
- Não há início de sessão único para espectadores: o colaborador entra no leitor com as credenciais da linha emitidas pelo seu sistema.
- Use chaves Admin API com o indicador só de leitura para ferramentas internas de relatórios.
Considerações de segurança
Confidencialidade da rede até à linha.
- Mantenha a plataforma na rede interna ou atrás do reverse proxy com TLS; defina TRUSTED_PROXIES em conformidade.
- Início de sessão com dois fatores em todas as contas do painel; grupos de permissões para que os RH não possam alterar o catálogo e a equipa de formação não veja as linhas.
- Ligações de reprodução assinadas e com validade, um limite de ligações baixo por linha e associação ao endereço onde os dispositivos são fixos.
- Cópias de segurança cifradas da base de dados com cópia externa; o registo de auditoria para cada alteração de linhas e catálogo.
Resolução de problemas
As primeiras verificações habituais.
- Um colaborador vê material de outro departamento: verifique o pacote da linha e os bouquets que concede.
- Um novo colaborador não tem acesso: verifique se a chamada dos RH foi bem-sucedida (o registo de chamadas da Reseller API) e a validade da linha.
- Um escritório faz buffering durante uma sessão em direto: verifique o heartbeat do nó do escritório e se os espectadores são encaminhados para ele.
- O registo de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES para o proxy e reinicie o painel.