How vanthorng/learn_aws_sqs works
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: CreateInvoiceImport.php Import creation · ProcessInvoiceImport.php Workbook processor · QuickBooksClient.php QuickBooks client · Team.php Team and membership
Components 26
Import Intake
- Import controller
app/Http/Controllers/InvoiceImportController.php - API intake
app/Http/Controllers/Api/InvoiceImportController.php - Scheduled imports
app/Http/Controllers/ScheduledImportController.php - Schedule dispatcher
app/Actions/Imports/DispatchScheduledImports.php - Import creation
app/Actions/Imports/CreateInvoiceImport.php
Import Processing
- Import state
app/Models/InvoiceImport.php - Workbook processor
app/Jobs/ProcessInvoiceImport.php - Spreadsheet reader
app/Services/InvoiceSpreadsheetReader.php - Outcome notifications
app/Actions/Imports/NotifyImportOutcome.php
QuickBooks
- QuickBooks connection
app/Http/Controllers/QuickBooks/QuickBooksAuthController.php - QuickBooks data operations
app/Http/Controllers/QuickBooks/QuickBooksDataController.php - QuickBooks client
app/Services/QuickBooks/QuickBooksClient.php - Import sync job
app/Jobs/SyncImportToQuickBooks.php
Teams And Access
- Team management
app/Http/Controllers/Teams/TeamController.php - Team and membership
app/Models/Team.php - Team API tokens
app/Models/TeamApiToken.php
Application Experience
- Inertia application
resources/js/app.ts - Import interface
resources/js/pages/imports/Index.vue - QuickBooks interface
resources/js/pages/quickbooks/Data.vue - Notification interface
resources/js/components/NotificationBell.vue
Other components
- Team user
- API client
- Private import storage
- Laravel queue
- QuickBooks Online
- Application database
Connections 31
- Team user → Inertia application: uses
README.md - Team user → API intake: submits workbook
README.md - Inertia application → Import interface: loads
- Import interface → Import controller: uploads
- Import controller → Import creation: creates import
app/Http/Controllers/InvoiceImportController.php - API intake → Import creation: creates import
app/Http/Controllers/Api/InvoiceImportController.php - Import creation → Workbook processor: dispatches
app/Actions/Imports/CreateInvoiceImport.php - Import creation → Import state: records import
app/Actions/Imports/CreateInvoiceImport.php - Import creation → Spreadsheet reader: validates workbook
app/Actions/Imports/CreateInvoiceImport.php - Workbook processor → Spreadsheet reader: reads workbook
- Workbook processor → Import state: updates status
- Workbook processor → Laravel queue: runs asynchronously
README.md - Import creation → Private import storage: stores workbook
README.md - Team user → Scheduled imports: schedules workbook
README.md - Scheduled imports → Schedule dispatcher: dispatches due imports
- Schedule dispatcher → Import creation: creates normal import
README.md - Workbook processor → Import sync job: starts optional sync
- Import sync job → QuickBooks client: calls
app/Jobs/SyncImportToQuickBooks.php - QuickBooks client → QuickBooks Online: sends API requests
app/Services/QuickBooks/QuickBooksClient.php - QuickBooks connection → QuickBooks client: uses
app/Http/Controllers/QuickBooks/QuickBooksAuthController.php - QuickBooks data operations → QuickBooks client: queries invoices
app/Http/Controllers/QuickBooks/QuickBooksDataController.php - QuickBooks data operations → Laravel queue: queues operations
app/Http/Controllers/QuickBooks/QuickBooksDataController.php - QuickBooks data operations → QuickBooks interface: serves operations
- Import sync job → Outcome notifications: reports outcome
app/Jobs/SyncImportToQuickBooks.php - Outcome notifications → Import state: reads import
app/Actions/Imports/NotifyImportOutcome.php - Team and membership → Application database: persists team data
- Import controller → Team and membership: checks team access
app/Http/Controllers/InvoiceImportController.php - Team management → Team and membership: manages teams
app/Http/Controllers/Teams/TeamController.php - API intake → Team API tokens: authenticates token
app/Http/Controllers/Api/InvoiceImportController.php - QuickBooks connection → Team and membership: stores team connection
app/Http/Controllers/QuickBooks/QuickBooksAuthController.php - Outcome notifications → Notification interface: surfaces unread alerts
README.md