# jakubpechoucek-glitch/project_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/jakubpechoucek-glitch/project_tracker
- Repository: https://github.com/jakubpechoucek-glitch/project_tracker

## Overview

Project Tracker is a React time-tracking application backed by an Express API and SQLite. PMs sign in, record and submit weekly time, while admins manage projects, assignments and users, review entries, and inspect reports and audit history; suggestions are shared across roles. The graph separates browser workflows, API handling, domain services, persistence, and scheduled reporting. The README documents the product capabilities and API; selected source excerpts show routing and service/repository calls, but not every feature’s implementation or browser-to-server request wiring.

Main entry points: [`client/src/App.jsx`](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/App.jsx) (Role-based app), [`server/controllers`](https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/server/controllers) (Request handlers), [`server/repositories`](https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/server/repositories) (SQL repositories), [`server/routes`](https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/server/routes) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Role-based app<br/>[App.jsx]"]
  node_login["Sign-in<br/>[Login.jsx]"]
  node_timesheet["Weekly timesheet<br/>[Timesheet.jsx]"]
  node_pm_views["PM workspace"]
  node_admin_views["Admin workspace"]
  node_reports_ui["Report views"]
  node_suggestions_ui["Suggestions<br/>[Suggestions.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_server["Express app<br/>[index.js]"]
  node_routes["API routes"]
  node_auth_mw["Authentication<br/>[auth.middleware.js]"]
  node_role_mw["Role checks<br/>[role.middleware.js]"]
  node_controllers["Request handlers"]
end

subgraph group_domain["Domain services"]
  node_auth_service["Sign-in service<br/>[auth.service.js]"]
  node_entries_service["Entry workflow<br/>[entries.service.js]"]
  node_assignments_service["Assignments"]
  node_users_service["User management<br/>[users.service.js]"]
end

subgraph group_data["Persistence"]
  node_repositories["SQL repositories"]
  node_sqlite[("SQLite database<br/>[db.js]")]
end

subgraph group_operations["Reporting and audit"]
  node_reports_service["Report calculations<br/>[reports.service.js]"]
  node_weekly_job["Weekly email job<br/>[weeklyReport.js]"]
  node_audit["Audit logging<br/>[audit.js]"]
end

node_pm(("Project manager"))
node_admin(("Administrator"))

node_pm -.->|"uses"| node_app
node_admin -.->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_timesheet
node_app -->|"routes to"| node_pm_views
node_app -->|"routes to"| node_admin_views
node_app -->|"routes to"| node_reports_ui
node_app -->|"routes to"| node_suggestions_ui
node_login -->|"uses"| node_api_client
node_timesheet -->|"uses"| node_api_client
node_api_client -.->|"requests API"| node_server
node_server -->|"mounts"| node_routes
node_routes -->|"dispatches"| node_controllers
node_routes -->|"authenticates"| node_auth_mw
node_routes -->|"checks role"| node_role_mw
node_controllers -->|"calls"| node_entries_service
node_controllers -->|"calls"| node_reports_service
node_controllers -.->|"calls"| node_auth_service
node_controllers -->|"calls"| node_assignments_service
node_controllers -->|"calls"| node_users_service
node_entries_service -->|"reads and writes"| node_repositories
node_assignments_service -->|"reads and writes"| node_repositories
node_users_service -->|"reads and writes"| node_repositories
node_auth_service -->|"reads and updates"| node_repositories
node_reports_service -->|"queries"| node_sqlite
node_repositories -->|"queries"| node_sqlite
node_entries_service -->|"logs changes"| node_audit
node_auth_service -->|"logs events"| node_audit
node_assignments_service -->|"logs changes"| node_audit
node_server -->|"registers"| node_weekly_job
node_weekly_job -->|"queries"| node_sqlite

click node_app "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/App.jsx"
click node_login "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/pages/Login.jsx"
click node_timesheet "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/pages/pm/Timesheet.jsx"
click node_pm_views "https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/client/src/pages/pm"
click node_admin_views "https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/client/src/pages/admin"
click node_reports_ui "https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/client/src/pages/admin/reports"
click node_suggestions_ui "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/pages/shared/Suggestions.jsx"
click node_api_client "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/services/api.js"
click node_server "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/index.js"
click node_routes "https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/server/routes"
click node_auth_mw "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/middleware/auth.middleware.js"
click node_role_mw "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/middleware/role.middleware.js"
click node_controllers "https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/server/controllers"
click node_auth_service "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/auth.service.js"
click node_entries_service "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/entries.service.js"
click node_assignments_service "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/assignments.service.js"
click node_users_service "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/users.service.js"
click node_reports_service "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/reports.service.js"
click node_weekly_job "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/jobs/weeklyReport.js"
click node_audit "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/utils/audit.js"
click node_repositories "https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/server/repositories"
click node_sqlite "https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/db/db.js"

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_app,node_login,node_timesheet,node_pm_views,node_admin_views,node_reports_ui,node_suggestions_ui,node_api_client toneBlue
class node_server,node_routes,node_auth_mw,node_role_mw,node_controllers toneAmber
class node_auth_service,node_entries_service,node_assignments_service,node_users_service toneMint
class node_repositories,node_sqlite toneRose
class node_reports_service,node_weekly_job,node_audit,node_pm,node_admin toneIndigo
```

## Components

### Web application

- [Role-based app](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Sign-in](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Weekly timesheet](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/pages/pm/Timesheet.jsx): `client/src/pages/pm/Timesheet.jsx`
- [PM workspace](https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/client/src/pages/pm): `client/src/pages/pm`
- [Admin workspace](https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/client/src/pages/admin): `client/src/pages/admin`
- [Report views](https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/client/src/pages/admin/reports): `client/src/pages/admin/reports`
- [Suggestions](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/pages/shared/Suggestions.jsx): `client/src/pages/shared/Suggestions.jsx`
- [API client](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/client/src/services/api.js): `client/src/services/api.js`

### API and access

- [Express app](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/index.js): `server/index.js`
- [API routes](https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/server/routes): `server/routes`
- [Authentication](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/middleware/auth.middleware.js): `server/middleware/auth.middleware.js`
- [Role checks](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/middleware/role.middleware.js): `server/middleware/role.middleware.js`
- [Request handlers](https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/server/controllers): `server/controllers`

### Domain services

- [Sign-in service](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/auth.service.js): `server/services/auth.service.js`
- [Entry workflow](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/entries.service.js): `server/services/entries.service.js`
- [Assignments](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/assignments.service.js): `server/services/assignments.service.js`
- [User management](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/users.service.js): `server/services/users.service.js`

### Persistence

- [SQL repositories](https://github.com/jakubpechoucek-glitch/project_tracker/tree/main/server/repositories): `server/repositories`
- [SQLite database](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/db/db.js): `db/db.js`

### Reporting and audit

- [Report calculations](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/services/reports.service.js): `server/services/reports.service.js`
- [Weekly email job](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/jobs/weeklyReport.js): `server/jobs/weeklyReport.js`
- [Audit logging](https://github.com/jakubpechoucek-glitch/project_tracker/blob/main/server/utils/audit.js): `server/utils/audit.js`

### Other components

- **Project manager**
- **Administrator**

## Connections

- Project manager → Role-based app: uses
- Administrator → Role-based app: uses
- Role-based app → Sign-in: routes to (evidence: `client/src/App.jsx`)
- Role-based app → Weekly timesheet: routes to (evidence: `client/src/App.jsx`)
- Role-based app → PM workspace: routes to (evidence: `client/src/App.jsx`)
- Role-based app → Admin workspace: routes to (evidence: `client/src/App.jsx`)
- Role-based app → Report views: routes to (evidence: `client/src/App.jsx`)
- Role-based app → Suggestions: routes to (evidence: `client/src/App.jsx`)
- Sign-in → API client: uses (evidence: `client/src/pages/Login.jsx`)
- Weekly timesheet → API client: uses (evidence: `client/src/pages/pm/Timesheet.jsx`)
- API client → Express app: requests API
- Express app → API routes: mounts (evidence: `server/index.js`)
- API routes → Request handlers: dispatches (evidence: `server/routes/entries.routes.js`)
- API routes → Authentication: authenticates (evidence: `server/routes/entries.routes.js`)
- API routes → Role checks: checks role (evidence: `server/routes/entries.routes.js`)
- Request handlers → Entry workflow: calls (evidence: `server/controllers/entries.controller.js`)
- Request handlers → Report calculations: calls (evidence: `server/controllers/reports.controller.js`)
- Request handlers → Sign-in service: calls
- Request handlers → Assignments: calls (evidence: `server/controllers/assignments.controller.js`)
- Request handlers → User management: calls (evidence: `server/controllers/users.controller.js`)
- Entry workflow → SQL repositories: reads and writes (evidence: `server/services/entries.service.js`)
- Assignments → SQL repositories: reads and writes (evidence: `server/services/assignments.service.js`)
- User management → SQL repositories: reads and writes (evidence: `server/services/users.service.js`)
- Sign-in service → SQL repositories: reads and updates (evidence: `server/services/auth.service.js`)
- Report calculations → SQLite database: queries (evidence: `server/services/reports.service.js`)
- SQL repositories → SQLite database: queries (evidence: `server/repositories/assignments.repository.js`)
- Entry workflow → Audit logging: logs changes (evidence: `server/services/entries.service.js`)
- Sign-in service → Audit logging: logs events (evidence: `server/services/auth.service.js`)
- Assignments → Audit logging: logs changes (evidence: `server/services/assignments.service.js`)
- Express app → Weekly email job: registers (evidence: `server/index.js`)
- Weekly email job → SQLite database: queries (evidence: `server/jobs/weeklyReport.js`)
