fastapi-motorcycle-data

Aplikacja REST API zbudowana przy użyciu frameworka FastAPI oraz SQLAlchemy, służąca do zarządzania danymi o motocyklach. Projekt wspiera pełne operacje CRUD i jest przygotowany do uruchomienia w kontenerze Docker.

Funkcje systemu

• CRUD dla motocykli: Dodawanie, odczyt, aktualizacja oraz usuwanie pojazdów z bazy danych.
• Automatyczna dokumentacja: Pełne wsparcie dla interaktywnej dokumentacji Swagger UI (/docs) z walidacją typów Pydantic.
• Architektura warstwowa: Wyraźny podział odpowiedzialności pomiędzy obsługę żądań HTTP (main.py) a logikę bazy danych (crud.py).
• Konteneryzacja: Szybkie uruchamianie środowiska za pomocą Docker i Docker Compose.

Technologie

• Backend: Python 3.14 / FastAPI
• ORM (Baza danych): SQLAlchemy / SQLite
• Walidacja danych: Pydantic v2
• Konteneryzacja: Docker / Docker Compose

Uruchomienie projektu

Opcja 1: Za pomocą Dockera (Zalecane)

Upewnij się, że masz zainstalowany Docker oraz Docker Compose, a następnie uruchom w terminalu:

docker compose up --build

Opcja 2: Lokalnie (środowisko wirtualne)

Stwórz środowisko wirtualne:

python -m venv .venv
source .venv/bin/activate  # Na Linux/MacOS
.venv\Scripts\activate     # Na Windows

Zainstaluj wymagane pakiety:

pip install -r requirements.txt

Uruchom serwer Uvicorn:

uvicorn main:app --reload