사용자 상태 세분화

docs/worksmobile-directory-sync-technical-review.md

@@ -28,8 +28,11 @@ Baron SSO는 Ory Stack을 SoT로 두고, PostgreSQL은 read-model 및 비즈니
 한맥가족 이메일 정책은 이미 #668에서 다음 방향으로 구현되어 있습니다.
 
 - `hanmac-family` root tenant와 descendant subtree에서 email local-part를 unique로 강제합니다.
+- local-part unique 검사는 `archived`를 포함한 모든 사용자 상태를 대상으로 합니다.
 - 단건 생성은 중복 시 `409 Conflict`로 차단합니다.
 - bulk import는 `@domain` 입력 시 이름 기반 local-part를 제안하고, 생성 직전 재검증합니다.
+- `preboarding`, `baron_guest`, `extended_leave`, `archived` 사용자는 Worksmobile 구성원 생성/갱신/backfill 대상에서 제외합니다.
+- `baron_guest`, `extended_leave`, `archived` 상태로 전환된 사용자는 기존 Worksmobile 계정 delete/deprovision 대상입니다.
 
 ## 웍스모바일 Directory API 확인 사항
 
@@ -335,9 +338,12 @@ Worksmobile 운영 화면은 `orgfront`가 아니라 `adminfront`의 tenant deta
 
 - 후보 위치: `UserHandler.UpdateUser`에서 Kratos update와 local DB sync 후
 - `email`, `name`, `phone`, `companyCode`, `tenant_id`, `metadata.additionalAppointments` 변경 시 `USER UPSERT` enqueue
-- `inactive`는 Worksmobile suspend로 동기화합니다.
+- `suspended`는 Worksmobile suspend로 동기화합니다.
+- `temporary_leave`는 Worksmobile 계정을 유지합니다.
+- `preboarding`은 Worksmobile 계정을 생성하지 않습니다.
+- `baron_guest`, `extended_leave`, `archived`는 Worksmobile delete/deprovision으로 동기화합니다.
 - Baron user delete는 Worksmobile delete로 동기화합니다.
-- `leave-of-absence`는 필요하지만 orgfront/Baron user status model 확장이 선행되어야 하므로 별도 scope로 분리합니다.
+- 기존 `inactive` 입력은 `preboarding`, `leave_of_absence` 입력은 `temporary_leave`, `baron_only` 입력은 `baron_guest`로 호환 처리합니다.
 
 ## 테스트 전략
 
@@ -410,9 +416,11 @@ Worksmobile 운영 화면은 `orgfront`가 아니라 `adminfront`의 tenant deta
    - Developer Console External Key Mapping이 비어 있는 기존 조직/구성원은 CSV mapping 또는 API external-key update가 선행되어야 합니다.
 
 6. 상태 정책
-   - Baron `inactive`는 Worksmobile suspend로 동기화합니다.
+   - Baron `active`, `temporary_leave`, `suspended`는 Worksmobile 구성원 비교 및 backfill scope에 포함합니다.
+   - Baron `suspended`는 Worksmobile suspend로 동기화합니다.
+   - Baron `preboarding`은 Worksmobile 계정을 생성하지 않습니다.
+   - Baron `baron_guest`, `extended_leave`, `archived`는 Worksmobile delete/deprovision으로 동기화합니다.
    - Baron delete는 Worksmobile delete로 동기화합니다.
-   - leave-of-absence는 별도 user 상태 확장 이슈로 분리합니다.
    - 직급/직책/사용자 유형 External Key sync는 이번 scope에서 제외합니다.
 
 7. adminfront 권한 경계