# mitimugdho/spl-1 architecture

> Architecture diagram of the GitHub repository mitimugdho/spl-1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mitimugdho/spl-1
- Repository: https://github.com/mitimugdho/spl-1

## Overview

This is a terminal dual-calendar application with event management and a calorie journal. The principal workflow is menu input in main.c, followed by date conversion or event actions, then persistence and display. The journal is a separate user-facing domain. The graph captures only relationships visible in the excerpts or SOURCE INDEX; several event and conversion links are documented there, while the README provides no further capability details.

Main entry points: [`main.c`](https://github.com/mitimugdho/spl-1/blob/main/main.c) (Menu workflows), [`journal.c`](https://github.com/mitimugdho/spl-1/blob/main/journal.c) (Journal operations), [`convert.c`](https://github.com/mitimugdho/spl-1/blob/main/convert.c) (Date conversion), [`ui.c`](https://github.com/mitimugdho/spl-1/blob/main/ui.c) (Calendar display)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Terminal application"]
  node_menu["Menu workflows<br/>[main.c]"]
end

subgraph group_dates["Calendar and conversion"]
  node_calendar_ui["Calendar display<br/>[ui.c]"]
  node_gregorian["Gregorian dates<br/>[gregorian.c]"]
  node_bengali["Bengali dates<br/>[bengali.c]"]
  node_conversion["Date conversion<br/>[convert.c]"]
  node_jdn["Julian day numbers<br/>[jdn.c]"]
end

subgraph group_events["Event management"]
  node_event_ops["Event operations<br/>[events.c]"]
  node_event_state["Event records<br/>[events.h]"]
  node_event_store["Event persistence<br/>[storage.c]"]
  node_event_files[("Event data files")]
end

subgraph group_journal["Calorie journal"]
  node_journal_ops["Journal operations<br/>[journal.c]"]
  node_journal_state["Journal records<br/>[journal.h]"]
  node_journal_file[("Journal data file")]
end

node_user(("User"))

node_user -->|"chooses actions"| node_menu
node_menu -->|"converts dates"| node_conversion
node_menu -->|"requests calendar"| node_calendar_ui
node_menu -->|"manages events"| node_event_ops
node_menu -->|"loads and saves"| node_event_store
node_menu -->|"manages journal"| node_journal_ops
node_menu -->|"validates dates"| node_gregorian
node_calendar_ui -->|"converts dates"| node_conversion
node_calendar_ui -->|"compares event dates"| node_jdn
node_calendar_ui -->|"reads events"| node_event_state
node_conversion -->|"uses date numbers"| node_jdn
node_conversion -->|"uses date types"| node_gregorian
node_conversion -->|"uses date types"| node_bengali
node_event_ops -->|"updates records"| node_event_state
node_event_store -->|"loads and updates"| node_event_state
node_event_store -->|"reads and writes"| node_event_files
node_event_store -->|"computes overdue"| node_jdn
node_journal_ops -->|"updates records"| node_journal_state
node_journal_ops -->|"reads and writes"| node_journal_file
node_journal_ops -->|"formats dates"| node_gregorian
node_journal_ops -->|"uses event declarations"| node_event_state

click node_menu "https://github.com/mitimugdho/spl-1/blob/main/main.c"
click node_calendar_ui "https://github.com/mitimugdho/spl-1/blob/main/ui.c"
click node_gregorian "https://github.com/mitimugdho/spl-1/blob/main/gregorian.c"
click node_bengali "https://github.com/mitimugdho/spl-1/blob/main/bengali.c"
click node_conversion "https://github.com/mitimugdho/spl-1/blob/main/convert.c"
click node_jdn "https://github.com/mitimugdho/spl-1/blob/main/jdn.c"
click node_event_ops "https://github.com/mitimugdho/spl-1/blob/main/events.c"
click node_event_state "https://github.com/mitimugdho/spl-1/blob/main/events.h"
click node_event_store "https://github.com/mitimugdho/spl-1/blob/main/storage.c"
click node_event_files "https://github.com/mitimugdho/spl-1/blob/main/calendar_events.txt"
click node_journal_ops "https://github.com/mitimugdho/spl-1/blob/main/journal.c"
click node_journal_state "https://github.com/mitimugdho/spl-1/blob/main/journal.h"
click node_journal_file "https://github.com/mitimugdho/spl-1/blob/main/journal_entries.txt"

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_menu,node_user toneBlue
class node_calendar_ui,node_gregorian,node_bengali,node_conversion,node_jdn toneAmber
class node_event_ops,node_event_state,node_event_store,node_event_files toneMint
class node_journal_ops,node_journal_state,node_journal_file toneRose
```

## Components

### Terminal application

- [Menu workflows](https://github.com/mitimugdho/spl-1/blob/main/main.c): `main.c`

### Calendar and conversion

- [Calendar display](https://github.com/mitimugdho/spl-1/blob/main/ui.c): `ui.c`
- [Gregorian dates](https://github.com/mitimugdho/spl-1/blob/main/gregorian.c): `gregorian.c`
- [Bengali dates](https://github.com/mitimugdho/spl-1/blob/main/bengali.c): `bengali.c`
- [Date conversion](https://github.com/mitimugdho/spl-1/blob/main/convert.c): `convert.c`
- [Julian day numbers](https://github.com/mitimugdho/spl-1/blob/main/jdn.c): `jdn.c`

### Event management

- [Event operations](https://github.com/mitimugdho/spl-1/blob/main/events.c): `events.c`
- [Event records](https://github.com/mitimugdho/spl-1/blob/main/events.h): `events.h`
- [Event persistence](https://github.com/mitimugdho/spl-1/blob/main/storage.c): `storage.c`
- [Event data files](https://github.com/mitimugdho/spl-1/blob/main/calendar_events.txt): `calendar_events.txt`

### Calorie journal

- [Journal operations](https://github.com/mitimugdho/spl-1/blob/main/journal.c): `journal.c`
- [Journal records](https://github.com/mitimugdho/spl-1/blob/main/journal.h): `journal.h`
- [Journal data file](https://github.com/mitimugdho/spl-1/blob/main/journal_entries.txt): `journal_entries.txt`

### Other components

- **User**

## Connections

- User → Menu workflows: chooses actions (evidence: `main.c`)
- Menu workflows → Date conversion: converts dates (evidence: `main.c`)
- Menu workflows → Calendar display: requests calendar (evidence: `main.c`)
- Menu workflows → Event operations: manages events (evidence: `main.c`)
- Menu workflows → Event persistence: loads and saves (evidence: `main.c`)
- Menu workflows → Journal operations: manages journal (evidence: `main.c`)
- Menu workflows → Gregorian dates: validates dates (evidence: `main.c`)
- Calendar display → Date conversion: converts dates (evidence: `ui.c`)
- Calendar display → Julian day numbers: compares event dates (evidence: `ui.c`)
- Calendar display → Event records: reads events (evidence: `ui.c`)
- Date conversion → Julian day numbers: uses date numbers (evidence: `convert.c`)
- Date conversion → Gregorian dates: uses date types
- Date conversion → Bengali dates: uses date types
- Event operations → Event records: updates records (evidence: `events.h`)
- Event persistence → Event records: loads and updates (evidence: `storage.c`)
- Event persistence → Event data files: reads and writes (evidence: `storage.c`)
- Event persistence → Julian day numbers: computes overdue (evidence: `storage.c`)
- Journal operations → Journal records: updates records (evidence: `journal.c`)
- Journal operations → Journal data file: reads and writes (evidence: `journal.c`)
- Journal operations → Gregorian dates: formats dates (evidence: `journal.c`)
- Journal operations → Event records: uses event declarations (evidence: `journal.c`)
