# stellarenam/jobrecommendationaichatweb architecture

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

- Interactive diagram: https://gitdiagram.com/stellarenam/jobrecommendationaichatweb
- Repository: https://github.com/stellarenam/jobrecommendationaichatweb

## Overview

This Vue single-page frontend supports a job-recommendation chat: users open the chat, browse or load session history, send a prompt, see an SSE-streamed assistant reply, and review recommended jobs in cards and a detail modal. The store coordinates session state and streaming; API and SSE modules handle backend communication. The README documents the backend’s RAG and model processing, but those backend internals are outside this repository. Edges reflect shown imports/calls or README-described HTTP behavior.

Main entry points: [`src/store/chat.js`](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/store/chat.js) (Chat state/actions), [`src/components/ChatWindow.vue`](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/ChatWindow.vue) (Conversation view), [`src/views/ChatPage.vue`](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/views/ChatPage.vue) (Chat page layout), [`src/router/index.js`](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/router/index.js) (Chat route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Chat application"]
  node_entry["Vue app shell<br/>[App.vue]"]
  node_routing["Chat route<br/>[index.js]"]
  node_page["Chat page layout<br/>[ChatPage.vue]"]
  node_sidebar["Session sidebar<br/>[ChatSidebar.vue]"]
  node_composer["Message composer<br/>[ChatInput.vue]"]
  node_window["Conversation view<br/>[ChatWindow.vue]"]
end

subgraph group_state["Conversation state"]
  node_store["Chat state/actions<br/>[chat.js]"]
end

subgraph group_transport["Backend communication"]
  node_history_api["History API<br/>[chat.js]"]
  node_stream["SSE parser<br/>[sse.js]"]
  node_jobs_api["Jobs API module<br/>[jobs.js]"]
end

subgraph group_results["Job recommendations"]
  node_recommendations["Recommended jobs<br/>[chat.js]"]
  node_jobcard["Job card<br/>[JobCard.vue]"]
  node_details["Job detail modal<br/>[ChatWindow.vue]"]
end

node_user(("Chat user"))
node_backend["Chat backend"]

node_user -->|"opens chat"| node_routing
node_routing -->|"route view"| node_entry
node_entry -->|"renders routes"| node_routing
node_routing -->|"routes to"| node_page
node_page -->|"renders"| node_sidebar
node_page -->|"renders"| node_window
node_page -->|"renders"| node_composer
node_sidebar -->|"loads sessions"| node_store
node_composer -->|"sends message"| node_store
node_window -->|"reads conversation"| node_store
node_store -->|"requests history"| node_history_api
node_history_api -->|"fetches history"| node_backend
node_store -->|"starts stream"| node_stream
node_stream -->|"posts SSE request"| node_backend
node_stream -->|"dispatches events"| node_store
node_store -->|"updates jobs"| node_recommendations
node_window -->|"renders cards"| node_jobcard
node_window -->|"opens details"| node_details
node_jobcard -->|"emits selection"| node_window
node_recommendations -->|"provides jobs"| node_window

click node_entry "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/App.vue"
click node_routing "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/router/index.js"
click node_page "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/views/ChatPage.vue"
click node_sidebar "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/ChatSidebar.vue"
click node_composer "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/ChatInput.vue"
click node_window "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/ChatWindow.vue"
click node_store "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/store/chat.js"
click node_history_api "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/api/chat.js"
click node_stream "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/utils/sse.js"
click node_jobs_api "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/api/jobs.js"
click node_recommendations "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/store/chat.js"
click node_jobcard "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/JobCard.vue"
click node_details "https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/ChatWindow.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_entry,node_routing,node_page,node_sidebar,node_composer,node_window,node_user toneBlue
class node_store toneAmber
class node_history_api,node_stream,node_jobs_api toneMint
class node_recommendations,node_jobcard,node_details toneRose
class node_backend toneIndigo
```

## Components

### Chat application

- [Vue app shell](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/App.vue): `src/App.vue`
- [Chat route](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/router/index.js): `src/router/index.js`
- [Chat page layout](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/views/ChatPage.vue): `src/views/ChatPage.vue`
- [Session sidebar](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/ChatSidebar.vue): `src/components/ChatSidebar.vue`
- [Message composer](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/ChatInput.vue): `src/components/ChatInput.vue`
- [Conversation view](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/ChatWindow.vue): `src/components/ChatWindow.vue`

### Conversation state

- [Chat state/actions](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/store/chat.js): `src/store/chat.js`

### Backend communication

- [History API](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/api/chat.js): `src/api/chat.js`
- [SSE parser](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/utils/sse.js): `src/utils/sse.js`
- [Jobs API module](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/api/jobs.js): `src/api/jobs.js`

### Job recommendations

- [Recommended jobs](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/store/chat.js): `src/store/chat.js`
- [Job card](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/JobCard.vue): `src/components/JobCard.vue`
- [Job detail modal](https://github.com/stellarenam/jobrecommendationaichatweb/blob/main/src/components/ChatWindow.vue): `src/components/ChatWindow.vue`

### Other components

- **Chat user**
- **Chat backend**

## Connections

- Chat user → Chat route: opens chat (evidence: `README.md`)
- Chat route → Vue app shell: route view (evidence: `src/main.js`)
- Vue app shell → Chat route: renders routes (evidence: `src/App.vue`)
- Chat route → Chat page layout: routes to (evidence: `src/router/index.js`)
- Chat page layout → Session sidebar: renders (evidence: `src/views/ChatPage.vue`)
- Chat page layout → Conversation view: renders (evidence: `src/views/ChatPage.vue`)
- Chat page layout → Message composer: renders (evidence: `src/views/ChatPage.vue`)
- Session sidebar → Chat state/actions: loads sessions (evidence: `src/components/ChatSidebar.vue`)
- Message composer → Chat state/actions: sends message (evidence: `src/components/ChatInput.vue`)
- Conversation view → Chat state/actions: reads conversation (evidence: `src/components/ChatWindow.vue`)
- Chat state/actions → History API: requests history (evidence: `src/store/chat.js`)
- History API → Chat backend: fetches history (evidence: `src/api/chat.js`)
- Chat state/actions → SSE parser: starts stream (evidence: `src/store/chat.js`)
- SSE parser → Chat backend: posts SSE request (evidence: `src/utils/sse.js`)
- SSE parser → Chat state/actions: dispatches events (evidence: `src/store/chat.js`)
- Chat state/actions → Recommended jobs: updates jobs (evidence: `src/store/chat.js`)
- Conversation view → Job card: renders cards (evidence: `src/components/ChatWindow.vue`)
- Conversation view → Job detail modal: opens details (evidence: `src/components/ChatWindow.vue`)
- Job card → Conversation view: emits selection (evidence: `src/components/JobCard.vue`)
- Recommended jobs → Conversation view: provides jobs (evidence: `src/components/ChatWindow.vue`)
