api-doacao-sangue 1.0.1__tar.gz

api_doacao_sangue-1.0.1/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: api-doacao-sangue
+Version: 1.0.1
+Summary: API aberta para integração e padronização de dados sobre doação de sangue no Brasil.
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: APScheduler<4,>=3.10
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: fastapi>=0.115
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: requests>=2.31
+Requires-Dist: selenium>=4.20
+Requires-Dist: SQLAlchemy>=2.0
+Requires-Dist: uvicorn[standard]>=0.30
+
+# API Aberta de Doação de Sangue
+
+API REST para integração, padronização e disponibilização de dados públicos sobre doação de sangue no Brasil.
+
+## Instalação como pacote Python
+
+Requer Python 3.10 ou superior.
+
+```bash
+python -m venv .venv
+```
+
+Ative o ambiente virtual:
+
+- Windows: `.venv\\Scripts\\activate`
+- Linux/macOS: `source .venv/bin/activate`
+
+Instale diretamente do diretório do projeto:
+
+```bash
+python -m pip install .
+```
+
+## Execução
+
+Depois da instalação, inicie a API com:
+
+```bash
+api-doacao-sangue
+```
+
+Alternativamente:
+
+```bash
+python -m api_doacao_sangue
+```
+
+A API ficará disponível localmente em `http://127.0.0.1:8000`.
+
+- Documentação Swagger: `http://127.0.0.1:8000/docs`
+- Documentação ReDoc: `http://127.0.0.1:8000/redoc`
+
+Para desenvolvimento, também é possível executar:
+
+```bash
+uvicorn api_doacao_sangue.main:app --reload
+```
+
+## Banco de dados
+
+Por padrão, o SQLite cria o arquivo `api_doacao_sangue.db` no diretório de execução. Para configurar outro banco compatível com SQLAlchemy, defina a variável de ambiente `DATABASE_URL`.
+
+Exemplo no PowerShell:
+
+```powershell
+$env:DATABASE_URL="sqlite:///./meu_banco.db"
+```
+
+Exemplo no Linux/macOS:
+
+```bash
+export DATABASE_URL="sqlite:///./meu_banco.db"
+```
+
+## Funcionalidades
+
+- CRUD de hemocentros, estoques, campanhas e fontes de dados
+- Consulta de compatibilidade sanguínea
+- Integrações com Hemominas (MG), HEMOSC (SC), HEMEPAR (PR), HEMOES (ES), HEMOCE (CE), HEMOPA (PA), HEMOBA (BA) e HEMOSUL (MS)
+- Consulta nacional de estoques
+- Atualização agendada para as integrações configuradas no scheduler
+
+## Observações
+
+- A instalação do pacote não hospeda a API na internet. Ela executa o servidor no computador ou ambiente do próprio usuário.
+- A coleta da Hemominas utiliza Selenium; para essa integração, também é necessário ter um navegador compatível e seu WebDriver configurados no ambiente.
+- O scheduler atual está configurado para executar atualizações de Hemominas, HEMOSC e HEMEPAR.
+- O projeto utiliza SQLite por padrão. Cada instalação mantém seu próprio banco local, salvo configuração diferente por `DATABASE_URL`.
+
+## Tecnologias
+
+Python, FastAPI, SQLAlchemy, SQLite, APScheduler, Requests, BeautifulSoup e Selenium.

api_doacao_sangue-1.0.1/README.md

