# akshayxgh/career-execution-system architecture

> Architecture diagram of the GitHub repository akshayxgh/career-execution-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akshayxgh/career-execution-system
- Repository: https://github.com/akshayxgh/career-execution-system

## Overview

1. This repo is a client-side React application built with TypeScript and Vite. The architecture is a single-page UI: `src/main.tsx` bootstraps the app, and `src/App.tsx` is the top-level composition point.

2. The app is organized around a shared shell and multiple feature views. `src/components/Layout.tsx` and `src/components/Sidebar.tsx` form the persistent navigation frame, while the page bodies live under `src/views/*`.

3. The main feature areas appear to be a personal/work management dashboard for documents and career tracking. The available views include `Dashboard`, `Analytics`, `Applications`, `Interviews`, `Documents`, `LearningTracks`, `PL300Tracker`, `ProjectTracker`, `ResumeTracker`, and `Weaknesses`. Each view is likely a self-contained screen rather than a deeply nested module system.

4. State is centralized in `src/store/StoreContext.tsx`, which is the key application boundary for shared data and actions. That suggests the UI relies on context-based state propagation instead of a separate backend API layer or a heavier state library.

5. Shared domain shapes live in `src/types/index.ts`. This indicates the app uses explicit TypeScript models for the store and feature data, which is important for understanding the data contract between the context, views, and utility functions.

6. Derived calculations are isolated in `src/utils/scoreCalculator.ts`. This is the main non-UI logic visible in the tree, and it likely powers analytics or scoring displays in the dashboard/tracker views rather than being embedded directly in components.

7. Styling is split between global and component-level CSS: `src/index.css`, `src/App.css`, and `src/components/Sidebar.css`. That implies the visual system is mostly local to the frontend, with no separate design system package.

8. There is no evidence of a server process, API gateway, or database in this repository tree. The architecture is therefore front-end only, with any persistence likely handled externally, mocked, or absent from the current codebase.

9. Deployment is static-host oriented. The presence of `vercel.json` and Vite configuration suggests the app is built as static assets and deployed to a platform like Vercel rather than run as a traditional server-rendered app.

10. The `public/` folder and `src/assets/` directory are the repository’s asset boundaries. These likely hold static images/icons and other non-code resources consumed by the UI shell and views.

11. There is also a complete backup copy under `document-center-backup-20260701-174849/` that mirrors the app structure. For architecture purposes, treat it as an archive or snapshot, not part of the active runtime path unless explicitly referenced.

12. A clean way to diagram this repo is: bootstrapping layer at `main.tsx`, app shell at `App.tsx`/`Layout`/`Sidebar`, shared state in `StoreContext`, derived logic in `scoreCalculator`, and feature screens in `views/`, all packaged as a Vite-built static SPA.

