LISTAS E VENDAS DE LIVE — versão 0.2

INSTALAÇÃO / ATUALIZAÇÃO
Extraia o ZIP. Se já instalou a versão anterior, substitua os arquivos na mesma pasta e clique Recarregar em chrome://extensions. Assim preserva as listas salvas. Não remova a extensão para atualizar. Se ainda não instalou, ative Modo do desenvolvedor e use Carregar sem compactação.

REGISTRAR VENDAS
No Console de LIVE do TikTok Shop, abra a extensão, dê um nome à live e clique Iniciar / retomar registro. Pode fechar o popup. A captura lê os dados da página a cada 3 segundos, sem fazer chamadas novas ao TikTok e sem modificar a transmissão. Clique Histórico e Excel para conferir.

O registro inclui os avisos de compra ainda disponíveis na página, incluindo os anteriores ao clique quando permanecem nos dados internos. Não garante recuperação de eventos que já sumiram. Para a próxima live, inicie o registro desde o começo. A aba do TikTok precisa permanecer aberta. Depois de recarregar a página, clique Iniciar / retomar registro novamente. O histórico salvo permanece.

Ao encerrar a live, clique Finalizar registro no histórico. Esse botão só encerra a captura; não termina a live do TikTok. Na próxima live, inicie novo registro. Se o horário de início do painel mudar, a captura para para evitar misturar lives. Os registros usam o nome escolhido e horário do painel, quando disponível. Use nomes distintos quando alternar contas.

COMISSÕES
O registro cruza o título da compra com um único produto de mesmo título. Não usa posição sozinha porque ela pode mudar. Se não encontrar o produto/taxa, a comissão fica vazia, nunca zero inventado. Para ajudar a leitura, apague o filtro da lista e deixe os produtos vendidos aparecerem nos cartões. O leitor também tenta obter a lista dos componentes internos, quando disponível.

A taxa commission_rate é dividida por 10000 (500 corresponde a 5%, compatível com o exemplo recebido). Estimativa = valor do aviso × taxa, arredondada por evento. Campos de recompensa são preservados sem somar bônus. Taxa do cartão pode diferir da taxa efetiva da compra. Não informa comissão confirmada, cancelamento, envio nem recebimento real.

HISTÓRICO / EXPORTAÇÃO
Escolha a live no histórico e clique Exportar Excel (.xlsx). Abas: Resumo, Vendas e Produtos. Valores e taxas são números; IDs são texto; datas mostram Bahia. Fórmulas calculam estimativas e totais no Excel. Perfil, IDs, produto, preço, posição, horários e campos de comissão disponíveis são incluídos. ID do evento não está comprovado como número do pedido. Contagem representa avisos de compra, não quantidade detalhada de unidades.

Faça também Backup dos dados (.json): preserva o registro inteiro, incluindo os campos originais. O histórico é local, sem sincronização. Remover a extensão, limpar seus dados ou perder o perfil do Chrome pode apagar o histórico. A captura não tem limite de 150 vendas; esse limite é apenas para listas de produtos.

LISTAS DE PRODUTOS
Salve até 150 produtos com nome. Para carregar, a lista do painel deve estar vazia. Mantenha o popup aberto durante salvar/carregar. Não troca automaticamente uma lista preenchida. Não restaura condições de ofertas relâmpago nem garante a ordem final do TikTok.

VALIDAÇÃO
Testes locais verificam deduplicação, preços, taxas, arredondamento, associação ambígua, IDs como texto e estrutura XLSX. A leitura real depende da estrutura do TikTok e precisa ser validada na sua conta. Confira o primeiro registro no histórico antes de depender dele. Não remova a lista de produtos nem reinicie uma transmissão apenas para testar.

CARRINHOS (versão 0.3.0)
A aba Carrinhos guarda avisos add_to_cart_filter por live, sem duplicar IDs. Perfil, produto, posição, horários, agregação e quantidade informada são preservados. Não são compras confirmadas nem pessoas únicas. O Excel inclui a aba Carrinhos e o backup JSON também guarda esses avisos. Carrinhos antigos que já saíram dos dados da página podem não ser recuperados. Após atualizar, recarregue o TikTok e clique Iniciar / retomar registro.

VISUALIZAÇÃO DE CARRINHOS (versão 0.3.1)
Carrinhos agora mostra grupos por título do produto, perfis e contagens de avisos, com busca por produto/perfil e ordenação por mais recentes, mais avisos ou nome. Ver horários e detalhes expande os avisos de cada produto. Os dados originais continuam no backup e no Excel.

