# alefsantos497/diario-estudos-cpp architecture

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

- Interactive diagram: https://gitdiagram.com/alefsantos497/diario-estudos-cpp
- Repository: https://github.com/alefsantos497/diario-estudos-cpp

## Overview

This is a small C++ terminal study journal. The user selects an action from the menu: log hours for a subject, which updates the in-memory totals and saves them, or list accumulated totals. Startup loads saved totals and skips malformed records. The single source file implements all stages; the README documents the workflow and persistence format.

Main entry points: [`main.cpp`](https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp) (Menu and dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Terminal workflow"]
  node_menu["Menu and dispatch<br/>[main.cpp]"]
  node_input_validation["Input validation<br/>[main.cpp]"]
  node_study_listing["Study listing<br/>[main.cpp]"]
end

subgraph group_study_data["Study records"]
  node_study_registration["Study registration<br/>[main.cpp]"]
  node_study_totals["Subject totals<br/>[main.cpp]"]
  node_file_loading["File loading<br/>[main.cpp]"]
  node_file_saving["File saving<br/>[main.cpp]"]
  node_study_file[("estudos.txt")]
end

node_user(("User"))

node_user -->|"chooses action"| node_menu
node_menu -->|"validates input"| node_input_validation
node_menu -->|"loads at startup"| node_file_loading
node_menu -->|"registers study"| node_study_registration
node_study_registration -->|"adds hours"| node_study_totals
node_menu -->|"saves after entry"| node_file_saving
node_file_saving -->|"writes records"| node_study_file
node_file_loading -->|"reads records"| node_study_file
node_file_loading -->|"restores totals"| node_study_totals
node_menu -->|"lists totals"| node_study_listing
node_study_listing -->|"displays totals"| node_study_totals

click node_menu "https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp"
click node_input_validation "https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp"
click node_study_registration "https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp"
click node_study_totals "https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp"
click node_study_listing "https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp"
click node_file_loading "https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp"
click node_file_saving "https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp"

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_input_validation,node_study_listing,node_user toneBlue
class node_study_registration,node_study_totals,node_file_loading,node_file_saving,node_study_file toneAmber
```

## Components

### Terminal workflow

- [Menu and dispatch](https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp): `main.cpp`
- [Input validation](https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp): `main.cpp`
- [Study listing](https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp): `main.cpp`

### Study records

- [Study registration](https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp): `main.cpp`
- [Subject totals](https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp): `main.cpp`
- [File loading](https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp): `main.cpp`
- [File saving](https://github.com/alefsantos497/diario-estudos-cpp/blob/main/main.cpp): `main.cpp`
- **estudos.txt**

### Other components

- **User**

## Connections

- User → Menu and dispatch: chooses action (evidence: `main.cpp`)
- Menu and dispatch → Input validation: validates input (evidence: `main.cpp`)
- Menu and dispatch → File loading: loads at startup (evidence: `main.cpp`)
- Menu and dispatch → Study registration: registers study (evidence: `main.cpp`)
- Study registration → Subject totals: adds hours (evidence: `main.cpp`)
- Menu and dispatch → File saving: saves after entry (evidence: `main.cpp`)
- File saving → estudos.txt: writes records (evidence: `main.cpp`)
- File loading → estudos.txt: reads records (evidence: `main.cpp`)
- File loading → Subject totals: restores totals (evidence: `main.cpp`)
- Menu and dispatch → Study listing: lists totals (evidence: `main.cpp`)
- Study listing → Subject totals: displays totals (evidence: `main.cpp`)
