# germanfo1uli/taskflow architecture

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

- Interactive diagram: https://gitdiagram.com/germanfo1uli/taskflow
- Repository: https://github.com/germanfo1uli/taskflow

## Overview

Jiro is a project-management product: users sign in, work with project boards and issues, manage sprints and team settings, and review reports. The frontend hooks make authenticated API requests; backend services expose sprint-management and dashboard/activity endpoints. The dashboard backend also includes persistence models and repositories, while the sprint backend includes persistence and expiration handling. The tree lists dashboard event consumers and a notifications service, but the excerpts do not establish their runtime wiring. Relationships shown below are limited to explicit calls or source-index references; other integrations are omitted where evidence is unavailable.

Main entry points: [`jiroapp/app/auth/hooks/useAuth.ts`](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/auth/hooks/useAuth.ts) (Authentication), [`backend/dashboard-service/Backend.Dashboards.Api/Data/DashboardDbContext.cs`](https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Data/DashboardDbContext.cs) (Dashboard database context), [`backend/sprints-service/Backend.Sprints.Api/Data/SprintsDbContext.cs`](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Data/SprintsDbContext.cs) (Sprint database context), [`jiroapp/app/auth/hooks/useTokenRefresh.ts`](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/auth/hooks/useTokenRefresh.ts) (Token refresh)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_auth["Authentication<br/>[useAuth.ts]"]
  node_token["Token refresh<br/>[useTokenRefresh.ts]"]
  node_dashboard_ui["Boards and issues<br/>[useDashboard.ts]"]
  node_board_manager["Board manager"]
  node_sprint_ui["Sprint workspace<br/>[useSprints.ts]"]
  node_reports_ui["Reports<br/>[useReports.ts]"]
  node_project_ui["Project management<br/>[useProjectData.ts]"]
  node_settings_ui["Team settings<br/>[useRoles.ts]"]
end

subgraph group_sprint_backend["Sprint management"]
  node_sprint_routes["Sprint endpoints"]
  node_sprint_issue_routes["Sprint issue endpoints"]
  node_sprint_service["Sprint operations<br/>[ISprintService.cs]"]
  node_sprint_issue_service["Sprint issue operations"]
  node_expiration["Sprint expiration"]
end

subgraph group_dashboard_backend["Dashboards and activity"]
  node_dashboard_routes["Dashboard endpoints"]
  node_activity_routes["Activity endpoints"]
  node_dashboard_service["Dashboard calculations"]
  node_activity_service["Activity logging"]
end

subgraph group_persistence["Persistence"]
  node_sprint_repo["Sprint repository"]
  node_sprint_db[("Sprint database context")]
  node_sprint_entity["Sprint records<br/>[Sprint.cs]"]
  node_sprint_issue_entity["Sprint issue records<br/>[SprintIssue.cs]"]
  node_activity_repo["Activity repository"]
  node_dashboard_db[("Dashboard database context")]
  node_activity_entity["Activity log records<br/>[ActivityLog.cs]"]
  node_snapshot_entity["Dashboard snapshots"]
end

node_user(("User"))
node_api{{"Product API"}}

node_user -.->|"signs in"| node_auth
node_auth -->|"uses refresh"| node_token
node_auth -->|"auth requests"| node_api
node_token -->|"refreshes tokens"| node_api
node_dashboard_ui -->|"loads and updates"| node_api
node_reports_ui -->|"loads report data"| node_api
node_sprint_ui -.->|"uses sprint API"| node_api
node_project_ui -.->|"uses project API"| node_api
node_settings_ui -.->|"uses settings API"| node_api
node_api -.->|"routes requests"| node_sprint_routes
node_api -.->|"routes requests"| node_dashboard_routes
node_api -.->|"routes requests"| node_activity_routes
node_sprint_routes -->|"calls operations"| node_sprint_service
node_sprint_issue_routes -->|"calls operations"| node_sprint_issue_service
node_expiration -->|"uses repository"| node_sprint_repo
node_sprint_db -->|"maps entities"| node_sprint_entity
node_sprint_db -->|"maps entities"| node_sprint_issue_entity
node_sprint_repo -->|"uses context"| node_sprint_db
node_dashboard_routes -->|"calculates dashboard"| node_dashboard_service
node_activity_routes -->|"loads activity"| node_activity_service
node_activity_repo -->|"uses context"| node_dashboard_db
node_dashboard_db -->|"maps entity"| node_activity_entity
node_dashboard_db -->|"maps entity"| node_snapshot_entity

