Gestao Completa da Plataforma

Guia completo do painel de administracao — dashboard com MRR, gestao de clientes, faturacao, produtos, Stripe, integracao fiscal e servicos provisionados.

Passo a Passo

Passo 1. Painel de administracao carregado — o administrador ve o dashboard principal com os cartoes de KPI no topo. Estes cartoes mostram as metricas mais importantes da plataforma: numero total de clientes registados, subscricoes activas, clientes em atraso, MRR (receita mensal recorrente), receita dos ultimos 30 dias e tickets abertos. Esta visao permite ao admin ter uma percepcao imediata da saude do negocio.

Passo 2. O dashboard apresenta 3 elementos de metricas. Cada cartao KPI mostra um valor numerico actual e, ' + 'em alguns casos, a variacao percentual face ao periodo anterior. Os cartoes usam cores distintas para facilitar a leitura rapida — ' + 'verde para valores positivos, vermelho para alertas como subscricoes em atraso.

Passo 3. Seccao de graficos do dashboard — aqui o administrador ve o grafico de receita dos ultimos 6 meses em formato de barras. Este grafico permite acompanhar a evolucao mensal da receita e identificar tendencias de crescimento ou queda. Abaixo do grafico podem aparecer indicadores adicionais como taxa de churn e lifetime value medio.

Passo 4. Parte inferior do dashboard — listas de faturas recentes e subscricoes mais recentes. As faturas mostram o numero, cliente, valor e estado (paga, pendente, vencida). As subscricoes mostram o plano, cliente e estado actual. Esta seccao permite ao admin reagir rapidamente a problemas como pagamentos falhados.

Passo 5. Dashboard completamente carregado ate ao fundo — todas as seccoes estao visiveis. O admin pode clicar em qualquer metrica ou item da lista para navegar directamente para o detalhe correspondente.

Passo 6. Pagina de gestao de clientes — o administrador ve a lista completa de todos os clientes registados na plataforma. A tabela mostra o nome, email, empresa, NIF, estado da conta (activo/suspenso) e a data de registo. No topo existe uma barra de pesquisa para filtrar clientes rapidamente.

Passo 7. A tabela de clientes mostra 20 registos. Cada linha permite acesso rapido ao detalhe do cliente ' + 'com um clique. As colunas sao ordenáveis e a tabela suporta paginacao quando existem muitos clientes.

Passo 8. Pesquisa activa — o admin escreveu "admin" na barra de pesquisa e a tabela foi filtrada automaticamente. A pesquisa funciona em tempo real (debounce) e procura em todos os campos: nome, email, empresa e NIF. Isto permite encontrar rapidamente um cliente especifico mesmo com centenas de registos.

Passo 9. Pesquisa limpa — apos apagar o texto da barra de pesquisa, a tabela volta a mostrar todos os clientes. O admin pode alternar entre pesquisa filtrada e vista completa a qualquer momento.

Passo 10. Lista de clientes com scroll — se existem mais clientes do que cabem no ecra, o admin pode fazer scroll ou usar paginacao. No fundo da tabela pode haver botoes de navegacao entre paginas.

Passo 11. Pagina de detalhe do cliente — apos clicar num cliente da lista, o admin ve toda a informacao pessoal: nome completo, email, telefone, empresa e NIF. Esta seccao permite ao admin confirmar os dados do cliente e verificar se o registo esta completo para emissao de faturas.

Passo 12. Seccao de morada do cliente — inclui a rua, codigo postal, cidade e pais. Estes dados sao essenciais para a faturacao fiscal via Moloni e para o cumprimento legal do SAF-T. Se a morada estiver incompleta, o sistema alerta o admin.

Passo 13. Informacoes da conta — o admin ve o Stripe Customer ID (cus_xxx), a data de registo, o ultimo login e o estado da conta. O Stripe ID permite correlacionar o cliente com a conta no painel Stripe.

Passo 14. Seccao de integracao fiscal — mostra se o cliente esta sincronizado com o Moloni, o seu Moloni Customer ID e o estado da ultima sincronizacao (synced/pending/failed). Aqui o admin pode forcar uma re-sincronizacao se necessario.

Passo 15. Seccao Stripe Connect — se o cliente tem uma conta Connect associada, aqui aparece o estado do onboarding, o account ID e os detalhes de verificacao. Para clientes sem Connect, esta seccao mostra "Nao configurado". O admin pode ver toda a informacao do cliente numa unica pagina sem necessidade de ir ao Stripe Dashboard.

