app/
├── controllers/     # Endpoints HTTP (rotas)
├── services/        # Lógica de negócio
├── models/          # Modelos de dados (Pydantic)
├── schemas/         # Validação de entrada/saída
├── dependencies/    # Injeção de dependências (Firebase, Auth)
└── utils/           # Funções auxiliares

{
  "firebase_token": "eyJhbG...",
  "platform": "web" // ou "mobile"
}

{
  "id": str,
  "firebase_uid": str,
  "name": str,
  "email": str,
  "birth_date": datetime,
  "phone_number": str,
  "city": str,
  "state": str,
  "country": str,
  "gender": UserGender,
  "is_active": bool,
  "is_admin": bool
}

{
  "id": str,
  "title": str,
  "description": str,
  "access_code": str,  # Código de inscrição
  "field": str,
  "start_date": datetime,
  "end_date": datetime,
  "type": str,  # Feira, Workshop, etc.
  "status": str,  # ongoing, finished
  "is_active": bool,
  "customization": {
    "primary_color": str,
    "secondary_color": str,
    "tertiary_color": str,
    "font": str,
    "icon_url": str,
    "banner_url": str
  },
  "tasks": List[Task],
  "activities": List[Activity]
}

{
  "id": str,
  "title": str,
  "description": str,
  "task_type": str,  # question, quiz, challenge
  "task_category": str,
  "status": str,
  "score": int,
  "sequence": int,
  "min_char": int,  # Mínimo de caracteres para resposta
  "question": List[Question],  # Para quizzes
  "is_active": bool
}

{
  "id": str,
  "title": str,
  "description": str,
  "type": str,  # Palestra, Workshop, etc.
  "image_url": str,
  "start_at": datetime,
  "end_at": datetime
}

{
  "id": str,  # {user_id}_{task_id}
  "user_id": str,
  "task_id": str,
  "event_id": str,
  "answers": [
    {
      "user_answer": str,
      "is_correct": bool,
      "submission_type": SubmissionType,  # text, image
      "submission_url": str  # URL Firebase Storage
    }
  ],
  "is_validated": bool,
  "score": float
}

{
  "id": str,  # {user_id}_{event_id}
  "user_id": str,
  "event_id": str,
  "total_score": int,  # Pontuação consolidada
  "enrollment_date": datetime
}

{
  "event_id": str,
  "ranks": [
    {
      "position": int,
      "user_id": str,
      "name": str,
      "total_score": int
    }
  ]
}

class UserGender(str, Enum):
    MALE = "male"
    FEMALE = "female"
    OTHER = "other"

class SubmissionType(str, Enum):
    TEXT = "text"
    IMAGE = "image"

# Todos os testes
pytest tests/

# Com cobertura
pytest --cov=app --cov-report=term-missing

# Teste específico
pytest tests/test_user_service.py

# Firebase
FIREBASE_CREDENTIALS_PATH=service-account.json
FIREBASE_STORAGE_BUCKET=your-bucket.appspot.com

# API
DEBUG=true
ALLOWED_ORIGINS=http://localhost:5173,https://taskee.work.gd

# Criar ambiente virtual
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
.venv\Scripts\activate     # Windows

# Instalar dependências
pip install -r requirements.txt

# Iniciar servidor
uvicorn app.main:app --reload

# Build e Run
docker-compose up --build

# Ou manualmente
docker build -t taskee_backend .
docker run -p 8000:8000 taskee_backend

allow_origins=[
    "http://localhost:5173",      # Frontend local
    "https://taskee.work.gd",     # Produção
    "https://www.taskee.work.gd"
]

1. POST /account/signup (cria Firebase Auth)
2. Frontend: signInWithEmailAndPassword()
3. Frontend: getIdToken()
4. POST /firebase-auth/verify (valida e sincroniza)
   → Retorna dados do usuário + valida plataforma

1. GET /events/all (usuário vê eventos disponíveis)
2. POST /user_event/register (inscreve com access_code)
3. GET /user_event/my-registrations (confirma inscrição)

1. GET /tasks/all/{event_id} (lista tarefas)
2. POST /user_tasks/upsert/{tipo}/{user_id}/{event_id}/{task_id}
   → Submete resposta (text/quiz/image)
3. Admin: PUT /user_tasks/evaluate/{user_task_id}
   → Avalia e pontua
4. Atualiza automaticamente total_score no UserEvent
5. GET /ranking/{event_id} (visualiza posição)

1. Usuário completa tarefas → score atualizado em UserEvent
2. GET /ranking/{event_id} → lista ordenada por pontuação
3. GET /ranking/{event_id}/user/{user_id} → posição específica

fastapi              # Framework web
firebase-admin       # Firebase SDK Python
pydantic[email]      # Validação de dados
uvicorn              # ASGI server
pytest               # Framework de testes
pytest-cov           # Cobertura de testes
python-multipart     # Upload de arquivos
httpx                # Cliente HTTP async