How lordjunn/dine-with-junn works
Dine with Junn is a Markdown-first food diary, expense tracker, and life archive. Its main workflow is editing monthly entries and photos, parsing them into structured month data, computing spending analytics, and building a searchable static archive. Separate CLI capabilities create month templates, migrate legacy records, and sync meal photos from Discord; validation checks content and build viability. The source excerpts show core parser, analytics, builder, image, migration, and sync relationships, but do not expose every generated page or CLI dispatch, so those links are omitted where unverified.
Main entry points: builder.py Static Site Builder · cli.py CLI Commands · discord_sync.py Discord Photo Sync · parser.py Markdown Parser
Components 21
Diary Sources
- Monthly Markdown
content - Meal Photos
images - Site Configuration
config.json
Content Pipeline
- Markdown Parser
pipeline/parser.py - Diary Data Model
pipeline/schema.py - Spending Analytics
pipeline/analytics.py - Static Site Builder
pipeline/builder.py - Config Loader
pipeline/config.py
Diary Operations
- CLI Commands
scripts/cli.py - Legacy Migrator
pipeline/migrator.py - Discord Photo Sync
pipeline/discord_sync.py - Image Processor
pipeline/image_processor.py - Content Validator
scripts/validate.py
Archive Experience
- Site Templates
templates - Site Assets
static - Generated Archive
pipeline/builder.py - Archive Search
static/js/all.js - Menu Datasets
data
Other components
- Diary Editor
- Discord
- Food-MMU Archive
Connections 26
- Diary Editor → Monthly Markdown: edits
README.md - Diary Editor → CLI Commands: runs commands
README.md - Monthly Markdown → Markdown Parser: parsed from
README.md - Markdown Parser → Diary Data Model: creates models
pipeline/parser.py - Static Site Builder → Markdown Parser: uses parser
pipeline/builder.py - Static Site Builder → Spending Analytics: computes analytics
pipeline/builder.py - Spending Analytics → Diary Data Model: reads month data
pipeline/analytics.py - Static Site Builder → Config Loader: loads configuration
pipeline/builder.py - Config Loader → Site Configuration: loads settings
pipeline/config.py - CLI Commands → Static Site Builder: builds site
scripts/cli.py - CLI Commands → Legacy Migrator: runs migration
scripts/cli.py - Legacy Migrator → Food-MMU Archive: imports legacy records
pipeline/migrator.py - CLI Commands → Discord Photo Sync: runs photo sync
scripts/cli.py - Discord Photo Sync → Discord: fetches candidates
pipeline/discord_sync.py - Discord Photo Sync → Markdown Parser: parses month
pipeline/discord_sync.py - Discord Photo Sync → Image Processor: uses processor
pipeline/discord_sync.py - Image Processor → Meal Photos: saves processed photos
pipeline/image_processor.py - Discord Photo Sync → Monthly Markdown: updates image references
- CLI Commands → Content Validator: validates content
scripts/cli.py - Content Validator → Markdown Parser: parses entries
scripts/validate.py - Content Validator → Static Site Builder: checks build
scripts/validate.py - Static Site Builder → Generated Archive: generates pages
README.md - Static Site Builder → Site Templates: renders templates
- Static Site Builder → Site Assets: includes assets
- Generated Archive → Archive Search: supports search
README.md - Static Site Builder → Menu Datasets: exports datasets
README.md