# phamhuy273/se347-smart-travel-planner architecture

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

- Interactive diagram: https://gitdiagram.com/phamhuy273/se347-smart-travel-planner
- Repository: https://github.com/phamhuy273/se347-smart-travel-planner

## Overview

Wanderflow is a travel-planning web application, with a Vue frontend and NestJS API backed by PostgreSQL/Prisma. The intended user journey spans account access, trip discovery and management, and itinerary planning; the README also documents maps, drag-and-drop ordering, and image uploads. The supplied backend domain folders and frontend view files appear to be scaffolding, so those capabilities are shown as documented product areas rather than confirmed implementations. Connections between frontend screens and API calls are not established by the excerpts.

Main entry points: [`frontend/src/router/index.ts`](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/router/index.ts) (Route handling), [`backend/src/app.module.ts`](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/app.module.ts) (Application module), [`backend/src/main.ts`](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/main.ts) (Nest API entry), [`frontend/src/services/api.client.ts`](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/services/api.client.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_vue_entry["Vue bootstrap<br/>[main.ts]"]
  node_app_shell["App shell<br/>[App.vue]"]
  node_routing["Route handling<br/>[index.ts]"]
  node_auth_views["Account screens"]
  node_landing_view["Landing screen<br/>[LandingView.vue]"]
  node_dashboard_view["Dashboard<br/>[DashboardView.vue]"]
  node_trips_view["Trip list<br/>[MyTripsView.vue]"]
  node_planner_view["Itinerary planner<br/>[PlannerView.vue]"]
  node_api_client["API client<br/>[api.client.ts]"]
  node_auth_state["Auth state<br/>[auth.store.ts]"]
end

subgraph group_backend["API runtime"]
  node_api_runtime["Nest API entry<br/>[main.ts]"]
  node_app_module["Application module<br/>[app.module.ts]"]
  node_hello_controller["Root controller<br/>[app.controller.ts]"]
  node_hello_service["Root service<br/>[app.service.ts]"]
  node_error_filter["Exception filter"]
  node_response_transform["Response transform"]
end

subgraph group_data["Persistence and media"]
  node_prisma_module["Prisma module<br/>[prisma.module.ts]"]
  node_prisma_service["Prisma client<br/>[prisma.service.ts]"]
  node_postgres[("PostgreSQL")]
  node_upload_module["Upload module<br/>[upload.module.ts]"]
  node_cloudinary_service["Cloudinary uploader"]
end

subgraph group_domain["Travel capabilities"]
  node_auth_domain["Authentication"]
  node_places_domain["Places"]
  node_trips_domain["Trip management"]
  node_planner_capability["Map and ordering<br/>[PlannerView.vue]"]
end

node_traveler(("Traveler"))
node_cloudinary["Cloudinary"]

node_traveler -->|"uses"| node_vue_entry
node_vue_entry -->|"mounts"| node_app_shell
node_vue_entry -->|"installs"| node_routing
node_app_shell -->|"renders routes"| node_routing
node_routing -->|"routes to"| node_auth_views
node_routing -->|"routes to"| node_landing_view
node_routing -->|"routes to"| node_dashboard_view
node_routing -->|"routes to"| node_trips_view
node_routing -->|"routes to"| node_planner_view
node_auth_views -.->|"uses"| node_auth_state
node_auth_views -.->|"may call"| node_api_client
node_trips_view -.->|"may call"| node_api_client
node_planner_view -.->|"may call"| node_api_client
node_traveler -->|"seeks account access"| node_auth_domain
node_traveler -->|"seeks places"| node_places_domain
node_traveler -->|"manages trips"| node_trips_domain
node_traveler -->|"plans itinerary"| node_planner_capability
node_planner_capability -.->|"uses map places"| node_places_domain
node_api_client -->|"sends requests"| node_api_runtime
node_api_runtime -->|"creates"| node_app_module
node_api_runtime -->|"registers"| node_error_filter
node_api_runtime -->|"registers"| node_response_transform
node_app_module -->|"registers"| node_hello_controller
node_app_module -->|"provides"| node_hello_service
node_hello_controller -->|"calls"| node_hello_service
node_app_module -->|"imports"| node_prisma_module
node_prisma_service -->|"connects"| node_postgres
node_app_module -->|"imports"| node_upload_module
node_upload_module -->|"provides"| node_cloudinary_service
node_cloudinary_service -->|"uploads files"| node_cloudinary

click node_vue_entry "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/main.ts"
click node_app_shell "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/App.vue"
click node_routing "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/router/index.ts"
click node_auth_views "https://github.com/phamhuy273/se347-smart-travel-planner/tree/main/frontend/src/views/auth"
click node_landing_view "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/landing/LandingView.vue"
click node_dashboard_view "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/dashboard/DashboardView.vue"
click node_trips_view "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/trips/MyTripsView.vue"
click node_planner_view "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/planner/PlannerView.vue"
click node_api_client "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/services/api.client.ts"
click node_auth_state "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/stores/auth.store.ts"
click node_api_runtime "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/main.ts"
click node_app_module "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/app.module.ts"
click node_hello_controller "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/app.controller.ts"
click node_hello_service "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/app.service.ts"
click node_error_filter "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/common/filters/http-exception.filter.ts"
click node_response_transform "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/common/interceptors/transform.interceptor.ts"
click node_auth_domain "https://github.com/phamhuy273/se347-smart-travel-planner/tree/main/backend/src/modules/auth"
click node_places_domain "https://github.com/phamhuy273/se347-smart-travel-planner/tree/main/backend/src/modules/places"
click node_trips_domain "https://github.com/phamhuy273/se347-smart-travel-planner/tree/main/backend/src/modules/trips"
click node_planner_capability "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/planner/PlannerView.vue"
click node_prisma_module "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/prisma/prisma.module.ts"
click node_prisma_service "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/prisma/prisma.service.ts"
click node_upload_module "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/common/upload/upload.module.ts"
click node_cloudinary_service "https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/common/upload/cloudinary.service.ts"

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_vue_entry,node_app_shell,node_routing,node_auth_views,node_landing_view,node_dashboard_view,node_trips_view,node_planner_view,node_api_client,node_auth_state toneBlue
class node_api_runtime,node_app_module,node_hello_controller,node_hello_service,node_error_filter,node_response_transform toneAmber
class node_prisma_module,node_prisma_service,node_postgres,node_upload_module,node_cloudinary_service toneMint
class node_auth_domain,node_places_domain,node_trips_domain,node_planner_capability toneRose
class node_traveler,node_cloudinary toneIndigo
```

## Components

### Web application

- [Vue bootstrap](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/main.ts): `frontend/src/main.ts`
- [App shell](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Route handling](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/router/index.ts): `frontend/src/router/index.ts`
- [Account screens](https://github.com/phamhuy273/se347-smart-travel-planner/tree/main/frontend/src/views/auth): `frontend/src/views/auth`
- [Landing screen](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/landing/LandingView.vue): `frontend/src/views/landing/LandingView.vue`
- [Dashboard](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/dashboard/DashboardView.vue): `frontend/src/views/dashboard/DashboardView.vue`
- [Trip list](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/trips/MyTripsView.vue): `frontend/src/views/trips/MyTripsView.vue`
- [Itinerary planner](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/planner/PlannerView.vue): `frontend/src/views/planner/PlannerView.vue`
- [API client](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/services/api.client.ts): `frontend/src/services/api.client.ts`
- [Auth state](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/stores/auth.store.ts): `frontend/src/stores/auth.store.ts`

### API runtime

- [Nest API entry](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/main.ts): `backend/src/main.ts`
- [Application module](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/app.module.ts): `backend/src/app.module.ts`
- [Root controller](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/app.controller.ts): `backend/src/app.controller.ts`
- [Root service](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/app.service.ts): `backend/src/app.service.ts`
- [Exception filter](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/common/filters/http-exception.filter.ts): `backend/src/common/filters/http-exception.filter.ts`
- [Response transform](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/common/interceptors/transform.interceptor.ts): `backend/src/common/interceptors/transform.interceptor.ts`

### Persistence and media

- [Prisma module](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/prisma/prisma.module.ts): `backend/src/prisma/prisma.module.ts`
- [Prisma client](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/prisma/prisma.service.ts): `backend/src/prisma/prisma.service.ts`
- **PostgreSQL**
- [Upload module](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/common/upload/upload.module.ts): `backend/src/common/upload/upload.module.ts`
- [Cloudinary uploader](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/backend/src/common/upload/cloudinary.service.ts): `backend/src/common/upload/cloudinary.service.ts`

### Travel capabilities

- [Authentication](https://github.com/phamhuy273/se347-smart-travel-planner/tree/main/backend/src/modules/auth): `backend/src/modules/auth`
- [Places](https://github.com/phamhuy273/se347-smart-travel-planner/tree/main/backend/src/modules/places): `backend/src/modules/places`
- [Trip management](https://github.com/phamhuy273/se347-smart-travel-planner/tree/main/backend/src/modules/trips): `backend/src/modules/trips`
- [Map and ordering](https://github.com/phamhuy273/se347-smart-travel-planner/blob/main/frontend/src/views/planner/PlannerView.vue): `frontend/src/views/planner/PlannerView.vue`

### Other components

- **Traveler**
- **Cloudinary**

## Connections

- Traveler → Vue bootstrap: uses (evidence: `README.md`)
- Vue bootstrap → App shell: mounts (evidence: `frontend/src/main.ts`)
- Vue bootstrap → Route handling: installs (evidence: `frontend/src/main.ts`)
- App shell → Route handling: renders routes (evidence: `frontend/src/App.vue`)
- Route handling → Account screens: routes to (evidence: `README.md`)
- Route handling → Landing screen: routes to (evidence: `README.md`)
- Route handling → Dashboard: routes to (evidence: `README.md`)
- Route handling → Trip list: routes to (evidence: `README.md`)
- Route handling → Itinerary planner: routes to (evidence: `README.md`)
- Account screens → Auth state: uses
- Account screens → API client: may call
- Trip list → API client: may call
- Itinerary planner → API client: may call
- Traveler → Authentication: seeks account access (evidence: `README.md`)
- Traveler → Places: seeks places (evidence: `README.md`)
- Traveler → Trip management: manages trips (evidence: `README.md`)
- Traveler → Map and ordering: plans itinerary (evidence: `README.md`)
- Map and ordering → Places: uses map places
- API client → Nest API entry: sends requests (evidence: `README.md`)
- Nest API entry → Application module: creates (evidence: `backend/src/main.ts`)
- Nest API entry → Exception filter: registers (evidence: `backend/src/main.ts`)
- Nest API entry → Response transform: registers (evidence: `backend/src/main.ts`)
- Application module → Root controller: registers (evidence: `backend/src/app.module.ts`)
- Application module → Root service: provides (evidence: `backend/src/app.module.ts`)
- Root controller → Root service: calls (evidence: `backend/src/app.controller.ts`)
- Application module → Prisma module: imports (evidence: `backend/src/app.module.ts`)
- Prisma client → PostgreSQL: connects (evidence: `backend/src/prisma/prisma.service.ts`)
- Application module → Upload module: imports (evidence: `backend/src/app.module.ts`)
- Upload module → Cloudinary uploader: provides (evidence: `backend/src/common/upload/upload.module.ts`)
- Cloudinary uploader → Cloudinary: uploads files (evidence: `backend/src/common/upload/cloudinary.service.ts`)
