# arawa/workspace architecture

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

- Interactive diagram: https://gitdiagram.com/arawa/workspace
- Repository: https://github.com/arawa/workspace

## Overview

Workspace is a Nextcloud extension for creating shared workspaces and delegating their administration. General Managers create and configure workspaces; Workspace Managers manage members and groups, while users interact through a unified interface. The backend coordinates workspace records, Nextcloud groups, and Groupfolders; the frontend exposes workspace and Hub views, and CSV-based user import is also present. The README documents advanced folder permissions and optional workspace creation by Workspace Managers. Some feature links rely on README documentation because their implementation was not sampled.

Main entry points: [`lib/Controller/WorkspaceController.php`](https://github.com/arawa/workspace/blob/main/lib/Controller/WorkspaceController.php) (Workspace controller), [`lib/Space/SpaceManager.php`](https://github.com/arawa/workspace/blob/main/lib/Space/SpaceManager.php) (Workspace manager), [`lib/Service/UserService.php`](https://github.com/arawa/workspace/blob/main/lib/Service/UserService.php) (User services), [`src/App.vue`](https://github.com/arawa/workspace/blob/main/src/App.vue) (Workspace UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User interface"]
  node_ui["Workspace UI<br/>[App.vue]"]
  node_workspace_views["Workspace views"]
  node_hub_views["Hub views<br/>[HubHome.vue]"]
  node_frontend_services["API services<br/>[spaceService.js]"]
end

subgraph group_api["API and access"]
  node_routes["HTTP routes<br/>[routes.php]"]
  node_workspace_controller["Workspace controller"]
  node_ocs_controller["Workspace OCS API"]
  node_access_control["Access middleware"]
end

subgraph group_workspace["Workspace domain"]
  node_space_manager["Workspace manager<br/>[SpaceManager.php]"]
  node_workspace_service["Workspace services"]
  node_space_service["Workspace records<br/>[SpaceService.php]"]
  node_space_mapper["Space mapper<br/>[SpaceMapper.php]"]
  node_space_record["Workspace record<br/>[Space.php]"]
end

subgraph group_membership["People and groups"]
  node_group_controller["Group controller"]
  node_user_service["User services<br/>[UserService.php]"]
  node_connected_groups["Connected groups"]
  node_user_group["Workspace user group<br/>[UserGroup.php]"]
  node_manager_group["Workspace manager group"]
end

subgraph group_integrations["Storage and imports"]
  node_groupfolder_helper["Groupfolder integration"]
  node_csv_import["CSV user import"]
end

node_manager(("General Manager"))
node_workspace_manager(("Workspace Manager"))
node_user(("Workspace User"))
node_groupfolders["Nextcloud Groupfolders"]

node_manager -->|"creates workspaces"| node_ui
node_workspace_manager -->|"manages workspace"| node_ui
node_user -->|"uses interface"| node_ui
node_ui -.->|"shows workspace views"| node_workspace_views
node_workspace_views -.->|"requests workspace data"| node_frontend_services
node_hub_views -.->|"loads Hub data"| node_frontend_services
node_frontend_services -.->|"calls backend"| node_routes
node_routes -.->|"routes requests"| node_workspace_controller
node_workspace_controller -->|"delegates workspace actions"| node_space_manager
node_ocs_controller -->|"delegates API actions"| node_space_manager
node_workspace_controller -->|"uses workspace services"| node_workspace_service
node_workspace_controller -->|"uses space records"| node_space_mapper
node_ocs_controller -->|"uses space records"| node_space_mapper
node_workspace_service -->|"queries workspaces"| node_space_mapper
node_space_mapper -->|"maps records"| node_space_record
node_workspace_controller -->|"uses folder integration"| node_groupfolder_helper
node_workspace_controller -->|"uses connected groups"| node_connected_groups
node_group_controller -->|"formats user data"| node_user_service
node_group_controller -->|"delegates group actions"| node_space_manager
node_user_service -->|"checks group links"| node_connected_groups
node_user_service -->|"uses workspace user group"| node_user_group
node_space_manager -->|"maintains member groups"| node_user_group
node_space_manager -->|"maintains manager groups"| node_manager_group
node_space_manager -->|"configures workspace folders"| node_groupfolders
node_csv_import -.->|"imports users"| node_user_service
node_access_control -.->|"guards actions"| node_workspace_controller

click node_ui "https://github.com/arawa/workspace/blob/main/src/App.vue"
click node_workspace_views "https://github.com/arawa/workspace/blob/main/src/WorkspaceContent.vue"
click node_hub_views "https://github.com/arawa/workspace/blob/main/src/views/Hub/HubHome.vue"
click node_frontend_services "https://github.com/arawa/workspace/blob/main/src/services/spaceService.js"
click node_routes "https://github.com/arawa/workspace/blob/main/appinfo/routes.php"
click node_workspace_controller "https://github.com/arawa/workspace/blob/main/lib/Controller/WorkspaceController.php"
click node_ocs_controller "https://github.com/arawa/workspace/blob/main/lib/Controller/WorkspaceApiOcsController.php"
click node_access_control "https://github.com/arawa/workspace/blob/main/lib/Middleware/WorkspaceManagerAccessMiddleware.php"
click node_space_manager "https://github.com/arawa/workspace/blob/main/lib/Space/SpaceManager.php"
click node_workspace_service "https://github.com/arawa/workspace/blob/main/lib/Service/WorkspaceService.php"
click node_space_service "https://github.com/arawa/workspace/blob/main/lib/Service/SpaceService.php"
click node_space_mapper "https://github.com/arawa/workspace/blob/main/lib/Db/SpaceMapper.php"
click node_space_record "https://github.com/arawa/workspace/blob/main/lib/Db/Space.php"
click node_group_controller "https://github.com/arawa/workspace/blob/main/lib/Controller/GroupController.php"
click node_user_service "https://github.com/arawa/workspace/blob/main/lib/Service/UserService.php"
click node_connected_groups "https://github.com/arawa/workspace/blob/main/lib/Service/Group/ConnectedGroupsService.php"
click node_user_group "https://github.com/arawa/workspace/blob/main/lib/Service/Group/UserGroup.php"
click node_manager_group "https://github.com/arawa/workspace/blob/main/lib/Service/Group/WorkspaceManagerGroup.php"
click node_groupfolder_helper "https://github.com/arawa/workspace/blob/main/lib/Helper/GroupfolderHelper.php"
click node_csv_import "https://github.com/arawa/workspace/blob/main/lib/Controller/FileCSVController.php"

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_ui,node_workspace_views,node_hub_views,node_frontend_services,node_user toneBlue
class node_routes,node_workspace_controller,node_ocs_controller,node_access_control toneAmber
class node_space_manager,node_workspace_service,node_space_service,node_space_mapper,node_space_record toneMint
class node_group_controller,node_user_service,node_connected_groups,node_user_group,node_manager_group toneRose
class node_groupfolder_helper,node_csv_import,node_manager,node_workspace_manager,node_groupfolders toneIndigo
```

## Components

### User interface

- [Workspace UI](https://github.com/arawa/workspace/blob/main/src/App.vue): `src/App.vue`
- [Workspace views](https://github.com/arawa/workspace/blob/main/src/WorkspaceContent.vue): `src/WorkspaceContent.vue`
- [Hub views](https://github.com/arawa/workspace/blob/main/src/views/Hub/HubHome.vue): `src/views/Hub/HubHome.vue`
- [API services](https://github.com/arawa/workspace/blob/main/src/services/spaceService.js): `src/services/spaceService.js`

### API and access

- [HTTP routes](https://github.com/arawa/workspace/blob/main/appinfo/routes.php): `appinfo/routes.php`
- [Workspace controller](https://github.com/arawa/workspace/blob/main/lib/Controller/WorkspaceController.php): `lib/Controller/WorkspaceController.php`
- [Workspace OCS API](https://github.com/arawa/workspace/blob/main/lib/Controller/WorkspaceApiOcsController.php): `lib/Controller/WorkspaceApiOcsController.php`
- [Access middleware](https://github.com/arawa/workspace/blob/main/lib/Middleware/WorkspaceManagerAccessMiddleware.php): `lib/Middleware/WorkspaceManagerAccessMiddleware.php`

### Workspace domain

- [Workspace manager](https://github.com/arawa/workspace/blob/main/lib/Space/SpaceManager.php): `lib/Space/SpaceManager.php`
- [Workspace services](https://github.com/arawa/workspace/blob/main/lib/Service/WorkspaceService.php): `lib/Service/WorkspaceService.php`
- [Workspace records](https://github.com/arawa/workspace/blob/main/lib/Service/SpaceService.php): `lib/Service/SpaceService.php`
- [Space mapper](https://github.com/arawa/workspace/blob/main/lib/Db/SpaceMapper.php): `lib/Db/SpaceMapper.php`
- [Workspace record](https://github.com/arawa/workspace/blob/main/lib/Db/Space.php): `lib/Db/Space.php`

### People and groups

- [Group controller](https://github.com/arawa/workspace/blob/main/lib/Controller/GroupController.php): `lib/Controller/GroupController.php`
- [User services](https://github.com/arawa/workspace/blob/main/lib/Service/UserService.php): `lib/Service/UserService.php`
- [Connected groups](https://github.com/arawa/workspace/blob/main/lib/Service/Group/ConnectedGroupsService.php): `lib/Service/Group/ConnectedGroupsService.php`
- [Workspace user group](https://github.com/arawa/workspace/blob/main/lib/Service/Group/UserGroup.php): `lib/Service/Group/UserGroup.php`
- [Workspace manager group](https://github.com/arawa/workspace/blob/main/lib/Service/Group/WorkspaceManagerGroup.php): `lib/Service/Group/WorkspaceManagerGroup.php`

### Storage and imports

- [Groupfolder integration](https://github.com/arawa/workspace/blob/main/lib/Helper/GroupfolderHelper.php): `lib/Helper/GroupfolderHelper.php`
- [CSV user import](https://github.com/arawa/workspace/blob/main/lib/Controller/FileCSVController.php): `lib/Controller/FileCSVController.php`

### Other components

- **General Manager**
- **Workspace Manager**
- **Workspace User**
- **Nextcloud Groupfolders**

## Connections

- General Manager → Workspace UI: creates workspaces (evidence: `README.md`)
- Workspace Manager → Workspace UI: manages workspace (evidence: `README.md`)
- Workspace User → Workspace UI: uses interface (evidence: `README.md`)
- Workspace UI → Workspace views: shows workspace views
- Workspace views → API services: requests workspace data
- Hub views → API services: loads Hub data
- API services → HTTP routes: calls backend
- HTTP routes → Workspace controller: routes requests
- Workspace controller → Workspace manager: delegates workspace actions (evidence: `lib/Controller/WorkspaceController.php`)
- Workspace OCS API → Workspace manager: delegates API actions (evidence: `lib/Controller/WorkspaceApiOcsController.php`)
- Workspace controller → Workspace services: uses workspace services (evidence: `lib/Controller/WorkspaceController.php`)
- Workspace controller → Space mapper: uses space records (evidence: `lib/Controller/WorkspaceController.php`)
- Workspace OCS API → Space mapper: uses space records (evidence: `lib/Controller/WorkspaceApiOcsController.php`)
- Workspace services → Space mapper: queries workspaces (evidence: `lib/Service/WorkspaceService.php`)
- Space mapper → Workspace record: maps records (evidence: `lib/Db/SpaceMapper.php`)
- Workspace controller → Groupfolder integration: uses folder integration (evidence: `lib/Controller/WorkspaceController.php`)
- Workspace controller → Connected groups: uses connected groups (evidence: `lib/Controller/WorkspaceController.php`)
- Group controller → User services: formats user data (evidence: `lib/Controller/GroupController.php`)
- Group controller → Workspace manager: delegates group actions (evidence: `lib/Controller/GroupController.php`)
- User services → Connected groups: checks group links (evidence: `lib/Service/UserService.php`)
- User services → Workspace user group: uses workspace user group (evidence: `lib/Service/UserService.php`)
- Workspace manager → Workspace user group: maintains member groups (evidence: `lib/Space/SpaceManager.php`)
- Workspace manager → Workspace manager group: maintains manager groups (evidence: `lib/Space/SpaceManager.php`)
- Workspace manager → Nextcloud Groupfolders: configures workspace folders (evidence: `README.md`)
- CSV user import → User services: imports users
- Access middleware → Workspace controller: guards actions
