# regardsoss/regards-frontend architecture

> Architecture diagram of the GitHub repository regardsoss/regards-frontend, 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/regardsoss/regards-frontend
- Repository: https://github.com/regardsoss/regards-frontend

## Overview

REGARDS Frontend is a React/Redux UI for a REGARDS backend. The visible application entry configures the store and renders the router; user-facing capabilities include pluggable search criteria and administration of search-engine configurations. Criterion plugins provide distinct filtering stages, while the search-results context helper serializes and restores result state. The evidence shows selected entry points and configuration flows, not the full routing or search execution path; omitted links reflect that limit.

Main entry points: [`webapp/src/main.jsx`](https://github.com/regardsoss/regards-frontend/blob/master/webapp/src/main.jsx) (React entry), [`webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/containers/configuration/SearchEngineConfigurationFormContainer.jsx`](https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/containers/configuration/SearchEngineConfigurationFormContainer.jsx) (Configuration container), [`webapp/plugins/criterion/SNR-criterion/src/containers/CriterionContainer.jsx`](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/SNR-criterion/src/containers/CriterionContainer.jsx) (SNR container), [`webapp/plugins/criterion/enumerated/src/containers/EnumeratedCriterionContainer.jsx`](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/enumerated/src/containers/EnumeratedCriterionContainer.jsx) (Enumerated container)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_entry["React entry<br/>[main.jsx]"]
  node_router["Root router<br/>[rootRouter.js]"]
  node_delete_container["Delete service"]
end

subgraph group_criteria["Search criteria"]
  node_snr_container["SNR container"]
  node_snr_component["SNR criterion"]
  node_snr_client["Sesame client<br/>[SesameClient.js]"]
  node_snr_angle["Cone angle helper<br/>[ConeAngleHelper.js]"]
  node_enum_container["Enumerated container"]
  node_enum_component["Enumerated criterion"]
  node_enum_client["Property values client"]
  node_toponym_container["Toponym container"]
  node_toponym_component["Toponym criterion"]
  node_toponym_client["Toponym search client"]
end

subgraph group_results["Search results"]
  node_context["Context storage"]
  node_query_client["OpenSearch client"]
end

subgraph group_admin["Search administration"]
  node_search_form_container["Configuration container"]
  node_search_form["Configuration form"]
  node_search_config_client["Configuration client"]
end

node_user(("UI user"))
node_backend{{"REGARDS backend"}}

node_user -.->|"uses"| node_entry
node_entry -->|"renders"| node_router
node_entry -.->|"requires"| node_backend
node_snr_container -->|"renders"| node_snr_component
node_enum_container -->|"renders"| node_enum_component
node_toponym_container -->|"renders"| node_toponym_component
node_snr_container -.->|"uses"| node_snr_client
node_snr_component -.->|"uses"| node_snr_angle
node_enum_container -.->|"uses"| node_enum_client
node_toponym_container -.->|"uses"| node_toponym_client
node_search_form_container -->|"renders"| node_search_form
node_search_form_container -->|"dispatches"| node_search_config_client
node_search_form -->|"submits"| node_search_form_container
node_context -.->|"stores URL state"| node_user

click node_entry "https://github.com/regardsoss/regards-frontend/blob/master/webapp/src/main.jsx"
click node_router "https://github.com/regardsoss/regards-frontend/blob/master/webapp/src/rootRouter.js"
click node_snr_container "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/SNR-criterion/src/containers/CriterionContainer.jsx"
click node_snr_component "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/SNR-criterion/src/components/CriterionComponent.jsx"
click node_snr_client "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/SNR-criterion/src/clients/SesameClient.js"
click node_snr_angle "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/SNR-criterion/src/utils/ConeAngleHelper.js"
click node_enum_container "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/enumerated/src/containers/EnumeratedCriterionContainer.jsx"
click node_enum_component "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/enumerated/src/components/EnumeratedCriterionComponent.jsx"
click node_enum_client "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/enumerated/src/clients/EnumeratedDOPropertyValuesClient.js"
click node_toponym_container "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/toponym/src/containers/ToponymCriterionContainer.jsx"
click node_toponym_component "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/toponym/src/components/ToponymCriterionComponent.jsx"
click node_toponym_client "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/toponym/src/clients/SearchToponymClient.js"
click node_delete_container "https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/service/fem-delete/src/containers/DeleteContainer.jsx"
click node_context "https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/modules/search-results/src/containers/user/context/ContextStorageHelper.js"
click node_query_client "https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/modules/search-results/src/clients/OpenSearchQueryClient.js"
click node_search_form_container "https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/containers/configuration/SearchEngineConfigurationFormContainer.jsx"
click node_search_form "https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/components/configuration/SearchEngineConfigurationFormComponent.jsx"
click node_search_config_client "https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/clients/SearchEngineConfigurationsClient.js"

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_entry,node_router,node_delete_container,node_user toneBlue
class node_snr_container,node_snr_component,node_snr_client,node_snr_angle,node_enum_container,node_enum_component,node_enum_client,node_toponym_container,node_toponym_component,node_toponym_client toneAmber
class node_context,node_query_client toneMint
class node_search_form_container,node_search_form,node_search_config_client toneRose
class node_backend toneIndigo
```

## Components

### Application shell

- [React entry](https://github.com/regardsoss/regards-frontend/blob/master/webapp/src/main.jsx): `webapp/src/main.jsx`
- [Root router](https://github.com/regardsoss/regards-frontend/blob/master/webapp/src/rootRouter.js): `webapp/src/rootRouter.js`
- [Delete service](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/service/fem-delete/src/containers/DeleteContainer.jsx): `webapp/plugins/service/fem-delete/src/containers/DeleteContainer.jsx`

### Search criteria

- [SNR container](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/SNR-criterion/src/containers/CriterionContainer.jsx): `webapp/plugins/criterion/SNR-criterion/src/containers/CriterionContainer.jsx`
- [SNR criterion](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/SNR-criterion/src/components/CriterionComponent.jsx): `webapp/plugins/criterion/SNR-criterion/src/components/CriterionComponent.jsx`
- [Sesame client](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/SNR-criterion/src/clients/SesameClient.js): `webapp/plugins/criterion/SNR-criterion/src/clients/SesameClient.js`
- [Cone angle helper](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/SNR-criterion/src/utils/ConeAngleHelper.js): `webapp/plugins/criterion/SNR-criterion/src/utils/ConeAngleHelper.js`
- [Enumerated container](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/enumerated/src/containers/EnumeratedCriterionContainer.jsx): `webapp/plugins/criterion/enumerated/src/containers/EnumeratedCriterionContainer.jsx`
- [Enumerated criterion](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/enumerated/src/components/EnumeratedCriterionComponent.jsx): `webapp/plugins/criterion/enumerated/src/components/EnumeratedCriterionComponent.jsx`
- [Property values client](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/enumerated/src/clients/EnumeratedDOPropertyValuesClient.js): `webapp/plugins/criterion/enumerated/src/clients/EnumeratedDOPropertyValuesClient.js`
- [Toponym container](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/toponym/src/containers/ToponymCriterionContainer.jsx): `webapp/plugins/criterion/toponym/src/containers/ToponymCriterionContainer.jsx`
- [Toponym criterion](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/toponym/src/components/ToponymCriterionComponent.jsx): `webapp/plugins/criterion/toponym/src/components/ToponymCriterionComponent.jsx`
- [Toponym search client](https://github.com/regardsoss/regards-frontend/blob/master/webapp/plugins/criterion/toponym/src/clients/SearchToponymClient.js): `webapp/plugins/criterion/toponym/src/clients/SearchToponymClient.js`

### Search results

- [Context storage](https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/modules/search-results/src/containers/user/context/ContextStorageHelper.js): `webapp/web_modules/modules/search-results/src/containers/user/context/ContextStorageHelper.js`
- [OpenSearch client](https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/modules/search-results/src/clients/OpenSearchQueryClient.js): `webapp/web_modules/modules/search-results/src/clients/OpenSearchQueryClient.js`

### Search administration

- [Configuration container](https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/containers/configuration/SearchEngineConfigurationFormContainer.jsx): `webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/containers/configuration/SearchEngineConfigurationFormContainer.jsx`
- [Configuration form](https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/components/configuration/SearchEngineConfigurationFormComponent.jsx): `webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/components/configuration/SearchEngineConfigurationFormComponent.jsx`
- [Configuration client](https://github.com/regardsoss/regards-frontend/blob/master/webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/clients/SearchEngineConfigurationsClient.js): `webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/clients/SearchEngineConfigurationsClient.js`

### Other components

- **UI user**
- **REGARDS backend**

## Connections

- UI user → React entry: uses
- React entry → Root router: renders (evidence: `webapp/src/main.jsx`)
- React entry → REGARDS backend: requires
- SNR container → SNR criterion: renders (evidence: `webapp/plugins/criterion/SNR-criterion/src/containers/CriterionContainer.jsx`)
- Enumerated container → Enumerated criterion: renders (evidence: `webapp/plugins/criterion/enumerated/src/containers/EnumeratedCriterionContainer.jsx`)
- Toponym container → Toponym criterion: renders (evidence: `webapp/plugins/criterion/toponym/src/containers/ToponymCriterionContainer.jsx`)
- SNR container → Sesame client: uses (evidence: `webapp/plugins/criterion/SNR-criterion/src/containers/CriterionContainer.jsx`)
- SNR criterion → Cone angle helper: uses
- Enumerated container → Property values client: uses (evidence: `webapp/plugins/criterion/enumerated/src/containers/EnumeratedCriterionContainer.jsx`)
- Toponym container → Toponym search client: uses
- Configuration container → Configuration form: renders (evidence: `webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/containers/configuration/SearchEngineConfigurationFormContainer.jsx`)
- Configuration container → Configuration client: dispatches (evidence: `webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/containers/configuration/SearchEngineConfigurationFormContainer.jsx`)
- Configuration form → Configuration container: submits (evidence: `webapp/web_modules/business-modules/admin-dataaccess-searchengines-management/src/components/configuration/SearchEngineConfigurationFormComponent.jsx`)
- Context storage → UI user: stores URL state
