@k2works/claude-code-booster 4.11.0 → 4.12.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 (749) 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 +281 -279
  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/closing-iteration/SKILL.md +129 -0
  33. package/lib/assets/.claude/skills/creating-adr/SKILL.md +113 -113
  34. package/lib/assets/.claude/skills/creating-development-strategy/SKILL.md +101 -101
  35. package/lib/assets/.claude/skills/creating-iteration-report/SKILL.md +210 -210
  36. package/lib/assets/.claude/skills/creating-journal/SKILL.md +129 -129
  37. package/lib/assets/.claude/skills/creating-release-report/SKILL.md +161 -161
  38. package/lib/assets/.claude/skills/creating-slides/SKILL.md +86 -86
  39. package/lib/assets/.claude/skills/creating-slides/agents/openai.yaml +4 -4
  40. package/lib/assets/.claude/skills/creating-slides/references/manga-css.md +45 -45
  41. package/lib/assets/.claude/skills/creating-slides/scripts/slide_tools.py +239 -239
  42. package/lib/assets/.claude/skills/developing-backend/SKILL.md +100 -100
  43. package/lib/assets/.claude/skills/developing-frontend/SKILL.md +93 -93
  44. package/lib/assets/.claude/skills/developing-release/SKILL.md +120 -120
  45. package/lib/assets/.claude/skills/developing-review/SKILL.md +175 -175
  46. package/lib/assets/.claude/skills/developing-uiux-review/SKILL.md +207 -207
  47. package/lib/assets/.claude/skills/generating-bmc/SKILL.md +123 -123
  48. package/lib/assets/.claude/skills/generating-slides/SKILL.md +94 -94
  49. package/lib/assets/.claude/skills/git-commit/SKILL.md +81 -81
  50. package/lib/assets/.claude/skills/killing-processes/SKILL.md +44 -44
  51. package/lib/assets/.claude/skills/opening-iteration/SKILL.md +105 -0
  52. package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -59
  53. package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -54
  54. package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -67
  55. package/lib/assets/.claude/skills/operating-docs/SKILL.md +219 -219
  56. package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -77
  57. package/lib/assets/.claude/skills/operating-qt/SKILL.md +147 -147
  58. package/lib/assets/.claude/skills/operating-review/SKILL.md +171 -171
  59. package/lib/assets/.claude/skills/operating-script/SKILL.md +145 -145
  60. package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -63
  61. package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +104 -104
  62. package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +168 -168
  63. package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +158 -158
  64. package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +144 -144
  65. package/lib/assets/.claude/skills/planning-releases/SKILL.md +119 -119
  66. package/lib/assets/.claude/skills/practicing-getting-start-tdd/SKILL.md +266 -266
  67. package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +151 -151
  68. package/lib/assets/.claude/skills/tracking-progress/SKILL.md +91 -91
  69. package/lib/assets/.claude/skills/validating-design/SKILL.md +130 -130
  70. package/lib/assets/.claude/skills/validating-iteration-plan/SKILL.md +238 -238
  71. package/lib/assets/.claude/skills/validating-operating-setup/SKILL.md +118 -118
  72. package/lib/assets/.devcontainer/devcontainer.json +37 -37
  73. package/lib/assets/.env.example +17 -17
  74. package/lib/assets/.gitattributes +4 -4
  75. package/lib/assets/.github/workflows/docker-publish.yml +77 -77
  76. package/lib/assets/.github/workflows/mkdocs.yml +39 -39
  77. package/lib/assets/AGENTS.md +94 -94
  78. package/lib/assets/CLAUDE.md +197 -195
  79. package/lib/assets/README.md +291 -291
  80. package/lib/assets/docker-compose.yml +33 -33
  81. package/lib/assets/docs/adr/index.md +10 -10
  82. package/lib/assets/docs/article/functional-desgin-ppp/all/01-immutability-and-data-transformation.md +475 -475
  83. package/lib/assets/docs/article/functional-desgin-ppp/all/02-function-composition.md +519 -519
  84. package/lib/assets/docs/article/functional-desgin-ppp/all/03-polymorphism.md +537 -537
  85. package/lib/assets/docs/article/functional-desgin-ppp/all/04-data-validation.md +300 -300
  86. package/lib/assets/docs/article/functional-desgin-ppp/all/05-property-based-testing.md +320 -320
  87. package/lib/assets/docs/article/functional-desgin-ppp/all/06-tdd-and-functional.md +498 -498
  88. package/lib/assets/docs/article/functional-desgin-ppp/all/07-composite-pattern.md +298 -298
  89. package/lib/assets/docs/article/functional-desgin-ppp/all/08-decorator-pattern.md +291 -291
  90. package/lib/assets/docs/article/functional-desgin-ppp/all/09-adapter-pattern.md +336 -336
  91. package/lib/assets/docs/article/functional-desgin-ppp/all/10-strategy-pattern.md +303 -303
  92. package/lib/assets/docs/article/functional-desgin-ppp/all/11-command-pattern.md +286 -286
  93. package/lib/assets/docs/article/functional-desgin-ppp/all/12-visitor-pattern.md +322 -322
  94. package/lib/assets/docs/article/functional-desgin-ppp/all/13-abstract-factory-pattern.md +319 -319
  95. package/lib/assets/docs/article/functional-desgin-ppp/all/14-abstract-server-pattern.md +365 -365
  96. package/lib/assets/docs/article/functional-desgin-ppp/all/15-gossiping-bus-drivers.md +156 -156
  97. package/lib/assets/docs/article/functional-desgin-ppp/all/16-payroll-system.md +178 -178
  98. package/lib/assets/docs/article/functional-desgin-ppp/all/17-video-rental-system.md +312 -312
  99. package/lib/assets/docs/article/functional-desgin-ppp/all/18-concurrency-system.md +287 -287
  100. package/lib/assets/docs/article/functional-desgin-ppp/all/19-wa-tor-simulation.md +286 -286
  101. package/lib/assets/docs/article/functional-desgin-ppp/all/20-pattern-interactions.md +274 -274
  102. package/lib/assets/docs/article/functional-desgin-ppp/all/21-best-practices.md +294 -294
  103. package/lib/assets/docs/article/functional-desgin-ppp/all/22-oo-to-fp-migration.md +337 -337
  104. package/lib/assets/docs/article/functional-desgin-ppp/all/index.md +388 -388
  105. package/lib/assets/docs/article/functional-desgin-ppp/clojure/01-immutability-and-data-transformation.md +273 -273
  106. package/lib/assets/docs/article/functional-desgin-ppp/clojure/02-function-composition.md +380 -380
  107. package/lib/assets/docs/article/functional-desgin-ppp/clojure/03-polymorphism.md +384 -384
  108. package/lib/assets/docs/article/functional-desgin-ppp/clojure/04-clojure-spec.md +350 -350
  109. package/lib/assets/docs/article/functional-desgin-ppp/clojure/05-property-based-testing.md +352 -352
  110. package/lib/assets/docs/article/functional-desgin-ppp/clojure/06-tdd-in-functional.md +383 -383
  111. package/lib/assets/docs/article/functional-desgin-ppp/clojure/07-composite-pattern.md +529 -529
  112. package/lib/assets/docs/article/functional-desgin-ppp/clojure/08-decorator-pattern.md +395 -395
  113. package/lib/assets/docs/article/functional-desgin-ppp/clojure/09-adapter-pattern.md +399 -399
  114. package/lib/assets/docs/article/functional-desgin-ppp/clojure/10-strategy-pattern.md +485 -485
  115. package/lib/assets/docs/article/functional-desgin-ppp/clojure/11-command-pattern.md +566 -566
  116. package/lib/assets/docs/article/functional-desgin-ppp/clojure/12-visitor-pattern.md +567 -567
  117. package/lib/assets/docs/article/functional-desgin-ppp/clojure/13-abstract-factory-pattern.md +475 -475
  118. package/lib/assets/docs/article/functional-desgin-ppp/clojure/14-abstract-server-pattern.md +462 -462
  119. package/lib/assets/docs/article/functional-desgin-ppp/clojure/15-gossiping-bus-drivers.md +325 -325
  120. package/lib/assets/docs/article/functional-desgin-ppp/clojure/16-payroll-system.md +401 -401
  121. package/lib/assets/docs/article/functional-desgin-ppp/clojure/17-video-rental-system.md +450 -450
  122. package/lib/assets/docs/article/functional-desgin-ppp/clojure/18-concurrency-system.md +475 -475
  123. package/lib/assets/docs/article/functional-desgin-ppp/clojure/19-wator-simulation.md +739 -739
  124. package/lib/assets/docs/article/functional-desgin-ppp/clojure/20-pattern-interactions.md +567 -567
  125. package/lib/assets/docs/article/functional-desgin-ppp/clojure/21-best-practices.md +518 -518
  126. package/lib/assets/docs/article/functional-desgin-ppp/clojure/22-oo-to-fp-migration.md +532 -532
  127. package/lib/assets/docs/article/functional-desgin-ppp/clojure/index.md +241 -241
  128. package/lib/assets/docs/article/functional-desgin-ppp/elixir/01-immutability-and-data-transformation.md +383 -383
  129. package/lib/assets/docs/article/functional-desgin-ppp/elixir/02-function-composition.md +374 -374
  130. package/lib/assets/docs/article/functional-desgin-ppp/elixir/03-polymorphism.md +375 -375
  131. package/lib/assets/docs/article/functional-desgin-ppp/elixir/04-data-validation.md +195 -195
  132. package/lib/assets/docs/article/functional-desgin-ppp/elixir/05-property-based-testing.md +268 -268
  133. package/lib/assets/docs/article/functional-desgin-ppp/elixir/06-tdd-and-fp.md +294 -294
  134. package/lib/assets/docs/article/functional-desgin-ppp/elixir/07-effects-and-pure-functions.md +164 -164
  135. package/lib/assets/docs/article/functional-desgin-ppp/elixir/08-error-handling-strategies.md +168 -168
  136. package/lib/assets/docs/article/functional-desgin-ppp/elixir/09-io-and-external-systems.md +254 -254
  137. package/lib/assets/docs/article/functional-desgin-ppp/elixir/10-concurrency-patterns.md +269 -269
  138. package/lib/assets/docs/article/functional-desgin-ppp/elixir/11-command-pattern.md +148 -148
  139. package/lib/assets/docs/article/functional-desgin-ppp/elixir/12-visitor-pattern.md +176 -176
  140. package/lib/assets/docs/article/functional-desgin-ppp/elixir/13-abstract-factory-pattern.md +604 -604
  141. package/lib/assets/docs/article/functional-desgin-ppp/elixir/14-abstract-server-pattern.md +729 -729
  142. package/lib/assets/docs/article/functional-desgin-ppp/elixir/15-gossiping-bus-drivers.md +291 -291
  143. package/lib/assets/docs/article/functional-desgin-ppp/elixir/16-payroll-system.md +420 -420
  144. package/lib/assets/docs/article/functional-desgin-ppp/elixir/17-video-rental-system.md +319 -319
  145. package/lib/assets/docs/article/functional-desgin-ppp/elixir/18-concurrency-system.md +466 -466
  146. package/lib/assets/docs/article/functional-desgin-ppp/elixir/19-wator-simulation.md +523 -523
  147. package/lib/assets/docs/article/functional-desgin-ppp/elixir/20-pattern-interactions.md +287 -287
  148. package/lib/assets/docs/article/functional-desgin-ppp/elixir/21-best-practices.md +340 -340
  149. package/lib/assets/docs/article/functional-desgin-ppp/elixir/22-oo-to-fp-migration.md +395 -395
  150. package/lib/assets/docs/article/functional-desgin-ppp/elixir/index.md +248 -248
  151. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/01-immutability-and-data-transformation.md +384 -384
  152. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/02-function-composition.md +452 -452
  153. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/03-polymorphism.md +495 -495
  154. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/04-data-validation.md +416 -416
  155. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/05-property-based-testing.md +382 -382
  156. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/06-tdd-functional.md +687 -687
  157. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/07-composite-pattern.md +442 -442
  158. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/08-decorator-pattern.md +479 -479
  159. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/09-adapter-pattern.md +479 -479
  160. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/10-strategy-pattern.md +427 -427
  161. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/11-command-pattern.md +428 -428
  162. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/12-visitor-pattern.md +339 -339
  163. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/13-abstract-factory-pattern.md +309 -309
  164. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/14-abstract-server-pattern.md +596 -596
  165. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/15-gossiping-bus-drivers.md +355 -355
  166. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/16-payroll-system.md +350 -350
  167. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/17-video-rental-system.md +414 -414
  168. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/18-concurrency-system.md +367 -367
  169. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/19-wator-simulation.md +403 -403
  170. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/20-pattern-interactions.md +291 -291
  171. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/21-best-practices.md +324 -324
  172. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/22-oo-to-fp-migration.md +332 -332
  173. package/lib/assets/docs/article/functional-desgin-ppp/fsharp/index.md +274 -274
  174. package/lib/assets/docs/article/functional-desgin-ppp/haskell/01-immutability-and-data-transformation.md +298 -298
  175. package/lib/assets/docs/article/functional-desgin-ppp/haskell/02-function-composition.md +304 -304
  176. package/lib/assets/docs/article/functional-desgin-ppp/haskell/03-polymorphism.md +362 -362
  177. package/lib/assets/docs/article/functional-desgin-ppp/haskell/04-data-validation.md +257 -257
  178. package/lib/assets/docs/article/functional-desgin-ppp/haskell/05-property-based-testing.md +254 -254
  179. package/lib/assets/docs/article/functional-desgin-ppp/haskell/06-tdd-functional.md +283 -283
  180. package/lib/assets/docs/article/functional-desgin-ppp/haskell/07-composite-pattern.md +395 -395
  181. package/lib/assets/docs/article/functional-desgin-ppp/haskell/08-decorator-pattern.md +319 -319
  182. package/lib/assets/docs/article/functional-desgin-ppp/haskell/09-adapter-pattern.md +382 -382
  183. package/lib/assets/docs/article/functional-desgin-ppp/haskell/10-strategy-pattern.md +287 -287
  184. package/lib/assets/docs/article/functional-desgin-ppp/haskell/11-command-pattern.md +303 -303
  185. package/lib/assets/docs/article/functional-desgin-ppp/haskell/12-visitor-pattern.md +326 -326
  186. package/lib/assets/docs/article/functional-desgin-ppp/haskell/13-abstract-factory-pattern.md +332 -332
  187. package/lib/assets/docs/article/functional-desgin-ppp/haskell/14-abstract-server-pattern.md +379 -379
  188. package/lib/assets/docs/article/functional-desgin-ppp/haskell/15-gossiping-bus-drivers.md +177 -177
  189. package/lib/assets/docs/article/functional-desgin-ppp/haskell/16-payroll-system.md +219 -219
  190. package/lib/assets/docs/article/functional-desgin-ppp/haskell/17-video-rental-system.md +244 -244
  191. package/lib/assets/docs/article/functional-desgin-ppp/haskell/18-concurrency-system.md +363 -363
  192. package/lib/assets/docs/article/functional-desgin-ppp/haskell/19-wator-simulation.md +438 -438
  193. package/lib/assets/docs/article/functional-desgin-ppp/haskell/20-pattern-interactions.md +325 -325
  194. package/lib/assets/docs/article/functional-desgin-ppp/haskell/21-best-practices.md +403 -403
  195. package/lib/assets/docs/article/functional-desgin-ppp/haskell/22-oo-to-fp-migration.md +469 -469
  196. package/lib/assets/docs/article/functional-desgin-ppp/haskell/index.md +174 -174
  197. package/lib/assets/docs/article/functional-desgin-ppp/index.md +90 -90
  198. package/lib/assets/docs/article/functional-desgin-ppp/rust/01-immutability-and-data-transformation.md +450 -450
  199. package/lib/assets/docs/article/functional-desgin-ppp/rust/02-function-composition.md +463 -463
  200. package/lib/assets/docs/article/functional-desgin-ppp/rust/03-polymorphism.md +425 -425
  201. package/lib/assets/docs/article/functional-desgin-ppp/rust/04-data-validation.md +273 -273
  202. package/lib/assets/docs/article/functional-desgin-ppp/rust/05-property-based-testing.md +247 -247
  203. package/lib/assets/docs/article/functional-desgin-ppp/rust/06-tdd-and-functional.md +841 -841
  204. package/lib/assets/docs/article/functional-desgin-ppp/rust/07-composite-pattern.md +384 -384
  205. package/lib/assets/docs/article/functional-desgin-ppp/rust/08-decorator-pattern.md +383 -383
  206. package/lib/assets/docs/article/functional-desgin-ppp/rust/09-adapter-pattern.md +339 -339
  207. package/lib/assets/docs/article/functional-desgin-ppp/rust/10-strategy-pattern.md +331 -331
  208. package/lib/assets/docs/article/functional-desgin-ppp/rust/11-command-pattern.md +356 -356
  209. package/lib/assets/docs/article/functional-desgin-ppp/rust/12-visitor-pattern.md +379 -379
  210. package/lib/assets/docs/article/functional-desgin-ppp/rust/13-abstract-factory-pattern.md +361 -361
  211. package/lib/assets/docs/article/functional-desgin-ppp/rust/14-abstract-server-pattern.md +392 -392
  212. package/lib/assets/docs/article/functional-desgin-ppp/rust/15-gossiping-bus-drivers.md +300 -300
  213. package/lib/assets/docs/article/functional-desgin-ppp/rust/16-payroll-system.md +297 -297
  214. package/lib/assets/docs/article/functional-desgin-ppp/rust/17-video-rental-system.md +304 -304
  215. package/lib/assets/docs/article/functional-desgin-ppp/rust/18-concurrency-system.md +315 -315
  216. package/lib/assets/docs/article/functional-desgin-ppp/rust/19-wator-simulation.md +311 -311
  217. package/lib/assets/docs/article/functional-desgin-ppp/rust/20-pattern-interactions.md +304 -304
  218. package/lib/assets/docs/article/functional-desgin-ppp/rust/21-best-practices.md +336 -336
  219. package/lib/assets/docs/article/functional-desgin-ppp/rust/22-oo-to-fp-migration.md +349 -349
  220. package/lib/assets/docs/article/functional-desgin-ppp/rust/index.md +243 -243
  221. package/lib/assets/docs/article/functional-desgin-ppp/scala/01-immutability-and-data-transformation.md +328 -328
  222. package/lib/assets/docs/article/functional-desgin-ppp/scala/02-function-composition.md +348 -348
  223. package/lib/assets/docs/article/functional-desgin-ppp/scala/03-polymorphism.md +357 -357
  224. package/lib/assets/docs/article/functional-desgin-ppp/scala/04-data-validation.md +364 -364
  225. package/lib/assets/docs/article/functional-desgin-ppp/scala/05-property-based-testing.md +515 -515
  226. package/lib/assets/docs/article/functional-desgin-ppp/scala/06-tdd-functional.md +557 -557
  227. package/lib/assets/docs/article/functional-desgin-ppp/scala/07-composite-pattern.md +363 -363
  228. package/lib/assets/docs/article/functional-desgin-ppp/scala/08-decorator-pattern.md +327 -327
  229. package/lib/assets/docs/article/functional-desgin-ppp/scala/09-adapter-pattern.md +517 -517
  230. package/lib/assets/docs/article/functional-desgin-ppp/scala/10-strategy-pattern.md +441 -441
  231. package/lib/assets/docs/article/functional-desgin-ppp/scala/11-command-pattern.md +407 -407
  232. package/lib/assets/docs/article/functional-desgin-ppp/scala/12-visitor-pattern.md +379 -379
  233. package/lib/assets/docs/article/functional-desgin-ppp/scala/13-abstract-factory-pattern.md +398 -398
  234. package/lib/assets/docs/article/functional-desgin-ppp/scala/14-abstract-server-pattern.md +476 -476
  235. package/lib/assets/docs/article/functional-desgin-ppp/scala/15-gossiping-bus-drivers.md +391 -391
  236. package/lib/assets/docs/article/functional-desgin-ppp/scala/16-payroll-system.md +342 -342
  237. package/lib/assets/docs/article/functional-desgin-ppp/scala/17-video-rental-system.md +324 -324
  238. package/lib/assets/docs/article/functional-desgin-ppp/scala/18-concurrency-system.md +730 -730
  239. package/lib/assets/docs/article/functional-desgin-ppp/scala/19-wator-simulation.md +624 -624
  240. package/lib/assets/docs/article/functional-desgin-ppp/scala/20-pattern-interactions.md +512 -512
  241. package/lib/assets/docs/article/functional-desgin-ppp/scala/21-best-practices.md +433 -433
  242. package/lib/assets/docs/article/functional-desgin-ppp/scala/22-oo-to-fp-migration.md +688 -688
  243. package/lib/assets/docs/article/functional-desgin-ppp/scala/index.md +243 -243
  244. package/lib/assets/docs/article/getting-start-tdd/clojure/01-todo-list-and-first-test.md +166 -166
  245. package/lib/assets/docs/article/getting-start-tdd/clojure/02-fake-it-and-triangulation.md +162 -162
  246. package/lib/assets/docs/article/getting-start-tdd/clojure/03-obvious-implementation-and-refactoring.md +135 -135
  247. package/lib/assets/docs/article/getting-start-tdd/clojure/04-version-control-and-conventional-commits.md +88 -88
  248. package/lib/assets/docs/article/getting-start-tdd/clojure/05-package-management-and-static-analysis.md +299 -299
  249. package/lib/assets/docs/article/getting-start-tdd/clojure/06-task-runner-and-ci-cd.md +241 -241
  250. package/lib/assets/docs/article/getting-start-tdd/clojure/07-protocols-and-records.md +131 -131
  251. package/lib/assets/docs/article/getting-start-tdd/clojure/08-multimethods-and-design-patterns.md +130 -130
  252. package/lib/assets/docs/article/getting-start-tdd/clojure/09-namespaces-and-module-design.md +127 -127
  253. package/lib/assets/docs/article/getting-start-tdd/clojure/10-higher-order-functions-and-composition.md +114 -114
  254. package/lib/assets/docs/article/getting-start-tdd/clojure/11-persistent-data-and-pipeline.md +138 -138
  255. package/lib/assets/docs/article/getting-start-tdd/clojure/12-error-handling-and-spec.md +161 -161
  256. package/lib/assets/docs/article/getting-start-tdd/clojure/index.md +65 -65
  257. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter01.md +232 -232
  258. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter02.md +244 -244
  259. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter03.md +202 -202
  260. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter04.md +92 -92
  261. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter05.md +256 -256
  262. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter06.md +195 -195
  263. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter07.md +214 -214
  264. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter08.md +249 -249
  265. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter09.md +174 -174
  266. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter10.md +166 -166
  267. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter11.md +192 -192
  268. package/lib/assets/docs/article/getting-start-tdd/csharp/chapter12.md +211 -211
  269. package/lib/assets/docs/article/getting-start-tdd/csharp/index.md +83 -83
  270. package/lib/assets/docs/article/getting-start-tdd/elixir/01-todo-list-and-first-test.md +87 -87
  271. package/lib/assets/docs/article/getting-start-tdd/elixir/02-fake-it-and-triangulation.md +95 -95
  272. package/lib/assets/docs/article/getting-start-tdd/elixir/03-obvious-implementation-and-refactoring.md +109 -109
  273. package/lib/assets/docs/article/getting-start-tdd/elixir/04-version-control-and-conventional-commits.md +96 -96
  274. package/lib/assets/docs/article/getting-start-tdd/elixir/05-package-management-and-static-analysis.md +88 -88
  275. package/lib/assets/docs/article/getting-start-tdd/elixir/06-task-runner-and-ci-cd.md +71 -71
  276. package/lib/assets/docs/article/getting-start-tdd/elixir/07-structs-and-protocols.md +110 -110
  277. package/lib/assets/docs/article/getting-start-tdd/elixir/08-pattern-matching-and-guards.md +108 -108
  278. package/lib/assets/docs/article/getting-start-tdd/elixir/09-module-design-and-behaviours.md +104 -104
  279. package/lib/assets/docs/article/getting-start-tdd/elixir/10-higher-order-functions-and-pipeline.md +178 -178
  280. package/lib/assets/docs/article/getting-start-tdd/elixir/11-stream-and-lazy-evaluation.md +142 -142
  281. package/lib/assets/docs/article/getting-start-tdd/elixir/12-error-handling-and-with.md +145 -145
  282. package/lib/assets/docs/article/getting-start-tdd/elixir/index.md +35 -35
  283. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter01.md +202 -202
  284. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter02.md +246 -246
  285. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter03.md +218 -218
  286. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter04.md +179 -179
  287. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter05.md +267 -267
  288. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter06.md +190 -190
  289. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter07.md +161 -161
  290. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter08.md +175 -175
  291. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter09.md +222 -222
  292. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter10.md +189 -189
  293. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter11.md +212 -212
  294. package/lib/assets/docs/article/getting-start-tdd/fsharp/chapter12.md +215 -215
  295. package/lib/assets/docs/article/getting-start-tdd/fsharp/index.md +71 -71
  296. package/lib/assets/docs/article/getting-start-tdd/go/01-todo-list-and-first-test.md +213 -213
  297. package/lib/assets/docs/article/getting-start-tdd/go/02-fake-it-and-triangulation.md +302 -302
  298. package/lib/assets/docs/article/getting-start-tdd/go/03-obvious-implementation-and-refactoring.md +339 -339
  299. package/lib/assets/docs/article/getting-start-tdd/go/04-version-control-and-conventional-commits.md +112 -112
  300. package/lib/assets/docs/article/getting-start-tdd/go/05-package-management-and-static-analysis.md +272 -272
  301. package/lib/assets/docs/article/getting-start-tdd/go/06-task-runner-and-ci-cd.md +233 -233
  302. package/lib/assets/docs/article/getting-start-tdd/go/07-encapsulation-and-polymorphism.md +394 -394
  303. package/lib/assets/docs/article/getting-start-tdd/go/08-design-patterns.md +422 -422
  304. package/lib/assets/docs/article/getting-start-tdd/go/09-solid-principles-and-module-design.md +400 -400
  305. package/lib/assets/docs/article/getting-start-tdd/go/10-higher-order-functions-and-composition.md +226 -226
  306. package/lib/assets/docs/article/getting-start-tdd/go/11-immutable-data-and-pipeline.md +296 -296
  307. package/lib/assets/docs/article/getting-start-tdd/go/12-error-handling-and-type-safety.md +411 -411
  308. package/lib/assets/docs/article/getting-start-tdd/go/index.md +83 -83
  309. package/lib/assets/docs/article/getting-start-tdd/haskell/01-todo-list-and-first-test.md +279 -279
  310. package/lib/assets/docs/article/getting-start-tdd/haskell/02-fake-it-and-triangulation.md +337 -337
  311. package/lib/assets/docs/article/getting-start-tdd/haskell/03-obvious-implementation-and-refactoring.md +257 -257
  312. package/lib/assets/docs/article/getting-start-tdd/haskell/04-version-control-and-conventional-commits.md +182 -182
  313. package/lib/assets/docs/article/getting-start-tdd/haskell/05-package-management-and-static-analysis.md +313 -313
  314. package/lib/assets/docs/article/getting-start-tdd/haskell/06-task-runner-and-ci-cd.md +309 -309
  315. package/lib/assets/docs/article/getting-start-tdd/haskell/07-algebraic-data-types-and-type-classes.md +412 -412
  316. package/lib/assets/docs/article/getting-start-tdd/haskell/08-pattern-matching-and-guards.md +390 -390
  317. package/lib/assets/docs/article/getting-start-tdd/haskell/09-module-design-and-smart-constructors.md +461 -461
  318. package/lib/assets/docs/article/getting-start-tdd/haskell/10-higher-order-functions-and-currying.md +434 -434
  319. package/lib/assets/docs/article/getting-start-tdd/haskell/11-function-composition-and-point-free.md +392 -392
  320. package/lib/assets/docs/article/getting-start-tdd/haskell/12-monad-and-error-handling.md +631 -631
  321. package/lib/assets/docs/article/getting-start-tdd/haskell/index.md +49 -49
  322. package/lib/assets/docs/article/getting-start-tdd/index.md +93 -93
  323. package/lib/assets/docs/article/getting-start-tdd/integration/01-language-overview.md +375 -375
  324. package/lib/assets/docs/article/getting-start-tdd/integration/02-test-framework-comparison.md +349 -349
  325. package/lib/assets/docs/article/getting-start-tdd/integration/03-tdd-pattern-comparison.md +445 -445
  326. package/lib/assets/docs/article/getting-start-tdd/integration/04-type-system-comparison.md +409 -409
  327. package/lib/assets/docs/article/getting-start-tdd/integration/05-dev-environment-comparison.md +330 -330
  328. package/lib/assets/docs/article/getting-start-tdd/integration/06-learning-roadmap.md +290 -290
  329. package/lib/assets/docs/article/getting-start-tdd/integration/index.md +69 -69
  330. package/lib/assets/docs/article/getting-start-tdd/java/01-todo-list-and-first-test.md +234 -234
  331. package/lib/assets/docs/article/getting-start-tdd/java/02-fake-it-and-triangulation.md +261 -261
  332. package/lib/assets/docs/article/getting-start-tdd/java/03-obvious-implementation-and-refactoring.md +185 -185
  333. package/lib/assets/docs/article/getting-start-tdd/java/04-version-control-and-conventional-commits.md +115 -115
  334. package/lib/assets/docs/article/getting-start-tdd/java/05-package-management-and-static-analysis.md +382 -382
  335. package/lib/assets/docs/article/getting-start-tdd/java/06-task-runner-and-ci-cd.md +272 -272
  336. package/lib/assets/docs/article/getting-start-tdd/java/07-encapsulation-and-polymorphism.md +626 -626
  337. package/lib/assets/docs/article/getting-start-tdd/java/08-design-patterns.md +393 -393
  338. package/lib/assets/docs/article/getting-start-tdd/java/09-solid-principles-and-module-design.md +310 -310
  339. package/lib/assets/docs/article/getting-start-tdd/java/10-higher-order-functions-and-composition.md +188 -188
  340. package/lib/assets/docs/article/getting-start-tdd/java/11-immutable-data-and-pipeline.md +167 -167
  341. package/lib/assets/docs/article/getting-start-tdd/java/12-error-handling-and-type-safety.md +205 -205
  342. package/lib/assets/docs/article/getting-start-tdd/java/index.md +61 -61
  343. package/lib/assets/docs/article/getting-start-tdd/node/01-todo-list-and-first-test.md +244 -244
  344. package/lib/assets/docs/article/getting-start-tdd/node/02-fake-it-and-triangulation.md +262 -262
  345. package/lib/assets/docs/article/getting-start-tdd/node/03-obvious-implementation-and-refactoring.md +169 -169
  346. package/lib/assets/docs/article/getting-start-tdd/node/04-version-control-and-conventional-commits.md +112 -112
  347. package/lib/assets/docs/article/getting-start-tdd/node/05-package-management-and-static-analysis.md +314 -314
  348. package/lib/assets/docs/article/getting-start-tdd/node/06-task-runner-and-ci-cd.md +235 -235
  349. package/lib/assets/docs/article/getting-start-tdd/node/07-encapsulation-and-polymorphism.md +327 -327
  350. package/lib/assets/docs/article/getting-start-tdd/node/08-design-patterns.md +322 -322
  351. package/lib/assets/docs/article/getting-start-tdd/node/09-solid-principles-and-module-design.md +285 -285
  352. package/lib/assets/docs/article/getting-start-tdd/node/10-higher-order-functions-and-composition.md +199 -199
  353. package/lib/assets/docs/article/getting-start-tdd/node/11-immutable-data-and-pipeline.md +207 -207
  354. package/lib/assets/docs/article/getting-start-tdd/node/12-error-handling-and-type-safety.md +295 -295
  355. package/lib/assets/docs/article/getting-start-tdd/node/index.md +56 -56
  356. package/lib/assets/docs/article/getting-start-tdd/php/01-todo-list-and-first-test.md +259 -259
  357. package/lib/assets/docs/article/getting-start-tdd/php/02-fake-it-and-triangulation.md +200 -200
  358. package/lib/assets/docs/article/getting-start-tdd/php/03-obvious-implementation-and-refactoring.md +248 -248
  359. package/lib/assets/docs/article/getting-start-tdd/php/04-version-control-and-conventional-commits.md +141 -141
  360. package/lib/assets/docs/article/getting-start-tdd/php/05-package-management-and-static-analysis.md +410 -410
  361. package/lib/assets/docs/article/getting-start-tdd/php/06-task-runner-and-ci-cd.md +321 -321
  362. package/lib/assets/docs/article/getting-start-tdd/php/07-encapsulation-and-polymorphism.md +372 -372
  363. package/lib/assets/docs/article/getting-start-tdd/php/08-design-patterns.md +453 -453
  364. package/lib/assets/docs/article/getting-start-tdd/php/09-solid-principles-and-module-design.md +460 -460
  365. package/lib/assets/docs/article/getting-start-tdd/php/10-higher-order-functions-and-composition.md +182 -182
  366. package/lib/assets/docs/article/getting-start-tdd/php/11-immutable-data-and-pipeline.md +266 -266
  367. package/lib/assets/docs/article/getting-start-tdd/php/12-error-handling-and-type-safety.md +308 -308
  368. package/lib/assets/docs/article/getting-start-tdd/php/index.md +84 -84
  369. package/lib/assets/docs/article/getting-start-tdd/python/01-todo-list-and-first-test.md +201 -201
  370. package/lib/assets/docs/article/getting-start-tdd/python/02-fake-it-and-triangulation.md +247 -247
  371. package/lib/assets/docs/article/getting-start-tdd/python/03-obvious-implementation-and-refactoring.md +199 -199
  372. package/lib/assets/docs/article/getting-start-tdd/python/04-version-control-and-conventional-commits.md +87 -87
  373. package/lib/assets/docs/article/getting-start-tdd/python/05-package-management-and-static-analysis.md +274 -274
  374. package/lib/assets/docs/article/getting-start-tdd/python/06-task-runner-and-ci-cd.md +190 -190
  375. package/lib/assets/docs/article/getting-start-tdd/python/07-encapsulation-and-polymorphism.md +208 -208
  376. package/lib/assets/docs/article/getting-start-tdd/python/08-design-patterns.md +172 -172
  377. package/lib/assets/docs/article/getting-start-tdd/python/09-solid-principles-and-module-design.md +130 -130
  378. package/lib/assets/docs/article/getting-start-tdd/python/10-higher-order-functions-and-composition.md +122 -122
  379. package/lib/assets/docs/article/getting-start-tdd/python/11-immutable-data-and-pipeline.md +116 -116
  380. package/lib/assets/docs/article/getting-start-tdd/python/12-error-handling-and-type-safety.md +126 -126
  381. package/lib/assets/docs/article/getting-start-tdd/python/index.md +55 -55
  382. package/lib/assets/docs/article/getting-start-tdd/ruby/01-todo-list-and-first-test.md +231 -231
  383. package/lib/assets/docs/article/getting-start-tdd/ruby/02-fake-it-and-triangulation.md +238 -238
  384. package/lib/assets/docs/article/getting-start-tdd/ruby/03-obvious-implementation-and-refactoring.md +228 -228
  385. package/lib/assets/docs/article/getting-start-tdd/ruby/04-version-control-and-conventional-commits.md +112 -112
  386. package/lib/assets/docs/article/getting-start-tdd/ruby/05-package-management-and-static-analysis.md +287 -287
  387. package/lib/assets/docs/article/getting-start-tdd/ruby/06-task-runner-and-ci-cd.md +248 -248
  388. package/lib/assets/docs/article/getting-start-tdd/ruby/07-encapsulation-and-polymorphism.md +279 -279
  389. package/lib/assets/docs/article/getting-start-tdd/ruby/08-design-patterns.md +329 -329
  390. package/lib/assets/docs/article/getting-start-tdd/ruby/09-solid-principles-and-module-design.md +196 -196
  391. package/lib/assets/docs/article/getting-start-tdd/ruby/10-higher-order-functions-and-composition.md +175 -175
  392. package/lib/assets/docs/article/getting-start-tdd/ruby/11-immutable-data-and-pipeline.md +237 -237
  393. package/lib/assets/docs/article/getting-start-tdd/ruby/12-error-handling-and-type-safety.md +398 -398
  394. package/lib/assets/docs/article/getting-start-tdd/ruby/index.md +83 -83
  395. package/lib/assets/docs/article/getting-start-tdd/rust/01-todo-list-and-first-test.md +211 -211
  396. package/lib/assets/docs/article/getting-start-tdd/rust/02-fake-it-and-triangulation.md +264 -264
  397. package/lib/assets/docs/article/getting-start-tdd/rust/03-obvious-implementation-and-refactoring.md +233 -233
  398. package/lib/assets/docs/article/getting-start-tdd/rust/04-version-control-and-conventional-commits.md +92 -92
  399. package/lib/assets/docs/article/getting-start-tdd/rust/05-package-management-and-static-analysis.md +212 -212
  400. package/lib/assets/docs/article/getting-start-tdd/rust/06-task-runner-and-ci-cd.md +164 -164
  401. package/lib/assets/docs/article/getting-start-tdd/rust/07-encapsulation-and-polymorphism.md +142 -142
  402. package/lib/assets/docs/article/getting-start-tdd/rust/08-design-patterns.md +145 -145
  403. package/lib/assets/docs/article/getting-start-tdd/rust/09-solid-principles-and-module-design.md +110 -110
  404. package/lib/assets/docs/article/getting-start-tdd/rust/10-higher-order-functions-and-composition.md +94 -94
  405. package/lib/assets/docs/article/getting-start-tdd/rust/11-immutable-data-and-pipeline.md +105 -105
  406. package/lib/assets/docs/article/getting-start-tdd/rust/12-error-handling-and-type-safety.md +112 -112
  407. package/lib/assets/docs/article/getting-start-tdd/rust/index.md +83 -83
  408. package/lib/assets/docs/article/getting-start-tdd/scala/01-todo-list-and-first-test.md +111 -111
  409. package/lib/assets/docs/article/getting-start-tdd/scala/02-fake-it-and-triangulation.md +107 -107
  410. package/lib/assets/docs/article/getting-start-tdd/scala/03-obvious-implementation-and-refactoring.md +99 -99
  411. package/lib/assets/docs/article/getting-start-tdd/scala/04-version-control-and-conventional-commits.md +123 -123
  412. package/lib/assets/docs/article/getting-start-tdd/scala/05-package-management-and-static-analysis.md +196 -196
  413. package/lib/assets/docs/article/getting-start-tdd/scala/06-task-runner-and-ci-cd.md +186 -186
  414. package/lib/assets/docs/article/getting-start-tdd/scala/07-case-classes-and-traits.md +139 -139
  415. package/lib/assets/docs/article/getting-start-tdd/scala/08-pattern-matching-and-sealed-traits.md +106 -106
  416. package/lib/assets/docs/article/getting-start-tdd/scala/09-packages-and-module-design.md +75 -75
  417. package/lib/assets/docs/article/getting-start-tdd/scala/10-higher-order-functions-and-composition.md +104 -104
  418. package/lib/assets/docs/article/getting-start-tdd/scala/11-collections-and-lazy-evaluation.md +94 -94
  419. package/lib/assets/docs/article/getting-start-tdd/scala/12-error-handling-and-type-safety.md +92 -92
  420. package/lib/assets/docs/article/getting-start-tdd/scala/index.md +65 -65
  421. package/lib/assets/docs/article/grokking-concurrency/all/index.md +404 -404
  422. package/lib/assets/docs/article/grokking-concurrency/all/part-1-ch02-sequential.md +554 -554
  423. package/lib/assets/docs/article/grokking-concurrency/all/part-2-ch04-05-threads.md +469 -469
  424. package/lib/assets/docs/article/grokking-concurrency/all/part-3-ch06-multitasking.md +520 -520
  425. package/lib/assets/docs/article/grokking-concurrency/all/part-4-ch07-parallel-patterns.md +420 -420
  426. package/lib/assets/docs/article/grokking-concurrency/all/part-5-ch08-09-synchronization.md +510 -510
  427. package/lib/assets/docs/article/grokking-concurrency/all/part-6-ch10-11-nonblocking-io.md +435 -435
  428. package/lib/assets/docs/article/grokking-concurrency/all/part-7-ch12-async.md +465 -465
  429. package/lib/assets/docs/article/grokking-concurrency/all/part-8-ch13-mapreduce.md +377 -377
  430. package/lib/assets/docs/article/grokking-concurrency/clojure/index.md +116 -116
  431. package/lib/assets/docs/article/grokking-concurrency/clojure/part-1.md +108 -108
  432. package/lib/assets/docs/article/grokking-concurrency/clojure/part-2.md +101 -101
  433. package/lib/assets/docs/article/grokking-concurrency/clojure/part-3.md +122 -122
  434. package/lib/assets/docs/article/grokking-concurrency/clojure/part-4.md +123 -123
  435. package/lib/assets/docs/article/grokking-concurrency/clojure/part-5.md +118 -118
  436. package/lib/assets/docs/article/grokking-concurrency/clojure/part-6.md +89 -89
  437. package/lib/assets/docs/article/grokking-concurrency/clojure/part-7.md +100 -100
  438. package/lib/assets/docs/article/grokking-concurrency/clojure/part-8.md +120 -120
  439. package/lib/assets/docs/article/grokking-concurrency/csharp/index.md +101 -101
  440. package/lib/assets/docs/article/grokking-concurrency/csharp/part-1.md +97 -97
  441. package/lib/assets/docs/article/grokking-concurrency/csharp/part-2.md +123 -123
  442. package/lib/assets/docs/article/grokking-concurrency/csharp/part-3.md +101 -101
  443. package/lib/assets/docs/article/grokking-concurrency/csharp/part-4.md +112 -112
  444. package/lib/assets/docs/article/grokking-concurrency/csharp/part-5.md +99 -99
  445. package/lib/assets/docs/article/grokking-concurrency/csharp/part-6.md +61 -61
  446. package/lib/assets/docs/article/grokking-concurrency/csharp/part-7.md +84 -84
  447. package/lib/assets/docs/article/grokking-concurrency/csharp/part-8.md +92 -92
  448. package/lib/assets/docs/article/grokking-concurrency/fsharp/index.md +65 -65
  449. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-1.md +80 -80
  450. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-2.md +103 -103
  451. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-3.md +94 -94
  452. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-4.md +110 -110
  453. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-5.md +104 -104
  454. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-6.md +93 -93
  455. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-7.md +121 -121
  456. package/lib/assets/docs/article/grokking-concurrency/fsharp/part-8.md +107 -107
  457. package/lib/assets/docs/article/grokking-concurrency/haskell/index.md +248 -248
  458. package/lib/assets/docs/article/grokking-concurrency/haskell/part-1.md +96 -96
  459. package/lib/assets/docs/article/grokking-concurrency/haskell/part-2.md +96 -96
  460. package/lib/assets/docs/article/grokking-concurrency/haskell/part-3.md +91 -91
  461. package/lib/assets/docs/article/grokking-concurrency/haskell/part-4.md +106 -106
  462. package/lib/assets/docs/article/grokking-concurrency/haskell/part-5.md +99 -99
  463. package/lib/assets/docs/article/grokking-concurrency/haskell/part-6.md +95 -95
  464. package/lib/assets/docs/article/grokking-concurrency/haskell/part-7.md +111 -111
  465. package/lib/assets/docs/article/grokking-concurrency/haskell/part-8.md +118 -118
  466. package/lib/assets/docs/article/grokking-concurrency/index.md +66 -66
  467. package/lib/assets/docs/article/grokking-concurrency/java/index.md +102 -102
  468. package/lib/assets/docs/article/grokking-concurrency/java/part-1.md +308 -308
  469. package/lib/assets/docs/article/grokking-concurrency/java/part-2.md +334 -334
  470. package/lib/assets/docs/article/grokking-concurrency/java/part-3.md +221 -221
  471. package/lib/assets/docs/article/grokking-concurrency/java/part-4.md +213 -213
  472. package/lib/assets/docs/article/grokking-concurrency/java/part-5.md +112 -112
  473. package/lib/assets/docs/article/grokking-concurrency/java/part-6.md +69 -69
  474. package/lib/assets/docs/article/grokking-concurrency/java/part-7.md +101 -101
  475. package/lib/assets/docs/article/grokking-concurrency/java/part-8.md +101 -101
  476. package/lib/assets/docs/article/grokking-concurrency/python/index.md +313 -313
  477. package/lib/assets/docs/article/grokking-concurrency/python/part-1.md +239 -239
  478. package/lib/assets/docs/article/grokking-concurrency/python/part-2.md +418 -418
  479. package/lib/assets/docs/article/grokking-concurrency/python/part-3.md +227 -227
  480. package/lib/assets/docs/article/grokking-concurrency/python/part-4.md +299 -299
  481. package/lib/assets/docs/article/grokking-concurrency/python/part-5.md +315 -315
  482. package/lib/assets/docs/article/grokking-concurrency/python/part-6.md +297 -297
  483. package/lib/assets/docs/article/grokking-concurrency/python/part-7.md +314 -314
  484. package/lib/assets/docs/article/grokking-concurrency/python/part-8.md +360 -360
  485. package/lib/assets/docs/article/grokking-concurrency/rust/index.md +270 -270
  486. package/lib/assets/docs/article/grokking-concurrency/rust/part-1.md +108 -108
  487. package/lib/assets/docs/article/grokking-concurrency/rust/part-2.md +120 -120
  488. package/lib/assets/docs/article/grokking-concurrency/rust/part-3.md +126 -126
  489. package/lib/assets/docs/article/grokking-concurrency/rust/part-4.md +175 -175
  490. package/lib/assets/docs/article/grokking-concurrency/rust/part-5.md +158 -158
  491. package/lib/assets/docs/article/grokking-concurrency/rust/part-6.md +94 -94
  492. package/lib/assets/docs/article/grokking-concurrency/rust/part-7.md +133 -133
  493. package/lib/assets/docs/article/grokking-concurrency/rust/part-8.md +155 -155
  494. package/lib/assets/docs/article/grokking-concurrency/scala/index.md +69 -69
  495. package/lib/assets/docs/article/grokking-concurrency/scala/part-1.md +78 -78
  496. package/lib/assets/docs/article/grokking-concurrency/scala/part-2.md +112 -112
  497. package/lib/assets/docs/article/grokking-concurrency/scala/part-3.md +93 -93
  498. package/lib/assets/docs/article/grokking-concurrency/scala/part-4.md +110 -110
  499. package/lib/assets/docs/article/grokking-concurrency/scala/part-5.md +119 -119
  500. package/lib/assets/docs/article/grokking-concurrency/scala/part-6.md +83 -83
  501. package/lib/assets/docs/article/grokking-concurrency/scala/part-7.md +131 -131
  502. package/lib/assets/docs/article/grokking-concurrency/scala/part-8.md +129 -129
  503. package/lib/assets/docs/article/grokkingfp/all/index.md +368 -368
  504. package/lib/assets/docs/article/grokkingfp/all/part-1-ch01-fp-introduction.md +530 -530
  505. package/lib/assets/docs/article/grokkingfp/all/part-1-ch02-pure-functions.md +923 -923
  506. package/lib/assets/docs/article/grokkingfp/all/part-2-ch03-immutable-data.md +1128 -1128
  507. package/lib/assets/docs/article/grokkingfp/all/part-2-ch04-higher-order-functions.md +1104 -1104
  508. package/lib/assets/docs/article/grokkingfp/all/part-2-ch05-flatmap.md +1026 -1026
  509. package/lib/assets/docs/article/grokkingfp/all/part-3-ch06-option.md +785 -785
  510. package/lib/assets/docs/article/grokkingfp/all/part-3-ch07-either-adt.md +871 -871
  511. package/lib/assets/docs/article/grokkingfp/all/part-4-ch08-io-monad.md +972 -972
  512. package/lib/assets/docs/article/grokkingfp/all/part-4-ch09-streams.md +926 -926
  513. package/lib/assets/docs/article/grokkingfp/all/part-5-ch10-concurrency.md +870 -870
  514. package/lib/assets/docs/article/grokkingfp/all/part-6-ch11-application.md +715 -715
  515. package/lib/assets/docs/article/grokkingfp/all/part-6-ch12-testing.md +626 -626
  516. package/lib/assets/docs/article/grokkingfp/all/writing-plan.md +712 -712
  517. package/lib/assets/docs/article/grokkingfp/clojure/index.md +276 -276
  518. package/lib/assets/docs/article/grokkingfp/clojure/part-1.md +667 -667
  519. package/lib/assets/docs/article/grokkingfp/clojure/part-2.md +643 -643
  520. package/lib/assets/docs/article/grokkingfp/clojure/part-3.md +620 -620
  521. package/lib/assets/docs/article/grokkingfp/clojure/part-4.md +697 -697
  522. package/lib/assets/docs/article/grokkingfp/clojure/part-5.md +751 -751
  523. package/lib/assets/docs/article/grokkingfp/clojure/part-6.md +721 -721
  524. package/lib/assets/docs/article/grokkingfp/csharp/index.md +246 -246
  525. package/lib/assets/docs/article/grokkingfp/csharp/part-1.md +811 -811
  526. package/lib/assets/docs/article/grokkingfp/csharp/part-2.md +971 -971
  527. package/lib/assets/docs/article/grokkingfp/csharp/part-3.md +981 -981
  528. package/lib/assets/docs/article/grokkingfp/csharp/part-4.md +949 -949
  529. package/lib/assets/docs/article/grokkingfp/csharp/part-5.md +947 -947
  530. package/lib/assets/docs/article/grokkingfp/csharp/part-6.md +739 -739
  531. package/lib/assets/docs/article/grokkingfp/elixir/index.md +203 -203
  532. package/lib/assets/docs/article/grokkingfp/elixir/part-1.md +712 -712
  533. package/lib/assets/docs/article/grokkingfp/elixir/part-2.md +838 -838
  534. package/lib/assets/docs/article/grokkingfp/elixir/part-3.md +985 -985
  535. package/lib/assets/docs/article/grokkingfp/elixir/part-4.md +974 -974
  536. package/lib/assets/docs/article/grokkingfp/elixir/part-5.md +1286 -1286
  537. package/lib/assets/docs/article/grokkingfp/elixir/part-6.md +1049 -1049
  538. package/lib/assets/docs/article/grokkingfp/fsharp/index.md +210 -210
  539. package/lib/assets/docs/article/grokkingfp/fsharp/part-1.md +714 -714
  540. package/lib/assets/docs/article/grokkingfp/fsharp/part-2.md +961 -961
  541. package/lib/assets/docs/article/grokkingfp/fsharp/part-3.md +972 -972
  542. package/lib/assets/docs/article/grokkingfp/fsharp/part-4.md +832 -832
  543. package/lib/assets/docs/article/grokkingfp/fsharp/part-5.md +911 -911
  544. package/lib/assets/docs/article/grokkingfp/fsharp/part-6.md +922 -922
  545. package/lib/assets/docs/article/grokkingfp/haskell/index.md +234 -234
  546. package/lib/assets/docs/article/grokkingfp/haskell/part-1.md +591 -591
  547. package/lib/assets/docs/article/grokkingfp/haskell/part-2.md +866 -866
  548. package/lib/assets/docs/article/grokkingfp/haskell/part-3.md +915 -915
  549. package/lib/assets/docs/article/grokkingfp/haskell/part-4.md +878 -878
  550. package/lib/assets/docs/article/grokkingfp/haskell/part-5.md +845 -845
  551. package/lib/assets/docs/article/grokkingfp/haskell/part-6.md +844 -844
  552. package/lib/assets/docs/article/grokkingfp/index.md +143 -143
  553. package/lib/assets/docs/article/grokkingfp/java/index.md +211 -211
  554. package/lib/assets/docs/article/grokkingfp/java/part-1.md +648 -648
  555. package/lib/assets/docs/article/grokkingfp/java/part-2.md +675 -675
  556. package/lib/assets/docs/article/grokkingfp/java/part-3.md +672 -672
  557. package/lib/assets/docs/article/grokkingfp/java/part-4.md +771 -771
  558. package/lib/assets/docs/article/grokkingfp/java/part-5.md +959 -959
  559. package/lib/assets/docs/article/grokkingfp/java/part-6.md +1328 -1328
  560. package/lib/assets/docs/article/grokkingfp/python/index.md +258 -258
  561. package/lib/assets/docs/article/grokkingfp/python/part-1.md +443 -443
  562. package/lib/assets/docs/article/grokkingfp/python/part-2.md +958 -958
  563. package/lib/assets/docs/article/grokkingfp/python/part-3.md +1004 -1004
  564. package/lib/assets/docs/article/grokkingfp/python/part-4.md +765 -765
  565. package/lib/assets/docs/article/grokkingfp/python/part-5.md +747 -747
  566. package/lib/assets/docs/article/grokkingfp/python/part-6.md +861 -861
  567. package/lib/assets/docs/article/grokkingfp/ruby/index.md +330 -330
  568. package/lib/assets/docs/article/grokkingfp/ruby/part-1.md +755 -755
  569. package/lib/assets/docs/article/grokkingfp/ruby/part-2.md +938 -938
  570. package/lib/assets/docs/article/grokkingfp/ruby/part-3.md +946 -946
  571. package/lib/assets/docs/article/grokkingfp/ruby/part-4.md +921 -921
  572. package/lib/assets/docs/article/grokkingfp/ruby/part-5.md +908 -908
  573. package/lib/assets/docs/article/grokkingfp/ruby/part-6.md +1412 -1412
  574. package/lib/assets/docs/article/grokkingfp/rust/index.md +242 -242
  575. package/lib/assets/docs/article/grokkingfp/rust/part-1.md +634 -634
  576. package/lib/assets/docs/article/grokkingfp/rust/part-2.md +1060 -1060
  577. package/lib/assets/docs/article/grokkingfp/rust/part-3.md +994 -994
  578. package/lib/assets/docs/article/grokkingfp/rust/part-4.md +573 -573
  579. package/lib/assets/docs/article/grokkingfp/rust/part-5.md +705 -705
  580. package/lib/assets/docs/article/grokkingfp/rust/part-6.md +508 -508
  581. package/lib/assets/docs/article/grokkingfp/scala/index.md +171 -171
  582. package/lib/assets/docs/article/grokkingfp/scala/part-1.md +543 -543
  583. package/lib/assets/docs/article/grokkingfp/scala/part-2.md +946 -946
  584. package/lib/assets/docs/article/grokkingfp/scala/part-3.md +919 -919
  585. package/lib/assets/docs/article/grokkingfp/scala/part-4.md +742 -742
  586. package/lib/assets/docs/article/grokkingfp/scala/part-5.md +722 -722
  587. package/lib/assets/docs/article/grokkingfp/scala/part-6.md +867 -867
  588. package/lib/assets/docs/article/grokkingfp/typescript/index.md +273 -273
  589. package/lib/assets/docs/article/grokkingfp/typescript/part-1.md +561 -561
  590. package/lib/assets/docs/article/grokkingfp/typescript/part-2.md +1129 -1129
  591. package/lib/assets/docs/article/grokkingfp/typescript/part-3.md +842 -842
  592. package/lib/assets/docs/article/grokkingfp/typescript/part-4.md +1087 -1087
  593. package/lib/assets/docs/article/grokkingfp/typescript/part-5.md +717 -717
  594. package/lib/assets/docs/article/grokkingfp/typescript/part-6.md +982 -982
  595. package/lib/assets/docs/article/index.md +41 -41
  596. package/lib/assets/docs/article/practical-database-design/index.md +121 -121
  597. package/lib/assets/docs/article/practical-database-design/part1/chapter01.md +288 -288
  598. package/lib/assets/docs/article/practical-database-design/part1/chapter02.md +518 -518
  599. package/lib/assets/docs/article/practical-database-design/part1/chapter03.md +557 -557
  600. package/lib/assets/docs/article/practical-database-design/part2/chapter04.md +924 -924
  601. package/lib/assets/docs/article/practical-database-design/part2/chapter05.md +1627 -1627
  602. package/lib/assets/docs/article/practical-database-design/part2/chapter06.md +2716 -2716
  603. package/lib/assets/docs/article/practical-database-design/part2/chapter07.md +2082 -2082
  604. package/lib/assets/docs/article/practical-database-design/part2/chapter08.md +2105 -2105
  605. package/lib/assets/docs/article/practical-database-design/part2/chapter09.md +2031 -2031
  606. package/lib/assets/docs/article/practical-database-design/part2/chapter10.md +1387 -1387
  607. package/lib/assets/docs/article/practical-database-design/part2/chapter11.md +1677 -1677
  608. package/lib/assets/docs/article/practical-database-design/part2/chapter12.md +1417 -1417
  609. package/lib/assets/docs/article/practical-database-design/part2/chapter13.md +1434 -1434
  610. package/lib/assets/docs/article/practical-database-design/part3/chapter14.md +667 -667
  611. package/lib/assets/docs/article/practical-database-design/part3/chapter15.md +1625 -1625
  612. package/lib/assets/docs/article/practical-database-design/part3/chapter16.md +1915 -1915
  613. package/lib/assets/docs/article/practical-database-design/part3/chapter17.md +1708 -1708
  614. package/lib/assets/docs/article/practical-database-design/part3/chapter18.md +2095 -2095
  615. package/lib/assets/docs/article/practical-database-design/part3/chapter19.md +1123 -1123
  616. package/lib/assets/docs/article/practical-database-design/part3/chapter20.md +1031 -1031
  617. package/lib/assets/docs/article/practical-database-design/part3/chapter21.md +1382 -1382
  618. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter14-orm.md +991 -991
  619. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter15-orm.md +1300 -1300
  620. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter16-orm.md +1166 -1166
  621. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter17-orm.md +1584 -1584
  622. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter18-orm.md +1183 -1183
  623. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter19-orm.md +1016 -1016
  624. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter20-orm.md +1753 -1753
  625. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter21-orm.md +1447 -1447
  626. package/lib/assets/docs/article/practical-database-design/part3-orm/chapter22-orm.md +1878 -1878
  627. package/lib/assets/docs/article/practical-database-design/part4/chapter22.md +965 -965
  628. package/lib/assets/docs/article/practical-database-design/part4/chapter23.md +2069 -2069
  629. package/lib/assets/docs/article/practical-database-design/part4/chapter24.md +2439 -2439
  630. package/lib/assets/docs/article/practical-database-design/part4/chapter25.md +3661 -3661
  631. package/lib/assets/docs/article/practical-database-design/part4/chapter26.md +2916 -2916
  632. package/lib/assets/docs/article/practical-database-design/part4/chapter27.md +3105 -3105
  633. package/lib/assets/docs/article/practical-database-design/part4/chapter28.md +2697 -2697
  634. package/lib/assets/docs/article/practical-database-design/part4/chapter29.md +2544 -2544
  635. package/lib/assets/docs/article/practical-database-design/part4/chapter30.md +2180 -2180
  636. package/lib/assets/docs/article/practical-database-design/part4/chapter31.md +1192 -1192
  637. package/lib/assets/docs/article/practical-database-design/part4/chapter32.md +2101 -2101
  638. package/lib/assets/docs/article/practical-database-design/part5/chapter33.md +1032 -1032
  639. package/lib/assets/docs/article/practical-database-design/part5/chapter34.md +1609 -1609
  640. package/lib/assets/docs/article/practical-database-design/part5/chapter35.md +1453 -1453
  641. package/lib/assets/docs/article/practical-database-design/part5/chapter36.md +1292 -1292
  642. package/lib/assets/docs/article/practical-database-design/part5/chapter37.md +1470 -1470
  643. package/lib/assets/docs/article/practical-database-design/part5/chapter38.md +1698 -1698
  644. package/lib/assets/docs/article/practical-database-design/part5/chapter39.md +2334 -2334
  645. package/lib/assets/docs/article/practical-database-design/study/study2-1.md +1693 -1693
  646. package/lib/assets/docs/article/practical-database-design/study/study2-2.md +1347 -1347
  647. package/lib/assets/docs/article/practical-database-design/study/study2-3.md +2044 -2044
  648. package/lib/assets/docs/article/practical-database-design/study/study2-4.md +2229 -2229
  649. package/lib/assets/docs/article/practical-database-design/study/study2-5.md +2418 -2418
  650. package/lib/assets/docs/article/practical-database-design/study/study3-1.md +2205 -2205
  651. package/lib/assets/docs/article/practical-database-design/study/study3-2.md +2221 -2221
  652. package/lib/assets/docs/article/practical-database-design/study/study3-3.md +2253 -2253
  653. package/lib/assets/docs/article/practical-database-design/study/study3-4.md +2106 -2106
  654. package/lib/assets/docs/article/practical-database-design/study/study3-5.md +2507 -2507
  655. package/lib/assets/docs/article/practical-database-design/study/study4-1.md +2587 -2587
  656. package/lib/assets/docs/article/practical-database-design/study/study4-2.md +2075 -2075
  657. package/lib/assets/docs/article/practical-database-design/study/study4-3.md +1805 -1805
  658. package/lib/assets/docs/article/practical-database-design/study/study4-4.md +1895 -1895
  659. package/lib/assets/docs/article/practical-database-design/study/study4-5.md +2878 -2878
  660. package/lib/assets/docs/assets/css/extra.css +29 -29
  661. package/lib/assets/docs/assets/js/extra.js +44 -44
  662. package/lib/assets/docs/design/index.md +44 -44
  663. package/lib/assets/docs/development/index.md +39 -39
  664. package/lib/assets/docs/index.md +33 -33
  665. package/lib/assets/docs/operation/index.md +27 -27
  666. 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
  667. 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
  668. 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
  669. 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
  670. 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
  671. package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +450 -450
  672. package/lib/assets/docs/reference/images/Ansoff.drawio.svg +3 -3
  673. package/lib/assets/docs/reference/images/BMC.drawio.svg +3 -3
  674. package/lib/assets/docs/reference/images/BrandBasicStrategy.drawio.svg +3 -3
  675. package/lib/assets/docs/reference/images/BrandCategorization.drawio.svg +3 -3
  676. package/lib/assets/docs/reference/images/BrandRecurutementStrategy.drawio.svg +3 -3
  677. package/lib/assets/docs/reference/images/BrandValue.drawio.svg +3 -3
  678. package/lib/assets/docs/reference/images/BusinessActivitiy.svg +3 -3
  679. package/lib/assets/docs/reference/images/HRM.drawio.svg +3 -3
  680. package/lib/assets/docs/reference/images/MarketingStructure.drawio.svg +3 -3
  681. package/lib/assets/docs/reference/images/OrganizationElemnts.svg +3 -3
  682. package/lib/assets/docs/reference/images/PPM.drawio.svg +3 -3
  683. package/lib/assets/docs/reference/images/PositioningMap.drawio.svg +3 -3
  684. package/lib/assets/docs/reference/images/ProductLayer.drawio.svg +3 -3
  685. package/lib/assets/docs/reference/images/ProductMix.drawio.svg +3 -3
  686. package/lib/assets/docs/reference/images/SWOT.drawio.svg +3 -3
  687. package/lib/assets/docs/reference/images/TargetMarket.drawio.svg +3 -3
  688. package/lib/assets/docs/reference/images/ThreeGenericStrategies.drawio.svg +3 -3
  689. package/lib/assets/docs/reference/images/VRIO.drawio.svg +3 -3
  690. package/lib/assets/docs/reference/images/ValueChain.drawio.svg +3 -3
  691. package/lib/assets/docs/reference/index.md +53 -53
  692. 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
  693. 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
  694. 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
  695. 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
  696. 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
  697. 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
  698. 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
  699. 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
  700. 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
  701. 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
  702. 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
  703. 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
  704. 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
  705. package/lib/assets/docs/reference//344/274/201/346/245/255/347/265/214/345/226/266/350/253/226.md +2637 -2637
  706. 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
  707. 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
  708. 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
  709. 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
  710. package/lib/assets/docs/reference//351/201/213/345/226/266/347/256/241/347/220/206.md +1482 -1482
  711. 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
  712. 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
  713. package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +305 -305
  714. 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
  715. package/lib/assets/docs/requirements/index.md +17 -17
  716. package/lib/assets/docs/review/index.md +5 -5
  717. package/lib/assets/docs/strategy/index.md +17 -17
  718. package/lib/assets/docs/template/ADR.md +30 -30
  719. 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
  720. 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
  721. package/lib/assets/docs/template/README.md +50 -50
  722. package/lib/assets/docs/template/index.md +24 -24
  723. 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
  724. 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
  725. 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
  726. 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
  727. 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
  728. 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
  729. 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
  730. package/lib/assets/docs/template//344/272/213/344/276/213/345/210/206/346/236/220.md +513 -513
  731. package/lib/assets/docs/template//344/274/201/346/245/255/345/210/206/346/236/220.md +573 -573
  732. 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
  733. package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
  734. package/lib/assets/docs/template//350/250/255/350/250/210.md +173 -173
  735. 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
  736. package/lib/assets/gulpfile.js +25 -25
  737. package/lib/assets/mkdocs.yml +139 -139
  738. package/lib/assets/ops/docker/mkdoc/Dockerfile +19 -19
  739. package/lib/assets/ops/docker/sonarqube-local/docker-compose.yml +57 -57
  740. package/lib/assets/ops/scripts/journal.js +180 -180
  741. package/lib/assets/ops/scripts/mkdocs.js +82 -82
  742. package/lib/assets/ops/scripts/release.js +431 -431
  743. package/lib/assets/ops/scripts/sonar_local.js +726 -726
  744. package/lib/assets/ops/scripts/ssh.js +190 -190
  745. package/lib/assets/ops/scripts/vault.js +299 -299
  746. package/lib/assets/package-lock.json +1653 -1653
  747. package/lib/assets/package.json +40 -40
  748. package/lib/gulpfile.js +37 -37
  749. 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
  非機能要件は、変更を楽に安全にできて役に立つソフトウェアを実現するための基盤である。適切な定義と継続的な管理により、持続的な価値提供を可能にする。