Files

T

jacobh2 6a79435baf Delete date helpers nothing calls

A hand-rolled month-arithmetic module survived the move to dateutil with no
caller left but its own tests, and two predicates alongside it were never
wired up at all. An error import was also being deferred inside a function
for a circular dependency that does not exist.

2026-09-18 01:09:42 +02:00

app

Delete date helpers nothing calls

2026-09-18 01:09:42 +02:00

migrations

Give tips a date, a scope per child, and a dismissal that sticks

2026-09-17 22:32:03 +02:00

scripts

Remove a period's days along with the period

2026-09-18 00:23:34 +02:00

tests

Delete date helpers nothing calls

2026-09-18 01:09:42 +02:00

.env.example

MVP frontend+backend

2026-06-14 09:58:30 +02:00

.gitignore

Initial commit

2026-06-01 16:48:21 +02:00

alembic.ini

Initial commit

2026-06-01 16:48:21 +02:00

pyproject.toml

MVP frontend+backend

2026-06-14 09:58:30 +02:00

README.md

Write a front door for the repository

2026-09-18 00:56:11 +02:00

tests.txt

Initial commit

2026-06-01 16:48:21 +02:00

uv.lock

MVP frontend+backend

2026-06-14 09:58:30 +02:00

README.md

Backend — Föräldraledigplannerare

FastAPI + Python 3.14, packages managed with uv. Layered architecture (entities → repositories → services → routers) with dependency injection so the database backend (SQLite now, Postgres later) is swappable.

Setup

uv sync                 # install deps (incl. dev group)
uv run uvicorn app.main:app --reload   # run dev server on :8000
uv run pytest           # run tests with coverage
uv run ruff check .     # lint

Layout

app/
  config.py            # pydantic-settings (app config + frozen LeaveRules)
  dependencies.py      # DI factories (pick repo impl by settings.database_type)
  entities/            # plain dataclasses (domain)
  models/              # pydantic API schemas
  repositories/        # abstract interfaces
  repositories_impl/   # concrete impls per backend (sqlite/, postgres/)
  services/            # business logic
  routers/             # FastAPI routes
  db/connection.py     # connection + (dev) schema bootstrap
  utils/               # errors, logger

Demo data (manual/browser testing)

scripts/seed_demo.py seeds a realistic, ready-to-explore workspace through the normal service/repository layers (no raw SQL) — a couple workspace with a partner, a child born ~6 months ago, vacation rows for only some years (so the is_assumed badge is visible), day overrides, and a spread of leave wishes (fixed, flexible, and one deliberately underfunded to show a shortfall + remedies + surplus advice). Login credentials are fixed and printed at the end.

uv run python scripts/seed_demo.py            # create once; re-running is a no-op
uv run python scripts/seed_demo.py --reset     # wipe the demo workspace and rebuild

Then open http://localhost:5173 and log in with the printed demo@example.com credentials. Safe to re-run: without --reset it detects the existing demo user and changes nothing; --reset only ever deletes the one demo workspace.

Reference vertical slice

VacationDays is implemented end-to-end (entity → schema → repo interface → SQLite impl → service → router → tests). Copy this slice when adding a new entity.

The inline schema in db/connection.py exists only so dev/tests are self-contained. Production schema is owned by Alembic migrations (a senior task).