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