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