Clientes¶

A secção Clientes responde às duas perguntas do vendedor: quem nos compra e o que exatamente cada um comprou. Um cliente aqui é uma pessoa coletiva com contrato, não uma conta: o cliente não inicia sessão em lado nenhum, e o seu pessoal, se precisar de acesso ao painel, recebe contas normais.

O serviço de um cliente não se cria com um botão próprio. Ele é derivado das definições dos streams: o push e a entrega SRT têm o campo Vendido para, e assim que uma entrega nomeia um cliente, esse cliente passa a ter um serviço sobre esse stream. Retire a última entrega e o serviço desaparece sozinho.

Está feito assim para não haver duas fontes de verdade. Um registo separado do serviço acabaria por divergir das definições, e o operador teria duas imagens que não coincidem: o vendido no papel e o que vai para o ar.

O que a secção não faz¶

A secção mantém a composição do que foi vendido, não a faturação nem a monitorização:

• não há nela tarifários, faturas nem dinheiro;
• os gráficos, o histórico e a qualidade do serviço vivem no painel de controlo e na página do stream — aqui, junto a cada coisa comprada, mostra-se apenas o seu estado atual, o suficiente para atender uma chamada de «não temos imagem» sem sair da página.

A lista de clientes¶

A lista tem quatro colunas: Identificador, Nome, Contrato e Estado (Ativo ou Desativado). A linha leva à ficha do cliente.

O botão Adicionar cliente abre um formulário de três campos: identificador, nome e contrato. O primeiro merece atenção.

O identificador não pode ser alterado. Ele não apenas endereça o cliente: é o que viaja como rótulo user_id_<identificador> para as definições das entregas e é o que nomeia o espectador na estatística de sessões. Alterá-lo depois é impossível — a alteração deixaria órfãs de uma vez todas as entregas vendidas. São admitidas letras latinas, dígitos, ponto, hífen e sublinhado; o formulário verifica o valor da mesma forma que o rótulo o verificará depois e rejeita um inservível no próprio campo.

A ficha do cliente¶

A ficha tem três partes: os serviços, as chaves de acesso dentro deles e as contas.

Serviços¶

Um serviço é um stream por trás do qual está pelo menos uma entrega deste cliente. De cada um mostra-se:

• o indicador de estado do stream, o seu bitrate atual e a classe de imagem;
• a lista de entregas: o tipo (Push, Token de reprodução, Reprodução SRT), o nome, o destinatário (protocolo, host e porta, sem chaves nem palavras-passe), o estado, o tempo no ar da execução atual, o número de erros de envio e o de reinícios, se os houve.

O nome do stream leva à sua página; a entrega, à aba onde é configurada. Qualquer análise do serviço continua ali.

Um valor que não existe não é substituído por zero: um serviço que não está a ser observado — o stream não está no ar, a estatística está fechada pela licença, a máquina não respondeu — simplesmente não mostra bitrate nem contadores. Uma entrega desativada pelo operador é marcada Desativado e não mostra contadores nenhuns: «erros: 0» ao lado da palavra «desativado» leria-se como «funciona e não falha».

O número de reinícios merece nota à parte. Uma entrega que nunca chegou a ligar-se tem zero erros de envio e centenas de reinícios: é esse número que responde a «então porque é que o cliente não tem nada».

Chaves de acesso¶

Uma chave de acesso é a cadeia do link com que o comprador assiste ao canal. As chaves são declaradas nas definições do próprio stream, e na ficha veem-se as que pertencem a este cliente. Criar uma chave nova o painel ainda não faz — isso passa pela API de gestão —, mas mostrar a entregue, dar ao operador um link pronto e revogá-la, faz.

• Entregue a — o nome da chave. É o operador que o escolhe: é uma nota sobre a quem foi entregue («escritório central», «reserva»), não um endereço nem um login.
• Token — o valor por inteiro. Não é mascarado: ao comprador é enviado por correio, e esconder no painel o que de qualquer forma sai para fora só atrapalha o operador. Aos papéis sem acesso às definições a chave não é mostrada de todo.
• Copiar o link copia não a chave mas um link de reprodução pronto, com o endereço, o nome do stream e a chave. Não é preciso montá-lo à mão: é aí que aparecem os erros de digitação. O endereço é aquele pelo qual o painel está aberto; se a entrega vive noutro domínio, o link é montado com o endereço público de reprodução das definições da instalação de controlo.
• Revogar apaga a chave. Não há um estado «revogada» à parte: o registo da chave é o próprio direito de acesso. A reprodução em curso para na verificação de acesso seguinte, por isso o botão pede confirmação.

Uma chave abre apenas o stream em cujas definições está declarada, e apenas para ver: publicar com ela é impossível e não dá acesso à API de gestão. Uma sessão aberta com uma chave é nomeada na estatística pelo identificador do seu cliente: é assim que o consumo de cada comprador é contado em separado.

Contas¶

Aqui estão as contas do painel que pertencem a este cliente — por exemplo, os engenheiros do comprador a quem foi dado acesso. O campo em baixo vincula um login existente; o botão da linha desvincula-o.

• Um cliente pode ter quantas contas forem precisas, mas uma conta tem no máximo um cliente: ao tentar vincular um login já tomado, o painel nomeia o cliente a quem ele pertence.
• Uma conta sem cliente é o normal: é assim que são as contas dos seus próprios operadores.
• Se o login foi eliminado na secção Contas, o vínculo continua visível com a marca Não existe essa conta. Não é um erro de integridade: os clientes e as contas são geridos por secções diferentes, e não há uma única ação que os concilie.

A conta em si não é criada aqui: a ficha gere a pertença, não as credenciais.

Rótulos sem cliente¶

Por baixo da lista de clientes aparece a tabela Rótulos sem cliente: entregas marcadas com um identificador que não existe no registo. As causas são exatamente duas: um erro de digitação no rótulo, ou um cliente nomeado num rótulo mas nunca criado no registo.

Escondê-los não é opção: o rótulo de uma entrega não é verificado quando é escrito, e este é o único sítio onde esse erro se torna visível. A linha indica o stream e a entrega, e os botões oferecem criar esse cliente ou abrir o stream e corrigir o rótulo.

Como vender um stream a um cliente¶

1. Crie o cliente nesta secção: identificador, nome, contrato.
2. Abra o stream, vá à aba das definições de entrega e adicione uma entrega: um push para o endereço do comprador ou uma entrega SRT com a sua própria porta e palavra-passe.
3. No campo Vendido para escolha o cliente da lista (imagem abaixo). O valor vazio significa Interno: não vendido a ninguém: é assim que se marcam os pushes de monitorização, de reserva e para mostrar a um parceiro.
4. Guarde. Na ficha do cliente aparecerá o serviço sobre esse stream.

Uma mesma entrega pode ser vendida a vários compradores: o formulário mostra então todos os proprietários e não permite editá-los, porque substituir o conjunto por um único valor retiraria em silêncio a venda a todos os outros.

Se a secção não estiver lá¶

O registo de clientes é um componente à parte da instalação. O pacote do Mcaster ativa-o por si, por isso numa máquina normal a secção funciona desde o início. Se o painel mostrar uma mensagem a dizer que o registo não está ativado, a instalação foi montada sem ele — o que acontece em bancadas montadas à mão; a lista de clientes não está então vazia mas ausente, e isso é dito diretamente para que ninguém procure dados que não faltam.