Guia de configuração de Treinamento corporativo

Mapeamento conceitual

Nada no painel se chama departamento ou funcionário. A tabela diz qual objeto faz qual papel; os capítulos abaixo os configuram nessa ordem.

1Pré-requisitos

O que ter antes de instalar.

1. 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 proxy reverso.
2. As gravações de treinamento, o encoder do auditório para as sessões ao vivo e a capacidade do sistema de RH ou LMS de chamar uma API HTTP.
3. Uma decisão sobre confidencialidade: qual material vai em qual coleção de departamento e quem no RH e na equipe de treinamento recebe uma conta no painel.

2Implantação da infraestrutura

Primeiro a matriz, depois os escritórios.

1. Execute o instalador no servidor da matriz; coloque o painel atrás do proxy reverso da empresa e defina os proxies confiáveis para que o log de auditoria veja os endereços reais.
2. Defina a base de reprodução como o endereço interno; os funcionários fora da rede chegam a ele pela VPN ou pelo proxy.
3. Registre um node por escritório em Servers; o painel o instala por SSH e direciona a ele os espectadores desse escritório.
4. Crie uma conta de parceiro para a equipe de treinamento com permissões para o catálogo e nenhuma para as lines dos funcionários.

3Organização do conteúdo

Coleções por departamento, cursos como séries.

1. Crie categorias por tema e uma série por curso em várias partes, com um episódio por sessão.
2. Crie um bouquet por coleção de treinamento de departamento e um bouquet para todos os funcionários com o material que todos veem.
3. Crie um pacote por função: os bouquets de que essa função precisa e nenhum outro, com uma duração longa (um ano, por exemplo) como período de acesso; uma renovação soma mais um período, e o RH desativa a line quando o contrato termina.
4. Marque claramente as coleções confidenciais em seus nomes; uma line vê apenas os bouquets que seu pacote concede.

4Configuração de parceiros (revendedores)

A equipe de treinamento e, em um grupo de empresas, cada subsidiária.

1. Crie um grupo com permissões de catálogo para a equipe de treinamento e um grupo com permissões de lines para o RH.
2. Adicione a equipe de treinamento e o RH como revendedores com esses grupos; nenhum dos dois precisa de créditos em uma implantação interna.
3. Uma subsidiária com biblioteca própria recebe seu próprio revendedor, seus próprios bouquets e seus próprios pacotes.

5Configuração do acesso dos funcionários

Uma line por funcionário, a partir do RH.

1. Crie uma chave da Reseller API para o sistema de RH e guarde-a nos segredos do sistema de RH.
2. Na contratação, o sistema de RH chama action=create_line com o pacote da função e um id de requisição (a duração do pacote é o período de acesso); no desligamento, chama action=disable_line.
3. Defina o máximo de conexões como o número de dispositivos que um funcionário pode usar (normalmente dois: mesa e celular).
4. Para um piloto, adicione lines em Lines → adicionar e entregue as credenciais a alguns funcionários.

6Materiais de treinamento

Gravações sob demanda.

1. Envie cada gravação como fonte de um episódio ou ingira-a com a tarefa de ingestão de VOD; mantenha o título e uma descrição curta.
2. Associe a gravação ao bouquet de departamento correto por meio da sua série.
3. Confira a reprodução com uma line de teste de cada função para confirmar quem vê o quê.

7Sessões internas de treinamento

Uma sessão como canal ao vivo.

1. Adicione um stream ao vivo para o encoder do auditório (envio por RTMP); coloque-o no bouquet de todos os funcionários ou no de um departamento.
2. Ative o catch-up para que quem entrar atrasado possa voltar, e envie a gravação à biblioteca depois.
3. Os nodes nos escritórios pegam a sessão uma vez da origem e atendem localmente as suas pessoas.

8Expiração do acesso

O acesso termina com o contrato.

1. Uma line expira ao fim do período do seu pacote; enquanto o contrato vigora, o RH a renova com action=renew_line e, quando o contrato termina, o RH a desativa.
2. Inscreva o sistema de RH nos webhooks para reconciliar as lines prestes a expirar e as expiradas com seus próprios registros.
3. Para acessos temporários (terceirizados, semana de integração), use uma expiração curta em vez de um pacote separado.

9Integração com RH ou um LMS

Os sistemas controlam o acesso; o player reproduz.

1. O RH cria, renova e desativa lines pela Reseller API; o LMS pode apontar para o player web a partir da página de um curso.
2. Não há single sign-on para espectadores: o funcionário entra no player com as credenciais da line emitidas pelo seu sistema.
3. Use chaves de Admin API com o indicador de somente leitura para ferramentas internas de relatórios.

10Considerações de segurança

Confidencialidade da rede até a line.

1. Mantenha a plataforma na rede interna ou atrás do proxy reverso com TLS; defina TRUSTED_PROXIES de acordo.
2. Login em duas etapas para todas as contas do painel; grupos de permissões para que o RH não altere o catálogo e a equipe de treinamento não veja as lines.
3. Links de reprodução assinados e com expiração, um limite de conexões baixo por line e vínculo de endereço onde os dispositivos são fixos.
4. Backups criptografados do banco de dados com cópia externa; o log de auditoria para toda alteração de lines e do catálogo.

11Solução de problemas

As primeiras verificações habituais.

1. Um funcionário vê o material de outro departamento: verifique o pacote da line e os bouquets que ele concede.
2. Um novo contratado está sem acesso: verifique se a chamada do RH teve sucesso (o registro de chamadas da Reseller API) e a expiração da line.
3. Um escritório trava durante uma sessão ao vivo: verifique o heartbeat do node do escritório e se os espectadores são direcionados a ele.
4. O log de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES como o proxy e reinicie o painel.