# demos-europe/demosplan-core architecture

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

- Interactive diagram: https://gitdiagram.com/demos-europe/demosplan-core
- Repository: https://github.com/demos-europe/demosplan-core

## Overview

demosplan is a Symfony/Vue core application for participatory land-use planning, mounted and configured by a separate project. Participants view text- and map-based planning information and submit comments or annotations; administrators then search, filter, and analyze contributions. The graph preserves those documented capabilities and the major procedure, document, map, statement, and account areas visible in the tree. Source excerpts support selected assessment-table and fragment-service relationships; other internal links are omitted where the sampled evidence does not show the caller.

Main entry points: [`demosplan/DemosPlanCoreBundle/Logic/AssessmentTable/HashedQueryService.php`](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Logic/AssessmentTable/HashedQueryService.php) (Saved assessment filters), [`client/js/components/statement/assessmentTable`](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/statement/assessmentTable) (Assessment workspace), [`demosplan/DemosPlanCoreBundle/Controller/Statement/DemosPlanAssessmentStatementFragmentController.php`](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Controller/Statement/DemosPlanAssessmentStatementFragmentController.php) (Assessment API), [`client/js/components/statement/statement`](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/statement/statement) (Statement submission)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_participation["Public participation"]
  node_public_info["Public information"]
  node_public_map["Public maps"]
  node_statement_submission["Statement submission"]
end

subgraph group_administration["Planning administration"]
  node_procedure_admin["Procedure setup"]
  node_document_admin["Document management"]
  node_account_admin["User and organization admin"]
  node_imports["Contribution imports"]
  node_news_faq["News and FAQs"]
  node_map_admin["Map configuration"]
end

subgraph group_assessment["Contribution assessment"]
  node_assessment_ui["Assessment workspace"]
  node_segment_work["Segment review"]
  node_analytics["Reports and analytics"]
end

subgraph group_core["Application core"]
  node_assessment_controller["Assessment API"]
  node_fragment_service["Fragment service"]
  node_hashed_query_service["Saved assessment filters"]
  node_hashed_query_repository["Filter persistence"]
  node_fragment_search["Fragment search"]
  node_procedure_entity["Procedure record<br/>[Procedure.php]"]
  node_statement_entity["Statement record<br/>[Statement.php]"]
  node_fragment_entity["Statement fragment"]
  node_user_entity["User and organization records<br/>[User.php]"]
  node_document_entities["Document entities"]
  node_file_entity["File record<br/>[File.php]"]
end

node_participant(("Participant"))
node_admin_user(("Administrator"))

node_participant -->|"views plans"| node_public_info
node_participant -->|"views map information"| node_public_map
node_participant -->|"submits comments"| node_statement_submission
node_statement_submission -->|"provides contributions"| node_assessment_ui
node_admin_user -->|"configures procedures"| node_procedure_admin
node_admin_user -->|"searches and filters"| node_assessment_ui
node_assessment_ui -->|"analyzes contributions"| node_analytics
node_assessment_controller -->|"uses"| node_fragment_service
node_assessment_controller -->|"uses"| node_hashed_query_service
node_hashed_query_service -->|"persists filters"| node_hashed_query_repository
node_hashed_query_service -->|"loads procedure"| node_procedure_entity
node_hashed_query_repository -->|"associates procedure"| node_procedure_entity
node_fragment_search -->|"uses paragraph services"| node_document_entities