@@ -0,0 +1,82 @@
+# API Aberta de Doação de Sangue
+
+API REST para integração, padronização e disponibilização de dados públicos sobre doação de sangue no Brasil.
+
+## Instalação como pacote Python
+
+Requer Python 3.10 ou superior.
+
+```bash
+python -m venv .venv
+```
+
+Ative o ambiente virtual:
+
+- Windows: `.venv\\Scripts\\activate`
+- Linux/macOS: `source .venv/bin/activate`
+
+Instale diretamente do diretório do projeto:
+
+```bash
+python -m pip install .
+```
+
+## Execução
+
+Depois da instalação, inicie a API com:
+
+```bash
+api-doacao-sangue
+```
+
+Alternativamente:
+
+```bash
+python -m api_doacao_sangue
+```
+
+A API ficará disponível localmente em `http://127.0.0.1:8000`.
+
+- Documentação Swagger: `http://127.0.0.1:8000/docs`
+- Documentação ReDoc: `http://127.0.0.1:8000/redoc`
+
+Para desenvolvimento, também é possível executar:
+
+```bash
+uvicorn api_doacao_sangue.main:app --reload
+```
+
+## Banco de dados
+
+Por padrão, o SQLite cria o arquivo `api_doacao_sangue.db` no diretório de execução. Para configurar outro banco compatível com SQLAlchemy, defina a variável de ambiente `DATABASE_URL`.
+
+Exemplo no PowerShell:
+
+```powershell
+$env:DATABASE_URL="sqlite:///./meu_banco.db"
+```
+
+Exemplo no Linux/macOS:
+
+```bash
+export DATABASE_URL="sqlite:///./meu_banco.db"
+```
+
+## Funcionalidades
+
+- CRUD de hemocentros, estoques, campanhas e fontes de dados
+- Consulta de compatibilidade sanguínea
+- Integrações com Hemominas (MG), HEMOSC (SC), HEMEPAR (PR), HEMOES (ES), HEMOCE (CE), HEMOPA (PA), HEMOBA (BA) e HEMOSUL (MS)
+- Consulta nacional de estoques
+- Atualização agendada para as integrações configuradas no scheduler
+
+## Observações
+
+- A instalação do pacote não hospeda a API na internet. Ela executa o servidor no computador ou ambiente do próprio usuário.
+- A coleta da Hemominas utiliza Selenium; para essa integração, também é necessário ter um navegador compatível e seu WebDriver configurados no ambiente.
+- O scheduler atual está configurado para executar atualizações de Hemominas, HEMOSC e HEMEPAR.
+- O projeto utiliza SQLite por padrão. Cada instalação mantém seu próprio banco local, salvo configuração diferente por `DATABASE_URL`.
+
+## Tecnologias
+
+Python, FastAPI, SQLAlchemy, SQLite, APScheduler, Requests, BeautifulSoup e Selenium.

api_doacao_sangue-1.0.1/api_doacao_sangue/__main__.py

@@ -0,0 +1,4 @@
+from api_doacao_sangue.cli import main
+
+if __name__ == "__main__":
+    main()

api_doacao_sangue-1.0.1/api_doacao_sangue/cli.py

@@ -0,0 +1,6 @@
+import uvicorn
+
+
+def main():
+    """Inicia a API localmente."""
+    uvicorn.run("api_doacao_sangue.main:app", host="127.0.0.1", port=8000)

api_doacao_sangue-1.0.1/api_doacao_sangue/config.py

@@ -0,0 +1,6 @@
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+DATABASE_URL = os.getenv("DATABASE_URL", "sqlite:///./api_doacao_sangue.db")

api_doacao_sangue-1.0.1/api_doacao_sangue/database.py

@@ -0,0 +1,22 @@
+from sqlalchemy import create_engine
+from sqlalchemy.orm import sessionmaker
+
+from api_doacao_sangue.config import DATABASE_URL
+
+connect_args = {"check_same_thread": False} if DATABASE_URL.startswith("sqlite") else {}
+
+engine = create_engine(DATABASE_URL, connect_args=connect_args)
+
+SessionLocal = sessionmaker(
+    autocommit=False,
+    autoflush=False,
+    bind=engine
+)
+
+
+def get_db():
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()

api_doacao_sangue-1.0.1/api_doacao_sangue/main.py

@@ -0,0 +1,34 @@
+from fastapi import FastAPI
+from api_doacao_sangue.database import engine
+from api_doacao_sangue.models import Base
+from api_doacao_sangue.scheduler import iniciar_scheduler
+
+from api_doacao_sangue.routes import hemocentros, estoques, campanhas, compatibilidade, cidades, fontes, integracoes
+
+Base.metadata.create_all(bind=engine)
+
+app = FastAPI(
+    title="API Aberta de Doação de Sangue",
+    description="API para integração, padronização e disponibilização de dados sobre doação de sangue.",
+    version="1.0.0"
+)
+
+@app.on_event("startup")
+def startup_event():
+    iniciar_scheduler()
+
+app.include_router(fontes.router)
+app.include_router(integracoes.router)
+app.include_router(hemocentros.router)
+app.include_router(estoques.router)
+app.include_router(campanhas.router)
+app.include_router(compatibilidade.router)
+app.include_router(cidades.router)
+
+
+@app.get("/")
+def home():
+    return {
+        "mensagem": "API Doação de Sangue funcionando!",
+        "documentacao": "/docs"
+    }

