# vanthorng/learn_aws_sqs architecture

> Architecture diagram of the GitHub repository vanthorng/learn_aws_sqs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vanthorng/learn_aws_sqs
- Repository: https://github.com/vanthorng/learn_aws_sqs

## Overview

Invoice Imports is a Laravel application for team-managed invoice workbook intake, asynchronous processing, QuickBooks Online operations, and status reporting. Users upload through the web UI or team API; scheduled work enters the same import path. The README documents private storage, queue workers, scheduled dispatch, notifications, and polling. Source excerpts confirm key controller, action, model, and client relationships; connections involving unsampled jobs and routes are shown only where documented or marked unverified.

Main entry points: [`app/Actions/Imports/CreateInvoiceImport.php`](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Actions/Imports/CreateInvoiceImport.php) (Import creation), [`app/Jobs/ProcessInvoiceImport.php`](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Jobs/ProcessInvoiceImport.php) (Workbook processor), [`app/Services/QuickBooks/QuickBooksClient.php`](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Services/QuickBooks/QuickBooksClient.php) (QuickBooks client), [`app/Models/Team.php`](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Models/Team.php) (Team and membership)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Import Intake"]
  node_web_import["Import controller"]
  node_api_import["API intake"]
  node_scheduled["Scheduled imports"]
  node_dispatch_scheduled["Schedule dispatcher"]
  node_create_import["Import creation"]
end

subgraph group_processing["Import Processing"]
  node_import_model["Import state<br/>[InvoiceImport.php]"]
  node_processor["Workbook processor"]
  node_spreadsheet["Spreadsheet reader"]
  node_notifications["Outcome notifications"]
end

subgraph group_accounting["QuickBooks"]
  node_qbo_auth["QuickBooks connection"]
  node_qbo_data["QuickBooks data operations"]
  node_qbo_client["QuickBooks client"]
  node_sync_job["Import sync job"]
end

subgraph group_teams["Teams And Access"]
  node_teams["Team management<br/>[TeamController.php]"]
  node_team_model["Team and membership<br/>[Team.php]"]
  node_api_tokens["Team API tokens<br/>[TeamApiToken.php]"]
end

subgraph group_experience["Application Experience"]
  node_web_app["Inertia application<br/>[app.ts]"]
  node_import_page["Import interface<br/>[Index.vue]"]
  node_quickbooks_page["QuickBooks interface<br/>[Data.vue]"]
  node_notifications_ui["Notification interface"]
end

node_user(("Team user"))
node_api_client(("API client"))
node_private_storage[("Private import storage")]
node_queue["Laravel queue"]
node_quickbooks{{"QuickBooks Online"}}
node_db[("Application database")]

node_user -->|"uses"| node_web_app
node_user -->|"submits workbook"| node_api_import
node_web_app -.->|"loads"| node_import_page
node_import_page -.->|"uploads"| node_web_import
node_web_import -->|"creates import"| node_create_import
node_api_import -->|"creates import"| node_create_import
node_create_import -->|"dispatches"| node_processor
node_create_import -->|"records import"| node_import_model
node_create_import -->|"validates workbook"| node_spreadsheet
node_processor -.->|"reads workbook"| node_spreadsheet
node_processor -.->|"updates status"| node_import_model
node_processor -->|"runs asynchronously"| node_queue
node_create_import -->|"stores workbook"| node_private_storage
node_user -->|"schedules workbook"| node_scheduled
node_scheduled -.->|"dispatches due imports"| node_dispatch_scheduled
node_dispatch_scheduled -->|"creates normal import"| node_create_import
node_processor -.->|"starts optional sync"| node_sync_job
node_sync_job -->|"calls"| node_qbo_client
node_qbo_client -->|"sends API requests"| node_quickbooks
node_qbo_auth -->|"uses"| node_qbo_client
node_qbo_data -.->|"queries invoices"| node_qbo_client
node_qbo_data -->|"queues operations"| node_queue
node_qbo_data -.->|"serves operations"| node_quickbooks_page
node_sync_job -->|"reports outcome"| node_notifications
node_notifications -->|"reads import"| node_import_model
node_team_model -.->|"persists team data"| node_db
node_web_import -.->|"checks team access"| node_team_model
node_teams -->|"manages teams"| node_team_model
node_api_import -.->|"authenticates token"| node_api_tokens
node_qbo_auth -.->|"stores team connection"| node_team_model
node_notifications -->|"surfaces unread alerts"| node_notifications_ui

