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 loja ou franquiado. 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 |
|---|---|---|
| Canal de loja ou coleção de formação | 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 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ídeo de formação e de produto | 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 |
| Ecrã de loja ou acesso de colaborador | 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 |
| Conta de franquiado | 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 |
| Nó regional | Nós de streaming: servidores edge registados a partir do painel, um por local ou edifício | Servers → adicionar um nó, instalado por SSH |
| Ecrãs ou dispositivos por linha | Máximo de ligações da linha: quantos dispositivos podem ver em simultâneo | O máximo de ligações da linha |
Pré-requisitos
O que ter antes de instalar.
- Um servidor da sede (Ubuntu 22.04 ou 24.04), o instalador e um servidor para cada região que tenha muitas lojas e possa ser alcançado por elas.
- O conteúdo do canal de loja (um codificador ou uma fonte em ciclo), as gravações de integração e formação de produto e os ecrãs ou media players nas lojas.
- Uma decisão sobre a estrutura da franquia: que regiões recebem um nó e quem em cada franquiado gere as linhas.
Implementação da infraestrutura
Primeiro a sede, depois as regiões.
- Execute o instalador no servidor da sede e defina o URL base de reprodução para um endereço que as lojas consigam alcançar, atrás de TLS.
- Adicione o canal de loja em Streams e as gravações de formação em Movies e verifique-os no leitor web.
- Registe um nó por região 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 as lojas dessa região.
- Crie uma conta de parceiro para a equipa de conteúdo da sede 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 formação.
- Crie um stream em direto para o canal de loja e coloque-o num bouquet próprio.
- Crie categorias por tema e uma série por curso de formação, com um episódio por aula; adicione um bouquet por função (vendedores, gestores, recém-chegados).
- Crie um pacote para os ecrãs das lojas e um pacote por função, cada um a conceder os seus bouquets e com o período de acesso como duração.
- Dê aos franquiados os pacotes que podem repassar às suas lojas e equipas.
Configuração de parceiros (revendedores)
Uma conta de parceiro por franquiado.
- Crie um grupo com permissões limitadas a linhas, sem alterações ao catálogo.
- Adicione cada franquiado em Users → add a reseller, com esse grupo, os seus pacotes e um saldo de créditos.
- Um franquiado com várias regiões pode adicionar um subrevendedor por região, cada um com as suas próprias lojas.
Configuração das linhas de lojas e colaboradores
Uma linha por ecrã e por colaborador.
- Crie uma linha por ecrã de loja em Lines → add com o nome da loja e o pacote de loja; o franquiado faz o mesmo para as suas lojas.
- Defina o máximo de ligações como o número de ecrãs da loja e como dois para um colaborador (zona de vendas e telemóvel).
- Associe uma linha de loja ao endereço da loja quando esta tiver um fixo, para que as credenciais não funcionem noutro lado.
- Configure o leitor do ecrã uma só vez (M3U, API Xtream Codes ou o endereço do leitor web) e guarde as credenciais no processo da loja.
Vídeo de formação e de produto
A biblioteca para colaboradores.
- Carregue cada curso de formação como série e cada filme de produto como filme, ou ingira-os com a tarefa de ingestão de VOD na raiz de media.
- Coloque as gravações no bouquet da função certa através das respetivas categorias.
- Verifique o que cada função vê com uma linha de teste antes de abrir a biblioteca aos franquiados.
O canal de loja
Um canal para todos os ecrãs.
- Adicione o canal de loja como stream em direto, alimentado pelo codificador da sede por RTMP ou por uma fonte em ciclo.
- Ative o catch-up para as sessões de formação que vão para o ar em direto e carregue a gravação para a biblioteca depois.
- Os nós das regiões obtêm o canal uma só vez da origem e servem as suas lojas, pelo que as ligações das lojas não saturam.
Validade e renovação
O acesso acompanha a loja ou o contrato.
- Uma linha expira no fim do período do seu pacote; o franquiado renova-a com um pacote ou um crédito.
- Desative a linha de uma loja encerrada ou de um colaborador que sai.
- Subscreva 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 leitor reproduz.
- Crie uma chave da Reseller API para o sistema de gestão de franquias ou de RH; este chama create_line, renew_line, enable_line e disable_line, com um id de pedido em cada escrita.
- Use um conector de comércio eletrónico quando faturar os franquiados pelo serviço; qualquer outro sistema usa a Reseller API e webhooks.
- Não há início de sessão único para espectadores: os colaboradores entram no leitor com as credenciais da sua linha.
Considerações de segurança
Mantenha cada loja nas suas próprias linhas.
- 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 sede; os franquiados recebem um grupo de permissões limitado às suas próprias linhas.
- Um limite de ligações por linha, ligações de reprodução assinadas e com expiração e associação de endereço para os ecrãs das lojas.
- Ative a cópia de segurança cifrada da base de dados com cópia externa e use o registo de auditoria para rever alterações de linhas e do catálogo.
Resolução de problemas
As primeiras verificações habituais.
- Um ecrã de loja está preto: verifique se a sua linha está ativada e não expirada, a associação de endereço e o limite de ligações se um segundo dispositivo estiver a usar a linha.
- Uma região bloqueia: verifique o heartbeat do nó regional e se as lojas estão encaminhadas para ele.
- Um franquiado não consegue criar linhas: verifique o saldo de créditos, as permissões do grupo e os pacotes atribuídos.
- O registo de auditoria mostra o endereço do proxy: defina TRUSTED_PROXIES para o proxy e reinicie o painel.