# ryancjc/fyp-ontology-based-career-guidance-system architecture

> Architecture diagram of the GitHub repository ryancjc/fyp-ontology-based-career-guidance-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ryancjc/fyp-ontology-based-career-guidance-system
- Repository: https://github.com/ryancjc/fyp-ontology-based-career-guidance-system

## Overview

This is an ontology-based career-guidance application. A candidate submits a resume through the Streamlit portal; the application extracts and aligns competencies to O*NET, estimates salary, and supports occupation matching, fit analysis, and course recommendations. A separate dashboard presents O*NET competency metrics. The graph preserves these documented capabilities; course-data loading and some salary-call details are not visible in the excerpts, so those relationships are marked unverified or omitted.

Main entry points: [`Deployment/app.py`](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py) (Career Portal), [`Deployment/recommendation_engine.py`](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/recommendation_engine.py) (Dense Occupation Retrieval), [`Deployment/model_inference.py`](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/model_inference.py) (Salary Inference), [`Deployment/feature_pipeline.py`](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/feature_pipeline.py) (Competency Fit Features)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Career Guidance Portal"]
  node_streamlit["Career Portal<br/>[app.py]"]
end

subgraph group_analysis["Resume Analysis"]
  node_pdf["PDF Extraction<br/>[nlp_processing.py]"]
  node_alignment["Ontology Alignment<br/>[nlp_processing.py]"]
  node_salary["Salary Inference<br/>[model_inference.py]"]
  node_salary_model["Salary Model"]
  node_salary_explain["Salary Explanation<br/>[model_inference.py]"]
end

subgraph group_matching["Occupation Matching"]
  node_retrieval["Dense Occupation Retrieval"]
  node_retrieval_model["Retrieval Model and Index"]
  node_feature_pipeline["Competency Fit Features"]
  node_hybrid_ranking["Hybrid Match Ranking<br/>[app.py]"]
  node_job_fit["Selected-Job Fit<br/>[app.py]"]
end

subgraph group_resources["Guidance and Ontology Data"]
  node_course_recs["Course Recommendations<br/>[app.py]"]
  node_course_data[("Course Catalog")]
  node_onet_dashboard["O*NET Dashboard<br/>[app.py]"]
  node_onet_data[("O*NET Competency Data")]
end

node_candidate(("Candidate"))

node_candidate -->|"submits resume"| node_streamlit
node_streamlit -->|"extracts PDF text"| node_pdf
node_streamlit -->|"aligns competencies"| node_alignment
node_streamlit -.->|"predicts salary"| node_salary
node_salary -.->|"loads model"| node_salary_model
node_streamlit -.->|"requests SHAP data"| node_salary_explain
node_streamlit -->|"retrieves occupations"| node_retrieval
node_retrieval -->|"searches index"| node_retrieval_model
node_streamlit -->|"computes fit features"| node_feature_pipeline
node_streamlit -->|"ranks matches"| node_hybrid_ranking
node_streamlit -->|"scores selected job"| node_job_fit
node_streamlit -->|"projects course gains"| node_course_recs
node_course_recs -->|"simulates skill fit"| node_feature_pipeline
node_course_recs -->|"scores simulated skills"| node_retrieval
node_course_recs -.->|"reads catalog"| node_course_data
node_streamlit -->|"renders dashboard"| node_onet_dashboard
node_onet_dashboard -->|"reads competency data"| node_onet_data

