# camellia2077/time_master_cpp architecture

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

- Interactive diagram: https://gitdiagram.com/camellia2077/time_master_cpp
- Repository: https://github.com/camellia2077/time_master_cpp

## Overview

##### Project type and purpose
- This is a multi-tool, open-source time-tracking suite. It contains:
- A C++ “Time_Master” CLI/interactive app that ingests raw text logs, validates & converts them, inserts structured data into a SQLite database, and runs queries/reports.
- A Python “graph_generator” tool that reads the same SQLite database and produces charts (timelines, bar charts, heatmaps).
- A small C++ “log_generator” test harness to produce synthetic logs for testing the ingestion pipeline.

##### High-level file structure analysis
- Top-level:
- time_master/ — C++ source, organized into subpackages (action_handler, file_handler, db_inserter, queries, reprocessing, UI) plus CMakeLists.txt and main entry points.
- test/log_generator/ — C++ test generator with its own CMakeLists and build script.
- Configuration files live under time_master/config and graph_generator/configs.
- CMakeLists.txt orchestrates the C++ builds; Python scripts are invoked directly.

##### Key insights from README
- Dependencies: SQLite C API, nlohmann/json for C++; Python’s json + sqlite3; Matplotlib.
- Detailed descriptions of each subproject’s purpose, directory layout, CLI flags, and config formats.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Test Log Generator
    subgraph "Test Log Generator (C++)" 
        direction TB
        TLGen["Test Log Generator"]:::cpp
    end

    RawLogs["Raw Log Input\n(plain-text files)"]:::data

    %% Time_Master CLI App
    subgraph "Time_Master CLI App (C++)"
        direction TB
        subgraph "Entry Points"
            CLI_Main1["main_cli.cpp"]:::cpp
            CLI_Main2["main.cpp"]:::cpp
        end
        CLI["CLI Layer"]:::cpp
        AH["ActionHandler"]:::cpp
        subgraph "FileHandler"
            ConfigLoader["ConfigLoader.cpp/.h"]:::cpp
            FileController["FileController.cpp/.h"]:::cpp
            FileUtils["FileUtils.cpp/.h"]:::cpp
        end
        subgraph "Reprocessing Pipeline"
            IntervalProc["IntervalProcessor.cpp/.h"]:::cpp
            LogProc["LogProcessor.cpp/.h"]:::cpp
            subgraph "Validators"
                OutVal["OutputFileValidator.cpp/.h"]:::cpp
                SrcVal["SourceFileValidator.cpp/.h"]:::cpp
                ValUtils["ValidatorUtils.cpp/.h"]:::cpp
            end
        end
        subgraph "DBInserter"
            DataParser["DataFileParser.cpp/.h"]:::cpp
            DataImporter["DataImporter.cpp/.h"]:::cpp
            DBInsert["DatabaseInserter.cpp/.h"]:::cpp
        end
        subgraph "QueryHandler & Reports"
            QH["QueryHandler.cpp/.h"]:::cpp
            subgraph "Report Generators"
                DailyRpt["DailyReportQuerier.cpp/.h"]:::cpp
                MonthlyRpt["MonthlyReportQuerier.cpp/.h"]:::cpp
                PeriodRpt["PeriodReportQuerier.cpp/.h"]:::cpp
                QDataStructs["query_data_structs.h"]:::cpp
            end
        end
        subgraph "Configs"
            TMConfig["config.json"]:::config
            ValConfig["format_validator_config.json"]:::config
            IntConfig["interval_processor_config.json"]:::config
        end
    end

    %% SQLite Database
    SQLiteDB["SQLite Database\n(bills.db)"]:::data

    %% Graph Generator Python App
    subgraph "Graph_Generator (Python)"
        direction TB
        GG_Main1["main_input.py"]:::py
        GG_Main2["main.py"]:::py
        DBAccess["db_access.py"]:::py
        subgraph "Modules"
            DayAn["day_analyzer.py"]:::py
            HeatmapGen["heatmap_generator.py"]:::py
            Plotters["plotters.py"]:::py
        end
        subgraph "Configs"
            HeatmapCfg["heatmap_colors.json"]:::config
            TimelineCfg["timeline_colors.json"]:::config
        end
        Charts["Output Charts\n(PNG/SVG)"]:::data
    end

    %% Relationships / Data Flow
    TLGen -->|generates| RawLogs
    RawLogs -->|logs| FileController
    FileController -->|reads| ConfigLoader
    ConfigLoader -->|loads JSON configs| TMConfig
    FileController -->|sends raw text| IntervalProc
    IntervalProc --> LogProc
    LogProc --> OutVal
    LogProc --> SrcVal
    OutVal --> ValUtils
    SrcVal --> ValUtils
    LogProc --> DataParser
    DataParser --> DataImporter
    DataImporter --> DBInsert
    DBInsert -->|SQL INSERTs| SQLiteDB
    AH --> FileController
    CLI_Main1 --> CLI
    CLI_Main2 --> CLI
    CLI --> AH
    AH --> QH
    QH --> DailyRpt
    QH --> MonthlyRpt
    QH --> PeriodRpt
    SQLiteDB -->|SELECT queries| DBAccess
    DBAccess --> DayAn
    DBAccess --> HeatmapGen
    DBAccess --> Plotters
    DayAn --> Charts
    HeatmapGen --> Charts
    Plotters --> Charts

    %% Click Events
    click TLGen "https://github.com/camellia2077/time_master_cpp/tree/main/test/log_generator/"
    click CLI_Main1 "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/main_cli.cpp"
    click CLI_Main2 "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/main.cpp"
    click AH "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/action_handler/ActionHandler.cpp"
    click ConfigLoader "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/file_handler/ConfigLoader.cpp"
    click FileController "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/file_handler/FileController.cpp"
    click FileUtils "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/file_handler/FileUtils.cpp"
    click IntervalProc "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/reprocessing/IntervalProcessor.cpp"
    click LogProc "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/reprocessing/LogProcessor.cpp"
    click OutVal "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/reprocessing/validator/OutputFileValidator.cpp"
    click SrcVal "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/reprocessing/validator/SourceFileValidator.cpp"
    click ValUtils "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/reprocessing/validator/ValidatorUtils.cpp"
    click DataParser "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/db_inserter/DataFileParser.cpp"
    click DataImporter "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/db_inserter/DataImporter.cpp"
    click DBInsert "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/db_inserter/DatabaseInserter.cpp"
    click QH "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/queries/QueryHandler.cpp"
    click DailyRpt "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/queries/report_generators/DailyReportQuerier.cpp"
    click MonthlyRpt "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/queries/report_generators/MonthlyReportQuerier.cpp"
    click PeriodRpt "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/queries/report_generators/PeriodReportQuerier.cpp"
    click QDataStructs "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/queries/report_generators/query_data_structs.h"
    click TMConfig "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/config/config.json"
    click ValConfig "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/config/format_validator_config.json"
    click IntConfig "https://github.com/camellia2077/time_master_cpp/blob/main/time_master/config/interval_processor_config.json"
    click GG_Main1 "https://github.com/camellia2077/time_master_cpp/blob/main/graph_generator/main_input.py"
    click GG_Main2 "https://github.com/camellia2077/time_master_cpp/blob/main/graph_generator/main.py"
    click DBAccess "https://github.com/camellia2077/time_master_cpp/blob/main/graph_generator/db_access.py"
    click DayAn "https://github.com/camellia2077/time_master_cpp/blob/main/graph_generator/modules/day_analyzer.py"
    click HeatmapGen "https://github.com/camellia2077/time_master_cpp/blob/main/graph_generator/modules/heatmap_generator.py"
    click Plotters "https://github.com/camellia2077/time_master_cpp/blob/main/graph_generator/modules/plotters.py"
    click HeatmapCfg "https://github.com/camellia2077/time_master_cpp/blob/main/graph_generator/configs/heatmap_colors.json"
    click TimelineCfg "https://github.com/camellia2077/time_master_cpp/blob/main/graph_generator/configs/timeline_colors.json"

    %% Styles
    classDef cpp fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef py fill:#90EE90,stroke:#000,stroke-width:1px
    classDef data fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef config fill:#D3D3D3,stroke:#000,stroke-width:1px

    %% Legend
    subgraph Legend
        direction TB
        A["C++ Components"]:::cpp
        B["Python Components"]:::py
        C["Data Stores & Outputs"]:::data
        D["Configuration Files"]:::config
    end
```
