Update documentation for composition and instance states

Issue-ID: POLICY-4935
Change-Id: I737fdead03bb5d485d665bee598ee8626824d7e5
Signed-off-by: FrancescoFioraEst <francesco.fiora@est.tech>

7 files changed, 108 insertions, 9 deletions

diff --git a/docs/clamp/acm/plantuml/states/AcElementInstanceStatesOnRuntime.puml b/docs/clamp/acm/plantuml/states/AcElementInstanceStatesOnRuntime.puml
index c27b320c..13faeacf 100644
--- a/docs/clamp/acm/plantuml/states/AcElementInstanceStatesOnRuntime.puml
+++ b/docs/clamp/acm/plantuml/states/AcElementInstanceStatesOnRuntime.puml
@@ -3,20 +3,24 @@
 [*] --> UNDEPLOYED: Create
 UNDEPLOYED --> [*]: Delete
 UNDEPLOYED --> DEPLOYING: Deploy
-DEPLOYING --> DEPLOYED: AC Element\nInstance DEPLOYED
+DEPLOYING --> DEPLOYED: AC Instance\nElement DEPLOYED
 DEPLOYING --> UNDEPLOYING: Undeploy
 DEPLOYED --> UNDEPLOYING: Undeploy
-UNDEPLOYING --> UNDEPLOYED: AC Element\nInstance UNDEPLOYED
+DEPLOYED --> UPDATING: Update
+DEPLOYED --> MIGRATING: Migrate
+MIGRATING --> DEPLOYED: AC Instance\nElement MIGRATED
+UNDEPLOYING --> UNDEPLOYED: AC Instance\nElement UNDEPLOYED
+UNDEPLOYING --> UNDEPLOYED: AC Instance\nElement UNDEPLOYED
 
 
 state DEPLOYED {
  [*] --> LOCKED: Deploy
  LOCKED --> [*]: Undeploy
  LOCKED --> UNLOCKING: Unlock
- UNLOCKING --> UNLOCKED: AC Element\nInstance UNLOCKED
+ UNLOCKING --> UNLOCKED: AC Instance\nElement UNLOCKED
  UNLOCKED --> LOCKING: Lock
  UNLOCKING --> LOCKING: Lock
- LOCKING --> LOCKED: AC Element\nInstance LOCKED
+ LOCKING --> LOCKED: AC Instance\nElement LOCKED
 }
 
 @enduml
diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStates.puml b/docs/clamp/acm/plantuml/states/AcInstanceStates.puml
index 17958411..f8483ffe 100644
--- a/docs/clamp/acm/plantuml/states/AcInstanceStates.puml
+++ b/docs/clamp/acm/plantuml/states/AcInstanceStates.puml
@@ -3,20 +3,23 @@
 [*] --> UNDEPLOYED: Create
 UNDEPLOYED --> [*]: Delete
 UNDEPLOYED --> DEPLOYING: Deploy
-DEPLOYING --> DEPLOYED: AC Element Instances\nall DEPLOYED
+DEPLOYING --> DEPLOYED: AC Instance Elements\nall DEPLOYED
 DEPLOYING --> UNDEPLOYING: Undeploy
 DEPLOYED --> UNDEPLOYING: Undeploy
-UNDEPLOYING --> UNDEPLOYED: AC Element Types\nall UNDEPLOYED
-
+DEPLOYED --> UPDATING: Update
+DEPLOYED --> MIGRATING: Migrate
+UPDATING --> DEPLOYED: AC Instance Elements\nall UPDATED
+MIGRATING --> DEPLOYED: AC Instance Elements\nall MIGRATED
+UNDEPLOYING --> UNDEPLOYED: AC Instance Elements\nall UNDEPLOYED
 
 state DEPLOYED {
  [*] --> LOCKED: Deploy
  LOCKED --> [*]: Undeploy
  LOCKED --> UNLOCKING: Unlock
- UNLOCKING --> UNLOCKED: AC Element Types\nall UNLOCKED
+ UNLOCKING --> UNLOCKED: AC Instance Elements\nall UNLOCKED
  UNLOCKED --> LOCKING: Lock
  UNLOCKING --> LOCKING: Lock
- LOCKING --> LOCKED: AC Element Types\nall LOCKED
+ LOCKING --> LOCKED: AC Instance Elements\nall LOCKED
 }
 
 @enduml
diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStatesDelete.puml b/docs/clamp/acm/plantuml/states/AcInstanceStatesDelete.puml
new file mode 100644
index 00000000..c6dae42d
--- /dev/null
+++ b/docs/clamp/acm/plantuml/states/AcInstanceStatesDelete.puml
@@ -0,0 +1,12 @@
+@startuml
+
+UNDEPLOYED:UNDEPLOYED:NO_ERROR --> DELETING:DELETING: Delete
+DELETING:DELETING --> UNDEPLOYED:DELETING:FAILED: Delete failed
+DELETING:DELETING --> DELETING:DELETING:TIMEOUT
+DELETING:DELETING --> [*]: Deleted
+UNDEPLOYED:DELETING:FAILED --> DELETING:DELETING: Delete
+DELETING:DELETING:TIMEOUT --> UNDEPLOYED:DELETING:FAILED: Delete failed
+DELETING:DELETING:TIMEOUT --> DELETING:DELETING: Delete
+DELETING:DELETING:TIMEOUT -->  [*]: Deleted
+
+@enduml
diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStatesDeploy.puml b/docs/clamp/acm/plantuml/states/AcInstanceStatesDeploy.puml
new file mode 100644
index 00000000..1d0f0920
--- /dev/null
+++ b/docs/clamp/acm/plantuml/states/AcInstanceStatesDeploy.puml
@@ -0,0 +1,25 @@
+@startuml
+
+[*] --> UNDEPLOYED:UNDEPLOYED:NO_ERROR: Create
+UNDEPLOYED:UNDEPLOYED:NO_ERROR --> [*]: Delete
+UNDEPLOYED:UNDEPLOYED:NO_ERROR --> DEPLOYING:DEPLOYING: Deploy
+DEPLOYING:DEPLOYING --> DEPLOYED:DEPLOYED:NO_ERROR: Deployed
+DEPLOYING:DEPLOYING --> UNDEPLOYED:DEPLOYING:FAILED: Deploy failed
+DEPLOYING:DEPLOYING --> DEPLOYING:DEPLOYING:TIMEOUT: Deploy timeout
+DEPLOYING:DEPLOYING:TIMEOUT --> DEPLOYED:DEPLOYED:NO_ERROR: Deployed
+DEPLOYING:DEPLOYING:TIMEOUT --> UNDEPLOYED:DEPLOYING:FAILED: Deploy failed
+DEPLOYING:DEPLOYING:TIMEOUT --> DEPLOYING:DEPLOYING: Deploy
+UNDEPLOYED:DEPLOYING:FAILED --> DEPLOYING:DEPLOYING: Deploy
+UNDEPLOYED:DEPLOYING:FAILED --> UNDEPLOYING:UNDEPLOYING: Undeploy
+DEPLOYED:DEPLOYED:NO_ERROR --> UNDEPLOYING:UNDEPLOYING: Undeploy
+UNDEPLOYING:UNDEPLOYING --> UNDEPLOYED:UNDEPLOYED:NO_ERROR: Undeployed
+UNDEPLOYING:UNDEPLOYING --> DEPLOYED:UNDEPLOYING:FAILED: Undeploy failed
+UNDEPLOYING:UNDEPLOYING --> UNDEPLOYING:UNDEPLOYING:TIMEOUT: Undeploy timeout
+DEPLOYED:UNDEPLOYING:FAILED --> UNDEPLOYING:UNDEPLOYING: Undeploy
+DEPLOYED:UNDEPLOYING:FAILED --> DEPLOYING:DEPLOYING: Deploy
+UNDEPLOYING:UNDEPLOYING:TIMEOUT --> UNDEPLOYED:UNDEPLOYED:NO_ERROR: Undeployed
+UNDEPLOYING:UNDEPLOYING:TIMEOUT --> DEPLOYED:UNDEPLOYING:FAILED: Undeploy failed
+UNDEPLOYING:UNDEPLOYING:TIMEOUT --> UNDEPLOYING:UNDEPLOYING: Undeploy
+UNDEPLOYING:UNDEPLOYING:TIMEOUT --> DEPLOYING:DEPLOYING: Deploy
+
+@enduml
diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStatesMigrate.puml b/docs/clamp/acm/plantuml/states/AcInstanceStatesMigrate.puml
new file mode 100644
index 00000000..b3875e81
--- /dev/null
+++ b/docs/clamp/acm/plantuml/states/AcInstanceStatesMigrate.puml
@@ -0,0 +1,12 @@
+@startuml
+
+DEPLOYED:DEPLOYED:NO_ERROR --> MIGRATING:MIGRATING: Migrate
+MIGRATING:MIGRATING --> DEPLOYED:DEPLOYED:NO_ERROR: Migrated
+MIGRATING:MIGRATING --> DEPLOYED:MIGRATING:FAILED: Migrate failed
+MIGRATING:MIGRATING --> MIGRATING:MIGRATING:TIMEOUT: Migrate timeout
+DEPLOYED:MIGRATING:FAILED --> UNDEPLOYING:UNDEPLOYING: Undeploy
+MIGRATING:MIGRATING:TIMEOUT --> DEPLOYED:MIGRATING:FAILED: Migrate failed
+MIGRATING:MIGRATING:TIMEOUT --> UNDEPLOYING:UNDEPLOYING: Undeploy
+MIGRATING:MIGRATING:TIMEOUT --> DEPLOYED:DEPLOYED:NO_ERROR: Migrated
+
+@enduml
diff --git a/docs/clamp/acm/plantuml/states/AcInstanceStatesUpdate.puml b/docs/clamp/acm/plantuml/states/AcInstanceStatesUpdate.puml
new file mode 100644
index 00000000..f5531b4c
--- /dev/null
+++ b/docs/clamp/acm/plantuml/states/AcInstanceStatesUpdate.puml
@@ -0,0 +1,14 @@
+@startuml
+
+DEPLOYED:DEPLOYED:NO_ERROR --> UPDATING:UPDATING: Update
+UPDATING:UPDATING --> DEPLOYED:DEPLOYED:NO_ERROR: Updated
+UPDATING:UPDATING --> DEPLOYED:UPDATING:FAILED: Update failed
+UPDATING:UPDATING --> UPDATING:UPDATING:TIMEOUT: Update timeout
+DEPLOYED:UPDATING:FAILED --> UPDATING:UPDATING: Update
+DEPLOYED:UPDATING:FAILED --> UNDEPLOYING:UNDEPLOYING: Undeploy
+UPDATING:UPDATING:TIMEOUT --> UPDATING:UPDATING: Update
+UPDATING:UPDATING:TIMEOUT --> DEPLOYED:UPDATING:FAILED: Update failed
+UPDATING:UPDATING:TIMEOUT --> UNDEPLOYING:UNDEPLOYING: Undeploy
+UPDATING:UPDATING:TIMEOUT --> DEPLOYED:DEPLOYED:NO_ERROR: Updated
+
+@enduml
diff --git a/docs/clamp/acm/plantuml/states/AcTypeStatesFail.puml b/docs/clamp/acm/plantuml/states/AcTypeStatesFail.puml
new file mode 100644
index 00000000..d9ff69bf
--- /dev/null
+++ b/docs/clamp/acm/plantuml/states/AcTypeStatesFail.puml
@@ -0,0 +1,29 @@
+@startuml
+
+COMMISSIONED:COMMISSIONED:NO_ERROR --> PRIMING:PRIMING: Prime
+
+PRIMING:PRIMING --> PRIMED:PRIMED:NO_ERROR: AC Element Types\nall PRIMED
+PRIMING:PRIMING --> COMMISSIONED:PRIMING:FAIL: Prime Failed
+PRIMING:PRIMING --> PRIMING:PRIMING:TIMEOUT: Prime Timeout
+
+COMMISSIONED:PRIMING:FAIL --> DEPRIMING:DEPRIMING: Deprime
+COMMISSIONED:PRIMING:FAIL --> PRIMING:PRIMING: Prime Again
+
+PRIMING:PRIMING:TIMEOUT --> DEPRIMING:DEPRIMING: Deprime
+PRIMING:PRIMING:TIMEOUT --> PRIMING:PRIMING: Prime Again
+PRIMING:PRIMING:TIMEOUT --> PRIMED:PRIMED:NO_ERROR: AC Element Types\nall PRIMED
+
+DEPRIMING:DEPRIMING --> COMMISSIONED:COMMISSIONED:NO_ERROR: AC Element Types\nall DEPRIMED
+DEPRIMING:DEPRIMING --> PRIMED:DEPRIMING:FAIL: Deprime Failed
+DEPRIMING:DEPRIMING --> DEPRIMING:DEPRIMING:TIMEOUT: Deprime Timeout
+
+PRIMED:DEPRIMING:FAIL --> DEPRIMING:DEPRIMING: Deprime Again
+PRIMED:DEPRIMING:FAIL --> PRIMING:PRIMING: Prime
+
+DEPRIMING:DEPRIMING:TIMEOUT --> DEPRIMING:DEPRIMING: Deprime Again
+DEPRIMING:DEPRIMING:TIMEOUT --> PRIMING:PRIMING: Prime
+DEPRIMING:DEPRIMING:TIMEOUT --> COMMISSIONED:COMMISSIONED:NO_ERROR: AC Element Types\nall DEPRIMED
+
+PRIMED:PRIMED:NO_ERROR --> DEPRIMING:DEPRIMING: Deprime
+
+@enduml