api_doacao_sangue-1.0.1/api_doacao_sangue/models.py

@@ -0,0 +1,63 @@
+from sqlalchemy.orm import DeclarativeBase
+from sqlalchemy import (
+    Column,
+    Integer,
+    String,
+    Float,
+    ForeignKey,
+    DateTime,
+    Boolean,
+)
+from datetime import datetime
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class Hemocentro(Base):
+    __tablename__ = "hemocentros"
+
+    id = Column(Integer, primary_key=True, index=True)
+    nome = Column(String, nullable=False)
+    estado = Column(String, nullable=False)
+    cidade = Column(String, nullable=False)
+    endereco = Column(String)
+    telefone = Column(String)
+    site = Column(String)
+    latitude = Column(Float)
+    longitude = Column(Float)
+
+
+class Estoque(Base):
+    __tablename__ = "estoques"
+
+    id = Column(Integer, primary_key=True, index=True)
+    hemocentro_id = Column(Integer, ForeignKey("hemocentros.id"))
+    tipo_sanguineo = Column(String, nullable=False)
+    status = Column(String, nullable=False)
+    fonte = Column(String)
+    ultima_atualizacao = Column(DateTime, default=datetime.now)
+
+
+class Campanha(Base):
+    __tablename__ = "campanhas"
+
+    id = Column(Integer, primary_key=True, index=True)
+    titulo = Column(String, nullable=False)
+    descricao = Column(String)
+    estado = Column(String, nullable=False)
+    cidade = Column(String, nullable=False)
+    data_inicio = Column(DateTime)
+    data_fim = Column(DateTime)
+    ativa = Column(Boolean, default=True)
+
+
+class FonteDados(Base):
+    __tablename__ = "fontes_dados"
+
+    id = Column(Integer, primary_key=True, index=True)
+    nome = Column(String, nullable=False)
+    url = Column(String, nullable=False)
+    estado = Column(String)
+    descricao = Column(String)

api_doacao_sangue-1.0.1/api_doacao_sangue/routes/campanhas.py

@@ -0,0 +1,112 @@
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy.orm import Session
+
+from api_doacao_sangue.database import get_db
+from api_doacao_sangue.models import Campanha
+from api_doacao_sangue.schemas import (
+    CampanhaCreate,
+    CampanhaUpdate,
+    CampanhaResponse
+)
+
+router = APIRouter(
+    prefix="/campanhas",
+    tags=["Campanhas"]
+)
+
+
+@router.post("/", response_model=CampanhaResponse)
+def criar_campanha(
+    dados: CampanhaCreate,
+    db: Session = Depends(get_db)
+):
+    campanha = Campanha(**dados.model_dump())
+
+    db.add(campanha)
+    db.commit()
+    db.refresh(campanha)
+
+    return campanha
+
+
+@router.get("/", response_model=list[CampanhaResponse])
+def listar_campanhas(
+    estado: str | None = None,
+    cidade: str | None = None,
+    db: Session = Depends(get_db)
+):
+    consulta = db.query(Campanha)
+
+    if estado:
+        consulta = consulta.filter(Campanha.estado == estado)
+
+    if cidade:
+        consulta = consulta.filter(Campanha.cidade == cidade)
+
+    return consulta.all()
+
+
+@router.get("/ativas", response_model=list[CampanhaResponse])
+def campanhas_ativas(
+    db: Session = Depends(get_db)
+):
+    return db.query(Campanha).filter(
+        Campanha.ativa == True
+    ).all()
+
+
+@router.get("/{campanha_id}", response_model=CampanhaResponse)
+def buscar_campanha(
+    campanha_id: int,
+    db: Session = Depends(get_db)
+):
+    campanha = db.query(Campanha).filter(
+        Campanha.id == campanha_id
+    ).first()
+
+    if not campanha:
+        raise HTTPException(404, "Campanha não encontrada")
+
+    return campanha
+
+
+@router.put("/{campanha_id}", response_model=CampanhaResponse)
+def atualizar_campanha(
+    campanha_id: int,
+    dados: CampanhaUpdate,
+    db: Session = Depends(get_db)
+):
+    campanha = db.query(Campanha).filter(
+        Campanha.id == campanha_id
+    ).first()
+
+    if not campanha:
+        raise HTTPException(404, "Campanha não encontrada")
+
+    for campo, valor in dados.model_dump().items():
+        setattr(campanha, campo, valor)
+
+    db.commit()
+    db.refresh(campanha)
+
+    return campanha
+
+
+@router.delete("/{campanha_id}")
+def deletar_campanha(
+    campanha_id: int,
+    db: Session = Depends(get_db)
+):
+    campanha = db.query(Campanha).filter(
+        Campanha.id == campanha_id
+    ).first()
+
+    if not campanha:
+        raise HTTPException(404, "Campanha não encontrada")
+
+    db.delete(campanha)
+    db.commit()
+
+    return {
+        "mensagem": "Campanha removida com sucesso"
+    }

