# moxer-mmh/personal-finance-manager architecture

> Architecture diagram of the GitHub repository moxer-mmh/personal-finance-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/moxer-mmh/personal-finance-manager
- Repository: https://github.com/moxer-mmh/personal-finance-manager

## Overview

##### Main Components

A. User Interface Layer
- UI components hierarchy with dashboard as the main view
- Components for analysis, reports, and transaction management
- Use a rectangle with rounded corners to represent the UI layer

B. Service Layer
- Four main services (Account, Transaction, Analysis, and ML)
- As hexagons to indicate their role as primary business logic handlers

C. Core Domain Layer
- Core entities: Account, Transaction, Expense, Income, Subscription, Category
- As rectangles with solid borders
- Relationships between entities with appropriate cardinality

D. Trackers Layer
- Tracker components that monitor different financial aspects
- To core entities they track

E. Analysis Engine
- Analyzers (Budget, Statistical, Time Series)
- Connection to the AI/ML components
- As parallelograms to indicate data processing

F. AI/ML Component
- Both categorization and prediction models
- Training and preprocessing components

G. Database Layer
- Database models and connection management

##### Component Relationships

- UI → Services (user requests)
- Services → Core Domain (business logic)
- Services → Trackers (monitoring)
- Services → Analysis Engine (data analysis requests)
- Analysis Engine → AI/ML (for predictions and categorization)
- All components → Database (data persistence)

##### Additional Elements

A. Include subsystems:
- Utils package (showing shared utilities)
- Configuration management
- Data import/export functionality

B. Show external integrations:
- Data import/export interfaces
- Potential API endpoints
- Authentication system (if applicable)

##### Technical Details

- Database connection pooling
- AI model training flow
- Analysis pipeline stages
- Service interaction patterns
- Data validation flow

This architecture represents a modern, modular design with clear separation of concerns, making it maintainable and scalable while supporting advanced features like AI-powered categorization and predictive analytics.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef service fill:#2ecc71,stroke:#27ae60,color:white
    classDef domain fill:#f1c40f,stroke:#f39c12,color:black
    classDef analysis fill:#e67e22,stroke:#d35400,color:white
    classDef ai fill:#9b59b6,stroke:#8e44ad,color:white
    classDef data fill:#e74c3c,stroke:#c0392b,color:white
    classDef utility fill:#95a5a6,stroke:#7f8c8d,color:white

    %% UI Layer
    subgraph UI
        Dashboard["Dashboard"]:::ui
        AnalysisView["Analysis View"]:::ui
        ReportsView["Reports View"]:::ui
        TransactionForm["Transaction Form"]:::ui
    end

    %% Services Layer
    subgraph Services
        AccountService["Account Service"]:::service
        TransactionService["Transaction Service"]:::service
        AnalysisService["Analysis Service"]:::service
        MLService["ML Service"]:::service
    end

    %% Core Domain Layer
    subgraph Domain
        Account["Account"]:::domain
        Transaction["Transaction"]:::domain
        Expense["Expense"]:::domain
        Income["Income"]:::domain
        Subscription["Subscription"]:::domain
        Category["Category"]:::domain
    end

    %% Analysis Engine
    subgraph Analysis
        BudgetAnalyzer["Budget Analyzer"]:::analysis
        StatisticalAnalyzer["Statistical Analyzer"]:::analysis
        TimeSeriesAnalyzer["Time Series Analyzer"]:::analysis
        ReportGenerator["Report Generator"]:::analysis
    end

    %% AI/ML Component
    subgraph AI
        CategorizationModel["Categorization Model"]:::ai
        PredictionModel["Prediction Model"]:::ai
        TrainingPipeline["Training Pipeline"]:::ai
        Preprocessing["Preprocessing"]:::ai
    end

    %% Data Layer
    subgraph Data
        DBConnection["Database Connection"]:::data
        DBModels["Database Models"]:::data
    end

    %% Utility Services
    subgraph Utils
        ConfigManager["Config Manager"]:::utility
        DataImportExport["Data Import/Export"]:::utility
        Validation["Validation"]:::utility
        CalculationUtils["Calculation Utils"]:::utility
    end

    %% Relationships
    Dashboard --> AccountService
    Dashboard --> TransactionService
    AnalysisView --> AnalysisService
    ReportsView --> AnalysisService
    TransactionForm --> TransactionService

    AccountService --> Account
    TransactionService --> Transaction
    AnalysisService --> BudgetAnalyzer
    MLService --> CategorizationModel

    Transaction --> Expense
    Transaction --> Income
    Transaction --> Subscription
    Transaction --> Category

    BudgetAnalyzer --> ReportGenerator
    StatisticalAnalyzer --> ReportGenerator
    TimeSeriesAnalyzer --> ReportGenerator

    CategorizationModel --> Preprocessing
    PredictionModel --> Preprocessing
    TrainingPipeline --> CategorizationModel
    TrainingPipeline --> PredictionModel

    Account --> DBModels
    Transaction --> DBModels
    DBModels --> DBConnection

    ConfigManager --> Services
    Validation --> Services
    DataImportExport --> Services
    CalculationUtils --> Analysis

    %% Click Events
    click Dashboard "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/ui/components/dashboard.py"
    click AnalysisView "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/ui/components/analysis_view.py"
    click ReportsView "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/ui/components/reports_view.py"
    click TransactionForm "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/ui/components/transaction_form.py"
    
    click AccountService "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/services/account_service.py"
    click TransactionService "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/services/transaction_service.py"
    click AnalysisService "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/services/analysis_service.py"
    click MLService "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/services/ml_service.py"
    
    click Account "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/core/account.py"
    click Transaction "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/core/transaction.py"
    click Expense "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/core/expense.py"
    click Income "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/core/income.py"
    click Subscription "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/core/subscription.py"
    click Category "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/core/category.py"
    
    click BudgetAnalyzer "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/analysis/budget_analyzer.py"
    click StatisticalAnalyzer "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/analysis/statistical_analyzer.py"
    click TimeSeriesAnalyzer "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/analysis/time_series_analyzer.py"
    click ReportGenerator "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/analysis/report_generator.py"
    
    click CategorizationModel "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/ai/models/categorization_model.py"
    click PredictionModel "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/ai/models/prediction_model.py"
    click TrainingPipeline "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/ai/training/trainer.py"
    click Preprocessing "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/ai/utils/preprocessing.py"
    
    click DBConnection "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/database/connection.py"
    click DBModels "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/database/models.py"
    
    click ConfigManager "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/utils/config_manager.py"
    click DataImportExport "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/utils/data_import_export.py"
    click Validation "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/utils/validation.py"
    click CalculationUtils "https://github.com/moxer-mmh/Personal-Finance-Manager/blob/main/finance_manager/utils/calculation_utils.py"
```
