# moralescr/atm-intellifastcash architecture

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

- Interactive diagram: https://gitdiagram.com/moralescr/atm-intellifastcash
- Repository: https://github.com/moralescr/atm-intellifastcash

## Overview

##### Project Type and Purpose
- Type: Front-end single-page application (Vue.js).
- Purpose: Allow bank customers to submit ATM transaction requests and view transaction history and details via a web UI. The app is served statically (e.g. Netlify) and communicates with a backend REST API.

##### Main Components
a. User & Client
- Browser (Desktop or Mobile)
b. Static Hosting
- Netlify (or any CDN/static server) serving index.html + compiled JS/CSS
c. Vue.js Application
- Core: App.vue + main.js
- Router (vue-router)
- UI Library (Vuetify)
d. UI Components
- TransactionList.vue
- CreateTransaction.vue
- TransactionDetail.vue
- GeneratePdf.vue
- AppSnackBar.vue
- FooterView.vue
- AboutView.vue
e. Client-Side Services
- Axios plugin for HTTP calls
- parseData.js (data transformation)
f. External Backend/API
- REST endpoints (e.g., GET /transactions, POST /transactions)
- Database (not in this repo but part of the overall system)
g. Optional: PDF generation library (jsPDF or browser’s Blob API)

##### Relationships & Data Flow
1. The user interacts with UI components in the browser.
2. Components dispatch HTTP requests via the Axios plugin.
3. Axios sends/receives JSON from the external ATM backend service.
4. parseData.js transforms raw response data into the format components expect.
5. GeneratePdf.vue invokes PDF-generation logic in-browser.
6. Browser downloads or displays the generated PDF.
7. All static assets (JS/CSS/HTML) are delivered by Netlify/CDN.

##### Architectural Patterns & Design Principles
- Component-Based UI: Each Vue component has a single responsibility.
- Plugin Pattern: axios.js and vuetify.js plugins initialize cross-cutting services.
- SPA Routing: vue-router manages view navigation without full page reloads.
- Separation of Concerns:
- UI layer in /components and /views
- Data fetching/configuration in /plugins/axios.js
- Data parsing in /js/parseData.js
- Static Hosting + Client-side Rendering.

## Diagram (Mermaid)

```mermaid
flowchart TD
    U((User)):::client
    B[/"Vue.js SPA"/]:::browser
    U -->|"UI Interaction"| B

    subgraph "SPA Core"
        Core["App.vue / main.js"]:::core
        Router["Router (/router/index.js)"]:::core
        PluginsAx["Axios Plugin"]:::core
        PluginsVu["Vuetify Plugin"]:::core
        Util["parseData.js"]:::core
        subgraph "UI Components"
            TList["TransactionList.vue"]:::ui
            CTrans["CreateTransaction.vue"]:::ui
            TDetail["TransactionDetail.vue"]:::ui
            GPdf["GeneratePdf.vue"]:::ui
            Snackbar["AppSnackBar.vue"]:::ui
            Footer["FooterView.vue"]:::ui
            About["AboutView.vue"]:::ui
        end
    end

    B -->|renders SPA| Core
    Core --> Router
    Core --> PluginsAx
    Core --> PluginsVu
    Core --> Util
    Core -->|"loads components"| TList
    Core --> CTrans
    Core --> TDetail
    Core --> GPdf
    Core --> Snackbar
    Core --> Footer
    Core --> About

    subgraph "Static Hosting"
        Static[("Netlify / Static Server\nindex.html + assets")]:::static
    end
    B <-->|"GET index.html, JS, CSS"| Static

    API["ATM REST API"]:::external
    DB[(Database)]:::external
    PluginsAx -->|"GET/POST JSON"| API
    API -->|"reads/writes"| DB

    classDef client fill:#D0E8FF,stroke:#0085FF
    classDef browser fill:#DDEEFF,stroke:#004477
    classDef core fill:#FFF4C1,stroke:#E1C95D
    classDef ui fill:#FFFFFF,stroke:#333333
    classDef static fill:#DAF5D4,stroke:#3C8D0D
    classDef external fill:#F8D7DA,stroke:#C82333

    click Core "https://github.com/moralescr/atm-intellifastcash/blob/main/src/App.vue"
    click Core "https://github.com/moralescr/atm-intellifastcash/blob/main/src/main.js"
    click Router "https://github.com/moralescr/atm-intellifastcash/blob/main/src/router/index.js"
    click PluginsAx "https://github.com/moralescr/atm-intellifastcash/blob/main/src/plugins/axios.js"
    click PluginsVu "https://github.com/moralescr/atm-intellifastcash/blob/main/src/plugins/vuetify.js"
    click Util "https://github.com/moralescr/atm-intellifastcash/blob/main/src/js/parseData.js"
    click TList "https://github.com/moralescr/atm-intellifastcash/blob/main/src/components/transaction-list.vue"
    click CTrans "https://github.com/moralescr/atm-intellifastcash/blob/main/src/components/create-transaction.vue"
    click TDetail "https://github.com/moralescr/atm-intellifastcash/blob/main/src/components/transaction-detail.vue"
    click GPdf "https://github.com/moralescr/atm-intellifastcash/blob/main/src/components/generate-pdf.vue"
    click Snackbar "https://github.com/moralescr/atm-intellifastcash/blob/main/src/components/app-snack-bar.vue"
    click Footer "https://github.com/moralescr/atm-intellifastcash/blob/main/src/views/footer-view.vue"
    click About "https://github.com/moralescr/atm-intellifastcash/blob/main/src/views/AboutView.vue"
    click Static "https://github.com/moralescr/atm-intellifastcash/blob/main/public/index.html"
```