click node_public_info "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/procedure/publicindex"
click node_public_map "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/map/publicdetail"
click node_statement_submission "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/statement/statement"
click node_procedure_admin "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/procedure/admin"
click node_document_admin "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/document"
click node_account_admin "https://github.com/demos-europe/demosplan-core/tree/main/client/js/bundles/user"
click node_imports "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/procedure/AdministrationImport"
click node_news_faq "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/news"
click node_map_admin "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/map/admin"
click node_assessment_ui "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/statement/assessmentTable"
click node_segment_work "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/procedure/StatementSegmentsList"
click node_analytics "https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/report"
click node_assessment_controller "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Controller/Statement/DemosPlanAssessmentStatementFragmentController.php"
click node_fragment_service "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Logic/Statement/StatementFragmentService.php"
click node_hashed_query_service "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Logic/AssessmentTable/HashedQueryService.php"
click node_hashed_query_repository "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Repository/HashedQueryRepository.php"
click node_fragment_search "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Repository/FragmentElasticsearchRepository.php"
click node_procedure_entity "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/Procedure/Procedure.php"
click node_statement_entity "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/Statement/Statement.php"
click node_fragment_entity "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/Statement/StatementFragment.php"
click node_user_entity "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/User/User.php"
click node_document_entities "https://github.com/demos-europe/demosplan-core/tree/main/demosplan/DemosPlanCoreBundle/Entity/Document"
click node_file_entity "https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/File.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_public_info,node_public_map,node_statement_submission toneBlue
class node_procedure_admin,node_document_admin,node_account_admin,node_imports,node_news_faq,node_map_admin toneAmber
class node_assessment_ui,node_segment_work,node_analytics toneMint
class node_assessment_controller,node_fragment_service,node_hashed_query_service,node_hashed_query_repository,node_fragment_search,node_procedure_entity,node_statement_entity,node_fragment_entity,node_user_entity,node_document_entities,node_file_entity toneRose
class node_participant,node_admin_user toneIndigo
```

## Components

### Public participation

- [Public information](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/procedure/publicindex): `client/js/components/procedure/publicindex`
- [Public maps](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/map/publicdetail): `client/js/components/map/publicdetail`
- [Statement submission](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/statement/statement): `client/js/components/statement/statement`

### Planning administration

- [Procedure setup](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/procedure/admin): `client/js/components/procedure/admin`
- [Document management](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/document): `client/js/components/document`
- [User and organization admin](https://github.com/demos-europe/demosplan-core/tree/main/client/js/bundles/user): `client/js/bundles/user`
- [Contribution imports](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/procedure/AdministrationImport): `client/js/components/procedure/AdministrationImport`
- [News and FAQs](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/news): `client/js/components/news`
- [Map configuration](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/map/admin): `client/js/components/map/admin`

### Contribution assessment

- [Assessment workspace](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/statement/assessmentTable): `client/js/components/statement/assessmentTable`
- [Segment review](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/procedure/StatementSegmentsList): `client/js/components/procedure/StatementSegmentsList`
- [Reports and analytics](https://github.com/demos-europe/demosplan-core/tree/main/client/js/components/report): `client/js/components/report`

### Application core

- [Assessment API](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Controller/Statement/DemosPlanAssessmentStatementFragmentController.php): `demosplan/DemosPlanCoreBundle/Controller/Statement/DemosPlanAssessmentStatementFragmentController.php`
- [Fragment service](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Logic/Statement/StatementFragmentService.php): `demosplan/DemosPlanCoreBundle/Logic/Statement/StatementFragmentService.php`
- [Saved assessment filters](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Logic/AssessmentTable/HashedQueryService.php): `demosplan/DemosPlanCoreBundle/Logic/AssessmentTable/HashedQueryService.php`
- [Filter persistence](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Repository/HashedQueryRepository.php): `demosplan/DemosPlanCoreBundle/Repository/HashedQueryRepository.php`
- [Fragment search](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Repository/FragmentElasticsearchRepository.php): `demosplan/DemosPlanCoreBundle/Repository/FragmentElasticsearchRepository.php`
- [Procedure record](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/Procedure/Procedure.php): `demosplan/DemosPlanCoreBundle/Entity/Procedure/Procedure.php`
- [Statement record](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/Statement/Statement.php): `demosplan/DemosPlanCoreBundle/Entity/Statement/Statement.php`
- [Statement fragment](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/Statement/StatementFragment.php): `demosplan/DemosPlanCoreBundle/Entity/Statement/StatementFragment.php`
- [User and organization records](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/User/User.php): `demosplan/DemosPlanCoreBundle/Entity/User/User.php`
- [Document entities](https://github.com/demos-europe/demosplan-core/tree/main/demosplan/DemosPlanCoreBundle/Entity/Document): `demosplan/DemosPlanCoreBundle/Entity/Document`
- [File record](https://github.com/demos-europe/demosplan-core/blob/main/demosplan/DemosPlanCoreBundle/Entity/File.php): `demosplan/DemosPlanCoreBundle/Entity/File.php`

### Other components

- **Participant**
- **Administrator**

## Connections

- Participant → Public information: views plans
- Participant → Public maps: views map information
- Participant → Statement submission: submits comments
- Statement submission → Assessment workspace: provides contributions
- Administrator → Procedure setup: configures procedures
- Administrator → Assessment workspace: searches and filters
- Assessment workspace → Reports and analytics: analyzes contributions
- Assessment API → Fragment service: uses (evidence: `demosplan/DemosPlanCoreBundle/Controller/Statement/DemosPlanAssessmentStatementFragmentController.php`)
- Assessment API → Saved assessment filters: uses (evidence: `demosplan/DemosPlanCoreBundle/Controller/Statement/DemosPlanAssessmentStatementFragmentController.php`)
- Saved assessment filters → Filter persistence: persists filters (evidence: `demosplan/DemosPlanCoreBundle/Logic/AssessmentTable/HashedQueryService.php`)
- Saved assessment filters → Procedure record: loads procedure (evidence: `demosplan/DemosPlanCoreBundle/Logic/AssessmentTable/HashedQueryService.php`)
- Filter persistence → Procedure record: associates procedure (evidence: `demosplan/DemosPlanCoreBundle/Repository/HashedQueryRepository.php`)
- Fragment search → Document entities: uses paragraph services (evidence: `demosplan/DemosPlanCoreBundle/Repository/FragmentElasticsearchRepository.php`)
