​

Backend do FitLocus

​

Tecnologias Utilizadas

• Linguagem: Java 21
• Framework: Spring Boot 3.x
• Banco de Dados: PostgreSQL
• ORM: Spring Data JPA / Hibernate
• Autenticação: JWT + Firebase Auth
• Documentação: Swagger / OpenAPI
• Build: Gradle
• Containerização: Docker
• CI/CD: GitHub Actions

​

Estrutura do Projeto

src/main/
├── java/com/fitlocus/backend/
│   ├── config/                 # Configurações (Security, CORS, Firebase)
│   ├── controllers/            # Endpoints da API REST
│   ├── dtos/                   # Data Transfer Objects
│   ├── enums/                  # Enumerações (UserType, SubscriptionType, etc.)
│   ├── exceptions/             # Exceções personalizadas
│   ├── mappers/                # Conversores entre entidades e DTOs
│   ├── models/                 # Entidades JPA
│   ├── repositories/           # Repositórios Spring Data JPA
│   ├── services/               # Lógica de negócio
│   ├── utils/                  # Classes utilitárias
│   └── validators/             # Lógica de validação
├── resources/
│   ├── application.properties  # Configurações da aplicação
│   ├── application-*.properties # Configurações específicas por ambiente
│   ├── db/
│   │   ├── changelog.xml      # Arquivo mestre de migração Liquibase
│   │   └── scripts/           # Scripts SQL para migrações
│   └── key/                    # Chaves de serviço Firebase

​

Principais Controladores

​

Modelos de Dados

• Users: Usuários do sistema (ALUNO ou PERSONAL)
• Exercise: Exercícios físicos com descrição e imagem
• Training: Treinos compostos por exercícios
• TrainingPlan: Planos de treino semanais
• PersonalStudent: Relacionamento entre personal e aluno
• ExerciseExecution: Registro de execução de exercícios
• TrainingExecution: Registro de execução de treinos
• PersonalRecord: Recordes pessoais em exercícios

​

Autenticação e Segurança

1. Login tradicional: Email/senha validados contra o banco de dados
2. Login social: Integração com Firebase Auth para login via Google
3. Autorização: Tokens JWT com claims para controle de acesso
4. Segurança: Filtros de segurança para validação de tokens em cada requisição

​

Armazenamento de Arquivos

1. Desenvolvimento: Armazenamento local no sistema de arquivos
2. Produção: Google Cloud Storage para armazenamento em nuvem

​

Validação de Assinaturas

• SubscriptionValidator: Valida se o usuário pode acessar recursos premium
• AccessValidator: Controla o acesso baseado no tipo de usuário e assinatura

​

Integração com Pagamentos

1. Webhooks: Endpoints para receber notificações de pagamentos
2. PIX: Suporte a pagamentos via PIX
3. Assinaturas: Gerenciamento de ciclos de assinatura

​

Ambiente de Desenvolvimento

# Clone o repositório
git clone https://github.com/logoscti/fitlocus-backend.git

# Entre no diretório
cd fitlocus-backend

# Execute com Gradle
./gradlew bootRun

# Ou com Docker Compose
docker-compose up

​

Endpoints da API