@k2works/claude-code-booster 4.6.0 → 4.7.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 (779) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +42 -42
  3. package/bin/claude-code-booster +90 -90
  4. package/lib/assets/.claude/README.md +269 -269
  5. package/lib/assets/.claude/agents/xp-architect.md +250 -250
  6. package/lib/assets/.claude/agents/xp-executive.md +207 -207
  7. package/lib/assets/.claude/agents/xp-interaction-designer.md +239 -239
  8. package/lib/assets/.claude/agents/xp-product-manager.md +245 -245
  9. package/lib/assets/.claude/agents/xp-programmer.md +268 -268
  10. package/lib/assets/.claude/agents/xp-project-manager.md +229 -229
  11. package/lib/assets/.claude/agents/xp-technical-writer.md +224 -224
  12. package/lib/assets/.claude/agents/xp-tester.md +265 -265
  13. package/lib/assets/.claude/agents/xp-user-representative.md +204 -204
  14. package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
  15. package/lib/assets/.claude/settings.json +11 -11
  16. package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +111 -111
  17. package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +83 -83
  18. package/lib/assets/.claude/skills/analyzing-business-architecture/SKILL.md +122 -122
  19. package/lib/assets/.claude/skills/analyzing-business-case/SKILL.md +148 -148
  20. package/lib/assets/.claude/skills/analyzing-business-strategy/SKILL.md +277 -277
  21. package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +77 -77
  22. package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +117 -117
  23. package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +84 -84
  24. package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +95 -95
  25. package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +95 -95
  26. package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +91 -91
  27. package/lib/assets/.claude/skills/analyzing-review/SKILL.md +174 -174
  28. package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +101 -101
  29. package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +89 -89
  30. package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +80 -80
  31. package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +72 -72
  32. package/lib/assets/.claude/skills/creating-adr/SKILL.md +113 -113
  33. package/lib/assets/.claude/skills/creating-iteration-report/SKILL.md +210 -210
  34. package/lib/assets/.claude/skills/creating-release-report/SKILL.md +161 -161
  35. package/lib/assets/.claude/skills/creating-slides/SKILL.md +86 -86
  36. package/lib/assets/.claude/skills/creating-slides/agents/openai.yaml +4 -4
  37. package/lib/assets/.claude/skills/creating-slides/references/manga-css.md +45 -45
  38. package/lib/assets/.claude/skills/creating-slides/scripts/slide_tools.py +239 -239
  39. package/lib/assets/.claude/skills/developing-backend/SKILL.md +100 -100
  40. package/lib/assets/.claude/skills/developing-frontend/SKILL.md +93 -93
  41. package/lib/assets/.claude/skills/developing-release/SKILL.md +120 -120
  42. package/lib/assets/.claude/skills/developing-review/SKILL.md +175 -175
  43. package/lib/assets/.claude/skills/developing-uiux-review/SKILL.md +207 -207
  44. package/lib/assets/.claude/skills/generating-bmc/SKILL.md +123 -123
  45. package/lib/assets/.claude/skills/generating-slides/SKILL.md +94 -94
  46. package/lib/assets/.claude/skills/git-commit/SKILL.md +81 -81
  47. package/lib/assets/.claude/skills/killing-processes/SKILL.md +44 -44
  48. package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -59
  49. package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -54
  50. package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -67
  51. package/lib/assets/.claude/skills/operating-docs/SKILL.md +219 -219
  52. package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -77
  53. package/lib/assets/.claude/skills/operating-qt/SKILL.md +147 -147
  54. package/lib/assets/.claude/skills/operating-review/SKILL.md +171 -171
  55. package/lib/assets/.claude/skills/operating-script/SKILL.md +145 -145
  56. package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -63
  57. package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +104 -104
  58. package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +168 -168
  59. package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +158 -158
  60. package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +144 -144
  61. package/lib/assets/.claude/skills/planning-releases/SKILL.md +119 -119
  62. package/lib/assets/.claude/skills/practicing-getting-start-tdd/SKILL.md +266 -266
  63. package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +151 -151
  64. package/lib/assets/.claude/skills/tracking-progress/SKILL.md +91 -91
  65. package/lib/assets/.claude/skills/validating-iteration-plan/SKILL.md +238 -238
  66. package/lib/assets/.devcontainer/devcontainer.json +37 -37
  67. package/lib/assets/.env.example +17 -17
  68. package/lib/assets/.gitattributes +4 -4
  69. package/lib/assets/.github/workflows/docker-publish.yml +77 -77
  70. package/lib/assets/.github/workflows/mkdocs.yml +39 -39
  71. package/lib/assets/AGENTS.md +94 -94
  72. package/lib/assets/CLAUDE.md +193 -193
  73. package/lib/assets/README.md +291 -291
  74. package/lib/assets/docker-compose.yml +33 -33
  75. package/lib/assets/docs/adr/index.md +10 -10
  76. package/lib/assets/docs/article/functional-desgin-ppp/all/01-immutability-and-data-transformation.md +475 -475
  77. package/lib/assets/docs/article/functional-desgin-ppp/all/02-function-composition.md +519 -519
  78. package/lib/assets/docs/article/functional-desgin-ppp/all/03-polymorphism.md +537 -537
  79. package/lib/assets/docs/article/functional-desgin-ppp/all/04-data-validation.md +300 -300
  80. package/lib/assets/docs/article/functional-desgin-ppp/all/05-property-based-testing.md +320 -320
  81. package/lib/assets/docs/article/functional-desgin-ppp/all/06-tdd-and-functional.md +498 -498
  82. package/lib/assets/docs/article/functional-desgin-ppp/all/07-composite-pattern.md +298 -298
  83. package/lib/assets/docs/article/functional-desgin-ppp/all/08-decorator-pattern.md +291 -291
  84. package/lib/assets/docs/article/functional-desgin-ppp/all/09-adapter-pattern.md +336 -336
  85. package/lib/assets/docs/article/functional-desgin-ppp/all/10-strategy-pattern.md +303 -303
  86. package/lib/assets/docs/article/functional-desgin-ppp/all/11-command-pattern.md +286 -286
  87. package/lib/assets/docs/article/functional-desgin-ppp/all/12-visitor-pattern.md +322 -322
  88. package/lib/assets/docs/article/functional-desgin-ppp/all/13-abstract-factory-pattern.md +319 -319
  89. package/lib/assets/docs/article/functional-desgin-ppp/all/14-abstract-server-pattern.md +365 -365
  90. package/lib/assets/docs/article/functional-desgin-ppp/all/15-gossiping-bus-drivers.md +156 -156
  91. package/lib/assets/docs/article/functional-desgin-ppp/all/16-payroll-system.md +178 -178
  92. package/lib/assets/docs/article/functional-desgin-ppp/all/17-video-rental-system.md +312 -312
  93. package/lib/assets/docs/article/functional-desgin-ppp/all/18-concurrency-system.md +287 -287
  94. package/lib/assets/docs/article/functional-desgin-ppp/all/19-wa-tor-simulation.md +286 -286
  95. package/lib/assets/docs/article/functional-desgin-ppp/all/20-pattern-interactions.md +274 -274
  96. package/lib/assets/docs/article/functional-desgin-ppp/all/21-best-practices.md +294 -294
  97. package/lib/assets/docs/article/functional-desgin-ppp/all/22-oo-to-fp-migration.md +337 -337
  98. package/lib/assets/docs/article/functional-desgin-ppp/all/index.md +388 -388
  99. package/lib/assets/docs/article/functional-desgin-ppp/clojure/01-immutability-and-data-transformation.md +273 -273
  100. package/lib/assets/docs/article/functional-desgin-ppp/clojure/02-function-composition.md +380 -380
  101. package/lib/assets/docs/article/functional-desgin-ppp/clojure/03-polymorphism.md +384 -384
  102. package/lib/assets/docs/article/functional-desgin-ppp/clojure/04-clojure-spec.md +350 -350
  103. package/lib/assets/docs/article/functional-desgin-ppp/clojure/05-property-based-testing.md +352 -352
  104. package/lib/assets/docs/article/functional-desgin-ppp/clojure/06-tdd-in-functional.md +383 -383
  105. package/lib/assets/docs/article/functional-desgin-ppp/clojure/07-composite-pattern.md +529 -529
  106. package/lib/assets/docs/article/functional-desgin-ppp/clojure/08-decorator-pattern.md +395 -395
  107. package/lib/assets/docs/article/functional-desgin-ppp/clojure/09-adapter-pattern.md +399 -399
  108. package/lib/assets/docs/article/functional-desgin-ppp/clojure/10-strategy-pattern.md +485 -485
  109. package/lib/assets/docs/article/functional-desgin-ppp/clojure/11-command-pattern.md +566 -566
  110. package/lib/assets/docs/article/functional-desgin-ppp/clojure/12-visitor-pattern.md +567 -567
  111. package/lib/assets/docs/article/functional-desgin-ppp/clojure/13-abstract-factory-pattern.md +475 -475
  112. package/lib/assets/docs/article/functional-desgin-ppp/clojure/14-abstract-server-pattern.md +462 -462
  113. package/lib/assets/docs/article/functional-desgin-ppp/clojure/15-gossiping-bus-drivers.md +325 -325
  114. package/lib/assets/docs/article/functional-desgin-ppp/clojure/16-payroll-system.md +401 -401
  115. package/lib/assets/docs/article/functional-desgin-ppp/clojure/17-video-rental-system.md +450 -450
  116. package/lib/assets/docs/article/functional-desgin-ppp/clojure/18-concurrency-system.md +475 -475
  117. package/lib/assets/docs/article/functional-desgin-ppp/clojure/19-wator-simulation.md +739 -739
  118. package/lib/assets/docs/article/functional-desgin-ppp/clojure/20-pattern-interactions.md +567 -567
  119. package/lib/assets/docs/article/functional-desgin-ppp/clojure/21-best-practices.md +518 -518
  120. package/lib/assets/docs/article/functional-desgin-ppp/clojure/22-oo-to-fp-migration.md +532 -532
  121. package/lib/assets/docs/article/functional-desgin-ppp/clojure/index.md +241 -241
  122. package/lib/assets/docs/article/functional-desgin-ppp/elixir/01-immutability-and-data-transformation.md +383 -383
  123. package/lib/assets/docs/article/functional-desgin-ppp/elixir/02-function-composition.md +374 -374
  124. package/lib/assets/docs/article/functional-desgin-ppp/elixir/03-polymorphism.md +375 -375
  125. package/lib/assets/docs/article/functional-desgin-ppp/elixir/04-data-validation.md +195 -195
  126. package/lib/assets/docs/article/functional-desgin-ppp/elixir/05-property-based-testing.md +268 -268
  127. package/lib/assets/docs/article/functional-desgin-ppp/elixir/06-tdd-and-fp.md +294 -294
  128. package/lib/assets/docs/article/functional-desgin-ppp/elixir/07-effects-and-pure-functions.md +164 -164
  129. package/lib/assets/docs/article/functional-desgin-ppp/elixir/08-error-handling-strategies.md +168 -168
  130. package/lib/assets/docs/article/functional-desgin-ppp/elixir/09-io-and-external-systems.md +254 -254
  131. package/lib/assets/docs/article/functional-desgin-ppp/elixir/10-concurrency-patterns.md +269 -269
  132. package/lib/assets/docs/article/functional-desgin-ppp/elixir/11-command-pattern.md +148 -148
  133. package/lib/assets/docs/article/functional-desgin-ppp/elixir/12-visitor-pattern.md +176 -176
  134. package/lib/assets/docs/article/functional-desgin-ppp/elixir/13-abstract-factory-pattern.md +604 -604
  135. package/lib/assets/docs/article/functional-desgin-ppp/elixir/14-abstract-server-pattern.md +729 -729
  136. package/lib/assets/docs/article/functional-desgin-ppp/elixir/15-gossiping-bus-drivers.md +291 -291
  137. package/lib/assets/docs/article/functional-desgin-ppp/elixir/16-payroll-system.md +420 -420
  138. package/lib/assets/docs/article/functional-desgin-ppp/elixir/17-video-rental-system.md +319 -319
  139. package/lib/assets/docs/article/functional-desgin-ppp/elixir/18-concurrency-system.md +466 -466
  140. package/lib/assets/docs/article/functional-desgin-ppp/elixir/19-wator-simulation.md +523 -523
  141. package/lib/assets/docs/article/functional-desgin-ppp/elixir/20-pattern-interactions.md +287 -287
  142. package/lib/assets/docs/article/functional-desgin-ppp/elixir/21-best-practices.md +340 -340
  143. package/lib/assets/docs/article/functional-desgin-ppp/elixir/22-oo-to-fp-migration.md +395 -395
  144. package/lib/assets/docs/article/functional-desgin-ppp/elixir/index.md +248 -248
  145. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/01-immutability-and-data-transformation.md +384 -384
  146. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/02-function-composition.md +452 -452
  147. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/03-polymorphism.md +495 -495
  148. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/04-data-validation.md +416 -416
  149. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/05-property-based-testing.md +382 -382
  150. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/06-tdd-functional.md +687 -687
  151. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/07-composite-pattern.md +442 -442
  152. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/08-decorator-pattern.md +479 -479
  153. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/09-adapter-pattern.md +479 -479
  154. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/10-strategy-pattern.md +427 -427
  155. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/11-command-pattern.md +428 -428
  156. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/12-visitor-pattern.md +339 -339
  157. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/13-abstract-factory-pattern.md +309 -309
  158. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/14-abstract-server-pattern.md +596 -596
  159. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/15-gossiping-bus-drivers.md +355 -355
  160. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/16-payroll-system.md +350 -350
  161. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/17-video-rental-system.md +414 -414
  162. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/18-concurrency-system.md +367 -367
  163. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/19-wator-simulation.md +403 -403
  164. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/20-pattern-interactions.md +291 -291
  165. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/21-best-practices.md +324 -324
  166. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/22-oo-to-fp-migration.md +332 -332
  167. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/index.md +274 -274
  168. package/lib/assets/docs/article/functional-desgin-ppp/haskell/01-immutability-and-data-transformation.md +298 -298
  169. package/lib/assets/docs/article/functional-desgin-ppp/haskell/02-function-composition.md +304 -304
  170. package/lib/assets/docs/article/functional-desgin-ppp/haskell/03-polymorphism.md +362 -362
  171. package/lib/assets/docs/article/functional-desgin-ppp/haskell/04-data-validation.md +257 -257
  172. package/lib/assets/docs/article/functional-desgin-ppp/haskell/05-property-based-testing.md +254 -254
  173. package/lib/assets/docs/article/functional-desgin-ppp/haskell/06-tdd-functional.md +283 -283
  174. package/lib/assets/docs/article/functional-desgin-ppp/haskell/07-composite-pattern.md +395 -395
  175. package/lib/assets/docs/article/functional-desgin-ppp/haskell/08-decorator-pattern.md +319 -319
  176. package/lib/assets/docs/article/functional-desgin-ppp/haskell/09-adapter-pattern.md +382 -382
  177. package/lib/assets/docs/article/functional-desgin-ppp/haskell/10-strategy-pattern.md +287 -287
  178. package/lib/assets/docs/article/functional-desgin-ppp/haskell/11-command-pattern.md +303 -303
  179. package/lib/assets/docs/article/functional-desgin-ppp/haskell/12-visitor-pattern.md +326 -326
  180. package/lib/assets/docs/article/functional-desgin-ppp/haskell/13-abstract-factory-pattern.md +332 -332
  181. package/lib/assets/docs/article/functional-desgin-ppp/haskell/14-abstract-server-pattern.md +379 -379
  182. package/lib/assets/docs/article/functional-desgin-ppp/haskell/15-gossiping-bus-drivers.md +177 -177
  183. package/lib/assets/docs/article/functional-desgin-ppp/haskell/16-payroll-system.md +219 -219
  184. package/lib/assets/docs/article/functional-desgin-ppp/haskell/17-video-rental-system.md +244 -244
  185. package/lib/assets/docs/article/functional-desgin-ppp/haskell/18-concurrency-system.md +363 -363
  186. package/lib/assets/docs/article/functional-desgin-ppp/haskell/19-wator-simulation.md +438 -438
  187. package/lib/assets/docs/article/functional-desgin-ppp/haskell/20-pattern-interactions.md +325 -325
  188. package/lib/assets/docs/article/functional-desgin-ppp/haskell/21-best-practices.md +403 -403
  189. package/lib/assets/docs/article/functional-desgin-ppp/haskell/22-oo-to-fp-migration.md +469 -469
  190. package/lib/assets/docs/article/functional-desgin-ppp/haskell/index.md +174 -174
  191. package/lib/assets/docs/article/functional-desgin-ppp/index.md +90 -90
  192. package/lib/assets/docs/article/functional-desgin-ppp/rust/01-immutability-and-data-transformation.md +450 -450
  193. package/lib/assets/docs/article/functional-desgin-ppp/rust/02-function-composition.md +463 -463
  194. package/lib/assets/docs/article/functional-desgin-ppp/rust/03-polymorphism.md +425 -425
  195. package/lib/assets/docs/article/functional-desgin-ppp/rust/04-data-validation.md +273 -273
  196. package/lib/assets/docs/article/functional-desgin-ppp/rust/05-property-based-testing.md +247 -247
  197. package/lib/assets/docs/article/functional-desgin-ppp/rust/06-tdd-and-functional.md +841 -841
  198. package/lib/assets/docs/article/functional-desgin-ppp/rust/07-composite-pattern.md +384 -384
  199. package/lib/assets/docs/article/functional-desgin-ppp/rust/08-decorator-pattern.md +383 -383
  200. package/lib/assets/docs/article/functional-desgin-ppp/rust/09-adapter-pattern.md +339 -339
  201. package/lib/assets/docs/article/functional-desgin-ppp/rust/10-strategy-pattern.md +331 -331
  202. package/lib/assets/docs/article/functional-desgin-ppp/rust/11-command-pattern.md +356 -356
  203. package/lib/assets/docs/article/functional-desgin-ppp/rust/12-visitor-pattern.md +379 -379
  204. package/lib/assets/docs/article/functional-desgin-ppp/rust/13-abstract-factory-pattern.md +361 -361
  205. package/lib/assets/docs/article/functional-desgin-ppp/rust/14-abstract-server-pattern.md +392 -392
  206. package/lib/assets/docs/article/functional-desgin-ppp/rust/15-gossiping-bus-drivers.md +300 -300
  207. package/lib/assets/docs/article/functional-desgin-ppp/rust/16-payroll-system.md +297 -297
  208. package/lib/assets/docs/article/functional-desgin-ppp/rust/17-video-rental-system.md +304 -304
  209. package/lib/assets/docs/article/functional-desgin-ppp/rust/18-concurrency-system.md +315 -315
  210. package/lib/assets/docs/article/functional-desgin-ppp/rust/19-wator-simulation.md +311 -311
  211. package/lib/assets/docs/article/functional-desgin-ppp/rust/20-pattern-interactions.md +304 -304
  212. package/lib/assets/docs/article/functional-desgin-ppp/rust/21-best-practices.md +336 -336
  213. package/lib/assets/docs/article/functional-desgin-ppp/rust/22-oo-to-fp-migration.md +349 -349
  214. package/lib/assets/docs/article/functional-desgin-ppp/rust/index.md +243 -243
  215. package/lib/assets/docs/article/functional-desgin-ppp/scala/01-immutability-and-data-transformation.md +328 -328
  216. package/lib/assets/docs/article/functional-desgin-ppp/scala/02-function-composition.md +348 -348
  217. package/lib/assets/docs/article/functional-desgin-ppp/scala/03-polymorphism.md +357 -357
  218. package/lib/assets/docs/article/functional-desgin-ppp/scala/04-data-validation.md +364 -364
  219. package/lib/assets/docs/article/functional-desgin-ppp/scala/05-property-based-testing.md +515 -515
  220. package/lib/assets/docs/article/functional-desgin-ppp/scala/06-tdd-functional.md +557 -557
  221. package/lib/assets/docs/article/functional-desgin-ppp/scala/07-composite-pattern.md +363 -363
  222. package/lib/assets/docs/article/functional-desgin-ppp/scala/08-decorator-pattern.md +327 -327
  223. package/lib/assets/docs/article/functional-desgin-ppp/scala/09-adapter-pattern.md +517 -517
  224. package/lib/assets/docs/article/functional-desgin-ppp/scala/10-strategy-pattern.md +441 -441
  225. package/lib/assets/docs/article/functional-desgin-ppp/scala/11-command-pattern.md +407 -407
  226. package/lib/assets/docs/article/functional-desgin-ppp/scala/12-visitor-pattern.md +379 -379
  227. package/lib/assets/docs/article/functional-desgin-ppp/scala/13-abstract-factory-pattern.md +398 -398
  228. package/lib/assets/docs/article/functional-desgin-ppp/scala/14-abstract-server-pattern.md +476 -476
  229. package/lib/assets/docs/article/functional-desgin-ppp/scala/15-gossiping-bus-drivers.md +391 -391
  230. package/lib/assets/docs/article/functional-desgin-ppp/scala/16-payroll-system.md +342 -342
  231. package/lib/assets/docs/article/functional-desgin-ppp/scala/17-video-rental-system.md +324 -324
  232. package/lib/assets/docs/article/functional-desgin-ppp/scala/18-concurrency-system.md +730 -730
  233. package/lib/assets/docs/article/functional-desgin-ppp/scala/19-wator-simulation.md +624 -624
  234. package/lib/assets/docs/article/functional-desgin-ppp/scala/20-pattern-interactions.md +512 -512
  235. package/lib/assets/docs/article/functional-desgin-ppp/scala/21-best-practices.md +433 -433
  236. package/lib/assets/docs/article/functional-desgin-ppp/scala/22-oo-to-fp-migration.md +688 -688
  237. package/lib/assets/docs/article/functional-desgin-ppp/scala/index.md +243 -243
  238. package/lib/assets/docs/article/getting-start-docker-kubernetes/01-container-and-docker-basics.md +332 -0
  239. package/lib/assets/docs/article/getting-start-docker-kubernetes/02-container-deployment.md +776 -0
  240. package/lib/assets/docs/article/getting-start-docker-kubernetes/03-practical-container-build-deploy.md +457 -0
  241. package/lib/assets/docs/article/getting-start-docker-kubernetes/04-multi-container-application.md +869 -0
  242. package/lib/assets/docs/article/getting-start-docker-kubernetes/05-kubernetes-introduction.md +576 -0
  243. package/lib/assets/docs/article/getting-start-docker-kubernetes/06-kubernetes-deploy-cluster.md +611 -0
  244. package/lib/assets/docs/article/getting-start-docker-kubernetes/07-kubernetes-advanced.md +612 -0
  245. package/lib/assets/docs/article/getting-start-docker-kubernetes/08-kubernetes-packaging.md +509 -0
  246. package/lib/assets/docs/article/getting-start-docker-kubernetes/09-container-operations.md +537 -0
  247. package/lib/assets/docs/article/getting-start-docker-kubernetes/10-optimal-container-image.md +631 -0
  248. package/lib/assets/docs/article/getting-start-docker-kubernetes/11-continuous-delivery.md +598 -0
  249. package/lib/assets/docs/article/getting-start-docker-kubernetes/12-container-use-cases.md +454 -0
  250. package/lib/assets/docs/article/getting-start-docker-kubernetes/13-case-monolith-compose-vs-kustomize.md +337 -0
  251. package/lib/assets/docs/article/getting-start-docker-kubernetes/14-case-event-driven-kustomize-vs-helm.md +315 -0
  252. package/lib/assets/docs/article/getting-start-docker-kubernetes/15-case-escqrs-axon-kustomize-vs-helm.md +288 -0
  253. package/lib/assets/docs/article/getting-start-docker-kubernetes/16-case-escqrs-kafka-kustomize-vs-helm.md +247 -0
  254. package/lib/assets/docs/article/getting-start-docker-kubernetes/17-case-comparison-summary.md +132 -0
  255. package/lib/assets/docs/article/getting-start-docker-kubernetes/18-case-load-testing.md +294 -0
  256. package/lib/assets/docs/article/getting-start-docker-kubernetes/appendix-a-dev-tools-setup.md +265 -0
  257. package/lib/assets/docs/article/getting-start-docker-kubernetes/appendix-b-orchestration-environments.md +521 -0
  258. package/lib/assets/docs/article/getting-start-docker-kubernetes/appendix-c-tips.md +510 -0
  259. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-01-comic.png +0 -0
  260. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-02-comic.png +0 -0
  261. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-03-comic.png +0 -0
  262. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-04-comic.png +0 -0
  263. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-05-comic.png +0 -0
  264. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-06-comic.png +0 -0
  265. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-07-comic.png +0 -0
  266. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-08-comic.png +0 -0
  267. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-09-comic.png +0 -0
  268. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-10-comic.png +0 -0
  269. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-11-comic.png +0 -0
  270. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/chapter-12-comic.png +0 -0
  271. package/lib/assets/docs/article/getting-start-docker-kubernetes/images/overview-comic.png +0 -0
  272. package/lib/assets/docs/article/getting-start-docker-kubernetes/index.md +82 -0
  273. package/lib/assets/docs/article/getting-start-docker-kubernetes/outline.md +211 -0
  274. package/lib/assets/docs/article/getting-start-tdd/clojure/01-todo-list-and-first-test.md +166 -166
  275. package/lib/assets/docs/article/getting-start-tdd/clojure/02-fake-it-and-triangulation.md +162 -162
  276. package/lib/assets/docs/article/getting-start-tdd/clojure/03-obvious-implementation-and-refactoring.md +135 -135
  277. package/lib/assets/docs/article/getting-start-tdd/clojure/04-version-control-and-conventional-commits.md +88 -88
  278. package/lib/assets/docs/article/getting-start-tdd/clojure/05-package-management-and-static-analysis.md +299 -299
  279. package/lib/assets/docs/article/getting-start-tdd/clojure/06-task-runner-and-ci-cd.md +241 -241
  280. package/lib/assets/docs/article/getting-start-tdd/clojure/07-protocols-and-records.md +131 -131
  281. package/lib/assets/docs/article/getting-start-tdd/clojure/08-multimethods-and-design-patterns.md +130 -130
  282. package/lib/assets/docs/article/getting-start-tdd/clojure/09-namespaces-and-module-design.md +127 -127
  283. package/lib/assets/docs/article/getting-start-tdd/clojure/10-higher-order-functions-and-composition.md +114 -114
  284. package/lib/assets/docs/article/getting-start-tdd/clojure/11-persistent-data-and-pipeline.md +138 -138
  285. package/lib/assets/docs/article/getting-start-tdd/clojure/12-error-handling-and-spec.md +161 -161
  286. package/lib/assets/docs/article/getting-start-tdd/clojure/index.md +65 -65
  287. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter01.md +232 -232
  288. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter02.md +244 -244
  289. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter03.md +202 -202
  290. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter04.md +92 -92
  291. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter05.md +256 -256
  292. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter06.md +195 -195
  293. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter07.md +214 -214
  294. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter08.md +249 -249
  295. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter09.md +174 -174
  296. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter10.md +166 -166
  297. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter11.md +192 -192
  298. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter12.md +211 -211
  299. package/lib/assets/docs/article/getting-start-tdd/csharp/index.md +83 -83
  300. package/lib/assets/docs/article/getting-start-tdd/elixir/01-todo-list-and-first-test.md +87 -87
  301. package/lib/assets/docs/article/getting-start-tdd/elixir/02-fake-it-and-triangulation.md +95 -95
  302. package/lib/assets/docs/article/getting-start-tdd/elixir/03-obvious-implementation-and-refactoring.md +109 -109
  303. package/lib/assets/docs/article/getting-start-tdd/elixir/04-version-control-and-conventional-commits.md +96 -96
  304. package/lib/assets/docs/article/getting-start-tdd/elixir/05-package-management-and-static-analysis.md +88 -88
  305. package/lib/assets/docs/article/getting-start-tdd/elixir/06-task-runner-and-ci-cd.md +71 -71
  306. package/lib/assets/docs/article/getting-start-tdd/elixir/07-structs-and-protocols.md +110 -110
  307. package/lib/assets/docs/article/getting-start-tdd/elixir/08-pattern-matching-and-guards.md +108 -108
  308. package/lib/assets/docs/article/getting-start-tdd/elixir/09-module-design-and-behaviours.md +104 -104
  309. package/lib/assets/docs/article/getting-start-tdd/elixir/10-higher-order-functions-and-pipeline.md +178 -178
  310. package/lib/assets/docs/article/getting-start-tdd/elixir/11-stream-and-lazy-evaluation.md +142 -142
  311. package/lib/assets/docs/article/getting-start-tdd/elixir/12-error-handling-and-with.md +145 -145
  312. package/lib/assets/docs/article/getting-start-tdd/elixir/index.md +35 -35
  313. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter01.md +202 -202
  314. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter02.md +246 -246
  315. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter03.md +218 -218
  316. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter04.md +179 -179
  317. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter05.md +267 -267
  318. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter06.md +190 -190
  319. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter07.md +161 -161
  320. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter08.md +175 -175
  321. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter09.md +222 -222
  322. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter10.md +189 -189
  323. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter11.md +212 -212
  324. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter12.md +215 -215
  325. package/lib/assets/docs/article/getting-start-tdd/fsharp/index.md +71 -71
  326. package/lib/assets/docs/article/getting-start-tdd/go/01-todo-list-and-first-test.md +213 -213
  327. package/lib/assets/docs/article/getting-start-tdd/go/02-fake-it-and-triangulation.md +302 -302
  328. package/lib/assets/docs/article/getting-start-tdd/go/03-obvious-implementation-and-refactoring.md +339 -339
  329. package/lib/assets/docs/article/getting-start-tdd/go/04-version-control-and-conventional-commits.md +112 -112
  330. package/lib/assets/docs/article/getting-start-tdd/go/05-package-management-and-static-analysis.md +272 -272
  331. package/lib/assets/docs/article/getting-start-tdd/go/06-task-runner-and-ci-cd.md +233 -233
  332. package/lib/assets/docs/article/getting-start-tdd/go/07-encapsulation-and-polymorphism.md +394 -394
  333. package/lib/assets/docs/article/getting-start-tdd/go/08-design-patterns.md +422 -422
  334. package/lib/assets/docs/article/getting-start-tdd/go/09-solid-principles-and-module-design.md +400 -400
  335. package/lib/assets/docs/article/getting-start-tdd/go/10-higher-order-functions-and-composition.md +226 -226
  336. package/lib/assets/docs/article/getting-start-tdd/go/11-immutable-data-and-pipeline.md +296 -296
  337. package/lib/assets/docs/article/getting-start-tdd/go/12-error-handling-and-type-safety.md +411 -411
  338. package/lib/assets/docs/article/getting-start-tdd/go/index.md +83 -83
  339. package/lib/assets/docs/article/getting-start-tdd/haskell/01-todo-list-and-first-test.md +279 -279
  340. package/lib/assets/docs/article/getting-start-tdd/haskell/02-fake-it-and-triangulation.md +337 -337
  341. package/lib/assets/docs/article/getting-start-tdd/haskell/03-obvious-implementation-and-refactoring.md +257 -257
  342. package/lib/assets/docs/article/getting-start-tdd/haskell/04-version-control-and-conventional-commits.md +182 -182
  343. package/lib/assets/docs/article/getting-start-tdd/haskell/05-package-management-and-static-analysis.md +313 -313
  344. package/lib/assets/docs/article/getting-start-tdd/haskell/06-task-runner-and-ci-cd.md +309 -309
  345. package/lib/assets/docs/article/getting-start-tdd/haskell/07-algebraic-data-types-and-type-classes.md +412 -412
  346. package/lib/assets/docs/article/getting-start-tdd/haskell/08-pattern-matching-and-guards.md +390 -390
  347. package/lib/assets/docs/article/getting-start-tdd/haskell/09-module-design-and-smart-constructors.md +461 -461
  348. package/lib/assets/docs/article/getting-start-tdd/haskell/10-higher-order-functions-and-currying.md +434 -434
  349. package/lib/assets/docs/article/getting-start-tdd/haskell/11-function-composition-and-point-free.md +392 -392
  350. package/lib/assets/docs/article/getting-start-tdd/haskell/12-monad-and-error-handling.md +631 -631
  351. package/lib/assets/docs/article/getting-start-tdd/haskell/index.md +49 -49
  352. package/lib/assets/docs/article/getting-start-tdd/index.md +93 -93
  353. package/lib/assets/docs/article/getting-start-tdd/integration/01-language-overview.md +375 -375
  354. package/lib/assets/docs/article/getting-start-tdd/integration/02-test-framework-comparison.md +349 -349
  355. package/lib/assets/docs/article/getting-start-tdd/integration/03-tdd-pattern-comparison.md +445 -445
  356. package/lib/assets/docs/article/getting-start-tdd/integration/04-type-system-comparison.md +409 -409
  357. package/lib/assets/docs/article/getting-start-tdd/integration/05-dev-environment-comparison.md +330 -330
  358. package/lib/assets/docs/article/getting-start-tdd/integration/06-learning-roadmap.md +290 -290
  359. package/lib/assets/docs/article/getting-start-tdd/integration/index.md +69 -69
  360. package/lib/assets/docs/article/getting-start-tdd/java/01-todo-list-and-first-test.md +234 -234
  361. package/lib/assets/docs/article/getting-start-tdd/java/02-fake-it-and-triangulation.md +261 -261
  362. package/lib/assets/docs/article/getting-start-tdd/java/03-obvious-implementation-and-refactoring.md +185 -185
  363. package/lib/assets/docs/article/getting-start-tdd/java/04-version-control-and-conventional-commits.md +115 -115
  364. package/lib/assets/docs/article/getting-start-tdd/java/05-package-management-and-static-analysis.md +382 -382
  365. package/lib/assets/docs/article/getting-start-tdd/java/06-task-runner-and-ci-cd.md +272 -272
  366. package/lib/assets/docs/article/getting-start-tdd/java/07-encapsulation-and-polymorphism.md +626 -626
  367. package/lib/assets/docs/article/getting-start-tdd/java/08-design-patterns.md +393 -393
  368. package/lib/assets/docs/article/getting-start-tdd/java/09-solid-principles-and-module-design.md +310 -310
  369. package/lib/assets/docs/article/getting-start-tdd/java/10-higher-order-functions-and-composition.md +188 -188
  370. package/lib/assets/docs/article/getting-start-tdd/java/11-immutable-data-and-pipeline.md +167 -167
  371. package/lib/assets/docs/article/getting-start-tdd/java/12-error-handling-and-type-safety.md +205 -205
  372. package/lib/assets/docs/article/getting-start-tdd/java/index.md +61 -61
  373. package/lib/assets/docs/article/getting-start-tdd/node/01-todo-list-and-first-test.md +244 -244
  374. package/lib/assets/docs/article/getting-start-tdd/node/02-fake-it-and-triangulation.md +262 -262
  375. package/lib/assets/docs/article/getting-start-tdd/node/03-obvious-implementation-and-refactoring.md +169 -169
  376. package/lib/assets/docs/article/getting-start-tdd/node/04-version-control-and-conventional-commits.md +112 -112
  377. package/lib/assets/docs/article/getting-start-tdd/node/05-package-management-and-static-analysis.md +314 -314
  378. package/lib/assets/docs/article/getting-start-tdd/node/06-task-runner-and-ci-cd.md +235 -235
  379. package/lib/assets/docs/article/getting-start-tdd/node/07-encapsulation-and-polymorphism.md +327 -327
  380. package/lib/assets/docs/article/getting-start-tdd/node/08-design-patterns.md +322 -322
  381. package/lib/assets/docs/article/getting-start-tdd/node/09-solid-principles-and-module-design.md +285 -285
  382. package/lib/assets/docs/article/getting-start-tdd/node/10-higher-order-functions-and-composition.md +199 -199
  383. package/lib/assets/docs/article/getting-start-tdd/node/11-immutable-data-and-pipeline.md +207 -207
  384. package/lib/assets/docs/article/getting-start-tdd/node/12-error-handling-and-type-safety.md +295 -295
  385. package/lib/assets/docs/article/getting-start-tdd/node/index.md +56 -56
  386. package/lib/assets/docs/article/getting-start-tdd/php/01-todo-list-and-first-test.md +259 -259
  387. package/lib/assets/docs/article/getting-start-tdd/php/02-fake-it-and-triangulation.md +200 -200
  388. package/lib/assets/docs/article/getting-start-tdd/php/03-obvious-implementation-and-refactoring.md +248 -248
  389. package/lib/assets/docs/article/getting-start-tdd/php/04-version-control-and-conventional-commits.md +141 -141
  390. package/lib/assets/docs/article/getting-start-tdd/php/05-package-management-and-static-analysis.md +410 -410
  391. package/lib/assets/docs/article/getting-start-tdd/php/06-task-runner-and-ci-cd.md +321 -321
  392. package/lib/assets/docs/article/getting-start-tdd/php/07-encapsulation-and-polymorphism.md +372 -372
  393. package/lib/assets/docs/article/getting-start-tdd/php/08-design-patterns.md +453 -453
  394. package/lib/assets/docs/article/getting-start-tdd/php/09-solid-principles-and-module-design.md +460 -460
  395. package/lib/assets/docs/article/getting-start-tdd/php/10-higher-order-functions-and-composition.md +182 -182
  396. package/lib/assets/docs/article/getting-start-tdd/php/11-immutable-data-and-pipeline.md +266 -266
  397. package/lib/assets/docs/article/getting-start-tdd/php/12-error-handling-and-type-safety.md +308 -308
  398. package/lib/assets/docs/article/getting-start-tdd/php/index.md +84 -84
  399. package/lib/assets/docs/article/getting-start-tdd/python/01-todo-list-and-first-test.md +201 -201
  400. package/lib/assets/docs/article/getting-start-tdd/python/02-fake-it-and-triangulation.md +247 -247
  401. package/lib/assets/docs/article/getting-start-tdd/python/03-obvious-implementation-and-refactoring.md +199 -199
  402. package/lib/assets/docs/article/getting-start-tdd/python/04-version-control-and-conventional-commits.md +87 -87
  403. package/lib/assets/docs/article/getting-start-tdd/python/05-package-management-and-static-analysis.md +274 -274
  404. package/lib/assets/docs/article/getting-start-tdd/python/06-task-runner-and-ci-cd.md +190 -190
  405. package/lib/assets/docs/article/getting-start-tdd/python/07-encapsulation-and-polymorphism.md +208 -208
  406. package/lib/assets/docs/article/getting-start-tdd/python/08-design-patterns.md +172 -172
  407. package/lib/assets/docs/article/getting-start-tdd/python/09-solid-principles-and-module-design.md +130 -130
  408. package/lib/assets/docs/article/getting-start-tdd/python/10-higher-order-functions-and-composition.md +122 -122
  409. package/lib/assets/docs/article/getting-start-tdd/python/11-immutable-data-and-pipeline.md +116 -116
  410. package/lib/assets/docs/article/getting-start-tdd/python/12-error-handling-and-type-safety.md +126 -126
  411. package/lib/assets/docs/article/getting-start-tdd/python/index.md +55 -55
  412. package/lib/assets/docs/article/getting-start-tdd/ruby/01-todo-list-and-first-test.md +231 -231
  413. package/lib/assets/docs/article/getting-start-tdd/ruby/02-fake-it-and-triangulation.md +238 -238
  414. package/lib/assets/docs/article/getting-start-tdd/ruby/03-obvious-implementation-and-refactoring.md +228 -228
  415. package/lib/assets/docs/article/getting-start-tdd/ruby/04-version-control-and-conventional-commits.md +112 -112
  416. package/lib/assets/docs/article/getting-start-tdd/ruby/05-package-management-and-static-analysis.md +287 -287
  417. package/lib/assets/docs/article/getting-start-tdd/ruby/06-task-runner-and-ci-cd.md +248 -248
  418. package/lib/assets/docs/article/getting-start-tdd/ruby/07-encapsulation-and-polymorphism.md +279 -279
  419. package/lib/assets/docs/article/getting-start-tdd/ruby/08-design-patterns.md +329 -329
  420. package/lib/assets/docs/article/getting-start-tdd/ruby/09-solid-principles-and-module-design.md +196 -196
  421. package/lib/assets/docs/article/getting-start-tdd/ruby/10-higher-order-functions-and-composition.md +175 -175
  422. package/lib/assets/docs/article/getting-start-tdd/ruby/11-immutable-data-and-pipeline.md +237 -237
  423. package/lib/assets/docs/article/getting-start-tdd/ruby/12-error-handling-and-type-safety.md +398 -398
  424. package/lib/assets/docs/article/getting-start-tdd/ruby/index.md +83 -83
  425. package/lib/assets/docs/article/getting-start-tdd/rust/01-todo-list-and-first-test.md +211 -211
  426. package/lib/assets/docs/article/getting-start-tdd/rust/02-fake-it-and-triangulation.md +264 -264
  427. package/lib/assets/docs/article/getting-start-tdd/rust/03-obvious-implementation-and-refactoring.md +233 -233
  428. package/lib/assets/docs/article/getting-start-tdd/rust/04-version-control-and-conventional-commits.md +92 -92
  429. package/lib/assets/docs/article/getting-start-tdd/rust/05-package-management-and-static-analysis.md +212 -212
  430. package/lib/assets/docs/article/getting-start-tdd/rust/06-task-runner-and-ci-cd.md +164 -164
  431. package/lib/assets/docs/article/getting-start-tdd/rust/07-encapsulation-and-polymorphism.md +142 -142
  432. package/lib/assets/docs/article/getting-start-tdd/rust/08-design-patterns.md +145 -145
  433. package/lib/assets/docs/article/getting-start-tdd/rust/09-solid-principles-and-module-design.md +110 -110
  434. package/lib/assets/docs/article/getting-start-tdd/rust/10-higher-order-functions-and-composition.md +94 -94
  435. package/lib/assets/docs/article/getting-start-tdd/rust/11-immutable-data-and-pipeline.md +105 -105
  436. package/lib/assets/docs/article/getting-start-tdd/rust/12-error-handling-and-type-safety.md +112 -112
  437. package/lib/assets/docs/article/getting-start-tdd/rust/index.md +83 -83
  438. package/lib/assets/docs/article/getting-start-tdd/scala/01-todo-list-and-first-test.md +111 -111
  439. package/lib/assets/docs/article/getting-start-tdd/scala/02-fake-it-and-triangulation.md +107 -107
  440. package/lib/assets/docs/article/getting-start-tdd/scala/03-obvious-implementation-and-refactoring.md +99 -99
  441. package/lib/assets/docs/article/getting-start-tdd/scala/04-version-control-and-conventional-commits.md +123 -123
  442. package/lib/assets/docs/article/getting-start-tdd/scala/05-package-management-and-static-analysis.md +196 -196
  443. package/lib/assets/docs/article/getting-start-tdd/scala/06-task-runner-and-ci-cd.md +186 -186
  444. package/lib/assets/docs/article/getting-start-tdd/scala/07-case-classes-and-traits.md +139 -139
  445. package/lib/assets/docs/article/getting-start-tdd/scala/08-pattern-matching-and-sealed-traits.md +106 -106
  446. package/lib/assets/docs/article/getting-start-tdd/scala/09-packages-and-module-design.md +75 -75
  447. package/lib/assets/docs/article/getting-start-tdd/scala/10-higher-order-functions-and-composition.md +104 -104
  448. package/lib/assets/docs/article/getting-start-tdd/scala/11-collections-and-lazy-evaluation.md +94 -94
  449. package/lib/assets/docs/article/getting-start-tdd/scala/12-error-handling-and-type-safety.md +92 -92
  450. package/lib/assets/docs/article/getting-start-tdd/scala/index.md +65 -65
  451. package/lib/assets/docs/article/grokking-concurrency/all/index.md +404 -404
  452. package/lib/assets/docs/article/grokking-concurrency/all/part-1-ch02-sequential.md +554 -554
  453. package/lib/assets/docs/article/grokking-concurrency/all/part-2-ch04-05-threads.md +469 -469
  454. package/lib/assets/docs/article/grokking-concurrency/all/part-3-ch06-multitasking.md +520 -520
  455. package/lib/assets/docs/article/grokking-concurrency/all/part-4-ch07-parallel-patterns.md +420 -420
  456. package/lib/assets/docs/article/grokking-concurrency/all/part-5-ch08-09-synchronization.md +510 -510
  457. package/lib/assets/docs/article/grokking-concurrency/all/part-6-ch10-11-nonblocking-io.md +435 -435
  458. package/lib/assets/docs/article/grokking-concurrency/all/part-7-ch12-async.md +465 -465
  459. package/lib/assets/docs/article/grokking-concurrency/all/part-8-ch13-mapreduce.md +377 -377
  460. package/lib/assets/docs/article/grokking-concurrency/clojure/index.md +116 -116
  461. package/lib/assets/docs/article/grokking-concurrency/clojure/part-1.md +108 -108
  462. package/lib/assets/docs/article/grokking-concurrency/clojure/part-2.md +101 -101
  463. package/lib/assets/docs/article/grokking-concurrency/clojure/part-3.md +122 -122
  464. package/lib/assets/docs/article/grokking-concurrency/clojure/part-4.md +123 -123
  465. package/lib/assets/docs/article/grokking-concurrency/clojure/part-5.md +118 -118
  466. package/lib/assets/docs/article/grokking-concurrency/clojure/part-6.md +89 -89
  467. package/lib/assets/docs/article/grokking-concurrency/clojure/part-7.md +100 -100
  468. package/lib/assets/docs/article/grokking-concurrency/clojure/part-8.md +120 -120
  469. package/lib/assets/docs/article/grokking-concurrency/csharp/index.md +101 -101
  470. package/lib/assets/docs/article/grokking-concurrency/csharp/part-1.md +97 -97
  471. package/lib/assets/docs/article/grokking-concurrency/csharp/part-2.md +123 -123
  472. package/lib/assets/docs/article/grokking-concurrency/csharp/part-3.md +101 -101
  473. package/lib/assets/docs/article/grokking-concurrency/csharp/part-4.md +112 -112
  474. package/lib/assets/docs/article/grokking-concurrency/csharp/part-5.md +99 -99
  475. package/lib/assets/docs/article/grokking-concurrency/csharp/part-6.md +61 -61
  476. package/lib/assets/docs/article/grokking-concurrency/csharp/part-7.md +84 -84
  477. package/lib/assets/docs/article/grokking-concurrency/csharp/part-8.md +92 -92
  478. package/lib/assets/docs/article/grokking-concurrency/fsharp/index.md +65 -65
  479. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-1.md +80 -80
  480. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-2.md +103 -103
  481. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-3.md +94 -94
  482. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-4.md +110 -110
  483. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-5.md +104 -104
  484. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-6.md +93 -93
  485. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-7.md +121 -121
  486. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-8.md +107 -107
  487. package/lib/assets/docs/article/grokking-concurrency/haskell/index.md +248 -248
  488. package/lib/assets/docs/article/grokking-concurrency/haskell/part-1.md +96 -96
  489. package/lib/assets/docs/article/grokking-concurrency/haskell/part-2.md +96 -96
  490. package/lib/assets/docs/article/grokking-concurrency/haskell/part-3.md +91 -91
  491. package/lib/assets/docs/article/grokking-concurrency/haskell/part-4.md +106 -106
  492. package/lib/assets/docs/article/grokking-concurrency/haskell/part-5.md +99 -99
  493. package/lib/assets/docs/article/grokking-concurrency/haskell/part-6.md +95 -95
  494. package/lib/assets/docs/article/grokking-concurrency/haskell/part-7.md +111 -111
  495. package/lib/assets/docs/article/grokking-concurrency/haskell/part-8.md +118 -118
  496. package/lib/assets/docs/article/grokking-concurrency/index.md +66 -66
  497. package/lib/assets/docs/article/grokking-concurrency/java/index.md +102 -102
  498. package/lib/assets/docs/article/grokking-concurrency/java/part-1.md +308 -308
  499. package/lib/assets/docs/article/grokking-concurrency/java/part-2.md +334 -334
  500. package/lib/assets/docs/article/grokking-concurrency/java/part-3.md +221 -221
  501. package/lib/assets/docs/article/grokking-concurrency/java/part-4.md +213 -213
  502. package/lib/assets/docs/article/grokking-concurrency/java/part-5.md +112 -112
  503. package/lib/assets/docs/article/grokking-concurrency/java/part-6.md +69 -69
  504. package/lib/assets/docs/article/grokking-concurrency/java/part-7.md +101 -101
  505. package/lib/assets/docs/article/grokking-concurrency/java/part-8.md +101 -101
  506. package/lib/assets/docs/article/grokking-concurrency/python/index.md +313 -313
  507. package/lib/assets/docs/article/grokking-concurrency/python/part-1.md +239 -239
  508. package/lib/assets/docs/article/grokking-concurrency/python/part-2.md +418 -418
  509. package/lib/assets/docs/article/grokking-concurrency/python/part-3.md +227 -227
  510. package/lib/assets/docs/article/grokking-concurrency/python/part-4.md +299 -299
  511. package/lib/assets/docs/article/grokking-concurrency/python/part-5.md +315 -315
  512. package/lib/assets/docs/article/grokking-concurrency/python/part-6.md +297 -297
  513. package/lib/assets/docs/article/grokking-concurrency/python/part-7.md +314 -314
  514. package/lib/assets/docs/article/grokking-concurrency/python/part-8.md +360 -360
  515. package/lib/assets/docs/article/grokking-concurrency/rust/index.md +270 -270
  516. package/lib/assets/docs/article/grokking-concurrency/rust/part-1.md +108 -108
  517. package/lib/assets/docs/article/grokking-concurrency/rust/part-2.md +120 -120
  518. package/lib/assets/docs/article/grokking-concurrency/rust/part-3.md +126 -126
  519. package/lib/assets/docs/article/grokking-concurrency/rust/part-4.md +175 -175
  520. package/lib/assets/docs/article/grokking-concurrency/rust/part-5.md +158 -158
  521. package/lib/assets/docs/article/grokking-concurrency/rust/part-6.md +94 -94
  522. package/lib/assets/docs/article/grokking-concurrency/rust/part-7.md +133 -133
  523. package/lib/assets/docs/article/grokking-concurrency/rust/part-8.md +155 -155
  524. package/lib/assets/docs/article/grokking-concurrency/scala/index.md +69 -69
  525. package/lib/assets/docs/article/grokking-concurrency/scala/part-1.md +78 -78
  526. package/lib/assets/docs/article/grokking-concurrency/scala/part-2.md +112 -112
  527. package/lib/assets/docs/article/grokking-concurrency/scala/part-3.md +93 -93
  528. package/lib/assets/docs/article/grokking-concurrency/scala/part-4.md +110 -110
  529. package/lib/assets/docs/article/grokking-concurrency/scala/part-5.md +119 -119
  530. package/lib/assets/docs/article/grokking-concurrency/scala/part-6.md +83 -83
  531. package/lib/assets/docs/article/grokking-concurrency/scala/part-7.md +131 -131
  532. package/lib/assets/docs/article/grokking-concurrency/scala/part-8.md +129 -129
  533. package/lib/assets/docs/article/grokkingfp/all/index.md +368 -368
  534. package/lib/assets/docs/article/grokkingfp/all/part-1-ch01-fp-introduction.md +530 -530
  535. package/lib/assets/docs/article/grokkingfp/all/part-1-ch02-pure-functions.md +923 -923
  536. package/lib/assets/docs/article/grokkingfp/all/part-2-ch03-immutable-data.md +1128 -1128
  537. package/lib/assets/docs/article/grokkingfp/all/part-2-ch04-higher-order-functions.md +1104 -1104
  538. package/lib/assets/docs/article/grokkingfp/all/part-2-ch05-flatmap.md +1026 -1026
  539. package/lib/assets/docs/article/grokkingfp/all/part-3-ch06-option.md +785 -785
  540. package/lib/assets/docs/article/grokkingfp/all/part-3-ch07-either-adt.md +871 -871
  541. package/lib/assets/docs/article/grokkingfp/all/part-4-ch08-io-monad.md +972 -972
  542. package/lib/assets/docs/article/grokkingfp/all/part-4-ch09-streams.md +926 -926
  543. package/lib/assets/docs/article/grokkingfp/all/part-5-ch10-concurrency.md +870 -870
  544. package/lib/assets/docs/article/grokkingfp/all/part-6-ch11-application.md +715 -715
  545. package/lib/assets/docs/article/grokkingfp/all/part-6-ch12-testing.md +626 -626
  546. package/lib/assets/docs/article/grokkingfp/all/writing-plan.md +712 -712
  547. package/lib/assets/docs/article/grokkingfp/clojure/index.md +276 -276
  548. package/lib/assets/docs/article/grokkingfp/clojure/part-1.md +667 -667
  549. package/lib/assets/docs/article/grokkingfp/clojure/part-2.md +643 -643
  550. package/lib/assets/docs/article/grokkingfp/clojure/part-3.md +620 -620
  551. package/lib/assets/docs/article/grokkingfp/clojure/part-4.md +697 -697
  552. package/lib/assets/docs/article/grokkingfp/clojure/part-5.md +751 -751
  553. package/lib/assets/docs/article/grokkingfp/clojure/part-6.md +721 -721
  554. package/lib/assets/docs/article/grokkingfp/csharp/index.md +246 -246
  555. package/lib/assets/docs/article/grokkingfp/csharp/part-1.md +811 -811
  556. package/lib/assets/docs/article/grokkingfp/csharp/part-2.md +971 -971
  557. package/lib/assets/docs/article/grokkingfp/csharp/part-3.md +981 -981
  558. package/lib/assets/docs/article/grokkingfp/csharp/part-4.md +949 -949
  559. package/lib/assets/docs/article/grokkingfp/csharp/part-5.md +947 -947
  560. package/lib/assets/docs/article/grokkingfp/csharp/part-6.md +739 -739
  561. package/lib/assets/docs/article/grokkingfp/elixir/index.md +203 -203
  562. package/lib/assets/docs/article/grokkingfp/elixir/part-1.md +712 -712
  563. package/lib/assets/docs/article/grokkingfp/elixir/part-2.md +838 -838
  564. package/lib/assets/docs/article/grokkingfp/elixir/part-3.md +985 -985
  565. package/lib/assets/docs/article/grokkingfp/elixir/part-4.md +974 -974
  566. package/lib/assets/docs/article/grokkingfp/elixir/part-5.md +1286 -1286
  567. package/lib/assets/docs/article/grokkingfp/elixir/part-6.md +1049 -1049
  568. package/lib/assets/docs/article/grokkingfp/fsharp/index.md +210 -210
  569. package/lib/assets/docs/article/grokkingfp/fsharp/part-1.md +714 -714
  570. package/lib/assets/docs/article/grokkingfp/fsharp/part-2.md +961 -961
  571. package/lib/assets/docs/article/grokkingfp/fsharp/part-3.md +972 -972
  572. package/lib/assets/docs/article/grokkingfp/fsharp/part-4.md +832 -832
  573. package/lib/assets/docs/article/grokkingfp/fsharp/part-5.md +911 -911
  574. package/lib/assets/docs/article/grokkingfp/fsharp/part-6.md +922 -922
  575. package/lib/assets/docs/article/grokkingfp/haskell/index.md +234 -234
  576. package/lib/assets/docs/article/grokkingfp/haskell/part-1.md +591 -591
  577. package/lib/assets/docs/article/grokkingfp/haskell/part-2.md +866 -866
  578. package/lib/assets/docs/article/grokkingfp/haskell/part-3.md +915 -915
  579. package/lib/assets/docs/article/grokkingfp/haskell/part-4.md +878 -878
  580. package/lib/assets/docs/article/grokkingfp/haskell/part-5.md +845 -845
  581. package/lib/assets/docs/article/grokkingfp/haskell/part-6.md +844 -844
  582. package/lib/assets/docs/article/grokkingfp/index.md +143 -143
  583. package/lib/assets/docs/article/grokkingfp/java/index.md +211 -211
  584. package/lib/assets/docs/article/grokkingfp/java/part-1.md +648 -648
  585. package/lib/assets/docs/article/grokkingfp/java/part-2.md +675 -675
  586. package/lib/assets/docs/article/grokkingfp/java/part-3.md +672 -672
  587. package/lib/assets/docs/article/grokkingfp/java/part-4.md +771 -771
  588. package/lib/assets/docs/article/grokkingfp/java/part-5.md +959 -959
  589. package/lib/assets/docs/article/grokkingfp/java/part-6.md +1328 -1328
  590. package/lib/assets/docs/article/grokkingfp/python/index.md +258 -258
  591. package/lib/assets/docs/article/grokkingfp/python/part-1.md +443 -443
  592. package/lib/assets/docs/article/grokkingfp/python/part-2.md +958 -958
  593. package/lib/assets/docs/article/grokkingfp/python/part-3.md +1004 -1004
  594. package/lib/assets/docs/article/grokkingfp/python/part-4.md +765 -765
  595. package/lib/assets/docs/article/grokkingfp/python/part-5.md +747 -747
  596. package/lib/assets/docs/article/grokkingfp/python/part-6.md +861 -861
  597. package/lib/assets/docs/article/grokkingfp/ruby/index.md +330 -330
  598. package/lib/assets/docs/article/grokkingfp/ruby/part-1.md +755 -755
  599. package/lib/assets/docs/article/grokkingfp/ruby/part-2.md +938 -938
  600. package/lib/assets/docs/article/grokkingfp/ruby/part-3.md +946 -946
  601. package/lib/assets/docs/article/grokkingfp/ruby/part-4.md +921 -921
  602. package/lib/assets/docs/article/grokkingfp/ruby/part-5.md +908 -908
  603. package/lib/assets/docs/article/grokkingfp/ruby/part-6.md +1412 -1412
  604. package/lib/assets/docs/article/grokkingfp/rust/index.md +242 -242
  605. package/lib/assets/docs/article/grokkingfp/rust/part-1.md +634 -634
  606. package/lib/assets/docs/article/grokkingfp/rust/part-2.md +1060 -1060
  607. package/lib/assets/docs/article/grokkingfp/rust/part-3.md +994 -994
  608. package/lib/assets/docs/article/grokkingfp/rust/part-4.md +573 -573
  609. package/lib/assets/docs/article/grokkingfp/rust/part-5.md +705 -705
  610. package/lib/assets/docs/article/grokkingfp/rust/part-6.md +508 -508
  611. package/lib/assets/docs/article/grokkingfp/scala/index.md +171 -171
  612. package/lib/assets/docs/article/grokkingfp/scala/part-1.md +543 -543
  613. package/lib/assets/docs/article/grokkingfp/scala/part-2.md +946 -946
  614. package/lib/assets/docs/article/grokkingfp/scala/part-3.md +919 -919
  615. package/lib/assets/docs/article/grokkingfp/scala/part-4.md +742 -742
  616. package/lib/assets/docs/article/grokkingfp/scala/part-5.md +722 -722
  617. package/lib/assets/docs/article/grokkingfp/scala/part-6.md +867 -867
  618. package/lib/assets/docs/article/grokkingfp/typescript/index.md +273 -273
  619. package/lib/assets/docs/article/grokkingfp/typescript/part-1.md +561 -561
  620. package/lib/assets/docs/article/grokkingfp/typescript/part-2.md +1129 -1129
  621. package/lib/assets/docs/article/grokkingfp/typescript/part-3.md +842 -842
  622. package/lib/assets/docs/article/grokkingfp/typescript/part-4.md +1087 -1087
  623. package/lib/assets/docs/article/grokkingfp/typescript/part-5.md +717 -717
  624. package/lib/assets/docs/article/grokkingfp/typescript/part-6.md +982 -982
  625. package/lib/assets/docs/article/index.md +41 -39
  626. package/lib/assets/docs/article/practical-database-design/index.md +121 -121
  627. package/lib/assets/docs/article/practical-database-design/part1/chapter01.md +288 -288
  628. package/lib/assets/docs/article/practical-database-design/part1/chapter02.md +518 -518
  629. package/lib/assets/docs/article/practical-database-design/part1/chapter03.md +557 -557
  630. package/lib/assets/docs/article/practical-database-design/part2/chapter04.md +924 -924
  631. package/lib/assets/docs/article/practical-database-design/part2/chapter05.md +1627 -1627
  632. package/lib/assets/docs/article/practical-database-design/part2/chapter06.md +2716 -2716
  633. package/lib/assets/docs/article/practical-database-design/part2/chapter07.md +2082 -2082
  634. package/lib/assets/docs/article/practical-database-design/part2/chapter08.md +2105 -2105
  635. package/lib/assets/docs/article/practical-database-design/part2/chapter09.md +2031 -2031
  636. package/lib/assets/docs/article/practical-database-design/part2/chapter10.md +1387 -1387
  637. package/lib/assets/docs/article/practical-database-design/part2/chapter11.md +1677 -1677
  638. package/lib/assets/docs/article/practical-database-design/part2/chapter12.md +1417 -1417
  639. package/lib/assets/docs/article/practical-database-design/part2/chapter13.md +1434 -1434
  640. package/lib/assets/docs/article/practical-database-design/part3/chapter14.md +667 -667
  641. package/lib/assets/docs/article/practical-database-design/part3/chapter15.md +1625 -1625
  642. package/lib/assets/docs/article/practical-database-design/part3/chapter16.md +1915 -1915
  643. package/lib/assets/docs/article/practical-database-design/part3/chapter17.md +1708 -1708
  644. package/lib/assets/docs/article/practical-database-design/part3/chapter18.md +2095 -2095
  645. package/lib/assets/docs/article/practical-database-design/part3/chapter19.md +1123 -1123
  646. package/lib/assets/docs/article/practical-database-design/part3/chapter20.md +1031 -1031
  647. package/lib/assets/docs/article/practical-database-design/part3/chapter21.md +1382 -1382
  648. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter14-orm.md +991 -991
  649. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter15-orm.md +1300 -1300
  650. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter16-orm.md +1166 -1166
  651. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter17-orm.md +1584 -1584
  652. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter18-orm.md +1183 -1183
  653. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter19-orm.md +1016 -1016
  654. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter20-orm.md +1753 -1753
  655. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter21-orm.md +1447 -1447
  656. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter22-orm.md +1878 -1878
  657. package/lib/assets/docs/article/practical-database-design/part4/chapter22.md +965 -965
  658. package/lib/assets/docs/article/practical-database-design/part4/chapter23.md +2069 -2069
  659. package/lib/assets/docs/article/practical-database-design/part4/chapter24.md +2439 -2439
  660. package/lib/assets/docs/article/practical-database-design/part4/chapter25.md +3661 -3661
  661. package/lib/assets/docs/article/practical-database-design/part4/chapter26.md +2916 -2916
  662. package/lib/assets/docs/article/practical-database-design/part4/chapter27.md +3105 -3105
  663. package/lib/assets/docs/article/practical-database-design/part4/chapter28.md +2697 -2697
  664. package/lib/assets/docs/article/practical-database-design/part4/chapter29.md +2544 -2544
  665. package/lib/assets/docs/article/practical-database-design/part4/chapter30.md +2180 -2180
  666. package/lib/assets/docs/article/practical-database-design/part4/chapter31.md +1192 -1192
  667. package/lib/assets/docs/article/practical-database-design/part4/chapter32.md +2101 -2101
  668. package/lib/assets/docs/article/practical-database-design/part5/chapter33.md +1032 -1032
  669. package/lib/assets/docs/article/practical-database-design/part5/chapter34.md +1609 -1609
  670. package/lib/assets/docs/article/practical-database-design/part5/chapter35.md +1453 -1453
  671. package/lib/assets/docs/article/practical-database-design/part5/chapter36.md +1292 -1292
  672. package/lib/assets/docs/article/practical-database-design/part5/chapter37.md +1470 -1470
  673. package/lib/assets/docs/article/practical-database-design/part5/chapter38.md +1698 -1698
  674. package/lib/assets/docs/article/practical-database-design/part5/chapter39.md +2334 -2334
  675. package/lib/assets/docs/article/practical-database-design/study/study2-1.md +1693 -1693
  676. package/lib/assets/docs/article/practical-database-design/study/study2-2.md +1347 -1347
  677. package/lib/assets/docs/article/practical-database-design/study/study2-3.md +2044 -2044
  678. package/lib/assets/docs/article/practical-database-design/study/study2-4.md +2229 -2229
  679. package/lib/assets/docs/article/practical-database-design/study/study2-5.md +2418 -2418
  680. package/lib/assets/docs/article/practical-database-design/study/study3-1.md +2205 -2205
  681. package/lib/assets/docs/article/practical-database-design/study/study3-2.md +2221 -2221
  682. package/lib/assets/docs/article/practical-database-design/study/study3-3.md +2253 -2253
  683. package/lib/assets/docs/article/practical-database-design/study/study3-4.md +2106 -2106
  684. package/lib/assets/docs/article/practical-database-design/study/study3-5.md +2507 -2507
  685. package/lib/assets/docs/article/practical-database-design/study/study4-1.md +2587 -2587
  686. package/lib/assets/docs/article/practical-database-design/study/study4-2.md +2075 -2075
  687. package/lib/assets/docs/article/practical-database-design/study/study4-3.md +1805 -1805
  688. package/lib/assets/docs/article/practical-database-design/study/study4-4.md +1895 -1895
  689. package/lib/assets/docs/article/practical-database-design/study/study4-5.md +2878 -2878
  690. package/lib/assets/docs/assets/css/extra.css +29 -29
  691. package/lib/assets/docs/assets/js/extra.js +44 -44
  692. package/lib/assets/docs/design/index.md +44 -44
  693. package/lib/assets/docs/development/index.md +39 -39
  694. package/lib/assets/docs/index.md +33 -33
  695. package/lib/assets/docs/operation/index.md +27 -27
  696. package/lib/assets/docs/reference/CodexCLIMCP/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/343/203/225/343/203/255/343/203/274.md +546 -546
  697. package/lib/assets/docs/reference/CodexCLIMCP/343/202/265/343/203/274/343/203/220/343/203/274/350/250/255/345/256/232/346/211/213/351/240/206.md +341 -341
  698. package/lib/assets/docs/reference/Java/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +581 -581
  699. package/lib/assets/docs/reference/SonarQube/343/203/255/343/203/274/343/202/253/343/203/253/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +642 -642
  700. package/lib/assets/docs/reference/TypeScript/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +465 -465
  701. package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +450 -450
  702. package/lib/assets/docs/reference/images/Ansoff.drawio.svg +3 -3
  703. package/lib/assets/docs/reference/images/BMC.drawio.svg +3 -3
  704. package/lib/assets/docs/reference/images/BrandBasicStrategy.drawio.svg +3 -3
  705. package/lib/assets/docs/reference/images/BrandCategorization.drawio.svg +3 -3
  706. package/lib/assets/docs/reference/images/BrandRecurutementStrategy.drawio.svg +3 -3
  707. package/lib/assets/docs/reference/images/BrandValue.drawio.svg +3 -3
  708. package/lib/assets/docs/reference/images/BusinessActivitiy.svg +3 -3
  709. package/lib/assets/docs/reference/images/HRM.drawio.svg +3 -3
  710. package/lib/assets/docs/reference/images/MarketingStructure.drawio.svg +3 -3
  711. package/lib/assets/docs/reference/images/OrganizationElemnts.svg +3 -3
  712. package/lib/assets/docs/reference/images/PPM.drawio.svg +3 -3
  713. package/lib/assets/docs/reference/images/PositioningMap.drawio.svg +3 -3
  714. package/lib/assets/docs/reference/images/ProductLayer.drawio.svg +3 -3
  715. package/lib/assets/docs/reference/images/ProductMix.drawio.svg +3 -3
  716. package/lib/assets/docs/reference/images/SWOT.drawio.svg +3 -3
  717. package/lib/assets/docs/reference/images/TargetMarket.drawio.svg +3 -3
  718. package/lib/assets/docs/reference/images/ThreeGenericStrategies.drawio.svg +3 -3
  719. package/lib/assets/docs/reference/images/VRIO.drawio.svg +3 -3
  720. package/lib/assets/docs/reference/images/ValueChain.drawio.svg +3 -3
  721. package/lib/assets/docs/reference/index.md +53 -53
  722. package/lib/assets/docs/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md +250 -250
  723. package/lib/assets/docs/reference//343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +2216 -2216
  724. package/lib/assets/docs/reference//343/202/244/343/203/263/343/203/225/343/203/251/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +1878 -1878
  725. package/lib/assets/docs/reference//343/202/250/343/202/257/343/202/271/343/203/210/343/203/252/343/203/274/343/203/240/343/203/227/343/203/255/343/202/260/343/203/251/343/203/237/343/203/263/343/202/260.md +550 -550
  726. package/lib/assets/docs/reference//343/202/263/343/203/274/343/203/207/343/202/243/343/203/263/343/202/260/343/201/250/343/203/206/343/202/271/343/203/210/343/202/254/343/202/244/343/203/211.md +705 -705
  727. package/lib/assets/docs/reference//343/203/206/343/202/271/343/203/210/346/210/246/347/225/245/343/202/254/343/202/244/343/203/211.md +1313 -1313
  728. package/lib/assets/docs/reference//343/203/207/343/203/274/343/202/277/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +311 -311
  729. package/lib/assets/docs/reference//343/203/211/343/203/241/343/202/244/343/203/263/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +599 -599
  730. package/lib/assets/docs/reference//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +528 -528
  731. package/lib/assets/docs/reference//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +689 -689
  732. package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/202/254/343/202/244/343/203/211.md +461 -461
  733. package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/203/273/343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273/343/202/254/343/202/244/343/203/211.md +580 -580
  734. package/lib/assets/docs/reference//343/203/255/343/202/270/343/202/253/343/203/253/343/202/267/343/203/263/343/202/255/343/203/263/343/202/260.md +1367 -1367
  735. package/lib/assets/docs/reference//344/274/201/346/245/255/347/265/214/345/226/266/350/253/226.md +2637 -2637
  736. package/lib/assets/docs/reference//347/222/260/345/242/203/345/244/211/346/225/260/347/256/241/347/220/206/343/202/254/343/202/244/343/203/211.md +665 -665
  737. package/lib/assets/docs/reference//347/265/214/345/226/266/346/210/246/347/225/245/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +566 -566
  738. package/lib/assets/docs/reference//350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1248 -1248
  739. package/lib/assets/docs/reference//350/250/200/350/252/236/345/210/245/351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +518 -518
  740. package/lib/assets/docs/reference//351/201/213/345/226/266/347/256/241/347/220/206.md +1482 -1482
  741. package/lib/assets/docs/reference//351/201/213/347/224/250/343/202/271/343/202/257/343/203/252/343/203/227/343/203/210/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +421 -421
  742. package/lib/assets/docs/reference//351/201/213/347/224/250/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +392 -392
  743. package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +305 -305
  744. package/lib/assets/docs/reference//351/235/236/346/251/237/350/203/275/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1236 -1236
  745. package/lib/assets/docs/requirements/index.md +17 -17
  746. package/lib/assets/docs/review/index.md +5 -5
  747. package/lib/assets/docs/strategy/index.md +17 -17
  748. package/lib/assets/docs/template/ADR.md +30 -30
  749. package/lib/assets/docs/template/AWS/343/202/271/343/203/206/343/203/274/343/202/270/343/203/263/343/202/260/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +1366 -1366
  750. package/lib/assets/docs/template/AWS/343/203/227/343/203/255/343/203/200/343/202/257/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +634 -634
  751. package/lib/assets/docs/template/README.md +50 -50
  752. package/lib/assets/docs/template/index.md +24 -24
  753. package/lib/assets/docs/template//343/201/276/343/201/232/343/201/223/343/202/214/343/202/222/350/252/255/343/202/202/343/201/206/343/203/252/343/202/271/343/203/210.md +12 -12
  754. package/lib/assets/docs/template//343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +547 -547
  755. package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +58 -58
  756. package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273.md +327 -327
  757. package/lib/assets/docs/template//343/202/244/343/203/263/343/202/273/343/203/227/343/202/267/343/203/247/343/203/263/343/203/207/343/203/203/343/202/255.md +13 -13
  758. package/lib/assets/docs/template//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243.md +379 -379
  759. package/lib/assets/docs/template//343/203/252/343/203/252/343/203/274/343/202/271/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +275 -275
  760. package/lib/assets/docs/template//344/272/213/344/276/213/345/210/206/346/236/220.md +513 -513
  761. package/lib/assets/docs/template//344/274/201/346/245/255/345/210/206/346/236/220.md +573 -573
  762. package/lib/assets/docs/template//345/256/214/345/205/250/345/275/242/345/274/217/343/201/256/343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271.md +69 -69
  763. package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
  764. package/lib/assets/docs/template//350/250/255/350/250/210.md +173 -173
  765. package/lib/assets/docs/template//351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +688 -688
  766. package/lib/assets/gulpfile.js +25 -25
  767. package/lib/assets/mkdocs.yml +139 -138
  768. package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
  769. package/lib/assets/ops/docker/sonarqube-local/docker-compose.yml +57 -57
  770. package/lib/assets/ops/scripts/journal.js +180 -180
  771. package/lib/assets/ops/scripts/mkdocs.js +82 -82
  772. package/lib/assets/ops/scripts/release.js +431 -431
  773. package/lib/assets/ops/scripts/sonar_local.js +726 -726
  774. package/lib/assets/ops/scripts/ssh.js +190 -190
  775. package/lib/assets/ops/scripts/vault.js +299 -299
  776. package/lib/assets/package-lock.json +1653 -1653
  777. package/lib/assets/package.json +40 -40
  778. package/lib/gulpfile.js +37 -37
  779. package/package.json +41 -41
