# studio-1947/task-tracker-s47 architecture

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

- Interactive diagram: https://gitdiagram.com/studio-1947/task-tracker-s47
- Repository: https://github.com/studio-1947/task-tracker-s47

## Overview

Task Tracker is a self-hosted team task-management product. Members sign in, select a workspace, and manage tasks through list, table, or Kanban views; task changes are audited and reflected in workspace dashboards. The product also supports projects, labels, meetings, attendance, chat, organisation management, and reporting. The graph follows the sampled web-to-task API path and includes these documented product branches. Several backend implementations were not sampled, so their internal call and persistence links are omitted rather than inferred.

Main entry points: [`apps/api/src/tasks/tasks.controller.ts`](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/tasks/tasks.controller.ts) (Task routes), [`apps/web/src/stores/auth.ts`](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/stores/auth.ts) (Auth state), [`apps/api/src/tasks/tasks.service.ts`](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/tasks/tasks.service.ts) (Task operations), [`apps/web/src/lib/api.ts`](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/lib/api.ts) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Web app routes<br/>[App.tsx]"]
  node_workspace_board["Workspace board"]
  node_task_hooks["Task data hooks<br/>[useTasks.ts]"]
  node_http_client["HTTP client<br/>[api.ts]"]
  node_auth_state["Auth state<br/>[auth.ts]"]
end

subgraph group_task_api["Task API"]
  node_task_routes["Task routes"]
  node_task_logic["Task operations<br/>[tasks.service.ts]"]
  node_audit["Task audit<br/>[audit.service.ts]"]
end

subgraph group_team_features["Team features"]
  node_dashboard["Dashboards"]
  node_meetings["Meeting board"]
  node_attendance["Attendance"]
  node_chat["Team chat<br/>[chat.service.ts]"]
  node_organisation["Organisation"]
  node_search["Search<br/>[search.service.ts]"]
  node_files["File handling<br/>[files.service.ts]"]
  node_users["User management<br/>[users.service.ts]"]
  node_workspaces["Workspace management"]
end

subgraph group_shared_data["Shared data"]
  node_shared_schemas["Shared schemas"]
  node_database[("PostgreSQL data<br/>[index.ts]")]
end

node_member(("Team member"))

node_member -->|"uses"| node_app
node_app -->|"routes to"| node_workspace_board
node_workspace_board -->|"uses"| node_task_hooks
node_task_hooks -->|"requests through"| node_http_client
node_http_client -->|"sends API requests"| node_task_routes
node_task_routes -->|"dispatches to"| node_task_logic
node_member -->|"signs in"| node_auth_state
node_auth_state -->|"calls"| node_http_client
node_task_logic -->|"records mutations"| node_audit
node_task_logic -.->|"persists task data"| node_database
node_audit -.->|"stores audit rows"| node_database
node_member -->|"views"| node_dashboard
node_member -->|"plans meetings"| node_meetings
node_member -.->|"records attendance"| node_attendance
node_member -.->|"uses chat"| node_chat
node_member -.->|"views organisation"| node_organisation
node_member -.->|"searches"| node_search
node_task_routes -->|"serves attachments"| node_files
node_member -->|"administers users"| node_users
node_member -->|"manages workspaces"| node_workspaces
node_task_routes -->|"validates requests"| node_shared_schemas
node_auth_state -->|"uses shared types"| node_shared_schemas