click node_auth "https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/auth/hooks/useAuth.ts"
click node_token "https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/auth/hooks/useTokenRefresh.ts"
click node_dashboard_ui "https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/DashboardContent/hooks/useDashboard.ts"
click node_board_manager "https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/DashboardContent/components/modal/BoardManagerModal.tsx"
click node_sprint_ui "https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/SprintsContent/hooks/useSprints.ts"
click node_reports_ui "https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/ReportsContent/hooks/useReports.ts"
click node_project_ui "https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/ProjectContent/hooks/useProjectData.ts"
click node_settings_ui "https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/SettingsContent/hooks/useRoles.ts"
click node_sprint_routes "https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Controllers/SprintsController.cs"
click node_sprint_issue_routes "https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Controllers/SprintIssuesController.cs"
click node_sprint_service "https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Services/ISprintService.cs"
click node_sprint_issue_service "https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Services/ISprintIssueService.cs"
click node_expiration "https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Services/SprintExpirationService.cs"
click node_sprint_repo "https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Repositories/SprintRepository.cs"
click node_sprint_db "https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Data/SprintsDbContext.cs"
click node_sprint_entity "https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Models/Entities/Sprint.cs"
click node_sprint_issue_entity "https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Models/Entities/SprintIssue.cs"
click node_dashboard_routes "https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Controllers/DashboardController.cs"
click node_activity_routes "https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Controllers/ActivityController.cs"
click node_dashboard_service "https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Services/DashboardService.cs"
click node_activity_service "https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Services/ActivityLogService.cs"
click node_activity_repo "https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Repositories/ActivityLogRepository.cs"
click node_dashboard_db "https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Data/DashboardDbContext.cs"
click node_activity_entity "https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Models/Entities/ActivityLog.cs"
click node_snapshot_entity "https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Models/Entities/DashboardSnapshot.cs"

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_auth,node_token,node_dashboard_ui,node_board_manager,node_sprint_ui,node_reports_ui,node_project_ui,node_settings_ui,node_user toneBlue
class node_sprint_routes,node_sprint_issue_routes,node_sprint_service,node_sprint_issue_service,node_expiration toneAmber
class node_dashboard_routes,node_activity_routes,node_dashboard_service,node_activity_service,node_api toneMint
class node_sprint_repo,node_sprint_db,node_sprint_entity,node_sprint_issue_entity,node_activity_repo,node_dashboard_db,node_activity_entity,node_snapshot_entity toneRose
```

## Components

### Web application

- [Authentication](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/auth/hooks/useAuth.ts): `jiroapp/app/auth/hooks/useAuth.ts`
- [Token refresh](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/auth/hooks/useTokenRefresh.ts): `jiroapp/app/auth/hooks/useTokenRefresh.ts`
- [Boards and issues](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/DashboardContent/hooks/useDashboard.ts): `jiroapp/app/components/DashboardContent/hooks/useDashboard.ts`
- [Board manager](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/DashboardContent/components/modal/BoardManagerModal.tsx): `jiroapp/app/components/DashboardContent/components/modal/BoardManagerModal.tsx`
- [Sprint workspace](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/SprintsContent/hooks/useSprints.ts): `jiroapp/app/components/SprintsContent/hooks/useSprints.ts`
- [Reports](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/ReportsContent/hooks/useReports.ts): `jiroapp/app/components/ReportsContent/hooks/useReports.ts`
- [Project management](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/ProjectContent/hooks/useProjectData.ts): `jiroapp/app/components/ProjectContent/hooks/useProjectData.ts`
- [Team settings](https://github.com/germanfo1uli/taskflow/blob/main/jiroapp/app/components/SettingsContent/hooks/useRoles.ts): `jiroapp/app/components/SettingsContent/hooks/useRoles.ts`

### Sprint management

- [Sprint endpoints](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Controllers/SprintsController.cs): `backend/sprints-service/Backend.Sprints.Api/Controllers/SprintsController.cs`
- [Sprint issue endpoints](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Controllers/SprintIssuesController.cs): `backend/sprints-service/Backend.Sprints.Api/Controllers/SprintIssuesController.cs`
- [Sprint operations](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Services/ISprintService.cs): `backend/sprints-service/Backend.Sprints.Api/Services/ISprintService.cs`
- [Sprint issue operations](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Services/ISprintIssueService.cs): `backend/sprints-service/Backend.Sprints.Api/Services/ISprintIssueService.cs`
- [Sprint expiration](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Services/SprintExpirationService.cs): `backend/sprints-service/Backend.Sprints.Api/Services/SprintExpirationService.cs`

### Dashboards and activity

- [Dashboard endpoints](https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Controllers/DashboardController.cs): `backend/dashboard-service/Backend.Dashboards.Api/Controllers/DashboardController.cs`
- [Activity endpoints](https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Controllers/ActivityController.cs): `backend/dashboard-service/Backend.Dashboards.Api/Controllers/ActivityController.cs`
- [Dashboard calculations](https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Services/DashboardService.cs): `backend/dashboard-service/Backend.Dashboards.Api/Services/DashboardService.cs`
- [Activity logging](https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Services/ActivityLogService.cs): `backend/dashboard-service/Backend.Dashboards.Api/Services/ActivityLogService.cs`

### Persistence

- [Sprint repository](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Repositories/SprintRepository.cs): `backend/sprints-service/Backend.Sprints.Api/Repositories/SprintRepository.cs`
- [Sprint database context](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Data/SprintsDbContext.cs): `backend/sprints-service/Backend.Sprints.Api/Data/SprintsDbContext.cs`
- [Sprint records](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Models/Entities/Sprint.cs): `backend/sprints-service/Backend.Sprints.Api/Models/Entities/Sprint.cs`
- [Sprint issue records](https://github.com/germanfo1uli/taskflow/blob/main/backend/sprints-service/Backend.Sprints.Api/Models/Entities/SprintIssue.cs): `backend/sprints-service/Backend.Sprints.Api/Models/Entities/SprintIssue.cs`
- [Activity repository](https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Repositories/ActivityLogRepository.cs): `backend/dashboard-service/Backend.Dashboards.Api/Repositories/ActivityLogRepository.cs`
- [Dashboard database context](https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Data/DashboardDbContext.cs): `backend/dashboard-service/Backend.Dashboards.Api/Data/DashboardDbContext.cs`
- [Activity log records](https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Models/Entities/ActivityLog.cs): `backend/dashboard-service/Backend.Dashboards.Api/Models/Entities/ActivityLog.cs`
- [Dashboard snapshots](https://github.com/germanfo1uli/taskflow/blob/main/backend/dashboard-service/Backend.Dashboards.Api/Models/Entities/DashboardSnapshot.cs): `backend/dashboard-service/Backend.Dashboards.Api/Models/Entities/DashboardSnapshot.cs`

### Other components

- **User**
- **Product API**

## Connections

- User → Authentication: signs in
- Authentication → Token refresh: uses refresh (evidence: `jiroapp/app/auth/hooks/useAuth.ts`)
- Authentication → Product API: auth requests (evidence: `jiroapp/app/auth/hooks/useAuth.ts`)
- Token refresh → Product API: refreshes tokens (evidence: `jiroapp/app/auth/hooks/useTokenRefresh.ts`)
- Boards and issues → Product API: loads and updates (evidence: `jiroapp/app/components/DashboardContent/hooks/useDashboard.ts`)
- Reports → Product API: loads report data (evidence: `jiroapp/app/components/ReportsContent/hooks/useReports.ts`)
- Sprint workspace → Product API: uses sprint API
- Project management → Product API: uses project API
- Team settings → Product API: uses settings API
- Product API → Sprint endpoints: routes requests
- Product API → Dashboard endpoints: routes requests
- Product API → Activity endpoints: routes requests
- Sprint endpoints → Sprint operations: calls operations (evidence: `backend/sprints-service/Backend.Sprints.Api/Controllers/SprintsController.cs`)
- Sprint issue endpoints → Sprint issue operations: calls operations (evidence: `backend/sprints-service/Backend.Sprints.Api/Controllers/SprintIssuesController.cs`)
- Sprint expiration → Sprint repository: uses repository (evidence: `backend/sprints-service/Backend.Sprints.Api/Services/SprintExpirationService.cs`)
- Sprint database context → Sprint records: maps entities (evidence: `backend/sprints-service/Backend.Sprints.Api/Data/SprintsDbContext.cs`)
- Sprint database context → Sprint issue records: maps entities (evidence: `backend/sprints-service/Backend.Sprints.Api/Data/SprintsDbContext.cs`)
- Sprint repository → Sprint database context: uses context
- Dashboard endpoints → Dashboard calculations: calculates dashboard (evidence: `backend/dashboard-service/Backend.Dashboards.Api/Controllers/DashboardController.cs`)
- Activity endpoints → Activity logging: loads activity (evidence: `backend/dashboard-service/Backend.Dashboards.Api/Controllers/ActivityController.cs`)
- Activity repository → Dashboard database context: uses context (evidence: `backend/dashboard-service/Backend.Dashboards.Api/Repositories/ActivityLogRepository.cs`)
- Dashboard database context → Activity log records: maps entity (evidence: `backend/dashboard-service/Backend.Dashboards.Api/Data/DashboardDbContext.cs`)
- Dashboard database context → Dashboard snapshots: maps entity (evidence: `backend/dashboard-service/Backend.Dashboards.Api/Data/DashboardDbContext.cs`)
