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 sessão, residente ou departamento. 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 |
|---|---|---|
| Sessão da câmara ou canal público | 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 sessões e biblioteca 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 |
| Programação pública ou coleçã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 |
| Acesso de residente 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 |
| Validade de um acesso público ou de funcionário | 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 |
| Integração com o sistema da câmara | 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 centro de dados da instituição (Ubuntu 22.04 ou 24.04), o instalador e um domínio atrás do proxy inverso da instituição para o endereço público.
- O codificador ou mesa de mistura de vídeo da sala capaz de enviar RTMP, as gravações de sessões passadas e os vídeos de formação dos funcionários.
- Uma decisão sobre o que é público e o que é interno, quanto dura uma linha pública e que operadores recebem uma conta do painel.
Implementação da infraestrutura
O servidor de gestão, depois qualquer local remoto.
- Execute o instalador no servidor da instituição; coloque o painel atrás do proxy inverso com TLS e defina TRUSTED_PROXIES para que o registo de auditoria e as regras de IP vejam os endereços reais.
- Defina a base de reprodução para o endereço público que os residentes acedem e a chave de licença no servidor.
- Registe um nó em Servers para um local que precise de um, como um segundo edifício com sala de sessões; o painel instala-o por SSH.
- Crie uma conta de parceiro (revendedor) para a equipa de comunicação com permissões para linhas públicas e uma para RH ou formação para linhas de funcionários.
Organização do conteúdo
Uma programação pública e coleções por departamento.
- Crie categorias para sessões, comissões e informação pública e uma série por órgão, com um episódio por reunião.
- Crie um bouquet público com o canal da sessão em direto e o arquivo e um bouquet por coleção de formação de cada departamento.
- Crie um pacote para residentes que conceda apenas o bouquet público, com uma duração longa como período de acesso.
- Crie pacotes para funcionários que somem os bouquets de formação e internos ao público.
Configuração de parceiros (revendedores)
Equipas que distribuem o acesso.
- Crie um grupo com permissões apenas para linhas, sem acesso ao catálogo nem às definições.
- Adicione a equipa de comunicação como conta de parceiro com o pacote dos residentes e o RH ou a formação com os pacotes dos funcionários.
- Um organismo com vários serviços pode dar a cada serviço a sua própria conta de parceiro; é uma conta delegada, não uma instalação isolada.
Configuração das linhas de residentes e funcionários
Linhas públicas e linhas de funcionários.
- Crie uma chave da Reseller API para o sítio web da câmara e guarde-a nos seus segredos; quando um residente pede acesso, este chama action=create_line com o pacote público e um id de pedido.
- Defina uma validade longa nas linhas públicas e um limite de ligações adequado à utilização doméstica.
- Crie linhas de funcionários por departamento com os pacotes de funcionários, a partir do sistema de pessoal da câmara através da API ou em Lines → add.
- Associe as linhas de funcionários ao intervalo de endereços da instituição quando a rede o permitir.
Arquivo de sessões e biblioteca de formação
Gravações a pedido.
- Adicione cada sessão gravada como episódio da série do seu órgão, ingerida com a tarefa de ingestão de VOD ou carregada, com título, data e descrição.
- Coloque a série de sessões no bouquet público e a biblioteca de formação nos bouquets dos departamentos.
- Verifique a reprodução com uma linha de teste do pacote público e uma de um pacote de funcionários para confirmar quem vê o quê.
Sessões em direto
A sala como canal em direto.
- Adicione um stream em direto com envio RTMP do codificador da sala e coloque-o no bouquet público.
- Ative o catch-up para que quem chega tarde possa recuar e adicione uma entrada de EPG ou um título para que os espectadores saibam que reunião está no ar.
- Teste o feed antes de cada reunião e mantenha um nó perto de um segundo local se este também acolher sessões.
Validade e renovação
Longa para o público, ligada ao vínculo laboral para os funcionários.
- Uma linha pública dura o mesmo que a duração do pacote; prolongue-a com action=renew_line quando o residente voltar a pedir.
- Uma linha de funcionário é renovada enquanto a pessoa trabalha para a instituição e desativada com action=disable_line quando sai.
- Subscreva os sistemas da câmara nos webhooks para ver linhas prestes a expirar e desativadas.
Integração com os sistemas da instituição
Os sistemas controlam o acesso; o leitor reproduz.
- O sítio web e o sistema de pessoal criam, renovam, ativam e desativam 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 um produto específico do setor público: os espectadores entram no leitor com as credenciais da sua linha.
- Use chaves da Admin API com a opção só de leitura, lista de IPs permitidos e data de expiração para ferramentas de relatório.
Considerações de segurança
Gerido pela instituição, aberto onde deve ser.
- Mantenha a plataforma na infraestrutura da instituição atrás do proxy inverso com TLS e mantenha o material público e interno em bouquets separados.
- Início de sessão com dois fatores para todas as contas do painel e grupos de permissões por equipa; reCAPTCHA ou Turnstile no início de sessão se o painel for acessível do exterior.
- Ligações de reprodução assinadas e com expiração, um limite de ligações por linha e associação de endereço nas linhas de funcionários.
- 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 residente não consegue ver: verifique a validade da linha, se está ativada, e o bouquet público do pacote.
- Uma sessão não arranca: verifique o envio do codificador para o stream e o estado do stream no painel.
- Os funcionários não veem a biblioteca de formação: verifique o pacote da linha do funcionário e os bouquets que ele concede.
- O registo de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES para o proxy e reinicie o painel.