Guia de configuração para o setor público

Mapeamento conceitual

Nada no painel se chama sessão, morador ou departamento. 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 no data center da instituição (Ubuntu 22.04 ou 24.04), o instalador e um domínio atrás do proxy reverso da instituição para o endereço público.
2. O encoder ou mixer de vídeo do plenário capaz de fazer push RTMP, as gravações de sessões passadas e os vídeos de treinamento dos servidores.
3. Uma decisão sobre o que é público e o que é interno, quanto dura uma linha pública e quais operadores recebem uma conta do painel.

2Implantação da infraestrutura

O servidor de gerenciamento, depois qualquer unidade remota.

1. Execute o instalador no servidor da instituição; coloque o painel atrás do proxy reverso com TLS e defina TRUSTED_PROXIES para que o log de auditoria e as regras de IP vejam os endereços reais.
2. Defina a base de reprodução como o endereço público que os moradores acessam e a chave de licença no servidor.
3. Registre um node em Servidores para uma unidade que precise de um, como um segundo prédio com plenário; o painel o instala por SSH.
4. Crie uma conta de parceiro (revendedor) para a equipe de comunicação com permissões para linhas públicas e uma para RH ou treinamento para linhas de servidores.

3Organização do conteúdo

Uma programação pública e coleções por departamento.

1. 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.
2. Crie um bouquet público com o canal da sessão ao vivo e o arquivo e um bouquet por coleção de treinamento de cada departamento.
3. Crie um pacote para moradores que conceda apenas o bouquet público, com uma duração longa como período de acesso.
4. Crie pacotes para servidores que somem os bouquets de treinamento e internos ao público.

4Configuração de parceiros (revendedores)

Equipes que distribuem o acesso.

1. Crie um grupo com permissões apenas para linhas, sem acesso ao catálogo nem às configurações.
2. Adicione a equipe de comunicação como conta de parceiro com o pacote dos moradores e o RH ou treinamento com os pacotes dos servidores.
3. Um órgão com vários serviços pode dar a cada serviço sua própria conta de parceiro; é uma conta delegada, não uma instalação isolada.

5Configuração das linhas de moradores e servidores

Linhas públicas e linhas de servidores.

1. Crie uma chave da Reseller API para o site da câmara e guarde-a nos segredos dele; quando um morador pede acesso, ele chama action=create_line com o pacote público e um id de requisição.
2. Defina um vencimento longo nas linhas públicas e um limite de conexões adequado ao uso doméstico.
3. Crie linhas de servidores por departamento com os pacotes de servidores, a partir do sistema de pessoal da câmara pela API ou em Linhas → adicionar.
4. Vincule as linhas de servidores à faixa de endereços da instituição quando a rede permitir.

6Arquivo de sessões e biblioteca de treinamento

Gravações sob demanda.

1. Adicione cada sessão gravada como episódio da série do seu órgão, ingerida com o job de ingestão de VOD ou enviada, com título, data e descrição.
2. Coloque a série de sessões no bouquet público e a biblioteca de treinamento nos bouquets dos departamentos.
3. Verifique a reprodução com uma linha de teste do pacote público e uma de um pacote de servidores para confirmar quem vê o quê.

7Sessões ao vivo

O plenário como canal ao vivo.

1. Adicione um stream ao vivo com push RTMP do encoder do plenário e coloque-o no bouquet público.
2. Ative o catch-up para que quem chega atrasado possa voltar no tempo e adicione uma entrada de EPG ou um título para que os espectadores saibam qual reunião está no ar.
3. Teste o sinal antes de cada reunião e mantenha um node perto de uma segunda unidade se ela também sediar sessões.

8Vencimento e renovação

Longo para o público, atrelado ao vínculo de trabalho para os servidores.

1. Uma linha pública dura o mesmo que a duração do pacote; estenda-a com action=renew_line quando o morador pedir de novo.
2. Uma linha de servidor é renovada enquanto a pessoa trabalha para a instituição e desativada com action=disable_line quando ela sai.
3. Inscreva os sistemas da câmara nos webhooks para ver linhas prestes a expirar e desativadas.

9Integração com os sistemas da instituição

Os sistemas controlam o acesso; o player reproduz.

1. O site e o sistema de pessoal criam, renovam, ativam e desativam linhas pela Reseller API com uma chave e um id de requisição.
2. Não há login único para espectadores nem integração nativa com um produto específico do setor público: os espectadores entram no player com as credenciais da própria linha.
3. Use chaves da Admin API com a opção somente leitura, lista de IPs permitidos e data de expiração para ferramentas de relatório.

10Considerações de segurança

Operado pela instituição, aberto onde deve ser.

1. Mantenha a plataforma na infraestrutura da instituição atrás do proxy reverso com TLS e mantenha material público e interno em bouquets separados.
2. Login em duas etapas para toda conta do painel e grupos de permissões por equipe; reCAPTCHA ou Turnstile no login se o painel for acessível de fora.
3. Links de reprodução assinados e com expiração, um limite de conexões por linha e vínculo de endereço nas linhas de servidores.
4. 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.

11Solução de problemas

As primeiras verificações habituais.

1. Um morador não consegue assistir: verifique o vencimento da linha, se ela está ativada e o bouquet público do pacote.
2. Uma sessão não inicia: verifique o push do encoder para o stream e o status do stream no painel.
3. Os servidores não veem a biblioteca de treinamento: verifique o pacote da linha do servidor e os bouquets que ele concede.
4. O log de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES com o proxy e reinicie o painel.