blockmine 1.24.0 → 1.27.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 (476) hide show
  1. package/CHANGELOG.md +76 -1
  2. package/README.en.md +427 -0
  3. package/README.md +40 -0
  4. package/backend/package.json +2 -2
  5. package/backend/prisma/migrations/20260328173000_add_plugin_source_ref/migration.sql +2 -0
  6. package/backend/prisma/migrations/migration_lock.toml +2 -2
  7. package/backend/prisma/schema.prisma +2 -0
  8. package/backend/src/ai/plugin-assistant-system-prompt.md +664 -5
  9. package/backend/src/api/routes/apiKeys.js +8 -0
  10. package/backend/src/api/routes/bots.js +271 -9
  11. package/backend/src/api/routes/eventGraphs.js +151 -1
  12. package/backend/src/api/routes/health.js +38 -0
  13. package/backend/src/api/routes/nodeRegistry.js +63 -0
  14. package/backend/src/api/routes/plugins.js +254 -29
  15. package/backend/src/api/routes/servers.js +14 -2
  16. package/backend/src/container.js +11 -8
  17. package/backend/src/core/BotCommandLoader.js +161 -0
  18. package/backend/src/core/BotConnection.js +125 -0
  19. package/backend/src/core/BotEventHandlers.js +234 -0
  20. package/backend/src/core/BotIPCHandler.js +445 -0
  21. package/backend/src/core/BotManager.js +15 -7
  22. package/backend/src/core/BotProcess.js +169 -140
  23. package/backend/src/core/EventGraphManager.js +7 -3
  24. package/backend/src/core/GraphDebugHandler.js +229 -0
  25. package/backend/src/core/GraphDebugIPC.js +117 -0
  26. package/backend/src/core/GraphExecutionEngine.js +545 -978
  27. package/backend/src/core/GraphTraversal.js +80 -0
  28. package/backend/src/core/GraphValidation.js +73 -0
  29. package/backend/src/core/NodeDefinition.js +138 -0
  30. package/backend/src/core/NodeRegistry.js +153 -141
  31. package/backend/src/core/PluginLoader.js +83 -3
  32. package/backend/src/core/PluginManager.js +346 -35
  33. package/backend/src/core/RewindSignal.js +9 -0
  34. package/backend/src/core/config/ConfigValidator.js +72 -0
  35. package/backend/src/core/config/FeatureFlags.js +52 -0
  36. package/backend/src/core/config/__tests__/ConfigValidator.test.js +232 -0
  37. package/backend/src/core/domain/entities/Bot.js +39 -0
  38. package/backend/src/core/domain/entities/Command.js +41 -0
  39. package/backend/src/core/domain/entities/EventGraph.js +39 -0
  40. package/backend/src/core/domain/entities/Plugin.js +45 -0
  41. package/backend/src/core/domain/entities/User.js +40 -0
  42. package/backend/src/core/domain/services/DependencyResolver.js +168 -0
  43. package/backend/src/core/domain/services/GraphValidator.js +117 -0
  44. package/backend/src/core/domain/services/PermissionChecker.js +34 -0
  45. package/backend/src/core/domain/services/__tests__/DependencyResolver.test.js +126 -0
  46. package/backend/src/core/domain/valueObjects/BotConfig.js +27 -0
  47. package/backend/src/core/domain/valueObjects/DependencyGraph.js +86 -0
  48. package/backend/src/core/domain/valueObjects/PluginManifest.js +36 -0
  49. package/backend/src/core/errors/BaseError.js +29 -0
  50. package/backend/src/core/errors/ErrorHandler.js +81 -0
  51. package/backend/src/core/errors/__tests__/ErrorHandler.test.js +188 -0
  52. package/backend/src/core/errors/index.js +68 -0
  53. package/backend/src/core/infrastructure/BatchingUtility.js +66 -0
  54. package/backend/src/core/infrastructure/CircuitBreaker.js +103 -0
  55. package/backend/src/core/infrastructure/ConnectionPool.js +81 -0
  56. package/backend/src/core/infrastructure/RateLimiter.js +64 -0
  57. package/backend/src/core/infrastructure/__tests__/BatchingUtility.test.js +86 -0
  58. package/backend/src/core/infrastructure/__tests__/CircuitBreaker.test.js +156 -0
  59. package/backend/src/core/infrastructure/__tests__/ConnectionPool.test.js +146 -0
  60. package/backend/src/core/infrastructure/__tests__/RateLimiter.test.js +171 -0
  61. package/backend/src/core/ipc/botApiFactory.js +72 -0
  62. package/backend/src/core/ipc/ipcMessageTypes.js +115 -0
  63. package/backend/src/core/logging/AuditLogger.js +61 -0
  64. package/backend/src/core/logging/StructuredLogger.js +80 -0
  65. package/backend/src/core/logging/__tests__/StructuredLogger.test.js +213 -0
  66. package/backend/src/core/logging/index.js +7 -0
  67. package/backend/src/core/metrics/MetricsCollector.js +104 -0
  68. package/backend/src/core/metrics/__tests__/MetricsCollector.test.js +131 -0
  69. package/backend/src/core/node-registries/actionsNodes.js +191 -0
  70. package/backend/src/core/node-registries/arraysNodes.js +152 -0
  71. package/backend/src/core/node-registries/botNodes.js +48 -0
  72. package/backend/src/core/node-registries/containerNodes.js +141 -0
  73. package/backend/src/core/node-registries/dataNodes.js +284 -0
  74. package/backend/src/core/node-registries/debugNodes.js +23 -0
  75. package/backend/src/core/node-registries/eventsNodes.js +223 -0
  76. package/backend/src/core/node-registries/flowNodes.js +151 -0
  77. package/backend/src/core/node-registries/furnaceNodes.js +123 -0
  78. package/backend/src/core/node-registries/index.js +108 -0
  79. package/backend/src/core/node-registries/inventory.js +102 -106
  80. package/backend/src/core/node-registries/logicNodes.js +54 -0
  81. package/backend/src/core/node-registries/mathNodes.js +38 -0
  82. package/backend/src/core/node-registries/navigationNodes.js +109 -0
  83. package/backend/src/core/node-registries/objectsNodes.js +90 -0
  84. package/backend/src/core/node-registries/stringsNodes.js +165 -0
  85. package/backend/src/core/node-registries/timeNodes.js +105 -0
  86. package/backend/src/core/node-registries/typeNodes.js +22 -0
  87. package/backend/src/core/node-registries/usersNodes.js +126 -0
  88. package/backend/src/core/nodes/arrays/shuffle.js +14 -0
  89. package/backend/src/core/nodes/bot/get_name.js +8 -0
  90. package/backend/src/core/nodes/bot/stop_bot.js +5 -0
  91. package/backend/src/core/nodes/container/open.js +101 -111
  92. package/backend/src/core/nodes/data/store_read.js +26 -0
  93. package/backend/src/core/nodes/data/store_write.js +23 -0
  94. package/backend/src/core/nodes/event/call_event.js +31 -0
  95. package/backend/src/core/nodes/event/custom_event.js +8 -0
  96. package/backend/src/core/nodes/flow/timer.js +35 -0
  97. package/backend/src/core/nodes/inventory/drop.js +73 -65
  98. package/backend/src/core/nodes/inventory/equip.js +54 -45
  99. package/backend/src/core/nodes/inventory/select_slot.js +48 -46
  100. package/backend/src/core/nodes/navigation/follow.js +54 -51
  101. package/backend/src/core/nodes/navigation/go_to.js +41 -53
  102. package/backend/src/core/nodes/navigation/go_to_entity.js +65 -69
  103. package/backend/src/core/nodes/navigation/go_to_player.js +65 -70
  104. package/backend/src/core/nodes/navigation/stop.js +17 -26
  105. package/backend/src/core/nodes/users/add_to_group.js +24 -0
  106. package/backend/src/core/nodes/users/check_permission.js +26 -0
  107. package/backend/src/core/nodes/users/remove_from_group.js +24 -0
  108. package/backend/src/core/services/BotIPCMessageRouter.js +337 -0
  109. package/backend/src/core/services/BotLifecycleService.js +43 -450
  110. package/backend/src/core/services/CacheManager.js +83 -23
  111. package/backend/src/core/services/CrashRestartManager.js +42 -0
  112. package/backend/src/core/services/DebugSessionManager.js +114 -12
  113. package/backend/src/core/services/EventGraphService.js +69 -0
  114. package/backend/src/core/services/MinecraftBotManager.js +9 -1
  115. package/backend/src/core/services/PluginManagementService.js +84 -0
  116. package/backend/src/core/services/TestModeContext.js +65 -0
  117. package/backend/src/core/services/__tests__/CacheManager.test.js +168 -0
  118. package/backend/src/core/services.js +1 -11
  119. package/backend/src/core/validation/InputValidator.js +167 -0
  120. package/backend/src/core/validation/__tests__/InputValidator.test.js +296 -0
  121. package/backend/src/real-time/botApi/index.js +1 -1
  122. package/backend/src/real-time/socketHandler.js +26 -0
  123. package/backend/src/server.js +21 -6
  124. package/frontend/dist/assets/browser-ponyfill-D8y0Ty7C.js +2 -0
  125. package/frontend/dist/assets/index-CFJLS0dk.css +32 -0
  126. package/frontend/dist/assets/index-D91UGNMG.js +11260 -0
  127. package/frontend/dist/flags/en.svg +32 -0
  128. package/frontend/dist/flags/ru.svg +5 -0
  129. package/frontend/dist/index.html +2 -2
  130. package/frontend/dist/locales/en/admin.json +100 -0
  131. package/frontend/dist/locales/en/api-keys.json +58 -0
  132. package/frontend/dist/locales/en/bots.json +113 -0
  133. package/frontend/dist/locales/en/common.json +53 -0
  134. package/frontend/dist/locales/en/configuration.json +22 -0
  135. package/frontend/dist/locales/en/console.json +10 -0
  136. package/frontend/dist/locales/en/dashboard.json +85 -0
  137. package/frontend/dist/locales/en/dialogs.json +70 -0
  138. package/frontend/dist/locales/en/event-graphs.json +50 -0
  139. package/frontend/dist/locales/en/graph-store.json +70 -0
  140. package/frontend/dist/locales/en/login.json +36 -0
  141. package/frontend/dist/locales/en/management.json +192 -0
  142. package/frontend/dist/locales/en/minecraft-viewer.json +27 -0
  143. package/frontend/dist/locales/en/nodes.json +1132 -0
  144. package/frontend/dist/locales/en/permissions.json +50 -0
  145. package/frontend/dist/locales/en/plugin-detail.json +69 -0
  146. package/frontend/dist/locales/en/plugins.json +329 -0
  147. package/frontend/dist/locales/en/proxies.json +81 -0
  148. package/frontend/dist/locales/en/servers.json +39 -0
  149. package/frontend/dist/locales/en/setup.json +19 -0
  150. package/frontend/dist/locales/en/sidebar.json +195 -0
  151. package/frontend/dist/locales/en/tasks.json +62 -0
  152. package/frontend/dist/locales/en/visual-editor.json +418 -0
  153. package/frontend/dist/locales/en/websocket.json +86 -0
  154. package/frontend/dist/locales/ru/admin.json +100 -0
  155. package/frontend/dist/locales/ru/api-keys.json +58 -0
  156. package/frontend/dist/locales/ru/bots.json +113 -0
  157. package/frontend/dist/locales/ru/common.json +49 -0
  158. package/frontend/dist/locales/ru/configuration.json +22 -0
  159. package/frontend/dist/locales/ru/console.json +10 -0
  160. package/frontend/dist/locales/ru/dashboard.json +85 -0
  161. package/frontend/dist/locales/ru/dialogs.json +70 -0
  162. package/frontend/dist/locales/ru/event-graphs.json +50 -0
  163. package/frontend/dist/locales/ru/graph-store.json +70 -0
  164. package/frontend/dist/locales/ru/login.json +36 -0
  165. package/frontend/dist/locales/ru/management.json +192 -0
  166. package/frontend/dist/locales/ru/minecraft-viewer.json +30 -0
  167. package/frontend/dist/locales/ru/nodes.json +1131 -0
  168. package/frontend/dist/locales/ru/permissions.json +50 -0
  169. package/frontend/dist/locales/ru/plugin-detail.json +49 -0
  170. package/frontend/dist/locales/ru/plugins.json +209 -0
  171. package/frontend/dist/locales/ru/proxies.json +81 -0
  172. package/frontend/dist/locales/ru/servers.json +39 -0
  173. package/frontend/dist/locales/ru/setup.json +19 -0
  174. package/frontend/dist/locales/ru/sidebar.json +195 -0
  175. package/frontend/dist/locales/ru/tasks.json +62 -0
  176. package/frontend/dist/locales/ru/visual-editor.json +420 -0
  177. package/frontend/dist/locales/ru/websocket.json +86 -0
  178. package/frontend/dist/monacoeditorwork/css.worker.bundle.js +7 -7
  179. package/frontend/dist/monacoeditorwork/html.worker.bundle.js +7 -7
  180. package/frontend/dist/monacoeditorwork/json.worker.bundle.js +7 -7
  181. package/frontend/dist/monacoeditorwork/ts.worker.bundle.js +3 -3
  182. package/frontend/package.json +6 -0
  183. package/nul +12 -0
  184. package/package.json +3 -3
  185. package/screen/3dviewer.png +0 -0
  186. package/screen/console.png +0 -0
  187. package/screen/dashboard.png +0 -0
  188. package/screen/graph_collabe.png +0 -0
  189. package/screen/graph_live_debug.png +0 -0
  190. package/screen/language_selector.png +0 -0
  191. package/screen/management_command.png +0 -0
  192. package/screen/node_debug_trace.png +0 -0
  193. package/screen/plugin_/320/276/320/261/320/267/320/276/321/200.png +0 -0
  194. package/screen/websocket.png +0 -0
  195. package/screen//320/275/320/260/321/201/321/202/321/200/320/276/320/271/320/272/320/270_/320/276/321/202/320/264/320/265/320/273/321/214/320/275/321/213/321/205_/320/272/320/276/320/274/320/260/320/275/320/264_/320/272/320/260/320/266/320/264/321/203_/320/272/320/276/320/274/320/260/320/275/320/273/320/264/321/203_/320/274/320/276/320/266/320/275/320/276_/320/275/320/260/321/201/321/202/321/200/320/260/320/270/320/262/320/260/321/202/321/214.png +0 -0
  196. package/screen//320/277/320/273/320/260/320/275/320/270/321/200/320/276/320/262/321/211/320/270/320/272_/320/274/320/276/320/266/320/275/320/276_/320/267/320/260/320/264/320/260/320/262/320/260/321/202/321/214_/320/264/320/265/320/271/321/201/321/202/320/262/320/270/321/217_/320/277/320/276_/320/262/321/200/320/265/320/274/320/265/320/275/320/270.png +0 -0
  197. package/.claude/agents/README.md +0 -469
  198. package/.claude/agents/auth-route-debugger.md +0 -118
  199. package/.claude/agents/auth-route-tester.md +0 -93
  200. package/.claude/agents/auto-error-resolver.md +0 -97
  201. package/.claude/agents/build-optimizer.md +0 -236
  202. package/.claude/agents/code-architect.md +0 -34
  203. package/.claude/agents/code-architecture-reviewer.md +0 -83
  204. package/.claude/agents/code-explorer.md +0 -51
  205. package/.claude/agents/code-refactor-master.md +0 -94
  206. package/.claude/agents/code-reviewer.md +0 -46
  207. package/.claude/agents/cost-optimizer.md +0 -134
  208. package/.claude/agents/deployment-orchestrator.md +0 -113
  209. package/.claude/agents/documentation-architect.md +0 -82
  210. package/.claude/agents/frontend-error-fixer.md +0 -77
  211. package/.claude/agents/iac-code-generator.md +0 -71
  212. package/.claude/agents/incident-responder.md +0 -346
  213. package/.claude/agents/infrastructure-architect.md +0 -31
  214. package/.claude/agents/kubernetes-specialist.md +0 -56
  215. package/.claude/agents/migration-planner.md +0 -181
  216. package/.claude/agents/network-architect.md +0 -196
  217. package/.claude/agents/plan-reviewer.md +0 -52
  218. package/.claude/agents/refactor-planner.md +0 -63
  219. package/.claude/agents/security-scanner.md +0 -102
  220. package/.claude/agents/web-research-specialist.md +0 -78
  221. package/.claude/commands/cost-analysis.md +0 -315
  222. package/.claude/commands/dev-docs-update.md +0 -55
  223. package/.claude/commands/dev-docs.md +0 -51
  224. package/.claude/commands/feature-dev.md +0 -125
  225. package/.claude/commands/incident-debug.md +0 -247
  226. package/.claude/commands/infra-plan.md +0 -81
  227. package/.claude/commands/migration-plan.md +0 -478
  228. package/.claude/commands/route-research-for-testing.md +0 -37
  229. package/.claude/commands/security-review.md +0 -66
  230. package/.claude/hooks/CONFIG.md +0 -448
  231. package/.claude/hooks/README.md +0 -163
  232. package/.claude/hooks/SKILL_ACTIVATION_COMPLETE.md +0 -226
  233. package/.claude/hooks/WINDOWS_HOOKS_README.md +0 -151
  234. package/.claude/hooks/add-skill-activation-banners.ts +0 -132
  235. package/.claude/hooks/comprehensive-skill-test.ts +0 -1315
  236. package/.claude/hooks/error-handling-reminder.sh +0 -12
  237. package/.claude/hooks/error-handling-reminder.ts +0 -222
  238. package/.claude/hooks/k8s-manifest-validator.sh +0 -56
  239. package/.claude/hooks/package-lock.json +0 -556
  240. package/.claude/hooks/package.json +0 -16
  241. package/.claude/hooks/post-tool-use-tracker.ps1 +0 -174
  242. package/.claude/hooks/post-tool-use-tracker.sh +0 -183
  243. package/.claude/hooks/security-policy-check.sh +0 -247
  244. package/.claude/hooks/skill-activation-prompt.ps1 +0 -10
  245. package/.claude/hooks/skill-activation-prompt.sh +0 -10
  246. package/.claude/hooks/skill-activation-prompt.ts +0 -141
  247. package/.claude/hooks/stop-build-check-enhanced.sh +0 -130
  248. package/.claude/hooks/terraform-validator.sh +0 -53
  249. package/.claude/hooks/test-input.json +0 -7
  250. package/.claude/hooks/test-skill-activation.ts +0 -427
  251. package/.claude/hooks/trigger-build-resolver.sh +0 -79
  252. package/.claude/hooks/tsc-check.sh +0 -173
  253. package/.claude/hooks/tsconfig.json +0 -19
  254. package/.claude/settings.json +0 -59
  255. package/.claude/settings.local.json +0 -67
  256. package/.claude/skills/README.md +0 -507
  257. package/.claude/skills/api-engineering/SKILL.md +0 -63
  258. package/.claude/skills/api-engineering/resources/api-versioning.md +0 -88
  259. package/.claude/skills/api-engineering/resources/graphql-patterns.md +0 -106
  260. package/.claude/skills/api-engineering/resources/rate-limiting.md +0 -118
  261. package/.claude/skills/api-engineering/resources/rest-api-design.md +0 -105
  262. package/.claude/skills/backend-dev-guidelines/SKILL.md +0 -306
  263. package/.claude/skills/backend-dev-guidelines/resources/architecture-overview.md +0 -451
  264. package/.claude/skills/backend-dev-guidelines/resources/async-and-errors.md +0 -307
  265. package/.claude/skills/backend-dev-guidelines/resources/complete-examples.md +0 -638
  266. package/.claude/skills/backend-dev-guidelines/resources/configuration.md +0 -275
  267. package/.claude/skills/backend-dev-guidelines/resources/database-patterns.md +0 -224
  268. package/.claude/skills/backend-dev-guidelines/resources/middleware-guide.md +0 -213
  269. package/.claude/skills/backend-dev-guidelines/resources/routing-and-controllers.md +0 -756
  270. package/.claude/skills/backend-dev-guidelines/resources/sentry-and-monitoring.md +0 -336
  271. package/.claude/skills/backend-dev-guidelines/resources/services-and-repositories.md +0 -789
  272. package/.claude/skills/backend-dev-guidelines/resources/testing-guide.md +0 -235
  273. package/.claude/skills/backend-dev-guidelines/resources/validation-patterns.md +0 -754
  274. package/.claude/skills/budget-and-cost-management/SKILL.md +0 -850
  275. package/.claude/skills/build-engineering/SKILL.md +0 -431
  276. package/.claude/skills/build-engineering/resources/artifact-repositories.md +0 -72
  277. package/.claude/skills/build-engineering/resources/build-caching.md +0 -96
  278. package/.claude/skills/build-engineering/resources/build-pipelines.md +0 -105
  279. package/.claude/skills/build-engineering/resources/build-security.md +0 -95
  280. package/.claude/skills/build-engineering/resources/build-systems.md +0 -389
  281. package/.claude/skills/build-engineering/resources/compilation-optimization.md +0 -201
  282. package/.claude/skills/build-engineering/resources/dependency-management.md +0 -73
  283. package/.claude/skills/build-engineering/resources/monorepo-builds.md +0 -110
  284. package/.claude/skills/build-engineering/resources/performance-optimization.md +0 -113
  285. package/.claude/skills/build-engineering/resources/reproducible-builds.md +0 -82
  286. package/.claude/skills/cloud-engineering/SKILL.md +0 -675
  287. package/.claude/skills/cloud-engineering/resources/aws-patterns.md +0 -742
  288. package/.claude/skills/cloud-engineering/resources/azure-patterns.md +0 -714
  289. package/.claude/skills/cloud-engineering/resources/cleared-cloud-environments.md +0 -987
  290. package/.claude/skills/cloud-engineering/resources/cloud-cost-optimization.md +0 -757
  291. package/.claude/skills/cloud-engineering/resources/cloud-networking.md +0 -1058
  292. package/.claude/skills/cloud-engineering/resources/cloud-security-tools.md +0 -1530
  293. package/.claude/skills/cloud-engineering/resources/cloud-security.md +0 -990
  294. package/.claude/skills/cloud-engineering/resources/gcp-patterns.md +0 -758
  295. package/.claude/skills/cloud-engineering/resources/migration-strategies.md +0 -820
  296. package/.claude/skills/cloud-engineering/resources/multi-cloud-strategies.md +0 -670
  297. package/.claude/skills/cloud-engineering/resources/oci-patterns.md +0 -1198
  298. package/.claude/skills/cloud-engineering/resources/serverless-patterns.md +0 -795
  299. package/.claude/skills/cloud-engineering/resources/well-architected-frameworks.md +0 -966
  300. package/.claude/skills/cybersecurity/SKILL.md +0 -409
  301. package/.claude/skills/cybersecurity/resources/security-architecture.md +0 -266
  302. package/.claude/skills/database-engineering/SKILL.md +0 -61
  303. package/.claude/skills/database-engineering/resources/backup-and-recovery.md +0 -72
  304. package/.claude/skills/database-engineering/resources/database-replication.md +0 -63
  305. package/.claude/skills/database-engineering/resources/postgresql-fundamentals.md +0 -70
  306. package/.claude/skills/database-engineering/resources/query-optimization.md +0 -68
  307. package/.claude/skills/devsecops/SKILL.md +0 -374
  308. package/.claude/skills/devsecops/resources/ci-cd-security.md +0 -204
  309. package/.claude/skills/devsecops/resources/compliance-automation.md +0 -530
  310. package/.claude/skills/devsecops/resources/compliance-frameworks.md +0 -2322
  311. package/.claude/skills/devsecops/resources/container-security.md +0 -915
  312. package/.claude/skills/devsecops/resources/cspm-integration.md +0 -1440
  313. package/.claude/skills/devsecops/resources/policy-enforcement.md +0 -619
  314. package/.claude/skills/devsecops/resources/secrets-management.md +0 -755
  315. package/.claude/skills/devsecops/resources/security-monitoring.md +0 -146
  316. package/.claude/skills/devsecops/resources/security-scanning.md +0 -887
  317. package/.claude/skills/devsecops/resources/security-testing.md +0 -203
  318. package/.claude/skills/devsecops/resources/supply-chain-security.md +0 -518
  319. package/.claude/skills/devsecops/resources/vulnerability-management.md +0 -481
  320. package/.claude/skills/devsecops/resources/zero-trust-architecture.md +0 -177
  321. package/.claude/skills/documentation-as-code/SKILL.md +0 -323
  322. package/.claude/skills/documentation-as-code/resources/api-documentation.md +0 -90
  323. package/.claude/skills/documentation-as-code/resources/changelog-management.md +0 -79
  324. package/.claude/skills/documentation-as-code/resources/diagram-generation.md +0 -44
  325. package/.claude/skills/documentation-as-code/resources/docs-as-code-workflow.md +0 -99
  326. package/.claude/skills/documentation-as-code/resources/documentation-automation.md +0 -68
  327. package/.claude/skills/documentation-as-code/resources/documentation-sites.md +0 -79
  328. package/.claude/skills/documentation-as-code/resources/markdown-best-practices.md +0 -162
  329. package/.claude/skills/documentation-as-code/resources/openapi-specification.md +0 -77
  330. package/.claude/skills/documentation-as-code/resources/readme-engineering.md +0 -60
  331. package/.claude/skills/documentation-as-code/resources/technical-writing-guide.md +0 -202
  332. package/.claude/skills/engineering-management/SKILL.md +0 -356
  333. package/.claude/skills/engineering-management/resources/career-ladders.md +0 -609
  334. package/.claude/skills/engineering-management/resources/hiring-and-assessment.md +0 -555
  335. package/.claude/skills/engineering-management/resources/one-on-one-guides.md +0 -609
  336. package/.claude/skills/engineering-management/resources/resource-planning.md +0 -557
  337. package/.claude/skills/engineering-management/resources/team-organization-patterns.md +0 -491
  338. package/.claude/skills/engineering-management/resources/technical-interviews.md +0 -474
  339. package/.claude/skills/engineering-operations-management/SKILL.md +0 -817
  340. package/.claude/skills/error-tracking/SKILL.md +0 -379
  341. package/.claude/skills/frontend-design/SKILL.md +0 -42
  342. package/.claude/skills/frontend-dev-guidelines/SKILL.md +0 -403
  343. package/.claude/skills/frontend-dev-guidelines/resources/common-patterns.md +0 -331
  344. package/.claude/skills/frontend-dev-guidelines/resources/complete-examples.md +0 -872
  345. package/.claude/skills/frontend-dev-guidelines/resources/component-patterns.md +0 -502
  346. package/.claude/skills/frontend-dev-guidelines/resources/data-fetching.md +0 -767
  347. package/.claude/skills/frontend-dev-guidelines/resources/file-organization.md +0 -502
  348. package/.claude/skills/frontend-dev-guidelines/resources/loading-and-error-states.md +0 -501
  349. package/.claude/skills/frontend-dev-guidelines/resources/performance.md +0 -406
  350. package/.claude/skills/frontend-dev-guidelines/resources/routing-guide.md +0 -364
  351. package/.claude/skills/frontend-dev-guidelines/resources/styling-guide.md +0 -428
  352. package/.claude/skills/frontend-dev-guidelines/resources/typescript-standards.md +0 -418
  353. package/.claude/skills/general-it-engineering/SKILL.md +0 -393
  354. package/.claude/skills/general-it-engineering/resources/asset-management.md +0 -712
  355. package/.claude/skills/general-it-engineering/resources/automation-orchestration.md +0 -817
  356. package/.claude/skills/general-it-engineering/resources/business-continuity.md +0 -786
  357. package/.claude/skills/general-it-engineering/resources/change-management.md +0 -715
  358. package/.claude/skills/general-it-engineering/resources/enterprise-monitoring.md +0 -729
  359. package/.claude/skills/general-it-engineering/resources/help-desk-operations.md +0 -738
  360. package/.claude/skills/general-it-engineering/resources/incident-service-management.md +0 -834
  361. package/.claude/skills/general-it-engineering/resources/it-governance.md +0 -753
  362. package/.claude/skills/general-it-engineering/resources/itil-framework.md +0 -503
  363. package/.claude/skills/general-it-engineering/resources/service-management.md +0 -669
  364. package/.claude/skills/infrastructure-architecture/SKILL.md +0 -328
  365. package/.claude/skills/infrastructure-architecture/resources/architecture-decision-records.md +0 -505
  366. package/.claude/skills/infrastructure-architecture/resources/architecture-patterns.md +0 -528
  367. package/.claude/skills/infrastructure-architecture/resources/capacity-planning.md +0 -453
  368. package/.claude/skills/infrastructure-architecture/resources/cleared-environment-architecture.md +0 -773
  369. package/.claude/skills/infrastructure-architecture/resources/cost-architecture.md +0 -499
  370. package/.claude/skills/infrastructure-architecture/resources/data-architecture.md +0 -501
  371. package/.claude/skills/infrastructure-architecture/resources/disaster-recovery.md +0 -535
  372. package/.claude/skills/infrastructure-architecture/resources/migration-architecture.md +0 -512
  373. package/.claude/skills/infrastructure-architecture/resources/multi-region-design.md +0 -608
  374. package/.claude/skills/infrastructure-architecture/resources/reference-architectures.md +0 -562
  375. package/.claude/skills/infrastructure-architecture/resources/security-architecture.md +0 -538
  376. package/.claude/skills/infrastructure-architecture/resources/system-design-principles.md +0 -489
  377. package/.claude/skills/infrastructure-architecture/resources/workload-classification.md +0 -1000
  378. package/.claude/skills/infrastructure-strategy/SKILL.md +0 -924
  379. package/.claude/skills/network-engineering/SKILL.md +0 -385
  380. package/.claude/skills/network-engineering/resources/dns-management.md +0 -738
  381. package/.claude/skills/network-engineering/resources/load-balancing.md +0 -820
  382. package/.claude/skills/network-engineering/resources/network-architecture.md +0 -546
  383. package/.claude/skills/network-engineering/resources/network-security.md +0 -921
  384. package/.claude/skills/network-engineering/resources/network-troubleshooting.md +0 -749
  385. package/.claude/skills/network-engineering/resources/routing-switching.md +0 -373
  386. package/.claude/skills/network-engineering/resources/sdn-networking.md +0 -695
  387. package/.claude/skills/network-engineering/resources/service-mesh-networking.md +0 -777
  388. package/.claude/skills/network-engineering/resources/tcp-ip-protocols.md +0 -444
  389. package/.claude/skills/network-engineering/resources/vpn-connectivity.md +0 -672
  390. package/.claude/skills/node-development/SKILL.md +0 -317
  391. package/.claude/skills/observability-engineering/SKILL.md +0 -101
  392. package/.claude/skills/observability-engineering/resources/apm-tools.md +0 -97
  393. package/.claude/skills/observability-engineering/resources/correlation-strategies.md +0 -87
  394. package/.claude/skills/observability-engineering/resources/distributed-tracing.md +0 -98
  395. package/.claude/skills/observability-engineering/resources/logs-aggregation.md +0 -118
  396. package/.claude/skills/observability-engineering/resources/observability-cost-optimization.md +0 -141
  397. package/.claude/skills/observability-engineering/resources/opentelemetry.md +0 -110
  398. package/.claude/skills/platform-engineering/SKILL.md +0 -555
  399. package/.claude/skills/platform-engineering/resources/architecture-overview.md +0 -600
  400. package/.claude/skills/platform-engineering/resources/container-orchestration.md +0 -916
  401. package/.claude/skills/platform-engineering/resources/cost-optimization.md +0 -634
  402. package/.claude/skills/platform-engineering/resources/developer-platforms.md +0 -670
  403. package/.claude/skills/platform-engineering/resources/gitops-automation.md +0 -650
  404. package/.claude/skills/platform-engineering/resources/infrastructure-as-code.md +0 -778
  405. package/.claude/skills/platform-engineering/resources/infrastructure-standards.md +0 -708
  406. package/.claude/skills/platform-engineering/resources/multi-tenancy.md +0 -602
  407. package/.claude/skills/platform-engineering/resources/platform-security.md +0 -711
  408. package/.claude/skills/platform-engineering/resources/resource-management.md +0 -592
  409. package/.claude/skills/platform-engineering/resources/service-mesh.md +0 -628
  410. package/.claude/skills/release-engineering/SKILL.md +0 -393
  411. package/.claude/skills/release-engineering/resources/artifact-management.md +0 -108
  412. package/.claude/skills/release-engineering/resources/build-optimization.md +0 -84
  413. package/.claude/skills/release-engineering/resources/ci-cd-pipelines.md +0 -411
  414. package/.claude/skills/release-engineering/resources/deployment-strategies.md +0 -197
  415. package/.claude/skills/release-engineering/resources/pipeline-security.md +0 -62
  416. package/.claude/skills/release-engineering/resources/progressive-delivery.md +0 -83
  417. package/.claude/skills/release-engineering/resources/release-automation.md +0 -68
  418. package/.claude/skills/release-engineering/resources/release-orchestration.md +0 -77
  419. package/.claude/skills/release-engineering/resources/rollback-strategies.md +0 -66
  420. package/.claude/skills/release-engineering/resources/versioning-strategies.md +0 -59
  421. package/.claude/skills/route-tester/SKILL.md +0 -392
  422. package/.claude/skills/skill-developer/ADVANCED.md +0 -197
  423. package/.claude/skills/skill-developer/HOOK_MECHANISMS.md +0 -306
  424. package/.claude/skills/skill-developer/PATTERNS_LIBRARY.md +0 -152
  425. package/.claude/skills/skill-developer/SKILL.md +0 -430
  426. package/.claude/skills/skill-developer/SKILL_RULES_REFERENCE.md +0 -315
  427. package/.claude/skills/skill-developer/TRIGGER_TYPES.md +0 -305
  428. package/.claude/skills/skill-developer/TROUBLESHOOTING.md +0 -514
  429. package/.claude/skills/skill-rules.json +0 -2989
  430. package/.claude/skills/sre/SKILL.md +0 -464
  431. package/.claude/skills/sre/resources/alerting-best-practices.md +0 -282
  432. package/.claude/skills/sre/resources/capacity-planning.md +0 -226
  433. package/.claude/skills/sre/resources/chaos-engineering.md +0 -193
  434. package/.claude/skills/sre/resources/disaster-recovery.md +0 -232
  435. package/.claude/skills/sre/resources/incident-management.md +0 -436
  436. package/.claude/skills/sre/resources/observability-stack.md +0 -240
  437. package/.claude/skills/sre/resources/on-call-runbooks.md +0 -167
  438. package/.claude/skills/sre/resources/performance-optimization.md +0 -108
  439. package/.claude/skills/sre/resources/reliability-patterns.md +0 -183
  440. package/.claude/skills/sre/resources/slo-sli-sla.md +0 -464
  441. package/.claude/skills/sre/resources/toil-reduction.md +0 -145
  442. package/.claude/skills/systems-engineering/SKILL.md +0 -648
  443. package/.claude/skills/systems-engineering/resources/automation-patterns.md +0 -771
  444. package/.claude/skills/systems-engineering/resources/configuration-management.md +0 -998
  445. package/.claude/skills/systems-engineering/resources/linux-administration.md +0 -672
  446. package/.claude/skills/systems-engineering/resources/networking-fundamentals.md +0 -982
  447. package/.claude/skills/systems-engineering/resources/performance-tuning.md +0 -871
  448. package/.claude/skills/systems-engineering/resources/powershell-scripting.md +0 -482
  449. package/.claude/skills/systems-engineering/resources/security-hardening.md +0 -739
  450. package/.claude/skills/systems-engineering/resources/shell-scripting.md +0 -915
  451. package/.claude/skills/systems-engineering/resources/storage-management.md +0 -628
  452. package/.claude/skills/systems-engineering/resources/system-monitoring.md +0 -787
  453. package/.claude/skills/systems-engineering/resources/troubleshooting-guide.md +0 -753
  454. package/.claude/skills/systems-engineering/resources/windows-administration.md +0 -738
  455. package/.claude/skills/technical-leadership/SKILL.md +0 -728
  456. package/backend/docs/SECRETS_DOCUMENTATION.md +0 -327
  457. package/backend/package-lock.json +0 -6801
  458. package/backend/src/core/node-registries/actions.js +0 -202
  459. package/backend/src/core/node-registries/arrays.js +0 -155
  460. package/backend/src/core/node-registries/bot.js +0 -23
  461. package/backend/src/core/node-registries/container.js +0 -162
  462. package/backend/src/core/node-registries/data.js +0 -290
  463. package/backend/src/core/node-registries/debug.js +0 -26
  464. package/backend/src/core/node-registries/events.js +0 -201
  465. package/backend/src/core/node-registries/flow.js +0 -139
  466. package/backend/src/core/node-registries/furnace.js +0 -143
  467. package/backend/src/core/node-registries/logic.js +0 -62
  468. package/backend/src/core/node-registries/math.js +0 -42
  469. package/backend/src/core/node-registries/navigation.js +0 -111
  470. package/backend/src/core/node-registries/objects.js +0 -98
  471. package/backend/src/core/node-registries/strings.js +0 -187
  472. package/backend/src/core/node-registries/time.js +0 -113
  473. package/backend/src/core/node-registries/type.js +0 -25
  474. package/backend/src/core/node-registries/users.js +0 -79
  475. package/frontend/dist/assets/index-BC-NbKXi.css +0 -32
  476. package/frontend/dist/assets/index-DqJXZMHY.js +0 -11266
