# codeworks-fullstack/summer25_gregslist_vue architecture

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

- Interactive diagram: https://gitdiagram.com/codeworks-fullstack/summer25_gregslist_vue
- Repository: https://github.com/codeworks-fullstack/summer25_gregslist_vue

## Overview

1. This repository is a client-side Vue application scaffolded with Vite. The runtime entry point is `src/main.js`, which mounts `App.vue`, wires in global utilities, and pulls in the shared SCSS entrypoint under `src/assets/scss`.

2. The app is organized as a single-page application with route-level pages in `src/pages` and a router in `src/router.js`. The main navigation surfaces are `HomePage`, `CarsPage`, and `AccountPage`, which act as the top-level views for the app’s major workflows.

3. State is managed on the client through `src/AppState.js` plus the custom store helpers in `src/utils/Store.js`. This is the central reactive boundary for application data such as the active account, car records, and other shared UI/session state.

4. Domain data is modeled explicitly in `src/models/Account.js` and `src/models/Car.js`. These model classes define the shape of data flowing between services, state, and components, and help keep the UI layer separate from raw API payloads.

5. Backend communication is split into focused service modules under `src/services`. `AxiosService.js` centralizes HTTP client configuration, while `AuthService.js`, `AccountService.js`, and `CarsService.js` encapsulate feature-specific API calls. This keeps network logic out of components and makes the API boundary easy to diagram.

6. The app also has a real-time boundary through `src/services/SocketService.js`. Socket event handling is organized separately in `src/handlers/RoomHandler.js`, with registration helpers in `src/utils/registerGlobalSocketHandlers.js` and `src/utils/SocketHandler.js`. This indicates a websocket channel alongside normal HTTP requests.

7. The UI layer is component-driven and domain-specific. `Navbar.vue`, `Login.vue`, `CarListing.vue`, `CarForm.vue`, and `CarFormModal.vue` make up the main interface pieces, while `src/components/globals/Icon.vue` provides a reusable shared primitive. `Example.vue` appears to be a sample or starter component.

8. The likely main data flow is: user interaction in a page/component triggers a service call, the service talks to the backend via Axios or sockets, results update `AppState`, and Vue’s reactivity refreshes the view. This is the core loop to capture in an architecture diagram.

9. Authentication is a distinct subsystem. `Login.vue` works with `AuthService` and `AccountService`, and the presence of `AccountPage.vue` and the `Account` model suggests a session/account boundary that is shared across the app rather than embedded in each page.

10. The cars feature is another major domain boundary. `CarsPage.vue` likely orchestrates listing and editing flows, with `CarListing.vue` for display and `CarForm`/`CarFormModal` for create/update interactions, all backed by `CarsService` and the `Car` model.

11. Styling is centralized through SCSS under `src/assets/scss`, with `_variables.scss`, `_main.scss`, and `style.scss` forming the main visual system. Static assets live in `src/assets/img` and `public/img`, while `public/.nojekyll` suggests the app may be deployed to a static hosting target such as GitHub Pages.

12. Configuration and tooling are standard Vue/Vite frontend infrastructure: `vite.config.js` for build/dev behavior, `eslint.config.js` for linting, `jsconfig.json` for editor/path support, and `@types/shims-vue.d.ts` for Vue SFC typing. `src/env.js` likely centralizes environment-specific configuration values used by the services layer.

13. In diagram terms, the repository is a frontend shell with three clear boundaries: routed views, reusable UI components, and service-driven integration points to an external API and socket server. There is no backend implementation in this repo; the backend is an external dependency consumed through the service layer.

