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 apartamento ou morador. 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 do administrador do condomínio | 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 |
| Grelha de canais | Bouquet: um conjunto nomeado de canais, filmes ou séries que um pacote concede | Bouquets, a partir de Streams e Movies / Series |
| Canal ou canal de informação | 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) |
| Vídeos de boas-vindas e avisos | 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 apartamento | 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 |
| Período de contrato ou ocupaçã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ó do edifício | Nós de streaming: servidores edge registados a partir do painel, um por local ou edifício | Servers → adicionar um nó, instalado por SSH |
Pré-requisitos
O que ter antes de instalar.
- Um servidor para a administração (Ubuntu 22.04 ou 24.04), o instalador e um servidor para cada edifício que consiga alcançar a rede dos moradores.
- Os feeds de canais que a comunidade pode retransmitir (URLs de obtenção ou RTMP), os avisos e vídeos de boas-vindas da administração e os dispositivos dos moradores (set-top boxes, smart TVs com uma aplicação de leitor ou um navegador).
- Uma decisão sobre os tipos de habitação (standard, sénior, estudante) e sobre quem na administração abre e renova as linhas.
Implementação da infraestrutura
O servidor central, depois um nó por edifício.
- Execute o instalador no servidor central e defina o URL base de reprodução para um endereço que os edifícios consigam alcançar.
- Adicione os feeds de canais em Streams e os avisos em Movies e verifique-os no leitor web.
- Registe um nó por edifício em Servers; o painel instala-o por SSH, ou o nó regista-se com um código de utilização única, e encaminha para ele os moradores desse edifício.
- Adicione o administrador do condomínio em Users → add a reseller, com um grupo que permita linhas e nenhuma alteração ao catálogo.
Organização do conteúdo
Grelhas por tipo de habitação.
- Crie um bouquet por grelha a partir dos canais de cada tipo de habitação e um bouquet para a informação da administração.
- Adicione o bouquet de informação a todos os pacotes para que cada morador receba os avisos.
- Crie um pacote por tipo de habitação com os seus bouquets e uma duração compatível com o contrato ou o período de ocupação.
- Ordene os canais e dê-lhes logótipos para que o menu da televisão fique bem legível.
Configuração de parceiros (revendedores)
O administrador do condomínio como conta delegada.
- Crie um grupo com permissões limitadas a linhas, sem acesso ao catálogo nem aos servidores.
- Adicione cada administrador de condomínio como revendedor com esse grupo, os pacotes das suas habitações e um saldo de créditos.
- Um administrador de vários edifícios pode adicionar um subrevendedor por edifício, cada um com as suas habitações e créditos.
Configuração dos apartamentos (linhas)
Uma linha por apartamento, com o número como nome.
- Crie uma linha por apartamento em Lines → add, com o número do apartamento como nome e o pacote desse tipo de habitação.
- Defina o máximo de ligações como o número de televisões da habitação.
- Use um código de ativação em vez de uma palavra-passe quando o morador puder introduzir um código curto no dispositivo.
- Configure o dispositivo uma só vez (API Xtream Codes ou M3U com as credenciais da linha, ou o portal MAG ou Enigma2); as credenciais ficam com o apartamento até a linha receber novas.
Vídeos de boas-vindas e avisos
Os vídeos da administração a pedido.
- Carregue o vídeo de boas-vindas, o regulamento interno e os guias de manutenção como filmes, com uma categoria por tema.
- Coloque-os no bouquet de informação para que todos os pacotes os incluam.
- Substitua um vídeo a partir do painel quando a informação mudar; os moradores veem a nova versão de imediato.
Canais e o canal de informação
A grelha e o canal de avisos como streams em direto.
- Adicione cada canal licenciado em Streams com o seu feed e uma fonte EPG para que o guia na televisão mostre os programas.
- Adicione o canal de informação como stream em direto, alimentado por um codificador por RTMP ou por uma fonte em ciclo, e coloque-o no bouquet de informação.
- Mantenha os canais com limite de território em bouquets que apenas os pacotes certos concedem.
Entrada, saída e validade
A ocupação como validade da linha.
- Uma linha expira no fim do período do seu pacote; renove-a com o pacote ou com um crédito a cada novo período do contrato.
- Quando um morador sai, desative a linha; o morador seguinte ativa-a de novo com novas credenciais, pelo que nada fica com o agregado anterior.
- Subscreva o sistema de habitação ou o administrador nos webhooks para ver linhas prestes a expirar ou já expiradas.
Integração com um sistema de habitação ou faturação
Os sistemas abrem o acesso; o leitor reproduz.
- Crie uma chave da Reseller API para o sistema de habitação ou faturação; este chama create_line, renew_line, enable_line e disable_line e envia um id de pedido a cada escrita.
- Use um conector de comércio eletrónico quando os moradores comprarem pacotes extra online; qualquer outro sistema usa a Reseller API e webhooks.
- Não há início de sessão único para espectadores: um morador entra no leitor com as credenciais da linha.
Considerações de segurança
Mantenha o serviço dentro da comunidade.
- Sirva o painel atrás de um proxy inverso com TLS e defina TRUSTED_PROXIES para que o registo de auditoria e as regras de IP vejam os endereços reais.
- Início de sessão com dois fatores para todas as contas da administração; os administradores de condomínio recebem um grupo de permissões limitado a linhas.
- Um limite de ligações por linha, ligações de reprodução assinadas e com expiração e associação de endereço onde os dispositivos têm endereços fixos.
- Ative a cópia de segurança cifrada da base de dados com cópia externa; as credenciais das linhas estão nela.
Resolução de problemas
As primeiras verificações habituais.
- Um apartamento está sem televisão: verifique se a sua linha está ativada e não expirada e depois as credenciais do dispositivo e o endereço de reprodução.
- Um edifício bloqueia à noite: verifique o heartbeat do nó do edifício e se os moradores estão encaminhados para ele.
- Falta um canal para um tipo de habitação: verifique os bouquets desse pacote.
- Um administrador não consegue criar linhas: verifique o saldo de créditos do revendedor, as permissões do grupo e os pacotes atribuídos.