@k2works/claude-code-booster 3.2.1 → 3.3.1

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 (70) hide show
  1. package/lib/assets/.claude/skills/analyzing-business/SKILL.md +2 -2
  2. package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +5 -5
  3. package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +2 -2
  4. package/lib/assets/.claude/skills/generating-slides/SKILL.md +7 -7
  5. package/lib/assets/docs/article/index.md +4 -1
  6. package/lib/assets/docs/article/practical-database-design/index.md +121 -0
  7. package/lib/assets/docs/article/practical-database-design/part1/chapter01.md +288 -0
  8. package/lib/assets/docs/article/practical-database-design/part1/chapter02.md +518 -0
  9. package/lib/assets/docs/article/practical-database-design/part1/chapter03.md +557 -0
  10. package/lib/assets/docs/article/practical-database-design/part2/chapter04.md +924 -0
  11. package/lib/assets/docs/article/practical-database-design/part2/chapter05.md +1627 -0
  12. package/lib/assets/docs/article/practical-database-design/part2/chapter06.md +2716 -0
  13. package/lib/assets/docs/article/practical-database-design/part2/chapter07.md +2082 -0
  14. package/lib/assets/docs/article/practical-database-design/part2/chapter08.md +2105 -0
  15. package/lib/assets/docs/article/practical-database-design/part2/chapter09.md +2031 -0
  16. package/lib/assets/docs/article/practical-database-design/part2/chapter10.md +1387 -0
  17. package/lib/assets/docs/article/practical-database-design/part2/chapter11.md +1677 -0
  18. package/lib/assets/docs/article/practical-database-design/part2/chapter12.md +1417 -0
  19. package/lib/assets/docs/article/practical-database-design/part2/chapter13.md +1434 -0
  20. package/lib/assets/docs/article/practical-database-design/part3/chapter14.md +667 -0
  21. package/lib/assets/docs/article/practical-database-design/part3/chapter15.md +1625 -0
  22. package/lib/assets/docs/article/practical-database-design/part3/chapter16.md +1915 -0
  23. package/lib/assets/docs/article/practical-database-design/part3/chapter17.md +1708 -0
  24. package/lib/assets/docs/article/practical-database-design/part3/chapter18.md +2095 -0
  25. package/lib/assets/docs/article/practical-database-design/part3/chapter19.md +1123 -0
  26. package/lib/assets/docs/article/practical-database-design/part3/chapter20.md +1031 -0
  27. package/lib/assets/docs/article/practical-database-design/part3/chapter21.md +1382 -0
  28. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter14-orm.md +991 -0
  29. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter15-orm.md +1300 -0
  30. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter16-orm.md +1166 -0
  31. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter17-orm.md +1584 -0
  32. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter18-orm.md +1183 -0
  33. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter19-orm.md +1016 -0
  34. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter20-orm.md +1753 -0
  35. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter21-orm.md +1447 -0
  36. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter22-orm.md +1878 -0
  37. package/lib/assets/docs/article/practical-database-design/part4/chapter22.md +965 -0
  38. package/lib/assets/docs/article/practical-database-design/part4/chapter23.md +2069 -0
  39. package/lib/assets/docs/article/practical-database-design/part4/chapter24.md +2439 -0
  40. package/lib/assets/docs/article/practical-database-design/part4/chapter25.md +3661 -0
  41. package/lib/assets/docs/article/practical-database-design/part4/chapter26.md +2916 -0
  42. package/lib/assets/docs/article/practical-database-design/part4/chapter27.md +3105 -0
  43. package/lib/assets/docs/article/practical-database-design/part4/chapter28.md +2697 -0
  44. package/lib/assets/docs/article/practical-database-design/part4/chapter29.md +2544 -0
  45. package/lib/assets/docs/article/practical-database-design/part4/chapter30.md +2180 -0
  46. package/lib/assets/docs/article/practical-database-design/part4/chapter31.md +1192 -0
  47. package/lib/assets/docs/article/practical-database-design/part4/chapter32.md +2101 -0
  48. package/lib/assets/docs/article/practical-database-design/part5/chapter33.md +1032 -0
  49. package/lib/assets/docs/article/practical-database-design/part5/chapter34.md +1609 -0
  50. package/lib/assets/docs/article/practical-database-design/part5/chapter35.md +1453 -0
  51. package/lib/assets/docs/article/practical-database-design/part5/chapter36.md +1292 -0
  52. package/lib/assets/docs/article/practical-database-design/part5/chapter37.md +1470 -0
  53. package/lib/assets/docs/article/practical-database-design/part5/chapter38.md +1698 -0
  54. package/lib/assets/docs/article/practical-database-design/part5/chapter39.md +2334 -0
  55. package/lib/assets/docs/article/practical-database-design/study/study2-1.md +1693 -0
  56. package/lib/assets/docs/article/practical-database-design/study/study2-2.md +1347 -0
  57. package/lib/assets/docs/article/practical-database-design/study/study2-3.md +2044 -0
  58. package/lib/assets/docs/article/practical-database-design/study/study2-4.md +2229 -0
  59. package/lib/assets/docs/article/practical-database-design/study/study2-5.md +2418 -0
  60. package/lib/assets/docs/article/practical-database-design/study/study3-1.md +2205 -0
  61. package/lib/assets/docs/article/practical-database-design/study/study3-2.md +2221 -0
  62. package/lib/assets/docs/article/practical-database-design/study/study3-3.md +2253 -0
  63. package/lib/assets/docs/article/practical-database-design/study/study3-4.md +2106 -0
  64. package/lib/assets/docs/article/practical-database-design/study/study3-5.md +2507 -0
  65. package/lib/assets/docs/article/practical-database-design/study/study4-1.md +2587 -0
  66. package/lib/assets/docs/article/practical-database-design/study/study4-2.md +2075 -0
  67. package/lib/assets/docs/article/practical-database-design/study/study4-3.md +1805 -0
  68. package/lib/assets/docs/article/practical-database-design/study/study4-4.md +1895 -0
  69. package/lib/assets/docs/article/practical-database-design/study/study4-5.md +2878 -0
  70. package/package.json +1 -1
