# adithyap-72/career_guidance_ml_ops architecture

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

- Interactive diagram: https://gitdiagram.com/adithyap-72/career_guidance_ml_ops
- Repository: https://github.com/adithyap-72/career_guidance_ml_ops

## Overview

This is an Indian career-guidance application backed by an MLOps workflow. A job seeker supplies skills and experience (or uploads a resume); the serving API returns ranked roles, readiness and skill gaps, and course suggestions. The repository also covers preparing labeled job-posting data, training and evaluating role classifiers, and packaging a model for inference. README documents the product outcomes; source excerpts and the SOURCE INDEX support only some internal calls, so uncertain links are omitted.

Main entry points: [`src/serving/app.py`](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/app.py) (Inference API), [`src/serving/recommender.py`](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/recommender.py) (Role recommender), [`src/models/train.py`](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/train.py) (Model training), [`src/serving/bundle.py`](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/bundle.py) (Model bundle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Career guidance"]
  node_dashboard["Web dashboard<br/>[app.js]"]
  node_courses["Course matching<br/>[courses.py]"]
  node_skill_profiles["Role skill profiles<br/>[profiles.py]"]
end

subgraph group_data["Data preparation"]
  node_raw_data[("Source snapshots")]
  node_ingest["Posting ingestion<br/>[ingest.py]"]
  node_label["Role labeling<br/>[label.py]"]
  node_taxonomy["Role taxonomy<br/>[taxonomy.py]"]
  node_profiles["Data profiling<br/>[profile.py]"]
  node_split["Dataset splitting<br/>[split.py]"]
end

subgraph group_ml["Model lifecycle"]
  node_features["Feature pipeline<br/>[build.py]"]
  node_estimators["Role estimators<br/>[estimators.py]"]
  node_train["Model training<br/>[train.py]"]
  node_evaluate["Model evaluation<br/>[evaluate.py]"]
  node_tracking["Experiment tracking<br/>[tracking.py]"]
  node_select["Champion selection<br/>[select.py]"]
  node_validate["Quality gate<br/>[validate.py]"]
  node_register["Model registry<br/>[register.py]"]
end

subgraph group_serve["Inference"]
  node_api["Inference API<br/>[app.py]"]
  node_resume["Resume extraction<br/>[resume.py]"]
  node_recommender["Role recommender<br/>[recommender.py]"]
  node_schemas["API schemas<br/>[schemas.py]"]
  node_limits["Request limits<br/>[limits.py]"]
  node_keyness["Skill keyness<br/>[keyness.py]"]
  node_bundle["Model bundle<br/>[bundle.py]"]
end

node_job_seeker(("Job seeker"))

node_job_seeker -->|"submits profile"| node_api
node_api -->|"extracts resume"| node_resume
node_api -->|"requests recommendations"| node_recommender
node_api -->|"rate limits"| node_limits
node_api -->|"uses schemas"| node_schemas
node_bundle -->|"provides model files"| node_recommender
node_recommender -->|"matches courses"| node_courses
node_recommender -->|"reads role skills"| node_skill_profiles
node_job_seeker -.->|"uses interface"| node_dashboard
node_dashboard -.->|"calls API"| node_api
node_raw_data -->|"loads snapshots"| node_ingest
node_ingest -.->|"prepares postings"| node_label
node_label -.->|"assigns roles"| node_taxonomy
node_taxonomy -.->|"supports role data"| node_split
node_profiles -.->|"builds profiles"| node_skill_profiles
node_split -->|"provides training data"| node_features
node_train -->|"builds inputs"| node_features
node_train -->|"builds classifier"| node_estimators
node_train -->|"scores model"| node_evaluate
node_train -->|"logs run"| node_tracking
node_select -->|"compares metrics"| node_evaluate
node_select -->|"uses run records"| node_tracking
node_validate -->|"checks performance"| node_evaluate
node_register -->|"uses run metadata"| node_tracking
node_register -->|"supplies registered model"| node_bundle
node_bundle -->|"checks trusted types"| node_train
node_recommender -->|"uses model preprocessing"| node_features
node_recommender -.->|"uses skill lookup"| node_keyness

click node_dashboard "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/frontend/app.js"
click node_api "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/app.py"
click node_resume "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/resume.py"
click node_recommender "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/recommender.py"
click node_schemas "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/schemas.py"
click node_limits "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/limits.py"
click node_keyness "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/keyness.py"
click node_bundle "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/bundle.py"
click node_raw_data "https://github.com/adithyap-72/career_guidance_ml_ops/tree/main/data/raw"
click node_ingest "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/ingest.py"
click node_label "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/label.py"
click node_taxonomy "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/taxonomy.py"
click node_profiles "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/profile.py"
click node_split "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/split.py"
click node_features "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/features/build.py"
click node_estimators "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/estimators.py"
click node_train "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/train.py"
click node_evaluate "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/evaluate.py"
click node_tracking "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/tracking.py"
click node_select "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/select.py"
click node_validate "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/validate.py"
click node_register "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/register.py"
click node_courses "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/courses.py"
click node_skill_profiles "https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/profiles.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_dashboard,node_courses,node_skill_profiles toneBlue
class node_raw_data,node_ingest,node_label,node_taxonomy,node_profiles,node_split toneAmber
class node_features,node_estimators,node_train,node_evaluate,node_tracking,node_select,node_validate,node_register toneMint
class node_api,node_resume,node_recommender,node_schemas,node_limits,node_keyness,node_bundle toneRose
class node_job_seeker toneIndigo
```

## Components

### Career guidance

- [Web dashboard](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/frontend/app.js): `frontend/app.js`
- [Course matching](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/courses.py): `src/models/courses.py`
- [Role skill profiles](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/profiles.py): `src/models/profiles.py`

### Data preparation

- [Source snapshots](https://github.com/adithyap-72/career_guidance_ml_ops/tree/main/data/raw): `data/raw`
- [Posting ingestion](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/ingest.py): `src/data/ingest.py`
- [Role labeling](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/label.py): `src/data/label.py`
- [Role taxonomy](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/taxonomy.py): `src/data/taxonomy.py`
- [Data profiling](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/profile.py): `src/data/profile.py`
- [Dataset splitting](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/data/split.py): `src/data/split.py`

### Model lifecycle

- [Feature pipeline](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/features/build.py): `src/features/build.py`
- [Role estimators](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/estimators.py): `src/models/estimators.py`
- [Model training](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/train.py): `src/models/train.py`
- [Model evaluation](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/evaluate.py): `src/models/evaluate.py`
- [Experiment tracking](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/tracking.py): `src/models/tracking.py`
- [Champion selection](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/select.py): `src/models/select.py`
- [Quality gate](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/validate.py): `src/models/validate.py`
- [Model registry](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/models/register.py): `src/models/register.py`

### Inference

- [Inference API](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/app.py): `src/serving/app.py`
- [Resume extraction](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/resume.py): `src/serving/resume.py`
- [Role recommender](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/recommender.py): `src/serving/recommender.py`
- [API schemas](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/schemas.py): `src/serving/schemas.py`
- [Request limits](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/limits.py): `src/serving/limits.py`
- [Skill keyness](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/keyness.py): `src/serving/keyness.py`
- [Model bundle](https://github.com/adithyap-72/career_guidance_ml_ops/blob/main/src/serving/bundle.py): `src/serving/bundle.py`

### Other components

- **Job seeker**

## Connections

- Job seeker → Inference API: submits profile (evidence: `README.md`)
- Inference API → Resume extraction: extracts resume (evidence: `src/serving/app.py`)
- Inference API → Role recommender: requests recommendations (evidence: `src/serving/app.py`)
- Inference API → Request limits: rate limits (evidence: `src/serving/app.py`)
- Inference API → API schemas: uses schemas (evidence: `src/serving/app.py`)
- Model bundle → Role recommender: provides model files (evidence: `src/serving/recommender.py`)
- Role recommender → Course matching: matches courses (evidence: `src/serving/recommender.py`)
- Role recommender → Role skill profiles: reads role skills (evidence: `src/serving/recommender.py`)
- Job seeker → Web dashboard: uses interface
- Web dashboard → Inference API: calls API
- Source snapshots → Posting ingestion: loads snapshots (evidence: `src/data/ingest.py`)
- Posting ingestion → Role labeling: prepares postings
- Role labeling → Role taxonomy: assigns roles
- Role taxonomy → Dataset splitting: supports role data
- Data profiling → Role skill profiles: builds profiles
- Dataset splitting → Feature pipeline: provides training data (evidence: `src/data/split.py`)
- Model training → Feature pipeline: builds inputs (evidence: `src/models/train.py`)
- Model training → Role estimators: builds classifier (evidence: `src/models/train.py`)
- Model training → Model evaluation: scores model (evidence: `src/models/train.py`)
- Model training → Experiment tracking: logs run (evidence: `src/models/train.py`)
- Champion selection → Model evaluation: compares metrics (evidence: `src/models/select.py`)
- Champion selection → Experiment tracking: uses run records (evidence: `src/models/select.py`)
- Quality gate → Model evaluation: checks performance (evidence: `src/models/validate.py`)
- Model registry → Experiment tracking: uses run metadata (evidence: `src/models/register.py`)
- Model registry → Model bundle: supplies registered model (evidence: `src/models/register.py`)
- Model bundle → Model training: checks trusted types (evidence: `src/serving/bundle.py`)
- Role recommender → Feature pipeline: uses model preprocessing (evidence: `src/serving/recommender.py`)
- Role recommender → Skill keyness: uses skill lookup
