Backend¶

Flask API using Python 3.12, Poetry for dependency management, PostgreSQL for storage.

Setup¶

Prerequisites¶

Python 3.8+
Poetry

Install¶

cd backend
poetry install
poetry shell
cp .env.example .env

Database¶

Set DATABASE_URL in .env:

DATABASE_URL=postgresql+psycopg://postgres:postgres@localhost:5432/nfc_connect

Run migrations:

poetry run flask --app app db upgrade

Run¶

poetry run python run.py

Common Poetry Commands¶

poetry add package-name          # Add dependency
poetry add --dev package-name    # Add dev dependency
poetry update                    # Update all dependencies
poetry run pytest                # Run tests
poetry export -f requirements.txt --output requirements.txt

Troubleshooting¶

Ensure correct Python version
Update Poetry: poetry self update
Recreate venv: poetry env remove python && poetry install