docs: Generate storage diagrams

Author: zguesmi

.gitignore

@@ -20,3 +20,6 @@ build/*.json
 contracts/hardhat-dependency-compiler/
 deployments/*hardhat*
 deployments/dev-*
+
+# Flattened Solidity file used to generate diagrams.
+flatten.sol

README.md

@@ -20,10 +20,12 @@ This repository contains the smart contract implementation of iExec's PoCo proto
 
 - [Contracts and Actors Architecture](./docs/README.md#contracts-and-actors-architecture)
 - [State diagrams](./docs/Statuses.md)
-- [Storage diagram (Boost)](./docs/uml/storage-IexecPocoBoostDelegate.svg)
 - [Nominal workflow sequence](./docs/README.md#nominal)
 - [Nominal workflow sequence w/ TEE](./docs/README.md#nominaltee)
 - [Boost workflow sequence](./docs/README.md#boost)
+- Storage diagrams
+    - [Diamond storage](./docs/uml/storage-diagram-diamond.svg)
+    - [PoCo storage](./docs/uml/storage-diagram-poco.svg)
 - UML classes related to:
     - [IexecPocoDelegates](./docs/uml/class-uml-IexecPocoDelegates.svg)
     - [IexecPocoBoostDelegate](./docs/uml/class-uml-IexecPocoBoostDelegate.svg)

contracts/tools/diagrams/StorageDiagrams.sol

@@ -0,0 +1,20 @@
+// SPDX-FileCopyrightText: 2025 IEXEC BLOCKCHAIN TECH <contact@iex.ec>
+// SPDX-License-Identifier: Apache-2.0
+
+pragma solidity ^0.8.0;
+
+import {LibDiamond} from "@mudgen/diamond-1/contracts/libraries/LibDiamond.sol";
+import {PocoStorageLib} from "../../libs/PocoStorageLib.v8.sol";
+
+// /!\ These contracts are only used to generate storage diagrams, they are not meant
+// to be deployed or used in any way.
+// PocoStorageLib and LibDiamond use namespaced storage which makes sol2uml unable to
+// generate diagrams directly, so these contracts provide their structs to sol2uml.
+
+contract DiamondStorageDiagram {
+    LibDiamond.DiamondStorage diamondStorage;
+}
+
+contract PocoStorageDiagram {
+    PocoStorageLib.PocoStorage pocoStorage;
+}