# rotott/oden architecture

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

## Overview

Oden is an early local-first voice-journal project. Its documented target workflow is recording, speech-to-text, review/correction, storage, and retrieval, but the sampled implementation is currently a set of journal-domain models plus a frontend placeholder; no runtime processing, persistence, or search pipeline is shown. The graph therefore separates implemented models from documented future capabilities. Edges are limited to imports visible in excerpts, frontend rendering, or README statements; unimplemented capabilities have no source path.

Main entry points: [`backend/src/journal/domain/contribution.py`](https://github.com/rotott/oden/blob/main/backend/src/journal/domain/contribution.py) (Voice contribution), [`backend/src/journal/domain/journal_entry.py`](https://github.com/rotott/oden/blob/main/backend/src/journal/domain/journal_entry.py) (Journal entry), [`backend/src/journal/domain/journal.py`](https://github.com/rotott/oden/blob/main/backend/src/journal/domain/journal.py) (Journal), [`frontend/src/main.tsx`](https://github.com/rotott/oden/blob/main/frontend/src/main.tsx) (Frontend entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend shell"]
  node_app_entry["Frontend entry<br/>[main.tsx]"]
  node_app["App placeholder<br/>[App.tsx]"]
end

subgraph group_domain["Journal domain"]
  node_journal["Journal<br/>[journal.py]"]
  node_folder["Folder<br/>[folder.py]"]
  node_entry["Journal entry<br/>[journal_entry.py]"]
  node_contribution["Voice contribution<br/>[contribution.py]"]
  node_recording["Recording metadata<br/>[recording.py]"]
  node_transcription["Transcription state<br/>[transcription.py]"]
end

subgraph group_planned["Planned capabilities"]
  node_vad["Voice activity detection"]
  node_stt["Speech-to-text"]
  node_review["Review and correction"]
  node_storage[("Audio and transcript storage")]
  node_retrieval["Search and retrieval"]
  node_dataset["Personal dataset"]
  node_personal_stt["Personal STT"]
  node_memory["Memory"]
  node_assistant["Assistant tools and workflows"]
  node_agents["Agent system"]
end

node_user(("User"))

node_user -->|"opens"| node_app_entry
node_app_entry -->|"renders"| node_app
node_journal -->|"uses"| node_folder
node_journal -->|"uses"| node_entry
node_folder -->|"holds"| node_entry
node_entry -->|"holds"| node_contribution
node_contribution -->|"references"| node_recording
node_contribution -->|"references"| node_transcription
node_user -.->|"records voice"| node_vad
node_vad -.->|"segments audio"| node_stt
node_stt -.->|"produces transcript"| node_review
node_review -.->|"stores reviewed result"| node_storage
node_storage -.->|"enables search"| node_retrieval
node_storage -.->|"supports dataset"| node_dataset
node_dataset -.->|"supports improvement"| node_personal_stt
node_storage -.->|"supports memory"| node_memory
node_memory -.->|"supports workflows"| node_assistant
node_assistant -.->|"may use agents"| node_agents

click node_app_entry "https://github.com/rotott/oden/blob/main/frontend/src/main.tsx"
click node_app "https://github.com/rotott/oden/blob/main/frontend/src/App.tsx"
click node_journal "https://github.com/rotott/oden/blob/main/backend/src/journal/domain/journal.py"
click node_folder "https://github.com/rotott/oden/blob/main/backend/src/journal/domain/folder.py"
click node_entry "https://github.com/rotott/oden/blob/main/backend/src/journal/domain/journal_entry.py"
click node_contribution "https://github.com/rotott/oden/blob/main/backend/src/journal/domain/contribution.py"
click node_recording "https://github.com/rotott/oden/blob/main/backend/src/journal/domain/recording.py"
click node_transcription "https://github.com/rotott/oden/blob/main/backend/src/journal/domain/transcription.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_app_entry,node_app,node_user toneBlue
class node_journal,node_folder,node_entry,node_contribution,node_recording,node_transcription toneAmber
class node_vad,node_stt,node_review,node_storage,node_retrieval,node_dataset,node_personal_stt,node_memory,node_assistant,node_agents toneMint
```

## Components

### Frontend shell

- [Frontend entry](https://github.com/rotott/oden/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [App placeholder](https://github.com/rotott/oden/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Journal domain

- [Journal](https://github.com/rotott/oden/blob/main/backend/src/journal/domain/journal.py): `backend/src/journal/domain/journal.py`
- [Folder](https://github.com/rotott/oden/blob/main/backend/src/journal/domain/folder.py): `backend/src/journal/domain/folder.py`
- [Journal entry](https://github.com/rotott/oden/blob/main/backend/src/journal/domain/journal_entry.py): `backend/src/journal/domain/journal_entry.py`
- [Voice contribution](https://github.com/rotott/oden/blob/main/backend/src/journal/domain/contribution.py): `backend/src/journal/domain/contribution.py`
- [Recording metadata](https://github.com/rotott/oden/blob/main/backend/src/journal/domain/recording.py): `backend/src/journal/domain/recording.py`
- [Transcription state](https://github.com/rotott/oden/blob/main/backend/src/journal/domain/transcription.py): `backend/src/journal/domain/transcription.py`

### Planned capabilities

- **Voice activity detection**
- **Speech-to-text**
- **Review and correction**
- **Audio and transcript storage**
- **Search and retrieval**
- **Personal dataset**
- **Personal STT**
- **Memory**
- **Assistant tools and workflows**
- **Agent system**

### Other components

- **User**

## Connections

- User → Frontend entry: opens
- Frontend entry → App placeholder: renders (evidence: `frontend/src/main.tsx`)
- Journal → Folder: uses (evidence: `backend/src/journal/domain/journal.py`)
- Journal → Journal entry: uses (evidence: `backend/src/journal/domain/journal.py`)
- Folder → Journal entry: holds (evidence: `backend/src/journal/domain/folder.py`)
- Journal entry → Voice contribution: holds (evidence: `backend/src/journal/domain/journal_entry.py`)
- Voice contribution → Recording metadata: references (evidence: `backend/src/journal/domain/contribution.py`)
- Voice contribution → Transcription state: references (evidence: `backend/src/journal/domain/contribution.py`)
- User → Voice activity detection: records voice (evidence: `README.md`)
- Voice activity detection → Speech-to-text: segments audio (evidence: `README.md`)
- Speech-to-text → Review and correction: produces transcript (evidence: `README.md`)
- Review and correction → Audio and transcript storage: stores reviewed result (evidence: `README.md`)
- Audio and transcript storage → Search and retrieval: enables search (evidence: `README.md`)
- Audio and transcript storage → Personal dataset: supports dataset (evidence: `README.md`)
- Personal dataset → Personal STT: supports improvement (evidence: `README.md`)
- Audio and transcript storage → Memory: supports memory (evidence: `README.md`)
- Memory → Assistant tools and workflows: supports workflows (evidence: `README.md`)
- Assistant tools and workflows → Agent system: may use agents (evidence: `README.md`)
