@k2works/claude-code-booster 3.6.1 → 3.7.0

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