# ankit-goyal-git/fincore-monitoring-project architecture

> Architecture diagram of the GitHub repository ankit-goyal-git/fincore-monitoring-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ankit-goyal-git/fincore-monitoring-project
- Repository: https://github.com/ankit-goyal-git/fincore-monitoring-project

## Overview

##### Project Type and Purpose
- This is a full-stack monitoring & observability solution for a Dockerized Flask-based banking microservices application.
- It uses Prometheus to scrape metrics (application + system via Node Exporter), Grafana for dashboards and alerting, Alertmanager (via Grafana) for notifications, and Terraform to provision AWS infrastructure (EC2, VPC, remote state in S3).

##### File-Structure Analysis
- Top level:
- app.py + Dockerfile – Flask banking app container
- prometheus.yml – Prometheus scrape configuration
- grafana/ – Grafana config + dashboards + provisioning rules
- terraform-fincore/ – Terraform modules for AWS EC2, VPC, security groups, remote state (S3 backend)
- Patterns:
- Containerized microservices (Flask app, Prometheus, Node Exporter, Grafana) running on a single EC2 host via Docker
- IaC with Terraform and remote state in S3
- Grafana provisioning of dashboards, datasources, and alerts via mounted JSON/YAML

##### Core Components & Responsibilities
- Infrastructure (AWS)
- VPC, public subnet, Internet Gateway, Routing
- Security Group (ports 22, 3000, 5000, 9090, 9100)
- EC2 instance (user-data script installs Docker, clones the repo, starts containers)
- S3 bucket (Terraform remote state backend)
- Docker Host (EC2)
- Flask Banking App container (exposes /metrics, endpoints /balance, /transfer, /transactions)
- Node Exporter container (exposes host-level metrics on 9100)
- Prometheus container (scrapes app & node exporter on 9090)
- Grafana container (listens on 3000, auto-loads dashboards, alert rules, data source)
- Observability Pipeline
- Prometheus scrapes metrics and stores time-series data
- Grafana queries Prometheus via Prometheus-datasource
- Alert rules (configured in Grafana provisioning) trigger notifications via SMTP/Slack

##### Interactions and Data Flow
1. Terraform CLI → AWS APIs → Provision VPC, Subnet, SG, EC2, S3 backend
2. EC2 user-data → installs Docker & Git → clones repository → launches containers
3. Node Exporter & Flask App → /metrics endpoints → scraped by Prometheus
4. Prometheus data → queried by Grafana dashboards
5. Grafana alert rules → evaluate Prometheus metrics → send emails via SMTP (or Slack)
6. Terraform remote state → stored and versioned in S3

##### Architectural Patterns & Design Principles
- Separation of concerns: infrastructure (Terraform) vs. application code vs. observability tools
- Immutable infrastructure: Docker containers launched by user-data script
- Infrastructure as Code: Terraform modules, variables, remote state
- Continuous provisioning: Grafana auto-provisioning of dashboards & alerts

##### Final Checklist
- [ ] All major components identified & labeled
- [ ] Architectural patterns annotated (IaC, containerization, observability pipeline)
- [ ] Detail Terraform remote state and provisioning sequence

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% IAC Layer
    subgraph "Infrastructure as Code (Terraform)"
        direction TB
        mainTF["main.tf"]:::iac
        backendTF["backend.tf"]:::iac
        variablesTF["variables.tf"]:::iac
        tfvars["terraform.tfvars"]:::iac
        outputTF["output.tf"]:::iac
        TerraformCLI["Terraform CLI"]:::iac
    end

    %% AWS Cloud Layer
    subgraph "AWS Cloud"
        direction TB
        VPC["VPC"]:::aws
        Subnet["Public Subnet"]:::aws
        IGW["Internet Gateway"]:::aws
        SG["Security Group"]:::aws
        EC2["EC2 Instance"]:::aws
        S3Bucket["S3 (Remote State)"]:::external
    end

    %% Compute Host
    EC2 -->|"user-data script"| Host["Docker Host"]:::compute

    %% Containers on Host
    subgraph "Docker Host"
        direction TB
        subgraph "Flask App (5000)"
            direction TB
            AppNode["Flask App"]:::container
            AppFile["app.py"]:::container
            DockerfileNode["Dockerfile"]:::container
        end
        subgraph "Node Exporter (9100)"
            NodeNode["Node Exporter"]:::container
        end
        subgraph "Prometheus (9090)"
            direction TB
            PromNode["Prometheus"]:::container
            PromConfig["prometheus.yml"]:::container
        end
        subgraph "Grafana (3000)"
            direction TB
            GrafNode["Grafana"]:::container
            GrafMain["grafana.ini"]:::container
            GrafDash["dashboards/"]:::container
            GrafProv["provisioning/"]:::container
        end
    end

    %% External Services
    SMTP["SMTP/Slack Endpoint"]:::external

    %% Flows
    TerraformCLI -->|AWS API calls| VPC
    TerraformCLI -->|AWS API calls| Subnet
    TerraformCLI -->|AWS API calls| IGW
    TerraformCLI -->|AWS API calls| SG
    TerraformCLI -->|AWS API calls| EC2
    backendTF -->|configure remote state| S3Bucket
    TerraformCLI -->|remote state usage| S3Bucket

    AppNode -->|"/metrics scrape 9090"| PromNode
    NodeNode -->|"/metrics scrape 9100"| PromNode
    PromNode -->|"query 9090/TCP"| GrafNode
    GrafNode -->|"alert notifications"| SMTP

    %% Click Events
    click mainTF "https://github.com/ankit-goyal-git/fincore-monitoring-project/blob/flask-app/terraform-fincore/main.tf"
    click backendTF "https://github.com/ankit-goyal-git/fincore-monitoring-project/blob/flask-app/terraform-fincore/backend.tf"
    click variablesTF "https://github.com/ankit-goyal-git/fincore-monitoring-project/blob/flask-app/terraform-fincore/variables.tf"
    click tfvars "https://github.com/ankit-goyal-git/fincore-monitoring-project/blob/flask-app/terraform-fincore/terraform.tfvars"
    click outputTF "https://github.com/ankit-goyal-git/fincore-monitoring-project/blob/flask-app/terraform-fincore/output.tf"
    click AppFile "https://github.com/ankit-goyal-git/fincore-monitoring-project/blob/flask-app/app.py"
    click DockerfileNode "https://github.com/ankit-goyal-git/fincore-monitoring-project/tree/flask-app/Dockerfile"
    click PromConfig "https://github.com/ankit-goyal-git/fincore-monitoring-project/blob/flask-app/prometheus.yml"
    click GrafMain "https://github.com/ankit-goyal-git/fincore-monitoring-project/blob/flask-app/grafana/grafana.ini"
    click GrafDash "https://github.com/ankit-goyal-git/fincore-monitoring-project/tree/flask-app/grafana/dashboards/"
    click GrafProv "https://github.com/ankit-goyal-git/fincore-monitoring-project/tree/flask-app/grafana/provisioning/"

    %% Legend
    subgraph Legend
        direction TB
        AW["AWS Resource"]:::aws
        CMP["Compute Host"]:::compute
        CNT["Container"]:::container
        EXT["External Service"]:::external
        IaC["Terraform Code"]:::iac
    end

    classDef aws fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef compute fill:#A9A9A9,stroke:#333,stroke-width:1px;
    classDef container fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef external fill:#DDA0DD,stroke:#333,stroke-width:1px;
    classDef iac fill:#F0E68C,stroke:#333,stroke-width:1px;
```
