Estes guias mapeiam os conceitos de um setor para os objetos que a plataforma tem hoje (bouquets, lines, pacotes, contas de parceiro, nodes, a API). São mapeamentos conceituais, não recursos específicos de um setor, e uma conta de parceiro é uma conta delegada, não um tenant isolado.
Mapeamento conceitual
Nada no painel se chama apartamento ou morador. A tabela diz qual objeto faz qual papel; os capítulos abaixo os configuram nessa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Conta do administrador do imóvel | Conta de parceiro (revendedor): um painel delegado com créditos, permissões e suas próprias lines | Users → adicionar um revendedor; Groups para suas permissões |
| Grade 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 ao vivo: um stream com suas fontes, EPG e formatos de saída | Streams → adicionar um stream ao vivo (URL de origem ou envio por RTMP) |
| Vídeos de boas-vindas e avisos | Catálogo de VOD: filmes e séries com temporadas e episódios, categorias e metadados | Movies e Series, ou a tarefa de ingestão de VOD |
| Acesso do apartamento | Line: um acesso com seu pacote, bouquets, expiração, limite de conexõ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 expiração da line, renovada por um pacote, um crédito ou a API | A data de expiração da line e a duração do pacote |
| Node do prédio | Nodes de streaming: servidores de borda registrados pelo painel, um por local ou prédio | Servers → adicionar um node, instalado por SSH |
Pré-requisitos
O que ter antes de instalar.
- Um servidor para a administradora (Ubuntu 22.04 ou 24.04), o instalador e um servidor para cada prédio que consiga acessar a rede dos moradores.
- Os sinais de canais que a comunidade pode retransmitir (URLs de pull ou RTMP), os avisos e vídeos de boas-vindas da administradora e os dispositivos dos moradores (set-top boxes, smart TVs com um app player ou um navegador).
- Uma decisão sobre os tipos de moradia (padrão, idoso, estudante) e sobre quem na administradora abre e renova as linhas.
Implantação da infraestrutura
O servidor central, depois um node por prédio.
- Execute o instalador no servidor central e defina a URL base de reprodução como um endereço que os prédios consigam acessar.
- Adicione os sinais de canais em Streams e os avisos em Filmes e verifique-os no player web.
- Registre um node por prédio em Servidores; o painel o instala por SSH, ou o node se registra com um código de uso único, e direciona os moradores daquele prédio a ele.
- Adicione o administrador do imóvel em Usuários → adicionar um revendedor, com um grupo que permita linhas e nenhuma alteração no catálogo.
Organização do conteúdo
Grades por tipo de moradia.
- Crie um bouquet por grade a partir dos canais de cada tipo de moradia e um bouquet para as informações da administradora.
- Adicione o bouquet de informação a todos os pacotes para que cada morador receba os avisos.
- Crie um pacote por tipo de moradia com seus bouquets e uma duração compatível com o contrato ou o período de ocupação.
- Ordene os canais e dê logotipos a eles para que o menu da televisão fique bem legível.
Configuração de parceiros (revendedores)
O administrador do imóvel como conta delegada.
- Crie um grupo com permissões limitadas a linhas, sem acesso ao catálogo nem aos servidores.
- Adicione cada administrador de imóvel como revendedor com esse grupo, os pacotes das suas moradias e um saldo de créditos.
- Um administrador de vários prédios pode adicionar um subrevendedor por prédio, cada um com suas moradias e créditos.
Configuração dos apartamentos (linhas)
Uma linha por apartamento, com o número como nome.
- Crie uma linha por apartamento em Linhas → adicionar, com o número do apartamento como nome e o pacote desse tipo de moradia.
- Defina o máximo de conexões como o número de televisões da moradia.
- Use um código de ativação em vez de uma senha quando o morador puder digitar um código curto no dispositivo.
- Configure o dispositivo uma única vez (Xtream Codes API ou M3U com as credenciais da linha, ou o portal MAG ou Enigma2); as credenciais ficam com o apartamento até que a linha receba novas.
Vídeos de boas-vindas e avisos
Os vídeos da administradora sob demanda.
- Envie 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 pelo painel quando a informação mudar; os moradores veem a nova versão imediatamente.
Canais e o canal de informação
A grade e o canal de avisos como streams ao vivo.
- Adicione cada canal licenciado em Streams com o seu sinal e uma fonte EPG para que o guia na televisão mostre os programas.
- Adicione o canal de informação como stream ao vivo, alimentado por um encoder via RTMP ou por uma fonte em loop, 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 vencimento
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 próximo morador a ativa de novo com novas credenciais, de modo que nada fique com a família anterior.
- Inscreva 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 cobrança
Os sistemas abrem o acesso; o player reproduz.
- Crie uma chave da Reseller API para o sistema de habitação ou cobrança; ele chama create_line, renew_line, enable_line e disable_line e envia um id de requisição a cada escrita.
- Use um conector de e-commerce quando os moradores comprarem pacotes extras online; qualquer outro sistema usa a Reseller API e webhooks.
- Não há login único para espectadores: um morador entra no player 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 reverso com TLS e defina TRUSTED_PROXIES para que o log de auditoria e as regras de IP vejam os endereços reais.
- Login em duas etapas para toda conta da administração; os administradores de imóveis recebem um grupo de permissões limitado a linhas.
- Um limite de conexões por linha, links de reprodução assinados e com expiração e vínculo de endereço onde os dispositivos têm endereços fixos.
- Ative o backup criptografado do banco de dados com cópia externa; as credenciais das linhas estão nele.
Solução de problemas
As primeiras verificações habituais.
- Um apartamento está sem televisão: verifique se a linha dele está ativada e não expirada e depois as credenciais do dispositivo e o endereço de reprodução.
- Um prédio trava à noite: verifique o heartbeat do node do prédio e se os moradores estão direcionados a ele.
- Falta um canal para um tipo de moradia: 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 a ele.