Passo 16. Detalhe do cliente antes da edicao — o admin esta na pagina de detalhe e vai clicar no botao "Editar" para modificar os dados do cliente. Os campos estao actualmente em modo de leitura.

Passo 17. Pagina de detalhe do cliente — a edicao pode ser feita directamente nos campos ou atraves de um formulario dedicado. Alguns campos podem nao ser editaveis (como o Stripe Customer ID que e gerado automaticamente).

Passo 18. Vista de edicao do cliente com scroll — campos adicionais podem estar visiveis mais abaixo na pagina.

Passo 19. Secao de dados editaveis do cliente documentada — o admin pode actualizar qualquer campo de informacao pessoal e fiscal.

Passo 20. Detalhe do cliente — o admin esta na pagina de detalhe e vai verificar as accoes de gestao de estado. Os botoes de "Suspender" e "Activar" permitem controlar o acesso do cliente a plataforma.

Passo 21. Estado do cliente identificado: nao visivel nesta posicao. Os botoes de gestao de estado podem estar noutra seccao da pagina ou requerer scroll adicional.

Passo 22. Pagina do cliente com scroll completo — todas as accoes de gestao (editar, suspender, eliminar) estao documentadas. O admin tem controlo total sobre o ciclo de vida de cada cliente.

Passo 23. Indicadores de estado do cliente — 0 badges/indicadores visiveis na pagina. Os badges usam cores para comunicar o estado: verde para activo, vermelho para suspenso, amarelo para pendente e cinza para inactivo.

Passo 24. Pagina de faturacao do admin — modulo central de gestao financeira da plataforma. Apresenta 3 separadores principais: Subscricoes, Faturas e Pagamentos. Esta pagina permite ao admin ter uma visao completa de toda a actividade financeira.

Passo 25. Separadores identificados: Home, Products, Pricing, Contact, Dashboard, Clients, Products, Billing, Stripe, Fiscal Invoicing, Services, Support, Reports, Settings, Dashboard, Clients, Products, Billing, Support. Cada separador mostra uma vista diferente dos dados financeiros, permitindo ao admin alternar rapidamente entre tipos de informacao.

Passo 26. Separador "Subscricoes" activo — mostra a lista de todas as subscricoes da plataforma. Cada subscricao indica o cliente, plano contratado, valor mensal, data de inicio e estado. Os estados possiveis sao: active (verde), past_due (amarelo), canceled (vermelho) e trialing (azul). O admin pode filtrar por estado e exportar os dados.

Passo 27. Separador "Faturas" activo — lista todas as faturas emitidas pela plataforma. Cada fatura mostra o numero (INV-xxx ou FT-xxx), cliente, valor, data de emissao e estado de pagamento. As faturas podem estar pagas (paid), pendentes (open), vencidas (overdue) ou canceladas (void). Faturas com integracao Moloni mostram tambem o numero SAF-T correspondente.

Passo 28. Separador "Pagamentos" activo — registo de todos os pagamentos recebidos na plataforma. Cada pagamento mostra o montante, metodo (Stripe/cartao), data, fatura associada e estado. O admin pode verificar se todos os pagamentos foram processados correctamente e identificar pagamentos falhados que necessitam de accao.

Passo 29. Dados adicionais de faturacao com scroll — o admin pode ver mais registos a medida que faz scroll. A paginacao permite navegar por grandes volumes de dados financeiros sem perda de performance.

Passo 30. Pagina de gestao de produtos — o admin ve o catalogo completo da plataforma com os 2 produtos SaaS: Booking System (sistema de reservas) e Virtual Store System (loja online). Cada produto e apresentado como um cartao com o nome, descricao curta e numero de planos associados.

Passo 31. Produtos identificados — Booking System: presente, Virtual Store: presente. Os produtos sao a base da oferta comercial da plataforma. Cada produto pode ter multiplos planos com precos e funcionalidades diferentes.

Passo 32. Planos visiveis — 0 tiers encontrados: a carregar. Cada produto tem 4 planos: Starter (basico com subdominio partilhado), Business (popular, melhor relacao qualidade/preco), Professional (dominio proprio + VPS) e Enterprise (recursos dedicados e suporte prioritario). Os precos variam: Starter 24.90, Business 49.90, Professional 89.90, Enterprise 149.90 por mes.