VENDAS E JANELA AO VIVO (versão 0.4.0)
Vendas aparece em cartões com busca por perfil/produto e ordenação por recentes, valor ou comissão estimada.
Abra Janela ao vivo no popup, ou Acompanhar ao vivo no histórico. Arraste pela barra de título e redimensione a janela para colocá-la ao lado do TikTok. É uma janela separada do Chrome; não fica sempre acima de outros aplicativos.
Filtros Tudo, Compras e Carrinhos mostram os 100 avisos mais recentes da live selecionada. Todos os registros permanecem no histórico e no Excel. A janela recebe atualizações do registro e sinaliza falta de leitura recente. Manter o TikTok aberto e registro ativo. Fechar a janela não encerra o registro.

PAINEL DENTRO DO TIKTOK (versão 0.4.1)
Na extensão, clique Painel flutuante no TikTok. O painel fica sobre a própria página ao clicar e rolar o console. Carrinhos recentes em cima, compras recentes embaixo; cada seção tem rolagem própria e mostra até 50 avisos recentes. Arraste pelo título, redimensione pelo canto, use − para recolher ou × para ocultar. Fechar não interrompe captura. Ao recarregar o TikTok, retome registro e abra o painel novamente. A janela separada continua disponível pelo histórico.

ALERTAS DO PAINEL (versão 0.4.2)
Novos carrinhos recebem destaque amarelo e novas compras verde por 10 segundos. A seção volta ao topo ao receber aviso novo. Clique Som: off para ativar: toca um som de teste; carrinhos usam um toque e compras dois. O som inicia desligado a cada recarga e precisa do clique para habilitar áudio no navegador. Abrir o painel não alerta os registros históricos; IDs já vistos e atualizações de comissão não repetem alertas.

Versão 0.4.3: compras usam efeito sintetizado de caixa registradora (cliques mecânicos e sino metálico). Ao ativar Som: on, o efeito de compra toca como teste.

CORREÇÃO DE CARGA (0.4.4)
Confirma adição pelo produto no console ou redução da capacidade, mesmo que a janela permaneça aberta. Permite retomar a lista salva pulando IDs já visíveis no console; não remove produtos. Interrompe se detectar produtos visíveis de outra lista. Mantém limite de 150. Deixe o popup aberto enquanto carrega. Em interrupção informa quantos adicionou e pode tentar a mesma lista novamente.

CARGA EM LOTE (0.5.0)
Pesquisa e marca os produtos disponíveis; confere novamente as seleções e confirma em um lote. Produtos não encontrados, desabilitados ou que não podem ser marcados são pulados e listados no resumo com seus nomes. Não usa Selecionar todos na vitrine, pois isso incluiria produtos fora da lista salva. Se o TikTok descartar seleções entre buscas, interrompe antes de confirmar o lote. A conferência adicional preserva a lista correta, mas ainda exige pesquisas individuais. Mantenha o popup aberto.

0.5.1: corrige capacidade exibida após seleção em lote: soma selecionados e espaços restantes para validar limite. Confere quantidade selecionada antes de clicar Adicionar produtos.

0.5.3: progresso animado na própria página, mostrando verificados, restantes, selecionados, pulados e adicionados. Diferencia seleção, conferência e confirmação do lote. Abre relatório final em aba separada com produtos pulados, motivos e seleção não confirmada se interromper. Pode baixar relatório em TXT. Inclui correção da capacidade após seleção.


VERSÃO 0.6.0 — DASHBOARD E REGISTRO AUTOMÁTICO
O ícone abre o dashboard: filtros diário, mensal e todo o histórico; top 5 compras e carrinhos; totais de vendas e comissão estimada. Menu Listas de produtos mantém as funções anteriores.
Depois de atualizar a extensão em chrome://extensions, recarregue o Console de LIVE do TikTok. O registro inicia com dois sinais concordantes de live (espectadores atuais, horário de início, duas pessoas entrando) e ignora Modo de prática. Após 30 segundos de painel inativo, encerra o registro. Mudança do horário de início cria nova sessão; recarregar a mesma live mantém o registro. A captura começa quando os sinais são reconhecidos; avisos já removidos pelo TikTok não são recuperados.
Valor de carrinho é estimado com o preço observado no cartão no momento da captura, uma unidade por aviso individual. Agregados e avisos antigos sem preço não entram no valor. Os rankings contam avisos, não unidades. Filtros usam horário dos eventos em America/Bahia.
Atualize a mesma pasta e clique em Recarregar na extensão; não remova a extensão, para preservar seu histórico.


