Sistema de Gestão de Academia (Painel Administrativo)
Plataforma web completa para gestão de academias, permitindo o gerenciamento centralizado de alunos, professores, unidades e controle de acesso com autenticação segura.
Visão Geral:
Aplicação Full Stack (iniciada 2025) desenvolvida para simplificar e automatizar a rotina operacional, financeira e administrativa de academias e estúdios fitness. O projeto possui um ecossistema híbrido e robusto, unindo um núcleo de gestão interno a módulos independentes para acesso público e ações promocionais.
Principais Funcionalidades:
Gestão de Usuários: Controle completo de Professores, Alunos e Responsáveis Legais (CRUD) com formulários guiados em múltiplas etapas (Wizard).
Controle de Múltiplas Unidades: Vínculo estruturado de instrutores e alunos às suas respectivas academias, filiais ou equipes.
Motor Contábil Inteligente: Sistema de precificação dinâmico com cálculo de rateio para planos fechados, identificação de modalidades base/adicionais e aplicação de descontos em cascata (cupons, fidelidade e manual).
Gestão Financeira e Pagamentos: Integração direta com o Mercado Pago via SDK para geração de PIX/Boleto, utilizando Webhooks para baixa automática de faturas, atualização de saldo em caixa e envio de notificações.
Automação de Documentos: Geração automática de comprovantes e recibos em PDF, com envio imediato via e-mail utilizando SMTP próprio.
Módulo de Campanhas (Rifas): Sistema auxiliar completo para gestão de cotas, bloqueios temporários de carrinho (Smart Polling) e sorteios.
Segurança e Acessos: Painel administrativo com controle rigoroso de permissões (RBAC), sessões com tempo de expiração e rotas públicas com recuperação de senhas baseada em tokens.
Stack Tecnológica:
Back-end (Core da Academia): Node.js, Express.js e Sequelize ORM.
Back-end (Serviços Auxiliares e Rifas): PHP 8+ com gerenciamento de dependências via Composer (PHPMailer e MercadoPagoConfig).
Front-end (Painel Administrativo): React.js, JavaScript moderno (ES6+), Hooks customizados e Tailwind CSS para estilização fluida e responsiva.
Front-end (Telas Públicas e Segurança): HTML5, CSS3 e JavaScript Vanilla com manipulação direta de DOM e requisições assíncronas (Fetch API).
Banco de Dados: Relacional (MySQL / PostgreSQL).
Arquitetura: Padrão MVC, consumo de API RESTful, integrações via Webhooks e autenticação segura baseada em Tokens e Hash (Bcrypt).