Merge pull request #1065 from pixelated/diagram-account-recovery

 Updated 'Forgot Password' diagram

4 files changed, 70 insertions, 35 deletions

diff --git a/service/diagrams/backup_account.txt b/service/diagrams/backup_account.puml
index 661126f2..7af99608 100644
--- a/service/diagrams/backup_account.txt
+++ b/service/diagrams/backup_account.puml
@@ -1,3 +1,4 @@
+@startuml
 title Backup Account Flow
 
 actor User
@@ -35,3 +36,4 @@ else bonafide failure
   note right: delete new recovery code
   PixUA -> User : error message
 end
+@enduml
diff --git a/service/diagrams/forgot_password.png b/service/diagrams/forgot_password.png
index 37dea8fa..472e3925 100644
--- a/service/diagrams/forgot_password.png
+++ b/service/diagrams/forgot_password.png
diff --git a/service/diagrams/forgot_password.puml b/service/diagrams/forgot_password.puml
new file mode 100644
index 00000000..bfa746b8
--- /dev/null
+++ b/service/diagrams/forgot_password.puml
@@ -0,0 +1,68 @@
+@startuml
+title Forgot Password Flow
+
+skinparam handwritten false
+skinparam sequenceGroupBorderColor LightGrey
+
+skinparam sequence {
+	ArrowColor Black
+	ActorBorderColor DeepSkyBlue
+	LifeLineBorderColor blue
+	LifeLineBackgroundColor #A9DCDF
+
+	ParticipantBorderColor DeepSkyBlue
+	ParticipantBackgroundColor White
+	ParticipantFontName Impact
+	ParticipantFontSize 17
+	ParticipantFontColor Grey
+
+	ActorBackgroundColor aqua
+	ActorFontColor DeepSkyBlue
+	ActorFontSize 17
+	ActorFontName Aapex
+}
+
+actor User
+
+User -> PixUA : Submit recovery code and new password
+alt submit successful
+
+    PixUA -> BonafideClient : //Handshake//
+    alt Handshake Successful
+
+        PixUA -> BonafideClient : Generate Salt & Verifier
+        alt Salt & Verifier Generation Successful
+
+            BonafideClient -> LeapWebapp : Authenticate & Save New Password
+            alt New Password Saved
+                LeapWebapp -> BonafideClient : New Password Success
+                BonafideClient -> PixUA : New Password Success
+
+                PixUA -> SoledadClient : Save Secret With New Password
+                alt Bonafide secret & new password saved successfully
+                  SoledadClient -> PixUA : Secret saved successfully
+                  PixUA -> User : Redirect To Confirmation Page
+                else soledad failure
+                  PixUA -> User : Error Message
+                end
+
+            else bonafide failure
+                LeapWebapp -> BonafideClient : New Password Not Saved
+                BonafideClient -> PixUA : New Password Not Saved
+                PixUA -> User : Error Message
+            end
+
+        else Salt & Verifier Generation Error
+            BonafideClient -> PixUA : Salt Generation Error
+            PixUA -> User : Error Message
+        end
+
+    else Handshake Failure
+        BonafideClient -> PixUA : Handshake Failure
+        PixUA -> User : Error Message
+    end
+
+else submit failure
+    PixUA -> User : Error Message
+end
+@enduml
diff --git a/service/diagrams/forgot_password.txt b/service/diagrams/forgot_password.txt
deleted file mode 100644
index 2a303ddc..00000000
--- a/service/diagrams/forgot_password.txt
+++ /dev/null
@@ -1,35 +0,0 @@
-title Forgot Password Flow
-
-actor User
-
-User -> PixUA : recovery code and new password
-
-PixUA -> BonafideClient : //handshake//
-PixUA -> BonafideClient : recovery code and new password
-note right
-  generate salt and verifier
-end note
-
-BonafideClient -> LeapWebapp : recovery code and new password
-note right
-  authenticate
-  save new password
-end note
-
-LeapWebapp -> BonafideClient
-BonafideClient -> PixUA
-
-alt successful case
-  PixUA -> SoledadClient : new password
-  note right : save secret with new password
-  SoledadClient -> PixUA
-
-  alt successful case
-    PixUA -> User : confirmation page
-    note left: start backup account flow
-  else soledad failure
-    PixUA -> User : error message
-  end
-else bonafide failure
-  PixUA -> User : error message
-end