법인 회원 초대 대응

2025-11-24 22:23:04 +09:00
parent a7d94c4d92
commit d7a32e1dcf
16 changed files with 2293 additions and 20 deletions
@@ -0,0 +1,64 @@
+sequenceDiagram
+    actor 법인관리자
+    participant Portal as Portal UI
+    participant UserManFacade
+    participant UserInvitationRepo as UserInvitation Repository
+    participant MessageService as Message Handler
+    participant Email as Email System
+    actor 초대받은사용자
+    participant UserRegisterController
+    participant UserRegisterFacade
+    participant PortalUserRepo as PortalUser Repository
+
+    법인관리자->>Portal: 사용자 이메일 입력<br/>초대 요청
+    Portal->>UserManFacade: sendInvitation(sender, emailAddr)
+
+    UserManFacade->>PortalUserRepo: findByEmailAddr(emailAddr)
+    alt 사용자가 없거나 이미 법인 사용자
+        UserManFacade-->>Portal: 에러 반환
+        Portal-->>법인관리자: 초대 불가 알림
+    else 일반 사용자 ROLE_USER
+        UserManFacade->>UserManFacade: generateEightCharToken()<br/>예: K7MNPQ2R
+        UserManFacade->>UserInvitationRepo: save(UserInvitation)<br/>status: PENDING<br/>expiresOn: 7일 후
+        UserManFacade->>MessageService: publishEvent(UserInvitationEvent)
+        MessageService->>Email: 초대 이메일 발송<br/>(법인명, 관리자명, 토큰)
+        UserManFacade-->>Portal: 초대 완료
+        Portal-->>법인관리자: 초대 성공 알림
+    end
+
+    Email->>초대받은사용자: 초대 이메일 수신
+
+    alt 폐쇄망 환경
+        초대받은사용자->>Portal: 8글자 토큰 직접 입력<br/>/signup/decision?invitation=K7MNPQ2R
+    else 이메일 링크
+        초대받은사용자->>Portal: 링크 클릭<br/>/signup/decision?invitation=BASE64TOKEN
+    end
+
+    Portal->>UserRegisterController: showDecisionPage(invitationToken)
+    UserRegisterController->>UserRegisterController: decodeInvitationToken()<br/>(Base64 or 직접입력 처리)
+    UserRegisterController->>UserInvitationRepo: findByToken(decodedToken)
+
+    alt 토큰 무효 or 상태가 PENDING 아님
+        UserRegisterController-->>Portal: 에러: 유효하지 않은 초대
+        Portal-->>초대받은사용자: 에러 페이지
+    else 토큰 유효
+        UserRegisterController->>PortalUserRepo: findByEmailAddr()
+        UserRegisterController-->>Portal: 약관 동의 페이지<br/>(법인명, 사용자명 표시)
+        Portal-->>초대받은사용자: 수락/거절 선택 화면
+    end
+
+    초대받은사용자->>Portal: 수락 or 거절 선택
+    Portal->>UserRegisterController: processInvitation(action)
+    UserRegisterController->>UserRegisterFacade: processInvitation(action, invitation)
+
+    alt 수락
+        UserRegisterFacade->>PortalUserRepo: findByEmailAddr()
+        UserRegisterFacade->>PortalUserRepo: updateUserToCorpUser()<br/>(PortalOrg 변경<br/>ROLE_CORP_USER 전환)
+        UserRegisterFacade->>UserInvitationRepo: save(invitation)<br/>status: COMPLETED<br/>completeDate: now()
+        UserRegisterFacade-->>Portal: 수락 성공
+        Portal-->>초대받은사용자: 성공 메시지<br/>로그아웃 후 재로그인 안내
+    else 거절
+        UserRegisterFacade->>UserInvitationRepo: save(invitation)<br/>status: REJECTED<br/>completeDate: now()
+        UserRegisterFacade-->>Portal: 거절 처리 완료
+        Portal-->>초대받은사용자: 거절 완료 메시지
+    end