@@ -1,1237 +1,1237 @@
1
- # 非機能要件定義ガイド
2
-
3
- ## 概要
4
-
5
- よいソフトウェアを作るための非機能要件定義について説明する。変更を楽に安全にできて役に立つソフトウェアを実現するため、品質属性を明確に定義し、測定可能な指標を設定する。
6
-
7
- ## 非機能要件の基本原則
8
-
9
- ### よいソフトウェアと非機能要件
10
-
11
- 変更を楽に安全にできて役に立つソフトウェアを作るため、非機能要件は以下の価値を提供する:
12
-
13
- 1. **安全な変更**: システムが安定して動作し続ける信頼性
14
- 2. **楽な変更**: 保守性と拡張性により変更コストを最小化
15
- 3. **役に立つ**: ユーザビリティとパフォーマンスによる価値提供
16
- 4. **継続的価値**: 可用性と運用性による長期的な価値維持
17
-
18
- ### 非機能要件の重要性
19
-
20
- ```plantuml
21
- @startuml
22
- rectangle "機能要件" as Func {
23
- - 何を実現するか
24
- - ビジネス要求
25
- - ユースケース
26
- }
27
-
28
- rectangle "非機能要件" as NonFunc {
29
- - どの程度うまく実現するか
30
- - 品質属性
31
- - システム制約
32
- }
33
-
34
- @enduml
35
- ```
36
-
37
- ## ISO/IEC 25010 品質モデル
38
-
39
- ### システム・ソフトウェア品質モデル
40
-
41
- ```plantuml
42
- @startuml
43
- rectangle "ISO/IEC 25010 品質特性" {
44
- rectangle "機能適合性" {
45
- - 機能完全性
46
- - 機能正確性
47
- - 機能適切性
48
- }
49
-
50
- rectangle "性能効率性" {
51
- - 時間効率性
52
- - 資源効率性
53
- - 容量満足性
54
- }
55
-
56
- rectangle "互換性" {
57
- - 共存性
58
- - 相互運用性
59
- }
60
-
61
- rectangle "使用性" {
62
- - 適切度認識性
63
- - 習得性
64
- - 運用性
65
- - ユーザーエラー防止性
66
- - UI快美性
67
- - アクセシビリティ
68
- }
69
-
70
- rectangle "信頼性" {
71
- - 成熟性
72
- - 可用性
73
- - 障害許容性
74
- - 回復性
75
- }
76
-
77
- rectangle "セキュリティ" {
78
- - 機密性
79
- - 完全性
80
- - 否認防止性
81
- - 責任追跡性
82
- - 真正性
83
- }
84
-
85
- rectangle "保守性" {
86
- - モジュール性
87
- - 再利用性
88
- - 解析性
89
- - 修正性
90
- - 試験性
91
- }
92
-
93
- rectangle "移植性" {
94
- - 適応性
95
- - 設置性
96
- - 置換性
97
- }
98
- }
99
- @enduml
100
- ```
101
-
102
- ### 品質特性の詳細
103
-
104
- #### 機能適合性(Functional Suitability)
105
- - **機能完全性**: 指定されたタスクと目標をカバーする機能の度合い
106
- - **機能正確性**: 正確な結果を提供する機能の度合い
107
- - **機能適切性**: 指定されたタスクと目標を促進する機能の度合い
108
-
109
- #### 性能効率性(Performance Efficiency)
110
- - **時間効率性**: 応答時間、処理時間、スループット
111
- - **資源効率性**: CPU、メモリ、ネットワーク、ストレージの使用量
112
- - **容量満足性**: 最大限界値(ユーザー数、データ量など)
113
-
114
- #### 互換性(Compatibility)
115
- - **共存性**: 他のソフトウェアと共通環境でリソースを共有する度合い
116
- - **相互運用性**: 他のシステムと情報交換し機能を利用する度合い
117
-
118
- #### 使用性(Usability)
119
- - **適切度認識性**: ユーザーが適切性を認識する度合い
120
- - **習得性**: 学習のしやすさ
121
- - **運用性**: 操作・制御のしやすさ
122
- - **ユーザーエラー防止性**: エラーを防護する度合い
123
- - **UI快美性**: 満足感を与える度合い
124
- - **アクセシビリティ**: 幅広いユーザーが使用できる度合い
125
-
126
- #### 信頼性(Reliability)
127
- - **成熟性**: 通常運用下で信頼性要求を満足する度合い
128
- - **可用性**: 運用可能で利用できる度合い
129
- - **障害許容性**: 障害にもかかわらず動作する度合い
130
- - **回復性**: 障害後に回復し影響データを復旧する度合い
131
-
132
- #### セキュリティ(Security)
133
- - **機密性**: 認可されたもののみがアクセスできる度合い
134
- - **完全性**: データや計算方法への不正アクセスを防ぐ度合い
135
- - **否認防止性**: アクションや事象が起きたことを証明する度合い
136
- - **責任追跡性**: エンティティのアクションを一意に追跡する度合い
137
- - **真正性**: 主張されたアイデンティティを証明する度合い
138
-
139
- #### 保守性(Maintainability)
140
- - **モジュール性**: 構成要素への変更が他に与える影響が最小限の度合い
141
- - **再利用性**: 他のシステムで利用できる度合い
142
- - **解析性**: 変更の影響を評価する度合い
143
- - **修正性**: 欠陥除去や改善を効果的かつ効率的に行える度合い
144
- - **試験性**: テスト基準を確立しテストを実行する度合い
145
-
146
- #### 移植性(Portability)
147
- - **適応性**: 異なるハードウェア・ソフトウェア環境に適応する度合い
148
- - **設置性**: 指定された環境に設置する度合い
149
- - **置換性**: 同じ目的の他のソフトウェアと置き換える度合い
150
-
151
- ## 非機能要件の分類
152
-
153
- ### FURPS+ モデル
154
-
155
- ```plantuml
156
- @startuml
157
- rectangle "FURPS+ モデル" {
158
- rectangle "Functionality" {
159
- - 機能性
160
- - セキュリティ
161
- - API
162
- - インターフェース
163
- }
164
-
165
- rectangle "Usability" {
166
- - 使いやすさ
167
- - ユーザビリティ
168
- - アクセシビリティ
169
- - ドキュメント
170
- }
171
-
172
- rectangle "Reliability" {
173
- - 信頼性
174
- - 可用性
175
- - 故障率
176
- - 復旧時間
177
- }
178
-
179
- rectangle "Performance" {
180
- - パフォーマンス
181
- - 応答時間
182
- - スループット
183
- - 容量
184
- }
185
-
186
- rectangle "Supportability" {
187
- - サポート性
188
- - 保守性
189
- - 拡張性
190
- - 設定性
191
- }
192
-
193
- rectangle "Plus" {
194
- - 実装制約
195
- - インターフェース制約
196
- - 運用制約
197
- - パッケージ制約
198
- - 法的制約
199
- }
200
- }
201
- @enduml
202
- ```
203
-
204
- ### 会議室予約システムの非機能要件分類
205
-
206
- #### 性能要件(Performance Requirements)
207
- - **応答時間**: ユーザーアクションに対するレスポンス時間
208
- - **スループット**: 同時処理可能な予約数・ユーザー数
209
- - **容量**: 保存可能なデータ量、サポートするユーザー数
210
-
211
- #### 可用性・信頼性要件(Availability & Reliability Requirements)
212
- - **稼働率**: システムが利用可能な時間の割合
213
- - **障害回復**: システム障害からの回復時間
214
- - **データ保護**: データの損失防止とバックアップ
215
-
216
- #### セキュリティ要件(Security Requirements)
217
- - **認証・認可**: ユーザー識別とアクセス制御
218
- - **データ保護**: 個人情報・機密情報の保護
219
- - **監査**: アクセスログと操作履歴の記録
220
-
221
- #### 使用性要件(Usability Requirements)
222
- - **操作性**: 直感的で使いやすいインターフェース
223
- - **アクセシビリティ**: 多様なユーザーへの対応
224
- - **応答性**: レスポンシブデザインと快適な操作感
225
-
226
- #### 保守性・拡張性要件(Maintainability & Scalability Requirements)
227
- - **保守性**: コードの理解しやすさと変更容易性
228
- - **拡張性**: 機能追加とユーザー増加への対応
229
- - **監視性**: システム状態の把握と問題の早期発見
230
-
231
- #### 互換性・移植性要件(Compatibility & Portability Requirements)
232
- - **ブラウザ互換性**: 複数ブラウザでの動作保証
233
- - **デバイス対応**: PC、タブレット、スマートフォン対応
234
- - **システム連携**: 既存システムとの連携能力
235
-
236
- ## 会議室予約システムの非機能要件詳細
237
-
238
- ### 1. 性能要件(Performance Requirements)
239
-
240
- #### 1.1 応答時間要件
241
-
242
- ```plantuml
243
- @startuml
244
- rectangle "応答時間要件" {
245
- rectangle "ページ表示" {
246
- - 初回ページ読み込み: < 3秒
247
- - ページ遷移: < 1秒
248
- - 部分更新: < 500ms
249
- }
250
-
251
- rectangle "API応答" {
252
- - 会議室検索: < 1秒
253
- - 予約作成: < 2秒
254
- - 予約変更・キャンセル: < 1秒
255
- - ユーザー認証: < 1秒
256
- }
257
-
258
- rectangle "バッチ処理" {
259
- - データ集計: < 30秒
260
- - レポート生成: < 60秒
261
- - データアーカイブ: < 10分
262
- }
263
- }
264
- @enduml
265
- ```
266
-
267
- **測定方法**:
268
- ```javascript
269
- // フロントエンド性能測定
270
- const observer = new PerformanceObserver((list) => {
271
- list.getEntries().forEach((entry) => {
272
- console.log(`${entry.name}: ${entry.duration}ms`);
273
- });
274
- });
275
- observer.observe({ entryTypes: ['navigation', 'measure'] });
276
-
277
- // API応答時間測定
278
- const startTime = performance.now();
279
- await fetch('/api/reservations');
280
- const endTime = performance.now();
281
- console.log(`API応答時間: ${endTime - startTime}ms`);
282
- ```
283
-
284
- **実装例**:
285
- ```java
286
- // バックエンド性能監視
287
- @RestController
288
- @Timed // Micrometer アノテーション
289
- public class ReservationController {
290
-
291
- @GetMapping("/reservations")
292
- @Timed(name = "reservation.search", description = "予約検索処理時間")
293
- public ResponseEntity<List<ReservationResponse>> searchReservations(
294
- @RequestParam ReservationSearchCriteria criteria) {
295
- // 処理実装
296
- }
297
- }
298
-
299
- // データベースクエリ最適化
300
- @Repository
301
- public class ReservationRepository {
302
-
303
- @Query(value = """
304
- SELECT r FROM Reservation r
305
- WHERE r.roomId = :roomId
306
- AND r.startTime >= :startDate
307
- AND r.endTime <= :endDate
308
- AND r.status IN ('CONFIRMED', 'PENDING')
309
- """)
310
- List<Reservation> findActiveByRoomAndDateRange(
311
- @Param("roomId") UUID roomId,
312
- @Param("startDate") LocalDateTime startDate,
313
- @Param("endDate") LocalDateTime endDate);
314
- }
315
- ```
316
-
317
- #### 1.2 スループット要件
318
-
319
- - **同時ユーザー数**: 100名(ピーク時200名まで対応)
320
- - **予約処理能力**: 毎秒10件の予約処理
321
- - **データ容量**: 年間10,000件の予約データ、5年間保持
322
-
323
- ```java
324
- // 負荷テスト設定例
325
- @Test
326
- @LoadTest(users = 100, duration = 300) // 100ユーザー、5分間
327
- void 予約作成の負荷テスト() {
328
- CreateReservationRequest request = createTestRequest();
329
-
330
- ResponseEntity<ReservationResponse> response = restTemplate.postForEntity(
331
- "/api/reservations", request, ReservationResponse.class);
332
-
333
- assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
334
- assertThat(response.getBody().getReservationId()).isNotNull();
335
- }
336
- ```
337
-
338
- ### 2. 可用性・信頼性要件(Availability & Reliability Requirements)
339
-
340
- #### 2.1 稼働率要件
341
-
342
- ```plantuml
343
- @startuml
344
- rectangle "可用性・信頼性要件" {
345
- rectangle "可用性レベル" {
346
- - 稼働率 99.9%: 年間ダウンタイム < 8.77時間
347
- - 営業時間内 99.95%: 月間ダウンタイム < 22分
348
- - 計画停止除く: 営業時間外のメンテナンス許可
349
- }
350
-
351
- rectangle "障害対応" {
352
- - 検知時間: < 5分
353
- - 初期対応: < 15分
354
- - 復旧時間: < 2時間(重大障害)
355
- - 回復時間: < 30分(軽微な障害)
356
- }
357
-
358
- rectangle "データ保護" {
359
- - バックアップ: 日次・週次・月次
360
- - 復旧時間: < 4時間(RPO: 1時間以内)
361
- - データ整合性: トランザクション保証
362
- }
363
- }
364
- @enduml
365
- ```
366
-
367
- **実装例**:
368
- ```yaml
369
- # Docker Compose でのヘルスチェック
370
- services:
371
- app:
372
- image: meeting-room-app:latest
373
- healthcheck:
374
- test: ["CMD", "curl", "-f", "http://localhost:8080/actuator/health"]
375
- interval: 30s
376
- timeout: 10s
377
- retries: 3
378
- start_period: 60s
379
- restart: unless-stopped
380
-
381
- database:
382
- image: postgres:15
383
- healthcheck:
384
- test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER}"]
385
- interval: 10s
386
- timeout: 5s
387
- retries: 5
388
- ```
389
-
390
- ```java
391
- // Spring Boot Actuator によるヘルスチェック
392
- @Component
393
- public class DatabaseHealthIndicator implements HealthIndicator {
394
-
395
- private final DataSource dataSource;
396
-
397
- @Override
398
- public Health health() {
399
- try (Connection connection = dataSource.getConnection()) {
400
- if (connection.isValid(1)) {
401
- return Health.up()
402
- .withDetail("database", "Available")
403
- .withDetail("validationQuery", "SELECT 1")
404
- .build();
405
- }
406
- } catch (SQLException e) {
407
- return Health.down(e)
408
- .withDetail("database", "Unavailable")
409
- .build();
410
- }
411
- return Health.down()
412
- .withDetail("database", "Unknown")
413
- .build();
414
- }
415
- }
416
- ```
417
-
418
- #### 2.2 障害許容性
419
-
420
- ```java
421
- // Circuit Breaker パターン実装
422
- @Component
423
- public class ExternalServiceClient {
424
-
425
- private final CircuitBreaker circuitBreaker;
426
-
427
- public ExternalServiceClient() {
428
- this.circuitBreaker = CircuitBreaker.ofDefaults("externalService");
429
- circuitBreaker.getEventPublisher()
430
- .onStateTransition(event ->
431
- log.info("Circuit breaker state transition: {}", event));
432
- }
433
-
434
- public Optional<String> callExternalService(String request) {
435
- return circuitBreaker.executeSupplier(() -> {
436
- // 外部サービス呼び出し
437
- return externalServiceCall(request);
438
- });
439
- }
440
- }
441
-
442
- // 再試行機能
443
- @Retryable(
444
- value = {DataAccessException.class},
445
- maxAttempts = 3,
446
- backoff = @Backoff(delay = 1000, multiplier = 2)
447
- )
448
- public Reservation saveReservation(Reservation reservation) {
449
- return reservationRepository.save(reservation);
450
- }
451
- ```
452
-
453
- ### 3. セキュリティ要件(Security Requirements)
454
-
455
- #### 3.1 認証・認可要件
456
-
457
- ```plantuml
458
- @startuml
459
- rectangle "セキュリティ要件" {
460
- rectangle "認証" {
461
- - JWT Bearer Token: 有効期限 24時間
462
- - リフレッシュトークン: 有効期限 30日
463
- - 多要素認証: 管理者必須
464
- - パスワード強度: 8文字以上、複雑性要求
465
- }
466
-
467
- rectangle "認可" {
468
- - RBAC: ロールベースアクセス制御
469
- - リソースレベル制御: 予約・会議室・ユーザー
470
- - API エンドポイント保護: 全API認証必須
471
- }
472
-
473
- rectangle "データ保護" {
474
- - 暗号化: 保存時・転送時
475
- - 個人情報保護: GDPR準拠
476
- - 監査ログ: 全操作記録
477
- }
478
- }
479
- @enduml
480
- ```
481
-
482
- **実装例**:
483
- ```java
484
- // JWT セキュリティ設定
485
- @Configuration
486
- @EnableWebSecurity
487
- @EnableMethodSecurity
488
- public class SecurityConfig {
489
-
490
- @Bean
491
- public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
492
- return http
493
- .csrf(csrf -> csrf.disable())
494
- .sessionManagement(session ->
495
- session.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
496
- .authorizeHttpRequests(auth -> auth
497
- .requestMatchers("/api/auth/**").permitAll()
498
- .requestMatchers(HttpMethod.GET, "/api/rooms").hasAnyRole("USER", "ADMIN")
499
- .requestMatchers("/api/reservations/**").hasAnyRole("USER", "ADMIN")
500
- .requestMatchers("/api/admin/**").hasRole("ADMIN")
501
- .anyRequest().authenticated())
502
- .oauth2ResourceServer(oauth2 -> oauth2
503
- .jwt(jwt -> jwt.jwtAuthenticationConverter(jwtAuthConverter())))
504
- .build();
505
- }
506
-
507
- @Bean
508
- public PasswordEncoder passwordEncoder() {
509
- return new BCryptPasswordEncoder(12); // 強度12
510
- }
511
- }
512
-
513
- // 認可制御
514
- @PreAuthorize("hasRole('ADMIN') or @reservationSecurityService.canAccessReservation(#reservationId, authentication.name)")
515
- public ReservationResponse getReservation(@PathVariable String reservationId) {
516
- // 実装
517
- }
518
-
519
- // 監査ログ
520
- @EventListener
521
- public class AuditEventListener {
522
-
523
- @Async
524
- @EventListener
525
- public void handleAuditEvent(AuditEvent event) {
526
- AuditLog auditLog = AuditLog.builder()
527
- .userId(event.getPrincipal())
528
- .action(event.getType())
529
- .resource(event.getData().toString())
530
- .timestamp(LocalDateTime.now())
531
- .ipAddress(getClientIpAddress())
532
- .userAgent(getUserAgent())
533
- .build();
534
-
535
- auditLogRepository.save(auditLog);
536
- }
537
- }
538
- ```
539
-
540
- #### 3.2 データ暗号化
541
-
542
- ```java
543
- // 個人情報暗号化
544
- @Entity
545
- @Table(name = "users")
546
- public class User {
547
-
548
- @Id
549
- private UUID id;
550
-
551
- @Column(name = "username")
552
- private String username;
553
-
554
- @Convert(converter = EncryptedStringConverter.class)
555
- @Column(name = "email")
556
- private String email; // 暗号化保存
557
-
558
- @Convert(converter = EncryptedStringConverter.class)
559
- @Column(name = "full_name")
560
- private String fullName; // 暗号化保存
561
-
562
- @Column(name = "password_hash")
563
- private String passwordHash; // BCrypt ハッシュ
564
- }
565
-
566
- // 暗号化コンバーター
567
- @Component
568
- public class EncryptedStringConverter implements AttributeConverter<String, String> {
569
-
570
- @Autowired
571
- private AESEncryptionService encryptionService;
572
-
573
- @Override
574
- public String convertToDatabaseColumn(String attribute) {
575
- return attribute == null ? null : encryptionService.encrypt(attribute);
576
- }
577
-
578
- @Override
579
- public String convertToEntityAttribute(String dbData) {
580
- return dbData == null ? null : encryptionService.decrypt(dbData);
581
- }
582
- }
583
- ```
584
-
585
- ### 4. 使用性要件(Usability Requirements)
586
-
587
- #### 4.1 ユーザビリティ要件
588
-
589
- ```plantuml
590
- @startuml
591
- rectangle "ユーザビリティ要件" {
592
- rectangle "操作性" {
593
- - 3クリック原則: 主要機能は3クリック以内
594
- - 予約完了時間: < 2分(初回ユーザー)
595
- - 学習時間: < 30分(新規ユーザー)
596
- - エラー回復: 1クリックで前の状態に復帰
597
- }
598
-
599
- rectangle "アクセシビリティ" {
600
- - WCAG 2.1 AA: Web Content Accessibility Guidelines 準拠
601
- - キーボード操作: 全機能をキーボードで操作可能
602
- - スクリーンリーダー: 対応必須
603
- - 色覚対応: カラーユニバーサルデザイン
604
- }
605
-
606
- rectangle "レスポンシブ" {
607
- - デスクトップ: 1920x1080以上推奨
608
- - タブレット: 768px以上対応
609
- - スマートフォン: 375px以上対応
610
- - ブラウザ: Chrome, Firefox, Safari, Edge 最新版
611
- }
612
- }
613
- @enduml
614
- ```
615
-
616
- **実装例**:
617
- ```tsx
618
- // アクセシビリティ対応コンポーネント
619
- interface ReservationFormProps {
620
- onSubmit: (data: ReservationFormData) => void;
621
- }
622
-
623
- export const ReservationForm: React.FC<ReservationFormProps> = ({ onSubmit }) => {
624
- return (
625
- <form onSubmit={handleSubmit} role="form" aria-label="会議室予約フォーム">
626
- <fieldset>
627
- <legend>予約情報</legend>
628
-
629
- <div className="form-group">
630
- <label htmlFor="room-select" className="required">
631
- 会議室選択
632
- </label>
633
- <select
634
- id="room-select"
635
- aria-required="true"
636
- aria-describedby="room-help"
637
- {...register('roomId', { required: '会議室を選択してください' })}
638
- >
639
- <option value="">選択してください</option>
640
- {rooms.map(room => (
641
- <option key={room.id} value={room.id}>
642
- {room.name} (収容人数: {room.capacity}名)
643
- </option>
644
- ))}
645
- </select>
646
- <div id="room-help" className="help-text">
647
- 希望する会議室を選択してください
648
- </div>
649
- {errors.roomId && (
650
- <div role="alert" className="error-message">
651
- {errors.roomId.message}
652
- </div>
653
- )}
654
- </div>
655
-
656
- <div className="form-group">
657
- <label htmlFor="date-input" className="required">
658
- 利用日
659
- </label>
660
- <input
661
- type="date"
662
- id="date-input"
663
- aria-required="true"
664
- min={new Date().toISOString().split('T')[0]}
665
- {...register('date', { required: '利用日を選択してください' })}
666
- />
667
- </div>
668
-
669
- <button
670
- type="submit"
671
- disabled={isSubmitting}
672
- aria-describedby="submit-help"
673
- >
674
- {isSubmitting ? '予約中...' : '予約する'}
675
- </button>
676
- <div id="submit-help" className="help-text">
677
- 入力内容を確認して予約ボタンをクリックしてください
678
- </div>
679
- </fieldset>
680
- </form>
681
- );
682
- };
683
-
684
- // レスポンシブデザイン
685
- const ReservationCard = styled.div`
686
- padding: 1rem;
687
- border: 1px solid #e2e8f0;
688
- border-radius: 0.5rem;
689
-
690
- @media (min-width: 768px) {
691
- padding: 1.5rem;
692
- display: grid;
693
- grid-template-columns: 1fr auto;
694
- gap: 1rem;
695
- }
696
-
697
- @media (min-width: 1024px) {
698
- padding: 2rem;
699
- }
700
- `;
701
- ```
702
-
703
- #### 4.2 ユーザーエクスペリエンス指標
704
-
705
- ```javascript
706
- // Core Web Vitals 測定
707
- import { getCLS, getFID, getFCP, getLCP, getTTFB } from 'web-vitals';
708
-
709
- function sendToAnalytics(metric) {
710
- // 分析ツールへの送信
711
- analytics.track('Performance Metric', {
712
- name: metric.name,
713
- value: metric.value,
714
- rating: metric.rating
715
- });
716
- }
717
-
718
- // 各指標の測定
719
- getCLS(sendToAnalytics); // Cumulative Layout Shift < 0.1
720
- getFID(sendToAnalytics); // First Input Delay < 100ms
721
- getFCP(sendToAnalytics); // First Contentful Paint < 1.8s
722
- getLCP(sendToAnalytics); // Largest Contentful Paint < 2.5s
723
- getTTFB(sendToAnalytics); // Time to First Byte < 0.8s
724
-
725
- // ユーザー行動分析
726
- const trackUserInteraction = (action, element, duration) => {
727
- analytics.track('User Interaction', {
728
- action,
729
- element,
730
- duration,
731
- timestamp: new Date().toISOString(),
732
- userId: getCurrentUserId()
733
- });
734
- };
735
-
736
- // 予約プロセス分析
737
- const reservationFlowTracking = {
738
- searchStart: () => trackUserInteraction('search_start', 'room_search', 0),
739
- searchComplete: (duration) => trackUserInteraction('search_complete', 'room_search', duration),
740
- reservationStart: () => trackUserInteraction('reservation_start', 'reservation_form', 0),
741
- reservationComplete: (duration) => trackUserInteraction('reservation_complete', 'reservation_form', duration),
742
- reservationAbandoned: (step, duration) => trackUserInteraction('reservation_abandoned', step, duration)
743
- };
744
- ```
745
-
746
- ### 5. 保守性・拡張性要件(Maintainability & Scalability Requirements)
747
-
748
- #### 5.1 保守性要件
749
-
750
- ```plantuml
751
- @startuml
752
- rectangle "保守性要件" {
753
- rectangle "コード品質" {
754
- - テストカバレッジ: > 80%(ドメイン層 > 90%)
755
- - 複雑度: Cyclomatic Complexity < 10
756
- - 重複コード: < 3%
757
- - 技術的負債: SonarQube Rating A
758
- }
759
-
760
- rectangle "ドキュメント" {
761
- - API ドキュメント: OpenAPI 3.0 準拠
762
- - アーキテクチャ図: C4 モデル
763
- - 運用手順書: 障害対応・デプロイ手順
764
- - 更新頻度: コード変更と同時更新
765
- }
766
-
767
- rectangle "監視・ログ" {
768
- - 構造化ログ: JSON形式、分析可能
769
- - メトリクス: Micrometer + Prometheus
770
- - 分散トレーシング: Jaeger 対応
771
- - アラート: SLA 違反時の自動通知
772
- }
773
- }
774
- @enduml
775
- ```
776
-
777
- **実装例**:
778
- ```java
779
- // 構造化ログ
780
- @RestController
781
- @Slf4j
782
- public class ReservationController {
783
-
784
- @PostMapping("/reservations")
785
- public ResponseEntity<ReservationResponse> createReservation(
786
- @RequestBody CreateReservationRequest request,
787
- HttpServletRequest httpRequest) {
788
-
789
- MDC.put("userId", getCurrentUserId());
790
- MDC.put("correlationId", UUID.randomUUID().toString());
791
- MDC.put("ipAddress", getClientIpAddress(httpRequest));
792
-
793
- try {
794
- log.info("Creating reservation: roomId={}, startTime={}",
795
- request.getRoomId(), request.getStartTime());
796
-
797
- ReservationId reservationId = createReservationUseCase.execute(
798
- mapToCommand(request));
799
-
800
- log.info("Reservation created successfully: reservationId={}", reservationId);
801
-
802
- return ResponseEntity.status(HttpStatus.CREATED)
803
- .body(ReservationResponse.from(reservationId));
804
-
805
- } catch (Exception e) {
806
- log.error("Failed to create reservation", e);
807
- throw e;
808
- } finally {
809
- MDC.clear();
810
- }
811
- }
812
- }
813
-
814
- // メトリクス収集
815
- @Component
816
- @Service
817
- public class ReservationMetricsService {
818
-
819
- private final MeterRegistry meterRegistry;
820
- private final Counter reservationCreatedCounter;
821
- private final Counter reservationFailedCounter;
822
- private final Timer reservationProcessingTimer;
823
-
824
- public ReservationMetricsService(MeterRegistry meterRegistry) {
825
- this.meterRegistry = meterRegistry;
826
- this.reservationCreatedCounter = Counter.builder("reservation.created")
827
- .description("Created reservations count")
828
- .register(meterRegistry);
829
- this.reservationFailedCounter = Counter.builder("reservation.failed")
830
- .description("Failed reservations count")
831
- .register(meterRegistry);
832
- this.reservationProcessingTimer = Timer.builder("reservation.processing")
833
- .description("Reservation processing time")
834
- .register(meterRegistry);
835
- }
836
-
837
- public void recordReservationCreated() {
838
- reservationCreatedCounter.increment();
839
- }
840
-
841
- public void recordReservationFailed(String reason) {
842
- reservationFailedCounter.increment(Tags.of("reason", reason));
843
- }
844
-
845
- public Timer.Sample startProcessingTimer() {
846
- return Timer.start(meterRegistry);
847
- }
848
- }
849
- ```
850
-
851
- #### 5.2 拡張性要件
852
-
853
- ```java
854
- // 水平スケーリング対応
855
- @Configuration
856
- @EnableCaching
857
- public class CacheConfig {
858
-
859
- @Bean
860
- public CacheManager cacheManager() {
861
- RedisCacheManager.Builder builder = RedisCacheManager
862
- .RedisCacheManagerBuilder
863
- .fromConnectionFactory(jedisConnectionFactory())
864
- .cacheDefaults(cacheConfiguration());
865
-
866
- return builder.build();
867
- }
868
-
869
- private RedisCacheConfiguration cacheConfiguration() {
870
- return RedisCacheConfiguration.defaultCacheConfig()
871
- .entryTtl(Duration.ofMinutes(10))
872
- .serializeKeysWith(RedisSerializationContext.SerializationPair
873
- .fromSerializer(new StringRedisSerializer()))
874
- .serializeValuesWith(RedisSerializationContext.SerializationPair
875
- .fromSerializer(new GenericJackson2JsonRedisSerializer()));
876
- }
877
- }
878
-
879
- // データベースパーティショニング
880
- @Entity
881
- @Table(name = "reservations")
882
- @PartitionKey("DATE(start_time)") // 日付によるパーティショニング
883
- public class ReservationEntity {
884
- // エンティティ定義
885
- }
886
-
887
- // マイクロサービス化の準備
888
- @FeignClient(name = "notification-service", url = "${services.notification.url}")
889
- public interface NotificationServiceClient {
890
-
891
- @PostMapping("/notifications")
892
- ResponseEntity<Void> sendNotification(@RequestBody NotificationRequest request);
893
- }
894
- ```
895
-
896
- ### 6. 運用要件(Operational Requirements)
897
-
898
- #### 6.1 監視・運用要件
899
-
900
- ```yaml
901
- # Kubernetes デプロイメント設定
902
- apiVersion: apps/v1
903
- kind: Deployment
904
- metadata:
905
- name: meeting-room-app
906
- spec:
907
- replicas: 3
908
- selector:
909
- matchLabels:
910
- app: meeting-room-app
911
- template:
912
- spec:
913
- containers:
914
- - name: app
915
- image: meeting-room-app:latest
916
- ports:
917
- - containerPort: 8080
918
- resources:
919
- requests:
920
- memory: "512Mi"
921
- cpu: "500m"
922
- limits:
923
- memory: "1Gi"
924
- cpu: "1000m"
925
- livenessProbe:
926
- httpGet:
927
- path: /actuator/health/liveness
928
- port: 8080
929
- initialDelaySeconds: 60
930
- periodSeconds: 30
931
- readinessProbe:
932
- httpGet:
933
- path: /actuator/health/readiness
934
- port: 8080
935
- initialDelaySeconds: 30
936
- periodSeconds: 10
937
- env:
938
- - name: JAVA_OPTS
939
- value: "-Xms512m -Xmx1g -XX:+UseG1GC"
940
- - name: SPRING_PROFILES_ACTIVE
941
- value: "production"
942
- ```
943
-
944
- ```java
945
- // カスタムヘルスチェック
946
- @Component
947
- public class ReservationSystemHealthIndicator implements HealthIndicator {
948
-
949
- private final ReservationRepository reservationRepository;
950
- private final NotificationServiceClient notificationService;
951
-
952
- @Override
953
- public Health health() {
954
- Health.Builder status = Health.up();
955
-
956
- try {
957
- // データベース接続確認
958
- long activeReservationsCount = reservationRepository.countActiveReservations();
959
- status.withDetail("database", Map.of(
960
- "status", "UP",
961
- "activeReservations", activeReservationsCount
962
- ));
963
-
964
- // 外部サービス接続確認
965
- boolean notificationServiceUp = checkNotificationService();
966
- status.withDetail("notificationService", Map.of(
967
- "status", notificationServiceUp ? "UP" : "DOWN"
968
- ));
969
-
970
- // システムリソース確認
971
- status.withDetail("system", getSystemMetrics());
972
-
973
- } catch (Exception e) {
974
- return Health.down(e).build();
975
- }
976
-
977
- return status.build();
978
- }
979
-
980
- private Map<String, Object> getSystemMetrics() {
981
- Runtime runtime = Runtime.getRuntime();
982
- long maxMemory = runtime.maxMemory();
983
- long totalMemory = runtime.totalMemory();
984
- long freeMemory = runtime.freeMemory();
985
-
986
- return Map.of(
987
- "memory.max", maxMemory,
988
- "memory.total", totalMemory,
989
- "memory.free", freeMemory,
990
- "memory.used", totalMemory - freeMemory,
991
- "processors", runtime.availableProcessors()
992
- );
993
- }
994
- }
995
- ```
996
-
997
- ## 非機能要件の測定と検証
998
-
999
- ### 1. パフォーマンステスト
1000
-
1001
- ```java
1002
- // JMeter 負荷テストシナリオ
1003
- @Test
1004
- public class PerformanceTest {
1005
-
1006
- @LoadTest(
1007
- users = 100,
1008
- rampUp = 60, // 60秒で100ユーザーまで増加
1009
- duration = 300 // 5分間実行
1010
- )
1011
- public void 予約作成負荷テスト() {
1012
- // 予約作成APIの負荷テスト
1013
- given()
1014
- .contentType(ContentType.JSON)
1015
- .body(createReservationRequest())
1016
- .when()
1017
- .post("/api/reservations")
1018
- .then()
1019
- .statusCode(201)
1020
- .time(lessThan(2000L)); // 2秒以内
1021
- }
1022
-
1023
- @PerformanceTest
1024
- @JvmOptions({"-Xms1g", "-Xmx2g", "-XX:+UseG1GC"})
1025
- public void メモリ使用量テスト() {
1026
- // メモリ使用量とGCの影響を測定
1027
- for (int i = 0; i < 10000; i++) {
1028
- createAndProcessReservation();
1029
- }
1030
-
1031
- // メモリ使用量を確認
1032
- assertThat(getUsedMemoryMB()).isLessThan(1500); // 1.5GB以下
1033
- assertThat(getGcPauseTimeMs()).isLessThan(100); // GC停止時間100ms以下
1034
- }
1035
- }
1036
- ```
1037
-
1038
- ### 2. セキュリティテスト
1039
-
1040
- ```java
1041
- // セキュリティテスト
1042
- @SpringBootTest
1043
- @AutoConfigureMockMvc
1044
- public class SecurityTest {
1045
-
1046
- @Test
1047
- public void 認証なしでアクセスすると401エラー() throws Exception {
1048
- mockMvc.perform(get("/api/reservations"))
1049
- .andExpect(status().isUnauthorized());
1050
- }
1051
-
1052
- @Test
1053
- public void 無効なJWTトークンで401エラー() throws Exception {
1054
- mockMvc.perform(get("/api/reservations")
1055
- .header("Authorization", "Bearer invalid-token"))
1056
- .andExpected(status().isUnauthorized());
1057
- }
1058
-
1059
- @Test
1060
- @WithMockUser(roles = "USER")
1061
- public void 管理者権限なしで管理APIにアクセスすると403エラー() throws Exception {
1062
- mockMvc.perform(get("/api/admin/users"))
1063
- .andExpect(status().isForbidden());
1064
- }
1065
-
1066
- @Test
1067
- public void SQLインジェクション攻撃をブロック() throws Exception {
1068
- String maliciousInput = "'; DROP TABLE users; --";
1069
-
1070
- mockMvc.perform(get("/api/reservations")
1071
- .param("search", maliciousInput))
1072
- .andExpect(status().isBadRequest())
1073
- .andExpect(jsonPath("$.error").value("INVALID_INPUT"));
1074
- }
1075
- }
1076
- ```
1077
-
1078
- ### 3. ユーザビリティテスト
1079
-
1080
- ```javascript
1081
- // Cypress E2Eテスト
1082
- describe('予約作成フロー', () => {
1083
- it('新規ユーザーでも2分以内に予約完了できる', () => {
1084
- const startTime = Date.now();
1085
-
1086
- cy.visit('/login');
1087
- cy.get('[data-cy=username]').type('newuser@example.com');
1088
- cy.get('[data-cy=password]').type('password123');
1089
- cy.get('[data-cy=login-button]').click();
1090
-
1091
- // 会議室検索
1092
- cy.get('[data-cy=room-search]').click();
1093
- cy.get('[data-cy=capacity-filter]').select('10');
1094
- cy.get('[data-cy=date-picker]').type('2024-12-01');
1095
- cy.get('[data-cy=search-button]').click();
1096
-
1097
- // 予約作成
1098
- cy.get('[data-cy=room-card]').first().click();
1099
- cy.get('[data-cy=time-slot]').contains('10:00-12:00').click();
1100
- cy.get('[data-cy=purpose]').type('定例会議');
1101
- cy.get('[data-cy=reserve-button]').click();
1102
-
1103
- // 完了確認
1104
- cy.get('[data-cy=success-message]').should('be.visible');
1105
-
1106
- const endTime = Date.now();
1107
- const duration = (endTime - startTime) / 1000; // 秒換算
1108
-
1109
- expect(duration).to.be.lessThan(120); // 2分以内
1110
- });
1111
-
1112
- it('アクセシビリティ基準を満たす', () => {
1113
- cy.visit('/reservations');
1114
- cy.injectAxe(); // axe-core ライブラリ
1115
-
1116
- cy.checkA11y(null, {
1117
- rules: {
1118
- 'color-contrast': { enabled: true },
1119
- 'keyboard-navigation': { enabled: true },
1120
- 'focus-management': { enabled: true }
1121
- }
1122
- });
1123
- });
1124
- });
1125
- ```
1126
-
1127
- ### 4. 継続的監視
1128
-
1129
- ```yaml
1130
- # Prometheus 監視ルール
1131
- groups:
1132
- - name: meeting-room-system
1133
- rules:
1134
- - alert: HighResponseTime
1135
- expr: histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m])) > 2
1136
- for: 2m
1137
- labels:
1138
- severity: warning
1139
- annotations:
1140
- summary: "API応答時間が遅延"
1141
- description: "95パーセンタイルの応答時間が2秒を超えています"
1142
-
1143
- - alert: HighErrorRate
1144
- expr: rate(http_requests_total{status=~"5.."}[5m]) > 0.05
1145
- for: 1m
1146
- labels:
1147
- severity: critical
1148
- annotations:
1149
- summary: "エラー率が高い"
1150
- description: "5xx エラーの発生率が5%を超えています"
1151
-
1152
- - alert: DatabaseConnectionFailure
1153
- expr: health_database_status != 1
1154
- for: 30s
1155
- labels:
1156
- severity: critical
1157
- annotations:
1158
- summary: "データベース接続失敗"
1159
- description: "データベースへの接続が失敗しています"
1160
- ```
1161
-
1162
- ## 非機能要件のライフサイクル管理
1163
-
1164
- ### 1. 要件定義フェーズ
1165
-
1166
- - ステークホルダー特定
1167
- - 品質属性の優先順位付け
1168
- - 測定可能な目標値設定
1169
- - 検証方法の決定
1170
- - 受け入れ基準の合意
1171
-
1172
- ### 2. 設計・実装フェーズ
1173
-
1174
- - アーキテクチャ設計への反映
1175
- - 非機能要件を満たす技術選択
1176
- - 測定・監視機能の実装
1177
- - テスト戦略への組み込み
1178
-
1179
- ### 3. テスト・検証フェーズ
1180
-
1181
- - パフォーマンステスト実行
1182
- - セキュリティテスト実行
1183
- - ユーザビリティテスト実行
1184
- - 受け入れ基準の検証
1185
- - 改善点の特定と対策
1186
-
1187
- ### 4. 運用フェーズ
1188
-
1189
- - 監視システム構築
1190
- - SLAの設定
1191
- - 定期的なパフォーマンス測定
1192
- - ユーザーフィードバック収集
1193
- - 継続的改善
1194
-
1195
- ## まとめ
1196
-
1197
- ### 非機能要件定義の要点
1198
-
1199
- 1. **品質属性の明確化**
1200
-
1201
- - ISO/IEC 25010 に基づく体系的な分類
1202
- - 測定可能な目標値の設定
1203
- - ステークホルダーとの合意形成
1204
-
1205
- 2. **実装と検証の統合**
1206
-
1207
- - アーキテクチャ設計への反映
1208
- - 自動テストによる継続的検証
1209
- - 運用監視との連携
1210
-
1211
- 3. **継続的改善**
1212
-
1213
- - 実運用データに基づく評価
1214
- - ユーザーフィードバックの活用
1215
- - 技術進歩に応じた要件見直し
1216
-
1217
- 4. **リスク管理**
1218
-
1219
- - 品質属性間のトレードオフの認識
1220
- - 優先順位に基づく段階的実装
1221
- - 早期の問題発見と対策
1222
-
1223
- ### 非機能要件がもたらす価値
1224
-
1225
- **短期的価値**:
1226
-
1227
- - システムの安定性と信頼性の確保
1228
- - ユーザー満足度の向上
1229
- - 運用コストの削減
1230
-
1231
- **長期的価値**:
1232
-
1233
- - 保守性による開発効率の維持
1234
- - 拡張性による事業成長への対応
1235
- - セキュリティによるリスク回避
1236
-
1
+ # 非機能要件定義ガイド
2
+
3
+ ## 概要
4
+
5
+ よいソフトウェアを作るための非機能要件定義について説明する。変更を楽に安全にできて役に立つソフトウェアを実現するため、品質属性を明確に定義し、測定可能な指標を設定する。
6
+
7
+ ## 非機能要件の基本原則
8
+
9
+ ### よいソフトウェアと非機能要件
10
+
11
+ 変更を楽に安全にできて役に立つソフトウェアを作るため、非機能要件は以下の価値を提供する:
12
+
13
+ 1. **安全な変更**: システムが安定して動作し続ける信頼性
14
+ 2. **楽な変更**: 保守性と拡張性により変更コストを最小化
15
+ 3. **役に立つ**: ユーザビリティとパフォーマンスによる価値提供
16
+ 4. **継続的価値**: 可用性と運用性による長期的な価値維持
17
+
18
+ ### 非機能要件の重要性
19
+
20
+ ```plantuml
21
+ @startuml
22
+ rectangle "機能要件" as Func {
23
+ - 何を実現するか
24
+ - ビジネス要求
25
+ - ユースケース
26
+ }
27
+
28
+ rectangle "非機能要件" as NonFunc {
29
+ - どの程度うまく実現するか
30
+ - 品質属性
31
+ - システム制約
32
+ }
33
+
34
+ @enduml
35
+ ```
36
+
37
+ ## ISO/IEC 25010 品質モデル
38
+
39
+ ### システム・ソフトウェア品質モデル
40
+
41
+ ```plantuml
42
+ @startuml
43
+ rectangle "ISO/IEC 25010 品質特性" {
44
+ rectangle "機能適合性" {
45
+ - 機能完全性
46
+ - 機能正確性
47
+ - 機能適切性
48
+ }
49
+
50
+ rectangle "性能効率性" {
51
+ - 時間効率性
52
+ - 資源効率性
53
+ - 容量満足性
54
+ }
55
+
56
+ rectangle "互換性" {
57
+ - 共存性
58
+ - 相互運用性
59
+ }
60
+
61
+ rectangle "使用性" {
62
+ - 適切度認識性
63
+ - 習得性
64
+ - 運用性
65
+ - ユーザーエラー防止性
66
+ - UI快美性
67
+ - アクセシビリティ
68
+ }
69
+
70
+ rectangle "信頼性" {
71
+ - 成熟性
72
+ - 可用性
73
+ - 障害許容性
74
+ - 回復性
75
+ }
76
+
77
+ rectangle "セキュリティ" {
78
+ - 機密性
79
+ - 完全性
80
+ - 否認防止性
81
+ - 責任追跡性
82
+ - 真正性
83
+ }
84
+
85
+ rectangle "保守性" {
86
+ - モジュール性
87
+ - 再利用性
88
+ - 解析性
89
+ - 修正性
90
+ - 試験性
91
+ }
92
+
93
+ rectangle "移植性" {
94
+ - 適応性
95
+ - 設置性
96
+ - 置換性
97
+ }
98
+ }
99
+ @enduml
100
+ ```
101
+
102
+ ### 品質特性の詳細
103
+
104
+ #### 機能適合性(Functional Suitability)
105
+ - **機能完全性**: 指定されたタスクと目標をカバーする機能の度合い
106
+ - **機能正確性**: 正確な結果を提供する機能の度合い
107
+ - **機能適切性**: 指定されたタスクと目標を促進する機能の度合い
108
+
109
+ #### 性能効率性(Performance Efficiency)
110
+ - **時間効率性**: 応答時間、処理時間、スループット
111
+ - **資源効率性**: CPU、メモリ、ネットワーク、ストレージの使用量
112
+ - **容量満足性**: 最大限界値(ユーザー数、データ量など)
113
+
114
+ #### 互換性(Compatibility)
115
+ - **共存性**: 他のソフトウェアと共通環境でリソースを共有する度合い
116
+ - **相互運用性**: 他のシステムと情報交換し機能を利用する度合い
117
+
118
+ #### 使用性(Usability)
119
+ - **適切度認識性**: ユーザーが適切性を認識する度合い
120
+ - **習得性**: 学習のしやすさ
121
+ - **運用性**: 操作・制御のしやすさ
122
+ - **ユーザーエラー防止性**: エラーを防護する度合い
123
+ - **UI快美性**: 満足感を与える度合い
124
+ - **アクセシビリティ**: 幅広いユーザーが使用できる度合い
125
+
126
+ #### 信頼性(Reliability)
127
+ - **成熟性**: 通常運用下で信頼性要求を満足する度合い
128
+ - **可用性**: 運用可能で利用できる度合い
129
+ - **障害許容性**: 障害にもかかわらず動作する度合い
130
+ - **回復性**: 障害後に回復し影響データを復旧する度合い
131
+
132
+ #### セキュリティ(Security)
133
+ - **機密性**: 認可されたもののみがアクセスできる度合い
134
+ - **完全性**: データや計算方法への不正アクセスを防ぐ度合い
135
+ - **否認防止性**: アクションや事象が起きたことを証明する度合い
136
+ - **責任追跡性**: エンティティのアクションを一意に追跡する度合い
137
+ - **真正性**: 主張されたアイデンティティを証明する度合い
138
+
139
+ #### 保守性(Maintainability)
140
+ - **モジュール性**: 構成要素への変更が他に与える影響が最小限の度合い
141
+ - **再利用性**: 他のシステムで利用できる度合い
142
+ - **解析性**: 変更の影響を評価する度合い
143
+ - **修正性**: 欠陥除去や改善を効果的かつ効率的に行える度合い
144
+ - **試験性**: テスト基準を確立しテストを実行する度合い
145
+
146
+ #### 移植性(Portability)
147
+ - **適応性**: 異なるハードウェア・ソフトウェア環境に適応する度合い
148
+ - **設置性**: 指定された環境に設置する度合い
149
+ - **置換性**: 同じ目的の他のソフトウェアと置き換える度合い
150
+
151
+ ## 非機能要件の分類
152
+
153
+ ### FURPS+ モデル
154
+
155
+ ```plantuml
156
+ @startuml
157
+ rectangle "FURPS+ モデル" {
158
+ rectangle "Functionality" {
159
+ - 機能性
160
+ - セキュリティ
161
+ - API
162
+ - インターフェース
163
+ }
164
+
165
+ rectangle "Usability" {
166
+ - 使いやすさ
167
+ - ユーザビリティ
168
+ - アクセシビリティ
169
+ - ドキュメント
170
+ }
171
+
172
+ rectangle "Reliability" {
173
+ - 信頼性
174
+ - 可用性
175
+ - 故障率
176
+ - 復旧時間
177
+ }
178
+
179
+ rectangle "Performance" {
180
+ - パフォーマンス
181
+ - 応答時間
182
+ - スループット
183
+ - 容量
184
+ }
185
+
186
+ rectangle "Supportability" {
187
+ - サポート性
188
+ - 保守性
189
+ - 拡張性
190
+ - 設定性
191
+ }
192
+
193
+ rectangle "Plus" {
194
+ - 実装制約
195
+ - インターフェース制約
196
+ - 運用制約
197
+ - パッケージ制約
198
+ - 法的制約
199
+ }
200
+ }
201
+ @enduml
202
+ ```
203
+
204
+ ### 会議室予約システムの非機能要件分類
205
+
206
+ #### 性能要件(Performance Requirements)
207
+ - **応答時間**: ユーザーアクションに対するレスポンス時間
208
+ - **スループット**: 同時処理可能な予約数・ユーザー数
209
+ - **容量**: 保存可能なデータ量、サポートするユーザー数
210
+
211
+ #### 可用性・信頼性要件(Availability & Reliability Requirements)
212
+ - **稼働率**: システムが利用可能な時間の割合
213
+ - **障害回復**: システム障害からの回復時間
214
+ - **データ保護**: データの損失防止とバックアップ
215
+
216
+ #### セキュリティ要件(Security Requirements)
217
+ - **認証・認可**: ユーザー識別とアクセス制御
218
+ - **データ保護**: 個人情報・機密情報の保護
219
+ - **監査**: アクセスログと操作履歴の記録
220
+
221
+ #### 使用性要件(Usability Requirements)
222
+ - **操作性**: 直感的で使いやすいインターフェース
223
+ - **アクセシビリティ**: 多様なユーザーへの対応
224
+ - **応答性**: レスポンシブデザインと快適な操作感
225
+
226
+ #### 保守性・拡張性要件(Maintainability & Scalability Requirements)
227
+ - **保守性**: コードの理解しやすさと変更容易性
228
+ - **拡張性**: 機能追加とユーザー増加への対応
229
+ - **監視性**: システム状態の把握と問題の早期発見
230
+
231
+ #### 互換性・移植性要件(Compatibility & Portability Requirements)
232
+ - **ブラウザ互換性**: 複数ブラウザでの動作保証
233
+ - **デバイス対応**: PC、タブレット、スマートフォン対応
234
+ - **システム連携**: 既存システムとの連携能力
235
+
236
+ ## 会議室予約システムの非機能要件詳細
237
+
238
+ ### 1. 性能要件(Performance Requirements)
239
+
240
+ #### 1.1 応答時間要件
241
+
242
+ ```plantuml
243
+ @startuml
244
+ rectangle "応答時間要件" {
245
+ rectangle "ページ表示" {
246
+ - 初回ページ読み込み: < 3秒
247
+ - ページ遷移: < 1秒
248
+ - 部分更新: < 500ms
249
+ }
250
+
251
+ rectangle "API応答" {
252
+ - 会議室検索: < 1秒
253
+ - 予約作成: < 2秒
254
+ - 予約変更・キャンセル: < 1秒
255
+ - ユーザー認証: < 1秒
256
+ }
257
+
258
+ rectangle "バッチ処理" {
259
+ - データ集計: < 30秒
260
+ - レポート生成: < 60秒
261
+ - データアーカイブ: < 10分
262
+ }
263
+ }
264
+ @enduml
265
+ ```
266
+
267
+ **測定方法**:
268
+ ```javascript
269
+ // フロントエンド性能測定
270
+ const observer = new PerformanceObserver((list) => {
271
+ list.getEntries().forEach((entry) => {
272
+ console.log(`${entry.name}: ${entry.duration}ms`);
273
+ });
274
+ });
275
+ observer.observe({ entryTypes: ['navigation', 'measure'] });
276
+
277
+ // API応答時間測定
278
+ const startTime = performance.now();
279
+ await fetch('/api/reservations');
280
+ const endTime = performance.now();
281
+ console.log(`API応答時間: ${endTime - startTime}ms`);
282
+ ```
283
+
284
+ **実装例**:
285
+ ```java
286
+ // バックエンド性能監視
287
+ @RestController
288
+ @Timed // Micrometer アノテーション
289
+ public class ReservationController {
290
+
291
+ @GetMapping("/reservations")
292
+ @Timed(name = "reservation.search", description = "予約検索処理時間")
293
+ public ResponseEntity<List<ReservationResponse>> searchReservations(
294
+ @RequestParam ReservationSearchCriteria criteria) {
295
+ // 処理実装
296
+ }
297
+ }
298
+
299
+ // データベースクエリ最適化
300
+ @Repository
301
+ public class ReservationRepository {
302
+
303
+ @Query(value = """
304
+ SELECT r FROM Reservation r
305
+ WHERE r.roomId = :roomId
306
+ AND r.startTime >= :startDate
307
+ AND r.endTime <= :endDate
308
+ AND r.status IN ('CONFIRMED', 'PENDING')
309
+ """)
310
+ List<Reservation> findActiveByRoomAndDateRange(
311
+ @Param("roomId") UUID roomId,
312
+ @Param("startDate") LocalDateTime startDate,
313
+ @Param("endDate") LocalDateTime endDate);
314
+ }
315
+ ```
316
+
317
+ #### 1.2 スループット要件
318
+
319
+ - **同時ユーザー数**: 100名(ピーク時200名まで対応)
320
+ - **予約処理能力**: 毎秒10件の予約処理
321
+ - **データ容量**: 年間10,000件の予約データ、5年間保持
322
+
323
+ ```java
324
+ // 負荷テスト設定例
325
+ @Test
326
+ @LoadTest(users = 100, duration = 300) // 100ユーザー、5分間
327
+ void 予約作成の負荷テスト() {
328
+ CreateReservationRequest request = createTestRequest();
329
+
330
+ ResponseEntity<ReservationResponse> response = restTemplate.postForEntity(
331
+ "/api/reservations", request, ReservationResponse.class);
332
+
333
+ assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
334
+ assertThat(response.getBody().getReservationId()).isNotNull();
335
+ }
336
+ ```
337
+
338
+ ### 2. 可用性・信頼性要件(Availability & Reliability Requirements)
339
+
340
+ #### 2.1 稼働率要件
341
+
342
+ ```plantuml
343
+ @startuml
344
+ rectangle "可用性・信頼性要件" {
345
+ rectangle "可用性レベル" {
346
+ - 稼働率 99.9%: 年間ダウンタイム < 8.77時間
347
+ - 営業時間内 99.95%: 月間ダウンタイム < 22分
348
+ - 計画停止除く: 営業時間外のメンテナンス許可
349
+ }
350
+
351
+ rectangle "障害対応" {
352
+ - 検知時間: < 5分
353
+ - 初期対応: < 15分
354
+ - 復旧時間: < 2時間(重大障害)
355
+ - 回復時間: < 30分(軽微な障害)
356
+ }
357
+
358
+ rectangle "データ保護" {
359
+ - バックアップ: 日次・週次・月次
360
+ - 復旧時間: < 4時間(RPO: 1時間以内)
361
+ - データ整合性: トランザクション保証
362
+ }
363
+ }
364
+ @enduml
365
+ ```
366
+
367
+ **実装例**:
368
+ ```yaml
369
+ # Docker Compose でのヘルスチェック
370
+ services:
371
+ app:
372
+ image: meeting-room-app:latest
373
+ healthcheck:
374
+ test: ["CMD", "curl", "-f", "http://localhost:8080/actuator/health"]
375
+ interval: 30s
376
+ timeout: 10s
377
+ retries: 3
378
+ start_period: 60s
379
+ restart: unless-stopped
380
+
381
+ database:
382
+ image: postgres:15
383
+ healthcheck:
384
+ test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER}"]
385
+ interval: 10s
386
+ timeout: 5s
387
+ retries: 5
388
+ ```
389
+
390
+ ```java
391
+ // Spring Boot Actuator によるヘルスチェック
392
+ @Component
393
+ public class DatabaseHealthIndicator implements HealthIndicator {
394
+
395
+ private final DataSource dataSource;
396
+
397
+ @Override
398
+ public Health health() {
399
+ try (Connection connection = dataSource.getConnection()) {
400
+ if (connection.isValid(1)) {
401
+ return Health.up()
402
+ .withDetail("database", "Available")
403
+ .withDetail("validationQuery", "SELECT 1")
404
+ .build();
405
+ }
406
+ } catch (SQLException e) {
407
+ return Health.down(e)
408
+ .withDetail("database", "Unavailable")
409
+ .build();
410
+ }
411
+ return Health.down()
412
+ .withDetail("database", "Unknown")
413
+ .build();
414
+ }
415
+ }
416
+ ```
417
+
418
+ #### 2.2 障害許容性
419
+
420
+ ```java
421
+ // Circuit Breaker パターン実装
422
+ @Component
423
+ public class ExternalServiceClient {
424
+
425
+ private final CircuitBreaker circuitBreaker;
426
+
427
+ public ExternalServiceClient() {
428
+ this.circuitBreaker = CircuitBreaker.ofDefaults("externalService");
429
+ circuitBreaker.getEventPublisher()
430
+ .onStateTransition(event ->
431
+ log.info("Circuit breaker state transition: {}", event));
432
+ }
433
+
434
+ public Optional<String> callExternalService(String request) {
435
+ return circuitBreaker.executeSupplier(() -> {
436
+ // 外部サービス呼び出し
437
+ return externalServiceCall(request);
438
+ });
439
+ }
440
+ }
441
+
442
+ // 再試行機能
443
+ @Retryable(
444
+ value = {DataAccessException.class},
445
+ maxAttempts = 3,
446
+ backoff = @Backoff(delay = 1000, multiplier = 2)
447
+ )
448
+ public Reservation saveReservation(Reservation reservation) {
449
+ return reservationRepository.save(reservation);
450
+ }
451
+ ```
452
+
453
+ ### 3. セキュリティ要件(Security Requirements)
454
+
455
+ #### 3.1 認証・認可要件
456
+
457
+ ```plantuml
458
+ @startuml
459
+ rectangle "セキュリティ要件" {
460
+ rectangle "認証" {
461
+ - JWT Bearer Token: 有効期限 24時間
462
+ - リフレッシュトークン: 有効期限 30日
463
+ - 多要素認証: 管理者必須
464
+ - パスワード強度: 8文字以上、複雑性要求
465
+ }
466
+
467
+ rectangle "認可" {
468
+ - RBAC: ロールベースアクセス制御
469
+ - リソースレベル制御: 予約・会議室・ユーザー
470
+ - API エンドポイント保護: 全API認証必須
471
+ }
472
+
473
+ rectangle "データ保護" {
474
+ - 暗号化: 保存時・転送時
475
+ - 個人情報保護: GDPR準拠
476
+ - 監査ログ: 全操作記録
477
+ }
478
+ }
479
+ @enduml
480
+ ```
481
+
482
+ **実装例**:
483
+ ```java
484
+ // JWT セキュリティ設定
485
+ @Configuration
486
+ @EnableWebSecurity
487
+ @EnableMethodSecurity
488
+ public class SecurityConfig {
489
+
490
+ @Bean
491
+ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
492
+ return http
493
+ .csrf(csrf -> csrf.disable())
494
+ .sessionManagement(session ->
495
+ session.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
496
+ .authorizeHttpRequests(auth -> auth
497
+ .requestMatchers("/api/auth/**").permitAll()
498
+ .requestMatchers(HttpMethod.GET, "/api/rooms").hasAnyRole("USER", "ADMIN")
499
+ .requestMatchers("/api/reservations/**").hasAnyRole("USER", "ADMIN")
500
+ .requestMatchers("/api/admin/**").hasRole("ADMIN")
501
+ .anyRequest().authenticated())
502
+ .oauth2ResourceServer(oauth2 -> oauth2
503
+ .jwt(jwt -> jwt.jwtAuthenticationConverter(jwtAuthConverter())))
504
+ .build();
505
+ }
506
+
507
+ @Bean
508
+ public PasswordEncoder passwordEncoder() {
509
+ return new BCryptPasswordEncoder(12); // 強度12
510
+ }
511
+ }
512
+
513
+ // 認可制御
514
+ @PreAuthorize("hasRole('ADMIN') or @reservationSecurityService.canAccessReservation(#reservationId, authentication.name)")
515
+ public ReservationResponse getReservation(@PathVariable String reservationId) {
516
+ // 実装
517
+ }
518
+
519
+ // 監査ログ
520
+ @EventListener
521
+ public class AuditEventListener {
522
+
523
+ @Async
524
+ @EventListener
525
+ public void handleAuditEvent(AuditEvent event) {
526
+ AuditLog auditLog = AuditLog.builder()
527
+ .userId(event.getPrincipal())
528
+ .action(event.getType())
529
+ .resource(event.getData().toString())
530
+ .timestamp(LocalDateTime.now())
531
+ .ipAddress(getClientIpAddress())
532
+ .userAgent(getUserAgent())
533
+ .build();
534
+
535
+ auditLogRepository.save(auditLog);
536
+ }
537
+ }
538
+ ```
539
+
540
+ #### 3.2 データ暗号化
541
+
542
+ ```java
543
+ // 個人情報暗号化
544
+ @Entity
545
+ @Table(name = "users")
546
+ public class User {
547
+
548
+ @Id
549
+ private UUID id;
550
+
551
+ @Column(name = "username")
552
+ private String username;
553
+
554
+ @Convert(converter = EncryptedStringConverter.class)
555
+ @Column(name = "email")
556
+ private String email; // 暗号化保存
557
+
558
+ @Convert(converter = EncryptedStringConverter.class)
559
+ @Column(name = "full_name")
560
+ private String fullName; // 暗号化保存
561
+
562
+ @Column(name = "password_hash")
563
+ private String passwordHash; // BCrypt ハッシュ
564
+ }
565
+
566
+ // 暗号化コンバーター
567
+ @Component
568
+ public class EncryptedStringConverter implements AttributeConverter<String, String> {
569
+
570
+ @Autowired
571
+ private AESEncryptionService encryptionService;
572
+
573
+ @Override
574
+ public String convertToDatabaseColumn(String attribute) {
575
+ return attribute == null ? null : encryptionService.encrypt(attribute);
576
+ }
577
+
578
+ @Override
579
+ public String convertToEntityAttribute(String dbData) {
580
+ return dbData == null ? null : encryptionService.decrypt(dbData);
581
+ }
582
+ }
583
+ ```
584
+
585
+ ### 4. 使用性要件(Usability Requirements)
586
+
587
+ #### 4.1 ユーザビリティ要件
588
+
589
+ ```plantuml
590
+ @startuml
591
+ rectangle "ユーザビリティ要件" {
592
+ rectangle "操作性" {
593
+ - 3クリック原則: 主要機能は3クリック以内
594
+ - 予約完了時間: < 2分(初回ユーザー)
595
+ - 学習時間: < 30分(新規ユーザー)
596
+ - エラー回復: 1クリックで前の状態に復帰
597
+ }
598
+
599
+ rectangle "アクセシビリティ" {
600
+ - WCAG 2.1 AA: Web Content Accessibility Guidelines 準拠
601
+ - キーボード操作: 全機能をキーボードで操作可能
602
+ - スクリーンリーダー: 対応必須
603
+ - 色覚対応: カラーユニバーサルデザイン
604
+ }
605
+
606
+ rectangle "レスポンシブ" {
607
+ - デスクトップ: 1920x1080以上推奨
608
+ - タブレット: 768px以上対応
609
+ - スマートフォン: 375px以上対応
610
+ - ブラウザ: Chrome, Firefox, Safari, Edge 最新版
611
+ }
612
+ }
613
+ @enduml
614
+ ```
615
+
616
+ **実装例**:
617
+ ```tsx
618
+ // アクセシビリティ対応コンポーネント
619
+ interface ReservationFormProps {
620
+ onSubmit: (data: ReservationFormData) => void;
621
+ }
622
+
623
+ export const ReservationForm: React.FC<ReservationFormProps> = ({ onSubmit }) => {
624
+ return (
625
+ <form onSubmit={handleSubmit} role="form" aria-label="会議室予約フォーム">
626
+ <fieldset>
627
+ <legend>予約情報</legend>
628
+
629
+ <div className="form-group">
630
+ <label htmlFor="room-select" className="required">
631
+ 会議室選択
632
+ </label>
633
+ <select
634
+ id="room-select"
635
+ aria-required="true"
636
+ aria-describedby="room-help"
637
+ {...register('roomId', { required: '会議室を選択してください' })}
638
+ >
639
+ <option value="">選択してください</option>
640
+ {rooms.map(room => (
641
+ <option key={room.id} value={room.id}>
642
+ {room.name} (収容人数: {room.capacity}名)
643
+ </option>
644
+ ))}
645
+ </select>
646
+ <div id="room-help" className="help-text">
647
+ 希望する会議室を選択してください
648
+ </div>
649
+ {errors.roomId && (
650
+ <div role="alert" className="error-message">
651
+ {errors.roomId.message}
652
+ </div>
653
+ )}
654
+ </div>
655
+
656
+ <div className="form-group">
657
+ <label htmlFor="date-input" className="required">
658
+ 利用日
659
+ </label>
660
+ <input
661
+ type="date"
662
+ id="date-input"
663
+ aria-required="true"
664
+ min={new Date().toISOString().split('T')[0]}
665
+ {...register('date', { required: '利用日を選択してください' })}
666
+ />
667
+ </div>
668
+
669
+ <button
670
+ type="submit"
671
+ disabled={isSubmitting}
672
+ aria-describedby="submit-help"
673
+ >
674
+ {isSubmitting ? '予約中...' : '予約する'}
675
+ </button>
676
+ <div id="submit-help" className="help-text">
677
+ 入力内容を確認して予約ボタンをクリックしてください
678
+ </div>
679
+ </fieldset>
680
+ </form>
681
+ );
682
+ };
683
+
684
+ // レスポンシブデザイン
685
+ const ReservationCard = styled.div`
686
+ padding: 1rem;
687
+ border: 1px solid #e2e8f0;
688
+ border-radius: 0.5rem;
689
+
690
+ @media (min-width: 768px) {
691
+ padding: 1.5rem;
692
+ display: grid;
693
+ grid-template-columns: 1fr auto;
694
+ gap: 1rem;
695
+ }
696
+
697
+ @media (min-width: 1024px) {
698
+ padding: 2rem;
699
+ }
700
+ `;
701
+ ```
702
+
703
+ #### 4.2 ユーザーエクスペリエンス指標
704
+
705
+ ```javascript
706
+ // Core Web Vitals 測定
707
+ import { getCLS, getFID, getFCP, getLCP, getTTFB } from 'web-vitals';
708
+
709
+ function sendToAnalytics(metric) {
710
+ // 分析ツールへの送信
711
+ analytics.track('Performance Metric', {
712
+ name: metric.name,
713
+ value: metric.value,
714
+ rating: metric.rating
715
+ });
716
+ }
717
+
718
+ // 各指標の測定
719
+ getCLS(sendToAnalytics); // Cumulative Layout Shift < 0.1
720
+ getFID(sendToAnalytics); // First Input Delay < 100ms
721
+ getFCP(sendToAnalytics); // First Contentful Paint < 1.8s
722
+ getLCP(sendToAnalytics); // Largest Contentful Paint < 2.5s
723
+ getTTFB(sendToAnalytics); // Time to First Byte < 0.8s
724
+
725
+ // ユーザー行動分析
726
+ const trackUserInteraction = (action, element, duration) => {
727
+ analytics.track('User Interaction', {
728
+ action,
729
+ element,
730
+ duration,
731
+ timestamp: new Date().toISOString(),
732
+ userId: getCurrentUserId()
733
+ });
734
+ };
735
+
736
+ // 予約プロセス分析
737
+ const reservationFlowTracking = {
738
+ searchStart: () => trackUserInteraction('search_start', 'room_search', 0),
739
+ searchComplete: (duration) => trackUserInteraction('search_complete', 'room_search', duration),
740
+ reservationStart: () => trackUserInteraction('reservation_start', 'reservation_form', 0),
741
+ reservationComplete: (duration) => trackUserInteraction('reservation_complete', 'reservation_form', duration),
742
+ reservationAbandoned: (step, duration) => trackUserInteraction('reservation_abandoned', step, duration)
743
+ };
744
+ ```
745
+
746
+ ### 5. 保守性・拡張性要件(Maintainability & Scalability Requirements)
747
+
748
+ #### 5.1 保守性要件
749
+
750
+ ```plantuml
751
+ @startuml
752
+ rectangle "保守性要件" {
753
+ rectangle "コード品質" {
754
+ - テストカバレッジ: > 80%(ドメイン層 > 90%)
755
+ - 複雑度: Cyclomatic Complexity < 10
756
+ - 重複コード: < 3%
757
+ - 技術的負債: SonarQube Rating A
758
+ }
759
+
760
+ rectangle "ドキュメント" {
761
+ - API ドキュメント: OpenAPI 3.0 準拠
762
+ - アーキテクチャ図: C4 モデル
763
+ - 運用手順書: 障害対応・デプロイ手順
764
+ - 更新頻度: コード変更と同時更新
765
+ }
766
+
767
+ rectangle "監視・ログ" {
768
+ - 構造化ログ: JSON形式、分析可能
769
+ - メトリクス: Micrometer + Prometheus
770
+ - 分散トレーシング: Jaeger 対応
771
+ - アラート: SLA 違反時の自動通知
772
+ }
773
+ }
774
+ @enduml
775
+ ```
776
+
777
+ **実装例**:
778
+ ```java
779
+ // 構造化ログ
780
+ @RestController
781
+ @Slf4j
782
+ public class ReservationController {
783
+
784
+ @PostMapping("/reservations")
785
+ public ResponseEntity<ReservationResponse> createReservation(
786
+ @RequestBody CreateReservationRequest request,
787
+ HttpServletRequest httpRequest) {
788
+
789
+ MDC.put("userId", getCurrentUserId());
790
+ MDC.put("correlationId", UUID.randomUUID().toString());
791
+ MDC.put("ipAddress", getClientIpAddress(httpRequest));
792
+
793
+ try {
794
+ log.info("Creating reservation: roomId={}, startTime={}",
795
+ request.getRoomId(), request.getStartTime());
796
+
797
+ ReservationId reservationId = createReservationUseCase.execute(
798
+ mapToCommand(request));
799
+
800
+ log.info("Reservation created successfully: reservationId={}", reservationId);
801
+
802
+ return ResponseEntity.status(HttpStatus.CREATED)
803
+ .body(ReservationResponse.from(reservationId));
804
+
805
+ } catch (Exception e) {
806
+ log.error("Failed to create reservation", e);
807
+ throw e;
808
+ } finally {
809
+ MDC.clear();
810
+ }
811
+ }
812
+ }
813
+
814
+ // メトリクス収集
815
+ @Component
816
+ @Service
817
+ public class ReservationMetricsService {
818
+
819
+ private final MeterRegistry meterRegistry;
820
+ private final Counter reservationCreatedCounter;
821
+ private final Counter reservationFailedCounter;
822
+ private final Timer reservationProcessingTimer;
823
+
824
+ public ReservationMetricsService(MeterRegistry meterRegistry) {
825
+ this.meterRegistry = meterRegistry;
826
+ this.reservationCreatedCounter = Counter.builder("reservation.created")
827
+ .description("Created reservations count")
828
+ .register(meterRegistry);
829
+ this.reservationFailedCounter = Counter.builder("reservation.failed")
830
+ .description("Failed reservations count")
831
+ .register(meterRegistry);
832
+ this.reservationProcessingTimer = Timer.builder("reservation.processing")
833
+ .description("Reservation processing time")
834
+ .register(meterRegistry);
835
+ }
836
+
837
+ public void recordReservationCreated() {
838
+ reservationCreatedCounter.increment();
839
+ }
840
+
841
+ public void recordReservationFailed(String reason) {
842
+ reservationFailedCounter.increment(Tags.of("reason", reason));
843
+ }
844
+
845
+ public Timer.Sample startProcessingTimer() {
846
+ return Timer.start(meterRegistry);
847
+ }
848
+ }
849
+ ```
850
+
851
+ #### 5.2 拡張性要件
852
+
853
+ ```java
854
+ // 水平スケーリング対応
855
+ @Configuration
856
+ @EnableCaching
857
+ public class CacheConfig {
858
+
859
+ @Bean
860
+ public CacheManager cacheManager() {
861
+ RedisCacheManager.Builder builder = RedisCacheManager
862
+ .RedisCacheManagerBuilder
863
+ .fromConnectionFactory(jedisConnectionFactory())
864
+ .cacheDefaults(cacheConfiguration());
865
+
866
+ return builder.build();
867
+ }
868
+
869
+ private RedisCacheConfiguration cacheConfiguration() {
870
+ return RedisCacheConfiguration.defaultCacheConfig()
871
+ .entryTtl(Duration.ofMinutes(10))
872
+ .serializeKeysWith(RedisSerializationContext.SerializationPair
873
+ .fromSerializer(new StringRedisSerializer()))
874
+ .serializeValuesWith(RedisSerializationContext.SerializationPair
875
+ .fromSerializer(new GenericJackson2JsonRedisSerializer()));
876
+ }
877
+ }
878
+
879
+ // データベースパーティショニング
880
+ @Entity
881
+ @Table(name = "reservations")
882
+ @PartitionKey("DATE(start_time)") // 日付によるパーティショニング
883
+ public class ReservationEntity {
884
+ // エンティティ定義
885
+ }
886
+
887
+ // マイクロサービス化の準備
888
+ @FeignClient(name = "notification-service", url = "${services.notification.url}")
889
+ public interface NotificationServiceClient {
890
+
891
+ @PostMapping("/notifications")
892
+ ResponseEntity<Void> sendNotification(@RequestBody NotificationRequest request);
893
+ }
894
+ ```
895
+
896
+ ### 6. 運用要件(Operational Requirements)
897
+
898
+ #### 6.1 監視・運用要件
899
+
900
+ ```yaml
901
+ # Kubernetes デプロイメント設定
902
+ apiVersion: apps/v1
903
+ kind: Deployment
904
+ metadata:
905
+ name: meeting-room-app
906
+ spec:
907
+ replicas: 3
908
+ selector:
909
+ matchLabels:
910
+ app: meeting-room-app
911
+ template:
912
+ spec:
913
+ containers:
914
+ - name: app
915
+ image: meeting-room-app:latest
916
+ ports:
917
+ - containerPort: 8080
918
+ resources:
919
+ requests:
920
+ memory: "512Mi"
921
+ cpu: "500m"
922
+ limits:
923
+ memory: "1Gi"
924
+ cpu: "1000m"
925
+ livenessProbe:
926
+ httpGet:
927
+ path: /actuator/health/liveness
928
+ port: 8080
929
+ initialDelaySeconds: 60
930
+ periodSeconds: 30
931
+ readinessProbe:
932
+ httpGet:
933
+ path: /actuator/health/readiness
934
+ port: 8080
935
+ initialDelaySeconds: 30
936
+ periodSeconds: 10
937
+ env:
938
+ - name: JAVA_OPTS
939
+ value: "-Xms512m -Xmx1g -XX:+UseG1GC"
940
+ - name: SPRING_PROFILES_ACTIVE
941
+ value: "production"
942
+ ```
943
+
944
+ ```java
945
+ // カスタムヘルスチェック
946
+ @Component
947
+ public class ReservationSystemHealthIndicator implements HealthIndicator {
948
+
949
+ private final ReservationRepository reservationRepository;
950
+ private final NotificationServiceClient notificationService;
951
+
952
+ @Override
953
+ public Health health() {
954
+ Health.Builder status = Health.up();
955
+
956
+ try {
957
+ // データベース接続確認
958
+ long activeReservationsCount = reservationRepository.countActiveReservations();
959
+ status.withDetail("database", Map.of(
960
+ "status", "UP",
961
+ "activeReservations", activeReservationsCount
962
+ ));
963
+
964
+ // 外部サービス接続確認
965
+ boolean notificationServiceUp = checkNotificationService();
966
+ status.withDetail("notificationService", Map.of(
967
+ "status", notificationServiceUp ? "UP" : "DOWN"
968
+ ));
969
+
970
+ // システムリソース確認
971
+ status.withDetail("system", getSystemMetrics());
972
+
973
+ } catch (Exception e) {
974
+ return Health.down(e).build();
975
+ }
976
+
977
+ return status.build();
978
+ }
979
+
980
+ private Map<String, Object> getSystemMetrics() {
981
+ Runtime runtime = Runtime.getRuntime();
982
+ long maxMemory = runtime.maxMemory();
983
+ long totalMemory = runtime.totalMemory();
984
+ long freeMemory = runtime.freeMemory();
985
+
986
+ return Map.of(
987
+ "memory.max", maxMemory,
988
+ "memory.total", totalMemory,
989
+ "memory.free", freeMemory,
990
+ "memory.used", totalMemory - freeMemory,
991
+ "processors", runtime.availableProcessors()
992
+ );
993
+ }
994
+ }
995
+ ```
996
+
997
+ ## 非機能要件の測定と検証
998
+
999
+ ### 1. パフォーマンステスト
1000
+
1001
+ ```java
1002
+ // JMeter 負荷テストシナリオ
1003
+ @Test
1004
+ public class PerformanceTest {
1005
+
1006
+ @LoadTest(
1007
+ users = 100,
1008
+ rampUp = 60, // 60秒で100ユーザーまで増加
1009
+ duration = 300 // 5分間実行
1010
+ )
1011
+ public void 予約作成負荷テスト() {
1012
+ // 予約作成APIの負荷テスト
1013
+ given()
1014
+ .contentType(ContentType.JSON)
1015
+ .body(createReservationRequest())
1016
+ .when()
1017
+ .post("/api/reservations")
1018
+ .then()
1019
+ .statusCode(201)
1020
+ .time(lessThan(2000L)); // 2秒以内
1021
+ }
1022
+
1023
+ @PerformanceTest
1024
+ @JvmOptions({"-Xms1g", "-Xmx2g", "-XX:+UseG1GC"})
1025
+ public void メモリ使用量テスト() {
1026
+ // メモリ使用量とGCの影響を測定
1027
+ for (int i = 0; i < 10000; i++) {
1028
+ createAndProcessReservation();
1029
+ }
1030
+
1031
+ // メモリ使用量を確認
1032
+ assertThat(getUsedMemoryMB()).isLessThan(1500); // 1.5GB以下
1033
+ assertThat(getGcPauseTimeMs()).isLessThan(100); // GC停止時間100ms以下
1034
+ }
1035
+ }
1036
+ ```
1037
+
1038
+ ### 2. セキュリティテスト
1039
+
1040
+ ```java
1041
+ // セキュリティテスト
1042
+ @SpringBootTest
1043
+ @AutoConfigureMockMvc
1044
+ public class SecurityTest {
1045
+
1046
+ @Test
1047
+ public void 認証なしでアクセスすると401エラー() throws Exception {
1048
+ mockMvc.perform(get("/api/reservations"))
1049
+ .andExpect(status().isUnauthorized());
1050
+ }
1051
+
1052
+ @Test
1053
+ public void 無効なJWTトークンで401エラー() throws Exception {
1054
+ mockMvc.perform(get("/api/reservations")
1055
+ .header("Authorization", "Bearer invalid-token"))
1056
+ .andExpected(status().isUnauthorized());
1057
+ }
1058
+
1059
+ @Test
1060
+ @WithMockUser(roles = "USER")
1061
+ public void 管理者権限なしで管理APIにアクセスすると403エラー() throws Exception {
1062
+ mockMvc.perform(get("/api/admin/users"))
1063
+ .andExpect(status().isForbidden());
1064
+ }
1065
+
1066
+ @Test
1067
+ public void SQLインジェクション攻撃をブロック() throws Exception {
1068
+ String maliciousInput = "'; DROP TABLE users; --";
1069
+
1070
+ mockMvc.perform(get("/api/reservations")
1071
+ .param("search", maliciousInput))
1072
+ .andExpect(status().isBadRequest())
1073
+ .andExpect(jsonPath("$.error").value("INVALID_INPUT"));
1074
+ }
1075
+ }
1076
+ ```
1077
+
1078
+ ### 3. ユーザビリティテスト
1079
+
1080
+ ```javascript
1081
+ // Cypress E2Eテスト
1082
+ describe('予約作成フロー', () => {
1083
+ it('新規ユーザーでも2分以内に予約完了できる', () => {
1084
+ const startTime = Date.now();
1085
+
1086
+ cy.visit('/login');
1087
+ cy.get('[data-cy=username]').type('newuser@example.com');
1088
+ cy.get('[data-cy=password]').type('password123');
1089
+ cy.get('[data-cy=login-button]').click();
1090
+
1091
+ // 会議室検索
1092
+ cy.get('[data-cy=room-search]').click();
1093
+ cy.get('[data-cy=capacity-filter]').select('10');
1094
+ cy.get('[data-cy=date-picker]').type('2024-12-01');
1095
+ cy.get('[data-cy=search-button]').click();
1096
+
1097
+ // 予約作成
1098
+ cy.get('[data-cy=room-card]').first().click();
1099
+ cy.get('[data-cy=time-slot]').contains('10:00-12:00').click();
1100
+ cy.get('[data-cy=purpose]').type('定例会議');
1101
+ cy.get('[data-cy=reserve-button]').click();
1102
+
1103
+ // 完了確認
1104
+ cy.get('[data-cy=success-message]').should('be.visible');
1105
+
1106
+ const endTime = Date.now();
1107
+ const duration = (endTime - startTime) / 1000; // 秒換算
1108
+
1109
+ expect(duration).to.be.lessThan(120); // 2分以内
1110
+ });
1111
+
1112
+ it('アクセシビリティ基準を満たす', () => {
1113
+ cy.visit('/reservations');
1114
+ cy.injectAxe(); // axe-core ライブラリ
1115
+
1116
+ cy.checkA11y(null, {
1117
+ rules: {
1118
+ 'color-contrast': { enabled: true },
1119
+ 'keyboard-navigation': { enabled: true },
1120
+ 'focus-management': { enabled: true }
1121
+ }
1122
+ });
1123
+ });
1124
+ });
1125
+ ```
1126
+
1127
+ ### 4. 継続的監視
1128
+
1129
+ ```yaml
1130
+ # Prometheus 監視ルール
1131
+ groups:
1132
+ - name: meeting-room-system
1133
+ rules:
1134
+ - alert: HighResponseTime
1135
+ expr: histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m])) > 2
1136
+ for: 2m
1137
+ labels:
1138
+ severity: warning
1139
+ annotations:
1140
+ summary: "API応答時間が遅延"
1141
+ description: "95パーセンタイルの応答時間が2秒を超えています"
1142
+
1143
+ - alert: HighErrorRate
1144
+ expr: rate(http_requests_total{status=~"5.."}[5m]) > 0.05
1145
+ for: 1m
1146
+ labels:
1147
+ severity: critical
1148
+ annotations:
1149
+ summary: "エラー率が高い"
1150
+ description: "5xx エラーの発生率が5%を超えています"
1151
+
1152
+ - alert: DatabaseConnectionFailure
1153
+ expr: health_database_status != 1
1154
+ for: 30s
1155
+ labels:
1156
+ severity: critical
1157
+ annotations:
1158
+ summary: "データベース接続失敗"
1159
+ description: "データベースへの接続が失敗しています"
1160
+ ```
1161
+
1162
+ ## 非機能要件のライフサイクル管理
1163
+
1164
+ ### 1. 要件定義フェーズ
1165
+
1166
+ - ステークホルダー特定
1167
+ - 品質属性の優先順位付け
1168
+ - 測定可能な目標値設定
1169
+ - 検証方法の決定
1170
+ - 受け入れ基準の合意
1171
+
1172
+ ### 2. 設計・実装フェーズ
1173
+
1174
+ - アーキテクチャ設計への反映
1175
+ - 非機能要件を満たす技術選択
1176
+ - 測定・監視機能の実装
1177
+ - テスト戦略への組み込み
1178
+
1179
+ ### 3. テスト・検証フェーズ
1180
+
1181
+ - パフォーマンステスト実行
1182
+ - セキュリティテスト実行
1183
+ - ユーザビリティテスト実行
1184
+ - 受け入れ基準の検証
1185
+ - 改善点の特定と対策
1186
+
1187
+ ### 4. 運用フェーズ
1188
+
1189
+ - 監視システム構築
1190
+ - SLAの設定
1191
+ - 定期的なパフォーマンス測定
1192
+ - ユーザーフィードバック収集
1193
+ - 継続的改善
1194
+
1195
+ ## まとめ
1196
+
1197
+ ### 非機能要件定義の要点
1198
+
1199
+ 1. **品質属性の明確化**
1200
+
1201
+ - ISO/IEC 25010 に基づく体系的な分類
1202
+ - 測定可能な目標値の設定
1203
+ - ステークホルダーとの合意形成
1204
+
1205
+ 2. **実装と検証の統合**
1206
+
1207
+ - アーキテクチャ設計への反映
1208
+ - 自動テストによる継続的検証
1209
+ - 運用監視との連携
1210
+
1211
+ 3. **継続的改善**
1212
+
1213
+ - 実運用データに基づく評価
1214
+ - ユーザーフィードバックの活用
1215
+ - 技術進歩に応じた要件見直し
1216
+
1217
+ 4. **リスク管理**
1218
+
1219
+ - 品質属性間のトレードオフの認識
1220
+ - 優先順位に基づく段階的実装
1221
+ - 早期の問題発見と対策
1222
+
1223
+ ### 非機能要件がもたらす価値
1224
+
1225
+ **短期的価値**:
1226
+
1227
+ - システムの安定性と信頼性の確保
1228
+ - ユーザー満足度の向上
1229
+ - 運用コストの削減
1230
+
1231
+ **長期的価値**:
1232
+
1233
+ - 保守性による開発効率の維持
1234
+ - 拡張性による事業成長への対応
1235
+ - セキュリティによるリスク回避
1236
+
1237
1237
  非機能要件は、変更を楽に安全にできて役に立つソフトウェアを実現するための基盤である。適切な定義と継続的な管理により、持続的な価値提供を可能にする。