click node_web_import "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/InvoiceImportController.php"
click node_api_import "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/Api/InvoiceImportController.php"
click node_scheduled "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/ScheduledImportController.php"
click node_dispatch_scheduled "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Actions/Imports/DispatchScheduledImports.php"
click node_create_import "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Actions/Imports/CreateInvoiceImport.php"
click node_import_model "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Models/InvoiceImport.php"
click node_processor "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Jobs/ProcessInvoiceImport.php"
click node_spreadsheet "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Services/InvoiceSpreadsheetReader.php"
click node_notifications "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Actions/Imports/NotifyImportOutcome.php"
click node_qbo_auth "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/QuickBooks/QuickBooksAuthController.php"
click node_qbo_data "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/QuickBooks/QuickBooksDataController.php"
click node_qbo_client "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Services/QuickBooks/QuickBooksClient.php"
click node_sync_job "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Jobs/SyncImportToQuickBooks.php"
click node_teams "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/Teams/TeamController.php"
click node_team_model "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Models/Team.php"
click node_api_tokens "https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Models/TeamApiToken.php"
click node_web_app "https://github.com/vanthorng/learn_aws_sqs/blob/main/resources/js/app.ts"
click node_import_page "https://github.com/vanthorng/learn_aws_sqs/blob/main/resources/js/pages/imports/Index.vue"
click node_quickbooks_page "https://github.com/vanthorng/learn_aws_sqs/blob/main/resources/js/pages/quickbooks/Data.vue"
click node_notifications_ui "https://github.com/vanthorng/learn_aws_sqs/blob/main/resources/js/components/NotificationBell.vue"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web_import,node_api_import,node_scheduled,node_dispatch_scheduled,node_create_import,node_user,node_api_client toneBlue
class node_import_model,node_processor,node_spreadsheet,node_notifications,node_private_storage,node_db toneAmber
class node_qbo_auth,node_qbo_data,node_qbo_client,node_sync_job toneMint
class node_teams,node_team_model,node_api_tokens,node_queue toneRose
class node_web_app,node_import_page,node_quickbooks_page,node_notifications_ui,node_quickbooks toneIndigo
```

## Components

### Import Intake

- [Import controller](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/InvoiceImportController.php): `app/Http/Controllers/InvoiceImportController.php`
- [API intake](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/Api/InvoiceImportController.php): `app/Http/Controllers/Api/InvoiceImportController.php`
- [Scheduled imports](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/ScheduledImportController.php): `app/Http/Controllers/ScheduledImportController.php`
- [Schedule dispatcher](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Actions/Imports/DispatchScheduledImports.php): `app/Actions/Imports/DispatchScheduledImports.php`
- [Import creation](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Actions/Imports/CreateInvoiceImport.php): `app/Actions/Imports/CreateInvoiceImport.php`

### Import Processing

- [Import state](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Models/InvoiceImport.php): `app/Models/InvoiceImport.php`
- [Workbook processor](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Jobs/ProcessInvoiceImport.php): `app/Jobs/ProcessInvoiceImport.php`
- [Spreadsheet reader](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Services/InvoiceSpreadsheetReader.php): `app/Services/InvoiceSpreadsheetReader.php`
- [Outcome notifications](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Actions/Imports/NotifyImportOutcome.php): `app/Actions/Imports/NotifyImportOutcome.php`

### QuickBooks

- [QuickBooks connection](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/QuickBooks/QuickBooksAuthController.php): `app/Http/Controllers/QuickBooks/QuickBooksAuthController.php`
- [QuickBooks data operations](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/QuickBooks/QuickBooksDataController.php): `app/Http/Controllers/QuickBooks/QuickBooksDataController.php`
- [QuickBooks client](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Services/QuickBooks/QuickBooksClient.php): `app/Services/QuickBooks/QuickBooksClient.php`
- [Import sync job](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Jobs/SyncImportToQuickBooks.php): `app/Jobs/SyncImportToQuickBooks.php`

### Teams And Access

- [Team management](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Http/Controllers/Teams/TeamController.php): `app/Http/Controllers/Teams/TeamController.php`
- [Team and membership](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Models/Team.php): `app/Models/Team.php`
- [Team API tokens](https://github.com/vanthorng/learn_aws_sqs/blob/main/app/Models/TeamApiToken.php): `app/Models/TeamApiToken.php`

### Application Experience

- [Inertia application](https://github.com/vanthorng/learn_aws_sqs/blob/main/resources/js/app.ts): `resources/js/app.ts`
- [Import interface](https://github.com/vanthorng/learn_aws_sqs/blob/main/resources/js/pages/imports/Index.vue): `resources/js/pages/imports/Index.vue`
- [QuickBooks interface](https://github.com/vanthorng/learn_aws_sqs/blob/main/resources/js/pages/quickbooks/Data.vue): `resources/js/pages/quickbooks/Data.vue`
- [Notification interface](https://github.com/vanthorng/learn_aws_sqs/blob/main/resources/js/components/NotificationBell.vue): `resources/js/components/NotificationBell.vue`

### Other components

- **Team user**
- **API client**
- **Private import storage**
- **Laravel queue**
- **QuickBooks Online**
- **Application database**

## Connections

- Team user → Inertia application: uses (evidence: `README.md`)
- Team user → API intake: submits workbook (evidence: `README.md`)
- Inertia application → Import interface: loads
- Import interface → Import controller: uploads
- Import controller → Import creation: creates import (evidence: `app/Http/Controllers/InvoiceImportController.php`)
- API intake → Import creation: creates import (evidence: `app/Http/Controllers/Api/InvoiceImportController.php`)
- Import creation → Workbook processor: dispatches (evidence: `app/Actions/Imports/CreateInvoiceImport.php`)
- Import creation → Import state: records import (evidence: `app/Actions/Imports/CreateInvoiceImport.php`)
- Import creation → Spreadsheet reader: validates workbook (evidence: `app/Actions/Imports/CreateInvoiceImport.php`)
- Workbook processor → Spreadsheet reader: reads workbook
- Workbook processor → Import state: updates status
- Workbook processor → Laravel queue: runs asynchronously (evidence: `README.md`)
- Import creation → Private import storage: stores workbook (evidence: `README.md`)
- Team user → Scheduled imports: schedules workbook (evidence: `README.md`)
- Scheduled imports → Schedule dispatcher: dispatches due imports
- Schedule dispatcher → Import creation: creates normal import (evidence: `README.md`)
- Workbook processor → Import sync job: starts optional sync
- Import sync job → QuickBooks client: calls (evidence: `app/Jobs/SyncImportToQuickBooks.php`)
- QuickBooks client → QuickBooks Online: sends API requests (evidence: `app/Services/QuickBooks/QuickBooksClient.php`)
- QuickBooks connection → QuickBooks client: uses (evidence: `app/Http/Controllers/QuickBooks/QuickBooksAuthController.php`)
- QuickBooks data operations → QuickBooks client: queries invoices (evidence: `app/Http/Controllers/QuickBooks/QuickBooksDataController.php`)
- QuickBooks data operations → Laravel queue: queues operations (evidence: `app/Http/Controllers/QuickBooks/QuickBooksDataController.php`)
- QuickBooks data operations → QuickBooks interface: serves operations
- Import sync job → Outcome notifications: reports outcome (evidence: `app/Jobs/SyncImportToQuickBooks.php`)
- Outcome notifications → Import state: reads import (evidence: `app/Actions/Imports/NotifyImportOutcome.php`)
- Team and membership → Application database: persists team data
- Import controller → Team and membership: checks team access (evidence: `app/Http/Controllers/InvoiceImportController.php`)
- Team management → Team and membership: manages teams (evidence: `app/Http/Controllers/Teams/TeamController.php`)
- API intake → Team API tokens: authenticates token (evidence: `app/Http/Controllers/Api/InvoiceImportController.php`)
- QuickBooks connection → Team and membership: stores team connection (evidence: `app/Http/Controllers/QuickBooks/QuickBooksAuthController.php`)
- Outcome notifications → Notification interface: surfaces unread alerts (evidence: `README.md`)
