🏋️ Sistema de Gestão Academia Five Star

Um sistema de gestão full-stack moderno para academias, combinando ferramentas administrativas robustas com uma experiência de aluno gamificada e potencializada por Inteligência Artificial Generativa.

---

🌟 Experiências Integradas

A aplicação oferece duas jornadas totalmente separadas e seguras:

🏠 Painel de Gestão (/dashboard)

• Gestão de Alunos: CRM completo para cadastro, edição e controle de matrículas.
• Controle Financeiro: Monitoramento de inadimplência e status de pagamentos.
• Gerador de Treinos IA: Criação automatizada de planos semanais personalizados usando Google Gemini via Genkit.
• Análise de Dados: Dashboards com indicadores de crescimento e retenção.

🛡️ Portal do Aluno (/aluno)

• Gamificação (Player Experience): Sistema de Nível, XP e Streaks (Ofensivas) para incentivar a consistência.
• Treino do Dia: Interface interativa para execução e conclusão de exercícios.
• Feedback Motivacional: Mensagens customizadas geradas por IA após cada treino finalizado.
• Meus Treinos: Separação entre planos profissionais (do personal) e treinos pessoais criados pelo aluno.

---

🛠️ Stack Tecnológica

Frontend & UI

• Framework: Next.js 15+ (App Router)
• Estilização: Tailwind CSS
• Componentes: Shadcn/UI & Framer Motion
• Icons: Lucide React

Backend & Database

• Auth: Supabase Auth (com suporte a SSR)
• Database: PostgreSQL (hospedado no Supabase)
• ORM: Prisma
• Validação: Zod & React Hook Form

Inteligência Artificial

• Engine: Google Genkit
• Modelos: Gemini (Google AI)

Observabilidade & Performance

• Error Tracking: Sentry (Next.js v15 integration)
• Privacidade: Filtro recursivo de PII (CPF, senhas) no servidor e cliente.
• Monitoring: Túnel de telemetria via /monitoring para evitar bloqueios por ad-blockers.
• Sentinel Engine: Orquestrador de desenvolvimento com IA para planejamento (plan), brainstorming (shout) e geração de código (forge) com governança FPA.

---

🛡️ Sentinel Development Engine (CLI)

O projeto inclui o Sentinel, um sistema operacional de desenvolvimento alimentado por IA que orquestra o ciclo de vida do software:

• npm run sentinel shout: Inicia um brainstorm dialético para novas features.
• npm run sentinel plan: Gera um plano de implementação [PID-SENTINEL] com análise de impacto.
• npm run sentinel forge: Transforma insights em esqueletos de implementação técnica com cálculo automático de Function Points (FPA).
• npm run pre-flight: Portão de qualidade obrigatório (Lint, Format, Types, Tests).

---

🚀 Como Executar o Projeto

Pré-requisitos

• Node.js 20+
• Docker (necessário para o stack E2E local via Supabase CLI)
• npm

1. Configurar Variáveis de Ambiente

Crie um arquivo .env.local na raiz do projeto com as seguintes chaves:

# Banco de Dados (Prisma)
DATABASE_URL="postgresql://user:password@host:port/dbname"
DIRECT_URL="postgresql://user:password@host:port/dbname"

# Supabase (Auth & API)
NEXT_PUBLIC_SUPABASE_URL="sua-url-do-supabase"
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY="sua-chave-publishable"
SUPABASE_SERVICE_ROLE_KEY="sua-chave-service-role"

# Inteligência Artificial
GOOGLE_GENAI_API_KEY="sua-google-ai-key"

# Observabilidade
NEXT_PUBLIC_SENTRY_DSN="sua-dsn-do-sentry"
SENTRY_AUTH_TOKEN="seu-token-sentry"

Consulte .env.example para a lista completa de variáveis.

2. Instalação e Setup

# Instalar dependências
npm install

# Gerar o cliente Prisma
npx prisma generate

# Aplicar migrations
npx prisma migrate deploy

# (Opcional) Popular o banco com dados de desenvolvimento
npm run prisma:seed

3. Rodar o Desenvolvimento

npm run dev

Acesse http://localhost:3001 para ver a aplicação em execução.

4. Quality Gates

npm run typecheck   # TypeScript strict — 0 erros
npm run lint        # ESLint — 0 erros
npm run test        # Vitest — 18/18 testes
npm run e2e         # Playwright — 15/15 cenários (requer Docker + supabase start)

---

📘 Documentação do Projeto

• Documento de Visão
• Documento de User Stories
• Modelo de Dados
• Estado Atual
• Milestones
• Tarefa - ODBC e ORM

---

👨‍🎓 Informações do Aluno (Tarefa)

• Nome: José Inamar de Medeiros Júnior
• Matrícula: 20200018540
• Email: inamarjunior2@gmail.com

---

📖 Governança e Segurança

Para garantir a qualidade e a segurança do projeto, seguimos os seguintes guias:

• Política de Segurança - Como reportar vulnerabilidades e boas práticas.
• Changelog - Histórico detalhado de mudanças e versões.
• Estratégia de Versionamento: Utilizamos SemVer.

---

---

📋 Licença e Repositório

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

Repositório principal: https://github.com/EmiyaKiritsugu3/PWeb_Project

Desenvolvido para fins acadêmicos e profissionais na área de Engenharia de Software.