@@ -0,0 +1,1292 @@
1
+ # 第36章:マスタデータ管理(MDM)
2
+
3
+ 本章では、複数の基幹業務システム間で共有されるマスタデータの管理方法について解説します。マスタデータ管理(Master Data Management: MDM)は、企業全体でのデータ品質と一貫性を確保するための重要な取り組みです。
4
+
5
+ ---
6
+
7
+ ## 36.1 マスタデータ統合の課題
8
+
9
+ ### 各システムでのマスタ重複
10
+
11
+ 基幹業務システムが個別に構築された場合、同じマスタデータが複数のシステムに存在することがあります。この「マスタ重複」は様々な問題を引き起こします。
12
+
13
+ ```plantuml
14
+ @startuml
15
+ title マスタデータ重複の現状
16
+
17
+ package "販売管理システム" as sales {
18
+ database "顧客マスタ\n----\n顧客コード\n顧客名\n住所\n与信限度額" as sales_customer
19
+ database "商品マスタ\n----\n商品コード\n商品名\n販売単価\n在庫数" as sales_product
20
+ }
21
+
22
+ package "生産管理システム" as production {
23
+ database "取引先マスタ\n----\n取引先コード\n取引先名\n住所\n納入条件" as prod_partner
24
+ database "品目マスタ\n----\n品目コード\n品目名\n製造リードタイム\nBOM情報" as prod_item
25
+ }
26
+
27
+ package "財務会計システム" as accounting {
28
+ database "取引先マスタ\n----\n取引先コード\n取引先名\n債権債務区分\n決済条件" as acc_partner
29
+ }
30
+
31
+ note bottom of sales
32
+ 【問題点】
33
+ ・同一顧客が異なるコードで登録
34
+ ・住所変更が反映されない
35
+ ・データ不整合
36
+ end note
37
+
38
+ note bottom of production
39
+ 【問題点】
40
+ ・商品と品目の紐付けが曖昧
41
+ ・仕入先情報の重複
42
+ ・更新タイミングのずれ
43
+ end note
44
+
45
+ @enduml
46
+ ```
47
+
48
+ #### マスタ重複による具体的な問題
49
+
50
+ | 問題カテゴリ | 具体例 | ビジネスへの影響 |
51
+ |------------|-------|----------------|
52
+ | データ不整合 | 顧客住所が各システムで異なる | 請求書誤送付、配送ミス |
53
+ | 更新漏れ | 取引先の廃業が反映されない | 無効な発注、債権回収不能 |
54
+ | コード重複 | 同一顧客に複数コード付与 | 売上分析の誤り、与信管理不能 |
55
+ | 属性欠落 | 必要な属性が一部システムにのみ存在 | システム間連携の障害 |
56
+
57
+ ### コード体系の不一致
58
+
59
+ 各システムが独自のコード体系を持つことで、データの突合が困難になります。
60
+
61
+ ```plantuml
62
+ @startuml
63
+ title コード体系の不一致
64
+
65
+ rectangle "販売管理" as sales {
66
+ object "顧客コード" as sales_code {
67
+ 形式: "C" + 連番5桁
68
+ 例: C00001, C00002
69
+ }
70
+ }
71
+
72
+ rectangle "生産管理" as production {
73
+ object "取引先コード" as prod_code {
74
+ 形式: 区分2桁 + 連番4桁
75
+ 例: CU0001(顧客)
76
+ 例: SP0001(仕入先)
77
+ }
78
+ }
79
+
80
+ rectangle "財務会計" as accounting {
81
+ object "取引先コード" as acc_code {
82
+ 形式: 連番8桁
83
+ 例: 00000001
84
+ }
85
+ }
86
+
87
+ sales_code -[hidden]-> prod_code
88
+ prod_code -[hidden]-> acc_code
89
+
90
+ note bottom
91
+ 【同一顧客のコード例】
92
+ ・販売管理:C00001
93
+ ・生産管理:CU0001
94
+ ・財務会計:00000001
95
+
96
+ → 突合するためにマッピングテーブルが必要
97
+ → マッピングの維持管理コストが発生
98
+ end note
99
+
100
+ @enduml
101
+ ```
102
+
103
+ ### 更新タイミングの同期
104
+
105
+ マスタデータの更新がシステム間で同期されないと、一時的または恒久的なデータ不整合が発生します。
106
+
107
+ ```plantuml
108
+ @startuml
109
+ title 更新タイミングの不整合
110
+
111
+ concise "販売管理" as sales
112
+ concise "生産管理" as production
113
+ concise "財務会計" as accounting
114
+
115
+ @0
116
+ sales is "住所A"
117
+ production is "住所A"
118
+ accounting is "住所A"
119
+
120
+ @100
121
+ sales is "住所B" : 住所変更
122
+ production is "住所A"
123
+ accounting is "住所A"
124
+
125
+ @200
126
+ sales is "住所B"
127
+ production is "住所B" : バッチ同期
128
+ accounting is "住所A"
129
+
130
+ @300
131
+ sales is "住所B"
132
+ production is "住所B"
133
+ accounting is "住所B" : 手動更新
134
+
135
+ @400
136
+ sales is "住所B"
137
+ production is "住所B"
138
+ accounting is "住所B"
139
+
140
+ @enduml
141
+ ```
142
+
143
+ ```plantuml
144
+ @startuml
145
+ title マスタ更新の同期問題
146
+
147
+ |販売管理|
148
+ start
149
+ :顧客住所変更;
150
+ :販売管理DBを更新;
151
+
152
+ |生産管理|
153
+ :夜間バッチで同期;
154
+ note right
155
+ タイムラグ:最大24時間
156
+ end note
157
+
158
+ |財務会計|
159
+ :月次で手動確認;
160
+ note right
161
+ タイムラグ:最大1ヶ月
162
+ end note
163
+
164
+ |問題|
165
+ :期間中のデータ不整合;
166
+ note right
167
+ ・請求書の住所が古い
168
+ ・配送先と請求先の不一致
169
+ ・顧客からのクレーム
170
+ end note
171
+
172
+ stop
173
+
174
+ @enduml
175
+ ```
176
+
177
+ ---
178
+
179
+ ## 36.2 MDM パターン
180
+
181
+ マスタデータ管理には、組織の状況や要件に応じた複数のアーキテクチャパターンがあります。
182
+
183
+ ### MDM パターンの概要
184
+
185
+ ```plantuml
186
+ @startuml
187
+ title MDM パターンの分類
188
+
189
+ rectangle "Registry Style\n(参照型)" as registry
190
+ note right of registry
191
+ ・既存システムを維持
192
+ ・インデックスのみ集約
193
+ ・低コスト・低リスク
194
+ end note
195
+
196
+ rectangle "Consolidation Style\n(統合型)" as consolidation
197
+ note right of consolidation
198
+ ・マスタを集約
199
+ ・分析・レポート用途
200
+ ・既存システムは変更なし
201
+ end note
202
+
203
+ rectangle "Coexistence Style\n(共存型)" as coexistence
204
+ note right of coexistence
205
+ ・MDMと既存システムが共存
206
+ ・双方向同期
207
+ ・段階的な移行に適する
208
+ end note
209
+
210
+ rectangle "Transaction Hub Style\n(ハブ型)" as hub
211
+ note right of hub
212
+ ・MDMが唯一の正
213
+ ・すべての更新はハブ経由
214
+ ・最高の一貫性
215
+ end note
216
+
217
+ registry -[hidden]down-> consolidation
218
+ consolidation -[hidden]down-> coexistence
219
+ coexistence -[hidden]down-> hub
220
+
221
+ @endumll
222
+ ```
223
+
224
+ ### Registry Style(参照型)
225
+
226
+ 既存システムのマスタデータはそのまま維持し、MDMはマスタデータの「インデックス」として機能します。
227
+
228
+ ```plantuml
229
+ @startuml
230
+ title Registry Style MDM
231
+
232
+ package "MDM(Registry)" as mdm {
233
+ database "マスタインデックス\n----\nグローバルID\nローカルID(販売)\nローカルID(生産)\nローカルID(会計)" as index
234
+ }
235
+
236
+ package "販売管理" as sales {
237
+ database "顧客マスタ" as sales_cust
238
+ }
239
+
240
+ package "生産管理" as production {
241
+ database "取引先マスタ" as prod_partner
242
+ }
243
+
244
+ package "財務会計" as accounting {
245
+ database "取引先マスタ" as acc_partner
246
+ }
247
+
248
+ rectangle "クロスリファレンス\nサービス" as xref
249
+
250
+ index <--> xref
251
+ xref <--> sales_cust : 参照
252
+ xref <--> prod_partner : 参照
253
+ xref <--> acc_partner : 参照
254
+
255
+ note bottom of mdm
256
+ 【特徴】
257
+ ・各システムのマスタは変更なし
258
+ ・グローバルIDによる紐付けのみ
259
+ ・名寄せ・重複検出に活用
260
+
261
+ 【適用場面】
262
+ ・既存システムへの影響を最小化したい
263
+ ・分析・レポートでの統合ビューが欲しい
264
+ end note
265
+
266
+ @enduml
267
+ ```
268
+
269
+ <details>
270
+ <summary>Java 実装例</summary>
271
+
272
+ ```java
273
+ // マスタインデックス
274
+ @Entity
275
+ @Table(name = "master_index")
276
+ public class MasterIndex {
277
+ @Id
278
+ private String globalId;
279
+
280
+ @OneToMany(mappedBy = "masterIndex", cascade = CascadeType.ALL)
281
+ private List<LocalIdMapping> localMappings;
282
+
283
+ private String masterType; // CUSTOMER, SUPPLIER, PRODUCT
284
+ private String canonicalName;
285
+ private LocalDateTime lastUpdated;
286
+ }
287
+
288
+ // ローカルIDマッピング
289
+ @Entity
290
+ @Table(name = "local_id_mapping")
291
+ public class LocalIdMapping {
292
+ @Id
293
+ @GeneratedValue
294
+ private Long id;
295
+
296
+ @ManyToOne
297
+ private MasterIndex masterIndex;
298
+
299
+ private String systemCode; // SALES, PRODUCTION, ACCOUNTING
300
+ private String localId;
301
+ private String status; // ACTIVE, INACTIVE, PENDING
302
+ }
303
+
304
+ // クロスリファレンスサービス
305
+ @Service
306
+ public class CrossReferenceService {
307
+ private final MasterIndexRepository indexRepository;
308
+
309
+ // グローバルIDからローカルIDを取得
310
+ public String getLocalId(String globalId, String systemCode) {
311
+ return indexRepository.findById(globalId)
312
+ .flatMap(index -> index.getLocalMappings().stream()
313
+ .filter(m -> m.getSystemCode().equals(systemCode))
314
+ .findFirst())
315
+ .map(LocalIdMapping::getLocalId)
316
+ .orElseThrow(() -> new MappingNotFoundException(globalId, systemCode));
317
+ }
318
+
319
+ // ローカルIDからグローバルIDを取得
320
+ public String getGlobalId(String localId, String systemCode) {
321
+ return indexRepository.findByLocalIdAndSystem(localId, systemCode)
322
+ .map(MasterIndex::getGlobalId)
323
+ .orElseThrow(() -> new MappingNotFoundException(localId, systemCode));
324
+ }
325
+
326
+ // 名寄せ処理
327
+ public List<MasterIndex> findPotentialDuplicates(String name) {
328
+ return indexRepository.findByCanonicalNameLike(normalize(name));
329
+ }
330
+ }
331
+ ```
332
+
333
+ </details>
334
+
335
+ ### Consolidation Style(統合型)
336
+
337
+ 各システムのマスタデータを MDM に集約し、分析やレポート用途の「ゴールデンレコード」を作成します。
338
+
339
+ ```plantuml
340
+ @startuml
341
+ title Consolidation Style MDM
342
+
343
+ package "ソースシステム" as source {
344
+ database "販売顧客" as sales_cust
345
+ database "生産取引先" as prod_partner
346
+ database "会計取引先" as acc_partner
347
+ }
348
+
349
+ package "MDM(Consolidation)" as mdm {
350
+ rectangle "ETL/統合処理" as etl
351
+ database "ゴールデンレコード\n----\n統合取引先マスタ\n品質スコア\nソース情報" as golden
352
+ }
353
+
354
+ package "分析システム" as analytics {
355
+ rectangle "BI/レポート" as bi
356
+ rectangle "データウェアハウス" as dwh
357
+ }
358
+
359
+ sales_cust --> etl : 抽出
360
+ prod_partner --> etl : 抽出
361
+ acc_partner --> etl : 抽出
362
+
363
+ etl --> golden : 統合・クレンジング
364
+
365
+ golden --> bi : 参照
366
+ golden --> dwh : 連携
367
+
368
+ note bottom of mdm
369
+ 【特徴】
370
+ ・各システムからデータを収集
371
+ ・クレンジング・統合処理
372
+ ・ゴールデンレコード(信頼できる単一ソース)作成
373
+
374
+ 【適用場面】
375
+ ・分析・レポートの統合ビューが必要
376
+ ・運用系への書き戻し不要
377
+ end note
378
+
379
+ @enduml
380
+ ```
381
+
382
+ #### ゴールデンレコードの構造
383
+
384
+ ```plantuml
385
+ @startuml
386
+ title ゴールデンレコードの構造
387
+
388
+ class "GoldenRecord" as golden {
389
+ +globalId: String
390
+ +entityType: String
391
+ +canonicalName: String
392
+ +qualityScore: Double
393
+ +survivorshipRule: String
394
+ +lastConsolidated: Timestamp
395
+ }
396
+
397
+ class "AttributeValue" as attr {
398
+ +attributeName: String
399
+ +value: String
400
+ +sourceSystem: String
401
+ +confidence: Double
402
+ +lastUpdated: Timestamp
403
+ }
404
+
405
+ class "SourceReference" as source {
406
+ +systemCode: String
407
+ +localId: String
408
+ +lastSynced: Timestamp
409
+ +syncStatus: String
410
+ }
411
+
412
+ class "MatchHistory" as history {
413
+ +matchedGlobalId: String
414
+ +matchScore: Double
415
+ +matchRule: String
416
+ +matchDate: Timestamp
417
+ }
418
+
419
+ golden "1" -- "*" attr : 属性
420
+ golden "1" -- "*" source : ソース参照
421
+ golden "1" -- "*" history : マッチ履歴
422
+
423
+ note right of golden
424
+ 【Survivorship Rule】
425
+ 複数ソースから同一属性がある場合の
426
+ 採用ルール
427
+ ・最新優先
428
+ ・信頼度優先
429
+ ・特定システム優先
430
+ end note
431
+
432
+ @enduml
433
+ ```
434
+
435
+ ### Coexistence Style(共存型)
436
+
437
+ MDM と各システムのマスタが共存し、双方向で同期を行います。
438
+
439
+ ```plantuml
440
+ @startuml
441
+ title Coexistence Style MDM
442
+
443
+ package "MDM Hub" as mdm {
444
+ database "マスタハブ" as hub
445
+ rectangle "同期エンジン" as sync
446
+ }
447
+
448
+ package "販売管理" as sales {
449
+ database "顧客マスタ" as sales_cust
450
+ }
451
+
452
+ package "生産管理" as production {
453
+ database "取引先マスタ" as prod_partner
454
+ }
455
+
456
+ package "財務会計" as accounting {
457
+ database "取引先マスタ" as acc_partner
458
+ }
459
+
460
+ hub <--> sync
461
+ sync <--> sales_cust : 双方向同期
462
+ sync <--> prod_partner : 双方向同期
463
+ sync <--> acc_partner : 双方向同期
464
+
465
+ note bottom of mdm
466
+ 【特徴】
467
+ ・MDMと各システムが共存
468
+ ・双方向でデータ同期
469
+ ・どちらでも更新可能
470
+
471
+ 【適用場面】
472
+ ・段階的なMDM導入
473
+ ・各システムの独自要件を維持
474
+ end note
475
+
476
+ @enduml
477
+ ```
478
+
479
+ #### 同期ルールの設計
480
+
481
+ ```plantuml
482
+ @startuml
483
+ title Coexistence同期ルール
484
+
485
+ |MDM Hub|
486
+ start
487
+ :変更イベント受信;
488
+
489
+ if (変更元は?) then (MDMHub)
490
+ :各システムへ配信;
491
+ :同期ステータス更新;
492
+ else (ローカルシステム)
493
+ :変更内容を検証;
494
+
495
+ if (競合あり?) then (yes)
496
+ :競合解決ルール適用;
497
+ note right
498
+ ・タイムスタンプ優先
499
+ ・システム優先度
500
+ ・手動解決キュー
501
+ end note
502
+ else (no)
503
+ endif
504
+
505
+ :MDM Hubを更新;
506
+ :他システムへ配信;
507
+ endif
508
+
509
+ :同期完了;
510
+
511
+ stop
512
+
513
+ @enduml
514
+ ```
515
+
516
+ <details>
517
+ <summary>Java 実装例</summary>
518
+
519
+ ```java
520
+ // 同期設定
521
+ @Entity
522
+ @Table(name = "sync_configuration")
523
+ public class SyncConfiguration {
524
+ @Id
525
+ private String configId;
526
+
527
+ private String entityType;
528
+ private String sourceSystem;
529
+ private String targetSystem;
530
+ private SyncDirection direction; // INBOUND, OUTBOUND, BIDIRECTIONAL
531
+ private ConflictResolution conflictResolution;
532
+
533
+ public enum ConflictResolution {
534
+ LATEST_WINS, // 最新タイムスタンプ優先
535
+ SOURCE_WINS, // ソースシステム優先
536
+ TARGET_WINS, // ターゲットシステム優先
537
+ MANUAL_REVIEW // 手動確認
538
+ }
539
+ }
540
+
541
+ // 同期サービス
542
+ @Service
543
+ public class CoexistenceSyncService {
544
+ private final SyncConfigurationRepository configRepository;
545
+ private final MasterHubRepository hubRepository;
546
+ private final ConflictResolver conflictResolver;
547
+
548
+ @EventListener
549
+ public void handleMasterChange(MasterChangeEvent event) {
550
+ SyncConfiguration config = configRepository
551
+ .findByEntityTypeAndSystem(event.entityType(), event.sourceSystem());
552
+
553
+ if (event.sourceSystem().equals("MDM_HUB")) {
554
+ // MDM Hubからの変更:各システムへ配信
555
+ distributeToSystems(event, config);
556
+ } else {
557
+ // ローカルシステムからの変更
558
+ MasterRecord hubRecord = hubRepository.findByGlobalId(event.globalId());
559
+
560
+ if (hasConflict(hubRecord, event)) {
561
+ MasterRecord resolved = conflictResolver.resolve(
562
+ hubRecord,
563
+ event,
564
+ config.getConflictResolution()
565
+ );
566
+ hubRepository.save(resolved);
567
+ } else {
568
+ hubRepository.updateFromSource(event);
569
+ }
570
+
571
+ // 他システムへ配信
572
+ distributeToOtherSystems(event, config);
573
+ }
574
+ }
575
+
576
+ private boolean hasConflict(MasterRecord hubRecord, MasterChangeEvent event) {
577
+ return hubRecord.getLastUpdated().isAfter(event.previousUpdateTime());
578
+ }
579
+ }
580
+ ```
581
+
582
+ </details>
583
+
584
+ ### Transaction Hub Style(トランザクションハブ型)
585
+
586
+ MDM が唯一の正(Single Source of Truth)となり、すべてのマスタ更新は MDM 経由で行われます。
587
+
588
+ ```plantuml
589
+ @startuml
590
+ title Transaction Hub Style MDM
591
+
592
+ package "MDM Hub(唯一の正)" as mdm {
593
+ database "マスタデータ" as master
594
+ rectangle "API Gateway" as api
595
+ rectangle "バリデーション" as validation
596
+ rectangle "ワークフロー" as workflow
597
+ }
598
+
599
+ package "販売管理" as sales {
600
+ rectangle "顧客参照" as sales_ref
601
+ }
602
+
603
+ package "生産管理" as production {
604
+ rectangle "取引先参照" as prod_ref
605
+ }
606
+
607
+ package "財務会計" as accounting {
608
+ rectangle "取引先参照" as acc_ref
609
+ }
610
+
611
+ actor "マスタ管理者" as admin
612
+
613
+ admin --> api : マスタ更新
614
+ api --> validation : 検証
615
+ validation --> workflow : 承認フロー
616
+ workflow --> master : 更新
617
+
618
+ master --> sales_ref : 参照のみ
619
+ master --> prod_ref : 参照のみ
620
+ master --> acc_ref : 参照のみ
621
+
622
+ note bottom of mdm
623
+ 【特徴】
624
+ ・MDMが唯一の更新ポイント
625
+ ・各システムは参照のみ
626
+ ・最高レベルのデータ一貫性
627
+
628
+ 【適用場面】
629
+ ・厳格なデータガバナンスが必要
630
+ ・規制対応(金融、医療等)
631
+ end note
632
+
633
+ @enduml
634
+ ```
635
+
636
+ #### マスタ更新ワークフロー
637
+
638
+ ```plantuml
639
+ @startuml
640
+ title Transaction Hub マスタ更新フロー
641
+
642
+ |申請者|
643
+ start
644
+ :マスタ変更申請;
645
+ :変更内容入力;
646
+
647
+ |MDM Hub|
648
+ :申請受付;
649
+ :自動バリデーション;
650
+
651
+ if (バリデーションOK?) then (yes)
652
+ else (no)
653
+ :エラー通知;
654
+ |申請者|
655
+ :内容修正;
656
+ |MDM Hub|
657
+ endif
658
+
659
+ :承認ワークフロー開始;
660
+
661
+ |承認者|
662
+ :変更内容確認;
663
+
664
+ if (承認?) then (yes)
665
+ :承認;
666
+ else (no)
667
+ :却下;
668
+ |申請者|
669
+ :却下通知受信;
670
+ stop
671
+ endif
672
+
673
+ |MDM Hub|
674
+ :マスタデータ更新;
675
+ :変更イベント発行;
676
+ :監査ログ記録;
677
+
678
+ |各システム|
679
+ :変更イベント受信;
680
+ :ローカルキャッシュ更新;
681
+
682
+ |申請者|
683
+ :完了通知受信;
684
+
685
+ stop
686
+
687
+ @enduml
688
+ ```
689
+
690
+ ### MDM パターンの比較と選択
691
+
692
+ | パターン | データ一貫性 | 導入コスト | 運用負荷 | 適用場面 |
693
+ |---------|------------|----------|---------|---------|
694
+ | Registry | 低 | 低 | 低 | 分析用途、名寄せ |
695
+ | Consolidation | 中 | 中 | 中 | BI、レポート |
696
+ | Coexistence | 中〜高 | 中〜高 | 高 | 段階的移行 |
697
+ | Transaction Hub | 高 | 高 | 中 | 規制対応、厳格なガバナンス |
698
+
699
+ ```plantuml
700
+ @startuml
701
+ title MDMパターン選択フローチャート
702
+
703
+ start
704
+
705
+ :MDM導入検討;
706
+
707
+ if (既存システムへの\n影響を最小化?) then (yes)
708
+ if (分析用途のみ?) then (yes)
709
+ :Consolidation Style;
710
+ stop
711
+ else (no)
712
+ :Registry Style;
713
+ stop
714
+ endif
715
+ else (no)
716
+ if (厳格なデータガバナンス\nが必要?) then (yes)
717
+ :Transaction Hub Style;
718
+ stop
719
+ else (no)
720
+ if (段階的な移行?) then (yes)
721
+ :Coexistence Style;
722
+ stop
723
+ else (no)
724
+ :Transaction Hub Style;
725
+ stop
726
+ endif
727
+ endif
728
+ endif
729
+
730
+ @enduml
731
+ ```
732
+
733
+ ---
734
+
735
+ ## 36.3 共通マスタの設計
736
+
737
+ 基幹業務システムで共有される主要なマスタデータの統合設計について解説します。
738
+
739
+ ### 取引先マスタの統合
740
+
741
+ 取引先(顧客、仕入先、外注先)は、複数のシステムで参照される代表的なマスタです。
742
+
743
+ ```plantuml
744
+ @startuml
745
+ title 統合取引先マスタの設計
746
+
747
+ entity "統合取引先マスタ" as partner {
748
+ *取引先ID <<PK>>
749
+ --
750
+ *取引先名
751
+ 取引先名カナ
752
+ 取引先区分
753
+ 法人個人区分
754
+ 代表者名
755
+ 設立年月日
756
+ 資本金
757
+ 従業員数
758
+ 業種コード
759
+ --
760
+ 作成日時
761
+ 更新日時
762
+ 有効フラグ
763
+ }
764
+
765
+ entity "取引先住所" as address {
766
+ *住所ID <<PK>>
767
+ --
768
+ *取引先ID <<FK>>
769
+ 住所区分
770
+ 郵便番号
771
+ 都道府県
772
+ 市区町村
773
+ 町域
774
+ 番地
775
+ 建物名
776
+ --
777
+ 主住所フラグ
778
+ }
779
+
780
+ entity "取引先連絡先" as contact {
781
+ *連絡先ID <<PK>>
782
+ --
783
+ *取引先ID <<FK>>
784
+ 連絡先区分
785
+ 担当者名
786
+ 部署名
787
+ 電話番号
788
+ FAX番号
789
+ メールアドレス
790
+ --
791
+ 主連絡先フラグ
792
+ }
793
+
794
+ entity "取引先口座" as account {
795
+ *口座ID <<PK>>
796
+ --
797
+ *取引先ID <<FK>>
798
+ 銀行コード
799
+ 支店コード
800
+ 口座種別
801
+ 口座番号
802
+ 口座名義
803
+ --
804
+ 主口座フラグ
805
+ }
806
+
807
+ entity "取引先システム属性" as system_attr {
808
+ *属性ID <<PK>>
809
+ --
810
+ *取引先ID <<FK>>
811
+ *システムコード
812
+ 属性名
813
+ 属性値
814
+ --
815
+ 有効開始日
816
+ 有効終了日
817
+ }
818
+
819
+ partner ||--o{ address
820
+ partner ||--o{ contact
821
+ partner ||--o{ account
822
+ partner ||--o{ system_attr
823
+
824
+ note right of partner
825
+ 【取引先区分】
826
+ ・CUSTOMER(顧客)
827
+ ・SUPPLIER(仕入先)
828
+ ・SUBCONTRACTOR(外注先)
829
+ ・BOTH(顧客兼仕入先)
830
+ end note
831
+
832
+ note right of system_attr
833
+ 【システム固有属性の例】
834
+ ・販売:与信限度額、締日、回収方法
835
+ ・生産:納入リードタイム、発注ロット
836
+ ・会計:勘定科目、補助科目
837
+ end note
838
+
839
+ @enduml
840
+ ```
841
+
842
+ <details>
843
+ <summary>SQL 定義</summary>
844
+
845
+ ```sql
846
+ -- 統合取引先マスタ
847
+ CREATE TABLE 統合取引先マスタ (
848
+ 取引先ID VARCHAR(20) PRIMARY KEY,
849
+ 取引先名 VARCHAR(200) NOT NULL,
850
+ 取引先名カナ VARCHAR(200),
851
+ 取引先区分 VARCHAR(20) NOT NULL,
852
+ 法人個人区分 VARCHAR(10),
853
+ 代表者名 VARCHAR(100),
854
+ 設立年月日 DATE,
855
+ 資本金 DECIMAL(15,0),
856
+ 従業員数 INTEGER,
857
+ 業種コード VARCHAR(10),
858
+ 作成日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
859
+ 更新日時 TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
860
+ 有効フラグ BOOLEAN DEFAULT TRUE
861
+ );
862
+
863
+ -- 取引先住所
864
+ CREATE TABLE 取引先住所 (
865
+ 住所ID VARCHAR(20) PRIMARY KEY,
866
+ 取引先ID VARCHAR(20) NOT NULL,
867
+ 住所区分 VARCHAR(20) NOT NULL,
868
+ 郵便番号 VARCHAR(10),
869
+ 都道府県 VARCHAR(10),
870
+ 市区町村 VARCHAR(50),
871
+ 町域 VARCHAR(100),
872
+ 番地 VARCHAR(100),
873
+ 建物名 VARCHAR(100),
874
+ 主住所フラグ BOOLEAN DEFAULT FALSE,
875
+ FOREIGN KEY (取引先ID) REFERENCES 統合取引先マスタ(取引先ID)
876
+ );
877
+
878
+ -- 取引先システム属性
879
+ CREATE TABLE 取引先システム属性 (
880
+ 属性ID VARCHAR(20) PRIMARY KEY,
881
+ 取引先ID VARCHAR(20) NOT NULL,
882
+ システムコード VARCHAR(20) NOT NULL,
883
+ 属性名 VARCHAR(50) NOT NULL,
884
+ 属性値 VARCHAR(500),
885
+ 有効開始日 DATE,
886
+ 有効終了日 DATE,
887
+ FOREIGN KEY (取引先ID) REFERENCES 統合取引先マスタ(取引先ID),
888
+ UNIQUE (取引先ID, システムコード, 属性名, 有効開始日)
889
+ );
890
+ ```
891
+
892
+ </details>
893
+
894
+ ### 商品/品目マスタの統合
895
+
896
+ 販売管理の「商品」と生産管理の「品目」を統合的に管理します。
897
+
898
+ ```plantuml
899
+ @startuml
900
+ title 統合商品/品目マスタの設計
901
+
902
+ entity "統合商品マスタ" as product {
903
+ *商品ID <<PK>>
904
+ --
905
+ *商品名
906
+ 商品名カナ
907
+ 商品区分
908
+ 販売単位
909
+ 在庫管理単位
910
+ 製造単位
911
+ 基準換算率
912
+ --
913
+ JANコード
914
+ 製造元コード
915
+ ブランドコード
916
+ --
917
+ 有効開始日
918
+ 有効終了日
919
+ }
920
+
921
+ entity "商品分類" as category {
922
+ *分類ID <<PK>>
923
+ --
924
+ *商品ID <<FK>>
925
+ *分類体系コード
926
+ 分類コード
927
+ 分類階層
928
+ }
929
+
930
+ entity "商品販売属性" as sales_attr {
931
+ *属性ID <<PK>>
932
+ --
933
+ *商品ID <<FK>>
934
+ 標準販売単価
935
+ 最低販売単価
936
+ 販売開始日
937
+ 販売終了日
938
+ --
939
+ 課税区分
940
+ 消費税率
941
+ }
942
+
943
+ entity "商品製造属性" as mfg_attr {
944
+ *属性ID <<PK>>
945
+ --
946
+ *商品ID <<FK>>
947
+ 製造リードタイム
948
+ 安全在庫数
949
+ 最小ロット数
950
+ 発注点
951
+ --
952
+ 歩留率
953
+ 検査要否
954
+ }
955
+
956
+ entity "商品原価属性" as cost_attr {
957
+ *属性ID <<PK>>
958
+ --
959
+ *商品ID <<FK>>
960
+ 標準原価
961
+ 原価計算方式
962
+ 有効開始日
963
+ 有効終了日
964
+ }
965
+
966
+ product ||--o{ category
967
+ product ||--o| sales_attr
968
+ product ||--o| mfg_attr
969
+ product ||--o{ cost_attr
970
+
971
+ note right of product
972
+ 【商品区分】
973
+ ・FINISHED(製品)
974
+ ・SEMI_FINISHED(半製品)
975
+ ・WIP(仕掛品)
976
+ ・RAW_MATERIAL(原材料)
977
+ ・PURCHASED(購入品)
978
+ ・SERVICE(サービス)
979
+ end note
980
+
981
+ @enduml
982
+ ```
983
+
984
+ #### 商品コード体系の統一
985
+
986
+ ```plantuml
987
+ @startuml
988
+ title 統一商品コード体系
989
+
990
+ object "コード構成" as code_structure {
991
+ 形式: PPPP-CCCC-SSSS-VV
992
+ --
993
+ PPPP: 商品区分(4桁)
994
+ CCCC: 分類コード(4桁)
995
+ SSSS: 連番(4桁)
996
+ VV: バージョン(2桁)
997
+ }
998
+
999
+ object "商品区分コード" as product_type {
1000
+ PROD: 製品
1001
+ SEMI: 半製品
1002
+ RAWM: 原材料
1003
+ PART: 部品
1004
+ SUPP: 消耗品
1005
+ SERV: サービス
1006
+ }
1007
+
1008
+ object "コード例" as examples {
1009
+ PROD-ELEC-0001-01: 電子機器製品001
1010
+ SEMI-MECH-0023-01: 機械半製品023
1011
+ RAWM-METAL-0102-01: 金属原材料102
1012
+ }
1013
+
1014
+ @enduml
1015
+ ```
1016
+
1017
+ ### 部門・組織マスタの統合
1018
+
1019
+ 組織構造は、権限管理や実績集計に使用される重要なマスタです。
1020
+
1021
+ ```plantuml
1022
+ @startuml
1023
+ title 統合組織マスタの設計
1024
+
1025
+ entity "組織マスタ" as org {
1026
+ *組織ID <<PK>>
1027
+ --
1028
+ *組織名
1029
+ 組織名略称
1030
+ 組織区分
1031
+ 組織レベル
1032
+ 親組織ID <<FK>>
1033
+ 組織パス
1034
+ --
1035
+ 有効開始日
1036
+ 有効終了日
1037
+ }
1038
+
1039
+ entity "組織階層" as hierarchy {
1040
+ *階層ID <<PK>>
1041
+ --
1042
+ *組織ID <<FK>>
1043
+ *階層種別
1044
+ 上位組織ID
1045
+ 下位組織ID
1046
+ 階層順序
1047
+ }
1048
+
1049
+ entity "組織属性" as org_attr {
1050
+ *属性ID <<PK>>
1051
+ --
1052
+ *組織ID <<FK>>
1053
+ *システムコード
1054
+ 属性名
1055
+ 属性値
1056
+ 有効開始日
1057
+ 有効終了日
1058
+ }
1059
+
1060
+ entity "組織担当者" as staff {
1061
+ *担当者ID <<PK>>
1062
+ --
1063
+ *組織ID <<FK>>
1064
+ 社員ID
1065
+ 役職コード
1066
+ 主担当フラグ
1067
+ 有効開始日
1068
+ 有効終了日
1069
+ }
1070
+
1071
+ org ||--o{ hierarchy
1072
+ org ||--o{ org_attr
1073
+ org ||--o{ staff
1074
+ org ||--o| org : 親組織
1075
+
1076
+ note right of org
1077
+ 【組織区分】
1078
+ ・COMPANY(会社)
1079
+ ・DIVISION(事業部)
1080
+ ・DEPARTMENT(部)
1081
+ ・SECTION(課)
1082
+ ・TEAM(チーム)
1083
+ end note
1084
+
1085
+ note right of hierarchy
1086
+ 【階層種別】
1087
+ ・REPORTING(レポート階層)
1088
+ ・COST_CENTER(原価センター階層)
1089
+ ・SALES_TERRITORY(営業テリトリー階層)
1090
+ end note
1091
+
1092
+ @enduml
1093
+ ```
1094
+
1095
+ #### 組織パスによる階層表現
1096
+
1097
+ ```plantuml
1098
+ @startuml
1099
+ title 組織パスによる階層表現
1100
+
1101
+ object "株式会社ABC" as company {
1102
+ 組織ID = "ORG-001"
1103
+ 組織パス = "/ORG-001"
1104
+ 組織レベル = 1
1105
+ }
1106
+
1107
+ object "営業本部" as sales_div {
1108
+ 組織ID = "ORG-010"
1109
+ 組織パス = "/ORG-001/ORG-010"
1110
+ 組織レベル = 2
1111
+ }
1112
+
1113
+ object "東日本営業部" as east_dept {
1114
+ 組織ID = "ORG-011"
1115
+ 組織パス = "/ORG-001/ORG-010/ORG-011"
1116
+ 組織レベル = 3
1117
+ }
1118
+
1119
+ object "東京営業課" as tokyo_sec {
1120
+ 組織ID = "ORG-111"
1121
+ 組織パス = "/ORG-001/ORG-010/ORG-011/ORG-111"
1122
+ 組織レベル = 4
1123
+ }
1124
+
1125
+ company --> sales_div
1126
+ sales_div --> east_dept
1127
+ east_dept --> tokyo_sec
1128
+
1129
+ note bottom
1130
+ 【組織パスの利点】
1131
+ ・階層検索が高速(LIKE '/ORG-001/%')
1132
+ ・任意の深さに対応
1133
+ ・親子関係の判定が容易
1134
+ end note
1135
+
1136
+ @enduml
1137
+ ```
1138
+
1139
+ <details>
1140
+ <summary>SQL クエリ例</summary>
1141
+
1142
+ ```sql
1143
+ -- 特定組織の配下をすべて取得
1144
+ SELECT * FROM 組織マスタ
1145
+ WHERE 組織パス LIKE '/ORG-001/ORG-010/%'
1146
+ ORDER BY 組織パス;
1147
+
1148
+ -- 特定組織の直接の子組織を取得
1149
+ SELECT * FROM 組織マスタ
1150
+ WHERE 親組織ID = 'ORG-010'
1151
+ AND 有効終了日 IS NULL;
1152
+
1153
+ -- 組織の全階層を展開(再帰CTE)
1154
+ WITH RECURSIVE 組織階層 AS (
1155
+ -- 基点
1156
+ SELECT 組織ID, 組織名, 親組織ID, 1 as レベル
1157
+ FROM 組織マスタ
1158
+ WHERE 組織ID = 'ORG-001'
1159
+
1160
+ UNION ALL
1161
+
1162
+ -- 再帰部分
1163
+ SELECT o.組織ID, o.組織名, o.親組織ID, h.レベル + 1
1164
+ FROM 組織マスタ o
1165
+ INNER JOIN 組織階層 h ON o.親組織ID = h.組織ID
1166
+ WHERE o.有効終了日 IS NULL
1167
+ )
1168
+ SELECT * FROM 組織階層
1169
+ ORDER BY レベル, 組織ID;
1170
+ ```
1171
+
1172
+ </details>
1173
+
1174
+ ---
1175
+
1176
+ ## 36.4 MDM 導入のベストプラクティス
1177
+
1178
+ ### データガバナンスの確立
1179
+
1180
+ ```plantuml
1181
+ @startuml
1182
+ title データガバナンス体制
1183
+
1184
+ rectangle "データガバナンス委員会" as committee {
1185
+ rectangle "データスチュワード" as steward
1186
+ rectangle "データオーナー" as owner
1187
+ rectangle "データ品質管理者" as quality
1188
+ }
1189
+
1190
+ rectangle "ポリシー・ルール" as policy {
1191
+ rectangle "データ標準" as standard
1192
+ rectangle "品質基準" as quality_std
1193
+ rectangle "セキュリティポリシー" as security
1194
+ }
1195
+
1196
+ rectangle "プロセス" as process {
1197
+ rectangle "登録プロセス" as register
1198
+ rectangle "変更プロセス" as change
1199
+ rectangle "監査プロセス" as audit
1200
+ }
1201
+
1202
+ rectangle "ツール" as tools {
1203
+ rectangle "MDMプラットフォーム" as platform
1204
+ rectangle "データ品質ツール" as dq_tool
1205
+ rectangle "ワークフローツール" as workflow
1206
+ }
1207
+
1208
+ committee --> policy : 策定
1209
+ committee --> process : 管理
1210
+ process --> tools : 実装
1211
+
1212
+ @enduml
1213
+ ```
1214
+
1215
+ ### 段階的な導入アプローチ
1216
+
1217
+ ```plantuml
1218
+ @startuml
1219
+ title MDM段階的導入ロードマップ
1220
+
1221
+ |Phase 1|
1222
+ :アセスメント;
1223
+ note right
1224
+ ・現状分析
1225
+ ・課題特定
1226
+ ・ROI試算
1227
+ end note
1228
+
1229
+ |Phase 2|
1230
+ :パイロット;
1231
+ note right
1232
+ ・対象マスタ選定
1233
+ ・小規模で検証
1234
+ ・課題抽出
1235
+ end note
1236
+
1237
+ |Phase 3|
1238
+ :展開;
1239
+ note right
1240
+ ・対象マスタ拡大
1241
+ ・システム連携
1242
+ ・運用プロセス確立
1243
+ end note
1244
+
1245
+ |Phase 4|
1246
+ :最適化;
1247
+ note right
1248
+ ・データ品質向上
1249
+ ・プロセス改善
1250
+ ・新規マスタ追加
1251
+ end note
1252
+
1253
+ @enduml
1254
+ ```
1255
+
1256
+ ---
1257
+
1258
+ ## 36.5 まとめ
1259
+
1260
+ 本章では、マスタデータ管理(MDM)の概念と実践的なパターンについて解説しました。
1261
+
1262
+ ### 学んだこと
1263
+
1264
+ 1. **マスタデータ統合の課題**
1265
+
1266
+ - 各システムでのマスタ重複
1267
+ - コード体系の不一致
1268
+ - 更新タイミングの同期問題
1269
+
1270
+ 2. **MDM パターン**
1271
+
1272
+ - Registry Style:インデックスとしての軽量 MDM
1273
+ - Consolidation Style:分析用ゴールデンレコード
1274
+ - Coexistence Style:双方向同期による共存
1275
+ - Transaction Hub Style:唯一の正としての厳格な MDM
1276
+
1277
+ 3. **共通マスタの設計**
1278
+
1279
+ - 取引先マスタ:顧客・仕入先・外注先の統合
1280
+ - 商品/品目マスタ:販売と製造の属性統合
1281
+ - 部門・組織マスタ:階層構造の表現
1282
+
1283
+ ### MDM 成功のポイント
1284
+
1285
+ - ビジネス要件に合ったパターンの選択
1286
+ - 段階的な導入アプローチ
1287
+ - データガバナンス体制の確立
1288
+ - 継続的なデータ品質管理
1289
+
1290
+ ### 次章の予告
1291
+
1292
+ 第37章では、イベント駆動アーキテクチャについて解説します。ドメインイベント、イベントソーシング、CQRS など、モダンなシステム統合の基盤となる概念を学びます。