# buechijonas/wintersehn architecture

> Architecture diagram of the GitHub repository buechijonas/wintersehn, 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/buechijonas/wintersehn
- Repository: https://github.com/buechijonas/wintersehn

## Overview

Wintersehn is a self-hosted platform combining six user-facing Vue applications with a shared Django API. Users enter through an app, which presents its domain workflow and relies on the backend for business logic; the API also supports account and content administration. The major branches cover public content, privacy-focused search, learning resources, media catalog and playback, and encrypted personal dossiers with sharing. The README documents platform-wide integrations; sampled frontend entry points and routes show app setup and navigation, but most backend and domain implementation files were not sampled, so those internal links are intentionally limited.

Main entry points: [`backend`](https://github.com/buechijonas/wintersehn/tree/main/backend) (Django API), [`frontend/core/src`](https://github.com/buechijonas/wintersehn/tree/main/frontend/core/src) (Shared frontend), [`frontend/wintersehn/src`](https://github.com/buechijonas/wintersehn/tree/main/frontend/wintersehn/src) (Wintersehn site), [`frontend/atlas/src`](https://github.com/buechijonas/wintersehn/tree/main/frontend/atlas/src) (ATLAS learning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shared["Shared platform"]
  node_core["Shared frontend"]
  node_api["Django API"]
  node_accounts["Accounts and consent"]
end

subgraph group_site["Public content"]
  node_home["App directory"]
  node_wintersehn["Wintersehn site"]
  node_content["Site content"]
end

subgraph group_search["Private search"]
  node_searchapp["Search interface"]
  node_searchbackend["Search settings"]
  node_searx["SearXNG"]
  node_tor["Tor service"]
end

subgraph group_atlas["Learning resources"]
  node_atlasapp["ATLAS learning"]
  node_atlasbackend["Learning API"]
end

subgraph group_lumon["Media library"]
  node_lumonapp["LUMON interface"]
  node_catalog["Media catalog"]
  node_sources["Catalog sources"]
  node_media["Local media library<br/>[library.py]"]
end

subgraph group_monolith["Secure dossiers"]
  node_monolithapp["Monolith interface"]
  node_dossiers["Encrypted dossiers<br/>[dossier.py]"]
  node_events["Dossier events<br/>[event.py]"]
  node_sharing["Dossier sharing<br/>[sharing.py]"]
end

node_visitor(("Platform user"))
node_postgres[("PostgreSQL")]

node_visitor -->|"opens"| node_home
node_visitor -->|"visits"| node_wintersehn
node_visitor -->|"searches"| node_searchapp
node_visitor -->|"studies"| node_atlasapp
node_visitor -->|"browses"| node_lumonapp
node_visitor -->|"manages records"| node_monolithapp
node_home -->|"uses shared UI"| node_core
node_wintersehn -->|"uses shared UI"| node_core
node_atlasapp -->|"uses shared UI"| node_core
node_lumonapp -->|"uses shared UI"| node_core
node_monolithapp -->|"uses shared UI"| node_core
node_searchapp -->|"requests API"| node_api
node_wintersehn -->|"requests API"| node_api
node_atlasapp -->|"requests API"| node_api
node_lumonapp -->|"requests API"| node_api
node_monolithapp -->|"requests API"| node_api
node_api -->|"serves account flows"| node_accounts
node_api -->|"serves content"| node_content
node_api -->|"serves learning data"| node_atlasbackend
node_api -->|"serves search settings"| node_searchbackend
node_api -->|"serves catalog"| node_catalog
node_api -->|"serves dossiers"| node_dossiers
node_api -->|"persists data"| node_postgres
node_accounts -.->|"authenticates via OIDC"| node_visitor
node_searchbackend -.->|"queries search"| node_searx
node_searx -.->|"routes through"| node_tor
node_catalog -.->|"imports metadata"| node_sources
node_catalog -.->|"uses local library"| node_media
node_dossiers -.->|"records events"| node_events
node_dossiers -.->|"supports sharing"| node_sharing

click node_core "https://github.com/buechijonas/wintersehn/tree/main/frontend/core/src"
click node_api "https://github.com/buechijonas/wintersehn/tree/main/backend"
click node_accounts "https://github.com/buechijonas/wintersehn/tree/main/backend/wintersehn/accounts"
click node_home "https://github.com/buechijonas/wintersehn/tree/main/frontend/home/src"
click node_wintersehn "https://github.com/buechijonas/wintersehn/tree/main/frontend/wintersehn/src"
click node_content "https://github.com/buechijonas/wintersehn/tree/main/backend/wintersehn/content"
click node_searchapp "https://github.com/buechijonas/wintersehn/tree/main/frontend/search/src"
click node_searchbackend "https://github.com/buechijonas/wintersehn/tree/main/backend/search"
click node_searx "https://github.com/buechijonas/wintersehn/tree/main/docker/searxng"
click node_atlasapp "https://github.com/buechijonas/wintersehn/tree/main/frontend/atlas/src"
click node_atlasbackend "https://github.com/buechijonas/wintersehn/tree/main/backend/atlas"
click node_lumonapp "https://github.com/buechijonas/wintersehn/tree/main/frontend/lumon/src"
click node_catalog "https://github.com/buechijonas/wintersehn/tree/main/backend/lumon"
click node_sources "https://github.com/buechijonas/wintersehn/tree/main/backend/lumon/sources"
click node_media "https://github.com/buechijonas/wintersehn/blob/main/backend/lumon/library.py"
click node_monolithapp "https://github.com/buechijonas/wintersehn/tree/main/frontend/monolith/src"
click node_dossiers "https://github.com/buechijonas/wintersehn/blob/main/backend/monolith/models/dossier.py"
click node_events "https://github.com/buechijonas/wintersehn/blob/main/backend/monolith/models/event.py"
click node_sharing "https://github.com/buechijonas/wintersehn/blob/main/backend/monolith/sharing.py"

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_core,node_api,node_accounts,node_visitor toneBlue
class node_home,node_wintersehn,node_content,node_postgres toneAmber
class node_searchapp,node_searchbackend,node_searx,node_tor toneMint
class node_atlasapp,node_atlasbackend toneRose
class node_lumonapp,node_catalog,node_sources,node_media toneIndigo
class node_monolithapp,node_dossiers,node_events,node_sharing toneTeal
```

## Components

### Shared platform

- [Shared frontend](https://github.com/buechijonas/wintersehn/tree/main/frontend/core/src): `frontend/core/src`
- [Django API](https://github.com/buechijonas/wintersehn/tree/main/backend): `backend`
- [Accounts and consent](https://github.com/buechijonas/wintersehn/tree/main/backend/wintersehn/accounts): `backend/wintersehn/accounts`

### Public content

- [App directory](https://github.com/buechijonas/wintersehn/tree/main/frontend/home/src): `frontend/home/src`
- [Wintersehn site](https://github.com/buechijonas/wintersehn/tree/main/frontend/wintersehn/src): `frontend/wintersehn/src`
- [Site content](https://github.com/buechijonas/wintersehn/tree/main/backend/wintersehn/content): `backend/wintersehn/content`

### Private search

- [Search interface](https://github.com/buechijonas/wintersehn/tree/main/frontend/search/src): `frontend/search/src`
- [Search settings](https://github.com/buechijonas/wintersehn/tree/main/backend/search): `backend/search`
- [SearXNG](https://github.com/buechijonas/wintersehn/tree/main/docker/searxng): `docker/searxng`
- **Tor service**

### Learning resources

- [ATLAS learning](https://github.com/buechijonas/wintersehn/tree/main/frontend/atlas/src): `frontend/atlas/src`
- [Learning API](https://github.com/buechijonas/wintersehn/tree/main/backend/atlas): `backend/atlas`

### Media library

- [LUMON interface](https://github.com/buechijonas/wintersehn/tree/main/frontend/lumon/src): `frontend/lumon/src`
- [Media catalog](https://github.com/buechijonas/wintersehn/tree/main/backend/lumon): `backend/lumon`
- [Catalog sources](https://github.com/buechijonas/wintersehn/tree/main/backend/lumon/sources): `backend/lumon/sources`
- [Local media library](https://github.com/buechijonas/wintersehn/blob/main/backend/lumon/library.py): `backend/lumon/library.py`

### Secure dossiers

- [Monolith interface](https://github.com/buechijonas/wintersehn/tree/main/frontend/monolith/src): `frontend/monolith/src`
- [Encrypted dossiers](https://github.com/buechijonas/wintersehn/blob/main/backend/monolith/models/dossier.py): `backend/monolith/models/dossier.py`
- [Dossier events](https://github.com/buechijonas/wintersehn/blob/main/backend/monolith/models/event.py): `backend/monolith/models/event.py`
- [Dossier sharing](https://github.com/buechijonas/wintersehn/blob/main/backend/monolith/sharing.py): `backend/monolith/sharing.py`

### Other components

- **Platform user**
- **PostgreSQL**

## Connections

- Platform user → App directory: opens
- Platform user → Wintersehn site: visits
- Platform user → Search interface: searches
- Platform user → ATLAS learning: studies
- Platform user → LUMON interface: browses
- Platform user → Monolith interface: manages records
- App directory → Shared frontend: uses shared UI (evidence: `frontend/home/src/main.js`)
- Wintersehn site → Shared frontend: uses shared UI (evidence: `frontend/wintersehn/src/main.js`)
- ATLAS learning → Shared frontend: uses shared UI (evidence: `frontend/atlas/src/main.js`)
- LUMON interface → Shared frontend: uses shared UI (evidence: `frontend/lumon/src/main.js`)
- Monolith interface → Shared frontend: uses shared UI (evidence: `frontend/monolith/src/main.js`)
- Search interface → Django API: requests API
- Wintersehn site → Django API: requests API
- ATLAS learning → Django API: requests API
- LUMON interface → Django API: requests API
- Monolith interface → Django API: requests API
- Django API → Accounts and consent: serves account flows
- Django API → Site content: serves content
- Django API → Learning API: serves learning data
- Django API → Search settings: serves search settings
- Django API → Media catalog: serves catalog
- Django API → Encrypted dossiers: serves dossiers
- Django API → PostgreSQL: persists data
- Accounts and consent → Platform user: authenticates via OIDC
- Search settings → SearXNG: queries search
- SearXNG → Tor service: routes through
- Media catalog → Catalog sources: imports metadata
- Media catalog → Local media library: uses local library
- Encrypted dossiers → Dossier events: records events
- Encrypted dossiers → Dossier sharing: supports sharing