VERSÃO 0.6.1
Encerramento automático quando o painel exibe LIVE encerrada; sem mensagem explícita, aguarda 12 segundos de perda dos sinais ativos com o painel presente. Recarregar/navegar (painel ausente) não é interpretado como encerramento. Fechar o console interrompe a captura, sem afirmar que encerrou a transmissão.
Acompanhar ao vivo mostra somente registros vinculados a consoles ativos, com leitura recente; sem vínculo, inicia zerado. Registros finalizados ficam apenas no histórico. Eventos já salvos em outras lives não entram na nova.
Tela de listas com escolha do console, prévia de produtos e atalhos. Histórico com resumo e auditoria da estimativa de comissão por produto.
Comissão: o valor do aviso multiplicado pela taxa é uma ESTIMATIVA PARCIAL. A regra oficial usa base de comissão (pagamento mais subsídios aplicáveis) e pode incluir bônus. Não temos essa base nem a comissão oficial do pedido no evento order_filter; não somamos campos de bônus sem comprovar sua aplicação. A referência est_commission_expense do cartão não é comissão do pedido. Fonte: https://seller-br.tiktok.com/university/essay?knowledge_id=1517752301717265&lang=en
Exemplo real: R$448,48 x 5% = R$22,42. Referência do cartão: R$498,48 x 5% = R$24,92. Esta diferença não comprova qual base foi aplicada ao pedido real.


VERSÃO 0.6.2 — LISTAS NA EXTENSÃO
Histórico de lives abre em outra aba (vendas, carrinhos e Excel). Listas de produtos abre dentro do popup da extensão. Localiza automaticamente consoles de LIVE abertos; se houver mais de um, escolha a aba. Sem console, carregar/salvar da LIVE fica desativado; ver e editar listas salvas continua disponível.
Editar lista permite renomear, remover produtos, mudar ordem e adicionar produtos da LIVE vinculada sem duplicar IDs, até 150. As alterações só são persistidas ao clicar em Salvar alterações; Cancelar preserva a lista original. Não altera a lista atual no TikTok até Carregar na LIVE.


VERSÃO 0.6.3 — NAVEGAÇÃO NO DASHBOARD
Visão geral, Histórico de lives (vendas e carrinhos) e Acompanhar ao vivo abrem dentro do mesmo dashboard, sem nova aba ou janela. Listas de produtos continua no popup da extensão para carregar produtos no Console do TikTok. O painel flutuante do Console continua disponível.


VERSÃO 0.6.4
Acompanhar ao vivo voltou a abrir o painel flutuante dentro do Console do TikTok. É um botão na parte de baixo do dashboard, fora do menu. Carrinhos em cima, compras embaixo, destaque por cor e som de caixa registradora ao ativar Som: on. Histórico e demais telas seguem dentro do dashboard.


VERSÃO 0.6.5
Botão Acompanhar ao vivo abaixo do aviso de registros salvos no navegador. Painel flutuante abre automaticamente ao detectar a LIVE e após recarregar o console. No painel, engrenagem ao lado de Som abre escolha/teste de sons separados para carrinho (bipe, pop, campainha) e compra (caixa registradora, moedas, melodia), volume e silêncio. Preferências persistem; ative Som: on para liberar áudio após carregar a página.
Cabeçalho mostra soma da comissão estimada parcial da live atual, começando em R$0,00, atualizada por evento único, sem duplicar vendas. Mostra quantas vendas estão sem cálculo. Nova live começa zerada.


VERSÃO 0.6.6
Novos sons reais nas configurações: Caixa registradora · tchim! (2,2 segundos) e Aplausos (3 segundos). Incluídos no pacote; não dependem de baixar som durante a live. O antigo caixa sintetizado é substituído pelo novo tchim como seleção inicial. Use engrenagem > Compra registrada > Testar compra para ouvir. Fontes e créditos em sounds/FONTES.txt.


VERSÃO 0.6.7
Tchim substituído pelo MP3 enviado pelo usuário, de u_byub5wd934 / Pixabay. Mesma opção nas configurações; preferências preservadas.


VERSÃO 0.6.8
Aplausos substituídos pelo MP3 enviado pelo usuário, de Mauricio Póvoa / Pixabay, sem corte. Tchim enviado anteriormente mantido.
