A arquitetura mudou de dados soltos para um modelo 100% relacional em SQL (MySQL/MariaDB). Isso garante enorme integridade através de Chaves Estrangeiras (Foreign Keys) e deleções em cascata. O sistema não permite dados órfãos.

• Limpeza Residual de Storage: O sistema possui uma inteligência sustentável. Quando você altera sua foto de perfil via MP4/Base64 ou deleta referências de Post-its, a rotina dispara a função unlink() varrendo o disco da hospedagem (/uploads/) e purgando mídias órfãs automaticamente, garantindo que o HD do servidor não lote ao longo dos anos.
• Prevenção Anti-Injeção e Tipagem Rígida: Com a restrição imposta no PHP 8, todos os dados vazios (como "null" em títulos de música ou checkboxes soltas) são absorvidos inteligentemente usando o protetor de chave nula (`??`). Além disso, 100% das inserções no banco de dados usam instruções preparadas PDO ($pdo->prepare() e execute([])). É literalmente impossível ocorrer os clássicos ataques de SQL Injection no sistema.
• Storage Quota e Compressão GD: Para evitar a exaustão do HD do servidor, um middleware global intercepta uploads físicos validando os limites definidos pelo usuário Master. Imagens brutas submetidas são automaticamente interceptadas pela lib GD do PHP, redimensionadas e convertidas para o formato WebP (compressão de 75%), o que reduz o tamanho dos arquivos em até 90% antes mesmo de tocar o disco.
• Backup de Soberania (ACID Transactions): Para garantir a integridade total do banco relacional em caso de restaurações completas, a função de Backup (presente em `perfil.php`) compila absolutamente todas as tabelas atreladas ao seu ID de usuário em um arquivo universal JSON. Se você precisar restaurar isso no futuro, o código "tranca" o banco ativando uma Transação ACID ($pdo->beginTransaction()). Se der qualquer problema no meio da restauração, ele cancela (Rollback) e devolve a versão antiga intacta sem corromper sua conta!
• Proteção CSRF & Isolamento: Implementação nativa de Tokens CSRF ($_SESSION['csrf_token']) nos formulários críticos, como a alteração de Perfil e Senha, protegendo o sistema contra falsificação de requisições. Credenciais do banco foram isoladas no arquivo config.php e o diretório de arquivos (/uploads/) protegido com políticas .htaccess contra RCE.

Em vez de compilar o aplicativo para lojas pesadas como a Google Play ou App Store (o que traria dores de cabeça com atualizações), o V-CARD PRO foi construído na arquitetura PWA (Progressive Web App).

• Possui um arquivo manifest.json configurado para informar aos smartphones e desktops de que trata-se de um aplicativo de interface nativa colorizada (Standalone).
• Possui um "Trabalhador de Fundo", o script sw.js (Service Worker) que instala regras de cache na máquina do usuário.
• Em todas as páginas o sistema escuta o evento global em JS beforeinstallprompt, exibindo o botão Instalar App organicamente na barra superior.

O V-CARD PRO foi arquitetado para ser extremamente leve (Low-Bloatware), capaz de rodar desde hospedagens compartilhadas básicas até clusters dedicados em nuvem. Abaixo estão as especificações para garantir a estabilidade do sistema.

Abaixo está o mapeamento detalhado da estrutura de diretórios e arquivos que compõem o ecossistema V-CARD PRO, divididos por responsabilidade arquitetural e lógica de negócios.

/sistema
│── uploads/                 # Diretório de mídias, anexos e fotos de perfil (auto-gerado)
│── index.php                # Landing Page do sistema (Apresentação pública)
│── dashboard.php            # Centro de Comando e Dashboard com IA
│── cartao.php               # Frontend Público (A vitrine / V-CARD do usuário)
│── conexao.php              # Configuração do PDO e função de otimização de imagens (WebP)
│── config.php               # Credenciais de banco de dados (DB_HOST, DB_USER, etc.)
│── banco.sql                # Estrutura de tabelas e injeção de dados do usuário Demo
│── sidebar.php              # Componente de navegação lateral (UI e Lógica do Menu)
│── ajax_pesquisa.php        # Endpoint de busca global unificada (Ctrl+K)
│── manifest.json / sw.js    # Arquivos de configuração do PWA (Progressive Web App)
│
├── [Autenticação & Acesso]
│   ├── login.php / cadastro.php # Telas de acesso e registro de novos usuários
│   ├── processa_login.php       # Validação de credenciais e criação de sessão
│   ├── logout.php               # Destruição de sessão segura
│   └── recuperar/redefinir.php  # Fluxo de envio e reset de senha via Token
│
├── [Módulos do Painel (Views & Controllers)]
│   ├── admin.php            # Gerenciador de Links e Árvore (Link in Bio)
│   ├── perfil.php           # Configurações da conta, IA (API Key), Backup e Tema
│   ├── redes.php            # Gerenciador de redes sociais fixas e customizadas
│   ├── financeiro.php       # ERP: Transações, planos de conta, orçamentos e investimentos
│   ├── veiculos.php         # Frota: Abastecimentos, cálculo de km/L e timeline de manutenção
│   ├── projetos.php         # Kanban board de alta densidade guiado por Drag-and-Drop
│   ├── calendario.php       # Calendário de eventos e integração de feriados (BrasilAPI)
│   ├── cifras.php           # Gerenciador de repertórios e transposição de acordes
│   ├── palco.php            # Modo Palco (Autoscroll, transposição em tempo real)
│   ├── canva.php            # Editor vetorial avançado e diagramas (Studio Canva)
│   ├── postits.php          # Mural de anotações rápidas com suporte a clipboard
│   ├── emergencia.php       # Perfil médico, dependentes e botão de pânico via GPS
│   ├── ged.php              # Gestor de Arquivos nativo (AjaXplorer)
│   └── auditoria.php        # Painel Master: Visão de usuários, storage e permissões
│
└── [Lógicas de Backend (Action Scripts)]
    ├── colab_action.php       # Motor de Colaboração e troca de Workspaces na Sessão
    └── salvar_*.php / excluir_*.php / mover_*.php # Processamento independente de ações isoladas

Bibliotecas e Assets Externos (CDN)

• Tailwind CSS v4 (Browser CDN)

  Framework utilitário carregado diretamente no navegador via @tailwindcss/browser@4, eliminando a necessidade de processos de build e permitindo estilo JIT (Just-in-Time).

• Font Awesome 6.4.0

  Biblioteca de ícones vetoriais embutida via CDN para toda a simbologia visual do painel, menus e V-CARD público.

• LocalForage / Cache

  Motores de cache local para acelerar carregamento da interface e salvar configurações entre sessões offline.

• SortableJS

  Script que orquestra o Kanban gerenciando a lógica de Drag-and-Drop multidirecional das tarefas e colunas, permitindo atualizações de status em tempo real via AJAX.

• Cropper.js & EasyMDE / Marked.js

  Ferramentas de conteúdo visual. O Cropper ajusta perfis de usuário circularmente, e a dupla EasyMDE/Marked fornece a interface rica para criar e renderizar documentos Markdown no sistema.

• Panzoom.js

  Biblioteca minúscula e de altíssima performance para controle livre de Zoom e Pan via mouse/touch, que atua como o motor de câmera do Canvas Infinito.

O antigo sistema baseado no Markmap foi substituído pelo Fabric.js, transformando a tela do usuário em um Canvas HTML5 de alta performance com suporte a renderização JSON bidirecional.