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