From 7a600157264c9ebd3664da43554bab5e3c4c9bbf Mon Sep 17 00:00:00 2001
From: Ladd Hoffman <laddhoffman@gmail.com>
Date: Mon, 10 Jun 2024 20:01:22 -0500
Subject: [PATCH] user stories: new member

---
 specification/docs/user-stories.md | 38 ++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/specification/docs/user-stories.md b/specification/docs/user-stories.md
index 562b75b..779bb6f 100644
--- a/specification/docs/user-stories.md
+++ b/specification/docs/user-stories.md
@@ -109,6 +109,44 @@ participant widget as Matrix Widget
 
 ## New member joins a DAO
 
+```mermaid
+sequenceDiagram
+
+participant Applicant
+box DAO
+participant Forum
+participant Bench
+participant Onboarding
+end
+participant Reviewer
+participant Members as DAO Members
+
+Reviewer ->> Onboarding : Stake availability
+Applicant ->> Onboarding : Send onboarding request, with fee
+Onboarding ->> Reviewer : Assign reviewer
+Reviewer ->> Forum : Post recommendation
+Reviewer ->> Onboarding : Submit recommendation
+Onboarding ->> Bench : Initiate Validation Pool, including portion of onboarding fee
+Bench -->> Forum : VP targets recommendation post
+Members ->> Bench : Stake for/against VP
+alt Recommendation VP passes
+Bench ->> Forum : Awards minted Reputation
+Forum ->> Reviewer : Propagates Reputation
+Bench ->> Members : Distributes VP fee among Members
+Onboarding ->> Forum : Make onboarding post on behalf of Applicant
+Onboarding ->> Bench : Initiate Validation Pool, including remainder of onboarding fee
+Members ->> Bench : Stake for/against VP
+Bench -->> Forum : BP targets onboarding post
+alt Onboarding VP passes
+Bench ->> Forum : Awards minted Reputation
+Forum ->> Applicant : Propagates Reputation
+Bench ->> Members : Distributes VP fee among Members
+end
+
+end
+
+```
+
 ## DAO member defines a new Work Contract
 
 ## Customer engages a Work Contract