# nextcloud/formvox architecture

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

- Interactive diagram: https://gitdiagram.com/nextcloud/formvox
- Repository: https://github.com/nextcloud/formvox

## Overview

FormVox is a Nextcloud forms and polls app whose canonical form and response data live in `.fvform` files. The main workflow is form creation and editing, public or authenticated response submission, then results and export. The graph also preserves documented AI generation, Microsoft Forms import, integrations, administration, collaboration, and file-app capabilities. Some subsystems are included from the repository tree and README; their internal wiring was not sampled, so uncertain links are omitted rather than inferred.

Main entry points: [`lib/Service/FormRepository.php`](https://github.com/nextcloud/formvox/blob/main/lib/Service/FormRepository.php) (Form repository), [`lib/Service/ResponseService.php`](https://github.com/nextcloud/formvox/blob/main/lib/Service/ResponseService.php) (Response processing), [`src/views/Editor.vue`](https://github.com/nextcloud/formvox/blob/main/src/views/Editor.vue) (Form editor), [`lib/Controller/PublicController.php`](https://github.com/nextcloud/formvox/blob/main/lib/Controller/PublicController.php) (Public form access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Form authoring"]
  node_home["Forms homepage<br/>[App.vue]"]
  node_form_editor["Form editor<br/>[Editor.vue]"]
  node_question_editor["Question editor<br/>[QuestionEditor.vue]"]
  node_page_builder["Page builder<br/>[PageBuilder.vue]"]
  node_form_controller["Form API<br/>[FormController.php]"]
  node_form_repository["Form repository<br/>[FormRepository.php]"]
  node_form_factory["Form factory<br/>[FormFactory.php]"]
  node_file_locator["Form file locator"]
  node_form_lock["Form file locking"]
  node_form_files["Form files"]
end

subgraph group_responses["Response lifecycle"]
  node_public_forms["Public form access"]
  node_response_view["Response interface<br/>[Respond.vue]"]
  node_response_service["Response processing"]
  node_response_persistence["Response persistence"]
  node_index_service["Response index<br/>[IndexService.php]"]
  node_results_view["Results view<br/>[Results.vue]"]
  node_export_controller["Results export"]
end

subgraph group_integrations["Integrations"]
  node_ai_generation["AI form generation"]
  node_ai_completion["AI task completion"]
  node_ai_pending[("Pending AI tasks")]
  node_ms_import["Microsoft Forms import"]
  node_external_api["External API"]
  node_webhooks["Webhook service<br/>[WebhookService.php]"]
end

subgraph group_platform["Nextcloud platform"]
  node_admin_settings["Admin settings"]
  node_branding["Branding service"]
  node_statistics["Statistics service"]
  node_app_bootstrap["App registration<br/>[Application.php]"]
  node_file_preview["Form file preview<br/>[FormPreview.php]"]
  node_dav_plugins["DAV file plugins"]
end

node_form_owner(("Form creator"))
node_respondent(("Respondent"))
node_nextcloud_files["Nextcloud Files"]

node_form_owner -->|"opens"| node_home
node_home -->|"loads forms"| node_form_controller
node_form_owner -->|"creates or edits"| node_form_editor
node_form_editor -.->|"configures questions"| node_question_editor
node_form_editor -.->|"builds pages"| node_page_builder
node_form_editor -->|"saves form"| node_form_controller
node_form_controller -->|"loads and updates"| node_form_repository
node_form_repository -->|"creates structure"| node_form_factory
node_form_repository -->|"resolves file"| node_file_locator
node_form_repository -->|"reads and writes"| node_form_files
node_respondent -->|"opens shared form"| node_public_forms
node_public_forms -->|"loads form"| node_form_repository
node_public_forms -->|"serves response page"| node_response_view
node_respondent -->|"submits answers"| node_response_view
node_public_forms -->|"processes submission"| node_response_service
node_response_service -->|"persists response"| node_response_persistence
node_response_persistence -->|"locks file mutation"| node_form_lock
node_response_persistence -->|"updates index"| node_index_service
node_response_persistence -->|"writes response"| node_form_files
node_respondent -->|"views permitted results"| node_results_view
node_results_view -.->|"requests results"| node_response_service
node_form_owner -->|"requests export"| node_export_controller
node_export_controller -.->|"exports responses"| node_response_service
node_form_owner -.->|"requests generation"| node_ai_generation
node_ai_generation -.->|"records pending task"| node_ai_pending
node_ai_completion -->|"loads and deletes task"| node_ai_pending
node_ai_completion -->|"parses output"| node_ai_generation
node_ai_completion -->|"creates generated form"| node_form_repository
node_form_owner -->|"imports form"| node_ms_import
node_external_api -->|"reads form"| node_form_repository
node_external_api -.->|"accesses responses"| node_response_service
node_response_service -->|"dispatches webhook"| node_webhooks
node_admin_settings -.->|"configures branding"| node_branding
node_admin_settings -.->|"views statistics"| node_statistics
node_app_bootstrap -->|"registers preview"| node_file_preview
node_nextcloud_files -->|"stores and serves"| node_form_files
node_app_bootstrap -->|"registers listeners"| node_dav_plugins

click node_home "https://github.com/nextcloud/formvox/blob/main/src/views/App.vue"
click node_form_editor "https://github.com/nextcloud/formvox/blob/main/src/views/Editor.vue"
click node_question_editor "https://github.com/nextcloud/formvox/blob/main/src/components/QuestionEditor.vue"
click node_page_builder "https://github.com/nextcloud/formvox/blob/main/src/components/pagebuilder/PageBuilder.vue"
click node_form_controller "https://github.com/nextcloud/formvox/blob/main/lib/Controller/FormController.php"
click node_form_repository "https://github.com/nextcloud/formvox/blob/main/lib/Service/FormRepository.php"
click node_form_factory "https://github.com/nextcloud/formvox/blob/main/lib/Service/FormFactory.php"
click node_file_locator "https://github.com/nextcloud/formvox/blob/main/lib/Service/FormFileLocator.php"
click node_form_lock "https://github.com/nextcloud/formvox/blob/main/lib/Service/FormLockManager.php"
click node_public_forms "https://github.com/nextcloud/formvox/blob/main/lib/Controller/PublicController.php"
click node_response_view "https://github.com/nextcloud/formvox/blob/main/src/views/Respond.vue"
click node_response_service "https://github.com/nextcloud/formvox/blob/main/lib/Service/ResponseService.php"
click node_response_persistence "https://github.com/nextcloud/formvox/blob/main/lib/Service/ResponsePersistenceService.php"
click node_index_service "https://github.com/nextcloud/formvox/blob/main/lib/Service/IndexService.php"
click node_results_view "https://github.com/nextcloud/formvox/blob/main/src/views/Results.vue"
click node_export_controller "https://github.com/nextcloud/formvox/blob/main/lib/Controller/ExportController.php"
click node_ai_generation "https://github.com/nextcloud/formvox/blob/main/lib/Service/AiFormGeneratorService.php"
click node_ai_completion "https://github.com/nextcloud/formvox/blob/main/lib/Listener/AiTaskSuccessfulListener.php"
click node_ai_pending "https://github.com/nextcloud/formvox/blob/main/lib/Db/AiPendingMapper.php"
click node_ms_import "https://github.com/nextcloud/formvox/blob/main/lib/Service/MSFormsImportService.php"
click node_external_api "https://github.com/nextcloud/formvox/blob/main/lib/Controller/ExternalApiController.php"
click node_webhooks "https://github.com/nextcloud/formvox/blob/main/lib/Service/WebhookService.php"
click node_admin_settings "https://github.com/nextcloud/formvox/blob/main/lib/Controller/SettingsController.php"
click node_branding "https://github.com/nextcloud/formvox/blob/main/lib/Service/BrandingService.php"
click node_statistics "https://github.com/nextcloud/formvox/blob/main/lib/Service/StatisticsService.php"
click node_app_bootstrap "https://github.com/nextcloud/formvox/blob/main/lib/AppInfo/Application.php"
click node_file_preview "https://github.com/nextcloud/formvox/blob/main/lib/Preview/FormPreview.php"
click node_dav_plugins "https://github.com/nextcloud/formvox/blob/main/lib/DAV/HideFormFilesPlugin.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_home,node_form_editor,node_question_editor,node_page_builder,node_form_controller,node_form_repository,node_form_factory,node_file_locator,node_form_lock,node_form_files toneBlue
class node_public_forms,node_response_view,node_response_service,node_response_persistence,node_index_service,node_results_view,node_export_controller toneAmber
class node_ai_generation,node_ai_completion,node_ai_pending,node_ms_import,node_external_api,node_webhooks toneMint
class node_admin_settings,node_branding,node_statistics,node_app_bootstrap,node_file_preview,node_dav_plugins toneRose
class node_form_owner,node_respondent,node_nextcloud_files toneIndigo
```

## Components

### Form authoring

- [Forms homepage](https://github.com/nextcloud/formvox/blob/main/src/views/App.vue): `src/views/App.vue`
- [Form editor](https://github.com/nextcloud/formvox/blob/main/src/views/Editor.vue): `src/views/Editor.vue`
- [Question editor](https://github.com/nextcloud/formvox/blob/main/src/components/QuestionEditor.vue): `src/components/QuestionEditor.vue`
- [Page builder](https://github.com/nextcloud/formvox/blob/main/src/components/pagebuilder/PageBuilder.vue): `src/components/pagebuilder/PageBuilder.vue`
- [Form API](https://github.com/nextcloud/formvox/blob/main/lib/Controller/FormController.php): `lib/Controller/FormController.php`
- [Form repository](https://github.com/nextcloud/formvox/blob/main/lib/Service/FormRepository.php): `lib/Service/FormRepository.php`
- [Form factory](https://github.com/nextcloud/formvox/blob/main/lib/Service/FormFactory.php): `lib/Service/FormFactory.php`
- [Form file locator](https://github.com/nextcloud/formvox/blob/main/lib/Service/FormFileLocator.php): `lib/Service/FormFileLocator.php`
- [Form file locking](https://github.com/nextcloud/formvox/blob/main/lib/Service/FormLockManager.php): `lib/Service/FormLockManager.php`
- **Form files**

### Response lifecycle

- [Public form access](https://github.com/nextcloud/formvox/blob/main/lib/Controller/PublicController.php): `lib/Controller/PublicController.php`
- [Response interface](https://github.com/nextcloud/formvox/blob/main/src/views/Respond.vue): `src/views/Respond.vue`
- [Response processing](https://github.com/nextcloud/formvox/blob/main/lib/Service/ResponseService.php): `lib/Service/ResponseService.php`
- [Response persistence](https://github.com/nextcloud/formvox/blob/main/lib/Service/ResponsePersistenceService.php): `lib/Service/ResponsePersistenceService.php`
- [Response index](https://github.com/nextcloud/formvox/blob/main/lib/Service/IndexService.php): `lib/Service/IndexService.php`
- [Results view](https://github.com/nextcloud/formvox/blob/main/src/views/Results.vue): `src/views/Results.vue`
- [Results export](https://github.com/nextcloud/formvox/blob/main/lib/Controller/ExportController.php): `lib/Controller/ExportController.php`

### Integrations

- [AI form generation](https://github.com/nextcloud/formvox/blob/main/lib/Service/AiFormGeneratorService.php): `lib/Service/AiFormGeneratorService.php`
- [AI task completion](https://github.com/nextcloud/formvox/blob/main/lib/Listener/AiTaskSuccessfulListener.php): `lib/Listener/AiTaskSuccessfulListener.php`
- [Pending AI tasks](https://github.com/nextcloud/formvox/blob/main/lib/Db/AiPendingMapper.php): `lib/Db/AiPendingMapper.php`
- [Microsoft Forms import](https://github.com/nextcloud/formvox/blob/main/lib/Service/MSFormsImportService.php): `lib/Service/MSFormsImportService.php`
- [External API](https://github.com/nextcloud/formvox/blob/main/lib/Controller/ExternalApiController.php): `lib/Controller/ExternalApiController.php`
- [Webhook service](https://github.com/nextcloud/formvox/blob/main/lib/Service/WebhookService.php): `lib/Service/WebhookService.php`

### Nextcloud platform

- [Admin settings](https://github.com/nextcloud/formvox/blob/main/lib/Controller/SettingsController.php): `lib/Controller/SettingsController.php`
- [Branding service](https://github.com/nextcloud/formvox/blob/main/lib/Service/BrandingService.php): `lib/Service/BrandingService.php`
- [Statistics service](https://github.com/nextcloud/formvox/blob/main/lib/Service/StatisticsService.php): `lib/Service/StatisticsService.php`
- [App registration](https://github.com/nextcloud/formvox/blob/main/lib/AppInfo/Application.php): `lib/AppInfo/Application.php`
- [Form file preview](https://github.com/nextcloud/formvox/blob/main/lib/Preview/FormPreview.php): `lib/Preview/FormPreview.php`
- [DAV file plugins](https://github.com/nextcloud/formvox/blob/main/lib/DAV/HideFormFilesPlugin.php): `lib/DAV/HideFormFilesPlugin.php`

### Other components

- **Form creator**
- **Respondent**
- **Nextcloud Files**

## Connections

- Form creator → Forms homepage: opens (evidence: `README.md`)
- Forms homepage → Form API: loads forms (evidence: `src/views/App.vue`)
- Form creator → Form editor: creates or edits (evidence: `README.md`)
- Form editor → Question editor: configures questions
- Form editor → Page builder: builds pages
- Form editor → Form API: saves form (evidence: `README.md`)
- Form API → Form repository: loads and updates (evidence: `lib/Controller/FormController.php`)
- Form repository → Form factory: creates structure (evidence: `lib/Service/FormRepository.php`)
- Form repository → Form file locator: resolves file (evidence: `lib/Service/FormRepository.php`)
- Form repository → Form files: reads and writes (evidence: `README.md`)
- Respondent → Public form access: opens shared form (evidence: `README.md`)
- Public form access → Form repository: loads form (evidence: `lib/Controller/PublicController.php`)
- Public form access → Response interface: serves response page (evidence: `lib/Controller/PublicController.php`)
- Respondent → Response interface: submits answers (evidence: `README.md`)
- Public form access → Response processing: processes submission (evidence: `lib/Controller/PublicController.php`)
- Response processing → Response persistence: persists response (evidence: `lib/Service/ResponseService.php`)
- Response persistence → Form file locking: locks file mutation (evidence: `lib/Service/ResponsePersistenceService.php`)
- Response persistence → Response index: updates index (evidence: `lib/Service/ResponsePersistenceService.php`)
- Response persistence → Form files: writes response (evidence: `README.md`)
- Respondent → Results view: views permitted results (evidence: `README.md`)
- Results view → Response processing: requests results
- Form creator → Results export: requests export (evidence: `README.md`)
- Results export → Response processing: exports responses
- Form creator → AI form generation: requests generation
- AI form generation → Pending AI tasks: records pending task
- AI task completion → Pending AI tasks: loads and deletes task (evidence: `lib/Listener/AiTaskSuccessfulListener.php`)
- AI task completion → AI form generation: parses output (evidence: `lib/Listener/AiTaskSuccessfulListener.php`)
- AI task completion → Form repository: creates generated form (evidence: `lib/Listener/AiTaskSuccessfulListener.php`)
- Form creator → Microsoft Forms import: imports form (evidence: `README.md`)
- External API → Form repository: reads form (evidence: `lib/Controller/ExternalApiController.php`)
- External API → Response processing: accesses responses
- Response processing → Webhook service: dispatches webhook (evidence: `lib/Service/ResponseService.php`)
- Admin settings → Branding service: configures branding
- Admin settings → Statistics service: views statistics
- App registration → Form file preview: registers preview (evidence: `lib/AppInfo/Application.php`)
- Nextcloud Files → Form files: stores and serves (evidence: `README.md`)
- App registration → DAV file plugins: registers listeners (evidence: `lib/AppInfo/Application.php`)