Main entry points: [`src/App.tsx`](https://github.com/akshayxgh/career-execution-system/blob/main/src/App.tsx) (App), [`src/store/StoreContext.tsx`](https://github.com/akshayxgh/career-execution-system/blob/main/src/store/StoreContext.tsx) (Store), [`src/views/Dashboard.tsx`](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Dashboard.tsx) (Dashboard), [`src/utils/scoreCalculator.ts`](https://github.com/akshayxgh/career-execution-system/blob/main/src/utils/scoreCalculator.ts) (Scoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_active_app["Active app"]
  node_main_tsx(("main.tsx<br/>bootstrap<br/>[main.tsx]"))
  node_app_tsx["App<br/>composition<br/>[App.tsx]"]
  node_layout_tsx["Layout<br/>shell<br/>[Layout.tsx]"]
  node_sidebar_tsx["Sidebar<br/>nav<br/>[Sidebar.tsx]"]
end

subgraph group_views["Views"]
  node_dashboard_tsx["Dashboard<br/>screen<br/>[Dashboard.tsx]"]
  node_analytics_tsx["Analytics<br/>screen<br/>[Analytics.tsx]"]
  node_applications_tsx["Applications<br/>screen<br/>[Applications.tsx]"]
  node_interviews_tsx["Interviews<br/>screen<br/>[Interviews.tsx]"]
  node_documents_tsx["Documents<br/>screen<br/>[Documents.tsx]"]
  node_learning_tracks_tsx["Learning<br/>screen<br/>[LearningTracks.tsx]"]
  node_pl300_tracker_tsx["PL300<br/>screen<br/>[PL300Tracker.tsx]"]
  node_project_tracker_tsx["Projects<br/>screen<br/>[ProjectTracker.tsx]"]
  node_resume_tracker_tsx["Resume<br/>screen<br/>[ResumeTracker.tsx]"]
  node_weaknesses_tsx["Weaknesses<br/>screen<br/>[Weaknesses.tsx]"]
end

subgraph group_shared["Shared core"]
  node_store_context_tsx[("Store<br/>context state<br/>[StoreContext.tsx]")]
  node_types_index_ts["Types<br/>domain models<br/>[index.ts]"]
  node_score_calculator_ts{{"Scoring<br/>derived logic<br/>[scoreCalculator.ts]"}}
end

subgraph group_assets["Assets"]
  node_public["Public<br/>static assets"]
  node_src_assets["Assets"]
end

subgraph group_archive["Archive"]
  node_backup_snapshot["Backup copy<br/>archive snapshot"]
end

node_main_tsx -->|"boots"| node_app_tsx
node_app_tsx -->|"wraps"| node_layout_tsx
node_layout_tsx -->|"includes"| node_sidebar_tsx
node_app_tsx -->|"provides state"| node_store_context_tsx
node_store_context_tsx -->|"shapes"| node_types_index_ts
node_store_context_tsx -->|"derives"| node_score_calculator_ts
node_app_tsx -->|"routes"| node_dashboard_tsx
node_app_tsx -->|"routes"| node_analytics_tsx
node_app_tsx -->|"routes"| node_applications_tsx
node_app_tsx -->|"routes"| node_interviews_tsx
node_app_tsx -->|"routes"| node_documents_tsx
node_app_tsx -->|"routes"| node_learning_tracks_tsx
node_app_tsx -->|"routes"| node_pl300_tracker_tsx
node_app_tsx -->|"routes"| node_project_tracker_tsx
node_app_tsx -->|"routes"| node_resume_tracker_tsx
node_app_tsx -->|"routes"| node_weaknesses_tsx
node_sidebar_tsx -->|"nav"| node_dashboard_tsx
node_sidebar_tsx -->|"nav"| node_analytics_tsx
node_store_context_tsx -->|"feeds"| node_dashboard_tsx
node_store_context_tsx -->|"feeds"| node_analytics_tsx
node_store_context_tsx -->|"feeds"| node_applications_tsx
node_store_context_tsx -->|"feeds"| node_interviews_tsx
node_store_context_tsx -->|"feeds"| node_documents_tsx
node_store_context_tsx -->|"feeds"| node_learning_tracks_tsx
node_score_calculator_ts -->|"powers"| node_analytics_tsx
node_score_calculator_ts -->|"powers"| node_dashboard_tsx
node_score_calculator_ts -->|"powers"| node_pl300_tracker_tsx
node_types_index_ts -->|"types"| node_dashboard_tsx
node_types_index_ts -->|"types"| node_applications_tsx
node_public -->|"assets"| node_app_tsx
node_src_assets -->|"assets"| node_app_tsx
node_backup_snapshot -.->|"mirrors"| node_app_tsx

click node_main_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/main.tsx"
click node_app_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/App.tsx"
click node_layout_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/components/Layout.tsx"
click node_sidebar_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/components/Sidebar.tsx"
click node_store_context_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/store/StoreContext.tsx"
click node_types_index_ts "https://github.com/akshayxgh/career-execution-system/blob/main/src/types/index.ts"
click node_score_calculator_ts "https://github.com/akshayxgh/career-execution-system/blob/main/src/utils/scoreCalculator.ts"
click node_dashboard_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Dashboard.tsx"
click node_analytics_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Analytics.tsx"
click node_applications_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Applications.tsx"
click node_interviews_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Interviews.tsx"
click node_documents_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Documents.tsx"
click node_learning_tracks_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/LearningTracks.tsx"
click node_pl300_tracker_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/PL300Tracker.tsx"
click node_project_tracker_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/ProjectTracker.tsx"
click node_resume_tracker_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/ResumeTracker.tsx"
click node_weaknesses_tsx "https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Weaknesses.tsx"
click node_public "https://github.com/akshayxgh/career-execution-system/tree/main/public"
click node_src_assets "https://github.com/akshayxgh/career-execution-system/tree/main/src/assets"
click node_backup_snapshot "https://github.com/akshayxgh/career-execution-system/tree/main/document-center-backup-20260701-174849"

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_main_tsx,node_app_tsx,node_layout_tsx,node_sidebar_tsx toneBlue
class node_dashboard_tsx,node_analytics_tsx,node_applications_tsx,node_interviews_tsx,node_documents_tsx,node_learning_tracks_tsx,node_pl300_tracker_tsx,node_project_tracker_tsx,node_resume_tracker_tsx,node_weaknesses_tsx toneAmber
class node_store_context_tsx,node_types_index_ts,node_score_calculator_ts toneMint
class node_public,node_src_assets toneRose
class node_backup_snapshot toneIndigo
```

## Components

### Active app

Primary Vite React SPA source tree

- [main.tsx](https://github.com/akshayxgh/career-execution-system/blob/main/src/main.tsx): bootstrap · Client entry that mounts the app · `src/main.tsx`
- [App](https://github.com/akshayxgh/career-execution-system/blob/main/src/App.tsx): composition · Top-level application composition and routing · `src/App.tsx`
- [Layout](https://github.com/akshayxgh/career-execution-system/blob/main/src/components/Layout.tsx): shell · Persistent app frame and content layout · `src/components/Layout.tsx`
- [Sidebar](https://github.com/akshayxgh/career-execution-system/blob/main/src/components/Sidebar.tsx): nav · Primary navigation for the shell · `src/components/Sidebar.tsx`

### Views

Feature screens rendered inside the shell

- [Dashboard](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Dashboard.tsx): screen · Main summary view · `src/views/Dashboard.tsx`
- [Analytics](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Analytics.tsx): screen · Metrics and scoring view · `src/views/Analytics.tsx`
- [Applications](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Applications.tsx): screen · Application tracking view · `src/views/Applications.tsx`
- [Interviews](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Interviews.tsx): screen · Interview tracking view · `src/views/Interviews.tsx`
- [Documents](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Documents.tsx): screen · Document management view · `src/views/Documents.tsx`
- [Learning](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/LearningTracks.tsx): screen · Learning path tracking view · `src/views/LearningTracks.tsx`
- [PL300](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/PL300Tracker.tsx): screen · PL-300 progress tracker · `src/views/PL300Tracker.tsx`
- [Projects](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/ProjectTracker.tsx): screen · Project tracking view · `src/views/ProjectTracker.tsx`
- [Resume](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/ResumeTracker.tsx): screen · Resume tracking and iteration view · `src/views/ResumeTracker.tsx`
- [Weaknesses](https://github.com/akshayxgh/career-execution-system/blob/main/src/views/Weaknesses.tsx): screen · Gaps and improvement tracking view · `src/views/Weaknesses.tsx`

### Shared core

Cross-cutting application state and domain logic

- [Store](https://github.com/akshayxgh/career-execution-system/blob/main/src/store/StoreContext.tsx): context state · Shared application data and actions · `src/store/StoreContext.tsx`
- [Types](https://github.com/akshayxgh/career-execution-system/blob/main/src/types/index.ts): domain models · Shared TypeScript data contracts · `src/types/index.ts`
- [Scoring](https://github.com/akshayxgh/career-execution-system/blob/main/src/utils/scoreCalculator.ts): derived logic · Computed scores and analytics helpers · `src/utils/scoreCalculator.ts`

### Assets

Static file boundaries consumed by the UI

- [Public](https://github.com/akshayxgh/career-execution-system/tree/main/public): static assets · Static files served as-is · `public`
- [Assets](https://github.com/akshayxgh/career-execution-system/tree/main/src/assets): ui assets · Bundled source assets · `src/assets`

### Archive

Backup snapshot of the app structure

- [Backup copy](https://github.com/akshayxgh/career-execution-system/tree/main/document-center-backup-20260701-174849): archive snapshot · Archived mirror of the application tree · `document-center-backup-20260701-174849`

## Connections

- main.tsx → App: boots · Entry point mounts the SPA root
- App → Layout: wraps · App composes the persistent shell
- Layout → Sidebar: includes · Shell provides navigation chrome
- App → Store: provides state · Top-level app uses shared context state
- Store → Types: shapes · Context uses shared domain contracts
- Store → Scoring: derives · State feeds computed scoring logic
- App → Dashboard: routes · Primary landing screen
- App → Analytics: routes · Feature view in the SPA
- App → Applications: routes · Feature view in the SPA
- App → Interviews: routes · Feature view in the SPA
- App → Documents: routes · Feature view in the SPA
- App → Learning: routes · Feature view in the SPA
- App → PL300: routes · Feature view in the SPA
- App → Projects: routes · Feature view in the SPA
- App → Resume: routes · Feature view in the SPA
- App → Weaknesses: routes · Feature view in the SPA
- Sidebar → Dashboard: nav · Sidebar links to major screens
- Sidebar → Analytics: nav · Sidebar links to major screens
- Store → Dashboard: feeds · Shared data powers the dashboard
- Store → Analytics: feeds · Shared data powers analytics
- Store → Applications: feeds · Shared data powers tracking views
- Store → Interviews: feeds · Shared data powers tracking views
- Store → Documents: feeds · Shared data powers tracking views
- Store → Learning: feeds · Shared data powers tracking views
- Scoring → Analytics: powers · Derived metrics surface in analytics
- Scoring → Dashboard: powers · Computed scoring influences summary cards
- Scoring → PL300: powers · Scoring logic supports tracker progress
- Types → Dashboard: types · Feature screens share the same models
- Types → Applications: types · Feature screens share the same models
- Public → App: assets · Static files available to the app shell
- Assets → App: assets · Bundled source assets used by components
- Backup copy → App: mirrors · Archived copy of the app structure
