# lordjunn/dine-with-junn architecture

> Architecture diagram of the GitHub repository lordjunn/dine-with-junn, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lordjunn/dine-with-junn
- Repository: https://github.com/lordjunn/dine-with-junn

## Overview

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: [`pipeline/builder.py`](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/builder.py) (Static Site Builder), [`scripts/cli.py`](https://github.com/lordjunn/dine-with-junn/blob/main/scripts/cli.py) (CLI Commands), [`pipeline/discord_sync.py`](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/discord_sync.py) (Discord Photo Sync), [`pipeline/parser.py`](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/parser.py) (Markdown Parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_diary["Diary Sources"]
  node_content["Monthly Markdown"]
  node_images["Meal Photos"]
  node_configdata["Site Configuration<br/>[config.json]"]
end

subgraph group_pipeline["Content Pipeline"]
  node_parser["Markdown Parser<br/>[parser.py]"]
  node_schema["Diary Data Model<br/>[schema.py]"]
  node_analytics["Spending Analytics<br/>[analytics.py]"]
  node_builder["Static Site Builder<br/>[builder.py]"]
  node_siteconfig["Config Loader<br/>[config.py]"]
end

subgraph group_operations["Diary Operations"]
  node_cli["CLI Commands<br/>[cli.py]"]
  node_migrator["Legacy Migrator<br/>[migrator.py]"]
  node_discord["Discord Photo Sync<br/>[discord_sync.py]"]
  node_imageprocessor["Image Processor<br/>[image_processor.py]"]
  node_validator["Content Validator<br/>[validate.py]"]
end

subgraph group_site["Archive Experience"]
  node_templates["Site Templates"]
  node_assets["Site Assets"]
  node_archive["Generated Archive<br/>[builder.py]"]
  node_search["Archive Search<br/>[all.js]"]
  node_csvdata["Menu Datasets"]
end

node_editor(("Diary Editor"))
node_discordservice["Discord"]
node_legacy["Food-MMU Archive"]

node_editor -->|"edits"| node_content
node_editor -->|"runs commands"| node_cli
node_content -->|"parsed from"| node_parser
node_parser -->|"creates models"| node_schema
node_builder -->|"uses parser"| node_parser
node_builder -->|"computes analytics"| node_analytics
node_analytics -->|"reads month data"| node_schema
node_builder -->|"loads configuration"| node_siteconfig
node_siteconfig -->|"loads settings"| node_configdata
node_cli -->|"builds site"| node_builder
node_cli -->|"runs migration"| node_migrator
node_migrator -.->|"imports legacy records"| node_legacy
node_cli -->|"runs photo sync"| node_discord
node_discord -->|"fetches candidates"| node_discordservice
node_discord -.->|"parses month"| node_parser
node_discord -.->|"uses processor"| node_imageprocessor
node_imageprocessor -->|"saves processed photos"| node_images
node_discord -->|"updates image references"| node_content
node_cli -->|"validates content"| node_validator
node_validator -->|"parses entries"| node_parser
node_validator -->|"checks build"| node_builder
node_builder -->|"generates pages"| node_archive
node_builder -.->|"renders templates"| node_templates
node_builder -.->|"includes assets"| node_assets
node_archive -.->|"supports search"| node_search
node_builder -.->|"exports datasets"| node_csvdata

click node_content "https://github.com/lordjunn/dine-with-junn/tree/main/content"
click node_images "https://github.com/lordjunn/dine-with-junn/tree/main/images"
click node_configdata "https://github.com/lordjunn/dine-with-junn/blob/main/config.json"
click node_cli "https://github.com/lordjunn/dine-with-junn/blob/main/scripts/cli.py"
click node_parser "https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/parser.py"
click node_schema "https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/schema.py"
click node_analytics "https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/analytics.py"
click node_builder "https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/builder.py"
click node_siteconfig "https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/config.py"
click node_migrator "https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/migrator.py"
click node_discord "https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/discord_sync.py"
click node_imageprocessor "https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/image_processor.py"
click node_validator "https://github.com/lordjunn/dine-with-junn/blob/main/scripts/validate.py"
click node_templates "https://github.com/lordjunn/dine-with-junn/tree/main/templates"
click node_assets "https://github.com/lordjunn/dine-with-junn/tree/main/static"
click node_archive "https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/builder.py"
click node_search "https://github.com/lordjunn/dine-with-junn/blob/main/static/js/all.js"
click node_csvdata "https://github.com/lordjunn/dine-with-junn/tree/main/data"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_content,node_images,node_configdata toneBlue
class node_parser,node_schema,node_analytics,node_builder,node_siteconfig toneAmber
class node_cli,node_migrator,node_discord,node_imageprocessor,node_validator toneMint
class node_templates,node_assets,node_archive,node_search,node_csvdata toneRose
class node_editor,node_discordservice,node_legacy toneIndigo
```

## Components

### Diary Sources

- [Monthly Markdown](https://github.com/lordjunn/dine-with-junn/tree/main/content): `content`
- [Meal Photos](https://github.com/lordjunn/dine-with-junn/tree/main/images): `images`
- [Site Configuration](https://github.com/lordjunn/dine-with-junn/blob/main/config.json): `config.json`

### Content Pipeline

- [Markdown Parser](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/parser.py): `pipeline/parser.py`
- [Diary Data Model](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/schema.py): `pipeline/schema.py`
- [Spending Analytics](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/analytics.py): `pipeline/analytics.py`
- [Static Site Builder](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/builder.py): `pipeline/builder.py`
- [Config Loader](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/config.py): `pipeline/config.py`

### Diary Operations

- [CLI Commands](https://github.com/lordjunn/dine-with-junn/blob/main/scripts/cli.py): `scripts/cli.py`
- [Legacy Migrator](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/migrator.py): `pipeline/migrator.py`
- [Discord Photo Sync](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/discord_sync.py): `pipeline/discord_sync.py`
- [Image Processor](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/image_processor.py): `pipeline/image_processor.py`
- [Content Validator](https://github.com/lordjunn/dine-with-junn/blob/main/scripts/validate.py): `scripts/validate.py`

### Archive Experience

- [Site Templates](https://github.com/lordjunn/dine-with-junn/tree/main/templates): `templates`
- [Site Assets](https://github.com/lordjunn/dine-with-junn/tree/main/static): `static`
- [Generated Archive](https://github.com/lordjunn/dine-with-junn/blob/main/pipeline/builder.py): `pipeline/builder.py`
- [Archive Search](https://github.com/lordjunn/dine-with-junn/blob/main/static/js/all.js): `static/js/all.js`
- [Menu Datasets](https://github.com/lordjunn/dine-with-junn/tree/main/data): `data`

### Other components

- **Diary Editor**
- **Discord**
- **Food-MMU Archive**

## Connections

- Diary Editor → Monthly Markdown: edits (evidence: `README.md`)
- Diary Editor → CLI Commands: runs commands (evidence: `README.md`)
- Monthly Markdown → Markdown Parser: parsed from (evidence: `README.md`)
- Markdown Parser → Diary Data Model: creates models (evidence: `pipeline/parser.py`)
- Static Site Builder → Markdown Parser: uses parser (evidence: `pipeline/builder.py`)
- Static Site Builder → Spending Analytics: computes analytics (evidence: `pipeline/builder.py`)
- Spending Analytics → Diary Data Model: reads month data (evidence: `pipeline/analytics.py`)
- Static Site Builder → Config Loader: loads configuration (evidence: `pipeline/builder.py`)
- Config Loader → Site Configuration: loads settings (evidence: `pipeline/config.py`)
- CLI Commands → Static Site Builder: builds site (evidence: `scripts/cli.py`)
- CLI Commands → Legacy Migrator: runs migration (evidence: `scripts/cli.py`)
- Legacy Migrator → Food-MMU Archive: imports legacy records (evidence: `pipeline/migrator.py`)
- CLI Commands → Discord Photo Sync: runs photo sync (evidence: `scripts/cli.py`)
- Discord Photo Sync → Discord: fetches candidates (evidence: `pipeline/discord_sync.py`)
- Discord Photo Sync → Markdown Parser: parses month (evidence: `pipeline/discord_sync.py`)
- Discord Photo Sync → Image Processor: uses processor (evidence: `pipeline/discord_sync.py`)
- Image Processor → Meal Photos: saves processed photos (evidence: `pipeline/image_processor.py`)
- Discord Photo Sync → Monthly Markdown: updates image references
- CLI Commands → Content Validator: validates content (evidence: `scripts/cli.py`)
- Content Validator → Markdown Parser: parses entries (evidence: `scripts/validate.py`)
- Content Validator → Static Site Builder: checks build (evidence: `scripts/validate.py`)
- Static Site Builder → Generated Archive: generates pages (evidence: `README.md`)
- Static Site Builder → Site Templates: renders templates
- Static Site Builder → Site Assets: includes assets
- Generated Archive → Archive Search: supports search (evidence: `README.md`)
- Static Site Builder → Menu Datasets: exports datasets (evidence: `README.md`)
