carsten
589dcbcdf5
Config-driven DATABASE_URL shared by the app and Alembic's env.py (fixes v1's config drift), psycopg3 driver, auto-discovering app/models package for SQLModel.metadata, and a /health endpoint that exercises the DB dependency end-to-end. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
3.6 KiB
Fælles Vinindkøb — Projektplan
Formål
Erstatte manuel administration (regneark til betalingstracking, direkte databaseredigering for nye runder/deltagere/vine) med en rigtig admin-backend, samt automatisk betalings-mail til deltagere. Arkitekturen designes fra start til at kunne understøtte flere organisationer (fx vinbonden Horcher-familiens egne ruter i Frankrig/Belgien), selvom kun én organisation/rute er i drift i dag.
Tech stack
- Backend: FastAPI + SQLModel + PostgreSQL + Alembic (migrations)
- Frontend: React (admin-UI) + eksisterende offentlige bestillingsside (fortsat intet login for deltagere)
- Mail: SMTP-udbyder — afklares
Datamodel
-
WineCategory — global, delt af ALLE organisationer/ruter (samme vinbonde, samme kategoristruktur: TRADITION, SELECTION, LES IMPERTINENTS, GRANDS CRUS, VENDANGES TARDIVES, CREMANT, MAGNUM, SANS ALCOOL osv.)
- navn, sortering
-
Organization — administrativ gruppe (fx "Fælles Vinindkøb DK", "Horcher Frankrig")
- navn
-
User — admin-login, tilhører en Organization
- simpelt login v1 (password-hash + session/JWT), struktureret så passkey/WebAuthn kan tilføjes senere uden brud
-
Route — tilhører en Organization (fx "Tyskland" for jer; "Belgique" / "Paris" / "Massif Central" for Horcher-familien)
- navn, mødested/kontaktperson/telefon (fritekst, forudfyldes fra forrige runde)
-
Participant — tilhører en Route
- navn, mail, telefon, is_active
-
PurchaseRound — tilhører en Route
- sæson (forår/efterår), år, status (kladde/åben/lukket)
- eur_dkk_rate (valgfri — ikke alle organisationer skal omregne)
- intro_text, pickup_info_text (forudfyldes fra forrige runde, kun dato/sæson skal typisk rettes)
-
WineOffering — tilhører PurchaseRound + (global) WineCategory
- navn (inkl. størrelse, fx "75cl" — ikke separat felt v1)
- vintage/årgang, pris (EUR)
- is_organic (boolean — sat via checkbox, kilde: AB-mærket på producentens prisliste)
-
Order — deltager + runde
- payment_status (ubetalt/betalt), paid_at
-
OrderLine — ordre + wine_offering + antal
Mail-events
- Runde åbnes → mail til alle aktive deltagere på ruten
- Ordre afgivet → kvittering til deltager + notifikation til admin (findes allerede)
- Nyt: Admin markerer ordre "betalt" → automatisk kvitteringsmail til deltager SMTP: Postal (selvhostet)
Fase 1 — nuværende scope
- Sæt FastAPI + SQLModel + PostgreSQL op med Alembic
- Definér modellerne ovenfor (inkl. Organization/Route-hierarki, selvom kun én organisation/rute findes i dag)
- Manuel dataindtastning: deltagere (og evt. en aktiv runde) fra MongoDB til PostgreSQL
- Simpelt login til User
- Admin CRUD: deltagere (inkl. aktiv/inaktiv — erstatter "tom bestilling"-tricket)
- Admin CRUD: runder + vinliste, med "kopiér fra forrige runde" (alle felter, inkl. kategori, forudfyldt og frit redigerbare)
- "Annoncér runde": skabelonmail til alle aktive deltagere på ruten
- Flyt offentlig bestillingsformular til nyt API (fortsat uden login)
- Admin-ordreoversigt pr. runde med "markér betalt" → trigger mail #3
- Genskab afhentningsliste (HTML-udtræk til print) mod ny datamodel
- Simpelt React admin-UI til pkt. 5, 6, 7, 9
- Testkør en rigtig runde gennem hele flowet
Fase 2 — senere
- enablebanking.com: automatisk match af indbetalinger mod ubetalte ordrer → kalder samme "markér betalt"-logik
- Passkey-login til admin
- Rute-vælger på bestillingssiden (når flere ruter er aktive samtidig)
- sold_only_by_case-flag + validering, hvis det bliver relevant