click node_app "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/App.tsx"
click node_workspace_board "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/pages/WorkspaceTasksPage.tsx"
click node_task_hooks "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/hooks/useTasks.ts"
click node_http_client "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/lib/api.ts"
click node_auth_state "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/stores/auth.ts"
click node_task_routes "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/tasks/tasks.controller.ts"
click node_task_logic "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/tasks/tasks.service.ts"
click node_audit "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/audit/audit.service.ts"
click node_dashboard "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/dashboard/dashboard.service.ts"
click node_meetings "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/meetings/meetings.service.ts"
click node_attendance "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/attendance/attendance.service.ts"
click node_chat "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/chat/chat.service.ts"
click node_organisation "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/organisation/organisation.service.ts"
click node_search "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/search/search.service.ts"
click node_files "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/files/files.service.ts"
click node_users "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/users/users.service.ts"
click node_workspaces "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/workspaces/workspaces.service.ts"
click node_shared_schemas "https://github.com/studio-1947/task-tracker-s47/tree/main/packages/shared/src"
click node_database "https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/database/schema/index.ts"

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_workspace_board,node_task_hooks,node_http_client,node_auth_state toneBlue
class node_task_routes,node_task_logic,node_audit toneAmber
class node_dashboard,node_meetings,node_attendance,node_chat,node_organisation,node_search,node_files,node_users,node_workspaces toneMint
class node_shared_schemas,node_database toneRose
class node_member toneIndigo
```

## Components

### Web application

- [Web app routes](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Workspace board](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/pages/WorkspaceTasksPage.tsx): `apps/web/src/pages/WorkspaceTasksPage.tsx`
- [Task data hooks](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/hooks/useTasks.ts): `apps/web/src/hooks/useTasks.ts`
- [HTTP client](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/lib/api.ts): `apps/web/src/lib/api.ts`
- [Auth state](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/web/src/stores/auth.ts): `apps/web/src/stores/auth.ts`

### Task API

- [Task routes](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/tasks/tasks.controller.ts): `apps/api/src/tasks/tasks.controller.ts`
- [Task operations](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/tasks/tasks.service.ts): `apps/api/src/tasks/tasks.service.ts`
- [Task audit](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/audit/audit.service.ts): `apps/api/src/audit/audit.service.ts`

### Team features

- [Dashboards](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/dashboard/dashboard.service.ts): `apps/api/src/dashboard/dashboard.service.ts`
- [Meeting board](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/meetings/meetings.service.ts): `apps/api/src/meetings/meetings.service.ts`
- [Attendance](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/attendance/attendance.service.ts): `apps/api/src/attendance/attendance.service.ts`
- [Team chat](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/chat/chat.service.ts): `apps/api/src/chat/chat.service.ts`
- [Organisation](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/organisation/organisation.service.ts): `apps/api/src/organisation/organisation.service.ts`
- [Search](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/search/search.service.ts): `apps/api/src/search/search.service.ts`
- [File handling](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/files/files.service.ts): `apps/api/src/files/files.service.ts`
- [User management](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/users/users.service.ts): `apps/api/src/users/users.service.ts`
- [Workspace management](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/workspaces/workspaces.service.ts): `apps/api/src/workspaces/workspaces.service.ts`

### Shared data

- [Shared schemas](https://github.com/studio-1947/task-tracker-s47/tree/main/packages/shared/src): `packages/shared/src`
- [PostgreSQL data](https://github.com/studio-1947/task-tracker-s47/blob/main/apps/api/src/database/schema/index.ts): `apps/api/src/database/schema/index.ts`

### Other components

- **Team member**

## Connections

- Team member → Web app routes: uses (evidence: `README.md`)
- Web app routes → Workspace board: routes to (evidence: `apps/web/src/App.tsx`)
- Workspace board → Task data hooks: uses (evidence: `apps/web/src/pages/WorkspaceTasksPage.tsx`)
- Task data hooks → HTTP client: requests through (evidence: `apps/web/src/hooks/useTasks.ts`)
- HTTP client → Task routes: sends API requests
- Task routes → Task operations: dispatches to (evidence: `apps/api/src/tasks/tasks.controller.ts`)
- Team member → Auth state: signs in (evidence: `README.md`)
- Auth state → HTTP client: calls (evidence: `apps/web/src/stores/auth.ts`)
- Task operations → Task audit: records mutations (evidence: `README.md`)
- Task operations → PostgreSQL data: persists task data
- Task audit → PostgreSQL data: stores audit rows
- Team member → Dashboards: views (evidence: `README.md`)
- Team member → Meeting board: plans meetings (evidence: `README.md`)
- Team member → Attendance: records attendance
- Team member → Team chat: uses chat
- Team member → Organisation: views organisation
- Team member → Search: searches
- Task routes → File handling: serves attachments (evidence: `apps/api/src/tasks/tasks.controller.ts`)
- Team member → User management: administers users (evidence: `README.md`)
- Team member → Workspace management: manages workspaces (evidence: `README.md`)
- Task routes → Shared schemas: validates requests (evidence: `apps/api/src/tasks/tasks.controller.ts`)
- Auth state → Shared schemas: uses shared types (evidence: `apps/web/src/stores/auth.ts`)
