Molar Check - Servidor (API)

Backend do Projeto Molar Check

Este é o repositório do back-end para o Molar Check, um sistema dedicado à identificação da Hipomineralização Molar-Incisivo (HMI).

A API foi desenvolvida para servir a aplicação front-end, gerenciando usuários, pacientes, registros, diagnósticos e o armazenamento seguro de imagens.

---

✨ Features

• Autenticação e Autorização:
  • Login social com Google OAuth2.
  • Sistema de papéis (roles) para distinguir responsáveis e especialistas.
• Gerenciamento de Usuários e Pacientes: Endpoints para criar, ler, atualizar e deletar usuários e seus pacientes associados.
• Fluxo de Registros (MIH):
  • Criação de registros de HMI com dados clínicos e observações.
  • Endpoints para especialistas avaliarem e atualizarem registros com um diagnóstico.
• Upload de Imagens Seguro:
  • Gera URLs pré-assinadas para o upload de imagens diretamente para um serviço de object storage (MinIO), evitando sobrecarga no servidor.
  • Associa os IDs das imagens aos registros dos pacientes.

---

🚀 Tecnologias Utilizadas

• FastAPI
• Python 3.12+
• SQLModel para interação com o banco de dados e validação de dados.
• PostgreSQL como banco de dados relacional.
• MinIO para armazenamento de objetos (imagens).
• Docker e Docker Compose para orquestração dos serviços.
• Alembic para migrações de banco de dados.

---

🏁 Começando

Siga estas instruções para rodar o servidor e seus serviços dependentes localmente.

Pré-requisitos

• Docker e Docker Compose
• Python (versão 3.12 ou superior)

1. Configuração do Banco de Dados e Armazenamento

O ambiente utiliza Docker para rodar o PostgreSQL e o MinIO.

1. Na raiz do projeto, crie seu arquivo de ambiente a partir do modelo:

   cp .env-model .env-model

   Preencha as variáveis necessárias (credenciais Google OAuth, SECRET_KEY, etc.).

2. Inicie todos os serviços (API, PostgreSQL e MinIO) com:

   docker-compose up -d

2. Configuração da Aplicação

1. Crie um ambiente virtual e instale as dependências:

   python -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

3. Rodando o Servidor

1. Execute as migrações do banco de dados com o Alembic:

   alembic upgrade head

2. Inicie o servidor FastAPI:

   fastapi dev main.py

A API estará disponível em http://localhost:8000/docs para documentação interativa.

---

🌐 Visão Geral da API

A API é modularizada em diferentes roteadores:

• /auth: Lida com a autenticação (login com Google).
• /users: Gerenciamento de usuários (responsáveis e especialistas).
• /users/patients: Gerenciamento dos pacientes de um usuário.
• /mih: Gerenciamento dos registros de HMI e seus diagnósticos.
• /images: Geração de URLs para upload de imagens.
• /healthz: Health check do servidor.