Main entry points: [`src/AppState.js`](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/AppState.js) (AppState), [`src/router.js`](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/router.js) (router), [`src/main.js`](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/main.js) (main.js), [`src/pages/CarsPage.vue`](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/pages/CarsPage.vue) (CarsPage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App Shell"]
  node_src_main_js["main.js<br/>entrypoint<br/>[main.js]"]
  node_src_app_vue["App<br/>root component<br/>[App.vue]"]
  node_src_router_js["router<br/>route config<br/>[router.js]"]
  node_src_pages_homepage_vue["HomePage<br/>[HomePage.vue]"]
  node_src_pages_carspage_vue["CarsPage<br/>[CarsPage.vue]"]
  node_src_pages_accountpage_vue["AccountPage<br/>[AccountPage.vue]"]
end

subgraph group_ui["UI Layer"]
  node_src_components_navbar_vue["Navbar<br/>navigation component<br/>[Navbar.vue]"]
  node_src_components_login_vue["Login<br/>auth component<br/>[Login.vue]"]
  node_src_components_carlisting_vue["CarListing<br/>listing component<br/>[CarListing.vue]"]
  node_src_components_carform_vue["CarForm<br/>editor component<br/>[CarForm.vue]"]
  node_src_components_carformmodal_vue["CarFormModal<br/>modal component<br/>[CarFormModal.vue]"]
  node_src_components_globals_icon_vue["Icon<br/>shared component<br/>[Icon.vue]"]
end

subgraph group_data["Data and Integration"]
  node_src_appstate_js[("AppState<br/>client state<br/>[AppState.js]")]
  node_src_utils_store_js["Store<br/>state helper<br/>[Store.js]"]
  node_src_models_account_js["Account<br/>model<br/>[Account.js]"]
  node_src_models_car_js["Car<br/>model<br/>[Car.js]"]
  node_src_services_axiosservice_js["AxiosService<br/>http client<br/>[AxiosService.js]"]
  node_src_services_authservice_js["AuthService<br/>auth api<br/>[AuthService.js]"]
  node_src_services_accountservice_js["AccountService<br/>account api<br/>[AccountService.js]"]
  node_src_services_carsservice_js["CarsService<br/>cars api<br/>[CarsService.js]"]
  node_src_services_socketservice_js["SocketService<br/>socket client<br/>[SocketService.js]"]
  node_src_handlers_roomhandler_js["RoomHandler<br/>socket handler<br/>[RoomHandler.js]"]
  node_src_utils_registerglobalsockethandlers_js["Socket reg<br/>socket bootstrap"]
  node_src_utils_sockethandler_js["SocketHandler<br/>socket helper<br/>[SocketHandler.js]"]
  node_src_utils_registerglobalcomponents_js["Comp reg<br/>component bootstrap"]
end

node_src_main_js -->|"mounts"| node_src_app_vue
node_src_main_js -->|"installs"| node_src_router_js
node_src_main_js -->|"initializes"| node_src_appstate_js
node_src_main_js -->|"registers"| node_src_utils_registerglobalcomponents_js
node_src_utils_registerglobalcomponents_js -->|"adds"| node_src_components_globals_icon_vue
node_src_app_vue -->|"uses"| node_src_components_navbar_vue
node_src_app_vue -->|"hosts"| node_src_router_js
node_src_router_js -->|"routes to"| node_src_pages_homepage_vue
node_src_router_js -->|"routes to"| node_src_pages_carspage_vue
node_src_router_js -->|"routes to"| node_src_pages_accountpage_vue
node_src_pages_homepage_vue -->|"uses"| node_src_components_login_vue
node_src_pages_carspage_vue -->|"uses"| node_src_components_carlisting_vue
node_src_pages_carspage_vue -->|"uses"| node_src_components_carformmodal_vue
node_src_components_carformmodal_vue -->|"wraps"| node_src_components_carform_vue
node_src_components_login_vue -->|"calls"| node_src_services_authservice_js
node_src_components_login_vue -->|"calls"| node_src_services_accountservice_js
node_src_components_login_vue -->|"updates"| node_src_appstate_js
node_src_components_carlisting_vue -->|"reads"| node_src_services_carsservice_js
node_src_components_carform_vue -->|"writes"| node_src_services_carsservice_js
node_src_services_authservice_js -->|"uses"| node_src_services_axiosservice_js
node_src_services_accountservice_js -->|"uses"| node_src_services_axiosservice_js
node_src_services_carsservice_js -->|"uses"| node_src_services_axiosservice_js
node_src_services_authservice_js -->|"returns"| node_src_models_account_js
node_src_services_accountservice_js -->|"returns"| node_src_models_account_js
node_src_services_carsservice_js -->|"returns"| node_src_models_car_js
node_src_appstate_js -->|"built on"| node_src_utils_store_js
node_src_appstate_js -->|"stores"| node_src_models_account_js
node_src_appstate_js -->|"stores"| node_src_models_car_js
node_src_utils_registerglobalsockethandlers_js -->|"uses"| node_src_utils_sockethandler_js
node_src_utils_registerglobalsockethandlers_js -->|"registers"| node_src_handlers_roomhandler_js
node_src_handlers_roomhandler_js -->|"listens to"| node_src_services_socketservice_js
node_src_services_socketservice_js -->|"uses"| node_src_utils_sockethandler_js
node_src_pages_accountpage_vue -->|"reads"| node_src_appstate_js
node_src_pages_carspage_vue -->|"reads"| node_src_appstate_js

click node_src_main_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/main.js"
click node_src_app_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/App.vue"
click node_src_router_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/router.js"
click node_src_pages_homepage_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/pages/HomePage.vue"
click node_src_pages_carspage_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/pages/CarsPage.vue"
click node_src_pages_accountpage_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/pages/AccountPage.vue"
click node_src_components_navbar_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/Navbar.vue"
click node_src_components_login_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/Login.vue"
click node_src_components_carlisting_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/CarListing.vue"
click node_src_components_carform_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/CarForm.vue"
click node_src_components_carformmodal_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/CarFormModal.vue"
click node_src_components_globals_icon_vue "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/globals/Icon.vue"
click node_src_appstate_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/AppState.js"
click node_src_utils_store_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/utils/Store.js"
click node_src_models_account_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/models/Account.js"
click node_src_models_car_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/models/Car.js"
click node_src_services_axiosservice_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/AxiosService.js"
click node_src_services_authservice_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/AuthService.js"
click node_src_services_accountservice_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/AccountService.js"
click node_src_services_carsservice_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/CarsService.js"
click node_src_services_socketservice_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/SocketService.js"
click node_src_handlers_roomhandler_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/handlers/RoomHandler.js"
click node_src_utils_registerglobalsockethandlers_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/utils/registerGlobalSocketHandlers.js"
click node_src_utils_sockethandler_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/utils/SocketHandler.js"
click node_src_utils_registerglobalcomponents_js "https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/utils/registerGlobalComponents.js"

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_src_main_js,node_src_app_vue,node_src_router_js,node_src_pages_homepage_vue,node_src_pages_carspage_vue,node_src_pages_accountpage_vue toneBlue
class node_src_components_navbar_vue,node_src_components_login_vue,node_src_components_carlisting_vue,node_src_components_carform_vue,node_src_components_carformmodal_vue,node_src_components_globals_icon_vue toneAmber
class node_src_appstate_js,node_src_utils_store_js,node_src_models_account_js,node_src_models_car_js,node_src_services_axiosservice_js,node_src_services_authservice_js,node_src_services_accountservice_js,node_src_services_carsservice_js,node_src_services_socketservice_js,node_src_handlers_roomhandler_js,node_src_utils_registerglobalsockethandlers_js,node_src_utils_sockethandler_js,node_src_utils_registerglobalcomponents_js toneMint
```

## Components

### App Shell

Runtime entry, root component, router, and routed views.

- [main.js](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/main.js): entrypoint · Vue app bootstrap and root mounting. · `src/main.js`
- [App](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/App.vue): root component · Top-level application shell. · `src/App.vue`
- [router](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/router.js): route config · SPA route definitions. · `src/router.js`
- [HomePage](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/pages/HomePage.vue): page · Landing and entry view. · `src/pages/HomePage.vue`
- [CarsPage](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/pages/CarsPage.vue): page · Cars workflow page. · `src/pages/CarsPage.vue`
- [AccountPage](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/pages/AccountPage.vue): page · Account and session view. · `src/pages/AccountPage.vue`

### UI Layer

Reusable visual components and domain-facing interface pieces.

- [Navbar](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/Navbar.vue): navigation component · Global app navigation. · `src/components/Navbar.vue`
- [Login](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/Login.vue): auth component · Authentication UI. · `src/components/Login.vue`
- [CarListing](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/CarListing.vue): listing component · Vehicle list display. · `src/components/CarListing.vue`
- [CarForm](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/CarForm.vue): editor component · Car create and edit form. · `src/components/CarForm.vue`
- [CarFormModal](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/CarFormModal.vue): modal component · Modal wrapper for car editing. · `src/components/CarFormModal.vue`
- [Icon](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/components/globals/Icon.vue): shared component · Reusable icon primitive. · `src/components/globals/Icon.vue`

### Data and Integration

Client state, domain models, HTTP, sockets, and helper utilities.

- [AppState](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/AppState.js): client state · Central reactive application state. · `src/AppState.js`
- [Store](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/utils/Store.js): state helper · Shared store/reactivity utilities. · `src/utils/Store.js`
- [Account](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/models/Account.js): model · Account domain shape. · `src/models/Account.js`
- [Car](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/models/Car.js): model · Car domain shape. · `src/models/Car.js`
- [AxiosService](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/AxiosService.js): http client · Shared HTTP configuration. · `src/services/AxiosService.js`
- [AuthService](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/AuthService.js): auth api · Authentication requests. · `src/services/AuthService.js`
- [AccountService](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/AccountService.js): account api · Account-related requests. · `src/services/AccountService.js`
- [CarsService](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/CarsService.js): cars api · Vehicle-related requests. · `src/services/CarsService.js`
- [SocketService](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/services/SocketService.js): socket client · WebSocket connection boundary. · `src/services/SocketService.js`
- [RoomHandler](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/handlers/RoomHandler.js): socket handler · Room/event handling. · `src/handlers/RoomHandler.js`
- [Socket reg](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/utils/registerGlobalSocketHandlers.js): socket bootstrap · Registers global socket handlers. · `src/utils/registerGlobalSocketHandlers.js`
- [SocketHandler](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/utils/SocketHandler.js): socket helper · Shared socket handler utilities. · `src/utils/SocketHandler.js`
- [Comp reg](https://github.com/codeworks-fullstack/summer25_gregslist_vue/blob/main/src/utils/registerGlobalComponents.js): component bootstrap · Registers global components. · `src/utils/registerGlobalComponents.js`

## Connections

- main.js → App: mounts · Bootstraps the root Vue component.
- main.js → router: installs · Wires routing into the app.
- main.js → AppState: initializes · Creates the shared client state boundary.
- main.js → Comp reg: registers · Loads global UI components.
- Comp reg → Icon: adds · Makes the shared icon available app-wide.
- App → Navbar: uses · Renders the persistent navigation shell.
- App → router: hosts · Displays route-level views.
- router → HomePage: routes to · Maps the home route.
- router → CarsPage: routes to · Maps the cars route.
- router → AccountPage: routes to · Maps the account route.
- HomePage → Login: uses · Home entry exposes login flow.
- CarsPage → CarListing: uses · Shows the cars list.
- CarsPage → CarFormModal: uses · Opens create/edit UI.
- CarFormModal → CarForm: wraps · Modal contains the editable form.
- Login → AuthService: calls · Submits authentication requests.
- Login → AccountService: calls · Fetches account/session data.
- Login → AppState: updates · Stores authenticated session state.
- CarListing → CarsService: reads · Loads vehicle data.
- CarForm → CarsService: writes · Creates and updates cars.
- AuthService → AxiosService: uses · Shares the HTTP client.
- AccountService → AxiosService: uses · Shares the HTTP client.
- CarsService → AxiosService: uses · Shares the HTTP client.
- AuthService → Account: returns · Produces account-shaped data.
- AccountService → Account: returns · Produces account-shaped data.
- CarsService → Car: returns · Produces car-shaped data.
- AppState → Store: built on · Uses the shared store helper.
- AppState → Account: stores · Holds account state.
- AppState → Car: stores · Holds car state.
- Socket reg → SocketHandler: uses · Common socket handler utilities.
- Socket reg → RoomHandler: registers · Attaches room event handling.
- RoomHandler → SocketService: listens to · Consumes socket events.
- SocketService → SocketHandler: uses · Shares socket helper behavior.
- AccountPage → AppState: reads · Displays current account state.
- CarsPage → AppState: reads · Coordinates shared cars state.
