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 loja ou franqueado. A tabela diz qual objeto faz qual papel; os capítulos abaixo os configuram nessa ordem.
| No seu setor | Na plataforma | Onde no painel |
|---|---|---|
| Canal de loja ou coleção de treinamento | Bouquet: um conjunto nomeado de canais, filmes ou séries que um pacote concede | Bouquets, a partir de Streams e Movies / Series |
| Canal de loja | 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ídeo de treinamento e de produtos | 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 |
| Tela da loja ou acesso de funcionário | 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 |
| Conta de franqueado | 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 |
| Node regional | Nodes de streaming: servidores de borda registrados pelo painel, um por local ou prédio | Servers → adicionar um node, instalado por SSH |
| Telas ou dispositivos por linha | Máximo de conexões da line: quantos dispositivos podem assistir ao mesmo tempo | O máximo de conexões da line |
Pré-requisitos
O que ter antes de instalar.
- Um servidor da matriz (Ubuntu 22.04 ou 24.04), o instalador e um servidor para cada região que tenha muitas lojas e possa ser acessado por elas.
- O conteúdo do canal de loja (um encoder ou uma fonte em loop), as gravações de integração e treinamento de produtos e as telas ou media players nas lojas.
- Uma decisão sobre a estrutura da franquia: quais regiões recebem um node e quem em cada franqueado gerencia as linhas.
Implantação da infraestrutura
Primeiro a matriz, depois as regiões.
- Execute o instalador no servidor da matriz e defina a URL base de reprodução como um endereço que as lojas consigam acessar, atrás de TLS.
- Adicione o canal de loja em Streams e as gravações de treinamento em Filmes e verifique-os no player web.
- Registre um node por região em Servidores; o painel o instala por SSH, ou o node se registra com um código de uso único, e direciona as lojas daquela região a ele.
- Crie uma conta de parceiro para a equipe de conteúdo da matriz com permissões para o catálogo e nenhuma para as linhas das lojas.
Organização do conteúdo
O canal de loja e a biblioteca de treinamento.
- Crie um stream ao vivo para o canal de loja e coloque-o em um bouquet próprio.
- Crie categorias por tema e uma série por curso de treinamento, com um episódio por aula; adicione um bouquet por função (vendedores, gerentes, recém-chegados).
- Crie um pacote para as telas das lojas e um pacote por função, cada um concedendo seus bouquets e tendo o período de acesso como duração.
- Dê aos franqueados os pacotes que eles podem repassar às suas lojas e equipes.
Configuração de parceiros (revendedores)
Uma conta de parceiro por franqueado.
- Crie um grupo com permissões limitadas a linhas, sem alterações no catálogo.
- Adicione cada franqueado em Usuários → adicionar um revendedor, com esse grupo, seus pacotes e um saldo de créditos.
- Um franqueado com várias regiões pode adicionar um subrevendedor por região, cada um com suas próprias lojas.
Configuração das linhas de lojas e funcionários
Uma linha por tela e por funcionário.
- Crie uma linha por tela de loja em Linhas → adicionar com o nome da loja e o pacote de loja; o franqueado faz o mesmo para as suas lojas.
- Defina o máximo de conexões como o número de telas da loja e como dois para um funcionário (salão de vendas e celular).
- Vincule uma linha de loja ao endereço da loja quando ela tiver um fixo, para que as credenciais não funcionem em outro lugar.
- Configure o player da tela uma única vez (M3U, Xtream Codes API ou o endereço do player web) e guarde as credenciais na pasta da loja.
Vídeo de treinamento e de produtos
A biblioteca para funcionários.
- Envie cada curso de treinamento como série e cada filme de produto como filme, ou ingira-os com o job de ingestão de VOD na raiz de mídia.
- Coloque as gravações no bouquet da função certa por meio das categorias delas.
- Verifique o que cada função vê com uma linha de teste antes de abrir a biblioteca aos franqueados.
O canal de loja
Um canal para todas as telas.
- Adicione o canal de loja como stream ao vivo, alimentado pelo encoder da matriz via RTMP ou por uma fonte em loop.
- Ative o catch-up para as sessões de treinamento que vão ao ar ao vivo e envie a gravação para a biblioteca depois.
- Os nodes das regiões pegam o canal uma única vez da origem e atendem suas lojas, de modo que os links das lojas não saturam.
Vencimento e renovação
O acesso acompanha a loja ou o contrato.
- Uma linha expira no fim do período do seu pacote; o franqueado a renova com um pacote ou um crédito.
- Desative a linha de uma loja fechada ou de um funcionário que está saindo.
- Inscreva o sistema de gestão de franquias ou de RH nos webhooks para ver linhas prestes a expirar ou já expiradas.
Integração com sistemas de franquia ou RH
Os sistemas controlam as linhas; o player reproduz.
- Crie uma chave da Reseller API para o sistema de gestão de franquias ou de RH; ele chama create_line, renew_line, enable_line e disable_line, com um id de requisição em cada escrita.
- Use um conector de e-commerce quando você cobrar os franqueados pelo serviço; qualquer outro sistema usa a Reseller API e webhooks.
- Não há login único para espectadores: os funcionários entram no player com as credenciais da própria linha.
Considerações de segurança
Mantenha cada loja nas suas próprias linhas.
- 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 matriz; os franqueados recebem um grupo de permissões limitado às próprias linhas.
- Um limite de conexões por linha, links de reprodução assinados e com expiração e vínculo de endereço para as telas das lojas.
- Ative o backup criptografado do banco de dados com cópia externa e use o log de auditoria para revisar alterações de linhas e do catálogo.
Solução de problemas
As primeiras verificações habituais.
- Uma tela de loja está preta: verifique se a linha dela está ativada e não expirada, o vínculo de endereço e o limite de conexões se um segundo dispositivo estiver usando a linha.
- Uma região trava: verifique o heartbeat do node regional e se as lojas estão direcionadas a ele.
- Um franqueado não consegue criar linhas: verifique o saldo de créditos, as permissões do grupo e os pacotes atribuídos a ele.
- O log de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES com o proxy e reinicie o painel.