# fangyaocneu/ai-job-agent architecture

> Architecture diagram of the GitHub repository fangyaocneu/ai-job-agent, 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/fangyaocneu/ai-job-agent
- Repository: https://github.com/fangyaocneu/ai-job-agent

## Overview

AI Job Agent combines automated job discovery and multi-stage candidate matching with application tracking, resume-grounded chat, and an agent activity dashboard. The primary workflow collects and stores jobs, evaluates fit through filtering, analysis, matching, and strategy, then exposes results for candidate review. Chat separately routes a user request, selects tools, retrieves relevant profile or resume data, and returns a response. The README documents several workflows whose implementation files were not sampled; those links are marked unverified rather than inferred as source-level calls.

Main entry points: [`src/main/java/com.fangyao.agent/AgentCoordinator.java`](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/AgentCoordinator.java) (Agent coordinator), [`src/main/java/com.fangyao.agent/ChatService.java`](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatService.java) (Chat orchestration), [`src/main/java/com.fangyao.agent/JobRepository.java`](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobRepository.java) (Job repository), [`frontend/src/App.jsx`](https://github.com/fangyaocneu/ai-job-agent/blob/main/frontend/src/App.jsx) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Job discovery"]
  node_ingestion["Job ingestion"]
  node_source_adapters["Source adapters<br/>[com.fangyao.agent]"]
end

subgraph group_matching["Matching workflow"]
  node_coordinator["Agent coordinator"]
  node_prefilter["Pre-filter"]
  node_analysis["Job analysis"]
  node_match["Candidate match<br/>[MatchAgent.java]"]
  node_strategy["Application strategy<br/>[StrategyAgent.java]"]
end

subgraph group_candidate["Candidate services"]
  node_profile["Candidate profile"]
  node_resume["Resume processing<br/>[ResumeService.java]"]
  node_chunking["Resume chunks"]
  node_embedding["Embedding service"]
  node_rag["Resume retrieval"]
  node_chat_service["Chat orchestration<br/>[ChatService.java]"]
  node_intent_router["Intent router"]
  node_tools["Chat tools"]
  node_email["Email delivery<br/>[EmailService.java]"]
end

subgraph group_api["API and persistence"]
  node_jobs["Job records<br/>[Job.java]"]
  node_job_store[("Job repository<br/>[JobRepository.java]")]
  node_result_store[("Agent results")]
  node_profile_store[("Profile repository")]
  node_chunk_store[("Resume chunk store")]
  node_chat_api["Chat endpoint"]
  node_conversation_store[("Conversation store")]
  node_message_store[("Message and trace store")]
  node_job_api["Job API<br/>[JobController.java]"]
end

subgraph group_frontend["Candidate interface"]
  node_chat_ui["Chat interface<br/>[Chat.jsx]"]
  node_app_ui["Dashboard<br/>[App.jsx]"]
  node_insights_ui["Agent insights<br/>[AgentInsights.jsx]"]
end

node_user(("Candidate"))
node_job_sources["Job sources"]
node_openai["OpenAI"]

node_user -->|"asks"| node_chat_ui
node_chat_ui -.->|"sends chat"| node_chat_api
node_chat_api -->|"delegates to"| node_chat_service
node_chat_service -->|"routes intent"| node_intent_router
node_chat_service -->|"executes tools"| node_tools
node_chat_service -->|"retrieves resume"| node_rag
node_chat_service -->|"loads conversations"| node_conversation_store
node_chat_service -->|"persists messages"| node_message_store
node_chat_service -.->|"reasons with"| node_openai
node_tools -->|"reads jobs"| node_job_store
node_tools -->|"reads profile"| node_profile_store
node_user -->|"reviews results"| node_app_ui
node_app_ui -->|"renders"| node_chat_ui
node_app_ui -->|"renders"| node_insights_ui
node_app_ui -.->|"loads job data"| node_job_api
node_insights_ui -.->|"shows activity"| node_user
node_job_sources -.->|"provides postings"| node_source_adapters
node_source_adapters -.->|"supplies jobs"| node_ingestion
node_ingestion -.->|"stores postings"| node_job_store
node_job_store -->|"maps records"| node_jobs
node_job_store -.->|"provides jobs"| node_coordinator
node_coordinator -.->|"filters jobs"| node_prefilter
node_coordinator -.->|"analyzes jobs"| node_analysis
node_coordinator -.->|"scores fit"| node_match
node_coordinator -.->|"plans applications"| node_strategy
node_coordinator -.->|"persists results"| node_result_store
node_profile_store -->|"maps profile"| node_profile
node_user -.->|"uploads resume"| node_resume
node_resume -->|"chunks text"| node_chunking
node_chunking -->|"embeds chunks"| node_embedding
node_chunking -->|"stores chunks"| node_chunk_store
node_rag -->|"embeds query"| node_embedding
node_rag -->|"searches vectors"| node_chunk_store
node_embedding -->|"requests embeddings"| node_openai
node_job_api -->|"reads jobs"| node_job_store
node_coordinator -.->|"sends updates"| node_email

click node_ingestion "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobIngestionService.java"
click node_source_adapters "https://github.com/fangyaocneu/ai-job-agent/tree/main/src/main/java/com.fangyao.agent"
click node_jobs "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/Job.java"
click node_job_store "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobRepository.java"
click node_coordinator "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/AgentCoordinator.java"
click node_prefilter "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/PreFilterAgent.java"
click node_analysis "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobAnalysisAgent.java"
click node_match "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/MatchAgent.java"
click node_strategy "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/StrategyAgent.java"
click node_result_store "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobAgentResultRepository.java"
click node_profile "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/CandidateProfile.java"
click node_profile_store "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/CandidateProfileRepository.java"
click node_resume "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ResumeService.java"
click node_chunking "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ResumeChunkService.java"
click node_embedding "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/EmbeddingService.java"
click node_rag "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ResumeRagService.java"
click node_chunk_store "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ResumeChunkRepository.java"
click node_chat_ui "https://github.com/fangyaocneu/ai-job-agent/blob/main/frontend/src/components/Chat.jsx"
click node_app_ui "https://github.com/fangyaocneu/ai-job-agent/blob/main/frontend/src/App.jsx"
click node_insights_ui "https://github.com/fangyaocneu/ai-job-agent/blob/main/frontend/src/components/AgentInsights.jsx"
click node_chat_api "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatController.java"
click node_chat_service "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatService.java"
click node_intent_router "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JevIntentRouter.java"
click node_tools "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatToolService.java"
click node_conversation_store "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatConversationRepository.java"
click node_message_store "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatMessageRepository.java"
click node_job_api "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobController.java"
click node_email "https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/EmailService.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_ingestion,node_source_adapters toneBlue
class node_coordinator,node_prefilter,node_analysis,node_match,node_strategy toneAmber
class node_profile,node_resume,node_chunking,node_embedding,node_rag,node_chat_service,node_intent_router,node_tools,node_email toneMint
class node_jobs,node_job_store,node_result_store,node_profile_store,node_chunk_store,node_chat_api,node_conversation_store,node_message_store,node_job_api toneRose
class node_chat_ui,node_app_ui,node_insights_ui,node_user,node_job_sources,node_openai toneIndigo
```

## Components

### Job discovery

- [Job ingestion](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobIngestionService.java): `src/main/java/com.fangyao.agent/JobIngestionService.java`
- [Source adapters](https://github.com/fangyaocneu/ai-job-agent/tree/main/src/main/java/com.fangyao.agent): `src/main/java/com.fangyao.agent`

### Matching workflow

- [Agent coordinator](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/AgentCoordinator.java): `src/main/java/com.fangyao.agent/AgentCoordinator.java`
- [Pre-filter](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/PreFilterAgent.java): `src/main/java/com.fangyao.agent/PreFilterAgent.java`
- [Job analysis](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobAnalysisAgent.java): `src/main/java/com.fangyao.agent/JobAnalysisAgent.java`
- [Candidate match](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/MatchAgent.java): `src/main/java/com.fangyao.agent/MatchAgent.java`
- [Application strategy](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/StrategyAgent.java): `src/main/java/com.fangyao.agent/StrategyAgent.java`

### Candidate services

- [Candidate profile](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/CandidateProfile.java): `src/main/java/com.fangyao.agent/CandidateProfile.java`
- [Resume processing](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ResumeService.java): `src/main/java/com.fangyao.agent/ResumeService.java`
- [Resume chunks](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ResumeChunkService.java): `src/main/java/com.fangyao.agent/ResumeChunkService.java`
- [Embedding service](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/EmbeddingService.java): `src/main/java/com.fangyao.agent/EmbeddingService.java`
- [Resume retrieval](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ResumeRagService.java): `src/main/java/com.fangyao.agent/ResumeRagService.java`
- [Chat orchestration](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatService.java): `src/main/java/com.fangyao.agent/ChatService.java`
- [Intent router](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JevIntentRouter.java): `src/main/java/com.fangyao.agent/JevIntentRouter.java`
- [Chat tools](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatToolService.java): `src/main/java/com.fangyao.agent/ChatToolService.java`
- [Email delivery](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/EmailService.java): `src/main/java/com.fangyao.agent/EmailService.java`

### API and persistence

- [Job records](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/Job.java): `src/main/java/com.fangyao.agent/Job.java`
- [Job repository](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobRepository.java): `src/main/java/com.fangyao.agent/JobRepository.java`
- [Agent results](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobAgentResultRepository.java): `src/main/java/com.fangyao.agent/JobAgentResultRepository.java`
- [Profile repository](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/CandidateProfileRepository.java): `src/main/java/com.fangyao.agent/CandidateProfileRepository.java`
- [Resume chunk store](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ResumeChunkRepository.java): `src/main/java/com.fangyao.agent/ResumeChunkRepository.java`
- [Chat endpoint](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatController.java): `src/main/java/com.fangyao.agent/ChatController.java`
- [Conversation store](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatConversationRepository.java): `src/main/java/com.fangyao.agent/ChatConversationRepository.java`
- [Message and trace store](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/ChatMessageRepository.java): `src/main/java/com.fangyao.agent/ChatMessageRepository.java`
- [Job API](https://github.com/fangyaocneu/ai-job-agent/blob/main/src/main/java/com.fangyao.agent/JobController.java): `src/main/java/com.fangyao.agent/JobController.java`

### Candidate interface

- [Chat interface](https://github.com/fangyaocneu/ai-job-agent/blob/main/frontend/src/components/Chat.jsx): `frontend/src/components/Chat.jsx`
- [Dashboard](https://github.com/fangyaocneu/ai-job-agent/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Agent insights](https://github.com/fangyaocneu/ai-job-agent/blob/main/frontend/src/components/AgentInsights.jsx): `frontend/src/components/AgentInsights.jsx`

### Other components

- **Candidate**
- **Job sources**
- **OpenAI**

## Connections

- Candidate → Chat interface: asks (evidence: `README.md`)
- Chat interface → Chat endpoint: sends chat
- Chat endpoint → Chat orchestration: delegates to (evidence: `src/main/java/com.fangyao.agent/ChatController.java`)
- Chat orchestration → Intent router: routes intent (evidence: `src/main/java/com.fangyao.agent/ChatService.java`)
- Chat orchestration → Chat tools: executes tools (evidence: `src/main/java/com.fangyao.agent/ChatService.java`)
- Chat orchestration → Resume retrieval: retrieves resume (evidence: `src/main/java/com.fangyao.agent/ChatService.java`)
- Chat orchestration → Conversation store: loads conversations (evidence: `src/main/java/com.fangyao.agent/ChatService.java`)
- Chat orchestration → Message and trace store: persists messages (evidence: `src/main/java/com.fangyao.agent/ChatService.java`)
- Chat orchestration → OpenAI: reasons with
- Chat tools → Job repository: reads jobs (evidence: `src/main/java/com.fangyao.agent/ChatToolService.java`)
- Chat tools → Profile repository: reads profile (evidence: `src/main/java/com.fangyao.agent/ChatToolService.java`)
- Candidate → Dashboard: reviews results (evidence: `README.md`)
- Dashboard → Chat interface: renders (evidence: `frontend/src/App.jsx`)
- Dashboard → Agent insights: renders (evidence: `frontend/src/App.jsx`)
- Dashboard → Job API: loads job data
- Agent insights → Candidate: shows activity
- Job sources → Source adapters: provides postings
- Source adapters → Job ingestion: supplies jobs (evidence: `src/main/java/com.fangyao.agent/JobIngestionService.java`)
- Job ingestion → Job repository: stores postings
- Job repository → Job records: maps records (evidence: `src/main/java/com.fangyao.agent/JobRepository.java`)
- Job repository → Agent coordinator: provides jobs
- Agent coordinator → Pre-filter: filters jobs
- Agent coordinator → Job analysis: analyzes jobs
- Agent coordinator → Candidate match: scores fit
- Agent coordinator → Application strategy: plans applications
- Agent coordinator → Agent results: persists results
- Profile repository → Candidate profile: maps profile (evidence: `src/main/java/com.fangyao.agent/CandidateProfileRepository.java`)
- Candidate → Resume processing: uploads resume
- Resume processing → Resume chunks: chunks text (evidence: `src/main/java/com.fangyao.agent/ResumeService.java`)
- Resume chunks → Embedding service: embeds chunks (evidence: `src/main/java/com.fangyao.agent/ResumeChunkService.java`)
- Resume chunks → Resume chunk store: stores chunks (evidence: `src/main/java/com.fangyao.agent/ResumeChunkService.java`)
- Resume retrieval → Embedding service: embeds query (evidence: `src/main/java/com.fangyao.agent/ResumeRagService.java`)
- Resume retrieval → Resume chunk store: searches vectors (evidence: `src/main/java/com.fangyao.agent/ResumeRagService.java`)
- Embedding service → OpenAI: requests embeddings (evidence: `src/main/java/com.fangyao.agent/EmbeddingService.java`)
- Job API → Job repository: reads jobs (evidence: `src/main/java/com.fangyao.agent/JobController.java`)
- Agent coordinator → Email delivery: sends updates
