m038andClaude Opus 4.8
2695bce835
Capture the safe procedure + three non-obvious traps from the standalone- page cleanup: keep the folder as a routable:false data container, repoint Back-link fallbacks to the grandparent (silent direct-landing regression), and sync the gitignored demo source + Makefile or the next demo-load undoes it. Seed CONCEPTS.md (Trip, Entry, Story, Active Trip) and surface docs/solutions/ + CONCEPTS.md in CLAUDE.md so future sessions discover them. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.2 KiB
Concepts
Shared domain vocabulary for this project — entities, named processes, and status concepts with project-specific meaning. Seeded with core domain vocabulary, then accretes as ce-compound and ce-compound-refresh process learnings; direct edits are fine. Glossary only, not a spec or catch-all.
Relationships
A Trip owns its Entries and Stories. Exactly one Trip is the Active Trip at a time; it is the one surfaced on the home page and the target for new posts. Entries and Stories are always scoped to a Trip — they do not exist independently.
Trip
Trip
A single journey the blog is organised around — the top-level content entity. A Trip aggregates its Entries and Stories and carries its own metadata (title, start/end dates, cover image, route GPX files). Each Trip renders as one consolidated Trip page showing an inline map, a filtered feed, and inline stats; the journal, map, stats, and story views are not separate pages.
Active Trip
The one Trip currently featured — set in site config and read by the home page and the post form. Switching the Active Trip is a deliberate, multi-file change; if the post form's target and the featured Trip fall out of sync, new posts land under the wrong Trip.
Entry
A single dated journal post within a Trip — the atomic unit of the day-to-day travel log. Avoid: daily, journal post
The Trip's journal section is labelled "Journal" and lives in the Trip's dailies container, so an Entry is colloquially "a daily"; in templates and page metadata the same thing is called an entry. Entries carry a date, optional location and coordinates, weather, and photos, and are ordered by date within a Trip.
Story
A long-form, designed narrative piece within a Trip — hero image plus scrollytelling/gallery sections — distinct from the short, dated Entry. Stories are curated set pieces; Entries are the running log.
Flagged ambiguities
- "daily" / "entry" / "journal post" all refer to the same concept (a dated journal post). Canonical term: Entry. The section/folder is named "dailies" and the nav label is "Journal" — these name the collection, not a different entity.