# jayanth-999/devops-talentflow-project architecture

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

- Interactive diagram: https://gitdiagram.com/jayanth-999/devops-talentflow-project
- Repository: https://github.com/jayanth-999/devops-talentflow-project

## Overview

TalentFlow is a job marketplace: job seekers and employers use the frontend to register or sign in, browse postings, apply, and manage jobs. User and job services handle those domain stages, while Kafka events feed notification consumers that send and log email notifications. The tree and excerpts support the frontend/API, service, persistence, and event relationships shown; aggregator behavior and several notification internals are not excerpted, so their connections are omitted.

Main entry points: [`talentflow/services/frontend/src/services/api.ts`](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/services/api.ts) (API clients), [`talentflow/services/frontend/src/App.tsx`](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/App.tsx) (Application routes), [`talentflow/services/user-service/app/services/user_service.py`](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/services/user_service.py) (User operations), [`talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java`](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java) (Job & application operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Marketplace frontend"]
  node_app["Application routes<br/>[App.tsx]"]
  node_authpages["Login &amp; registration"]
  node_jobpages["Browse &amp; job detail"]
  node_dashboard["Dashboard<br/>[DashboardPage.tsx]"]
  node_apiclient["API clients<br/>[api.ts]"]
  node_authstate["Auth state<br/>[authStore.ts]"]
end

subgraph group_identity["Identity service"]
  node_userapi["User endpoints<br/>[users.py]"]
  node_usersvc["User operations<br/>[user_service.py]"]
  node_userdb[("User database<br/>[database.py]")]
  node_userentity["User model<br/>[user.py]"]
  node_usersecurity["Password security<br/>[security.py]"]
  node_userkafka["User event producer<br/>[kafka_producer.py]"]
end

subgraph group_jobs["Job marketplace"]
  node_jobapi["Job endpoints<br/>[JobController.java]"]
  node_joblogic["Job &amp; application operations<br/>[JobService.java]"]
  node_jobstore[("Job repository<br/>[JobRepository.java]")]
  node_applicationstore[("Application repository")]
  node_jobmodel["Job record<br/>[Job.java]"]
  node_applicationmodel["Application record<br/>[Application.java]"]
  node_jobevents["Job event producer"]
  node_jobaggregator["Job feed aggregator<br/>[job-sync.py]"]
end

subgraph group_notify["Notifications"]
  node_consumers["Event consumers"]
  node_email["Email delivery<br/>[EmailService.cs]"]
  node_notificationstore[("Notification logs")]
  node_notificationmodel["Notification record<br/>[NotificationLog.cs]"]
end

node_people(("Job seekers &amp; employers"))
node_broker["Kafka event broker"]

node_people -->|"uses"| node_app
node_app -->|"routes"| node_authpages
node_app -->|"routes"| node_jobpages
node_app -->|"protects"| node_dashboard
node_authpages -.->|"calls"| node_apiclient
node_jobpages -->|"calls"| node_apiclient
node_dashboard -->|"calls"| node_apiclient
node_app -->|"checks"| node_authstate
node_apiclient -->|"reads"| node_authstate
node_apiclient -.->|"HTTP requests"| node_userapi
node_apiclient -.->|"HTTP requests"| node_jobapi
node_userapi -->|"delegates"| node_usersvc
node_usersvc -.->|"queries"| node_userdb
node_usersvc -->|"creates &amp; reads"| node_userentity
node_usersvc -->|"hashes &amp; verifies"| node_usersecurity
node_usersvc -->|"publishes registration"| node_userkafka
node_userkafka -.->|"publishes"| node_broker
node_jobapi -->|"delegates"| node_joblogic
node_joblogic -->|"reads &amp; writes"| node_jobstore
node_joblogic -->|"reads &amp; writes"| node_applicationstore
node_joblogic -->|"publishes events"| node_jobevents
node_jobstore -->|"persists"| node_jobmodel
node_applicationstore -->|"persists"| node_applicationmodel
node_jobevents -.->|"publishes"| node_broker
node_broker -.->|"dispatches events"| node_consumers
node_consumers -.->|"sends email"| node_email
node_consumers -.->|"records outcome"| node_notificationstore
node_notificationstore -->|"stores"| node_notificationmodel

click node_app "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/App.tsx"
click node_authpages "https://github.com/jayanth-999/devops-talentflow-project/tree/main/talentflow/services/frontend/src/pages"
click node_jobpages "https://github.com/jayanth-999/devops-talentflow-project/tree/main/talentflow/services/frontend/src/pages"
click node_dashboard "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/pages/DashboardPage.tsx"
click node_apiclient "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/services/api.ts"
click node_authstate "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/store/authStore.ts"
click node_userapi "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/api/v1/endpoints/users.py"
click node_usersvc "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/services/user_service.py"
click node_userdb "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/core/database.py"
click node_userentity "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/models/user.py"
click node_usersecurity "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/core/security.py"
click node_userkafka "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/services/kafka_producer.py"
click node_jobapi "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/controller/JobController.java"
click node_joblogic "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java"
click node_jobstore "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/repository/JobRepository.java"
click node_applicationstore "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/repository/ApplicationRepository.java"
click node_jobmodel "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/model/Job.java"
click node_applicationmodel "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/model/Application.java"
click node_jobevents "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/kafka/JobEventProducer.java"
click node_consumers "https://github.com/jayanth-999/devops-talentflow-project/tree/main/talentflow/services/notification-service/src/NotificationService/Consumers"
click node_email "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/notification-service/src/NotificationService/Services/EmailService.cs"
click node_notificationstore "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/notification-service/src/NotificationService/Services/NotificationRepository.cs"
click node_notificationmodel "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/notification-service/src/NotificationService/Models/NotificationLog.cs"
click node_jobaggregator "https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/scripts/aggregator/job-sync.py"

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_app,node_authpages,node_jobpages,node_dashboard,node_apiclient,node_authstate toneBlue
class node_userapi,node_usersvc,node_userdb,node_userentity,node_usersecurity,node_userkafka toneAmber
class node_jobapi,node_joblogic,node_jobstore,node_applicationstore,node_jobmodel,node_applicationmodel,node_jobevents,node_jobaggregator toneMint
class node_consumers,node_email,node_notificationstore,node_notificationmodel toneRose
class node_people,node_broker toneIndigo
```

## Components

### Marketplace frontend

- [Application routes](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/App.tsx): `talentflow/services/frontend/src/App.tsx`
- [Login & registration](https://github.com/jayanth-999/devops-talentflow-project/tree/main/talentflow/services/frontend/src/pages): `talentflow/services/frontend/src/pages`
- [Browse & job detail](https://github.com/jayanth-999/devops-talentflow-project/tree/main/talentflow/services/frontend/src/pages): `talentflow/services/frontend/src/pages`
- [Dashboard](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/pages/DashboardPage.tsx): `talentflow/services/frontend/src/pages/DashboardPage.tsx`
- [API clients](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/services/api.ts): `talentflow/services/frontend/src/services/api.ts`
- [Auth state](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/frontend/src/store/authStore.ts): `talentflow/services/frontend/src/store/authStore.ts`

### Identity service

- [User endpoints](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/api/v1/endpoints/users.py): `talentflow/services/user-service/app/api/v1/endpoints/users.py`
- [User operations](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/services/user_service.py): `talentflow/services/user-service/app/services/user_service.py`
- [User database](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/core/database.py): `talentflow/services/user-service/app/core/database.py`
- [User model](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/models/user.py): `talentflow/services/user-service/app/models/user.py`
- [Password security](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/core/security.py): `talentflow/services/user-service/app/core/security.py`
- [User event producer](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/user-service/app/services/kafka_producer.py): `talentflow/services/user-service/app/services/kafka_producer.py`

### Job marketplace

- [Job endpoints](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/controller/JobController.java): `talentflow/services/job-service/src/main/java/com/talentflow/job/controller/JobController.java`
- [Job & application operations](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java): `talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java`
- [Job repository](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/repository/JobRepository.java): `talentflow/services/job-service/src/main/java/com/talentflow/job/repository/JobRepository.java`
- [Application repository](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/repository/ApplicationRepository.java): `talentflow/services/job-service/src/main/java/com/talentflow/job/repository/ApplicationRepository.java`
- [Job record](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/model/Job.java): `talentflow/services/job-service/src/main/java/com/talentflow/job/model/Job.java`
- [Application record](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/model/Application.java): `talentflow/services/job-service/src/main/java/com/talentflow/job/model/Application.java`
- [Job event producer](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/job-service/src/main/java/com/talentflow/job/kafka/JobEventProducer.java): `talentflow/services/job-service/src/main/java/com/talentflow/job/kafka/JobEventProducer.java`
- [Job feed aggregator](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/scripts/aggregator/job-sync.py): `talentflow/scripts/aggregator/job-sync.py`

### Notifications

- [Event consumers](https://github.com/jayanth-999/devops-talentflow-project/tree/main/talentflow/services/notification-service/src/NotificationService/Consumers): `talentflow/services/notification-service/src/NotificationService/Consumers`
- [Email delivery](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/notification-service/src/NotificationService/Services/EmailService.cs): `talentflow/services/notification-service/src/NotificationService/Services/EmailService.cs`
- [Notification logs](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/notification-service/src/NotificationService/Services/NotificationRepository.cs): `talentflow/services/notification-service/src/NotificationService/Services/NotificationRepository.cs`
- [Notification record](https://github.com/jayanth-999/devops-talentflow-project/blob/main/talentflow/services/notification-service/src/NotificationService/Models/NotificationLog.cs): `talentflow/services/notification-service/src/NotificationService/Models/NotificationLog.cs`

### Other components

- **Job seekers & employers**
- **Kafka event broker**

## Connections

- Job seekers & employers → Application routes: uses (evidence: `talentflow/services/frontend/src/App.tsx`)
- Application routes → Login & registration: routes (evidence: `talentflow/services/frontend/src/App.tsx`)
- Application routes → Browse & job detail: routes (evidence: `talentflow/services/frontend/src/App.tsx`)
- Application routes → Dashboard: protects (evidence: `talentflow/services/frontend/src/App.tsx`)
- Login & registration → API clients: calls (evidence: `talentflow/services/frontend/src/pages/JobsPage.tsx`)
- Browse & job detail → API clients: calls (evidence: `talentflow/services/frontend/src/pages/JobsPage.tsx`)
- Dashboard → API clients: calls (evidence: `talentflow/services/frontend/src/pages/DashboardPage.tsx`)
- Application routes → Auth state: checks (evidence: `talentflow/services/frontend/src/App.tsx`)
- API clients → Auth state: reads (evidence: `talentflow/services/frontend/src/services/api.ts`)
- API clients → User endpoints: HTTP requests
- API clients → Job endpoints: HTTP requests
- User endpoints → User operations: delegates (evidence: `talentflow/services/user-service/app/api/v1/endpoints/users.py`)
- User operations → User database: queries
- User operations → User model: creates & reads (evidence: `talentflow/services/user-service/app/services/user_service.py`)
- User operations → Password security: hashes & verifies (evidence: `talentflow/services/user-service/app/services/user_service.py`)
- User operations → User event producer: publishes registration (evidence: `talentflow/services/user-service/app/services/user_service.py`)
- User event producer → Kafka event broker: publishes
- Job endpoints → Job & application operations: delegates (evidence: `talentflow/services/job-service/src/main/java/com/talentflow/job/controller/JobController.java`)
- Job & application operations → Job repository: reads & writes (evidence: `talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java`)
- Job & application operations → Application repository: reads & writes (evidence: `talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java`)
- Job & application operations → Job event producer: publishes events (evidence: `talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java`)
- Job repository → Job record: persists (evidence: `talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java`)
- Application repository → Application record: persists (evidence: `talentflow/services/job-service/src/main/java/com/talentflow/job/service/JobService.java`)
- Job event producer → Kafka event broker: publishes
- Kafka event broker → Event consumers: dispatches events
- Event consumers → Email delivery: sends email
- Event consumers → Notification logs: records outcome
- Notification logs → Notification record: stores (evidence: `talentflow/services/notification-service/src/NotificationService/Services/NotificationRepository.cs`)