click node_streamlit "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py"
click node_pdf "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/nlp_processing.py"
click node_alignment "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/nlp_processing.py"
click node_salary "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/model_inference.py"
click node_salary_model "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/models_%26_files/catboost_salarypred.cbm"
click node_salary_explain "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/model_inference.py"
click node_retrieval "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/recommendation_engine.py"
click node_retrieval_model "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/tree/main/Deployment/models_%26_files"
click node_feature_pipeline "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/feature_pipeline.py"
click node_hybrid_ranking "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py"
click node_job_fit "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py"
click node_course_recs "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py"
click node_course_data "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/Datasets/Unified_Course_Dataset.csv"
click node_onet_dashboard "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py"
click node_onet_data "https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/Datasets/Unified_Occupation_Dataset.csv"

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_streamlit toneBlue
class node_pdf,node_alignment,node_salary,node_salary_model,node_salary_explain toneAmber
class node_retrieval,node_retrieval_model,node_feature_pipeline,node_hybrid_ranking,node_job_fit toneMint
class node_course_recs,node_course_data,node_onet_dashboard,node_onet_data toneRose
class node_candidate toneIndigo
```

## Components

### Career Guidance Portal

- [Career Portal](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py): `Deployment/app.py`

### Resume Analysis

- [PDF Extraction](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/nlp_processing.py): `Deployment/nlp_processing.py`
- [Ontology Alignment](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/nlp_processing.py): `Deployment/nlp_processing.py`
- [Salary Inference](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/model_inference.py): `Deployment/model_inference.py`
- [Salary Model](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/models_%26_files/catboost_salarypred.cbm): `Deployment/models_&_files/catboost_salarypred.cbm`
- [Salary Explanation](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/model_inference.py): `Deployment/model_inference.py`

### Occupation Matching

- [Dense Occupation Retrieval](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/recommendation_engine.py): `Deployment/recommendation_engine.py`
- [Retrieval Model and Index](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/tree/main/Deployment/models_%26_files): `Deployment/models_&_files`
- [Competency Fit Features](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/feature_pipeline.py): `Deployment/feature_pipeline.py`
- [Hybrid Match Ranking](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py): `Deployment/app.py`
- [Selected-Job Fit](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py): `Deployment/app.py`

### Guidance and Ontology Data

- [Course Recommendations](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py): `Deployment/app.py`
- [Course Catalog](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/Datasets/Unified_Course_Dataset.csv): `Deployment/Datasets/Unified_Course_Dataset.csv`
- [O*NET Dashboard](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/app.py): `Deployment/app.py`
- [O*NET Competency Data](https://github.com/ryancjc/fyp-ontology-based-career-guidance-system/blob/main/Deployment/Datasets/Unified_Occupation_Dataset.csv): `Deployment/Datasets/Unified_Occupation_Dataset.csv`

### Other components

- **Candidate**

## Connections

- Candidate → Career Portal: submits resume (evidence: `README.md`)
- Career Portal → PDF Extraction: extracts PDF text (evidence: `Deployment/app.py`)
- Career Portal → Ontology Alignment: aligns competencies (evidence: `Deployment/app.py`)
- Career Portal → Salary Inference: predicts salary (evidence: `Deployment/app.py`)
- Salary Inference → Salary Model: loads model
- Career Portal → Salary Explanation: requests SHAP data (evidence: `Deployment/app.py`)
- Career Portal → Dense Occupation Retrieval: retrieves occupations (evidence: `Deployment/app.py`)
- Dense Occupation Retrieval → Retrieval Model and Index: searches index (evidence: `Deployment/recommendation_engine.py`)
- Career Portal → Competency Fit Features: computes fit features (evidence: `Deployment/app.py`)
- Career Portal → Hybrid Match Ranking: ranks matches (evidence: `Deployment/app.py`)
- Career Portal → Selected-Job Fit: scores selected job (evidence: `Deployment/app.py`)
- Career Portal → Course Recommendations: projects course gains (evidence: `Deployment/app.py`)
- Course Recommendations → Competency Fit Features: simulates skill fit (evidence: `Deployment/app.py`)
- Course Recommendations → Dense Occupation Retrieval: scores simulated skills (evidence: `Deployment/app.py`)
- Course Recommendations → Course Catalog: reads catalog
- Career Portal → O*NET Dashboard: renders dashboard (evidence: `Deployment/app.py`)
- O*NET Dashboard → O*NET Competency Data: reads competency data (evidence: `Deployment/app.py`)
