Meal planner backend

## Structure

- `main.py`: FastAPI app with all HTTP endpoints.
- `db.py`: aiosqlite connection + schema bootstrap across subpackages (calls each feature's `repository.create`).
- Domain packages with models and persistence:
	- `products/` (models.py, repository.py, scrapers for Woolworths/Coles)
	- `ingredients/` (models.py, repository.py)
	- `recipes/` (models.py, repository.py, scraping.py)
	- `meals/` (models.py, repository.py, service.py)
	- `persons/` (models.py, repository.py)
	- `shopping/` (models.py, repository.py)
- `tests/`: unit and API tests with sample HTTP fixtures.

## Getting started

Install packages
```
pip install -r ./requirements.txt
```

Run API (dev)
```
uvicorn main:app --reload
```

Run tests
```
pytest -q
```

## Tooling

This repo includes baseline configs in `pyproject.toml`:
- black (format)
- ruff (lint)
- mypy (type check)

Optional commands (install these locally first):
```
ruff check .
ruff format .
mypy .
```

## Environment variables

- DOOF_DB: Path to sqlite database (default: `./data/doof.sqlite`)
- DOOF_PORT: Port the server listens on when containerized; align Dockerfile `EXPOSE` accordingly.

## OpenAPI schema

- Generate the schema artifact used by the frontend and CI checks:
```
python scripts/export_openapi.py
```

This writes `openapi.json` to the repo root. Versioned endpoints live under `/api/v1`, legacy under `/api` (deprecated with `Deprecation` header).

## Schema lint/diff (manual)

Optionally, lint and compare schemas locally using Node tools:
```
npx -y @stoplight/spectral-cli lint openapi.json
npx -y openapi-diff --fail-on-changed --fail-on-incompatible path/to/baseline.json openapi.json
```

Keep a `baseline.json` on release branches to detect breaking changes.