# jaratran/applicationbase-spa-pwa architecture

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

- Interactive diagram: https://gitdiagram.com/jaratran/applicationbase-spa-pwa
- Repository: https://github.com/jaratran/applicationbase-spa-pwa

## Overview

This repository is a Vue progressive web app backed by a Laravel API, with login, profile and parameter features plus offline support. The user-facing flow starts in the SPA, which presents guest or authenticated layouts and views; client services communicate with API endpoints, while offline components preserve selected state and support synchronization. The tree and excerpts support several internal links, but route definitions and much of the frontend were not inspected, so API dispatch and some feature connections are left unverified or omitted.

Main entry points: [`routes/api.php`](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/routes/api.php) (API routes), [`public/frontend/src/App.vue`](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/App.vue) (Vue app), [`public/frontend/src/router/index.js`](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/router/index.js) (Client router), [`public/frontend/main.js`](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/main.js) (Client bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_spa["Vue app<br/>[App.vue]"]
  node_bootstrap["Client bootstrap<br/>[main.js]"]
  node_layouts["App layouts"]
  node_router["Client router<br/>[index.js]"]
  node_authview["Login view<br/>[LoginView.vue]"]
  node_profileview["Profile views<br/>[PerfilView.vue]"]
  node_dashboard["Dashboard view<br/>[DashboardView.vue]"]
end

subgraph group_offline["Offline support"]
  node_network["Network state<br/>[network.js]"]
  node_identity["Offline identity<br/>[offlineIdentity.js]"]
  node_sync["Sync service<br/>[syncService.js]"]
  node_outbox[("Offline outbox<br/>[outboxRepo.js]")]
  node_offlinecache[("Offline caches")]
  node_worker["Service worker<br/>[service-worker.js]"]
end

subgraph group_api["API features"]
  node_api["API routes<br/>[api.php]"]
  node_login["Login API"]
  node_profile["Profile API"]
  node_panel["Panel API"]
  node_admin["Admin context"]
  node_design["Design parameters"]
  node_locations["Location API"]
  node_catalogapi["Catalog API"]
end

subgraph group_domain["Domain data"]
  node_user_model["User model<br/>[User.php]"]
  node_region["Region model<br/>[Region.php]"]
  node_comuna["Comuna model<br/>[Comuna.php]"]
  node_designmodel["Design model"]
  node_operational["Operational parameters"]
  node_catalog["Catalog model<br/>[Catalogo.php]"]
  node_authz["Authorization gates"]
  node_viewprovider["View parameter setup"]
  node_seeders["Catalog and location seeders"]
end

node_user(("User"))

node_user -->|"uses"| node_spa
node_bootstrap -->|"mounts"| node_spa
node_spa -->|"updates"| node_network
node_spa -->|"selects"| node_layouts
node_bootstrap -->|"installs"| node_router
node_bootstrap -->|"loads"| node_identity
node_router -.->|"routes to"| node_authview
node_router -.->|"routes to"| node_profileview
node_router -.->|"routes to"| node_dashboard
node_spa -->|"messages"| node_worker
node_sync -->|"uses"| node_outbox
node_spa -.->|"requests"| node_api
node_api -.->|"dispatches"| node_login
node_api -.->|"dispatches"| node_profile
node_api -.->|"dispatches"| node_panel
node_api -.->|"dispatches"| node_admin
node_api -.->|"dispatches"| node_design
node_api -.->|"dispatches"| node_locations
node_api -.->|"dispatches"| node_catalogapi
node_profile -->|"queries"| node_user_model
node_profile -->|"loads relation"| node_comuna
node_locations -->|"queries"| node_region
node_locations -->|"loads relation"| node_comuna
node_design -->|"queries"| node_designmodel
node_authz -->|"checks roles"| node_user_model
node_viewprovider -->|"uses"| node_designmodel
node_viewprovider -->|"uses"| node_operational
node_user_model -->|"belongs to"| node_catalog
node_seeders -.->|"seeds"| node_catalog
node_seeders -.->|"seeds"| node_region

click node_spa "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/App.vue"
click node_bootstrap "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/main.js"
click node_layouts "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/layouts/AuthenticatedLayout.vue"
click node_router "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/router/index.js"
click node_authview "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/views/LoginView.vue"
click node_profileview "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/views/Perfil/PerfilView.vue"
click node_dashboard "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/views/DashboardView.vue"
click node_network "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/stores/network.js"
click node_identity "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/stores/offlineIdentity.js"
click node_sync "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/services/offline/syncService.js"
click node_outbox "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/services/offline/outboxRepo.js"
click node_offlinecache "https://github.com/jaratran/applicationbase-spa-pwa/tree/main/public/frontend/src/services/offline"
click node_worker "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/service-worker.js"
click node_api "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/routes/api.php"
click node_login "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/Auth/LoginController.php"
click node_profile "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/ProfileController.php"
click node_panel "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/PanelController.php"
click node_admin "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/Admin/AdminContextController.php"
click node_design "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/DesignParameterController.php"
click node_locations "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/Parametros/LocationController.php"
click node_catalogapi "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/Parametros/CatalogoController.php"
click node_user_model "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/User.php"
click node_region "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/Region.php"
click node_comuna "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/Comuna.php"
click node_designmodel "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/DesignParameter.php"
click node_operational "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/OperationalParameter.php"
click node_catalog "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/Catalogo.php"
click node_authz "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Providers/AuthServiceProvider.php"
click node_viewprovider "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Providers/ViewServiceProvider.php"
click node_seeders "https://github.com/jaratran/applicationbase-spa-pwa/blob/main/database/seeders/CatalogosSeeder.php"

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_spa,node_bootstrap,node_layouts,node_router,node_authview,node_profileview,node_dashboard,node_user toneBlue
class node_network,node_identity,node_sync,node_outbox,node_offlinecache,node_worker toneAmber
class node_api,node_login,node_profile,node_panel,node_admin,node_design,node_locations,node_catalogapi toneMint
class node_user_model,node_region,node_comuna,node_designmodel,node_operational,node_catalog,node_authz,node_viewprovider,node_seeders toneRose
```

## Components

### Web client

- [Vue app](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/App.vue): `public/frontend/src/App.vue`
- [Client bootstrap](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/main.js): `public/frontend/main.js`
- [App layouts](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/layouts/AuthenticatedLayout.vue): `public/frontend/src/layouts/AuthenticatedLayout.vue`
- [Client router](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/router/index.js): `public/frontend/src/router/index.js`
- [Login view](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/views/LoginView.vue): `public/frontend/src/views/LoginView.vue`
- [Profile views](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/views/Perfil/PerfilView.vue): `public/frontend/src/views/Perfil/PerfilView.vue`
- [Dashboard view](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/views/DashboardView.vue): `public/frontend/src/views/DashboardView.vue`

### Offline support

- [Network state](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/stores/network.js): `public/frontend/src/stores/network.js`
- [Offline identity](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/stores/offlineIdentity.js): `public/frontend/src/stores/offlineIdentity.js`
- [Sync service](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/services/offline/syncService.js): `public/frontend/src/services/offline/syncService.js`
- [Offline outbox](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/frontend/src/services/offline/outboxRepo.js): `public/frontend/src/services/offline/outboxRepo.js`
- [Offline caches](https://github.com/jaratran/applicationbase-spa-pwa/tree/main/public/frontend/src/services/offline): `public/frontend/src/services/offline`
- [Service worker](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/public/service-worker.js): `public/service-worker.js`

### API features

- [API routes](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/routes/api.php): `routes/api.php`
- [Login API](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/Auth/LoginController.php): `app/Http/Controllers/Api/Auth/LoginController.php`
- [Profile API](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/ProfileController.php): `app/Http/Controllers/Api/ProfileController.php`
- [Panel API](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/PanelController.php): `app/Http/Controllers/Api/PanelController.php`
- [Admin context](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/Admin/AdminContextController.php): `app/Http/Controllers/Api/Admin/AdminContextController.php`
- [Design parameters](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/DesignParameterController.php): `app/Http/Controllers/Api/DesignParameterController.php`
- [Location API](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/Parametros/LocationController.php): `app/Http/Controllers/Api/Parametros/LocationController.php`
- [Catalog API](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Http/Controllers/Api/Parametros/CatalogoController.php): `app/Http/Controllers/Api/Parametros/CatalogoController.php`

### Domain data

- [User model](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/User.php): `app/Models/User.php`
- [Region model](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/Region.php): `app/Models/Region.php`
- [Comuna model](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/Comuna.php): `app/Models/Comuna.php`
- [Design model](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/DesignParameter.php): `app/Models/DesignParameter.php`
- [Operational parameters](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/OperationalParameter.php): `app/Models/OperationalParameter.php`
- [Catalog model](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Models/Catalogo.php): `app/Models/Catalogo.php`
- [Authorization gates](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Providers/AuthServiceProvider.php): `app/Providers/AuthServiceProvider.php`
- [View parameter setup](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/app/Providers/ViewServiceProvider.php): `app/Providers/ViewServiceProvider.php`
- [Catalog and location seeders](https://github.com/jaratran/applicationbase-spa-pwa/blob/main/database/seeders/CatalogosSeeder.php): `database/seeders/CatalogosSeeder.php`

### Other components

- **User**

## Connections

- User → Vue app: uses
- Client bootstrap → Vue app: mounts (evidence: `public/frontend/main.js`)
- Vue app → Network state: updates (evidence: `public/frontend/src/App.vue`)
- Vue app → App layouts: selects (evidence: `public/frontend/src/App.vue`)
- Client bootstrap → Client router: installs (evidence: `public/frontend/main.js`)
- Client bootstrap → Offline identity: loads (evidence: `public/frontend/main.js`)
- Client router → Login view: routes to
- Client router → Profile views: routes to
- Client router → Dashboard view: routes to
- Vue app → Service worker: messages (evidence: `public/frontend/src/App.vue`)
- Sync service → Offline outbox: uses (evidence: `public/frontend/src/services/offline/syncService.js`)
- Vue app → API routes: requests
- API routes → Login API: dispatches
- API routes → Profile API: dispatches
- API routes → Panel API: dispatches
- API routes → Admin context: dispatches
- API routes → Design parameters: dispatches
- API routes → Location API: dispatches
- API routes → Catalog API: dispatches
- Profile API → User model: queries (evidence: `app/Http/Controllers/Api/ProfileController.php`)
- Profile API → Comuna model: loads relation (evidence: `app/Http/Controllers/Api/ProfileController.php`)
- Location API → Region model: queries (evidence: `app/Http/Controllers/Api/Parametros/LocationController.php`)
- Location API → Comuna model: loads relation (evidence: `app/Http/Controllers/Api/Parametros/LocationController.php`)
- Design parameters → Design model: queries (evidence: `app/Http/Controllers/Api/DesignParameterController.php`)
- Authorization gates → User model: checks roles (evidence: `app/Providers/AuthServiceProvider.php`)
- View parameter setup → Design model: uses (evidence: `app/Providers/ViewServiceProvider.php`)
- View parameter setup → Operational parameters: uses (evidence: `app/Providers/ViewServiceProvider.php`)
- User model → Catalog model: belongs to (evidence: `app/Models/User.php`)
- Catalog and location seeders → Catalog model: seeds
- Catalog and location seeders → Region model: seeds
