# camellia2077/bills_master_cpp architecture

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

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

## Overview

##### Project type and purpose
- This is a C++-based, command-line data-processing tool (“Bills_Master”) with a small Python component for graph generation and a helper log generator.
- Purpose: take raw bill files, validate and modify them according to JSON rules, insert the cleaned data into an SQLite database, run queries (monthly/yearly), and optionally produce bar-chart reports. A side utility can emit synthetic logs.

##### File structure
- Top-level CMakeLists.txt + build.sh: controls the build (C++), compiles into a CLI executable.
- main.cpp / AppController: orchestrates user menu, invokes sub-modules.
- reprocessing/: “BillValidator” + “BillModifier” + Reprocessor facade → pre-insert pipeline.
- db_insert/: parser + DataProcessor + BillInserter → reads raw text, maps it to Transaction structures, writes to SQLite via C API.
- query/: QueryFacade + MonthlyQuery + YearlyQuery → read-only access to SQLite, output text reports.
- config/: JSON files drive validation and modification rules.
- graph/: Python script + JSON config → uses sqlite3/python-json + matplotlib to render bar charts.
- log_generator/: separate C++ project with its own CMakeLists.sh that emits fake bill logs for ingestion.

##### README for additional insights
- Dependencies: nlohmann/json in C++, Python std-json/sqlite3, SQLite C API, matplotlib.
- Configuration drives two domains: bill pre-processing and chart styling.

