eventa

Small, opinionated event-planning app for personal use. Parties, dinners, weekend trips, weddings, birthdays. Built for a single user or family.

This folder contains the specification + presentation site for eventa. The app itself isn't implemented yet — first we agree on what it should be.

Folder layout

eventa/
  README.md            ← you are here
  REQUIREMENTS.md      ← functional features (13, with MVP-5 highlighted)
  TECHNICAL.md         ← stack, data model, routes, V1 cuts
  docs/
    codex-round1.txt   ← raw codex transcripts (traceability)
    codex-round2.txt
    codex-round3.txt
  site/                ← presentation site (flask) → eventa.heapzilla.eu

How this was produced

A 3-round discussion with the codex CLI:

1. Round 1 — brainstorm 10-14 core features for a personal-use event planner without bloat. Codex came back with 13.
2. Round 2 — critique the list. Cut 1, merge 1, add 2, identify the MVP-5.
3. Round 3 — technical architecture: stack, data model, endpoints, risks-and-cuts for V1.

Result: a tight 13-feature scope with a clear MVP-5 and a Flask + SQLite implementation plan that fits the existing tiny1 homelab stack.

What ships in V1 (MVP-5)

1. Event Brief — title, dates, location, type, estimated guests, rough budget
2. Guest List with RSVP — guests, households, dietary, lodging
3. Private Planning Checklist — tasks with category, owner, due date (incl. supplies)
4. Deadline Timeline — Overdue / This Week / This Month / Later
5. Budget Buckets — estimated vs actual by category

See REQUIREMENTS.md for the full 13-feature list and TECHNICAL.md for the implementation plan.