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,444 +0,0 @@
1
- # TCP/IP Protocols
2
-
3
- Comprehensive guide to TCP/IP protocols covering OSI model, TCP/UDP, IP addressing, subnetting, CIDR, routing protocols, and packet flow analysis.
4
-
5
- ## OSI and TCP/IP Models
6
-
7
- ### Layer Comparison
8
-
9
- ```
10
- OSI Model TCP/IP Model Protocols/Examples
11
- ─────────────────────────────────────────────────────────
12
- 7. Application ┐
13
- 6. Presentation │→ Application HTTP, HTTPS, FTP, SSH,
14
- 5. Session ┘ DNS, SMTP, TLS
15
-
16
- 4. Transport → Transport TCP, UDP, SCTP
17
-
18
- 3. Network → Internet IP, ICMP, IGMP, IPsec
19
-
20
- 2. Data Link ┐
21
- 1. Physical ┘→ Network Access Ethernet, WiFi, ARP
22
- ```
23
-
24
- ## Transport Layer Protocols
25
-
26
- ### TCP (Transmission Control Protocol)
27
-
28
- **Characteristics:**
29
- - Connection-oriented
30
- - Reliable delivery (acknowledgments)
31
- - Ordered delivery
32
- - Flow control
33
- - Congestion control
34
-
35
- **Three-Way Handshake:**
36
- ```
37
- Client Server
38
- │ │
39
- │──── SYN ───────────→│ (Sequence = X)
40
- │ │
41
- │←─── SYN-ACK ───────│ (Sequence = Y, Ack = X+1)
42
- │ │
43
- │──── ACK ───────────→│ (Ack = Y+1)
44
- │ │
45
- │ Connection Open │
46
- ```
47
-
48
- **TCP Header:**
49
- ```
50
- 0 1 2 3
51
- 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
52
- ├───────────────────────────────────────────────────────────────┤
53
- │ Source Port │ Destination Port │
54
- ├───────────────────────────────────────────────────────────────┤
55
- │ Sequence Number │
56
- ├───────────────────────────────────────────────────────────────┤
57
- │ Acknowledgment Number │
58
- ├───────┬───┬───────┬───────────────────────────────────────────┤
59
- │Offset │Res│ Flags │ Window Size │
60
- ├───────┴───┴───────┼───────────────────────────────────────────┤
61
- │ Checksum │ Urgent Pointer │
62
- └───────────────────┴───────────────────────────────────────────┘
63
-
64
- Flags: URG, ACK, PSH, RST, SYN, FIN
65
- ```
66
-
67
- ### UDP (User Datagram Protocol)
68
-
69
- **Characteristics:**
70
- - Connectionless
71
- - No reliability guarantees
72
- - No ordering
73
- - Low overhead
74
- - Fast
75
-
76
- **UDP Header (8 bytes):**
77
- ```
78
- 0 7 8 15 16 23 24 31
79
- ├────────┼────────┼────────┼────────┤
80
- │ Source │ Dest │ Length │Checksum│
81
- │ Port │ Port │ │ │
82
- └────────┴────────┴────────┴────────┘
83
- ```
84
-
85
- **Use Cases:**
86
- - DNS queries
87
- - Video streaming (loss acceptable)
88
- - Gaming (low latency critical)
89
- - VoIP
90
- - IoT sensors
91
-
92
- ## Network Layer (IP)
93
-
94
- ### IPv4
95
-
96
- **IPv4 Address:**
97
- ```
98
- Format: 32 bits (4 octets)
99
- Example: 192.168.1.100
100
- Binary: 11000000.10101000.00000001.01100100
101
- ```
102
-
103
- **IPv4 Classes:**
104
- ```
105
- Class A: 0.0.0.0 - 127.255.255.255 (/8) 16M hosts
106
- Class B: 128.0.0.0 - 191.255.255.255 (/16) 65K hosts
107
- Class C: 192.0.0.0 - 223.255.255.255 (/24) 254 hosts
108
- Class D: 224.0.0.0 - 239.255.255.255 (Multicast)
109
- Class E: 240.0.0.0 - 255.255.255.255 (Reserved)
110
- ```
111
-
112
- **Private IP Ranges (RFC 1918):**
113
- ```
114
- 10.0.0.0 - 10.255.255.255 (10.0.0.0/8) 16M IPs
115
- 172.16.0.0 - 172.31.255.255 (172.16.0.0/12) 1M IPs
116
- 192.168.0.0 - 192.168.255.255 (192.168.0.0/16) 65K IPs
117
- ```
118
-
119
- ### IPv6
120
-
121
- **IPv6 Address:**
122
- ```
123
- Format: 128 bits (8 groups of 4 hex digits)
124
- Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
125
-
126
- Compressed: 2001:db8:85a3::8a2e:370:7334
127
- (Leading zeros omitted, :: replaces consecutive zeros)
128
- ```
129
-
130
- **IPv6 Types:**
131
- ```
132
- Global Unicast: 2000::/3 (Internet routable)
133
- Link-Local: fe80::/10 (Local network only)
134
- Unique Local: fc00::/7 (Private, like RFC 1918)
135
- Multicast: ff00::/8
136
- Loopback: ::1/128
137
- Unspecified: ::/128
138
- ```
139
-
140
- ## Subnetting and CIDR
141
-
142
- ### Subnet Mask
143
-
144
- ```
145
- Subnet Mask: 255.255.255.0 = /24
146
- Binary: 11111111.11111111.11111111.00000000
147
-
148
- Network portion: First 24 bits
149
- Host portion: Last 8 bits
150
- Total hosts: 2^8 - 2 = 254 usable
151
- ```
152
-
153
- ### CIDR Notation
154
-
155
- ```
156
- CIDR Subnet Mask Hosts Subnet Count
157
- /8 255.0.0.0 16,777,214 1
158
- /16 255.255.0.0 65,534 256
159
- /24 255.255.255.0 254 65,536
160
- /25 255.255.255.128 126 131,072
161
- /26 255.255.255.192 62 262,144
162
- /27 255.255.255.224 30 524,288
163
- /28 255.255.255.240 14 1,048,576
164
- /29 255.255.255.248 6 2,097,152
165
- /30 255.255.255.252 2 4,194,304
166
- /32 255.255.255.255 1 (host) -
167
- ```
168
-
169
- ### Subnetting Example
170
-
171
- **Subnet 192.168.1.0/24 into 4 equal subnets:**
172
- ```
173
- Original: 192.168.1.0/24 (254 hosts)
174
- New mask: /26 (2 borrowed bits, 2^2 = 4 subnets)
175
-
176
- Subnet 1: 192.168.1.0/26 (192.168.1.1 - 192.168.1.62)
177
- Subnet 2: 192.168.1.64/26 (192.168.1.65 - 192.168.1.126)
178
- Subnet 3: 192.168.1.128/26 (192.168.1.129 - 192.168.1.190)
179
- Subnet 4: 192.168.1.192/26 (192.168.1.193 - 192.168.1.254)
180
-
181
- Each subnet: 64 IPs (62 usable)
182
- ```
183
-
184
- ### VLSM (Variable Length Subnet Mask)
185
-
186
- ```
187
- Network: 192.168.1.0/24
188
-
189
- Requirements:
190
- - Sales: 100 hosts → /25 (126 hosts)
191
- - IT: 50 hosts → /26 (62 hosts)
192
- - HR: 20 hosts → /27 (30 hosts)
193
- - Mgmt: 10 hosts → /28 (14 hosts)
194
-
195
- Allocation:
196
- Sales: 192.168.1.0/25 (192.168.1.0 - 192.168.1.127)
197
- IT: 192.168.1.128/26 (192.168.1.128 - 192.168.1.191)
198
- HR: 192.168.1.192/27 (192.168.1.192 - 192.168.1.223)
199
- Mgmt: 192.168.1.224/28 (192.168.1.224 - 192.168.1.239)
200
- ```
201
-
202
- ## ICMP (Internet Control Message Protocol)
203
-
204
- ### Common ICMP Types
205
-
206
- ```
207
- Type 0: Echo Reply (Ping response)
208
- Type 3: Destination Unreachable
209
- Type 5: Redirect
210
- Type 8: Echo Request (Ping)
211
- Type 11: Time Exceeded (TTL=0)
212
- Type 30: Traceroute
213
- ```
214
-
215
- ### Ping Example
216
-
217
- ```bash
218
- $ ping -c 4 8.8.8.8
219
-
220
- PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.
221
- 64 bytes from 8.8.8.8: icmp_seq=1 ttl=117 time=12.3 ms
222
- 64 bytes from 8.8.8.8: icmp_seq=2 ttl=117 time=11.8 ms
223
- 64 bytes from 8.8.8.8: icmp_seq=3 ttl=117 time=12.1 ms
224
- 64 bytes from 8.8.8.8: icmp_seq=4 ttl=117 time=12.0 ms
225
-
226
- --- 8.8.8.8 ping statistics ---
227
- 4 packets transmitted, 4 received, 0% packet loss, time 3004ms
228
- rtt min/avg/max/mdev = 11.849/12.050/12.301/0.174 ms
229
- ```
230
-
231
- ### Traceroute
232
-
233
- ```bash
234
- $ traceroute google.com
235
-
236
- 1 gateway (192.168.1.1) 1.234 ms
237
- 2 10.0.0.1 (10.0.0.1) 8.456 ms
238
- 3 isp-router.net (203.0.113.1) 12.789 ms
239
- 4 * * * (timeout)
240
- 5 google-peer.net (172.217.1.1) 15.234 ms
241
- 6 google.com (142.250.185.46) 16.123 ms
242
- ```
243
-
244
- ## Routing Protocols
245
-
246
- ### Static Routing
247
-
248
- ```bash
249
- # Linux
250
- ip route add 10.0.2.0/24 via 10.0.1.1
251
-
252
- # Cisco
253
- ip route 10.0.2.0 255.255.255.0 10.0.1.1
254
-
255
- # Default route
256
- ip route add default via 192.168.1.1
257
- ```
258
-
259
- ### Dynamic Routing Protocols
260
-
261
- **RIP (Routing Information Protocol):**
262
- - Distance vector protocol
263
- - Metric: Hop count (max 15)
264
- - Updates every 30 seconds
265
- - Legacy, rarely used
266
-
267
- **OSPF (Open Shortest Path First):**
268
- - Link-state protocol
269
- - Metric: Cost (based on bandwidth)
270
- - Fast convergence
271
- - Scalable (areas)
272
- - Widely used in enterprises
273
-
274
- **BGP (Border Gateway Protocol):**
275
- - Path vector protocol
276
- - Metric: AS path, policies
277
- - Internet routing protocol
278
- - Scalable to internet size
279
-
280
- ### OSPF Areas
281
-
282
- ```
283
- ┌────────────────────────────────────┐
284
- │ Backbone Area 0 │
285
- │ (All routers) │
286
- └──────┬─────────┬──────────┬────────┘
287
- │ │ │
288
- ┌───▼───┐ ┌───▼───┐ ┌───▼───┐
289
- │Area 1 │ │Area 2 │ │Area 3 │
290
- │ │ │ │ │ │
291
- └───────┘ └───────┘ └───────┘
292
- ```
293
-
294
- ## Packet Flow Analysis
295
-
296
- ### TCP Packet Capture
297
-
298
- ```bash
299
- # Capture with tcpdump
300
- sudo tcpdump -i eth0 -nn port 80
301
-
302
- # Sample output
303
- 12:34:56.789012 IP 192.168.1.100.51234 > 93.184.216.34.80: Flags [S], seq 123456, win 65535
304
- 12:34:56.801234 IP 93.184.216.34.80 > 192.168.1.100.51234: Flags [S.], seq 789012, ack 123457, win 65535
305
- 12:34:56.801456 IP 192.168.1.100.51234 > 93.184.216.34.80: Flags [.], ack 789013, win 65535
306
- 12:34:56.801678 IP 192.168.1.100.51234 > 93.184.216.34.80: Flags [P.], seq 123457:123557
307
- ```
308
-
309
- ### HTTP Request Flow
310
-
311
- ```
312
- 1. DNS Resolution
313
- Client → DNS Server: "What is example.com?"
314
- DNS Server → Client: "93.184.216.34"
315
-
316
- 2. TCP Handshake
317
- Client → Server: SYN
318
- Server → Client: SYN-ACK
319
- Client → Server: ACK
320
-
321
- 3. HTTP Request
322
- Client → Server: GET / HTTP/1.1
323
- Host: example.com
324
-
325
- 4. HTTP Response
326
- Server → Client: HTTP/1.1 200 OK
327
- Content-Type: text/html
328
- <html>...</html>
329
-
330
- 5. Connection Close
331
- Client → Server: FIN
332
- Server → Client: ACK
333
- Server → Client: FIN
334
- Client → Server: ACK
335
- ```
336
-
337
- ## Network Address Translation (NAT)
338
-
339
- ### NAT Types
340
-
341
- **SNAT (Source NAT):**
342
- ```
343
- Internal → External
344
- 10.0.1.5:12345 → 203.0.113.1:54321
345
- (Private IP → Public IP)
346
- ```
347
-
348
- **DNAT (Destination NAT / Port Forwarding):**
349
- ```
350
- External → Internal
351
- 203.0.113.1:80 → 10.0.1.10:8080
352
- (Public → Private web server)
353
- ```
354
-
355
- **PAT (Port Address Translation):**
356
- ```
357
- Multiple internal hosts share one public IP
358
- 10.0.1.5:12345 → 203.0.113.1:54321
359
- 10.0.1.6:12346 → 203.0.113.1:54322
360
- 10.0.1.7:12347 → 203.0.113.1:54323
361
- ```
362
-
363
- ## Quality of Service (QoS)
364
-
365
- ### DSCP (Differentiated Services Code Point)
366
-
367
- ```
368
- ToS Field in IP Header (8 bits)
369
- ┌──────────┬────┐
370
- │ DSCP (6) │ECN │
371
- └──────────┴────┘
372
-
373
- DSCP Values:
374
- EF (Expedited Forwarding): 46 - VoIP, real-time
375
- AF41 (Assured Forwarding): 34 - Video
376
- AF31: 26 - High-priority data
377
- BE (Best Effort): 0 - Default
378
- ```
379
-
380
- ### Traffic Shaping
381
-
382
- ```bash
383
- # Linux tc (traffic control)
384
- tc qdisc add dev eth0 root tbf rate 1mbit burst 32kbit latency 400ms
385
-
386
- # Prioritize SSH traffic
387
- tc filter add dev eth0 protocol ip parent 1:0 prio 1 u32 \
388
- match ip dport 22 0xffff flowid 1:1
389
- ```
390
-
391
- ## Protocol Encapsulation
392
-
393
- ### Packet Structure
394
-
395
- ```
396
- ┌─────────────────────────────────────┐
397
- │ Ethernet Header (14 bytes) │
398
- ├─────────────────────────────────────┤
399
- │ IP Header (20+ bytes) │
400
- ├─────────────────────────────────────┤
401
- │ TCP Header (20+ bytes) │
402
- ├─────────────────────────────────────┤
403
- │ Application Data │
404
- └─────────────────────────────────────┘
405
-
406
- MTU: 1500 bytes (Ethernet)
407
- MSS: 1460 bytes (MTU - IP - TCP headers)
408
- ```
409
-
410
- ### Tunneling Protocols
411
-
412
- **GRE (Generic Routing Encapsulation):**
413
- ```
414
- ┌──────────┐
415
- │ Outer IP │
416
- ├──────────┤
417
- │ GRE │
418
- ├──────────┤
419
- │ Inner IP │
420
- ├──────────┤
421
- │ Data │
422
- └──────────┘
423
- ```
424
-
425
- **IPsec:**
426
- ```
427
- Transport Mode:
428
- ┌──────────┬─────────┬──────────┐
429
- │ IP Header│ESP/AH │ Payload │
430
- └──────────┴─────────┴──────────┘
431
-
432
- Tunnel Mode:
433
- ┌──────────┬────────┬──────────┬──────────┐
434
- │ New IP │ESP/AH │ Orig IP │ Payload │
435
- └──────────┴────────┴──────────┴──────────┘
436
- ```
437
-
438
- ---
439
-
440
- **Related Topics:**
441
- - See [network-architecture.md](network-architecture.md) for network design
442
- - See [routing-switching.md](routing-switching.md) for routing protocols
443
- - See [network-troubleshooting.md](network-troubleshooting.md) for packet analysis
444
- - See [vpn-connectivity.md](vpn-connectivity.md) for VPN protocols