# mtes-mct/dialog architecture

> Architecture diagram of the GitHub repository mtes-mct/dialog, 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/mtes-mct/dialog
- Repository: https://github.com/mtes-mct/dialog

## Overview

DiaLog is a Symfony application for digitizing, diagnosing, and distributing regulatory information about logistics. Its principal workflow is for organizations to manage regulatory orders—including measures, locations, and periods—and then expose or export that information. The tree also shows user and organization administration, external regulation imports, geocoding, statistics, and a blog. Relationships are shown only where the README or excerpts support them; links to unsampled subsystems are dashed and unverified.

Main entry points: [`src/Infrastructure/Controller/Api/Regulations/AddStorageRegulationOrderController.php`](https://github.com/mtes-mct/dialog/blob/main/src/Infrastructure/Controller/Api/Regulations/AddStorageRegulationOrderController.php) (API document upload), [`src/Infrastructure/Controller/Regulation/AbstractRegulationController.php`](https://github.com/mtes-mct/dialog/blob/main/src/Infrastructure/Controller/Regulation/AbstractRegulationController.php) (Regulation endpoints), [`src/Domain/Regulation/StorageRegulationOrder.php`](https://github.com/mtes-mct/dialog/blob/main/src/Domain/Regulation/StorageRegulationOrder.php) (Regulation orders), [`src/Application/Regulation/Query/Location/GetNamedStreetGeometryQueryHandler.php`](https://github.com/mtes-mct/dialog/blob/main/src/Application/Regulation/Query/Location/GetNamedStreetGeometryQueryHandler.php) (Street geometry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_regulation_http["Regulation endpoints"]
  node_api_storage["API document upload"]
  node_command_bus["Command bus"]
  node_query_bus["Query bus"]
end

subgraph group_regulation["Regulation management"]
  node_regulation_orders["Regulation orders"]
  node_measures["Measures<br/>[Measure.php]"]
  node_locations["Locations<br/>[Location.php]"]
  node_street_geocoding["Street geometry"]
  node_regulation_storage["Regulation documents"]
end

subgraph group_organization["Organizations and users"]
  node_organizations["Organizations<br/>[Organization.php]"]
  node_users["Users<br/>[User.php]"]
end

subgraph group_distribution["Distribution and integrations"]
  node_cifs_feed["CIFS incidents"]
  node_imports["Regulation imports"]
  node_datex_csv["DATEX and CSV"]
  node_statistics["Statistics"]
end

subgraph group_content["Public content"]
  node_blog["Blog"]
end

node_database[("PostgreSQL")]
node_organization_user(("Organization staff"))
node_regulation_user(("Regulation editor"))
node_external_sources(("External sources"))
node_public_consumers(("Information consumers"))

node_organization_user -.->|"manages"| node_organizations
node_organization_user -.->|"administers"| node_users
node_regulation_user -.->|"edits orders"| node_regulation_http
node_regulation_http -.->|"queries"| node_query_bus
node_regulation_http -.->|"commands"| node_command_bus
node_api_storage -->|"looks up"| node_query_bus
node_api_storage -->|"saves document"| node_command_bus
node_api_storage -->|"updates"| node_regulation_storage
node_regulation_orders -->|"contains"| node_measures
node_measures -->|"contains"| node_locations
node_street_geocoding -->|"reads geometry"| node_locations
node_street_geocoding -.->|"geocodes via"| node_external_sources
node_cifs_feed -.->|"provides incidents"| node_public_consumers
node_external_sources -.->|"supplies regulations"| node_imports
node_datex_csv -.->|"exports data"| node_public_consumers
node_statistics -.->|"records metrics"| node_database
node_organizations -.->|"persists"| node_database
node_regulation_orders -.->|"persists"| node_database
node_blog -.->|"publishes content"| node_public_consumers

click node_organizations "https://github.com/mtes-mct/dialog/blob/main/src/Domain/User/Organization.php"
click node_users "https://github.com/mtes-mct/dialog/blob/main/src/Domain/User/User.php"
click node_regulation_http "https://github.com/mtes-mct/dialog/blob/main/src/Infrastructure/Controller/Regulation/AbstractRegulationController.php"
click node_api_storage "https://github.com/mtes-mct/dialog/blob/main/src/Infrastructure/Controller/Api/Regulations/AddStorageRegulationOrderController.php"
click node_command_bus "https://github.com/mtes-mct/dialog/blob/main/src/Application/CommandBusInterface.php"
click node_query_bus "https://github.com/mtes-mct/dialog/blob/main/src/Application/QueryBusInterface.php"
click node_regulation_orders "https://github.com/mtes-mct/dialog/blob/main/src/Domain/Regulation/StorageRegulationOrder.php"
click node_measures "https://github.com/mtes-mct/dialog/blob/main/src/Domain/Regulation/Measure.php"
click node_locations "https://github.com/mtes-mct/dialog/blob/main/src/Domain/Regulation/Location/Location.php"
click node_street_geocoding "https://github.com/mtes-mct/dialog/blob/main/src/Application/Regulation/Query/Location/GetNamedStreetGeometryQueryHandler.php"
click node_cifs_feed "https://github.com/mtes-mct/dialog/blob/main/src/Application/Regulation/Query/GetCifsIncidentsQueryHandler.php"
click node_regulation_storage "https://github.com/mtes-mct/dialog/blob/main/src/Domain/Regulation/StorageRegulationOrder.php"
click node_imports "https://github.com/mtes-mct/dialog/tree/main/src/Application/Integration"
click node_datex_csv "https://github.com/mtes-mct/dialog/tree/main/src/Application/Regulation"
click node_statistics "https://github.com/mtes-mct/dialog/tree/main/src/Application/Statistics"
click node_blog "https://github.com/mtes-mct/dialog/tree/main/blog"

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_regulation_http,node_api_storage,node_command_bus,node_query_bus toneBlue
class node_regulation_orders,node_measures,node_locations,node_street_geocoding,node_regulation_storage,node_database toneAmber
class node_organizations,node_users toneMint
class node_cifs_feed,node_imports,node_datex_csv,node_statistics toneRose
class node_blog,node_organization_user,node_regulation_user,node_external_sources,node_public_consumers toneIndigo
```

## Components

### Application entry

- [Regulation endpoints](https://github.com/mtes-mct/dialog/blob/main/src/Infrastructure/Controller/Regulation/AbstractRegulationController.php): `src/Infrastructure/Controller/Regulation/AbstractRegulationController.php`
- [API document upload](https://github.com/mtes-mct/dialog/blob/main/src/Infrastructure/Controller/Api/Regulations/AddStorageRegulationOrderController.php): `src/Infrastructure/Controller/Api/Regulations/AddStorageRegulationOrderController.php`
- [Command bus](https://github.com/mtes-mct/dialog/blob/main/src/Application/CommandBusInterface.php): `src/Application/CommandBusInterface.php`
- [Query bus](https://github.com/mtes-mct/dialog/blob/main/src/Application/QueryBusInterface.php): `src/Application/QueryBusInterface.php`

### Regulation management

- [Regulation orders](https://github.com/mtes-mct/dialog/blob/main/src/Domain/Regulation/StorageRegulationOrder.php): `src/Domain/Regulation/StorageRegulationOrder.php`
- [Measures](https://github.com/mtes-mct/dialog/blob/main/src/Domain/Regulation/Measure.php): `src/Domain/Regulation/Measure.php`
- [Locations](https://github.com/mtes-mct/dialog/blob/main/src/Domain/Regulation/Location/Location.php): `src/Domain/Regulation/Location/Location.php`
- [Street geometry](https://github.com/mtes-mct/dialog/blob/main/src/Application/Regulation/Query/Location/GetNamedStreetGeometryQueryHandler.php): `src/Application/Regulation/Query/Location/GetNamedStreetGeometryQueryHandler.php`
- [Regulation documents](https://github.com/mtes-mct/dialog/blob/main/src/Domain/Regulation/StorageRegulationOrder.php): `src/Domain/Regulation/StorageRegulationOrder.php`

### Organizations and users

- [Organizations](https://github.com/mtes-mct/dialog/blob/main/src/Domain/User/Organization.php): `src/Domain/User/Organization.php`
- [Users](https://github.com/mtes-mct/dialog/blob/main/src/Domain/User/User.php): `src/Domain/User/User.php`

### Distribution and integrations

- [CIFS incidents](https://github.com/mtes-mct/dialog/blob/main/src/Application/Regulation/Query/GetCifsIncidentsQueryHandler.php): `src/Application/Regulation/Query/GetCifsIncidentsQueryHandler.php`
- [Regulation imports](https://github.com/mtes-mct/dialog/tree/main/src/Application/Integration): `src/Application/Integration`
- [DATEX and CSV](https://github.com/mtes-mct/dialog/tree/main/src/Application/Regulation): `src/Application/Regulation`
- [Statistics](https://github.com/mtes-mct/dialog/tree/main/src/Application/Statistics): `src/Application/Statistics`

### Public content

- [Blog](https://github.com/mtes-mct/dialog/tree/main/blog): `blog`

### Other components

- **PostgreSQL**
- **Organization staff**
- **Regulation editor**
- **External sources**
- **Information consumers**

## Connections

- Organization staff → Organizations: manages
- Organization staff → Users: administers
- Regulation editor → Regulation endpoints: edits orders
- Regulation endpoints → Query bus: queries (evidence: `src/Infrastructure/Controller/Regulation/AbstractRegulationController.php`)
- Regulation endpoints → Command bus: commands
- API document upload → Query bus: looks up (evidence: `src/Infrastructure/Controller/Api/Regulations/AddStorageRegulationOrderController.php`)
- API document upload → Command bus: saves document (evidence: `src/Infrastructure/Controller/Api/Regulations/AddStorageRegulationOrderController.php`)
- API document upload → Regulation documents: updates (evidence: `src/Infrastructure/Controller/Api/Regulations/AddStorageRegulationOrderController.php`)
- Regulation orders → Measures: contains (evidence: `src/Domain/Regulation/Measure.php`)
- Measures → Locations: contains (evidence: `src/Domain/Regulation/Measure.php`)
- Street geometry → Locations: reads geometry (evidence: `src/Application/Regulation/Query/Location/GetNamedStreetGeometryQueryHandler.php`)
- Street geometry → External sources: geocodes via
- CIFS incidents → Information consumers: provides incidents
- External sources → Regulation imports: supplies regulations
- DATEX and CSV → Information consumers: exports data
- Statistics → PostgreSQL: records metrics
- Organizations → PostgreSQL: persists
- Regulation orders → PostgreSQL: persists
- Blog → Information consumers: publishes content
