# otniel113/sumtime architecture

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

- Interactive diagram: https://gitdiagram.com/otniel113/sumtime
- Repository: https://github.com/otniel113/sumtime

## Overview

##### Identifikasi Tipe dan Tujuan Proyek
- Tipe: Standalone CLI utility (C++ console application).
- Tujuan: Menjumlahkan durasi waktu (jam-menit-detik) berulang kali dan menampilkan totalnya.

##### Analisis Struktur File
- Root:
- README.md – dokumentasi.
- main.cpp – kode sumber utama.
- SumTime.cbp / .depend / .layout – project file Code::Blocks.
- Bin/Debug:
- SumTime.exe – executable hasil kompilasi.
- Obj/Debug:
- main.o – object file hasil kompilasi.
- Menandakan pipeline build sederhana: source → compiler → object → linker → exe.

a. External Actor:
- User (Console)
b. CLI I/O Module:
- Menangani input jam-menit-detik.
- Menampilkan menu dan output.
c. Time Conversion Module:
- Fungsi konversi H-M-S → total detik.
- Fungsi konversi total detik → H-M-S.
d. Summation Engine:
- Menyimpan akumulasi durasi (accumulator).
- Menambahkan durasi baru tiap input.
e. Program Control Flow:
- Loop menu: “Tambah Waktu” vs “Selesai”.
f. Build Pipeline (opsional):
- Code::Blocks IDE / g++ compiler.
- Generasi .o → .exe (bin/Debug).

##### Hubungan & Interaksi Komponen
- User → CLI I/O Module: memasukkan pilihan & durasi.
- CLI I/O → Time Conversion: kirim H-M-S untuk konversi ke detik.
- CLI I/O ↔ Summation Engine:
- Kirim nilai detik baru untuk ditambahkan.
- Minta nilai akumulasi saat “Selesai”.
- Summation Engine → Time Conversion: kirim total detik untuk diubah ke H-M-S.
- Time Conversion → CLI I/O: kembalikan format H-M-S untuk ditampilkan.
- Build Pipeline (terpisah): source files → compiler → linker → exe.

##### Pola Arsitektur & Prinsip Desain
- Single Responsibility: tiap modul (I/O, konversi, logika penjumlahan) punya tugas tunggal.
- Data Flow Linear: input → proses → output.
- Layered View (logical layers): Presentation (CLI) → Business Logic (Summation) → Utility (Conversion).

- Setiap kotak beri nama modul (mis. “Time Conversion Module”).
- Panah Berarah:
- Tunjukkan aliran data (H-M-S → detik → akumulasi → H-M-S).
- Warna/Bentuk Beda:
- Gunakan warna berbeda untuk I/O (mis. biru), Processing (kuning), Build (abu-abu).
- Keterangan Tambahan:
- Tampilkan loop kontrol menu.

1) Buat kotak untuk “User (Console)”.
2) Sambungkan panah ke kotak “CLI I/O Module”.
3) Dari “CLI I/O” gambarkan panah ke “Time Conversion Module” dan “Summation Engine”.
4) Tampilkan panah bolak-balik jika modul saling bertukar data.
5) Tambahkan kotak tersendiri di samping (atau bawah) bertuliskan “Build Pipeline” dengan sub-elemen: Source (main.cpp, SumTime.cbp) → Compiler → Binary (SumTime.exe).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors and Modules
    User["User (Console)"]:::actor
    CLI_IO["CLI I/O Module"]:::io
    TimeConv["Time Conversion Module"]:::processing
    SumEngine["Summation Engine"]:::processing
    ControlFlow["Program Control Flow\n(menu loop)"]:::processing
    Doc["Project Documentation\n(README.md)"]:::doc

    %% Build Pipeline
    subgraph "Build Pipeline"
        direction TB
        Source["Source Files\n(main.cpp, SumTime.cbp,\nSumTime.depend, SumTime.layout)"]:::build
        Compiler["Compiler\n(g++)"]:::build
        Object["Compiled Object\n(main.o)"]:::build
        Executable["Executable Binary\n(SumTime.exe)"]:::build
    end

    %% Data Flow
    User -->|"enter choice & time"| CLI_IO
    CLI_IO -->|"H-M-S input"| TimeConv
    TimeConv -->|"total seconds"| CLI_IO
    CLI_IO -->|"send seconds"| SumEngine
    SumEngine -->|"updated accumulator"| CLI_IO
    CLI_IO -->|"request total on finish"| SumEngine
    SumEngine -->|"total seconds"| TimeConv
    TimeConv -->|"format H-M-S"| CLI_IO
    CLI_IO -->|"display result"| User

    %% Build Flow
    Source --> Compiler --> Object --> Executable

    %% Documentation link
    Doc

    %% Click Events
    click CLI_IO "https://github.com/otniel113/sumtime/blob/main/main.cpp"
    click TimeConv "https://github.com/otniel113/sumtime/blob/main/main.cpp"
    click SumEngine "https://github.com/otniel113/sumtime/blob/main/main.cpp"
    click ControlFlow "https://github.com/otniel113/sumtime/blob/main/main.cpp"
    click Source "https://github.com/otniel113/sumtime/blob/main/SumTime.cbp"
    click Source "https://github.com/otniel113/sumtime/blob/main/SumTime.depend"
    click Source "https://github.com/otniel113/sumtime/blob/main/SumTime.layout"
    click Object "https://github.com/otniel113/sumtime/blob/main/obj/Debug/main.o"
    click Executable "https://github.com/otniel113/sumtime/blob/main/bin/Debug/SumTime.exe"
    click Doc "https://github.com/otniel113/sumtime/blob/main/README.md"

    %% Styles
    classDef actor fill:#a8d5e2,stroke:#333,stroke-width:1px
    classDef io fill:#a0c4ff,stroke:#333,stroke-width:1px
    classDef processing fill:#ffe066,stroke:#333,stroke-width:1px
    classDef build fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef doc fill:#caffbf,stroke:#333,stroke-width:1px
```
