# webenred/project-management-application-for-researchers architecture

> Architecture diagram of the GitHub repository webenred/project-management-application-for-researchers, 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/webenred/project-management-application-for-researchers
- Repository: https://github.com/webenred/project-management-application-for-researchers

## Overview

This Laravel/Inertia application supports project proposals and versioning, board review, and a task-workspace Kanban, alongside account and administrative management. A central workflow creates or edits a project version, persists it through the project service, and tracks version state for review; board decisions update project status, while workspace actions change task status. The graph also includes user/organization administration and the project/task domain layer. The README is empty; several controllers and frontend paths are listed but not sampled, so uncertain links are omitted or marked unverified.

Main entry points: [`app/Http/Controllers/Project/ProjectVersionController.php`](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Project/ProjectVersionController.php) (Project version flow), [`app/Http/Controllers/Board/BoardController.php`](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Board/BoardController.php) (Board review), [`app/Http/Controllers/Workspace/KanbanController.php`](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Workspace/KanbanController.php) (Kanban actions), [`app/Models/Project.php`](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/Project.php) (Project)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_projects["Projects and versions"]
  node_project_versions["Project version flow"]
  node_project_service["Project service<br/>[Project.php]"]
  node_version_store[("Version records<br/>[Version.php]")]
  node_version_validation["Version validation<br/>[StoreRequest.php]"]
end

subgraph group_review["Review and boards"]
  node_board_controller["Board review"]
  node_status_job["Project status job"]
  node_project_events["Project events"]
end

subgraph group_workspace["Workspace tasks"]
  node_kanban["Kanban actions"]
  node_workspace_ui["Workspace interface<br/>[kanban.tsx]"]
end

subgraph group_admin["Accounts and administration"]
  node_manage_users["User administration<br/>[UserController.php]"]
  node_auth["Authentication"]
  node_permission["Permission service"]
end

subgraph group_domain["Domain model"]
  node_project[("Project<br/>[Project.php]")]
  node_domain_nature[("Domain and nature<br/>[Domain.php]")]
  node_board[("Board<br/>[Board.php]")]
  node_task[("Task<br/>[Task.php]")]
  node_task_history[("Task status history")]
  node_task_status["Task status values<br/>[TaskStatus.php]"]
  node_user_model[("User accounts<br/>[User.php]")]
end

node_user(("User"))

node_user -.->|"submits versions"| node_project_versions
node_project_versions -->|"updates project"| node_project
node_project_versions -->|"delegates changes"| node_project_service
node_project_versions -->|"creates versions"| node_version_store
node_project_versions -->|"accepts validated input"| node_version_validation
node_project_versions -->|"loads choices"| node_domain_nature
node_project -->|"uses versioning"| node_version_store
node_board_controller -->|"reads decisions"| node_board
node_board_controller -->|"loads project"| node_project
node_board_controller -->|"dispatches status update"| node_status_job
node_board_controller -->|"dispatches decision event"| node_project_events
node_kanban -->|"updates task state"| node_task
node_kanban -->|"sets statuses"| node_task_status
node_task -->|"has status histories"| node_task_history
node_manage_users -->|"creates and updates"| node_user_model
node_manage_users -.->|"loads access data"| node_permission
node_auth -.->|"authenticates accounts"| node_user_model
node_workspace_ui -.->|"uses Kanban actions"| node_kanban