api_doacao_sangue-1.0.1/api_doacao_sangue/routes/cidades.py

@@ -0,0 +1,41 @@
+from fastapi import APIRouter, Depends
+from sqlalchemy.orm import Session
+
+from api_doacao_sangue.database import get_db
+from api_doacao_sangue.models import Hemocentro
+
+router = APIRouter(
+    prefix="/cidades",
+    tags=["Cidades"]
+)
+
+
+@router.get("/")
+def listar_cidades(db: Session = Depends(get_db)):
+    cidades = db.query(
+        Hemocentro.estado,
+        Hemocentro.cidade
+    ).distinct().all()
+
+    return [
+        {
+            "estado": estado,
+            "cidade": cidade
+        }
+        for estado, cidade in cidades
+    ]
+
+
+@router.get("/{estado}")
+def listar_cidades_por_estado(
+    estado: str,
+    db: Session = Depends(get_db)
+):
+    cidades = db.query(Hemocentro.cidade).filter(
+        Hemocentro.estado == estado.upper()
+    ).distinct().all()
+
+    return [
+        cidade[0]
+        for cidade in cidades
+    ]

api_doacao_sangue-1.0.1/api_doacao_sangue/routes/compatibilidade.py

@@ -0,0 +1,58 @@
+from fastapi import APIRouter, HTTPException
+
+router = APIRouter(
+    prefix="/compatibilidade",
+    tags=["Compatibilidade"]
+)
+
+COMPATIBILIDADE = {
+    "O-": {
+        "recebe_de": ["O-"],
+        "doa_para": ["O-", "O+", "A-", "A+", "B-", "B+", "AB-", "AB+"]
+    },
+    "O+": {
+        "recebe_de": ["O-", "O+"],
+        "doa_para": ["O+", "A+", "B+", "AB+"]
+    },
+    "A-": {
+        "recebe_de": ["O-", "A-"],
+        "doa_para": ["A-", "A+", "AB-", "AB+"]
+    },
+    "A+": {
+        "recebe_de": ["O-", "O+", "A-", "A+"],
+        "doa_para": ["A+", "AB+"]
+    },
+    "B-": {
+        "recebe_de": ["O-", "B-"],
+        "doa_para": ["B-", "B+", "AB-", "AB+"]
+    },
+    "B+": {
+        "recebe_de": ["O-", "O+", "B-", "B+"],
+        "doa_para": ["B+", "AB+"]
+    },
+    "AB-": {
+        "recebe_de": ["O-", "A-", "B-", "AB-"],
+        "doa_para": ["AB-", "AB+"]
+    },
+    "AB+": {
+        "recebe_de": ["O-", "O+", "A-", "A+", "B-", "B+", "AB-", "AB+"],
+        "doa_para": ["AB+"]
+    }
+}
+
+
+@router.get("/{tipo}")
+def consultar_compatibilidade(tipo: str):
+    tipo = tipo.upper()
+
+    if tipo not in COMPATIBILIDADE:
+        raise HTTPException(
+            status_code=404,
+            detail="Tipo sanguíneo inválido"
+        )
+
+    return {
+        "tipo_sanguineo": tipo,
+        "recebe_de": COMPATIBILIDADE[tipo]["recebe_de"],
+        "doa_para": COMPATIBILIDADE[tipo]["doa_para"]
+    }