# d3cim025/jobtracker architecture

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

- Interactive diagram: https://gitdiagram.com/d3cim025/jobtracker
- Repository: https://github.com/d3cim025/jobtracker

## Overview

JobTracker is a local-first Flask application for managing a job search in one private workspace. A user works through the web interface to create and track applications, then records hiring progress with timeline events and reminders; resume versions and application-specific documents preserve what was sent. Dashboard summaries and read-only analytics help review activity. The README documents these capabilities, while source excerpts and the SOURCE INDEX establish several route-to-service links; some less-sampled feature wiring is therefore shown only where the index or README supports it.

Main entry points: [`app/models.py`](https://github.com/d3cim025/jobtracker/blob/master/app/models.py) (Domain models), [`app/__init__.py`](https://github.com/d3cim025/jobtracker/blob/master/app/__init__.py) (App setup and security), [`app/routes/applications.py`](https://github.com/d3cim025/jobtracker/blob/master/app/routes/applications.py) (Application routes), [`app/services/application_service.py`](https://github.com/d3cim025/jobtracker/blob/master/app/services/application_service.py) (Application operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_ui["Pages and assets"]
  node_client_assets["Offline interface assets"]
end

subgraph group_tracking["Application tracking"]
  node_applications_route["Application routes<br/>[applications.py]"]
  node_application_service["Application operations"]
  node_duplication_service["Apply Again workflow"]
  node_timeline_route["Timeline routes<br/>[timeline.py]"]
  node_timeline_service["Timeline operations"]
  node_reminder_route["Reminder routes<br/>[reminders.py]"]
  node_reminder_service["Reminder operations"]
end

subgraph group_materials["Application materials"]
  node_resume_route["Resume routes<br/>[resumes.py]"]
  node_resume_service["Resume library<br/>[resume_service.py]"]
  node_document_route["Document routes<br/>[documents.py]"]
  node_document_service["Document operations"]
end

subgraph group_insights["Progress insights"]
  node_main_route["Home and health routes<br/>[main.py]"]
  node_dashboard_service["Dashboard summaries"]
  node_analytics_route["Analytics routes<br/>[analytics.py]"]
  node_analytics_service["Analytics queries"]
end

subgraph group_runtime["Local runtime"]
  node_app_factory["App setup and security<br/>[__init__.py]"]
  node_models["Domain models<br/>[models.py]"]
  node_config["Local configuration<br/>[config.py]"]
  node_sqlite[("SQLite database")]
  node_uploads[("Local uploaded files")]
end

node_user(("Local user"))

node_user -->|"uses"| node_ui
node_ui -.->|"submits requests"| node_applications_route
node_ui -->|"loads local assets"| node_client_assets
node_applications_route -->|"delegates to"| node_application_service
node_applications_route -->|"starts duplicate flow"| node_duplication_service
node_applications_route -->|"loads reminder groups"| node_reminder_service
node_applications_route -->|"queries records"| node_models
node_application_service -->|"prepares document deletion"| node_document_service
node_duplication_service -->|"validates reused fields"| node_application_service
node_timeline_route -->|"delegates to"| node_timeline_service
node_timeline_route -->|"queries records"| node_models
node_reminder_route -->|"delegates to"| node_reminder_service
node_reminder_route -->|"queries records"| node_models
node_resume_route -->|"delegates to"| node_resume_service
node_resume_route -->|"queries records"| node_models
node_resume_service -->|"stores resume files"| node_uploads
node_document_route -->|"delegates to"| node_document_service
node_document_route -->|"queries records"| node_models
node_document_service -->|"stores application files"| node_uploads
node_main_route -->|"builds dashboard"| node_dashboard_service
node_dashboard_service -->|"classifies reminders"| node_reminder_service
node_analytics_route -->|"delegates to"| node_analytics_service
node_app_factory -->|"loads defaults"| node_config
node_app_factory -->|"registers blueprint"| node_applications_route
node_app_factory -->|"registers blueprint"| node_resume_route
node_app_factory -->|"registers blueprint"| node_document_route
node_app_factory -->|"registers blueprint"| node_timeline_route
node_app_factory -->|"registers blueprint"| node_reminder_route
node_app_factory -->|"registers blueprint"| node_main_route
node_app_factory -->|"registers blueprint"| node_analytics_route
node_application_service -->|"reads and writes"| node_models
node_duplication_service -->|"creates application"| node_models
node_timeline_service -->|"reads and writes"| node_models
node_reminder_service -->|"reads and writes"| node_models
node_resume_service -->|"reads and writes"| node_models
node_document_service -->|"reads and writes"| node_models
node_dashboard_service -->|"queries activity"| node_models
node_analytics_service -->|"queries metrics"| node_models
node_app_factory -->|"configures database"| node_sqlite
node_models -->|"defines persisted entities"| node_sqlite

click node_ui "https://github.com/d3cim025/jobtracker/tree/master/app/templates"
click node_client_assets "https://github.com/d3cim025/jobtracker/tree/master/app/static"
click node_applications_route "https://github.com/d3cim025/jobtracker/blob/master/app/routes/applications.py"
click node_application_service "https://github.com/d3cim025/jobtracker/blob/master/app/services/application_service.py"
click node_duplication_service "https://github.com/d3cim025/jobtracker/blob/master/app/services/duplication_service.py"
click node_timeline_route "https://github.com/d3cim025/jobtracker/blob/master/app/routes/timeline.py"
click node_timeline_service "https://github.com/d3cim025/jobtracker/blob/master/app/services/timeline_service.py"
click node_reminder_route "https://github.com/d3cim025/jobtracker/blob/master/app/routes/reminders.py"
click node_reminder_service "https://github.com/d3cim025/jobtracker/blob/master/app/services/reminder_service.py"
click node_resume_route "https://github.com/d3cim025/jobtracker/blob/master/app/routes/resumes.py"
click node_resume_service "https://github.com/d3cim025/jobtracker/blob/master/app/services/resume_service.py"
click node_document_route "https://github.com/d3cim025/jobtracker/blob/master/app/routes/documents.py"
click node_document_service "https://github.com/d3cim025/jobtracker/blob/master/app/services/document_service.py"
click node_main_route "https://github.com/d3cim025/jobtracker/blob/master/app/routes/main.py"
click node_dashboard_service "https://github.com/d3cim025/jobtracker/blob/master/app/services/dashboard_service.py"
click node_analytics_route "https://github.com/d3cim025/jobtracker/blob/master/app/routes/analytics.py"
click node_analytics_service "https://github.com/d3cim025/jobtracker/blob/master/app/services/analytics_service.py"
click node_app_factory "https://github.com/d3cim025/jobtracker/blob/master/app/__init__.py"
click node_models "https://github.com/d3cim025/jobtracker/blob/master/app/models.py"
click node_config "https://github.com/d3cim025/jobtracker/blob/master/config.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_ui,node_client_assets,node_user toneBlue
class node_applications_route,node_application_service,node_duplication_service,node_timeline_route,node_timeline_service,node_reminder_route,node_reminder_service toneAmber
class node_resume_route,node_resume_service,node_document_route,node_document_service toneMint
class node_main_route,node_dashboard_service,node_analytics_route,node_analytics_service toneRose
class node_app_factory,node_models,node_config,node_sqlite,node_uploads toneIndigo
```

## Components

### Web interface

- [Pages and assets](https://github.com/d3cim025/jobtracker/tree/master/app/templates): `app/templates`
- [Offline interface assets](https://github.com/d3cim025/jobtracker/tree/master/app/static): `app/static`

### Application tracking

- [Application routes](https://github.com/d3cim025/jobtracker/blob/master/app/routes/applications.py): `app/routes/applications.py`
- [Application operations](https://github.com/d3cim025/jobtracker/blob/master/app/services/application_service.py): `app/services/application_service.py`
- [Apply Again workflow](https://github.com/d3cim025/jobtracker/blob/master/app/services/duplication_service.py): `app/services/duplication_service.py`
- [Timeline routes](https://github.com/d3cim025/jobtracker/blob/master/app/routes/timeline.py): `app/routes/timeline.py`
- [Timeline operations](https://github.com/d3cim025/jobtracker/blob/master/app/services/timeline_service.py): `app/services/timeline_service.py`
- [Reminder routes](https://github.com/d3cim025/jobtracker/blob/master/app/routes/reminders.py): `app/routes/reminders.py`
- [Reminder operations](https://github.com/d3cim025/jobtracker/blob/master/app/services/reminder_service.py): `app/services/reminder_service.py`

### Application materials

- [Resume routes](https://github.com/d3cim025/jobtracker/blob/master/app/routes/resumes.py): `app/routes/resumes.py`
- [Resume library](https://github.com/d3cim025/jobtracker/blob/master/app/services/resume_service.py): `app/services/resume_service.py`
- [Document routes](https://github.com/d3cim025/jobtracker/blob/master/app/routes/documents.py): `app/routes/documents.py`
- [Document operations](https://github.com/d3cim025/jobtracker/blob/master/app/services/document_service.py): `app/services/document_service.py`

### Progress insights

- [Home and health routes](https://github.com/d3cim025/jobtracker/blob/master/app/routes/main.py): `app/routes/main.py`
- [Dashboard summaries](https://github.com/d3cim025/jobtracker/blob/master/app/services/dashboard_service.py): `app/services/dashboard_service.py`
- [Analytics routes](https://github.com/d3cim025/jobtracker/blob/master/app/routes/analytics.py): `app/routes/analytics.py`
- [Analytics queries](https://github.com/d3cim025/jobtracker/blob/master/app/services/analytics_service.py): `app/services/analytics_service.py`

### Local runtime

- [App setup and security](https://github.com/d3cim025/jobtracker/blob/master/app/__init__.py): `app/__init__.py`
- [Domain models](https://github.com/d3cim025/jobtracker/blob/master/app/models.py): `app/models.py`
- [Local configuration](https://github.com/d3cim025/jobtracker/blob/master/config.py): `config.py`
- **SQLite database**
- **Local uploaded files**

### Other components

- **Local user**

## Connections

- Local user → Pages and assets: uses (evidence: `README.md`)
- Pages and assets → Application routes: submits requests
- Pages and assets → Offline interface assets: loads local assets (evidence: `README.md`)
- Application routes → Application operations: delegates to (evidence: `app/routes/applications.py`)
- Application routes → Apply Again workflow: starts duplicate flow (evidence: `app/routes/applications.py`)
- Application routes → Reminder operations: loads reminder groups (evidence: `app/routes/applications.py`)
- Application routes → Domain models: queries records (evidence: `app/routes/applications.py`)
- Application operations → Document operations: prepares document deletion (evidence: `app/services/application_service.py`)
- Apply Again workflow → Application operations: validates reused fields (evidence: `app/services/duplication_service.py`)
- Timeline routes → Timeline operations: delegates to (evidence: `app/routes/timeline.py`)
- Timeline routes → Domain models: queries records (evidence: `app/routes/timeline.py`)
- Reminder routes → Reminder operations: delegates to (evidence: `app/routes/reminders.py`)
- Reminder routes → Domain models: queries records (evidence: `app/routes/reminders.py`)
- Resume routes → Resume library: delegates to (evidence: `app/routes/resumes.py`)
- Resume routes → Domain models: queries records (evidence: `app/routes/resumes.py`)
- Resume library → Local uploaded files: stores resume files (evidence: `README.md`)
- Document routes → Document operations: delegates to (evidence: `app/routes/documents.py`)
- Document routes → Domain models: queries records (evidence: `app/routes/documents.py`)
- Document operations → Local uploaded files: stores application files (evidence: `README.md`)
- Home and health routes → Dashboard summaries: builds dashboard (evidence: `app/routes/main.py`)
- Dashboard summaries → Reminder operations: classifies reminders (evidence: `app/services/dashboard_service.py`)
- Analytics routes → Analytics queries: delegates to (evidence: `app/routes/analytics.py`)
- App setup and security → Local configuration: loads defaults (evidence: `app/__init__.py`)
- App setup and security → Application routes: registers blueprint (evidence: `app/__init__.py`)
- App setup and security → Resume routes: registers blueprint (evidence: `app/__init__.py`)
- App setup and security → Document routes: registers blueprint (evidence: `app/__init__.py`)
- App setup and security → Timeline routes: registers blueprint (evidence: `app/__init__.py`)
- App setup and security → Reminder routes: registers blueprint (evidence: `app/__init__.py`)
- App setup and security → Home and health routes: registers blueprint (evidence: `app/__init__.py`)
- App setup and security → Analytics routes: registers blueprint (evidence: `app/__init__.py`)
- Application operations → Domain models: reads and writes (evidence: `app/services/application_service.py`)
- Apply Again workflow → Domain models: creates application (evidence: `app/services/duplication_service.py`)
- Timeline operations → Domain models: reads and writes (evidence: `app/services/timeline_service.py`)
- Reminder operations → Domain models: reads and writes (evidence: `app/services/reminder_service.py`)
- Resume library → Domain models: reads and writes (evidence: `app/services/resume_service.py`)
- Document operations → Domain models: reads and writes (evidence: `app/services/document_service.py`)
- Dashboard summaries → Domain models: queries activity (evidence: `app/services/dashboard_service.py`)
- Analytics queries → Domain models: queries metrics (evidence: `app/services/analytics_service.py`)
- App setup and security → SQLite database: configures database (evidence: `app/__init__.py`)
- Domain models → SQLite database: defines persisted entities (evidence: `README.md`)
