> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fitlocus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> Bem-vindo à documentação oficial do FitLocus

<img className="block dark:hidden" src="https://mintcdn.com/fitlocus/8vqpgIEUvCBOkGCP/logo/light.svg?fit=max&auto=format&n=8vqpgIEUvCBOkGCP&q=85&s=997497394808bf8d6c3dbc419a94d6d0" alt="Logo FitLocus Light" width="1920" height="1080" data-path="logo/light.svg" />

<img className="hidden dark:block" src="https://mintcdn.com/fitlocus/8vqpgIEUvCBOkGCP/logo/dark.svg?fit=max&auto=format&n=8vqpgIEUvCBOkGCP&q=85&s=316d7bec037c7ebd6c4d02e4c6d31f08" alt="Logo FitLocus Dark" width="1920" height="1080" data-path="logo/dark.svg" />

# FitLocus

O **FitLocus** é a nova forma de pensar corpo, saúde e rotina. Criado para quem treina sozinho ou com o acompanhamento de um personal, ele reúne planos de treino, IA, histórico de progresso, agendamentos, notificações e cobrança automática – tudo em um só lugar.

## Visão Geral

O FitLocus é uma plataforma completa que conecta profissionais de educação física (Personal Trainers) e alunos, oferecendo funcionalidades específicas para cada tipo de usuário:

### Para Personal Trainers

* Gerenciamento de alunos
* Criação de exercícios personalizados
* Montagem de treinos e planos de treino
* Acompanhamento de progresso dos alunos
* Relatórios e análises de desempenho
* Planos de assinatura baseados na quantidade de alunos

### Para Alunos

* Acesso a treinos personalizados
* Execução e registro de treinos
* Acompanhamento de progresso
* Métricas de saúde (hidratação, passos, sono)
* Recordes pessoais em exercícios

## Comece agora

Configure o projeto localmente e entenda sua arquitetura técnica.

<CardGroup cols={2}>
  <Card title="Guia Rápido" icon="rocket" href="/quickstart">
    Aprenda a instalar o backend e o frontend localmente em poucos passos.
  </Card>

  <Card title="Ambiente de Desenvolvimento" icon="laptop-code" href="/development">
    Veja como configurar o projeto e contribuir com o código.
  </Card>
</CardGroup>

## Documentação técnica

Explore os recursos disponíveis no FitLocus e como utilizá-los.

<CardGroup cols={2}>
  <Card title="API de Autenticação" icon="key" href="/api-reference/authentication">
    Endpoints para login, registro, Firebase Auth e JWT.
  </Card>

  <Card title="Integração com Pagamentos" icon="credit-card" href="/api-reference/payments/overview">
    Webhooks e cobranças via PIX com o AbacatePay.
  </Card>

  <Card title="Planos e Assinaturas" icon="dumbbell" href="/business/subscription-model">
    Lógica de planos freemium, premium mensal, semestral e anual.
  </Card>

  <Card title="Infraestrutura do Projeto" icon="server" href="/architecture/overview">
    Arquitetura com GCP, Cloud Run, banco PostgreSQL e CI/CD automatizado.
  </Card>
</CardGroup>

## Arquitetura do Projeto

O FitLocus é composto por três projetos principais:

1. **Backend (Java/Spring Boot)**: API RESTful que gerencia toda a lógica de negócio, autenticação, e persistência de dados.
2. **App Frontend (React Native/Capacitor)**: Aplicativo móvel para iOS e Android que oferece a experiência principal para usuários.
3. **Landing Page (Next.js)**: Site institucional e portal de entrada para novos usuários, com fluxos de cadastro e assinatura.

## Identidade e Design

A estética do FitLocus é minimalista, moderna e funcional.

<CardGroup cols={2}>
  <Card title="Identidade Visual" icon="palette" href="/design/brand-guidelines">
    Saiba mais sobre as fontes, cores e propósito visual do projeto.
  </Card>

  <Card title="Componentes UI" icon="screwdriver-wrench" href="/design/components">
    Biblioteca de componentes visuais utilizados no projeto.
  </Card>
</CardGroup>