Passo 33. Detalhes dos planos com scroll — cada plano mostra o preco mensal e anual, as funcionalidades incluidas, os addons disponiveis (dominio proprio, VPS dedicado, backup extra) e os limites de recursos. O plano basico inclui subdominio partilhado, enquanto os planos premium incluem dominio proprio.

Passo 34. Pagina de produtos com scroll completo — todos os produtos e planos estao documentados. O admin pode gerir o catalogo directamente a partir desta pagina.

Passo 35. Modulo Stripe — pagina dedicada a integracao com o Stripe, o processador de pagamentos da plataforma. No topo aparecem 4 cartoes KPI: numero total de subscricoes activas no Stripe, receita total processada, contas Connect activas e numero de clientes Stripe. Estes dados sao obtidos directamente da API do Stripe.

Passo 36. Cartoes KPI do Stripe — 2 metricas visiveis. Os valores sao actualizados em tempo real a cada carregamento da pagina. O MRR (Monthly Recurring Revenue) e a metrica mais importante para avaliar a saude financeira do negocio SaaS.

Passo 37. Distribuicao de subscricoes por estado — badges coloridos mostram quantas subscricoes estao activas (active), em periodo de teste (trialing), com pagamento em atraso (past_due) e canceladas (canceled). O admin pode identificar rapidamente se ha subscricoes em risco que necessitam de atencao.

Passo 38. Tabela de pagamentos recentes do Stripe — lista os ultimos pagamentos processados com valor, data, cliente e estado (succeeded, failed, pending). Esta tabela permite ao admin monitorizar os pagamentos em tempo real e detectar falhas rapidamente.

Passo 39. Seccao Stripe Connect — mostra as contas Connect dos clientes que usam a funcionalidade de marketplace. Cada conta mostra o estado do onboarding (complete, restricted, pending), o pais e a data de criacao. O admin pode ver o detalhe de cada conta e resolver problemas de verificacao.

Passo 40. Pagina de gestao fiscal — modulo de integracao com sistemas de faturacao certificados. A plataforma esta integrada com o Moloni para emissao automatica de faturas em conformidade com o SAF-T portugues. O badge "Moloni" indica o estado da ligacao: conectado (verde) ou desconectado (vermelho).

Passo 41. Integracoes disponiveis — Moloni: presente na pagina. O Moloni e o sistema de faturacao oficial usado pela plataforma para emitir faturas, recibos e notas de credito. A integracao e automatica: quando um pagamento e confirmado no Stripe, a fatura Moloni e emitida automaticamente.

Passo 42. Tabela de clientes com configuracao fiscal — mostra todos os clientes e o seu estado de sincronizacao com o Moloni. Cada linha indica: nome do cliente, NIF, Moloni Customer ID e estado (synced/pending/failed). Clientes sem NIF aparecem com alerta porque nao e possivel emitir faturas sem numero fiscal.

Passo 43. Contadores de sincronizacao — o admin ve um resumo do estado de sincronizacao fiscal: quantos clientes estao sincronizados (synced), quantos estao pendentes (pending) e quantos falharam (failed). Os clientes com falha de sincronizacao necessitam de atencao manual — normalmente o problema e um NIF invalido ou dados de morada incompletos.

Passo 44. Pagina fiscal com scroll completo — toda a informacao de integracao fiscal esta documentada. O admin tem visibilidade total sobre o estado de faturacao de cada cliente.

Passo 45. Pagina de gestao de servicos — o admin ve todos os servicos provisionados na plataforma. Cada servico corresponde a uma instancia de produto atribuida a um cliente: um Booking System, uma Loja Online, etc. A tabela mostra o nome do servico, cliente associado, tipo de produto, estado e data de criacao.

Passo 46. Tabela de servicos com 10 registos. Cada servico tem um estado de provisioning: ' + 'active (o servico esta funcional), provisioning (em processo de criacao), ' + 'suspended (suspenso por falta de pagamento) e terminated (cancelado definitivamente).

Passo 47. Detalhe do servico — o admin ve os registos de provisioning, incluindo cada passo executado: criacao do tenant, configuracao DNS, setup do VPS (se aplicavel) e activacao do servico. Cada passo mostra o timestamp e o resultado (success/failed).

