How arawa/workspace works
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: WorkspaceController.php Workspace controller · SpaceManager.php Workspace manager · UserService.php User services · App.vue Workspace UI
Components 24
User interface
- Workspace UI
src/App.vue - Workspace views
src/WorkspaceContent.vue - Hub views
src/views/Hub/HubHome.vue - API services
src/services/spaceService.js
API and access
- HTTP routes
appinfo/routes.php - Workspace controller
lib/Controller/WorkspaceController.php - Workspace OCS API
lib/Controller/WorkspaceApiOcsController.php - Access middleware
lib/Middleware/WorkspaceManagerAccessMiddleware.php
Workspace domain
- Workspace manager
lib/Space/SpaceManager.php - Workspace services
lib/Service/WorkspaceService.php - Workspace records
lib/Service/SpaceService.php - Space mapper
lib/Db/SpaceMapper.php - Workspace record
lib/Db/Space.php
People and groups
- Group controller
lib/Controller/GroupController.php - User services
lib/Service/UserService.php - Connected groups
lib/Service/Group/ConnectedGroupsService.php - Workspace user group
lib/Service/Group/UserGroup.php - Workspace manager group
lib/Service/Group/WorkspaceManagerGroup.php
Storage and imports
- Groupfolder integration
lib/Helper/GroupfolderHelper.php - CSV user import
lib/Controller/FileCSVController.php
Other components
- General Manager
- Workspace Manager
- Workspace User
- Nextcloud Groupfolders
Connections 26
- General Manager → Workspace UI: creates workspaces
README.md - Workspace Manager → Workspace UI: manages workspace
README.md - Workspace User → Workspace UI: uses interface
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
lib/Controller/WorkspaceController.php - Workspace OCS API → Workspace manager: delegates API actions
lib/Controller/WorkspaceApiOcsController.php - Workspace controller → Workspace services: uses workspace services
lib/Controller/WorkspaceController.php - Workspace controller → Space mapper: uses space records
lib/Controller/WorkspaceController.php - Workspace OCS API → Space mapper: uses space records
lib/Controller/WorkspaceApiOcsController.php - Workspace services → Space mapper: queries workspaces
lib/Service/WorkspaceService.php - Space mapper → Workspace record: maps records
lib/Db/SpaceMapper.php - Workspace controller → Groupfolder integration: uses folder integration
lib/Controller/WorkspaceController.php - Workspace controller → Connected groups: uses connected groups
lib/Controller/WorkspaceController.php - Group controller → User services: formats user data
lib/Controller/GroupController.php - Group controller → Workspace manager: delegates group actions
lib/Controller/GroupController.php - User services → Connected groups: checks group links
lib/Service/UserService.php - User services → Workspace user group: uses workspace user group
lib/Service/UserService.php - Workspace manager → Workspace user group: maintains member groups
lib/Space/SpaceManager.php - Workspace manager → Workspace manager group: maintains manager groups
lib/Space/SpaceManager.php - Workspace manager → Nextcloud Groupfolders: configures workspace folders
README.md - CSV user import → User services: imports users
- Access middleware → Workspace controller: guards actions