# govinddangi4564/collaborative-workflow-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/govinddangi4564/collaborative-workflow-management-system
- Repository: https://github.com/govinddangi4564/collaborative-workflow-management-system

## Overview

This is a Spring Boot REST API for collaborative, Jira-style workflow management. Clients create projects, add boards, manage tickets and users, and attach comments; ticket history and optimistic locking are additional capabilities. The graph follows documented endpoints and the sampled controller/service/repository relationships. Persistence wiring and several service implementations were not sampled, so some storage links are dashed or omitted rather than inferred from naming.

Main entry points: [`workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketService.java`](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketService.java) (Ticket Service), [`workflow-management-system/src/main/java/com/govind/Workflow_Management/service/CommentService.java`](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/CommentService.java) (Comment Service), [`workflow-management-system/src/main/java/com/govind/Workflow_Management/entity`](https://github.com/govinddangi4564/collaborative-workflow-management-system/tree/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/entity) (Workflow Entities), [`workflow-management-system/src/main/java/com/govind/Workflow_Management/service/BoardService.java`](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/BoardService.java) (Board Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_projects_api["Projects API"]
  node_boards_api["Boards API"]
  node_tickets_api["Tickets API"]
  node_comments_api["Comments API"]
  node_users_api["Users API"]
  node_history_api["Ticket History API"]
end

subgraph group_workflow["Workflow Management"]
  node_project_service["Project Service"]
  node_board_service["Board Service<br/>[BoardService.java]"]
  node_ticket_service["Ticket Service<br/>[TicketService.java]"]
  node_domain_entities[("Workflow Entities")]
end

subgraph group_collaboration["Collaboration"]
  node_comment_service["Comment Service"]
  node_user_service["User Service<br/>[UserService.java]"]
end

subgraph group_persistence["Persistence and History"]
  node_history_service["Revision Service"]
  node_project_repo["Project Repository"]
  node_board_repo["Board Repository"]
  node_ticket_repo["Ticket Repository"]
  node_comment_repo["Comment Repository"]
  node_user_repo["User Repository"]
  node_postgres[("PostgreSQL")]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_projects_api
node_client -->|"sends requests"| node_boards_api
node_client -->|"sends requests"| node_tickets_api
node_client -->|"sends requests"| node_comments_api
node_client -->|"sends requests"| node_users_api
node_client -->|"requests history"| node_history_api
node_projects_api -->|"delegates"| node_project_service
node_boards_api -->|"delegates"| node_board_service
node_tickets_api -->|"delegates"| node_ticket_service
node_comments_api -->|"delegates"| node_comment_service
node_users_api -->|"delegates"| node_user_service
node_history_api -.->|"delegates"| node_history_service
node_project_service -->|"reads and saves"| node_project_repo
node_board_service -->|"loads project"| node_project_repo
node_board_service -->|"reads and saves"| node_board_repo
node_ticket_service -->|"loads board"| node_board_repo
node_ticket_service -->|"loads assignee"| node_user_repo
node_ticket_service -->|"reads and saves"| node_ticket_repo
node_comment_service -->|"loads ticket"| node_ticket_repo
node_comment_service -->|"loads author"| node_user_repo
node_comment_service -->|"reads and saves"| node_comment_repo
node_user_service -->|"reads and saves"| node_user_repo
node_project_service -->|"creates projects"| node_domain_entities
node_board_service -->|"creates boards"| node_domain_entities
node_ticket_service -->|"creates tickets"| node_domain_entities
node_comment_service -->|"creates comments"| node_domain_entities
node_project_repo -.->|"persists entities"| node_postgres
node_board_repo -.->|"persists entities"| node_postgres
node_ticket_repo -.->|"persists entities"| node_postgres
node_comment_repo -.->|"persists entities"| node_postgres
node_user_repo -.->|"persists entities"| node_postgres
node_history_service -->|"audits tickets"| node_domain_entities

click node_projects_api "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/ProjectController.java"
click node_boards_api "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/BoardController.java"
click node_tickets_api "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/TicketController.java"
click node_comments_api "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/CommentController.java"
click node_users_api "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/UserController.java"
click node_history_api "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/TicketRevisionController.java"
click node_project_service "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/ProjectService.java"
click node_board_service "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/BoardService.java"
click node_ticket_service "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketService.java"
click node_comment_service "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/CommentService.java"
click node_user_service "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/UserService.java"
click node_history_service "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketRevisionService.java"
click node_project_repo "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/ProjectRepository.java"
click node_board_repo "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/BoardRepository.java"
click node_ticket_repo "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/TicketRepository.java"
click node_comment_repo "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/CommentRepository.java"
click node_user_repo "https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/UserRepository.java"
click node_domain_entities "https://github.com/govinddangi4564/collaborative-workflow-management-system/tree/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/entity"

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_projects_api,node_boards_api,node_tickets_api,node_comments_api,node_users_api,node_history_api,node_client toneBlue
class node_project_service,node_board_service,node_ticket_service,node_domain_entities toneAmber
class node_comment_service,node_user_service toneMint
class node_history_service,node_project_repo,node_board_repo,node_ticket_repo,node_comment_repo,node_user_repo,node_postgres toneRose
```

## Components

### REST API

- [Projects API](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/ProjectController.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/ProjectController.java`
- [Boards API](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/BoardController.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/BoardController.java`
- [Tickets API](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/TicketController.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/TicketController.java`
- [Comments API](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/CommentController.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/CommentController.java`
- [Users API](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/UserController.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/UserController.java`
- [Ticket History API](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/TicketRevisionController.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/TicketRevisionController.java`

### Workflow Management

- [Project Service](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/ProjectService.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/ProjectService.java`
- [Board Service](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/BoardService.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/BoardService.java`
- [Ticket Service](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketService.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketService.java`
- [Workflow Entities](https://github.com/govinddangi4564/collaborative-workflow-management-system/tree/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/entity): `workflow-management-system/src/main/java/com/govind/Workflow_Management/entity`

### Collaboration

- [Comment Service](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/CommentService.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/CommentService.java`
- [User Service](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/UserService.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/UserService.java`

### Persistence and History

- [Revision Service](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketRevisionService.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketRevisionService.java`
- [Project Repository](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/ProjectRepository.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/ProjectRepository.java`
- [Board Repository](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/BoardRepository.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/BoardRepository.java`
- [Ticket Repository](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/TicketRepository.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/TicketRepository.java`
- [Comment Repository](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/CommentRepository.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/CommentRepository.java`
- [User Repository](https://github.com/govinddangi4564/collaborative-workflow-management-system/blob/main/workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/UserRepository.java): `workflow-management-system/src/main/java/com/govind/Workflow_Management/repository/UserRepository.java`
- **PostgreSQL**

### Other components

- **API Client**

## Connections

- API Client → Projects API: sends requests
- API Client → Boards API: sends requests
- API Client → Tickets API: sends requests
- API Client → Comments API: sends requests
- API Client → Users API: sends requests
- API Client → Ticket History API: requests history
- Projects API → Project Service: delegates (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/ProjectController.java`)
- Boards API → Board Service: delegates (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/BoardController.java`)
- Tickets API → Ticket Service: delegates (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/TicketController.java`)
- Comments API → Comment Service: delegates (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/CommentController.java`)
- Users API → User Service: delegates (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/UserController.java`)
- Ticket History API → Revision Service: delegates (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/controller/TicketRevisionController.java`)
- Project Service → Project Repository: reads and saves (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/ProjectService.java`)
- Board Service → Project Repository: loads project (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/BoardService.java`)
- Board Service → Board Repository: reads and saves (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/BoardService.java`)
- Ticket Service → Board Repository: loads board (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketService.java`)
- Ticket Service → User Repository: loads assignee (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketService.java`)
- Ticket Service → Ticket Repository: reads and saves (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketService.java`)
- Comment Service → Ticket Repository: loads ticket (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/CommentService.java`)
- Comment Service → User Repository: loads author (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/CommentService.java`)
- Comment Service → Comment Repository: reads and saves (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/CommentService.java`)
- User Service → User Repository: reads and saves (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/UserService.java`)
- Project Service → Workflow Entities: creates projects (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/ProjectService.java`)
- Board Service → Workflow Entities: creates boards (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/BoardService.java`)
- Ticket Service → Workflow Entities: creates tickets (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketService.java`)
- Comment Service → Workflow Entities: creates comments (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/CommentService.java`)
- Project Repository → PostgreSQL: persists entities
- Board Repository → PostgreSQL: persists entities
- Ticket Repository → PostgreSQL: persists entities
- Comment Repository → PostgreSQL: persists entities
- User Repository → PostgreSQL: persists entities
- Revision Service → Workflow Entities: audits tickets (evidence: `workflow-management-system/src/main/java/com/govind/Workflow_Management/service/TicketRevisionService.java`)
