# mrioan/transaction-reconciliation architecture

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

- Interactive diagram: https://gitdiagram.com/mrioan/transaction-reconciliation
- Repository: https://github.com/mrioan/transaction-reconciliation

## Overview

##### Project Type & Purpose
- This is a full‐stack Java web application (Maven multi‐module) for automatic financial reconciliation of two CSV files.
- The “core” module implements the CSV-processing pipeline in plain Java; the “web” module is a Spring Boot WebMVC layer (Thymeleaf + JS + Bootstrap + jQuery) that exposes HTML pages and JSON endpoints.

##### File Structure Analysis
- Top level:
- pom.xml (aggregator)
- modules: “core” and “web”
- core/src/main/java/com/mario/sample/reconciliation:
- config (ConfigProperties)
- exception
- filter (CSVLoadingFilter → IdenticalRecordRemoverFilter → SimilarRecordFilter → ResemblingRecordFilter → ReportDataOrganizationFilter)
- matching (field matchers, record matchers, revisitors)
- model (Record, RecordPair, etc.)
- processing (CSVParser, RecordStore abstractions)
- util
- web/src/main/java/com/mario/sample/reconciliation/web:
- Application (entry point)
- configuration (WebConfig)
- controller (HomeController, GlobalExceptionHandler)
- service (TransactionReconciliationService orchestrates core; StorageService)
- mapper (maps core FilterOutput → web ReconciliationResult)
- web model (DTOs)
- static (JS/CSS/images), templates (Thymeleaf)

