# joindesk/joindesk architecture

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

- Interactive diagram: https://gitdiagram.com/joindesk/joindesk
- Repository: https://github.com/joindesk/joindesk

## Overview

Joindesk is a project-management application with an Angular client, Spring backend, and PostgreSQL persistence. A principal workflow is an authenticated user creating or updating an issue, which is represented in the issue UI/service and handled by backend issue logic. The README also identifies boards, calendar and Gantt views, custom workflows and fields, releases, wiki, webhooks, access control, and firewall capabilities. Connections between sampled frontend and backend are not shown directly, so that boundary is marked unverified; unsampled feature branches are retained without invented call chains.

Main entry points: [`Frontend/src/app/app.module.ts`](https://github.com/joindesk/joindesk/blob/main/Frontend/src/app/app.module.ts) (App shell), [`Backend/src/main/java/com/ariseontech/joindesk/auth/service/AuthService.java`](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/auth/service/AuthService.java) (Authentication API), [`Backend/src/main/java/com/ariseontech/joindesk/issues/service/IssueService.java`](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/issues/service/IssueService.java) (Issue handling), [`Frontend/src/app/auth/authentication.service.ts`](https://github.com/joindesk/joindesk/blob/main/Frontend/src/app/auth/authentication.service.ts) (Login and auth)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_frontend["App shell<br/>[app.module.ts]"]
  node_authui["Login and auth"]
  node_issueui["Issue interface<br/>[issue.service.ts]"]
  node_views["Planning views"]
  node_account["Account controls"]
end

subgraph group_identity["Identity and access"]
  node_authapi["Authentication API<br/>[AuthService.java]"]
  node_userdata[("User records<br/>[Login.java]")]
  node_firewall["IP access rules"]
end

subgraph group_work["Issue delivery"]
  node_issueapi["Issue handling<br/>[IssueService.java]"]
  node_workflow["Workflow rules"]
  node_issuedata[("Issue records<br/>[IssueRepo.java]")]
  node_board["Kanban boards"]
  node_reports["Calendar and reports"]
end

subgraph group_project["Project configuration"]
  node_projects["Project management"]
  node_configuration["Project configuration"]
  node_releases["Versions and releases"]
end

subgraph group_collaboration["Knowledge and integrations"]
  node_wiki["Wiki pages<br/>[WikiService.java]"]
  node_webhooks["Webhooks"]
  node_slack["Slack integration<br/>[SlackService.java]"]
end

node_user(("Project user"))

node_user -->|"uses"| node_frontend
node_frontend -->|"registers"| node_authui
node_frontend -->|"registers"| node_issueui
node_user -.->|"signs in"| node_authui
node_authui -.->|"requests auth"| node_authapi
node_authapi -->|"reads and saves"| node_userdata
node_authapi -->|"checks access"| node_firewall
node_issueui -.->|"requests issues"| node_issueapi
node_issueapi -->|"persists issues"| node_issuedata
node_issueapi -.->|"uses transitions"| node_workflow
node_user -.->|"plans work"| node_views
node_user -.->|"tracks work"| node_board
node_user -.->|"views schedules"| node_reports
node_user -.->|"manages projects"| node_projects
node_projects -.->|"configures"| node_configuration
node_user -.->|"manages releases"| node_releases
node_user -.->|"uses wiki"| node_wiki
node_user -.->|"configures hooks"| node_webhooks
node_user -.->|"uses integration"| node_slack
node_user -.->|"manages account"| node_account

click node_frontend "https://github.com/joindesk/joindesk/blob/main/Frontend/src/app/app.module.ts"
click node_authui "https://github.com/joindesk/joindesk/blob/main/Frontend/src/app/auth/authentication.service.ts"
click node_issueui "https://github.com/joindesk/joindesk/blob/main/Frontend/src/app/app/issue/issue.service.ts"
click node_views "https://github.com/joindesk/joindesk/tree/main/Frontend/src/app/app/dashboard"
click node_account "https://github.com/joindesk/joindesk/tree/main/Frontend/src/app/app/myaccount"
click node_authapi "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/auth/service/AuthService.java"
click node_userdata "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/auth/domain/Login.java"
click node_issueapi "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/issues/service/IssueService.java"
click node_workflow "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/issues/service/WorkflowService.java"
click node_issuedata "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/issues/repo/IssueRepo.java"
click node_board "https://github.com/joindesk/joindesk/tree/main/Backend/src/main/java/com/ariseontech/joindesk/board"
click node_reports "https://github.com/joindesk/joindesk/tree/main/Backend/src/main/java/com/ariseontech/joindesk/issues/service"
click node_projects "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/project/service/ProjectService.java"
click node_configuration "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/project/service/ConfigurationService.java"
click node_releases "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/issues/service/VersionService.java"
click node_wiki "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/wiki/service/WikiService.java"
click node_webhooks "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/webhook/service/WebHookService.java"
click node_slack "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/slack/SlackService.java"
click node_firewall "https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/auth/service/IPWhiteBlackListingService.java"

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_frontend,node_authui,node_issueui,node_views,node_account,node_user toneBlue
class node_authapi,node_userdata,node_firewall toneAmber
class node_issueapi,node_workflow,node_issuedata,node_board,node_reports toneMint
class node_projects,node_configuration,node_releases toneRose
class node_wiki,node_webhooks,node_slack toneIndigo
```

## Components

### Angular client

- [App shell](https://github.com/joindesk/joindesk/blob/main/Frontend/src/app/app.module.ts): `Frontend/src/app/app.module.ts`
- [Login and auth](https://github.com/joindesk/joindesk/blob/main/Frontend/src/app/auth/authentication.service.ts): `Frontend/src/app/auth/authentication.service.ts`
- [Issue interface](https://github.com/joindesk/joindesk/blob/main/Frontend/src/app/app/issue/issue.service.ts): `Frontend/src/app/app/issue/issue.service.ts`
- [Planning views](https://github.com/joindesk/joindesk/tree/main/Frontend/src/app/app/dashboard): `Frontend/src/app/app/dashboard`
- [Account controls](https://github.com/joindesk/joindesk/tree/main/Frontend/src/app/app/myaccount): `Frontend/src/app/app/myaccount`

### Identity and access

- [Authentication API](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/auth/service/AuthService.java): `Backend/src/main/java/com/ariseontech/joindesk/auth/service/AuthService.java`
- [User records](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/auth/domain/Login.java): `Backend/src/main/java/com/ariseontech/joindesk/auth/domain/Login.java`
- [IP access rules](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/auth/service/IPWhiteBlackListingService.java): `Backend/src/main/java/com/ariseontech/joindesk/auth/service/IPWhiteBlackListingService.java`

### Issue delivery

- [Issue handling](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/issues/service/IssueService.java): `Backend/src/main/java/com/ariseontech/joindesk/issues/service/IssueService.java`
- [Workflow rules](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/issues/service/WorkflowService.java): `Backend/src/main/java/com/ariseontech/joindesk/issues/service/WorkflowService.java`
- [Issue records](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/issues/repo/IssueRepo.java): `Backend/src/main/java/com/ariseontech/joindesk/issues/repo/IssueRepo.java`
- [Kanban boards](https://github.com/joindesk/joindesk/tree/main/Backend/src/main/java/com/ariseontech/joindesk/board): `Backend/src/main/java/com/ariseontech/joindesk/board`
- [Calendar and reports](https://github.com/joindesk/joindesk/tree/main/Backend/src/main/java/com/ariseontech/joindesk/issues/service): `Backend/src/main/java/com/ariseontech/joindesk/issues/service`

### Project configuration

- [Project management](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/project/service/ProjectService.java): `Backend/src/main/java/com/ariseontech/joindesk/project/service/ProjectService.java`
- [Project configuration](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/project/service/ConfigurationService.java): `Backend/src/main/java/com/ariseontech/joindesk/project/service/ConfigurationService.java`
- [Versions and releases](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/issues/service/VersionService.java): `Backend/src/main/java/com/ariseontech/joindesk/issues/service/VersionService.java`

### Knowledge and integrations

- [Wiki pages](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/wiki/service/WikiService.java): `Backend/src/main/java/com/ariseontech/joindesk/wiki/service/WikiService.java`
- [Webhooks](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/webhook/service/WebHookService.java): `Backend/src/main/java/com/ariseontech/joindesk/webhook/service/WebHookService.java`
- [Slack integration](https://github.com/joindesk/joindesk/blob/main/Backend/src/main/java/com/ariseontech/joindesk/slack/SlackService.java): `Backend/src/main/java/com/ariseontech/joindesk/slack/SlackService.java`

### Other components

- **Project user**

## Connections

- Project user → App shell: uses (evidence: `Frontend/src/app/app.module.ts`)
- App shell → Login and auth: registers (evidence: `Frontend/src/app/app.module.ts`)
- App shell → Issue interface: registers (evidence: `Frontend/src/app/app.module.ts`)
- Project user → Login and auth: signs in
- Login and auth → Authentication API: requests auth
- Authentication API → User records: reads and saves (evidence: `Backend/src/main/java/com/ariseontech/joindesk/auth/service/AuthService.java`)
- Authentication API → IP access rules: checks access (evidence: `Backend/src/main/java/com/ariseontech/joindesk/auth/service/AuthService.java`)
- Issue interface → Issue handling: requests issues
- Issue handling → Issue records: persists issues (evidence: `Backend/src/main/java/com/ariseontech/joindesk/issues/service/IssueService.java`)
- Issue handling → Workflow rules: uses transitions (evidence: `Backend/src/main/java/com/ariseontech/joindesk/issues/service/IssueService.java`)
- Project user → Planning views: plans work
- Project user → Kanban boards: tracks work
- Project user → Calendar and reports: views schedules
- Project user → Project management: manages projects
- Project management → Project configuration: configures
- Project user → Versions and releases: manages releases
- Project user → Wiki pages: uses wiki
- Project user → Webhooks: configures hooks
- Project user → Slack integration: uses integration
- Project user → Account controls: manages account
