@burgan-tech/morph-idm-runtime 0.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (206) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +245 -0
  3. package/burgan-tech-morph-idm-runtime-0.0.0.tgz +0 -0
  4. package/morph-idm/Extensions/.gitkeep +0 -0
  5. package/morph-idm/Functions/.gitkeep +0 -0
  6. package/morph-idm/Functions/user/function-validate-user.json +31 -0
  7. package/morph-idm/Functions/user/src/ValidateUser.csx +39 -0
  8. package/morph-idm/Mappings/device-register-evaluate-get-device-request.mapper.json +319 -0
  9. package/morph-idm/Mappings/device-register-evaluate-get-device-response.mapper.json +761 -0
  10. package/morph-idm/Mappings/device-register-new-device-call-device-start-request.mapper.json +762 -0
  11. package/morph-idm/Mappings/device-register-start.mapper.json +971 -0
  12. package/morph-idm/Mappings/device-start-request.mapper.json +20 -0
  13. package/morph-idm/Mappings/device-start.mapper.json +896 -0
  14. package/morph-idm/Mappings/device-update-request.mapper.json +883 -0
  15. package/morph-idm/Mappings/token-start-request.mapper.json +436 -0
  16. package/morph-idm/Schemas/approval-matrix/approval-matrix-master-1.0.0.json +98 -0
  17. package/morph-idm/Schemas/approval-matrix/approval-matrix-update-1.0.0.json +85 -0
  18. package/morph-idm/Schemas/client/client-master-1.0.0.json +293 -0
  19. package/morph-idm/Schemas/client/client-update-master-1.0.0.json +201 -0
  20. package/morph-idm/Schemas/consent/consent-master-1.0.0.json +151 -0
  21. package/morph-idm/Schemas/device/device-master-1.0.0.json +433 -0
  22. package/morph-idm/Schemas/device/device-register-master-1.0.0.json +300 -0
  23. package/morph-idm/Schemas/device/device-register-start-1.0.0.json +270 -0
  24. package/morph-idm/Schemas/device/device-start-1.0.0.json +281 -0
  25. package/morph-idm/Schemas/device/device-update-1.0.0.json +275 -0
  26. package/morph-idm/Schemas/headers-1.0.0.json +245 -0
  27. package/morph-idm/Schemas/organization/organization-master-1.0.0.json +386 -0
  28. package/morph-idm/Schemas/organization/organization-update-1.0.0.json +60 -0
  29. package/morph-idm/Schemas/privilege/privilege-master-1.0.0.json +84 -0
  30. package/morph-idm/Schemas/privilege/privilege-update-1.0.0.json +76 -0
  31. package/morph-idm/Schemas/scope/scope-group-master-1.0.0.json +52 -0
  32. package/morph-idm/Schemas/scope/scope-master-1.0.0.json +120 -0
  33. package/morph-idm/Schemas/token/token-master-1.0.0.json +346 -0
  34. package/morph-idm/Schemas/token/token-start-1.0.0.json +50 -0
  35. package/morph-idm/Schemas/transaction-limit/transaction-limit-master-1.0.0.json +175 -0
  36. package/morph-idm/Schemas/transaction-limit/transaction-limit-update-1.0.0.json +90 -0
  37. package/morph-idm/Schemas/user/person-master-1.0.0.json +211 -0
  38. package/morph-idm/Schemas/user/user-master-1.0.0.json +121 -0
  39. package/morph-idm/Tasks/.gitkeep +0 -0
  40. package/morph-idm/Tasks/call-device-start-1.0.0.json +21 -0
  41. package/morph-idm/Tasks/call-device-update-1.0.0.json +21 -0
  42. package/morph-idm/Tasks/client/client-create-rsa.json +26 -0
  43. package/morph-idm/Tasks/client/client-password-generator.json +14 -0
  44. package/morph-idm/Tasks/client/get-client-by-task.json +18 -0
  45. package/morph-idm/Tasks/consent/get-consent-by-task.json +18 -0
  46. package/morph-idm/Tasks/consent/get-multi-consents-by-task.json +25 -0
  47. package/morph-idm/Tasks/device/get-device-by-task.json +18 -0
  48. package/morph-idm/Tasks/get-device-1.0.0.json +20 -0
  49. package/morph-idm/Tasks/scope/get-scope-by-task.json +17 -0
  50. package/morph-idm/Tasks/scope/scope-by-user-task.json +25 -0
  51. package/morph-idm/Tasks/scope/scope-details-task.json +25 -0
  52. package/morph-idm/Tasks/token/send-token-to-main.json +20 -0
  53. package/morph-idm/Tasks/token/token-create-jwt.json +27 -0
  54. package/morph-idm/Tasks/user/get-user-by-task.json +18 -0
  55. package/morph-idm/Tasks/user/send-otp-task.json +25 -0
  56. package/morph-idm/Tasks/user/send-push-task.json +22 -0
  57. package/morph-idm/Tasks/user/user-password-generator.json +26 -0
  58. package/morph-idm/Tasks/user/verify-otp-task.json +22 -0
  59. package/morph-idm/Tasks/user/verify-push-task.json +22 -0
  60. package/morph-idm/Views/.gitkeep +0 -0
  61. package/morph-idm/Workflows/.gitkeep +0 -0
  62. package/morph-idm/Workflows/approval-matrix/approval-1.0.0.json +452 -0
  63. package/morph-idm/Workflows/approval-matrix/approval-matrix-1.0.0.json +184 -0
  64. package/morph-idm/Workflows/client/client-1.0.0.json +257 -0
  65. package/morph-idm/Workflows/client/client-update-1.0.0.json +202 -0
  66. package/morph-idm/Workflows/client/execute/client.http +377 -0
  67. package/morph-idm/Workflows/client/src/ClientCreateRsa.csx +198 -0
  68. package/morph-idm/Workflows/client/src/ClientCreateRsaByScript.csx +118 -0
  69. package/morph-idm/Workflows/client/src/CreateRsaByHttpCallMapping.csx +223 -0
  70. package/morph-idm/Workflows/client/src/PasswordGeneratorMapping.csx +26 -0
  71. package/morph-idm/Workflows/client/src/RsaExistsRule.csx +44 -0
  72. package/morph-idm/Workflows/client-manager/client-manager-1.0.0.json +217 -0
  73. package/morph-idm/Workflows/client-manager/execute/client-manager.http +214 -0
  74. package/morph-idm/Workflows/client-manager/src/ClientCreatedRule.csx +28 -0
  75. package/morph-idm/Workflows/client-manager/src/ClientExistsRule.csx +25 -0
  76. package/morph-idm/Workflows/client-manager/src/CreateClientSubFlowMapping.csx +63 -0
  77. package/morph-idm/Workflows/client-manager/src/GetClientForManagerMapping.csx +59 -0
  78. package/morph-idm/Workflows/consent/consent-1.0.0.json +424 -0
  79. package/morph-idm/Workflows/consent/execute/README.md +167 -0
  80. package/morph-idm/Workflows/consent/execute/consent-invitation-flow.http +283 -0
  81. package/morph-idm/Workflows/consent/execute/create-consent.http +780 -0
  82. package/morph-idm/Workflows/consent/src/AutoConsentRule.csx +29 -0
  83. package/morph-idm/Workflows/consent/src/ConsentTimeoutTimer.csx +14 -0
  84. package/morph-idm/Workflows/consent-selection/consent-selection-1.0.0.json +331 -0
  85. package/morph-idm/Workflows/consent-selection/src/AutoConsentCreatedRule.csx +28 -0
  86. package/morph-idm/Workflows/consent-selection/src/ConsentFetchMapping.csx +82 -0
  87. package/morph-idm/Workflows/consent-selection/src/ConsentSelectedMapping.csx +70 -0
  88. package/morph-idm/Workflows/consent-selection/src/CreateAutoConsentMapping.csx +150 -0
  89. package/morph-idm/Workflows/consent-selection/src/MultipleConsentsRule.csx +31 -0
  90. package/morph-idm/Workflows/consent-selection/src/NoConsentEligibleRule.csx +44 -0
  91. package/morph-idm/Workflows/consent-selection/src/SingleConsentRule.csx +45 -0
  92. package/morph-idm/Workflows/device/device-1.0.0.json +261 -0
  93. package/morph-idm/Workflows/device/device-migration-1.0.0.json +213 -0
  94. package/morph-idm/Workflows/device/device-register-1.0.0-documentation.md +646 -0
  95. package/morph-idm/Workflows/device/device-register-1.0.0-documentation.svg +36 -0
  96. package/morph-idm/Workflows/device/device-register-1.0.0.json +185 -0
  97. package/morph-idm/Workflows/device/execute/device-android.http +260 -0
  98. package/morph-idm/Workflows/device/execute/device-huawei.http +219 -0
  99. package/morph-idm/Workflows/device/execute/device-ios.http +325 -0
  100. package/morph-idm/Workflows/device/execute/device-web.http +284 -0
  101. package/morph-idm/Workflows/device/src/DeviceCreatedRule.csx +32 -0
  102. package/morph-idm/Workflows/device/src/DeviceFoundRule.csx +32 -0
  103. package/morph-idm/Workflows/device/src/DeviceNotFoundRule.csx +28 -0
  104. package/morph-idm/Workflows/device/src/DeviceUpdatedRule.csx +26 -0
  105. package/morph-idm/Workflows/device/src/NoUpdateRule.csx +19 -0
  106. package/morph-idm/Workflows/device/src/ReInstallRule.csx +19 -0
  107. package/morph-idm/Workflows/document-validation/_FF_document-validation.json +423 -0
  108. package/morph-idm/Workflows/document-validation/src/ApproveRule.csx +16 -0
  109. package/morph-idm/Workflows/document-validation/src/ClassifyRule.csx +16 -0
  110. package/morph-idm/Workflows/document-validation/src/ExtractRule.csx +16 -0
  111. package/morph-idm/Workflows/document-validation/src/HitlRule.csx +16 -0
  112. package/morph-idm/Workflows/document-validation/src/RejectRule.csx +16 -0
  113. package/morph-idm/Workflows/document-validation/src/RunOcrRule.csx +16 -0
  114. package/morph-idm/Workflows/document-validation/src/StartRule.csx +16 -0
  115. package/morph-idm/Workflows/document-validation/src/ToAggregateRule.csx +16 -0
  116. package/morph-idm/Workflows/document-validation/src/ToFraudRule.csx +16 -0
  117. package/morph-idm/Workflows/document-validation/src/ToReferentialRule.csx +16 -0
  118. package/morph-idm/Workflows/document-validation/src/ToSemanticRule.csx +16 -0
  119. package/morph-idm/Workflows/document-validation/src/ToStructuralRule.csx +16 -0
  120. package/morph-idm/Workflows/organization/execute/create-organization.http +280 -0
  121. package/morph-idm/Workflows/organization/organization-1.0.0-documentation.md +616 -0
  122. package/morph-idm/Workflows/organization/organization-1.0.0.json +181 -0
  123. package/morph-idm/Workflows/privilege/privilege-1.0.0.json +185 -0
  124. package/morph-idm/Workflows/scope/execute/scope-24-7-access.http +131 -0
  125. package/morph-idm/Workflows/scope/execute/scope-business-hours.http +138 -0
  126. package/morph-idm/Workflows/scope/execute/scope-corporate.http +165 -0
  127. package/morph-idm/Workflows/scope/execute/scope-individual.http +133 -0
  128. package/morph-idm/Workflows/scope/execute/scope-lifecycle-test.http +133 -0
  129. package/morph-idm/Workflows/scope/execute/scope-multi-systems.http +159 -0
  130. package/morph-idm/Workflows/scope/execute/scope-restricted.http +143 -0
  131. package/morph-idm/Workflows/scope/scope-1.0.0.json +142 -0
  132. package/morph-idm/Workflows/scope/scope-group-1.0.0.json +144 -0
  133. package/morph-idm/Workflows/scope-group/execute/create-scope-group.http +222 -0
  134. package/morph-idm/Workflows/token/execute/README.md +450 -0
  135. package/morph-idm/Workflows/token/execute/token.http +236 -0
  136. package/morph-idm/Workflows/token/oauth-authentication-workflow.json +406 -0
  137. package/morph-idm/Workflows/token/password-subflow.json +173 -0
  138. package/morph-idm/Workflows/token/scope-cdc-worker.1.0.0.json +46 -0
  139. package/morph-idm/Workflows/token/src/CreateRsaJwtMapping.csx +208 -0
  140. package/morph-idm/Workflows/token/src/ExpireTokenTimer.csx +14 -0
  141. package/morph-idm/Workflows/token/src/PrepareAuthorizationCodeRule.csx +16 -0
  142. package/morph-idm/Workflows/token/src/RequestInappropriateRule.csx +16 -0
  143. package/morph-idm/Workflows/token/src/SendJwtToMainMapping.csx +167 -0
  144. package/morph-idm/Workflows/token/token-1.0.0.json +356 -0
  145. package/morph-idm/Workflows/token/token-1.0.0.openapi.json.md +707 -0
  146. package/morph-idm/Workflows/token/token-exchange.1.0.0.json +45 -0
  147. package/morph-idm/Workflows/transaction-limit/transaction-limit-1.0.0.json +244 -0
  148. package/morph-idm/Workflows/transaction-limit/transaction-limit-authorization.json +502 -0
  149. package/morph-idm/Workflows/transaction-limit/transaction-limit-capture.json +142 -0
  150. package/morph-idm/Workflows/user/execute/README-LOGIN.md +535 -0
  151. package/morph-idm/Workflows/user/execute/create-user-1234567890.http +116 -0
  152. package/morph-idm/Workflows/user/execute/create-user-minimal.http +22 -0
  153. package/morph-idm/Workflows/user/execute/create-user-person-password.http +130 -0
  154. package/morph-idm/Workflows/user/execute/create-user-person.http +249 -0
  155. package/morph-idm/Workflows/user/execute/create-user-system.http +16 -0
  156. package/morph-idm/Workflows/user/execute/user-login.http +583 -0
  157. package/morph-idm/Workflows/user/execute/user-requests.http +51 -0
  158. package/morph-idm/Workflows/user/person-1.0.0.json +140 -0
  159. package/morph-idm/Workflows/user/person-cdc-worker.1.0.0.json +46 -0
  160. package/morph-idm/Workflows/user/person-upsert-1.0.0.json +129 -0
  161. package/morph-idm/Workflows/user/src/ApproveRule.csx +16 -0
  162. package/morph-idm/Workflows/user/src/AutoConsentCreatedRule.csx +20 -0
  163. package/morph-idm/Workflows/user/src/AutoConsentRequiredRule.csx +77 -0
  164. package/morph-idm/Workflows/user/src/CheckDeviceByUserReferenceMapping.csx +66 -0
  165. package/morph-idm/Workflows/user/src/ClientValidationFailRule.csx +28 -0
  166. package/morph-idm/Workflows/user/src/ClientValidationRule.csx +25 -0
  167. package/morph-idm/Workflows/user/src/ConsentSelectedRule.csx +24 -0
  168. package/morph-idm/Workflows/user/src/ConsentValidationRule.csx +36 -0
  169. package/morph-idm/Workflows/user/src/CreateAutoConsentMapping.csx +171 -0
  170. package/morph-idm/Workflows/user/src/DeviceFoundForLoginRule.csx +32 -0
  171. package/morph-idm/Workflows/user/src/DeviceNotFoundForLoginRule.csx +31 -0
  172. package/morph-idm/Workflows/user/src/GetClientMapping.csx +45 -0
  173. package/morph-idm/Workflows/user/src/GetConsentMapping.csx +27 -0
  174. package/morph-idm/Workflows/user/src/GetDeviceMapping.csx +52 -0
  175. package/morph-idm/Workflows/user/src/GetScopeMapping.csx +139 -0
  176. package/morph-idm/Workflows/user/src/GetScopesByUserMapping.csx +137 -0
  177. package/morph-idm/Workflows/user/src/GetUserMapping.csx +39 -0
  178. package/morph-idm/Workflows/user/src/GrantValidationFailRule.csx +48 -0
  179. package/morph-idm/Workflows/user/src/GrantValidationRule.csx +45 -0
  180. package/morph-idm/Workflows/user/src/IsIbWebClientWithDeviceRule.csx +42 -0
  181. package/morph-idm/Workflows/user/src/NonIbWebClientWithDeviceRule.csx +42 -0
  182. package/morph-idm/Workflows/user/src/OtpSentRule.csx +31 -0
  183. package/morph-idm/Workflows/user/src/OtpVerifiedRule.csx +31 -0
  184. package/morph-idm/Workflows/user/src/PushSentRule.csx +31 -0
  185. package/morph-idm/Workflows/user/src/PushVerifiedRule.csx +31 -0
  186. package/morph-idm/Workflows/user/src/RejectRule.csx +16 -0
  187. package/morph-idm/Workflows/user/src/ScopeFetchedRule.csx +35 -0
  188. package/morph-idm/Workflows/user/src/ScopeValidationFailRule.csx +67 -0
  189. package/morph-idm/Workflows/user/src/ScopeValidationRule.csx +67 -0
  190. package/morph-idm/Workflows/user/src/SendOtpMapping.csx +94 -0
  191. package/morph-idm/Workflows/user/src/SendPushMapping.csx +90 -0
  192. package/morph-idm/Workflows/user/src/TokenGenerationSuccessRule.csx +28 -0
  193. package/morph-idm/Workflows/user/src/TriggerConsentSelectionAsSubFlowMapping.csx +63 -0
  194. package/morph-idm/Workflows/user/src/TriggerTokenWorkflowAsSubFlowMapping.csx +42 -0
  195. package/morph-idm/Workflows/user/src/UserPasswordGeneratorMapping.csx +190 -0
  196. package/morph-idm/Workflows/user/src/UserValidationFailRule.csx +36 -0
  197. package/morph-idm/Workflows/user/src/UserValidationRule.csx +38 -0
  198. package/morph-idm/Workflows/user/src/VerifyOtpMapping.csx +65 -0
  199. package/morph-idm/Workflows/user/src/VerifyPushMapping.csx +65 -0
  200. package/morph-idm/Workflows/user/user-1.0.0.json +400 -0
  201. package/morph-idm/Workflows/user/user-force-update.1.0.0.json +46 -0
  202. package/morph-idm/Workflows/user/user-login-certificate.1.0.0.json +46 -0
  203. package/morph-idm/Workflows/user/user-login.1.0.0.json +1144 -0
  204. package/morph-idm/Workflows/user/user-password-reset.1.0.0.json +45 -0
  205. package/package.json +21 -0
  206. package/vnext.config.json +58 -0