click node_project_versions "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Project/ProjectVersionController.php"
click node_project_service "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Services/Project/Project.php"
click node_version_store "https://github.com/webenred/project-management-application-for-researchers/blob/main/Modules/Versioning/app/Models/Version.php"
click node_version_validation "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Requests/Version/StoreRequest.php"
click node_project "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/Project.php"
click node_domain_nature "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/Domain.php"
click node_board_controller "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Board/BoardController.php"
click node_board "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/Board.php"
click node_status_job "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Jobs/Project/UpdateProjectStatusJob.php"
click node_project_events "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Events/Project/ProjectAccepted.php"
click node_kanban "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Workspace/KanbanController.php"
click node_task "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/Task.php"
click node_task_history "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/TaskStatusHistory.php"
click node_task_status "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Enums/TaskStatus.php"
click node_manage_users "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Manage/UserController.php"
click node_user_model "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/User.php"
click node_auth "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_permission "https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Services/Permission/PermissionService.php"
click node_workspace_ui "https://github.com/webenred/project-management-application-for-researchers/blob/main/resources/js/Pages/Workspace/kanban.tsx"

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_project_versions,node_project_service,node_version_store,node_version_validation,node_user toneBlue
class node_board_controller,node_status_job,node_project_events toneAmber
class node_kanban,node_workspace_ui toneMint
class node_manage_users,node_auth,node_permission toneRose
class node_project,node_domain_nature,node_board,node_task,node_task_history,node_task_status,node_user_model toneIndigo
```

## Components

### Projects and versions

- [Project version flow](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Project/ProjectVersionController.php): `app/Http/Controllers/Project/ProjectVersionController.php`
- [Project service](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Services/Project/Project.php): `app/Services/Project/Project.php`
- [Version records](https://github.com/webenred/project-management-application-for-researchers/blob/main/Modules/Versioning/app/Models/Version.php): `Modules/Versioning/app/Models/Version.php`
- [Version validation](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Requests/Version/StoreRequest.php): `app/Http/Requests/Version/StoreRequest.php`

### Review and boards

- [Board review](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Board/BoardController.php): `app/Http/Controllers/Board/BoardController.php`
- [Project status job](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Jobs/Project/UpdateProjectStatusJob.php): `app/Jobs/Project/UpdateProjectStatusJob.php`
- [Project events](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Events/Project/ProjectAccepted.php): `app/Events/Project/ProjectAccepted.php`

### Workspace tasks

- [Kanban actions](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Workspace/KanbanController.php): `app/Http/Controllers/Workspace/KanbanController.php`
- [Workspace interface](https://github.com/webenred/project-management-application-for-researchers/blob/main/resources/js/Pages/Workspace/kanban.tsx): `resources/js/Pages/Workspace/kanban.tsx`

### Accounts and administration

- [User administration](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Manage/UserController.php): `app/Http/Controllers/Manage/UserController.php`
- [Authentication](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Permission service](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Services/Permission/PermissionService.php): `app/Services/Permission/PermissionService.php`

### Domain model

- [Project](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/Project.php): `app/Models/Project.php`
- [Domain and nature](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/Domain.php): `app/Models/Domain.php`
- [Board](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/Board.php): `app/Models/Board.php`
- [Task](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/Task.php): `app/Models/Task.php`
- [Task status history](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/TaskStatusHistory.php): `app/Models/TaskStatusHistory.php`
- [Task status values](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Enums/TaskStatus.php): `app/Enums/TaskStatus.php`
- [User accounts](https://github.com/webenred/project-management-application-for-researchers/blob/main/app/Models/User.php): `app/Models/User.php`

### Other components

- **User**

## Connections

- User → Project version flow: submits versions
- Project version flow → Project: updates project (evidence: `app/Http/Controllers/Project/ProjectVersionController.php`)
- Project version flow → Project service: delegates changes (evidence: `app/Http/Controllers/Project/ProjectVersionController.php`)
- Project version flow → Version records: creates versions (evidence: `app/Http/Controllers/Project/ProjectVersionController.php`)
- Project version flow → Version validation: accepts validated input (evidence: `app/Http/Controllers/Project/ProjectVersionController.php`)
- Project version flow → Domain and nature: loads choices (evidence: `app/Http/Controllers/Project/ProjectVersionController.php`)
- Project → Version records: uses versioning (evidence: `app/Models/Project.php`)
- Board review → Board: reads decisions (evidence: `app/Http/Controllers/Board/BoardController.php`)
- Board review → Project: loads project (evidence: `app/Http/Controllers/Board/BoardController.php`)
- Board review → Project status job: dispatches status update (evidence: `app/Http/Controllers/Board/BoardController.php`)
- Board review → Project events: dispatches decision event (evidence: `app/Http/Controllers/Board/BoardController.php`)
- Kanban actions → Task: updates task state (evidence: `app/Http/Controllers/Workspace/KanbanController.php`)
- Kanban actions → Task status values: sets statuses (evidence: `app/Http/Controllers/Workspace/KanbanController.php`)
- Task → Task status history: has status histories (evidence: `app/Models/Task.php`)
- User administration → User accounts: creates and updates (evidence: `app/Http/Controllers/Manage/UserController.php`)
- User administration → Permission service: loads access data
- Authentication → User accounts: authenticates accounts
- Workspace interface → Kanban actions: uses Kanban actions