Passo 48. Metadata do servico — informacao tecnica como o URL externo do servico, o ID do tenant no sistema de booking/loja, configuracao DNS e identificadores internos. O admin pode usar esta informacao para debugging ou para comunicar ao cliente.

Passo 49. Pagina de servicos com scroll completo — toda a informacao de provisioning esta acessivel. O admin pode monitorizar o estado de cada servico e intervir manualmente se necessario, por exemplo re-provisionar um servico que falhou ou suspender um servico por abuso.

Passo 50. Dashboard do admin com sidebar visivel — a barra lateral de navegacao e o menu principal do painel de administracao. Contem links para todas as seccoes: Dashboard, Clientes, Faturacao, Produtos, Stripe, Fiscal, Servicos e Tickets. A sidebar e fixa no desktop e recolhivel em tablet/mobile.

Passo 51. Navegacao para Clientes via sidebar — o admin clicou em "Clientes" na barra lateral e foi redirecionado para a lista de clientes. O item activo na sidebar fica destacado visualmente (cor diferente ou sublinhado).

Passo 52. Navegacao para Faturacao via sidebar — o admin esta agora na pagina de faturacao. A sidebar permite navegar entre modulos sem perder contexto. Cada modulo carrega independentemente e mantem o estado da sessao.

Passo 53. Navegacao para Stripe via sidebar — o modulo Stripe mostra os dados financeiros directos do processador de pagamentos. A navegacao pela sidebar e fluida e consistente em todas as paginas do painel admin.

Passo 54. Regresso ao Dashboard — o admin voltou ao painel principal. A navegacao completa pela sidebar esta funcional: Dashboard -> Clientes -> Faturacao -> Stripe -> Dashboard. Todas as transicoes sao rapidas e sem erros. O admin pode aceder a qualquer modulo da plataforma com um unico clique na sidebar.

Passo 55. Lista de clientes — o admin vai criar um novo cliente manualmente. Normalmente os clientes registam-se pelo site publico, mas o admin pode criar contas directamente para clientes que contactam por telefone ou email.

Passo 56. Formulario de criacao de cliente — o admin ve os campos necessarios para registar um novo cliente: nome, email, telefone, empresa, NIF, morada completa e password inicial. Os campos marcados com asterisco sao obrigatorios.

Passo 57. O formulario tem 11 campos. O email e o campo mais critico porque sera usado para login. O NIF e essencial para a emissao de faturas via Moloni. Ao submeter, o sistema cria automaticamente o cliente no Stripe e inicia a sincronizacao com o Moloni.

Passo 58. Campos adicionais do formulario de criacao — morada, codigo postal, cidade, pais e notas internas. O campo de notas permite ao admin adicionar informacao relevante sobre o cliente que nao e visivel no portal.

Passo 59. Dashboard em modo desktop (1280x900) — o layout adapta-se automaticamente ao tamanho do ecra. Em mobile, os KPI cards empilham verticalmente e a sidebar transforma-se num menu hamburger ou bottom navigation. Em tablet, o layout usa 2 colunas. Em desktop, a sidebar fica fixa a esquerda.

Passo 60. Lista de clientes em modo desktop — a tabela adapta-se mostrando menos colunas em ecras pequenos. Em mobile, apenas o nome e email sao visiveis, com os outros dados acessiveis ao clicar no cliente. A pesquisa mantem-se funcional em todos os tamanhos de ecra.

Passo 61. Pagina de faturacao em modo desktop — os separadores (tabs) adaptam-se ao espaco disponivel. Em mobile, os tabs podem tornar-se scrollaveis horizontalmente ou transformar-se num dropdown. As tabelas de dados mantêm a scrollabilidade horizontal quando necessario.

Passo 62. Catalogo de produtos em modo desktop — os cartoes de produto reorganizam-se em grelha responsiva. Em mobile, os produtos aparecem em coluna unica. Em tablet, em grelha de 2. Em desktop, em grelha de 3 ou mais. Todos os elementos interactivos mantem o tamanho minimo de toque (44x44px) para acessibilidade.

** Modulo Stripe em modo desktop — os KPI cards e a tabela de pagamentos adaptam-se ao ecra. A experiencia de administracao e completa em qualquer dispositivo, permitindo ao admin gerir a plataforma a partir de um telefone ou tablet quando necessario.**