# vikram-04/odayssey architecture

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

- Interactive diagram: https://gitdiagram.com/vikram-04/odayssey
- Repository: https://github.com/vikram-04/odayssey

## Overview

Odayssey is a Flask digital diary combining account access, habits, tasks, important dates, journaling, and a daily motivational quote. The main user flow is to register or log in, then use the app’s diary and productivity features, with data stored in SQLite and pages rendered from Jinja templates. The graph separates the route-owning application from its feature areas and helper integrations. Some route and template wiring is documented in the README rather than shown in the sampled excerpts; those links cite the README.

Main entry points: [`app.py`](https://github.com/vikram-04/odayssey/blob/main/app.py) (Flask Routes), [`templates/layout.html`](https://github.com/vikram-04/odayssey/blob/main/templates/layout.html) (Shared Layout), [`helpers.py`](https://github.com/vikram-04/odayssey/blob/main/helpers.py) (Mood Prompts), [`templates/homepage.html`](https://github.com/vikram-04/odayssey/blob/main/templates/homepage.html) (Home Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Application Core"]
  node_app["Flask Routes<br/>[app.py]"]
  node_auth["Account Access<br/>[app.py]"]
  node_store[("SQLite Data<br/>[app.py]")]
end

subgraph group_productivity["Productivity Features"]
  node_habits["Habit Tracker<br/>[app.py]"]
  node_tasks["Task List<br/>[app.py]"]
  node_dates["Important Dates<br/>[app.py]"]
end

subgraph group_reflection["Diary and Reflection"]
  node_journal["Journal Entries<br/>[app.py]"]
  node_prompts["Mood Prompts<br/>[helpers.py]"]
  node_quotes["Daily Quote<br/>[helpers.py]"]
end

subgraph group_interface["Web Interface"]
  node_home["Home Page<br/>[homepage.html]"]
  node_layout["Shared Layout<br/>[layout.html]"]
  node_login["Login Page<br/>[login.html]"]
  node_register["Registration Page<br/>[register.html]"]
  node_habitview["Habit View<br/>[habits.html]"]
  node_taskview["Task View<br/>[todo.html]"]
  node_dateview["Dates View<br/>[dates.html]"]
  node_journalview["Journal Views<br/>[journal.html]"]
  node_writeview["Entry Editor<br/>[journal_write.html]"]
end

subgraph group_integrations["External Services"]
  node_quoteapi{{"Quote API"}}
  node_gemini{{"Gemini API"}}
end

node_visitor(("Visitor"))

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_auth
node_auth -->|"reads and writes"| node_store
node_app -->|"routes to"| node_habits
node_habits -->|"reads and writes"| node_store
node_app -->|"routes to"| node_tasks
node_tasks -->|"reads and writes"| node_store
node_app -->|"routes to"| node_dates
node_dates -->|"reads and writes"| node_store
node_app -->|"routes to"| node_journal
node_journal -->|"reads and writes"| node_store
node_journal -->|"requests prompt"| node_prompts
node_app -->|"fetches quote"| node_quotes
node_quotes -->|"requests quote"| node_quoteapi
node_prompts -->|"generates prompt"| node_gemini
node_app -->|"renders"| node_home
node_app -->|"renders"| node_login
node_app -->|"renders"| node_register
node_app -->|"renders"| node_habitview
node_app -->|"renders"| node_taskview
node_app -->|"renders"| node_dateview
node_app -->|"renders"| node_journalview
node_app -->|"renders"| node_writeview
node_home -->|"extends"| node_layout
node_login -->|"extends"| node_layout
node_register -->|"extends"| node_layout
node_habitview -->|"extends"| node_layout
node_taskview -->|"extends"| node_layout
node_dateview -->|"extends"| node_layout
node_journalview -->|"extends"| node_layout
node_writeview -->|"extends"| node_layout

click node_app "https://github.com/vikram-04/odayssey/blob/main/app.py"
click node_auth "https://github.com/vikram-04/odayssey/blob/main/app.py"
click node_store "https://github.com/vikram-04/odayssey/blob/main/app.py"
click node_habits "https://github.com/vikram-04/odayssey/blob/main/app.py"
click node_tasks "https://github.com/vikram-04/odayssey/blob/main/app.py"
click node_dates "https://github.com/vikram-04/odayssey/blob/main/app.py"
click node_journal "https://github.com/vikram-04/odayssey/blob/main/app.py"
click node_prompts "https://github.com/vikram-04/odayssey/blob/main/helpers.py"
click node_quotes "https://github.com/vikram-04/odayssey/blob/main/helpers.py"
click node_home "https://github.com/vikram-04/odayssey/blob/main/templates/homepage.html"
click node_layout "https://github.com/vikram-04/odayssey/blob/main/templates/layout.html"
click node_login "https://github.com/vikram-04/odayssey/blob/main/templates/login.html"
click node_register "https://github.com/vikram-04/odayssey/blob/main/templates/register.html"
click node_habitview "https://github.com/vikram-04/odayssey/blob/main/templates/habits.html"
click node_taskview "https://github.com/vikram-04/odayssey/blob/main/templates/todo.html"
click node_dateview "https://github.com/vikram-04/odayssey/blob/main/templates/dates.html"
click node_journalview "https://github.com/vikram-04/odayssey/blob/main/templates/journal.html"
click node_writeview "https://github.com/vikram-04/odayssey/blob/main/templates/journal_write.html"

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,node_auth,node_store toneBlue
class node_habits,node_tasks,node_dates toneAmber
class node_journal,node_prompts,node_quotes toneMint
class node_home,node_layout,node_login,node_register,node_habitview,node_taskview,node_dateview,node_journalview,node_writeview toneRose
class node_quoteapi,node_gemini,node_visitor toneIndigo
```

## Components

### Application Core

- [Flask Routes](https://github.com/vikram-04/odayssey/blob/main/app.py): `app.py`
- [Account Access](https://github.com/vikram-04/odayssey/blob/main/app.py): `app.py`
- [SQLite Data](https://github.com/vikram-04/odayssey/blob/main/app.py): `app.py`

### Productivity Features

- [Habit Tracker](https://github.com/vikram-04/odayssey/blob/main/app.py): `app.py`
- [Task List](https://github.com/vikram-04/odayssey/blob/main/app.py): `app.py`
- [Important Dates](https://github.com/vikram-04/odayssey/blob/main/app.py): `app.py`

### Diary and Reflection

- [Journal Entries](https://github.com/vikram-04/odayssey/blob/main/app.py): `app.py`
- [Mood Prompts](https://github.com/vikram-04/odayssey/blob/main/helpers.py): `helpers.py`
- [Daily Quote](https://github.com/vikram-04/odayssey/blob/main/helpers.py): `helpers.py`

### Web Interface

- [Home Page](https://github.com/vikram-04/odayssey/blob/main/templates/homepage.html): `templates/homepage.html`
- [Shared Layout](https://github.com/vikram-04/odayssey/blob/main/templates/layout.html): `templates/layout.html`
- [Login Page](https://github.com/vikram-04/odayssey/blob/main/templates/login.html): `templates/login.html`
- [Registration Page](https://github.com/vikram-04/odayssey/blob/main/templates/register.html): `templates/register.html`
- [Habit View](https://github.com/vikram-04/odayssey/blob/main/templates/habits.html): `templates/habits.html`
- [Task View](https://github.com/vikram-04/odayssey/blob/main/templates/todo.html): `templates/todo.html`
- [Dates View](https://github.com/vikram-04/odayssey/blob/main/templates/dates.html): `templates/dates.html`
- [Journal Views](https://github.com/vikram-04/odayssey/blob/main/templates/journal.html): `templates/journal.html`
- [Entry Editor](https://github.com/vikram-04/odayssey/blob/main/templates/journal_write.html): `templates/journal_write.html`

### External Services

- **Quote API**
- **Gemini API**

### Other components

- **Visitor**

## Connections

- Visitor → Flask Routes: uses (evidence: `README.md`)
- Flask Routes → Account Access: routes to (evidence: `README.md`)
- Account Access → SQLite Data: reads and writes (evidence: `README.md`)
- Flask Routes → Habit Tracker: routes to (evidence: `README.md`)
- Habit Tracker → SQLite Data: reads and writes (evidence: `app.py`)
- Flask Routes → Task List: routes to (evidence: `README.md`)
- Task List → SQLite Data: reads and writes (evidence: `app.py`)
- Flask Routes → Important Dates: routes to (evidence: `README.md`)
- Important Dates → SQLite Data: reads and writes (evidence: `app.py`)
- Flask Routes → Journal Entries: routes to (evidence: `README.md`)
- Journal Entries → SQLite Data: reads and writes (evidence: `app.py`)
- Journal Entries → Mood Prompts: requests prompt (evidence: `app.py`)
- Flask Routes → Daily Quote: fetches quote (evidence: `app.py`)
- Daily Quote → Quote API: requests quote (evidence: `helpers.py`)
- Mood Prompts → Gemini API: generates prompt (evidence: `helpers.py`)
- Flask Routes → Home Page: renders (evidence: `README.md`)
- Flask Routes → Login Page: renders (evidence: `README.md`)
- Flask Routes → Registration Page: renders (evidence: `README.md`)
- Flask Routes → Habit View: renders (evidence: `README.md`)
- Flask Routes → Task View: renders (evidence: `README.md`)
- Flask Routes → Dates View: renders (evidence: `README.md`)
- Flask Routes → Journal Views: renders (evidence: `README.md`)
- Flask Routes → Entry Editor: renders (evidence: `README.md`)
- Home Page → Shared Layout: extends (evidence: `README.md`)
- Login Page → Shared Layout: extends (evidence: `README.md`)
- Registration Page → Shared Layout: extends (evidence: `README.md`)
- Habit View → Shared Layout: extends (evidence: `README.md`)
- Task View → Shared Layout: extends (evidence: `README.md`)
- Dates View → Shared Layout: extends (evidence: `README.md`)
- Journal Views → Shared Layout: extends (evidence: `README.md`)
- Entry Editor → Shared Layout: extends (evidence: `README.md`)