##### Insights from README
- Core uses a filter‐pipeline architecture (extensible sequence of Filters).
- Web module relies on core, exposes:
- HTML UI (file upload form + results tables + animations)
- JSON API (multipart/form POST, returns JSON summary).
- Uses external config.properties for core; application.properties for web.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        Browser["Browser UI (Thymeleaf)"]:::client
        JSONClient["JSON Client (AJAX)"]:::client
    end

    %% Web Layer
    subgraph "Web Layer" 
        direction TB
        App["Application"]:::web
        WebCfg["WebConfig"]:::web
        HC["HomeController"]:::web
        GEH["GlobalExceptionHandler"]:::web
        TRS["TransactionReconciliationService"]:::web
        SS["StorageService"]:::web
        FSStorage["FileSystemStorageService"]:::web
        FOM["FilterOutputMapper"]:::web
        RR["ReconciliationResult (DTO)"]:::web
    end

    %% Core Module
    subgraph "Core Module"
        direction TB
        subgraph "Configuration"
            ConfigProps["ConfigProperties"]:::core
            ConfigFile["config.properties"]:::storage
        end
        subgraph "Filter Pipeline"
            CSVLoading["CSVLoadingFilter"]:::core
            IdenticalRemover["IdenticalRecordRemoverFilter"]:::core
            SimilarFilter["SimilarRecordFilter"]:::core
            ResemblingFilter["ResemblingRecordFilter"]:::core
            ReportOrganizer["ReportDataOrganizationFilter"]:::core
            Workflow["CSVProcessingWorkflow"]:::core
        end
        subgraph "Matching Strategy"
            MatchDir["matching/"]:::core
        end
        subgraph "Processing Abstractions"
            ProcessingDir["processing/"]:::core
        end
        subgraph "Data Models"
            ModelDir["model/"]:::core
        end
        subgraph "Utilities"
            UtilDir["util/"]:::core
        end
        subgraph "Exceptions"
            ExceptionDir["exception/"]:::core
        end
    end

    %% Storage & Config
    subgraph "Storage & Config"
        direction TB
        TempFS["Temp File Storage"]:::storage
    end

    %% Flows
    Browser -->|"HTTP POST / upload"| HC
    JSONClient -->|"HTTP POST / upload"| HC
    HC -->|"upload(files)"| TRS
    HC -->|"handles exceptions"| GEH
    TRS -->|"save files"| SS
    SS -->|"store files"| FSStorage
    TRS -->|"invoke pipeline"| Workflow
    Workflow --> CSVLoading
    CSVLoading --> IdenticalRemover
    IdenticalRemover --> SimilarFilter
    SimilarFilter --> ResemblingFilter
    ResemblingFilter --> ReportOrganizer
    Workflow -->|"uses"| ProcessingDir
    Workflow -->|"uses"| ModelDir
    Workflow -->|"uses"| MatchDir
    Workflow -->|"reads config"| ConfigProps
    ConfigProps --> ConfigFile
    Workflow -->|"returns FilterOutput"| FOM
    FOM -->|"map to DTO"| RR
    RR --> HC
    HC -->|"render HTML view"| Browser
    HC -->|"return JSON"| JSONClient
    SS --> TempFS

    %% Click Events
    click ConfigProps "https://github.com/mrioan/transaction-reconciliation/blob/master/core/src/main/java/com/mario/sample/reconciliation/config/ConfigProperties.java"
    click ConfigFile "https://github.com/mrioan/transaction-reconciliation/blob/master/core/src/main/resources/config.properties"
    click CSVLoading "https://github.com/mrioan/transaction-reconciliation/blob/master/core/src/main/java/com/mario/sample/reconciliation/filter/CSVLoadingFilter.java"
    click IdenticalRemover "https://github.com/mrioan/transaction-reconciliation/blob/master/core/src/main/java/com/mario/sample/reconciliation/filter/IdenticalRecordRemoverFilter.java"
    click SimilarFilter "https://github.com/mrioan/transaction-reconciliation/blob/master/core/src/main/java/com/mario/sample/reconciliation/filter/SimilarRecordFilter.java"
    click ResemblingFilter "https://github.com/mrioan/transaction-reconciliation/blob/master/core/src/main/java/com/mario/sample/reconciliation/filter/ResemblingRecordFilter.java"
    click ReportOrganizer "https://github.com/mrioan/transaction-reconciliation/blob/master/core/src/main/java/com/mario/sample/reconciliation/filter/ReportDataOrganizationFilter.java"
    click Workflow "https://github.com/mrioan/transaction-reconciliation/blob/master/core/src/main/java/com/mario/sample/reconciliation/filter/CSVProcessingWorkflow.java"
    click MatchDir "https://github.com/mrioan/transaction-reconciliation/tree/master/core/src/main/java/com/mario/sample/reconciliation/matching/"
    click ModelDir "https://github.com/mrioan/transaction-reconciliation/tree/master/core/src/main/java/com/mario/sample/reconciliation/model/"
    click ProcessingDir "https://github.com/mrioan/transaction-reconciliation/tree/master/core/src/main/java/com/mario/sample/reconciliation/processing/"
    click UtilDir "https://github.com/mrioan/transaction-reconciliation/tree/master/core/src/main/java/com/mario/sample/reconciliation/util/"
    click ExceptionDir "https://github.com/mrioan/transaction-reconciliation/tree/master/core/src/main/java/com/mario/sample/reconciliation/exception/"
    click App "https://github.com/mrioan/transaction-reconciliation/blob/master/web/src/main/java/com/mario/sample/reconciliation/web/Application.java"
    click WebCfg "https://github.com/mrioan/transaction-reconciliation/blob/master/web/src/main/java/com/mario/sample/reconciliation/web/configuration/WebConfig.java"
    click HC "https://github.com/mrioan/transaction-reconciliation/blob/master/web/src/main/java/com/mario/sample/reconciliation/web/controller/HomeController.java"
    click GEH "https://github.com/mrioan/transaction-reconciliation/blob/master/web/src/main/java/com/mario/sample/reconciliation/web/controller/GlobalExceptionHandler.java"
    click TRS "https://github.com/mrioan/transaction-reconciliation/blob/master/web/src/main/java/com/mario/sample/reconciliation/web/service/TransactionReconciliationService.java"
    click SS "https://github.com/mrioan/transaction-reconciliation/blob/master/web/src/main/java/com/mario/sample/reconciliation/web/service/StorageService.java"
    click FSStorage "https://github.com/mrioan/transaction-reconciliation/blob/master/web/src/main/java/com/mario/sample/reconciliation/web/service/FileSystemStorageService.java"
    click FOM "https://github.com/mrioan/transaction-reconciliation/blob/master/web/src/main/java/com/mario/sample/reconciliation/web/mapper/FilterOutputMapper.java"
    click RR "https://github.com/mrioan/transaction-reconciliation/blob/master/web/src/main/java/com/mario/sample/reconciliation/web/model/ReconciliationResult.java"
    click Templates "https://github.com/mrioan/transaction-reconciliation/tree/master/web/src/main/resources/templates/"
    click StaticAssets "https://github.com/mrioan/transaction-reconciliation/tree/master/web/src/main/resources/static/assets/"

    %% Styles
    classDef client fill:#bbdefb,stroke:#0d47a1,color:#0d47a1
    classDef web fill:#c8e6c9,stroke:#1b5e20,color:#1b5e20
    classDef core fill:#ffe0b2,stroke:#e65100,color:#e65100
    classDef storage fill:#e0e0e0,stroke:#424242,color:#424242
```