@@ -1,966 +0,0 @@
1
- # Well-Architected Frameworks
2
-
3
- Comprehensive guide to AWS Well-Architected Framework, Azure Well-Architected Framework, and Google Cloud Architecture Framework.
4
-
5
- ## AWS Well-Architected Framework
6
-
7
- ### The Five Pillars
8
-
9
- ```
10
- ┌─────────────────────────────────────────────────────────────┐
11
- │ AWS Well-Architected Framework │
12
- ├──────────────────┬──────────────────┬───────────────────────┤
13
- │ Operational │ Security │ Reliability │
14
- │ Excellence │ │ │
15
- │ │ │ │
16
- │ • Automate ops │ • Identity │ • Test recovery │
17
- │ • Make changes │ • Traceability │ • Auto-recovery │
18
- │ • Learn & share │ • Defense depth │ • Scale horizontal │
19
- ├──────────────────┼──────────────────┼───────────────────────┤
20
- │ Performance │ Cost │ │
21
- │ Efficiency │ Optimization │ │
22
- │ │ │ │
23
- │ • Serverless │ • Consumption │ │
24
- │ • Experiment │ • Measure │ │
25
- │ • Go global │ • Attribute │ │
26
- └──────────────────┴──────────────────┴───────────────────────┘
27
- ```
28
-
29
- ### Pillar 1: Operational Excellence
30
-
31
- **Design Principles:**
32
- 1. Perform operations as code
33
- 2. Make frequent, small, reversible changes
34
- 3. Refine operations procedures frequently
35
- 4. Anticipate failure
36
- 5. Learn from all operational failures
37
-
38
- **Implementation Example:**
39
- ```hcl
40
- # Infrastructure as Code
41
- resource "aws_ecs_cluster" "main" {
42
- name = "production-cluster"
43
-
44
- configuration {
45
- execute_command_configuration {
46
- logging = "OVERRIDE"
47
-
48
- log_configuration {
49
- cloud_watch_log_group_name = aws_cloudwatch_log_group.ecs.name
50
- }
51
- }
52
- }
53
-
54
- # Enable Container Insights for observability
55
- setting {
56
- name = "containerInsights"
57
- value = "enabled"
58
- }
59
-
60
- tags = {
61
- Environment = "production"
62
- ManagedBy = "terraform"
63
- }
64
- }
65
-
66
- # CloudWatch Dashboards for operations
67
- resource "aws_cloudwatch_dashboard" "main" {
68
- dashboard_name = "operations-dashboard"
69
-
70
- dashboard_body = jsonencode({
71
- widgets = [
72
- {
73
- type = "metric"
74
- properties = {
75
- metrics = [
76
- ["AWS/ECS", "CPUUtilization", { stat = "Average" }],
77
- [".", "MemoryUtilization", { stat = "Average" }]
78
- ]
79
- period = 300
80
- stat = "Average"
81
- region = "us-east-1"
82
- title = "ECS Cluster Metrics"
83
- }
84
- },
85
- {
86
- type = "log"
87
- properties = {
88
- query = "SOURCE '/aws/ecs/production-cluster' | fields @timestamp, @message | sort @timestamp desc | limit 20"
89
- region = "us-east-1"
90
- title = "Recent Logs"
91
- }
92
- }
93
- ]
94
- })
95
- }
96
-
97
- # Automated remediation
98
- resource "aws_cloudwatch_event_rule" "instance_unhealthy" {
99
- name = "ecs-instance-unhealthy"
100
- description = "Trigger when ECS instance becomes unhealthy"
101
-
102
- event_pattern = jsonencode({
103
- source = ["aws.ecs"]
104
- detail-type = ["ECS Container Instance State Change"]
105
- detail = {
106
- status = ["DRAINING"]
107
- }
108
- })
109
- }
110
-
111
- resource "aws_cloudwatch_event_target" "remediate" {
112
- rule = aws_cloudwatch_event_rule.instance_unhealthy.name
113
- target_id = "RemediateLambda"
114
- arn = aws_lambda_function.remediate_instance.arn
115
- }
116
-
117
- # Runbook automation
118
- resource "aws_ssm_document" "deploy_app" {
119
- name = "DeployApplication"
120
- document_type = "Automation"
121
-
122
- content = jsonencode({
123
- schemaVersion = "0.3"
124
- description = "Deploys application with rollback capability"
125
- parameters = {
126
- ImageTag = {
127
- type = "String"
128
- description = "Docker image tag to deploy"
129
- }
130
- }
131
- mainSteps = [
132
- {
133
- name = "UpdateService"
134
- action = "aws:executeAwsApi"
135
- inputs = {
136
- Service = "ecs"
137
- Api = "UpdateService"
138
- cluster = "production-cluster"
139
- service = "app-service"
140
- forceNewDeployment = true
141
- taskDefinition = "app-task:{{ ImageTag }}"
142
- }
143
- },
144
- {
145
- name = "WaitForDeployment"
146
- action = "aws:waitForAwsResourceProperty"
147
- inputs = {
148
- Service = "ecs"
149
- Api = "DescribeServices"
150
- cluster = "production-cluster"
151
- services = ["app-service"]
152
- PropertySelector = "$.services[0].deployments[0].rolloutState"
153
- DesiredValues = ["COMPLETED"]
154
- }
155
- timeoutSeconds = 600
156
- }
157
- ]
158
- })
159
- }
160
- ```
161
-
162
- ### Pillar 2: Security
163
-
164
- **Design Principles:**
165
- 1. Implement a strong identity foundation
166
- 2. Enable traceability
167
- 3. Apply security at all layers
168
- 4. Automate security best practices
169
- 5. Protect data in transit and at rest
170
- 6. Keep people away from data
171
- 7. Prepare for security events
172
-
173
- **Implementation Example:**
174
- ```hcl
175
- # Identity foundation
176
- resource "aws_iam_role" "app" {
177
- name = "app-execution-role"
178
-
179
- assume_role_policy = jsonencode({
180
- Version = "2012-10-17"
181
- Statement = [
182
- {
183
- Effect = "Allow"
184
- Principal = {
185
- Service = "ecs-tasks.amazonaws.com"
186
- }
187
- Action = "sts:AssumeRole"
188
- Condition = {
189
- StringEquals = {
190
- "sts:ExternalId" = var.external_id
191
- }
192
- }
193
- }
194
- ]
195
- })
196
-
197
- # Restrict session duration
198
- max_session_duration = 3600
199
-
200
- tags = {
201
- Name = "app-execution-role"
202
- }
203
- }
204
-
205
- # Traceability - CloudTrail
206
- resource "aws_cloudtrail" "main" {
207
- name = "organization-trail"
208
- s3_bucket_name = aws_s3_bucket.cloudtrail.id
209
- include_global_service_events = true
210
- is_multi_region_trail = true
211
- enable_log_file_validation = true
212
-
213
- event_selector {
214
- read_write_type = "All"
215
- include_management_events = true
216
-
217
- data_resource {
218
- type = "AWS::S3::Object"
219
- values = ["arn:aws:s3:::sensitive-data-bucket/"]
220
- }
221
- }
222
-
223
- insight_selector {
224
- insight_type = "ApiCallRateInsight"
225
- }
226
-
227
- tags = {
228
- Name = "security-audit-trail"
229
- }
230
- }
231
-
232
- # Defense in depth - WAF
233
- resource "aws_wafv2_web_acl" "main" {
234
- name = "production-waf"
235
- scope = "REGIONAL"
236
-
237
- default_action {
238
- allow {}
239
- }
240
-
241
- # Rate limiting
242
- rule {
243
- name = "RateLimitRule"
244
- priority = 1
245
-
246
- action {
247
- block {}
248
- }
249
-
250
- statement {
251
- rate_based_statement {
252
- limit = 2000
253
- aggregate_key_type = "IP"
254
- }
255
- }
256
-
257
- visibility_config {
258
- cloudwatch_metrics_enabled = true
259
- metric_name = "RateLimit"
260
- sampled_requests_enabled = true
261
- }
262
- }
263
-
264
- # Managed rules
265
- rule {
266
- name = "AWSManagedRulesCommonRuleSet"
267
- priority = 2
268
-
269
- override_action {
270
- none {}
271
- }
272
-
273
- statement {
274
- managed_rule_group_statement {
275
- vendor_name = "AWS"
276
- name = "AWSManagedRulesCommonRuleSet"
277
- }
278
- }
279
-
280
- visibility_config {
281
- cloudwatch_metrics_enabled = true
282
- metric_name = "CommonRuleSet"
283
- sampled_requests_enabled = true
284
- }
285
- }
286
-
287
- visibility_config {
288
- cloudwatch_metrics_enabled = true
289
- metric_name = "ProductionWAF"
290
- sampled_requests_enabled = true
291
- }
292
- }
293
-
294
- # Data protection
295
- resource "aws_s3_bucket" "sensitive" {
296
- bucket = "sensitive-data-bucket"
297
-
298
- tags = {
299
- Classification = "confidential"
300
- }
301
- }
302
-
303
- resource "aws_s3_bucket_server_side_encryption_configuration" "sensitive" {
304
- bucket = aws_s3_bucket.sensitive.id
305
-
306
- rule {
307
- apply_server_side_encryption_by_default {
308
- sse_algorithm = "aws:kms"
309
- kms_master_key_id = aws_kms_key.sensitive.arn
310
- }
311
- bucket_key_enabled = true
312
- }
313
- }
314
-
315
- resource "aws_s3_bucket_public_access_block" "sensitive" {
316
- bucket = aws_s3_bucket.sensitive.id
317
-
318
- block_public_acls = true
319
- block_public_policy = true
320
- ignore_public_acls = true
321
- restrict_public_buckets = true
322
- }
323
-
324
- resource "aws_s3_bucket_versioning" "sensitive" {
325
- bucket = aws_s3_bucket.sensitive.id
326
-
327
- versioning_configuration {
328
- status = "Enabled"
329
- }
330
- }
331
-
332
- # Security event response
333
- resource "aws_guardduty_detector" "main" {
334
- enable = true
335
-
336
- datasources {
337
- s3_logs {
338
- enable = true
339
- }
340
- kubernetes {
341
- audit_logs {
342
- enable = true
343
- }
344
- }
345
- }
346
- }
347
-
348
- resource "aws_cloudwatch_event_rule" "guardduty_findings" {
349
- name = "guardduty-findings"
350
- description = "Trigger on GuardDuty findings"
351
-
352
- event_pattern = jsonencode({
353
- source = ["aws.guardduty"]
354
- detail-type = ["GuardDuty Finding"]
355
- detail = {
356
- severity = [7, 7.1, 7.2, 7.3, 7.4, 7.5, 7.6, 7.7, 7.8, 7.9, 8, 8.1, 8.2, 8.3, 8.4, 8.5, 8.6, 8.7, 8.8, 8.9]
357
- }
358
- })
359
- }
360
-
361
- resource "aws_cloudwatch_event_target" "sns" {
362
- rule = aws_cloudwatch_event_rule.guardduty_findings.name
363
- target_id = "SendToSNS"
364
- arn = aws_sns_topic.security_alerts.arn
365
- }
366
- ```
367
-
368
- ### Pillar 3: Reliability
369
-
370
- **Design Principles:**
371
- 1. Automatically recover from failure
372
- 2. Test recovery procedures
373
- 3. Scale horizontally to increase aggregate workload availability
374
- 4. Stop guessing capacity
375
- 5. Manage change in automation
376
-
377
- **Implementation Example:**
378
- ```hcl
379
- # Auto Scaling for reliability
380
- resource "aws_autoscaling_group" "app" {
381
- name = "app-asg"
382
- vpc_zone_identifier = aws_subnet.private_app[*].id
383
- target_group_arns = [aws_lb_target_group.app.arn]
384
- health_check_type = "ELB"
385
- health_check_grace_period = 300
386
-
387
- min_size = 3
388
- max_size = 12
389
- desired_capacity = 6
390
-
391
- launch_template {
392
- id = aws_launch_template.app.id
393
- version = "$Latest"
394
- }
395
-
396
- # Ensure instances in multiple AZs
397
- enabled_metrics = [
398
- "GroupMinSize",
399
- "GroupMaxSize",
400
- "GroupDesiredCapacity",
401
- "GroupInServiceInstances",
402
- "GroupTotalInstances"
403
- ]
404
-
405
- tag {
406
- key = "Name"
407
- value = "app-instance"
408
- propagate_at_launch = true
409
- }
410
-
411
- lifecycle {
412
- create_before_destroy = true
413
- }
414
- }
415
-
416
- # Target tracking scaling policy
417
- resource "aws_autoscaling_policy" "target_tracking" {
418
- name = "target-tracking-policy"
419
- autoscaling_group_name = aws_autoscaling_group.app.name
420
- policy_type = "TargetTrackingScaling"
421
-
422
- target_tracking_configuration {
423
- predefined_metric_specification {
424
- predefined_metric_type = "ASGAverageCPUUtilization"
425
- }
426
- target_value = 70.0
427
- }
428
- }
429
-
430
- # Multi-AZ RDS for data reliability
431
- resource "aws_db_instance" "main" {
432
- identifier = "production-database"
433
- engine = "postgres"
434
- instance_class = "db.r6g.xlarge"
435
-
436
- # High availability
437
- multi_az = true
438
- availability_zone = null # Let AWS choose for Multi-AZ
439
-
440
- # Backup and recovery
441
- backup_retention_period = 14
442
- backup_window = "03:00-04:00"
443
- copy_tags_to_snapshot = true
444
- delete_automated_backups = false
445
-
446
- # Automated failover
447
- auto_minor_version_upgrade = true
448
- maintenance_window = "sun:04:00-sun:05:00"
449
-
450
- # Point-in-time recovery
451
- enabled_cloudwatch_logs_exports = ["postgresql", "upgrade"]
452
-
453
- tags = {
454
- Name = "production-database"
455
- }
456
- }
457
-
458
- # Disaster recovery with cross-region replication
459
- resource "aws_s3_bucket_replication_configuration" "main" {
460
- bucket = aws_s3_bucket.source.id
461
- role = aws_iam_role.replication.arn
462
-
463
- rule {
464
- id = "disaster-recovery"
465
- status = "Enabled"
466
-
467
- filter {
468
- prefix = ""
469
- }
470
-
471
- destination {
472
- bucket = aws_s3_bucket.destination.arn
473
- storage_class = "STANDARD_IA"
474
-
475
- replication_time {
476
- status = "Enabled"
477
- time {
478
- minutes = 15
479
- }
480
- }
481
-
482
- metrics {
483
- status = "Enabled"
484
- event_threshold {
485
- minutes = 15
486
- }
487
- }
488
- }
489
- }
490
- }
491
-
492
- # Chaos engineering test
493
- resource "aws_fis_experiment_template" "az_outage" {
494
- description = "Simulate AZ failure"
495
- role_arn = aws_iam_role.fis.arn
496
-
497
- action {
498
- name = "az-outage"
499
- action_id = "aws:ec2:stop-instances"
500
-
501
- target {
502
- key = "Instances"
503
- value = "az-target"
504
- }
505
-
506
- parameter {
507
- key = "durationMinutes"
508
- value = "5"
509
- }
510
- }
511
-
512
- target {
513
- name = "az-target"
514
- resource_type = "aws:ec2:instance"
515
- selection_mode = "COUNT(1)"
516
-
517
- resource_tag {
518
- key = "AvailabilityZone"
519
- value = "us-east-1a"
520
- }
521
-
522
- resource_tag {
523
- key = "Environment"
524
- value = "staging"
525
- }
526
- }
527
-
528
- stop_condition {
529
- source = "aws:cloudwatch:alarm"
530
- value = aws_cloudwatch_metric_alarm.critical.arn
531
- }
532
-
533
- tags = {
534
- Name = "az-failure-test"
535
- }
536
- }
537
- ```
538
-
539
- ### Pillar 4: Performance Efficiency
540
-
541
- **Design Principles:**
542
- 1. Democratize advanced technologies
543
- 2. Go global in minutes
544
- 3. Use serverless architectures
545
- 4. Experiment more often
546
- 5. Consider mechanical sympathy
547
-
548
- **Implementation Example:**
549
- ```hcl
550
- # CloudFront for global distribution
551
- resource "aws_cloudfront_distribution" "main" {
552
- enabled = true
553
- is_ipv6_enabled = true
554
- http_version = "http2and3"
555
- price_class = "PriceClass_All"
556
-
557
- origin {
558
- domain_name = aws_s3_bucket.static.bucket_regional_domain_name
559
- origin_id = "S3-static"
560
-
561
- s3_origin_config {
562
- origin_access_identity = aws_cloudfront_origin_access_identity.main.cloudfront_access_identity_path
563
- }
564
- }
565
-
566
- # Edge caching
567
- default_cache_behavior {
568
- allowed_methods = ["GET", "HEAD", "OPTIONS"]
569
- cached_methods = ["GET", "HEAD"]
570
- target_origin_id = "S3-static"
571
- compress = true
572
- viewer_protocol_policy = "redirect-to-https"
573
-
574
- cache_policy_id = aws_cloudfront_cache_policy.optimized.id
575
-
576
- # Lambda@Edge for personalization
577
- lambda_function_association {
578
- event_type = "viewer-request"
579
- lambda_arn = aws_lambda_function.edge.qualified_arn
580
- include_body = false
581
- }
582
- }
583
-
584
- restrictions {
585
- geo_restriction {
586
- restriction_type = "none"
587
- }
588
- }
589
-
590
- viewer_certificate {
591
- acm_certificate_arn = aws_acm_certificate.main.arn
592
- ssl_support_method = "sni-only"
593
- minimum_protocol_version = "TLSv1.2_2021"
594
- }
595
- }
596
-
597
- # ElastiCache for performance
598
- resource "aws_elasticache_replication_group" "main" {
599
- replication_group_id = "app-cache"
600
- replication_group_description = "Application cache cluster"
601
- engine = "redis"
602
- engine_version = "7.0"
603
- node_type = "cache.r6g.large"
604
- num_cache_clusters = 3
605
- parameter_group_name = "default.redis7"
606
- port = 6379
607
-
608
- # Multi-AZ
609
- automatic_failover_enabled = true
610
- multi_az_enabled = true
611
-
612
- # Encryption
613
- at_rest_encryption_enabled = true
614
- transit_encryption_enabled = true
615
-
616
- # Backup
617
- snapshot_retention_limit = 5
618
- snapshot_window = "03:00-05:00"
619
-
620
- subnet_group_name = aws_elasticache_subnet_group.main.name
621
-
622
- tags = {
623
- Name = "app-cache-cluster"
624
- }
625
- }
626
-
627
- # DynamoDB with auto-scaling
628
- resource "aws_dynamodb_table" "sessions" {
629
- name = "user-sessions"
630
- billing_mode = "PAY_PER_REQUEST" # Automatic scaling
631
-
632
- hash_key = "sessionId"
633
- range_key = "timestamp"
634
-
635
- attribute {
636
- name = "sessionId"
637
- type = "S"
638
- }
639
-
640
- attribute {
641
- name = "timestamp"
642
- type = "N"
643
- }
644
-
645
- # Global table for multi-region
646
- replica {
647
- region_name = "us-west-2"
648
- }
649
-
650
- replica {
651
- region_name = "eu-west-1"
652
- }
653
-
654
- # TTL for automatic cleanup
655
- ttl {
656
- attribute_name = "expirationTime"
657
- enabled = true
658
- }
659
-
660
- point_in_time_recovery {
661
- enabled = true
662
- }
663
-
664
- tags = {
665
- Name = "user-sessions"
666
- }
667
- }
668
- ```
669
-
670
- ### Pillar 5: Cost Optimization
671
-
672
- **Design Principles:**
673
- 1. Implement cloud financial management
674
- 2. Adopt a consumption model
675
- 3. Measure overall efficiency
676
- 4. Stop spending on undifferentiated heavy lifting
677
- 5. Analyze and attribute expenditure
678
-
679
- **Implementation Example:**
680
- ```hcl
681
- # Cost allocation tags
682
- resource "aws_ec2_tag" "cost_center" {
683
- resource_id = aws_instance.app.id
684
- key = "CostCenter"
685
- value = "engineering"
686
- }
687
-
688
- # Savings Plans
689
- resource "aws_savingsplans_plan" "compute" {
690
- savings_plan_type = "ComputeSavingsPlan"
691
- term = "ONE_YEAR"
692
- payment_option = "PARTIAL_UPFRONT"
693
- commitment = "100.0" # $100/hour commitment
694
-
695
- tags = {
696
- Name = "compute-savings-plan"
697
- }
698
- }
699
-
700
- # S3 Intelligent-Tiering
701
- resource "aws_s3_bucket_intelligent_tiering_configuration" "main" {
702
- bucket = aws_s3_bucket.data.id
703
- name = "EntireBucket"
704
-
705
- tiering {
706
- access_tier = "DEEP_ARCHIVE_ACCESS"
707
- days = 180
708
- }
709
-
710
- tiering {
711
- access_tier = "ARCHIVE_ACCESS"
712
- days = 90
713
- }
714
- }
715
-
716
- # Spot instances for cost savings
717
- resource "aws_autoscaling_group" "spot" {
718
- name = "app-spot-asg"
719
- vpc_zone_identifier = aws_subnet.private_app[*].id
720
-
721
- min_size = 0
722
- max_size = 10
723
-
724
- mixed_instances_policy {
725
- instances_distribution {
726
- on_demand_base_capacity = 2
727
- on_demand_percentage_above_base_capacity = 20
728
- spot_allocation_strategy = "price-capacity-optimized"
729
- }
730
-
731
- launch_template {
732
- launch_template_specification {
733
- launch_template_id = aws_launch_template.app.id
734
- version = "$Latest"
735
- }
736
-
737
- override {
738
- instance_type = "m5.large"
739
- }
740
-
741
- override {
742
- instance_type = "m5a.large"
743
- }
744
-
745
- override {
746
- instance_type = "m6i.large"
747
- }
748
- }
749
- }
750
- }
751
-
752
- # Budget alerts
753
- resource "aws_budgets_budget" "monthly" {
754
- name = "monthly-budget"
755
- budget_type = "COST"
756
- limit_amount = "10000"
757
- limit_unit = "USD"
758
- time_period_start = "2024-01-01_00:00"
759
- time_unit = "MONTHLY"
760
-
761
- notification {
762
- comparison_operator = "GREATER_THAN"
763
- threshold = 80
764
- threshold_type = "PERCENTAGE"
765
- notification_type = "FORECASTED"
766
- subscriber_email_addresses = ["finance@example.com"]
767
- }
768
-
769
- notification {
770
- comparison_operator = "GREATER_THAN"
771
- threshold = 100
772
- threshold_type = "PERCENTAGE"
773
- notification_type = "ACTUAL"
774
- subscriber_email_addresses = ["finance@example.com", "engineering@example.com"]
775
- }
776
- }
777
- ```
778
-
779
- ## Azure Well-Architected Framework
780
-
781
- ### The Five Pillars (Azure)
782
-
783
- 1. **Cost Optimization**
784
- 2. **Operational Excellence**
785
- 3. **Performance Efficiency**
786
- 4. **Reliability**
787
- 5. **Security**
788
-
789
- **Example - Azure Cost Optimization:**
790
- ```hcl
791
- # Azure Reserved Instances
792
- resource "azurerm_reserved_capacity" "vm" {
793
- name = "reserved-vms"
794
- resource_group_name = azurerm_resource_group.main.name
795
- sku_name = "Standard_D2s_v3"
796
- term = "P1Y" # 1 year
797
- quantity = 10
798
- }
799
-
800
- # Auto-shutdown for dev environments
801
- resource "azurerm_dev_test_global_vm_shutdown_schedule" "main" {
802
- virtual_machine_id = azurerm_linux_virtual_machine.dev.id
803
- location = var.location
804
- enabled = true
805
-
806
- daily_recurrence_time = "1900"
807
- timezone = "Pacific Standard Time"
808
-
809
- notification_settings {
810
- enabled = true
811
- email = "devops@example.com"
812
- }
813
- }
814
-
815
- # Azure Advisor recommendations
816
- resource "azurerm_monitor_action_group" "cost" {
817
- name = "cost-optimization"
818
- resource_group_name = azurerm_resource_group.main.name
819
- short_name = "costopt"
820
-
821
- email_receiver {
822
- name = "finance"
823
- email_address = "finance@example.com"
824
- }
825
- }
826
- ```
827
-
828
- ## Google Cloud Architecture Framework
829
-
830
- ### The Five Categories (GCP)
831
-
832
- 1. **Operational Excellence**
833
- 2. **Security, Privacy, and Compliance**
834
- 3. **Reliability**
835
- 4. **Cost Optimization**
836
- 5. **Performance Optimization**
837
-
838
- **Example - GCP Performance:**
839
- ```hcl
840
- # Cloud CDN
841
- resource "google_compute_backend_bucket" "static" {
842
- name = "static-backend"
843
- bucket_name = google_storage_bucket.static.name
844
- enable_cdn = true
845
-
846
- cdn_policy {
847
- cache_mode = "CACHE_ALL_STATIC"
848
- default_ttl = 3600
849
- max_ttl = 86400
850
- client_ttl = 7200
851
- negative_caching = true
852
-
853
- cache_key_policy {
854
- include_host = true
855
- include_protocol = true
856
- include_query_string = true
857
- }
858
- }
859
- }
860
-
861
- # Memorystore for caching
862
- resource "google_redis_instance" "cache" {
863
- name = "app-cache"
864
- tier = "STANDARD_HA"
865
- memory_size_gb = 5
866
- region = var.region
867
- redis_version = "REDIS_7_0"
868
- display_name = "Application Cache"
869
-
870
- authorized_network = google_compute_network.main.id
871
-
872
- redis_configs = {
873
- maxmemory-policy = "allkeys-lru"
874
- }
875
-
876
- maintenance_policy {
877
- weekly_maintenance_window {
878
- day = "SUNDAY"
879
- start_time {
880
- hours = 3
881
- minutes = 0
882
- }
883
- }
884
- }
885
- }
886
- ```
887
-
888
- ## Well-Architected Review Process
889
-
890
- **Assessment Checklist:**
891
- ```yaml
892
- # well-architected-review.yaml
893
- operational_excellence:
894
- - question: "How do you manage and deploy changes?"
895
- best_practice: "Infrastructure as Code with CI/CD"
896
- current_state: "terraform + GitHub Actions"
897
- risk_level: "low"
898
-
899
- - question: "How do you monitor your workload?"
900
- best_practice: "Comprehensive observability"
901
- current_state: "CloudWatch + Prometheus"
902
- risk_level: "medium"
903
- improvement: "Add distributed tracing"
904
-
905
- security:
906
- - question: "How do you protect data at rest?"
907
- best_practice: "Encryption with customer-managed keys"
908
- current_state: "KMS encryption enabled"
909
- risk_level: "low"
910
-
911
- - question: "How do you manage identities?"
912
- best_practice: "Centralized identity with MFA"
913
- current_state: "IAM roles, MFA required"
914
- risk_level: "low"
915
-
916
- reliability:
917
- - question: "How do you design for failure?"
918
- best_practice: "Multi-AZ deployment"
919
- current_state: "Single AZ"
920
- risk_level: "high"
921
- improvement: "Deploy across 3 AZs"
922
-
923
- performance:
924
- - question: "How do you select your compute solution?"
925
- best_practice: "Right-sized for workload"
926
- current_state: "Over-provisioned"
927
- risk_level: "medium"
928
- improvement: "Implement auto-scaling"
929
-
930
- cost_optimization:
931
- - question: "How do you monitor costs?"
932
- best_practice: "Cost allocation tags + budgets"
933
- current_state: "Basic tagging"
934
- risk_level: "medium"
935
- improvement: "Implement comprehensive tagging strategy"
936
- ```
937
-
938
- ## Best Practices
939
-
940
- 1. **Regular Reviews:**
941
- - Quarterly architecture reviews
942
- - Use framework assessment tools
943
- - Document decisions and trade-offs
944
- - Track improvements over time
945
-
946
- 2. **Multi-Pillar Optimization:**
947
- - Balance across all pillars
948
- - Avoid over-optimizing one area
949
- - Consider trade-offs
950
- - Align with business goals
951
-
952
- 3. **Continuous Improvement:**
953
- - Implement feedback loops
954
- - Learn from incidents
955
- - Stay current with best practices
956
- - Automate compliance checks
957
-
958
- ## Anti-Patterns
959
-
960
- - Ignoring operational excellence for speed
961
- - Security as an afterthought
962
- - Single AZ deployments in production
963
- - No cost monitoring or optimization
964
- - Over-engineering for performance
965
- - Skipping well-architected reviews
966
- - Not documenting architectural decisions