@@ -0,0 +1,616 @@
1
+ # Organization Workflow Dokümantasyonu
2
+
3
+ ## 📋 Genel Bakış
4
+
5
+ Organization workflow, müşteri (scope) bazlı organizasyon yapılarını yönetir. Her scope (müşteri) kendi organizasyon ağacına sahiptir. Bu ağaç **Location** (lokasyon), **Division** (bölüm) ve **Position** (pozisyon) olmak üzere üç tip node'dan oluşan **recursive tree composition** yapısındadır.
6
+
7
+ ### Temel Özellikler
8
+
9
+ - **Recursive Tree**: Her node kendi `children[]` array'i ile alt düğümlerini içerir
10
+ - **Üç Node Tipi**: Location, Division, Position serbestçe karıştırılabilir
11
+ - **Dual Inheritance (Çift Kalıtım)**:
12
+ - **Dikey (Vertical)**: Parent → Child otomatik yetki kalıtımı
13
+ - **Yatay (Horizontal)**: ScopeGroup → Scope key matching ile birleşim
14
+ - **DENY Her Zaman Kazanır**: Herhangi bir seviyede deny varsa, diğer allow'lar geçersiz
15
+
16
+ ---
17
+
18
+ ## 🔄 Workflow Durumları (States)
19
+
20
+ ```
21
+ start ──────► draft ──publish──► active ◄──reactivate── passive
22
+ │ ▲
23
+ │ ┌─restructure─┐ │
24
+ └─────┴─────────────┴────┘
25
+ │
26
+ └──deactivate──► passive
27
+ ```
28
+
29
+ | State | Açıklama | Yapılabilecek İşlemler |
30
+ |-------|----------|------------------------|
31
+ | **draft** | Taslak durumu. Organizasyon yapısı tanımlanıyor, henüz aktif değil. | `publish` → active |
32
+ | **active** | Aktif durumu. Organizasyon yapısı kullanımda. Consent'ler bu yapıdaki pozisyonlara referans verir. | `restructure` → active, `deactivate` → passive |
33
+ | **passive** | Pasif durumu. Arşivlenmiş, tarihsel referans için tutulur. | `reactivate` → active |
34
+
35
+ ### Transition'lar
36
+
37
+ | Transition | Kaynak | Hedef | Açıklama |
38
+ |------------|--------|-------|----------|
39
+ | `start` | - | draft | Yeni organizasyon oluşturma |
40
+ | `publish` | draft | active | Organizasyonu yayınla/aktifleştir |
41
+ | `restructure` | active | active | Yapıyı güncelle (departman ekle/çıkar, hiyerarşi değiştir) |
42
+ | `deactivate` | active | passive | Pasife al (scope kapandığında veya tamamen yeniden yapılandırmada) |
43
+ | `reactivate` | passive | active | Tekrar aktifleştir |
44
+
45
+ ---
46
+
47
+ ## 📊 Şema Yapısı (Organization Master)
48
+
49
+ ### Root Alanları
50
+
51
+ | Alan | Tip | Zorunlu | Açıklama |
52
+ |------|-----|---------|----------|
53
+ | `reference` | Reference | ✅ Evet | Bu organizasyonun ait olduğu Scope veya ScopeGroup referansı |
54
+ | `positionLevels` | string[] | ❌ Hayır | Kullanılabilir pozisyon seviyeleri (örn: `["clerk", "officer", "manager", "director", "executive"]`) |
55
+ | `children` | OrganizationNode[] | ✅ Evet | Root seviyedeki düğümler (Location, Division veya Position olabilir) |
56
+ | `metadata` | object | ❌ Hayır | Ek meta bilgiler |
57
+
58
+ #### reference Alanı
59
+
60
+ Organizasyonun hangi Scope veya ScopeGroup'a ait olduğunu belirtir.
61
+
62
+ ```json
63
+ {
64
+ "reference": {
65
+ "domain": "morph-idm",
66
+ "workflow": "scope",
67
+ "key": "burganbank"
68
+ }
69
+ }
70
+ ```
71
+
72
+ **İki Kullanım Senaryosu:**
73
+ 1. **Scope Instance**: Müşteriye özel organizasyon yapısı
74
+ 2. **ScopeGroup Instance**: Birden fazla scope için paylaşılan şablon
75
+
76
+ #### positionLevels Alanı
77
+
78
+ ApprovalMatrix ve TransactionLimits'te kullanılan pozisyon seviyeleri.
79
+
80
+ ```json
81
+ {
82
+ "positionLevels": ["clerk", "officer", "manager", "director", "executive"]
83
+ }
84
+ ```
85
+
86
+ **Önemli:**
87
+ - Runtime'da ScopeGroup ve Scope positionLevels birleşim kümesi (union) alınır
88
+ - Position node'larının `positionLevel` değeri bu listeden seçilmelidir
89
+ - Şema seviyesinde validation yoktur, runtime'da kontrol edilir
90
+
91
+ #### metadata Alanı
92
+
93
+ | Alt Alan | Tip | Açıklama |
94
+ |----------|-----|----------|
95
+ | `createdAt` | datetime | Oluşturulma zamanı |
96
+ | `lastRestructured` | datetime | Son yeniden yapılandırma zamanı |
97
+ | `version` | string | Versiyon numarası |
98
+
99
+ ---
100
+
101
+ ## 🏢 Node Tipleri
102
+
103
+ ### 1. Location (Lokasyon)
104
+
105
+ Fiziksel veya mantıksal konum bilgilerini temsil eder.
106
+
107
+ #### Alanlar
108
+
109
+ | Alan | Tip | Zorunlu | Açıklama |
110
+ |------|-----|---------|----------|
111
+ | `nodeType` | string | ✅ Evet | **Sabit değer: `"location"`** - Node tipi ayırıcısı |
112
+ | `key` | string | ✅ Evet | Benzersiz tanımlayıcı (örn: `"istanbul-hq"`, `"ankara-branch"`) |
113
+ | `name` | string | ✅ Evet | Görünen isim (örn: `"İstanbul Genel Merkez"`) |
114
+ | `description` | string | ❌ Hayır | Lokasyon açıklaması |
115
+ | `locationType` | enum | ❌ Hayır | Lokasyon tipi |
116
+ | `address` | string | ❌ Hayır | Fiziksel adres |
117
+ | `coordinates` | object | ❌ Hayır | GPS koordinatları |
118
+ | `timezone` | string | ❌ Hayır | IANA zaman dilimi (örn: `"Europe/Istanbul"`) |
119
+ | `workingHours` | object | ❌ Hayır | Çalışma saatleri |
120
+ | `contactPersons` | Reference[] | ❌ Hayır | İletişim sorumluları (Person referansları) |
121
+ | `roles` | Role[] | ❌ Hayır | Bu lokasyona atanan roller |
122
+ | `privileges` | Reference[] | ❌ Hayır | Privilege referansları |
123
+ | `children` | OrganizationNode[] | ❌ Hayır | Alt düğümler |
124
+
125
+ #### locationType Enum Değerleri
126
+
127
+ | Değer | Açıklama |
128
+ |-------|----------|
129
+ | `headquarters` | Genel merkez |
130
+ | `branch` | Şube |
131
+ | `regional-office` | Bölge müdürlüğü |
132
+ | `virtual` | Sanal (fiziksel varlığı yok) |
133
+
134
+ #### workingHours Yapısı
135
+
136
+ ```json
137
+ {
138
+ "workingHours": {
139
+ "monday": "09:00-17:00",
140
+ "tuesday": "09:00-17:00",
141
+ "wednesday": "09:00-17:00",
142
+ "thursday": "09:00-17:00",
143
+ "friday": "09:00-17:00",
144
+ "saturday": "closed",
145
+ "sunday": "closed"
146
+ }
147
+ }
148
+ ```
149
+
150
+ #### coordinates Yapısı
151
+
152
+ ```json
153
+ {
154
+ "coordinates": {
155
+ "latitude": 41.0082,
156
+ "longitude": 28.9784
157
+ }
158
+ }
159
+ ```
160
+
161
+ #### Örnek Location Node
162
+
163
+ ```json
164
+ {
165
+ "nodeType": "location",
166
+ "key": "istanbul-hq",
167
+ "name": "İstanbul Genel Merkez",
168
+ "description": "Şirket genel merkezi",
169
+ "locationType": "headquarters",
170
+ "address": "Levent, İstanbul",
171
+ "timezone": "Europe/Istanbul",
172
+ "coordinates": {
173
+ "latitude": 41.0822,
174
+ "longitude": 29.0108
175
+ },
176
+ "workingHours": {
177
+ "monday": "09:00-18:00",
178
+ "tuesday": "09:00-18:00",
179
+ "wednesday": "09:00-18:00",
180
+ "thursday": "09:00-18:00",
181
+ "friday": "09:00-18:00",
182
+ "saturday": "closed",
183
+ "sunday": "closed"
184
+ },
185
+ "roles": [
186
+ { "role": "idm.account-viewer", "allowance": "allow" }
187
+ ],
188
+ "children": [
189
+ { /* Division veya Position */ }
190
+ ]
191
+ }
192
+ ```
193
+
194
+ ---
195
+
196
+ ### 2. Division (Bölüm)
197
+
198
+ İş birimi veya departman bilgilerini temsil eder.
199
+
200
+ #### Alanlar
201
+
202
+ | Alan | Tip | Zorunlu | Açıklama |
203
+ |------|-----|---------|----------|
204
+ | `nodeType` | string | ✅ Evet | **Sabit değer: `"division"`** - Node tipi ayırıcısı |
205
+ | `key` | string | ✅ Evet | Benzersiz tanımlayıcı (örn: `"it-dept"`, `"finance"`) |
206
+ | `name` | string | ✅ Evet | Görünen isim (örn: `"Bilgi Teknolojileri"`) |
207
+ | `description` | string | ❌ Hayır | Bölümün sorumluluk alanları açıklaması |
208
+ | `divisionType` | enum | ❌ Hayır | Bölüm tipi |
209
+ | `roles` | Role[] | ❌ Hayır | Bu bölüme atanan roller |
210
+ | `privileges` | Reference[] | ❌ Hayır | Privilege referansları |
211
+ | `children` | OrganizationNode[] | ❌ Hayır | Alt düğümler |
212
+
213
+ #### divisionType Enum Değerleri
214
+
215
+ | Değer | Açıklama |
216
+ |-------|----------|
217
+ | `operational` | Operasyonel (ana iş kolu) |
218
+ | `support` | Destek (IT, İK, vb.) |
219
+ | `management` | Yönetim (üst düzey yönetim) |
220
+ | `compliance` | Uyum (hukuk, denetim) |
221
+ | `technical` | Teknik (mühendislik, Ar-Ge) |
222
+
223
+ #### Örnek Division Node
224
+
225
+ ```json
226
+ {
227
+ "nodeType": "division",
228
+ "key": "finance-dept",
229
+ "name": "Mali İşler",
230
+ "description": "Finansal operasyonlar ve raporlama",
231
+ "divisionType": "operational",
232
+ "roles": [
233
+ { "role": "idm.account-viewer", "allowance": "allow" },
234
+ { "role": "idm.payment-viewer", "allowance": "allow" }
235
+ ],
236
+ "privileges": [
237
+ {
238
+ "domain": "morph-idm",
239
+ "workflow": "privilege",
240
+ "key": "finance-restrictions"
241
+ }
242
+ ],
243
+ "children": [
244
+ { /* Position veya başka Division */ }
245
+ ]
246
+ }
247
+ ```
248
+
249
+ ---
250
+
251
+ ### 3. Position (Pozisyon)
252
+
253
+ İş pozisyonu veya görev bilgilerini temsil eder.
254
+
255
+ #### Alanlar
256
+
257
+ | Alan | Tip | Zorunlu | Açıklama |
258
+ |------|-----|---------|----------|
259
+ | `nodeType` | string | ✅ Evet | **Sabit değer: `"position"`** - Node tipi ayırıcısı |
260
+ | `key` | string | ✅ Evet | Benzersiz tanımlayıcı (örn: `"branch-manager"`, `"teller"`) |
261
+ | `title` | string | ✅ Evet | Pozisyon başlığı (örn: `"Şube Müdürü"`) |
262
+ | `positionLevel` | string | ✅ Evet | Pozisyon seviyesi (`organization.positionLevels`'dan) |
263
+ | `description` | string | ❌ Hayır | Pozisyonun sorumluluk alanları açıklaması |
264
+ | `maxAssignments` | integer | ❌ Hayır | Bu pozisyona atanabilecek maksimum kullanıcı sayısı |
265
+ | `roles` | Role[] | ❌ Hayır | Bu pozisyona atanan roller |
266
+ | `privileges` | Reference[] | ❌ Hayır | Privilege referansları |
267
+ | `children` | OrganizationNode[] | ❌ Hayır | Alt pozisyonlar (raporlama hiyerarşisi) |
268
+
269
+ #### positionLevel Hakkında
270
+
271
+ **⚠️ KRİTİK:** `positionLevel` değeri aşağıdaki yerlerde kullanılır:
272
+ - **ApprovalMatrix**: Onay kurallarında (hangi seviye kaç onay verir)
273
+ - **TransactionLimits**: Limit tanımlarında (seviyeye göre limit)
274
+ - **Business Rules**: İş akışı kurallarında
275
+
276
+ **Örnek Seviyeler:**
277
+ ```
278
+ executive → C-Level yöneticiler (CEO, CFO, CTO)
279
+ general-manager → Genel müdürler
280
+ director → Direktörler
281
+ manager → Müdürler
282
+ specialist → Uzmanlar
283
+ officer → Yetkililer
284
+ clerk → Memurlar
285
+ ```
286
+
287
+ #### Örnek Position Node
288
+
289
+ ```json
290
+ {
291
+ "nodeType": "position",
292
+ "key": "branch-manager",
293
+ "title": "Şube Müdürü",
294
+ "positionLevel": "manager",
295
+ "description": "Şube operasyonlarının yönetimi ve koordinasyonu",
296
+ "maxAssignments": 1,
297
+ "roles": [
298
+ { "role": "idm.manager", "allowance": "allow" },
299
+ { "role": "idm.approver", "allowance": "allow" },
300
+ { "role": "idm.maker", "allowance": "deny" }
301
+ ],
302
+ "privileges": [
303
+ {
304
+ "domain": "morph-idm",
305
+ "workflow": "privilege",
306
+ "key": "manager-level-access"
307
+ }
308
+ ],
309
+ "children": [
310
+ {
311
+ "nodeType": "position",
312
+ "key": "teller",
313
+ "title": "Gişe Yetkilisi",
314
+ "positionLevel": "clerk",
315
+ "roles": [
316
+ { "role": "idm.teller", "allowance": "allow" }
317
+ ]
318
+ }
319
+ ]
320
+ }
321
+ ```
322
+
323
+ ---
324
+
325
+ ## 🔐 Rol Yapısı (roles[])
326
+
327
+ Her node tipi (Location, Division, Position) `roles[]` array'ine sahiptir.
328
+
329
+ ### Role Tanımı
330
+
331
+ | Alan | Tip | Zorunlu | Açıklama |
332
+ |------|-----|---------|----------|
333
+ | `role` | string | ✅ Evet | Domain-qualified rol adı (format: `domain.rolename`) |
334
+ | `allowance` | enum | ✅ Evet | `"allow"` veya `"deny"` |
335
+
336
+ ### Role Naming Convention
337
+
338
+ Roller **domain-qualified** formatında tanımlanır:
339
+ ```
340
+ idm.maker
341
+ idm.approver
342
+ idm.viewer
343
+ idm.manager
344
+ idm.admin
345
+ ```
346
+
347
+ ### Allow vs Deny
348
+
349
+ | Allowance | Anlam |
350
+ |-----------|-------|
351
+ | `allow` | Rol izni verildi |
352
+ | `deny` | Rol açıkça reddedildi |
353
+
354
+ **⚠️ KRİTİK KURAL:** **DENY her zaman ALLOW'u ezer!**
355
+
356
+ Herhangi bir seviyede (parent veya child) bir rol için `deny` verilmişse, diğer seviyelerde `allow` verilmiş olsa bile yetki **kısıtlanır**.
357
+
358
+ ### Örnek
359
+
360
+ ```json
361
+ {
362
+ "roles": [
363
+ { "role": "idm.account-viewer", "allowance": "allow" },
364
+ { "role": "idm.account-editor", "allowance": "allow" },
365
+ { "role": "idm.payment-maker", "allowance": "deny" }
366
+ ]
367
+ }
368
+ ```
369
+
370
+ ---
371
+
372
+ ## 🎁 Privilege Yapısı (privileges[])
373
+
374
+ Her node tipi `privileges[]` array'ine sahiptir. Privilege'lar ince-taneli kaynak kısıtlamaları için kullanılır.
375
+
376
+ ### Privilege Referansı
377
+
378
+ ```json
379
+ {
380
+ "privileges": [
381
+ {
382
+ "domain": "morph-idm",
383
+ "workflow": "privilege",
384
+ "key": "branch-teller-restrictions"
385
+ }
386
+ ]
387
+ }
388
+ ```
389
+
390
+ Privilege instance'ları `privilege` workflow'unda yönetilir ve buradan referans edilir.
391
+
392
+ ---
393
+
394
+ ## 🔄 Kalıtım (Inheritance)
395
+
396
+ ### Dikey Kalıtım (Vertical Inheritance)
397
+
398
+ Roller ve privilege'lar parent'tan child'a otomatik olarak kalıtılır.
399
+
400
+ ```
401
+ 📍 Genel Merkez (Location)
402
+ └── roles: [idm.viewer: allow]
403
+ │
404
+ 📂 Mali İşler (Division)
405
+ └── roles: [idm.finance: allow]
406
+ │
407
+ 💼 Muhasebeci (Position)
408
+ └── roles: [idm.accountant: allow]
409
+ ```
410
+
411
+ **Muhasebeci'nin nihai rolleri:**
412
+ - `idm.viewer` (Genel Merkez'den kalıtım)
413
+ - `idm.finance` (Mali İşler'den kalıtım)
414
+ - `idm.accountant` (kendi rolü)
415
+
416
+ ### Yatay Kalıtım (Horizontal Inheritance)
417
+
418
+ ScopeGroup şablonundan Scope instance'ına key matching ile birleşim.
419
+
420
+ **Senaryo:**
421
+ 1. ScopeGroup'ta `CFO` pozisyonu tanımlı (şablon)
422
+ 2. Scope'ta aynı key'de `CFO` pozisyonu tanımlı (müşteriye özel)
423
+ 3. Runtime'da her ikisinin rolleri union ile birleştirilir
424
+
425
+ ```
426
+ ScopeGroup CFO rolleri: [maker: allow, viewer: allow]
427
+ Scope CFO rolleri: [maker: deny, approver: allow]
428
+
429
+ Sonuç: [maker: DENY, viewer: allow, approver: allow]
430
+ ```
431
+
432
+ > **Not:** DENY her zaman kazanır!
433
+
434
+ ---
435
+
436
+ ## 📝 Tam Örnek: Organizasyon Instance
437
+
438
+ ```json
439
+ {
440
+ "key": "burganbank-organization",
441
+ "workflowKey": "organization",
442
+ "domain": "morph-idm",
443
+ "state": "active",
444
+ "data": {
445
+ "reference": {
446
+ "domain": "morph-idm",
447
+ "workflow": "scope",
448
+ "key": "burganbank"
449
+ },
450
+ "positionLevels": ["clerk", "officer", "manager", "director", "executive"],
451
+ "children": [
452
+ {
453
+ "nodeType": "location",
454
+ "key": "istanbul-hq",
455
+ "name": "İstanbul Genel Merkez",
456
+ "locationType": "headquarters",
457
+ "timezone": "Europe/Istanbul",
458
+ "roles": [
459
+ { "role": "idm.account-viewer", "allowance": "allow" }
460
+ ],
461
+ "children": [
462
+ {
463
+ "nodeType": "division",
464
+ "key": "retail-banking",
465
+ "name": "Bireysel Bankacılık",
466
+ "divisionType": "operational",
467
+ "roles": [
468
+ { "role": "idm.retail-operations", "allowance": "allow" }
469
+ ],
470
+ "children": [
471
+ {
472
+ "nodeType": "position",
473
+ "key": "retail-director",
474
+ "title": "Bireysel Bankacılık Direktörü",
475
+ "positionLevel": "director",
476
+ "maxAssignments": 1,
477
+ "roles": [
478
+ { "role": "idm.director", "allowance": "allow" },
479
+ { "role": "idm.approver", "allowance": "allow" }
480
+ ],
481
+ "children": [
482
+ {
483
+ "nodeType": "position",
484
+ "key": "branch-manager",
485
+ "title": "Şube Müdürü",
486
+ "positionLevel": "manager",
487
+ "maxAssignments": 50,
488
+ "roles": [
489
+ { "role": "idm.manager", "allowance": "allow" },
490
+ { "role": "idm.approver", "allowance": "allow" }
491
+ ],
492
+ "children": [
493
+ {
494
+ "nodeType": "position",
495
+ "key": "teller",
496
+ "title": "Gişe Yetkilisi",
497
+ "positionLevel": "clerk",
498
+ "roles": [
499
+ { "role": "idm.teller", "allowance": "allow" },
500
+ { "role": "idm.maker", "allowance": "allow" }
501
+ ]
502
+ }
503
+ ]
504
+ }
505
+ ]
506
+ }
507
+ ]
508
+ },
509
+ {
510
+ "nodeType": "division",
511
+ "key": "it-dept",
512
+ "name": "Bilgi Teknolojileri",
513
+ "divisionType": "technical",
514
+ "roles": [
515
+ { "role": "idm.system-admin", "allowance": "allow" }
516
+ ],
517
+ "children": [
518
+ {
519
+ "nodeType": "position",
520
+ "key": "cto",
521
+ "title": "Teknoloji Direktörü",
522
+ "positionLevel": "executive",
523
+ "maxAssignments": 1,
524
+ "roles": [
525
+ { "role": "idm.executive", "allowance": "allow" }
526
+ ]
527
+ }
528
+ ]
529
+ }
530
+ ]
531
+ },
532
+ {
533
+ "nodeType": "location",
534
+ "key": "ankara-branch",
535
+ "name": "Ankara Şubesi",
536
+ "locationType": "branch",
537
+ "timezone": "Europe/Istanbul",
538
+ "address": "Kızılay, Ankara",
539
+ "workingHours": {
540
+ "monday": "09:00-17:00",
541
+ "tuesday": "09:00-17:00",
542
+ "wednesday": "09:00-17:00",
543
+ "thursday": "09:00-17:00",
544
+ "friday": "09:00-17:00",
545
+ "saturday": "closed",
546
+ "sunday": "closed"
547
+ },
548
+ "children": [
549
+ {
550
+ "nodeType": "position",
551
+ "key": "ankara-branch-manager",
552
+ "title": "Ankara Şube Müdürü",
553
+ "positionLevel": "manager",
554
+ "maxAssignments": 1,
555
+ "roles": [
556
+ { "role": "idm.manager", "allowance": "allow" }
557
+ ]
558
+ }
559
+ ]
560
+ }
561
+ ],
562
+ "metadata": {
563
+ "createdAt": "2024-01-01T00:00:00Z",
564
+ "lastRestructured": "2024-12-01T00:00:00Z",
565
+ "version": "2.0.0"
566
+ }
567
+ }
568
+ }
569
+ ```
570
+
571
+ ---
572
+
573
+ ## 🎯 Kullanım Senaryoları
574
+
575
+ ### 1. Yeni Müşteri Onboarding
576
+
577
+ 1. ScopeGroup şablonundan organizasyon yapısı kopyalanır
578
+ 2. `draft` state'te müşteriye özel düzenlemeler yapılır
579
+ 3. `publish` ile aktifleştirilir
580
+
581
+ ### 2. Organizasyon Yeniden Yapılandırma
582
+
583
+ 1. `restructure` transition'ı çağrılır
584
+ 2. Departman ekleme/çıkarma, hiyerarşi değişikliği yapılır
585
+ 3. Yeni versiyon otomatik oluşturulur
586
+
587
+ ### 3. Kullanıcı Yetkilendirme
588
+
589
+ 1. Consent oluşturulurken pozisyon atanır
590
+ 2. Pozisyondan parent'lara doğru traverse edilir
591
+ 3. Tüm seviyelerdeki roller ve privilege'lar birleştirilir
592
+ 4. DENY her zaman kazanır
593
+
594
+ ---
595
+
596
+ ## 📎 İlişkili Kaynaklar
597
+
598
+ | Kaynak | Açıklama |
599
+ |--------|----------|
600
+ | `Schemas/organization/organization-master-1.0.0.json` | Ana şema |
601
+ | `Schemas/organization/organization-update-1.0.0.json` | Update şeması |
602
+ | `Authorization.md` | Yetkilendirme sistemi dokümantasyonu |
603
+ | `Schemas/privilege/privilege-master-1.0.0.json` | Privilege şeması |
604
+ | `Schemas/approval-matrix/approval-matrix-master-1.0.0.json` | ApprovalMatrix şeması |
605
+
606
+ ---
607
+
608
+ **Versiyon:** 1.0.0
609
+ **Son Güncelleme:** 2024-12-04
610
+ **Yazar:** Morph.IDM Team
611
+
612
+
613
+
614
+
615
+
616
+