Central BPO
Central de operação para BPO financeiro: tarefas recorrentes por cliente, cronômetro por pessoa, calendário da operação, cofre de acessos e cadastros, tudo num lugar só e com trilha de quem fez o quê.
Status: app completo ligado ao Supabase (login, tarefas, cronômetro, Home, Calendário, Histórico e Cadastros), backend com 79 testes automáticos, pronto para publicar na Vercel. Todos os nomes de clientes, pessoas, valores e acessos deste repositório são fictícios.
Contexto
Num BPO financeiro, a equipe atende várias empresas ao mesmo tempo, e cada uma tem rotinas diárias, semanais, quinzenais e mensais: conciliação bancária, contas a pagar e a receber, agendamentos, fechamento, relatórios para a contabilidade e revisão de DRE.
Hoje esse controle costuma ficar espalhado entre quadros de tarefas, planilhas, grupos de mensagem e anotações. Isso gera três problemas:
- Não se sabe quanto tempo cada cliente consome. Sem esse número, não dá para precificar nem medir a rentabilidade.
- Não há histórico confiável: quem fez, quando e em quanto tempo.
- Senhas e acessos dos clientes ficam em texto livre, sem controle de quem consultou.
A Central BPO nasceu para resolver isso, a partir da rotina real de uma operação de BPO e do mapeamento de ferramentas de mercado.
Para que serve
| Objetivo | Como a Central resolve |
|---|
| Saber o que fazer hoje, em cada cliente | Rotinas cadastradas geram as tarefas do dia sozinhas, com checklist |
| Medir o tempo real | Cronômetro por pessoa e por cliente; o tempo de cada tarefa é registrado ao concluir |
| Cumprir prazos | Data meta (pronto até) separada da data de entrega; atrasadas em destaque |
| Ver a operação de cima | Painel com andamento por cliente, entregas por dia e tempo médio por tarefa |
| Proteger acessos | Cofre de senhas por cliente; cada visualização e cópia fica registrada |
| Dar responsabilidade clara | Papéis com permissões configuráveis; trilha completa de alterações |
Impacto numa operação de BPO ou de serviços financeiros
- Precificação com base em dado real: horas por cliente e por tarefa saem dos registros, não de estimativa.
- Menos retrabalho e menos esquecimento: a tarefa nasce da rotina, com checklist obrigatório para concluir.
- Escala com controle: um cliente novo entra pelo cadastro, já com as rotinas e a equipe vinculada.
- Segurança e auditoria: senhas fora de cartões e mensagens, acesso por papel e histórico de quem viu ou alterou.
- Gestão que enxerga gargalo: o painel compara o tempo do período com a média histórica de cada tarefa.
Como funciona o dia
- A pessoa entra e vê a Home: o que está atrasado, o que é de hoje e o andamento de cada cliente.
- Em Tarefas, escolhe um cliente: o cronômetro começa (só para ela, só naquele cliente).
- Executa as tarefas do dia. Cada conclusão grava o tempo daquela tarefa (tempo ativo desde a conclusão anterior; pausa não conta).
- Ao sair, escolhe Pausar ("vou em outro cliente e já volto") ou Finalizar ("terminei este cliente hoje").
- Às 22h o registro do dia fecha e congela. Só o administrador corrige, direto no banco.
Abas e funções
| Aba | O que tem |
|---|
| Home | Números do dia, andamento por cliente (hoje, semana, mês ou período personalizado), gráfico de entregas por dia e tempo médio por tarefa × média histórica |
| Tarefas | Lista de clientes vinculados → tela do cliente com tarefas do dia, atrasadas, resto da semana, calendário do mês, anotações, tarefa pontual e Senhas e acessos. Clicar numa tarefa abre o cartão: recorrência, meta e entrega, responsáveis, checklist e observações |
| Calendário | Calendário da operação inteira (mês ou semana), com filtros por cliente, responsável e tipo; meta (◎) e entrega (▸) ligadas |
| Histórico | Registro de atividade por cliente, pessoa e data: iniciou, pausou, concluiu (com tempo), transferiu, consultou senha, alterou cadastro |
| Cadastros · Clientes | Ficha completa: dados, contrato e honorário, sócios, contatos, grupo principal, equipe atrelada; campos sensíveis protegidos |
| Cadastros · Senhas | Todos os acessos de todos os clientes, alerta de senha sem troca há mais de 180 dias, consultas recentes |
| Cadastros · Tarefas | Rotinas por cliente: diária, semanal, quinzenal, mensal ou anual, com meta, responsáveis, checklist padrão e vigência; aplicação a vários clientes de uma vez |
| Cadastros · Colaboradores | Papel, clientes vinculados, carga horária × horas no mês, redefinição de senha de acesso e matriz de permissões editável pelo administrador |
Também tem: tema claro e escuro, quatro tamanhos de texto (pensado para leitura confortável) e datas sempre com ano.
Papéis e permissões
Cinco papéis vêm de fábrica: Estagiária, Analista financeira, Supervisor, Gestor financeiro e Administrador. O que cada um pode fazer fica numa matriz editável pelo administrador, que vale na hora.
Quando um papel não pode fazer algo sensível, a ação vira um pedido ao administrador, e o pedido fica registrado. Isso vale, por exemplo, para alterar CNPJ ou honorário, excluir uma senha ou criar uma rotina.
As regras de negócio completas estão em docs/regras-de-negocio.md.
Estrutura técnica
App (app/)
- HTML, CSS e JavaScript puros em módulos, sem framework. A biblioteca do Supabase é copiada para dentro do site no build (nenhum script de fora).
- O app só lê pelas tabelas e views (com RLS) e só grava pelas funções
central_* do banco.
- Criar login de colaborador e redefinir senha passam pela função de servidor
api/admin.js, que confere se quem chama é administrador. A chave de serviço fica só na Vercel.
Backend
- Supabase/Postgres: migrations com tabelas, funções de regra de negócio, RLS e views. Detalhes em
supabase/README.md.
- O tempo de cada tarefa é calculado no banco, com o relógio do servidor; as senhas ficam cifradas, com a chave no Vault.
- 79 testes automáticos num Postgres descartável (
npm run test:db).
Protótipo (prototipo/index.html): a versão navegável com dados em memória, usada para desenhar cada tela.
| Camada | Tecnologia |
|---|
| Interface | HTML, CSS e JavaScript (módulos), sem framework |
| Banco, login e regras de acesso | Supabase (Postgres, Auth e Row Level Security) |
| Hospedagem | Vercel |
| Rotinas agendadas | Fechamento das 22h e resumo por e-mail às 12h30 e às 17h |
| Integrações previstas | Conta Azul, e-mail (n8n) e WhatsApp; agente de IA em painel lateral |
Pastas
CentralBPO/
├── app/ # o app: telas, estilos e módulos JS
├── api/admin.js # função de servidor (Vercel): criar login e redefinir senha
├── scripts/ # gerar-config (build) e servidor local de teste
├── prototipo/
│ └── index.html # protótipo navegável
├── docs/
│ └── regras-de-negocio.md # todas as regras decididas, fonte da verdade
├── supabase/
│ ├── migrations/ # tabelas, regras (funções) e acesso (RLS + views)
│ ├── agendamentos/ # pg_cron: fechamento das 22h e geração diária
│ ├── testes/rodar.mjs # 79 testes automáticos
│ └── README.md # como aplicar e quais funções o app chama
├── package.json # npm run test:db
├── SECURITY.md # proteções e checklist de instalação
├── .env.example # variáveis de ambiente (sem valores)
├── vercel.json # publica o app, com cabeçalhos de segurança
├── LICENSE
└── README.md
Como usar localmente
App: copie .env.example para .env.local, preencha com o seu Supabase e rode:
npm install
npm run dev
Depois acesse http://127.0.0.1:4173/app/. O servidor local usa os mesmos cabeçalhos de segurança da Vercel e também serve /api/admin.
Protótipo: abra prototipo/index.html no navegador. Para testar os papéis, troque o usuário no rodapé da barra lateral.
Próximos passos
- Revisão geral do protótipo com a equipe
Tabelas no Supabase e regras de acesso por papel ✓ (backend pronto e testado)App ligado ao banco, com login individual ✓ (falta publicar na Vercel)- Rotinas agendadas: fechamento das 22h e resumos por e-mail
- Painel do agente de IA dentro da tela do cliente
Segurança
Como a Central protege os dados e o checklist de instalação estão em SECURITY.md.
Autoria
Projeto idealizado e conduzido por Paulo Renato Nunes de Melo.
Distribuído sob a licença MIT (veja LICENSE).
