How nextcloud/formvox works
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: FormRepository.php Form repository · ResponseService.php Response processing · Editor.vue Form editor · PublicController.php Public form access
Components 32
Form authoring
- Forms homepage
src/views/App.vue - Form editor
src/views/Editor.vue - Question editor
src/components/QuestionEditor.vue - Page builder
src/components/pagebuilder/PageBuilder.vue - Form API
lib/Controller/FormController.php - Form repository
lib/Service/FormRepository.php - Form factory
lib/Service/FormFactory.php - Form file locator
lib/Service/FormFileLocator.php - Form file locking
lib/Service/FormLockManager.php - Form files
Response lifecycle
- Public form access
lib/Controller/PublicController.php - Response interface
src/views/Respond.vue - Response processing
lib/Service/ResponseService.php - Response persistence
lib/Service/ResponsePersistenceService.php - Response index
lib/Service/IndexService.php - Results view
src/views/Results.vue - Results export
lib/Controller/ExportController.php
Integrations
- AI form generation
lib/Service/AiFormGeneratorService.php - AI task completion
lib/Listener/AiTaskSuccessfulListener.php - Pending AI tasks
lib/Db/AiPendingMapper.php - Microsoft Forms import
lib/Service/MSFormsImportService.php - External API
lib/Controller/ExternalApiController.php - Webhook service
lib/Service/WebhookService.php
Nextcloud platform
- Admin settings
lib/Controller/SettingsController.php - Branding service
lib/Service/BrandingService.php - Statistics service
lib/Service/StatisticsService.php - App registration
lib/AppInfo/Application.php - Form file preview
lib/Preview/FormPreview.php - DAV file plugins
lib/DAV/HideFormFilesPlugin.php
Other components
- Form creator
- Respondent
- Nextcloud Files
Connections 37
- Form creator → Forms homepage: opens
README.md - Forms homepage → Form API: loads forms
src/views/App.vue - Form creator → Form editor: creates or edits
README.md - Form editor → Question editor: configures questions
- Form editor → Page builder: builds pages
- Form editor → Form API: saves form
README.md - Form API → Form repository: loads and updates
lib/Controller/FormController.php - Form repository → Form factory: creates structure
lib/Service/FormRepository.php - Form repository → Form file locator: resolves file
lib/Service/FormRepository.php - Form repository → Form files: reads and writes
README.md - Respondent → Public form access: opens shared form
README.md - Public form access → Form repository: loads form
lib/Controller/PublicController.php - Public form access → Response interface: serves response page
lib/Controller/PublicController.php - Respondent → Response interface: submits answers
README.md - Public form access → Response processing: processes submission
lib/Controller/PublicController.php - Response processing → Response persistence: persists response
lib/Service/ResponseService.php - Response persistence → Form file locking: locks file mutation
lib/Service/ResponsePersistenceService.php - Response persistence → Response index: updates index
lib/Service/ResponsePersistenceService.php - Response persistence → Form files: writes response
README.md - Respondent → Results view: views permitted results
README.md - Results view → Response processing: requests results
- Form creator → Results export: requests export
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
lib/Listener/AiTaskSuccessfulListener.php - AI task completion → AI form generation: parses output
lib/Listener/AiTaskSuccessfulListener.php - AI task completion → Form repository: creates generated form
lib/Listener/AiTaskSuccessfulListener.php - Form creator → Microsoft Forms import: imports form
README.md - External API → Form repository: reads form
lib/Controller/ExternalApiController.php - External API → Response processing: accesses responses
- Response processing → Webhook service: dispatches webhook
lib/Service/ResponseService.php - Admin settings → Branding service: configures branding
- Admin settings → Statistics service: views statistics
- App registration → Form file preview: registers preview
lib/AppInfo/Application.php - Nextcloud Files → Form files: stores and serves
README.md - App registration → DAV file plugins: registers listeners
lib/AppInfo/Application.php