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 programa ou apoiador. A tabela diz qual objeto faz qual papel; os capítulos abaixo os configuram nessa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| O canal do estúdio | 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) |
| Biblioteca de programas | 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 |
| Nível de assinatura | Bouquet: um conjunto nomeado de canais, filmes ou séries que um pacote concede | Bouquets, a partir de Streams e Movies / Series |
| Acesso do apoiador | 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 cobrança | 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 |
| Conta de afiliado ou distribuidor | 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 |
| Integração com loja ou assinatura | 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 (Ubuntu 22.04 ou 24.04) com endereço público ou um domínio e banda de saída suficiente para o público que você espera.
- Os episódios finalizados, o playout ou encoder do estúdio para o canal e uma loja em uma plataforma com conector, ou a capacidade de chamar uma API HTTP.
- Uma decisão sobre níveis e afiliados: o que cada assinatura concede e quem pode vendê-la.
Implantação da infraestrutura
Primeiro um servidor, nodes conforme o público cresce.
- Execute o instalador no servidor de gerenciamento e coloque o painel atrás de um proxy reverso com TLS; defina os proxies confiáveis para que as regras de IP vejam o endereço real do espectador.
- Defina a URL base de reprodução com o endereço público que o seu público acessa.
- Registre um node em Servidores em uma região onde muitos apoiadores assistem; o painel o instala por SSH e direciona os espectadores dessa região a ele.
- Crie uma conta de parceiro (revendedor) para cada integrante da equipe que cuida do catálogo ou dos apoiadores, com seu próprio grupo de permissões.
Organização do conteúdo
Programas como séries, níveis como bouquets.
- Crie categorias por gênero e uma série por programa, com uma temporada por lote de lançamento e um episódio por vídeo.
- Crie um bouquet para o canal ao vivo, um para o conteúdo gratuito ou de entrada e um para cada nível superior.
- Crie um pacote por nível com o período de cobrança como duração, um pacote de teste para novos visitantes, se quiser, e um preço em créditos para os afiliados.
- Mantenha o acervo em uma categoria própria para poder movê-lo entre níveis sem mexer nas séries.
Configuração de parceiros (revendedores)
Afiliados e distribuidores.
- Crie um grupo para afiliados apenas com permissões de linhas, para que não possam alterar o catálogo.
- Adicione cada afiliado como revendedor com esse grupo e um saldo de créditos; o preço do pacote dele é o que o estúdio decidir.
- Um distribuidor com subafiliados pode criar subrevendedores na sua própria conta, em até cinco níveis.
Configuração do acesso dos apoiadores
Uma linha por apoiador.
- Instale o conector da sua loja (WooCommerce, por exemplo) e informe a chave da Reseller API e o pacote correspondente a cada produto.
- Na assinatura, o conector chama create_line com o pacote e um id de requisição; o período de cobrança é a duração do pacote.
- Defina o máximo de conexões como o número de dispositivos que um apoiador pode usar, normalmente dois ou três.
- Para um sorteio ou um lançamento, gere códigos de ativação em massa ou adicione linhas em Linhas → adicionar com um pacote de teste.
Biblioteca de programas
Episódios sob demanda.
- Envie cada episódio como fonte, ou ingira-o com o job de ingestão de VOD; preencha o título, a temporada, o número do episódio e os metadados do TMDB, se o programa tiver.
- Associe cada série aos bouquets dos níveis que podem assisti-la.
- Verifique a reprodução com uma linha de teste de cada nível antes de anunciar um lançamento.
O canal do estúdio
Um canal o dia todo.
- Adicione um stream ao vivo para o playout do estúdio (push RTMP) e coloque-o nos bouquets de todos os níveis que incluem o canal.
- Carregue o guia do canal como XMLTV para que os apoiadores vejam o que está no ar e ative o catch-up para os programas que valem ser revistos.
- Mantenha o playout funcionando entre lançamentos com o conteúdo agendado do próprio estúdio; o painel apenas retransmite o stream.
Vencimento da assinatura
O acesso acompanha o pagamento.
- Uma linha expira no fim do período do seu pacote; a loja a renova com renew_line quando o próximo pagamento chega.
- Inscreva a loja nos webhooks para enviar um lembrete em line.expiring e rebaixar um apoiador em line.expired.
- Um apoiador que cancela é desativado pela loja com disable_line, e a linha pode ser renovada mais tarde sem uma nova conta.
Integração com a loja
A loja vende; o player reproduz.
- O conector cria, renova e desativa linhas de acordo com os pedidos; qualquer outra loja usa a Reseller API e webhooks.
- Os afiliados veem as próprias linhas em seu painel, e a Reseller API permite que eles automatizem isso.
- Não há login único para espectadores: os apoiadores entram no player com as credenciais da própria linha, que a loja envia a eles.
Considerações de segurança
Proteja a assinatura, não só o servidor.
- Sirva o painel e a URL base de reprodução com TLS e defina TRUSTED_PROXIES com o seu proxy reverso.
- Login em duas etapas para toda conta do painel e grupos de permissões para que os afiliados não possam alterar o catálogo.
- Links de reprodução assinados e com expiração e um limite de conexões por linha; vincule uma linha a um país se uma licença for territorial.
- 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.
Solução de problemas
As primeiras verificações habituais.
- Um novo apoiador não consegue assistir depois de pagar: verifique a chamada do conector da loja no log da Reseller API e a data de vencimento da linha.
- Um apoiador vê conteúdo de um nível superior: verifique o pacote da linha e os bouquets que ele concede.
- O canal para no fim de um ciclo do playout: verifique o push do encoder para o stream ao vivo e o status de sondagem do stream.
- A venda de um afiliado não aparece: verifique os créditos dele e se o pacote usado pertence ao seu grupo.