Começar · estrutura do sistema
1 · País → mapa → território
O THE MAP foi preparado para vários países e para mapas com números diferentes de segmentos. Nunca dependemos apenas do nome do território.
PT→PT-MUN→PT-MUN-0303
territory_code é a referência operacional; na base real existirá também um UUID interno.
2 · O que significa o estado?
Disponível: pode receber pedido. Stand by: está temporariamente reservado. Ocupado: existe uma presença aprovada e oficial.
Disponível→Stand by→Ocupado
Pedidos · validação · publicação
3 · Quando chega um pedido
O pedido guarda uma cópia do que o utilizador submeteu: empresa, categoria, contactos, descrição, logo/imagem, território, nível, Cor/Tom e dados declarados de pagamento. O pedido e a presença oficial são entidades separadas.
4 · Aprovar não é apenas “mudar estado”
Ao aprovar, o pedido fica registado como aprovado e o território recebe a presença oficial com a empresa, nível, Cor/Tom e eventual império. É esta presença oficial que o mapa público irá consumir.
5 · Stand by automático
Um pedido pendente pode colocar o território em stand by para impedir que seja tratado como livre enquanto aguardas validação ou pagamento manual.
6 · Stand by manual
O Owner pode reservar manualmente um território mesmo sem pedido, indicando motivo e, se quiser, uma data limite. Depois pode libertá-lo sem criar uma presença.
Presença visual · níveis · cores · impérios
7 · Três níveis de destaque
Cada território pode ter Nível 1, 2 ou 3. O nível é um dado comercial; a aparência concreta de cada nível continua a ser decidida pelo mapa visual.
8 · Cor 1/2 e Tom 1/2
A base não grava nomes como azul ou verde. Guarda apenas Cor 1 ou Cor 2 e Tom 1 ou Tom 2. Assim podes mudar a paleta do mapa no futuro sem alterar registos comerciais.
C1 · T1C1 · T2C2 · T1C2 · T2
9 · Impérios
Um império é um aglomerado de vários territórios pertencentes à mesma entidade. Tem um território de origem e uma lista de membros. Cada território do império continua a manter o seu próprio nível, Cor e Tom; “Império” não é um quarto nível de destaque.
Empresas · categorias · imagens
10 · Categoria escolhida pelo utilizador
A categoria submetida fica guardada no pedido. Antes de aprovar, o Owner pode corrigi-la para uma categoria admissível sem perder o valor originalmente submetido no histórico.
11 · Lista de categorias admissíveis
As categorias são definidas no backstage com código estável, nome, âmbito, visibilidade pública e estado ativo. Quando ligarmos ao Supabase, o formulário público irá consultar esta mesma fonte e mostrar apenas categorias ativas e públicas.
12 · Logo e fotografia
A ficha do pedido mostra os ficheiros/imagens fornecidos. Se o utilizador não enviar fotografia — ou se precisares de substituir a apresentação — o Owner pode colar uma URL de imagem. O mesmo princípio pode ser usado para o logo.
13 · Porque preservamos o original?
O pedido funciona como snapshot. Alterar depois a ficha da empresa ou uma imagem não deve reescrever silenciosamente aquilo que foi originalmente submetido e aprovado.
Pagamentos · receitas · histórico
14 · Pagamento inicial é manual
Nesta fase podes validar donativos e pagamentos diretos manualmente. O pedido guarda o meio usado, quantia, moeda e estado. Não existe ainda gateway automático.
15 · Pedido ≠ receita
O pedido regista aquilo que foi solicitado/declarado. A área Receitas regista movimentos efetivamente confirmados. Isto permite corrigir ou adicionar movimentos manualmente sem falsificar o histórico do pedido.
16 · Como são analisadas as receitas?
Os movimentos podem ser resumidos por país, cliente/utilizador, semana e mês. Cada registo deve manter quantia e moeda próprias; moedas diferentes nunca devem ser somadas cegamente.
17 · Correções financeiras
O Owner pode editar um movimento quando necessário, mas a alteração deve gerar audit log: valor anterior, novo valor, utilizador e momento da alteração.
Visitas · domínio · ligação ao mapa
18 · Quem regista os visitantes?
O domínio é apenas o endereço. Uma ferramenta de analytics regista visitas/page views de forma agregada. O backstage apresenta esses dados; visitantes anónimos não precisam de ser transformados em contas ou clientes.
19 · Domínio próprio
Podes comprar o domínio quando quiseres. A arquitetura pode usar o site público em /, o backstage privado em /admin e operações seguras em /api, sem obrigar a reconstruir o mapa.
20 · Quando o mapa visual estiver pronto
O mapa passa a ler do Supabase o estado público através dos códigos territoriais. O SVG, zoom, sombras e restantes efeitos continuam separados desta camada administrativa.
21 · Atualizações futuras
Podemos começar com carregamento normal dos dados. Mais tarde, Realtime pode fazer uma aprovação aparecer no mapa aberto sem refresh. Pagamentos automáticos também podem ser acrescentados depois sem mudar o modelo central.
Entrada e segurança
22 · Como se entra no backstage?
Na versão ligada ao Supabase haverá login obrigatório com utilizador e palavra-passe. Não haverá registo público. Este HTML é uma demonstração local e não deve fingir que uma password guardada no ficheiro seria segurança real.
23 · Quem cria os acessos?
Apenas o Owner. O Owner cria, suspende e define o acesso por país/mapa. As passwords serão tratadas pelo sistema de autenticação e nunca guardadas em texto simples nas tabelas do THE MAP.
Só visível ao Owner
24 · Poderes de cada tipo de utilizador
Esta informação é intencionalmente escondida dos restantes perfis. O objetivo é que cada pessoa veja apenas as ferramentas necessárias ao seu trabalho, sem expor a matriz completa de privilégios.
- Owner: controlo total; gere acessos, categorias, empresas, impérios, receitas, stand by manual, rejeições, configurações e histórico.
- Moderador: pode consultar o trabalho que lhe foi atribuído, aprovar pedidos e alterar apenas Tom 1 ↔ Tom 2 nos territórios autorizados.
- Consulta: visualização apenas; não altera dados.
- Não existe perfil “Admin” intermédio nesta estrutura: os poderes sensíveis permanecem concentrados no Owner.
Dúvidas frequentes
Se eu rejeitar um pedido, o que acontece?
O pedido continua no histórico como rejeitado. Se era o único motivo para o stand by e não existe outra reserva, o território pode voltar a disponível.
E se houver dois pedidos para o mesmo território?
A regra definitiva deverá ser aplicada no Supabase. A opção mais segura para o arranque é o primeiro pedido válido reservar o território até decisão, evitando aprovações concorrentes.
Posso mudar as cores reais mais tarde?
Sim. Cor 1/2 e Tom 1/2 são identificadores abstratos; alterar a paleta no mapa não exige migrar os pedidos ou as presenças existentes.
Um país tem de ter o mesmo número de segmentos?
Não. Cada mapa tem o seu próprio dataset e número de territórios. Portugal pode ter centenas e outro país milhares; a lógica do backstage é a mesma.
Posso substituir uma foto sem upload?
Sim. Usa a URL de substituição na ficha do pedido. Quando houver Storage no Supabase, poderemos também permitir upload administrativo direto.
O sistema já está ligado ao Supabase?
Ainda não. Esta versão finaliza a interface e as regras funcionais. O passo seguinte é reproduzir este modelo em tabelas, autenticação, Storage e políticas de acesso reais.