Backend do Projeto com FastAPI e PostgreSQL

Este é o backend do projeto desenvolvido em FastAPI com PostgreSQL, Alembic e TimeScaleDB para gestão de dados. Este guia descreve como configurar o ambiente, executar o projeto e começar a desenvolver.

---

Pré-requisitos

Certifica-te de que tem os seguintes itens instalados no seu sistema:

• Python 3.8+
• PostgreSQL
• TimeScaleDB
• Git

---

Como Configurar o Projeto

1. Clone do Repositório

Primeiro, faz clone do repositório para a máquina local.

2. Cria um ambiente Virtual

Cria e ativa um ambiente virtual para gerir as dependencias

python3 -m venv venv
source venv/bin/activate

3. Criar um user e base de dados

Executa:

sudo -u postgres psql

Depois cria o user e a base de dados:

CREATE USER admin WITH PASSWORD '1234';
ALTER USER admin CREATEDB;
CREATE DATABASE lumicheck OWNER admin;
\q

4. Instala as dependências

Com o ambiente virtual ativado, instala as dependências do projeto:

pip install -r requirements.txt

Como executar o projeto

1. Ativa o ambiente virtual

Certifica-te de que o ambiente virtual está ativo:

source venv/bin/activate

2. Executa o Servidor

Para iniciar o servidor, execute:

python3 app/main.py

O servidor estará disponível em http://127.0.0.1:8000.

Documentação da API

• Documentação interativa Swagger UI: http://127.0.0.1:8000/docs
• Alternativa Redoc: http://127.0.0.1:8000/redoc

Estrutura do projeto

 backend/
├── app/
│   ├── __init__.py      
│   ├── models/          
│   ├── routes/         
│   ├── config.py        
│   ├── main.py          
├── .env                 
├── requirements.txt     
├── venv/                

Scripts úteis

Exportar Dependências

Se adicionares novos pacotes, exporta-os para o requirements.txt:

pip freeze > requirements.txt