# techx-team-project/intervue architecture

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

- Interactive diagram: https://gitdiagram.com/techx-team-project/intervue
- Repository: https://github.com/techx-team-project/intervue

## Overview

InterVue combines a career-oriented frontend—job and company discovery, career guidance, articles, CV templates, and candidate profiles—with a Java backend whose evidenced runtime workflow handles account registration and token issuance. The README confirms the register API and its access-token/refresh-cookie response; sampled backend code shows how registration reaches persistence and token services. Most frontend feature modules are represented at their page or view level because their runtime wiring was not sampled, so frontend relationships are not inferred.

Main entry points: [`backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserService.java`](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserService.java) (User registration), [`backend/src/main/java/com/techx/intervue/modules/user/services/impl/RefreshTokenService.java`](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/RefreshTokenService.java) (Refresh tokens), [`backend/src/main/java/com/techx/intervue/modules/user/controllers/AuthController.java`](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/controllers/AuthController.java) (Registration API), [`backend/src/main/java/com/techx/intervue/modules/user/repositories/RefreshTokenRepository.java`](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/repositories/RefreshTokenRepository.java) (Refresh repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Career frontend"]
  node_home["Home discovery<br/>[page.tsx]"]
  node_job["Job details<br/>[page.tsx]"]
  node_company["Company details<br/>[page.tsx]"]
  node_candidate["Candidate profile<br/>[page.tsx]"]
  node_cvlist["CV templates<br/>[page.tsx]"]
  node_cvdetail["Template detail<br/>[page.tsx]"]
  node_cvpreview["CV preview<br/>[CvPaperPreview.tsx]"]
  node_authpages["Login and register<br/>[page.tsx]"]
end

subgraph group_content["Guidance content"]
  node_blog["Blog<br/>[page.tsx]"]
  node_blogcategory["Blog categories<br/>[page.tsx]"]
  node_blogarticle["Blog articles<br/>[page.tsx]"]
  node_careers["Career guidance<br/>[page.tsx]"]
  node_careerarticle["Career articles<br/>[page.tsx]"]
end

subgraph group_identity["Identity backend"]
  node_authcontroller["Registration API"]
  node_userservice["User registration<br/>[UserService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_refreshservice["Refresh tokens"]
  node_sessioncache["User session cache"]
  node_tokenhash["Token hashing<br/>[TokenHashUtil.java]"]
end

subgraph group_persistence["Identity persistence"]
  node_userrepo[("User repository")]
  node_refreshrepo[("Refresh repository")]
  node_refreshentity["Refresh token record<br/>[RefreshToken.java]"]
end

node_visitor(("Visitor"))

node_userservice -->|"checks and saves"| node_userrepo
node_userservice -->|"generates token"| node_jwt
node_userservice -->|"issues refresh token"| node_refreshservice
node_userservice -->|"sets session"| node_sessioncache
node_authcontroller -->|"registers user"| node_userservice
node_refreshservice -->|"stores and looks up"| node_refreshrepo
node_refreshservice -->|"hashes tokens"| node_tokenhash
node_refreshrepo -->|"persists"| node_refreshentity
node_visitor -.->|"visits"| node_home
node_visitor -.->|"opens"| node_job
node_visitor -.->|"opens"| node_company
node_visitor -.->|"views"| node_candidate
node_visitor -.->|"browses"| node_blog
node_visitor -.->|"browses"| node_blogcategory
node_visitor -.->|"reads"| node_blogarticle
node_visitor -.->|"browses"| node_careers
node_visitor -.->|"reads"| node_careerarticle
node_visitor -.->|"browses"| node_cvlist
node_visitor -.->|"opens"| node_cvdetail
node_visitor -.->|"previews"| node_cvpreview
node_visitor -.->|"authenticates"| node_authpages
node_visitor -->|"registers via API"| node_authcontroller

click node_home "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/page.tsx"
click node_job "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/jobs/%5Bid%5D/page.tsx"
click node_company "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/companies/%5Bid%5D/page.tsx"
click node_candidate "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/candidate/profile/page.tsx"
click node_blog "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/blog/page.tsx"
click node_blogcategory "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/blog/%5Bcategory%5D/page.tsx"
click node_blogarticle "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/blog/%5Bcategory%5D/%5Bslug%5D/page.tsx"
click node_careers "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/career-orientation/page.tsx"
click node_careerarticle "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/career-orientation/%5Bslug%5D/page.tsx"
click node_cvlist "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/cv-templates/page.tsx"
click node_cvdetail "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/cv-templates/%5Bslug%5D/page.tsx"
click node_cvpreview "https://github.com/techx-team-project/intervue/blob/dev/frontend/components/cv-templates/CvPaperPreview.tsx"
click node_authpages "https://github.com/techx-team-project/intervue/blob/dev/frontend/app/auth/page.tsx"
click node_authcontroller "https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/controllers/AuthController.java"
click node_userservice "https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserService.java"
click node_jwt "https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/JwtService.java"
click node_refreshservice "https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/RefreshTokenService.java"
click node_sessioncache "https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserSessionCache.java"
click node_userrepo "https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/repositories/UserRepository.java"
click node_refreshrepo "https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/repositories/RefreshTokenRepository.java"
click node_refreshentity "https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/entities/RefreshToken.java"
click node_tokenhash "https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/helpers/TokenHashUtil.java"

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_home,node_job,node_company,node_candidate,node_cvlist,node_cvdetail,node_cvpreview,node_authpages toneBlue
class node_blog,node_blogcategory,node_blogarticle,node_careers,node_careerarticle toneAmber
class node_authcontroller,node_userservice,node_jwt,node_refreshservice,node_sessioncache,node_tokenhash toneMint
class node_userrepo,node_refreshrepo,node_refreshentity toneRose
class node_visitor toneIndigo
```

## Components

### Career frontend

- [Home discovery](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/page.tsx): `frontend/app/page.tsx`
- [Job details](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/jobs/%5Bid%5D/page.tsx): `frontend/app/jobs/[id]/page.tsx`
- [Company details](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/companies/%5Bid%5D/page.tsx): `frontend/app/companies/[id]/page.tsx`
- [Candidate profile](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/candidate/profile/page.tsx): `frontend/app/candidate/profile/page.tsx`
- [CV templates](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/cv-templates/page.tsx): `frontend/app/cv-templates/page.tsx`
- [Template detail](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/cv-templates/%5Bslug%5D/page.tsx): `frontend/app/cv-templates/[slug]/page.tsx`
- [CV preview](https://github.com/techx-team-project/intervue/blob/dev/frontend/components/cv-templates/CvPaperPreview.tsx): `frontend/components/cv-templates/CvPaperPreview.tsx`
- [Login and register](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/auth/page.tsx): `frontend/app/auth/page.tsx`

### Guidance content

- [Blog](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/blog/page.tsx): `frontend/app/blog/page.tsx`
- [Blog categories](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/blog/%5Bcategory%5D/page.tsx): `frontend/app/blog/[category]/page.tsx`
- [Blog articles](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/blog/%5Bcategory%5D/%5Bslug%5D/page.tsx): `frontend/app/blog/[category]/[slug]/page.tsx`
- [Career guidance](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/career-orientation/page.tsx): `frontend/app/career-orientation/page.tsx`
- [Career articles](https://github.com/techx-team-project/intervue/blob/dev/frontend/app/career-orientation/%5Bslug%5D/page.tsx): `frontend/app/career-orientation/[slug]/page.tsx`

### Identity backend

- [Registration API](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/controllers/AuthController.java): `backend/src/main/java/com/techx/intervue/modules/user/controllers/AuthController.java`
- [User registration](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserService.java): `backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserService.java`
- [JWT service](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/JwtService.java): `backend/src/main/java/com/techx/intervue/modules/user/services/impl/JwtService.java`
- [Refresh tokens](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/RefreshTokenService.java): `backend/src/main/java/com/techx/intervue/modules/user/services/impl/RefreshTokenService.java`
- [User session cache](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserSessionCache.java): `backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserSessionCache.java`
- [Token hashing](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/helpers/TokenHashUtil.java): `backend/src/main/java/com/techx/intervue/modules/helpers/TokenHashUtil.java`

### Identity persistence

- [User repository](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/repositories/UserRepository.java): `backend/src/main/java/com/techx/intervue/modules/user/repositories/UserRepository.java`
- [Refresh repository](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/repositories/RefreshTokenRepository.java): `backend/src/main/java/com/techx/intervue/modules/user/repositories/RefreshTokenRepository.java`
- [Refresh token record](https://github.com/techx-team-project/intervue/blob/dev/backend/src/main/java/com/techx/intervue/modules/user/entities/RefreshToken.java): `backend/src/main/java/com/techx/intervue/modules/user/entities/RefreshToken.java`

### Other components

- **Visitor**

## Connections

- User registration → User repository: checks and saves (evidence: `backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserService.java`)
- User registration → JWT service: generates token (evidence: `backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserService.java`)
- User registration → Refresh tokens: issues refresh token (evidence: `backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserService.java`)
- User registration → User session cache: sets session (evidence: `backend/src/main/java/com/techx/intervue/modules/user/services/impl/UserService.java`)
- Registration API → User registration: registers user (evidence: `backend/src/main/java/com/techx/intervue/modules/user/controllers/AuthController.java`)
- Refresh tokens → Refresh repository: stores and looks up (evidence: `backend/src/main/java/com/techx/intervue/modules/user/services/impl/RefreshTokenService.java`)
- Refresh tokens → Token hashing: hashes tokens (evidence: `backend/src/main/java/com/techx/intervue/modules/user/services/impl/RefreshTokenService.java`)
- Refresh repository → Refresh token record: persists (evidence: `backend/src/main/java/com/techx/intervue/modules/user/repositories/RefreshTokenRepository.java`)
- Visitor → Home discovery: visits
- Visitor → Job details: opens
- Visitor → Company details: opens
- Visitor → Candidate profile: views
- Visitor → Blog: browses
- Visitor → Blog categories: browses
- Visitor → Blog articles: reads
- Visitor → Career guidance: browses
- Visitor → Career articles: reads
- Visitor → CV templates: browses
- Visitor → Template detail: opens
- Visitor → CV preview: previews
- Visitor → Login and register: authenticates
- Visitor → Registration API: registers via API
