# programmevitam/sedatools architecture

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

## Overview

sedatools combines SEDA package construction and editing with mail extraction and SIP-generation utilities. The main user workflows are importing or editing archive content in Resip and exporting a SEDA SIP, and selecting a mail source in MailExtract and extracting it as a SEDA-compatible directory structure. The README documents these capabilities; source excerpts are limited, so unshown implementation links are omitted or marked unverified.

Main entry points: [`sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectPackage.java`](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectPackage.java) (Data object package), [`resip/src/main/java/fr/gouv/vitam/tools/resip/app/ResipGraphicApp.java`](https://github.com/programmevitam/sedatools/blob/master/resip/src/main/java/fr/gouv/vitam/tools/resip/app/ResipGraphicApp.java) (Resip GUI), [`mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/core/StoreExtractor.java`](https://github.com/programmevitam/sedatools/blob/master/mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/core/StoreExtractor.java) (Store extractor), [`sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/SIPBuilder.java`](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/SIPBuilder.java) (SIP builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["User applications"]
  node_resip["Resip GUI"]
  node_resipwindow["Main window<br/>[MainWindow.java]"]
  node_interaction["User interaction"]
  node_mailapp["MailExtract"]
  node_mailgui["Mail GUI"]
  node_mailthread["Extraction worker"]
end

subgraph group_mail["Mail extraction"]
  node_extractor["Store extractor"]
  node_sourceadapters["Mail adapters"]
  node_pstreader["PST reader"]
  node_mailformats["Content conversion"]
  node_mailoutput["Extracted directory"]
end

subgraph group_seda["SEDA package model"]
  node_package["Data object package"]
  node_archiveunit["Archive units<br/>[ArchiveUnit.java]"]
  node_datagroup["Data object groups"]
  node_binary["Binary objects"]
  node_metadata["SEDA metadata<br/>[SEDAMetadata.java]"]
  node_content["Descriptive content<br/>[Content.java]"]
  node_management["Management metadata"]
end

subgraph group_io["Import and export"]
  node_builder["SIP builder<br/>[SIPBuilder.java]"]
  node_diskimport["Disk importer"]
  node_csvexport["CSV metadata export"]
  node_xml["SEDA XML"]
end

node_archivist(("Archivist"))
node_mailuser(("Mail operator"))
node_sipuser(("SIP consumer"))

node_archivist -->|"uses"| node_resip
node_resip -.->|"opens"| node_resipwindow
node_resipwindow -.->|"prompts"| node_interaction
node_resip -.->|"edits packages"| node_package
node_resip -->|"imports disk"| node_diskimport
node_resip -.->|"exports SIP"| node_builder
node_mailuser -->|"starts extraction"| node_mailapp
node_mailapp -->|"opens GUI"| node_mailgui
node_mailapp -.->|"runs extraction"| node_mailthread
node_mailthread -.->|"extracts source"| node_extractor
node_extractor -.->|"dispatches to"| node_sourceadapters
node_sourceadapters -.->|"reads PST"| node_pstreader
node_extractor -.->|"normalizes content"| node_mailformats
node_extractor -->|"writes structure"| node_mailoutput
node_mailoutput -->|"feeds import"| node_package
node_diskimport -.->|"builds package"| node_package
node_package -->|"indexes units"| node_archiveunit
node_package -->|"indexes groups"| node_datagroup
node_package -->|"indexes binaries"| node_binary
node_archiveunit -->|"holds metadata"| node_content
node_content -.->|"extends metadata"| node_metadata
node_archiveunit -.->|"uses rules"| node_management
node_builder -->|"serializes package"| node_package
node_builder -.->|"writes SEDA XML"| node_xml
node_package -->|"exports metadata"| node_csvexport
node_builder -->|"produces SIP"| node_sipuser

click node_resip "https://github.com/programmevitam/sedatools/blob/master/resip/src/main/java/fr/gouv/vitam/tools/resip/app/ResipGraphicApp.java"
click node_resipwindow "https://github.com/programmevitam/sedatools/blob/master/resip/src/main/java/fr/gouv/vitam/tools/resip/frame/MainWindow.java"
click node_interaction "https://github.com/programmevitam/sedatools/blob/master/resip/src/main/java/fr/gouv/vitam/tools/resip/frame/UserInteractionDialog.java"
click node_mailapp "https://github.com/programmevitam/sedatools/blob/master/mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractApp.java"
click node_mailgui "https://github.com/programmevitam/sedatools/blob/master/mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractMainWindow.java"
click node_mailthread "https://github.com/programmevitam/sedatools/blob/master/mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractThread.java"
click node_extractor "https://github.com/programmevitam/sedatools/blob/master/mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/core/StoreExtractor.java"
click node_sourceadapters "https://github.com/programmevitam/sedatools/tree/master/mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/store"
click node_pstreader "https://github.com/programmevitam/sedatools/blob/master/mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/store/microsoft/pst/PstStoreExtractor.java"
click node_mailformats "https://github.com/programmevitam/sedatools/tree/master/mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/formattools"
click node_package "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectPackage.java"
click node_archiveunit "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/ArchiveUnit.java"
click node_datagroup "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectGroup.java"
click node_binary "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/BinaryDataObject.java"
click node_metadata "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/SEDAMetadata.java"
click node_content "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/content/Content.java"
click node_management "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/ManagementMetadata.java"
click node_builder "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/SIPBuilder.java"
click node_diskimport "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/importer/DiskToDataObjectPackageImporter.java"
click node_csvexport "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/exporter/DataObjectPackageToCSVMetadataExporter.java"
click node_xml "https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/xml/SEDAXMLEventReader.java"

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_resip,node_resipwindow,node_interaction,node_mailapp,node_mailgui,node_mailthread toneBlue
class node_extractor,node_sourceadapters,node_pstreader,node_mailformats,node_mailoutput toneAmber
class node_package,node_archiveunit,node_datagroup,node_binary,node_metadata,node_content,node_management toneMint
class node_builder,node_diskimport,node_csvexport,node_xml toneRose
class node_archivist,node_mailuser,node_sipuser toneIndigo
```

## Components

### User applications

- [Resip GUI](https://github.com/programmevitam/sedatools/blob/master/resip/src/main/java/fr/gouv/vitam/tools/resip/app/ResipGraphicApp.java): `resip/src/main/java/fr/gouv/vitam/tools/resip/app/ResipGraphicApp.java`
- [Main window](https://github.com/programmevitam/sedatools/blob/master/resip/src/main/java/fr/gouv/vitam/tools/resip/frame/MainWindow.java): `resip/src/main/java/fr/gouv/vitam/tools/resip/frame/MainWindow.java`
- [User interaction](https://github.com/programmevitam/sedatools/blob/master/resip/src/main/java/fr/gouv/vitam/tools/resip/frame/UserInteractionDialog.java): `resip/src/main/java/fr/gouv/vitam/tools/resip/frame/UserInteractionDialog.java`
- [MailExtract](https://github.com/programmevitam/sedatools/blob/master/mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractApp.java): `mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractApp.java`
- [Mail GUI](https://github.com/programmevitam/sedatools/blob/master/mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractMainWindow.java): `mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractMainWindow.java`
- [Extraction worker](https://github.com/programmevitam/sedatools/blob/master/mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractThread.java): `mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractThread.java`

### Mail extraction

- [Store extractor](https://github.com/programmevitam/sedatools/blob/master/mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/core/StoreExtractor.java): `mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/core/StoreExtractor.java`
- [Mail adapters](https://github.com/programmevitam/sedatools/tree/master/mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/store): `mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/store`
- [PST reader](https://github.com/programmevitam/sedatools/blob/master/mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/store/microsoft/pst/PstStoreExtractor.java): `mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/store/microsoft/pst/PstStoreExtractor.java`
- [Content conversion](https://github.com/programmevitam/sedatools/tree/master/mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/formattools): `mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/formattools`
- **Extracted directory**

### SEDA package model

- [Data object package](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectPackage.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectPackage.java`
- [Archive units](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/ArchiveUnit.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/ArchiveUnit.java`
- [Data object groups](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectGroup.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectGroup.java`
- [Binary objects](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/BinaryDataObject.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/BinaryDataObject.java`
- [SEDA metadata](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/SEDAMetadata.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/SEDAMetadata.java`
- [Descriptive content](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/content/Content.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/content/Content.java`
- [Management metadata](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/ManagementMetadata.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/ManagementMetadata.java`

### Import and export

- [SIP builder](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/SIPBuilder.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/SIPBuilder.java`
- [Disk importer](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/importer/DiskToDataObjectPackageImporter.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/importer/DiskToDataObjectPackageImporter.java`
- [CSV metadata export](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/exporter/DataObjectPackageToCSVMetadataExporter.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/inout/exporter/DataObjectPackageToCSVMetadataExporter.java`
- [SEDA XML](https://github.com/programmevitam/sedatools/blob/master/sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/xml/SEDAXMLEventReader.java): `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/xml/SEDAXMLEventReader.java`

### Other components

- **Archivist**
- **Mail operator**
- **SIP consumer**

## Connections

- Archivist → Resip GUI: uses
- Resip GUI → Main window: opens (evidence: `resip/src/main/java/fr/gouv/vitam/tools/resip/app/ResipGraphicApp.java`)
- Main window → User interaction: prompts (evidence: `resip/src/main/java/fr/gouv/vitam/tools/resip/frame/UserInteractionDialog.java`)
- Resip GUI → Data object package: edits packages
- Resip GUI → Disk importer: imports disk (evidence: `resip/src/main/java/fr/gouv/vitam/tools/resip/sedaobjecteditor/components/viewers/DataObjectListTransferHandler.java`)
- Resip GUI → SIP builder: exports SIP
- Mail operator → MailExtract: starts extraction
- MailExtract → Mail GUI: opens GUI (evidence: `mailextract/src/main/java/fr/gouv/vitam/tools/mailextract/MailExtractMainWindow.java`)
- MailExtract → Extraction worker: runs extraction
- Extraction worker → Store extractor: extracts source
- Store extractor → Mail adapters: dispatches to (evidence: `mailextractlib/src/main/java/fr/gouv/vitam/tools/mailextractlib/core/StoreExtractor.java`)
- Mail adapters → PST reader: reads PST
- Store extractor → Content conversion: normalizes content
- Store extractor → Extracted directory: writes structure
- Extracted directory → Data object package: feeds import
- Disk importer → Data object package: builds package
- Data object package → Archive units: indexes units (evidence: `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectPackage.java`)
- Data object package → Data object groups: indexes groups (evidence: `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectPackage.java`)
- Data object package → Binary objects: indexes binaries (evidence: `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/DataObjectPackage.java`)
- Archive units → Descriptive content: holds metadata (evidence: `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/core/ArchiveUnit.java`)
- Descriptive content → SEDA metadata: extends metadata (evidence: `sedalib/src/main/java/fr/gouv/vitam/tools/sedalib/metadata/content/Content.java`)
- Archive units → Management metadata: uses rules
- SIP builder → Data object package: serializes package
- SIP builder → SEDA XML: writes SEDA XML
- Data object package → CSV metadata export: exports metadata
- SIP builder → SIP consumer: produces SIP