##### Detail and granularity
- Component with its major classes or scripts (e.g., “Reprocessor: BillValidator, BillModifier”).
- Error-handling or logging pathways only if they are critical for understanding the flow.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User interaction
    User["User"]:::actor

    %% C++ Core Modules
    subgraph "CLI Runner" 
        direction TB
        MainCPP["main.cpp"]:::cpp
        MainCommon["main_commond.cpp"]:::cpp
        AppCtrCPP["AppController.cpp"]:::cpp
        AppCtrH["AppController.h"]:::cpp
    end

    subgraph "Reprocessing Module" 
        direction TB
        ValidatorCPP["BillValidator.cpp"]:::cpp
        ValidatorH["BillValidator.h"]:::cpp
        ModifierCPP["BillModifier.cpp"]:::cpp
        ModifierH["BillModifier.h"]:::cpp
        ReprocCPP["Reprocessor.cpp"]:::cpp
        ReprocH["Reprocessor.h"]:::cpp
    end

    subgraph "Parser & Inserter Module"
        direction TB
        ParserCPP["parser.cpp"]:::cpp
        ParserH["parser.h"]:::cpp
        DataProcCPP["DataProcessor.cpp"]:::cpp
        DataProcH["DataProcessor.h"]:::cpp
        InsertCPP["insert.cpp"]:::cpp
        InsertH["insert.h"]:::cpp
    end

    subgraph "Query Module"
        direction TB
        QueryDbCPP["QueryDb.cpp"]:::cpp
        QueryDbH["QueryDb.h"]:::cpp
        MonthlyCPP["MonthlyQuery.cpp"]:::cpp
        MonthlyH["MonthlyQuery.h"]:::cpp
        YearlyCPP["YearlyQuery.cpp"]:::cpp
        YearlyH["YearlyQuery.h"]:::cpp
    end

    %% Configuration Store
    subgraph "Configuration Store"
        direction TB
        ValidatorCfg["Validator_Config.json"]:::config
        ModifierCfg["Modifier_Config.json"]:::config
    end

    %% Common Utilities
    CommonUtils["common_utils.h\nversion.h"]:::cpp

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

    %% Python Report Generator
    subgraph "Graph Generator (Python)"
        direction TB
        GenPy["generate_report.py"]:::py
        ReportCfg["generate_report.json"]:::config
    end

    %% Log Generator Utility
    subgraph "Log Generator"
        direction TB
        LogCPP["generator.cpp"]:::cpp
        LogCfg["config.json"]:::config
        LogCMake["CMakeLists.txt"]:::cpp
        LogBuild["build.sh"]:::cpp
    end

    %% Build & Docs
    CMake["CMakeLists.txt"]:::cpp
    BuildSh["build.sh"]:::cpp
    Readme["README.md"]:::cpp
    License["LICENSE"]:::cpp

    %% External Libraries
    ExtLib["External Libraries\n(nlohmann/json, SQLite C API,\nPython json/sqlite3, matplotlib)"]:::ext

    %% Data Flow
    User -->|runs| MainCPP
    MainCPP -->|invokes| ValidatorCPP
    MainCPP -->|invokes| QueryDbCPP
    MainCPP -->|invokes| GenPy
    MainCPP -->|reads| ValidatorCfg
    MainCPP -->|reads| ModifierCfg
    MainCPP -->|uses| CommonUtils
    ValidatorCPP -->|validates| ValidatorCfg
    ModifierCPP -->|modifies| ModifierCfg
    ReprocCPP -->|processes| ValidatorCPP
    ReprocCPP --> ModifierCPP
    ReprocCPP -->|emits cleaned data| ParserCPP
    ParserCPP --> DataProcCPP
    DataProcCPP --> InsertCPP
    InsertCPP -->|writes| DB
    QueryDbCPP -->|queries| DB
    GenPy -->|reads| DB
    GenPy -->|reads| ReportCfg
    GenPy -->|outputs chart.png| MainCPP
    LogCPP -->|generates sample bills| MainCPP

    %% External libs usage
    ValidatorCPP -.-> ExtLib
    ModifierCPP -.-> ExtLib
    ParserCPP -.-> ExtLib
    DataProcCPP -.-> ExtLib
    InsertCPP -.-> ExtLib
    QueryDbCPP -.-> ExtLib
    GenPy -.-> ExtLib

    %% Click Events
    click MainCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/main.cpp"
    click MainCommon "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/main_commond.cpp"
    click AppCtrCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/AppController/AppController.cpp"
    click AppCtrH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/AppController/AppController.h"
    click ValidatorCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/reprocessing/BillValidator.cpp"
    click ValidatorH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/reprocessing/BillValidator.h"
    click ModifierCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/reprocessing/BillModifier.cpp"
    click ModifierH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/reprocessing/BillModifier.h"
    click ReprocCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/reprocessing/Reprocessor.cpp"
    click ReprocH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/reprocessing/Reprocessor.h"
    click ParserCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/db_insert/parser.cpp"
    click ParserH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/db_insert/parser.h"
    click DataProcCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/db_insert/DataProcessor.cpp"
    click DataProcH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/db_insert/DataProcessor.h"
    click InsertCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/db_insert/insert.cpp"
    click InsertH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/db_insert/insert.h"
    click QueryDbCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/query/QueryDb.cpp"
    click QueryDbH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/query/QueryDb.h"
    click MonthlyCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/query/MonthlyQuery.cpp"
    click MonthlyH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/query/MonthlyQuery.h"
    click YearlyCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/query/YearlyQuery.cpp"
    click YearlyH "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/query/YearlyQuery.h"
    click ValidatorCfg "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/config/Validator_Config.json"
    click ModifierCfg "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/config/Modifier_Config.json"
    click CommonUtils "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/common/common_utils.h"
    click CMake "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/CMakeLists.txt"
    click BuildSh "https://github.com/camellia2077/bills_master_cpp/blob/main/Bills_Master/build.sh"
    click Readme "https://github.com/camellia2077/bills_master_cpp/blob/main/README.md"
    click License "https://github.com/camellia2077/bills_master_cpp/tree/main/LICENSE"
    click GenPy "https://github.com/camellia2077/bills_master_cpp/blob/main/graph/generate_report.py"
    click ReportCfg "https://github.com/camellia2077/bills_master_cpp/blob/main/graph/generate_report.json"
    click LogCPP "https://github.com/camellia2077/bills_master_cpp/blob/main/log_generator/generator.cpp"
    click LogCfg "https://github.com/camellia2077/bills_master_cpp/blob/main/log_generator/config.json"
    click LogCMake "https://github.com/camellia2077/bills_master_cpp/blob/main/log_generator/CMakeLists.txt"
    click LogBuild "https://github.com/camellia2077/bills_master_cpp/blob/main/log_generator/build.sh"

    %% Styles
    classDef cpp fill:#D0E6FF,stroke:#0050A0,stroke-width:1px;
    classDef config fill:#E2FFD0,stroke:#3A7F00,stroke-width:1px,stroke-dasharray: 5 5;
    classDef db fill:#F0F0F0,stroke:#888888,stroke-width:1px;
    classDef py fill:#FFE0B2,stroke:#E67E22,stroke-width:1px;
    classDef ext fill:#CCCCCC,stroke:#666666,stroke-width:1px;
    classDef actor fill:#FFFFFF,stroke:#000000,stroke-width:1px;
    class MainCPP,MainCommon,AppCtrCPP,AppCtrH,ValidatorCPP,ValidatorH,ModifierCPP,ModifierH,ReprocCPP,ReprocH,ParserCPP,ParserH,DataProcCPP,DataProcH,InsertCPP,InsertH,QueryDbCPP,QueryDbH,MonthlyCPP,MonthlyH,YearlyCPP,YearlyH,CMake,BuildSh,Readme,License,LogCPP,LogCMake,LogBuild,CommonUtils cpp
    class ValidatorCfg,ModifierCfg,ReportCfg,LogCfg config
    class DB ext
    class GenPy py
    class ExtLib ext
    class User actor
```
