# safkhancader/rolemint architecture

> Architecture diagram of the GitHub repository safkhancader/rolemint, 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/safkhancader/rolemint
- Repository: https://github.com/safkhancader/rolemint

## Overview

RoleMint is a career-development platform: users manage resumes and receive ATS scoring, role matches, and job-tailoring support, alongside interview preparation and other career tools. The main documented processing path parses an uploaded resume, structures its text, matches roles, scores it, and produces AI review. The web app routes users to public and authenticated features; the API exposes the corresponding product domains. Evidence is strongest for API registration and the worker pipeline; many feature implementations and frontend-to-API calls were not sampled, so those links are omitted or marked unverified.

Main entry points: [`apps/api/app/api/v1/router.py`](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/router.py) (API routing), [`apps/api/app/workers/tasks.py`](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/workers/tasks.py) (Resume pipeline), [`apps/web/src/app/router.tsx`](https://github.com/safkhancader/rolemint/blob/main/apps/web/src/app/router.tsx) (Page routing), [`apps/web/src/app/App.tsx`](https://github.com/safkhancader/rolemint/blob/main/apps/web/src/app/App.tsx) (Web app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Web app<br/>[App.tsx]"]
  node_routes["Page routing<br/>[router.tsx]"]
  node_dashboard["Career dashboard<br/>[DashboardPage.tsx]"]
  node_resume_ui["Resume workspace<br/>[ResumeListPage.tsx]"]
  node_ats_ui["ATS scoring UI"]
  node_interview_ui["Interview prep UI"]
end

subgraph group_api["API surface"]
  node_api["FastAPI application<br/>[main.py]"]
  node_api_router["API routing<br/>[router.py]"]
  node_resume_routes["Resume endpoints<br/>[resumes.py]"]
  node_score_routes["Scoring endpoints<br/>[scoring.py]"]
  node_matching_routes["Matching endpoints<br/>[matching.py]"]
  node_interview_routes["Interview endpoints<br/>[interview.py]"]
  node_other_routes["Career feature endpoints"]
end

subgraph group_resume["Resume intelligence"]
  node_worker["Resume pipeline<br/>[tasks.py]"]
  node_document_parse["Document extraction"]
  node_structurer["Resume structuring"]
  node_role_match["Role matching<br/>[service.py]"]
  node_scoring["Resume scoring<br/>[service.py]"]
  node_ai_review["AI resume review<br/>[resume_ai.py]"]
end

subgraph group_career["Career tools"]
  node_interview_tools["Interview booking and transcription"]
  node_career_tools["Career generators and coaching<br/>[coach.py]"]
  node_ats_tools["ATS checks<br/>[ats_check.py]"]
end

subgraph group_platform["Platform services"]
  node_resume_store[("Resume storage<br/>[service.py]")]
  node_database[("Application database<br/>[session.py]")]
  node_email["Transactional email<br/>[email_service.py]"]
  node_billing["Billing service<br/>[service.py]"]
end

node_user(("Career seeker"))

node_user -->|"uses"| node_webapp
node_webapp -->|"renders routes"| node_routes
node_routes -->|"routes to"| node_dashboard
node_routes -.->|"routes to"| node_resume_ui
node_routes -->|"routes to"| node_ats_ui
node_routes -.->|"routes to"| node_interview_ui
node_api -->|"mounts"| node_api_router
node_api_router -->|"registers"| node_resume_routes
node_api_router -->|"registers"| node_score_routes
node_api_router -->|"registers"| node_matching_routes
node_api_router -->|"registers"| node_interview_routes
node_api_router -->|"registers"| node_other_routes
node_worker -->|"reads files"| node_resume_store
node_worker -->|"extracts text"| node_document_parse
node_worker -->|"structures text"| node_structurer
node_worker -->|"matches roles"| node_role_match
node_worker -->|"scores resume"| node_scoring
node_worker -->|"augments review"| node_ai_review
node_worker -->|"persists results"| node_database
node_role_match -->|"supplies keywords"| node_scoring
node_api_router -->|"registers booking"| node_interview_tools
node_api_router -->|"registers coach"| node_career_tools
node_api_router -->|"registers ATS"| node_ats_tools
node_billing -.->|"exposed through"| node_api_router
node_email -.->|"used by auth"| node_api_router

click node_webapp "https://github.com/safkhancader/rolemint/blob/main/apps/web/src/app/App.tsx"
click node_routes "https://github.com/safkhancader/rolemint/blob/main/apps/web/src/app/router.tsx"
click node_dashboard "https://github.com/safkhancader/rolemint/blob/main/apps/web/src/features/dashboard/pages/DashboardPage.tsx"
click node_resume_ui "https://github.com/safkhancader/rolemint/blob/main/apps/web/src/features/resume/pages/ResumeListPage.tsx"
click node_ats_ui "https://github.com/safkhancader/rolemint/blob/main/apps/web/src/features/scoring/pages/AtsOverviewPage.tsx"
click node_interview_ui "https://github.com/safkhancader/rolemint/blob/main/apps/web/src/features/interview/pages/InterviewTextPage.tsx"
click node_api "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/main.py"
click node_api_router "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/router.py"
click node_resume_routes "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/resumes.py"
click node_score_routes "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/scoring.py"
click node_matching_routes "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/matching.py"
click node_interview_routes "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/interview.py"
click node_other_routes "https://github.com/safkhancader/rolemint/tree/main/apps/api/app/api/v1/routes"
click node_worker "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/workers/tasks.py"
click node_document_parse "https://github.com/safkhancader/rolemint/tree/main/apps/api/app/services/parsing"
click node_structurer "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/ai/resume_structurer.py"
click node_role_match "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/matching/service.py"
click node_scoring "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/scoring/service.py"
click node_ai_review "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/ai/resume_ai.py"
click node_resume_store "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/storage/service.py"
click node_database "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/db/session.py"
click node_email "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/email_service.py"
click node_billing "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/billing/service.py"
click node_interview_tools "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/interview_booking.py"
click node_career_tools "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/coach.py"
click node_ats_tools "https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/ats_check.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_webapp,node_routes,node_dashboard,node_resume_ui,node_ats_ui,node_interview_ui toneBlue
class node_api,node_api_router,node_resume_routes,node_score_routes,node_matching_routes,node_interview_routes,node_other_routes toneAmber
class node_worker,node_document_parse,node_structurer,node_role_match,node_scoring,node_ai_review toneMint
class node_interview_tools,node_career_tools,node_ats_tools toneRose
class node_resume_store,node_database,node_email,node_billing,node_user toneIndigo
```

## Components

### Web application

- [Web app](https://github.com/safkhancader/rolemint/blob/main/apps/web/src/app/App.tsx): `apps/web/src/app/App.tsx`
- [Page routing](https://github.com/safkhancader/rolemint/blob/main/apps/web/src/app/router.tsx): `apps/web/src/app/router.tsx`
- [Career dashboard](https://github.com/safkhancader/rolemint/blob/main/apps/web/src/features/dashboard/pages/DashboardPage.tsx): `apps/web/src/features/dashboard/pages/DashboardPage.tsx`
- [Resume workspace](https://github.com/safkhancader/rolemint/blob/main/apps/web/src/features/resume/pages/ResumeListPage.tsx): `apps/web/src/features/resume/pages/ResumeListPage.tsx`
- [ATS scoring UI](https://github.com/safkhancader/rolemint/blob/main/apps/web/src/features/scoring/pages/AtsOverviewPage.tsx): `apps/web/src/features/scoring/pages/AtsOverviewPage.tsx`
- [Interview prep UI](https://github.com/safkhancader/rolemint/blob/main/apps/web/src/features/interview/pages/InterviewTextPage.tsx): `apps/web/src/features/interview/pages/InterviewTextPage.tsx`

### API surface

- [FastAPI application](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/main.py): `apps/api/app/main.py`
- [API routing](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/router.py): `apps/api/app/api/v1/router.py`
- [Resume endpoints](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/resumes.py): `apps/api/app/api/v1/routes/resumes.py`
- [Scoring endpoints](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/scoring.py): `apps/api/app/api/v1/routes/scoring.py`
- [Matching endpoints](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/matching.py): `apps/api/app/api/v1/routes/matching.py`
- [Interview endpoints](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/interview.py): `apps/api/app/api/v1/routes/interview.py`
- [Career feature endpoints](https://github.com/safkhancader/rolemint/tree/main/apps/api/app/api/v1/routes): `apps/api/app/api/v1/routes`

### Resume intelligence

- [Resume pipeline](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/workers/tasks.py): `apps/api/app/workers/tasks.py`
- [Document extraction](https://github.com/safkhancader/rolemint/tree/main/apps/api/app/services/parsing): `apps/api/app/services/parsing`
- [Resume structuring](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/ai/resume_structurer.py): `apps/api/app/services/ai/resume_structurer.py`
- [Role matching](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/matching/service.py): `apps/api/app/services/matching/service.py`
- [Resume scoring](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/scoring/service.py): `apps/api/app/services/scoring/service.py`
- [AI resume review](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/ai/resume_ai.py): `apps/api/app/services/ai/resume_ai.py`

### Career tools

- [Interview booking and transcription](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/interview_booking.py): `apps/api/app/api/v1/routes/interview_booking.py`
- [Career generators and coaching](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/coach.py): `apps/api/app/api/v1/routes/coach.py`
- [ATS checks](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/api/v1/routes/ats_check.py): `apps/api/app/api/v1/routes/ats_check.py`

### Platform services

- [Resume storage](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/storage/service.py): `apps/api/app/services/storage/service.py`
- [Application database](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/db/session.py): `apps/api/app/db/session.py`
- [Transactional email](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/email_service.py): `apps/api/app/services/email_service.py`
- [Billing service](https://github.com/safkhancader/rolemint/blob/main/apps/api/app/services/billing/service.py): `apps/api/app/services/billing/service.py`

### Other components

- **Career seeker**

## Connections

- Career seeker → Web app: uses (evidence: `apps/web/src/app/App.tsx`)
- Web app → Page routing: renders routes (evidence: `apps/web/src/app/App.tsx`)
- Page routing → Career dashboard: routes to (evidence: `apps/web/src/app/router.tsx`)
- Page routing → Resume workspace: routes to
- Page routing → ATS scoring UI: routes to (evidence: `apps/web/src/app/router.tsx`)
- Page routing → Interview prep UI: routes to
- FastAPI application → API routing: mounts (evidence: `apps/api/app/main.py`)
- API routing → Resume endpoints: registers (evidence: `apps/api/app/api/v1/router.py`)
- API routing → Scoring endpoints: registers (evidence: `apps/api/app/api/v1/router.py`)
- API routing → Matching endpoints: registers (evidence: `apps/api/app/api/v1/router.py`)
- API routing → Interview endpoints: registers (evidence: `apps/api/app/api/v1/router.py`)
- API routing → Career feature endpoints: registers (evidence: `apps/api/app/api/v1/router.py`)
- Resume pipeline → Resume storage: reads files (evidence: `apps/api/app/workers/tasks.py`)
- Resume pipeline → Document extraction: extracts text (evidence: `apps/api/app/workers/tasks.py`)
- Resume pipeline → Resume structuring: structures text (evidence: `apps/api/app/workers/tasks.py`)
- Resume pipeline → Role matching: matches roles (evidence: `apps/api/app/workers/tasks.py`)
- Resume pipeline → Resume scoring: scores resume (evidence: `apps/api/app/workers/tasks.py`)
- Resume pipeline → AI resume review: augments review (evidence: `apps/api/app/workers/tasks.py`)
- Resume pipeline → Application database: persists results (evidence: `apps/api/app/workers/tasks.py`)
- Role matching → Resume scoring: supplies keywords (evidence: `apps/api/app/workers/tasks.py`)
- API routing → Interview booking and transcription: registers booking (evidence: `apps/api/app/api/v1/router.py`)
- API routing → Career generators and coaching: registers coach (evidence: `apps/api/app/api/v1/router.py`)
- API routing → ATS checks: registers ATS (evidence: `apps/api/app/api/v1/router.py`)
- Billing service → API routing: exposed through
- Transactional email → API routing: used by auth
