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. Navegue até o diretório de configuração do banco:

   cd install/dbms/

2. Crie uma cópia do arquivo docker-compose-model.yml e renomeie para docker-compose.yml:

   cp docker-compose-model.yml docker-compose.yml

   Make 2 directories, docker and impexp, and use their path on their respective volumes inside docker-compose.yml.

3. Inicie os contêineres:

   docker-compose up -d

   Isso iniciará o PostgreSQL em background.

2. Configuração da Aplicação

1. Volte para a raiz do projeto e crie um ambiente virtual:

   cd ../..
   python -m venv .venv
   source .venv/bin/activate

2. Instale as dependências do Python:

   pip install -r requirements.txt

3. Crie seu arquivo de ambiente a partir do modelo:

   cp .env-model .env

4. Abra o arquivo .env e preencha todas as variáveis, especialmente as credenciais do Google OAuth (CLIENT_ID, CLIENT_SECRET) e a SECRET_KEY.

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.