@mytechtoday/augment-extensions 0.7.0 → 1.2.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 (483) hide show
  1. package/AGENTS.md +265 -232
  2. package/README.md +956 -771
  3. package/augment-extensions/coding-standards/bash/README.md +196 -196
  4. package/augment-extensions/coding-standards/bash/module.json +163 -163
  5. package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -336
  6. package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -289
  7. package/augment-extensions/coding-standards/css/README.md +40 -40
  8. package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -550
  9. package/augment-extensions/coding-standards/css/module.json +44 -44
  10. package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -448
  11. package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -492
  12. package/augment-extensions/coding-standards/html/README.md +40 -40
  13. package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -267
  14. package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -505
  15. package/augment-extensions/coding-standards/html/module.json +44 -44
  16. package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -349
  17. package/augment-extensions/coding-standards/html-css-js/README.md +194 -194
  18. package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -487
  19. package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -550
  20. package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -667
  21. package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -267
  22. package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -612
  23. package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -505
  24. package/augment-extensions/coding-standards/html-css-js/module.json +48 -48
  25. package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -515
  26. package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -448
  27. package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -492
  28. package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -439
  29. package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -349
  30. package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -486
  31. package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -463
  32. package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -543
  33. package/augment-extensions/coding-standards/js/README.md +46 -46
  34. package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -487
  35. package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -667
  36. package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -612
  37. package/augment-extensions/coding-standards/js/module.json +49 -49
  38. package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -515
  39. package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -439
  40. package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -486
  41. package/augment-extensions/coding-standards/js/rules/performance.md +463 -463
  42. package/augment-extensions/coding-standards/js/rules/tooling.md +543 -543
  43. package/augment-extensions/coding-standards/php/README.md +248 -248
  44. package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -204
  45. package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -206
  46. package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -234
  47. package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -211
  48. package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -215
  49. package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -189
  50. package/augment-extensions/coding-standards/php/module.json +166 -166
  51. package/augment-extensions/coding-standards/php/rules/api-development.md +480 -480
  52. package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -332
  53. package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -472
  54. package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -561
  55. package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -402
  56. package/augment-extensions/coding-standards/php/rules/documentation.md +425 -425
  57. package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -627
  58. package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -336
  59. package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -677
  60. package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -279
  61. package/augment-extensions/coding-standards/php/rules/performance.md +392 -392
  62. package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -186
  63. package/augment-extensions/coding-standards/php/rules/security.md +358 -358
  64. package/augment-extensions/coding-standards/php/rules/testing.md +403 -403
  65. package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -331
  66. package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -426
  67. package/augment-extensions/coding-standards/powershell/README.md +154 -154
  68. package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -272
  69. package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -173
  70. package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -243
  71. package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -297
  72. package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -224
  73. package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -340
  74. package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -255
  75. package/augment-extensions/coding-standards/powershell/module.json +165 -165
  76. package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -439
  77. package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -240
  78. package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -384
  79. package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -383
  80. package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -482
  81. package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -296
  82. package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -314
  83. package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -466
  84. package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -244
  85. package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -266
  86. package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -209
  87. package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -314
  88. package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -268
  89. package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -197
  90. package/augment-extensions/coding-standards/python/README.md +48 -48
  91. package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -373
  92. package/augment-extensions/coding-standards/python/module.json +30 -30
  93. package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -884
  94. package/augment-extensions/coding-standards/python/rules/best-practices.md +232 -232
  95. package/augment-extensions/coding-standards/python/rules/code-organization.md +220 -220
  96. package/augment-extensions/coding-standards/python/rules/documentation.md +831 -831
  97. package/augment-extensions/coding-standards/python/rules/error-handling.md +1008 -1008
  98. package/augment-extensions/coding-standards/python/rules/naming-conventions.md +172 -172
  99. package/augment-extensions/coding-standards/python/rules/testing.md +409 -409
  100. package/augment-extensions/coding-standards/python/rules/tooling.md +446 -446
  101. package/augment-extensions/coding-standards/python/rules/type-hints.md +253 -253
  102. package/augment-extensions/coding-standards/react/README.md +45 -45
  103. package/augment-extensions/coding-standards/react/module.json +27 -27
  104. package/augment-extensions/coding-standards/react/rules/component-patterns.md +214 -214
  105. package/augment-extensions/coding-standards/react/rules/hooks-best-practices.md +235 -235
  106. package/augment-extensions/coding-standards/react/rules/performance.md +300 -300
  107. package/augment-extensions/coding-standards/react/rules/state-management.md +265 -265
  108. package/augment-extensions/coding-standards/react/rules/typescript-react.md +271 -271
  109. package/augment-extensions/coding-standards/typescript/README.md +45 -45
  110. package/augment-extensions/coding-standards/typescript/module.json +27 -27
  111. package/augment-extensions/coding-standards/typescript/rules/naming-conventions.md +225 -225
  112. package/augment-extensions/collections/html-css-js/README.md +82 -82
  113. package/augment-extensions/collections/html-css-js/collection.json +41 -41
  114. package/augment-extensions/domain-rules/api-design/README.md +41 -41
  115. package/augment-extensions/domain-rules/api-design/module.json +27 -27
  116. package/augment-extensions/domain-rules/api-design/rules/authentication.md +263 -263
  117. package/augment-extensions/domain-rules/api-design/rules/documentation.md +395 -395
  118. package/augment-extensions/domain-rules/api-design/rules/error-handling.md +290 -290
  119. package/augment-extensions/domain-rules/api-design/rules/graphql-api.md +313 -313
  120. package/augment-extensions/domain-rules/api-design/rules/rest-api.md +214 -214
  121. package/augment-extensions/domain-rules/api-design/rules/versioning.md +268 -268
  122. package/augment-extensions/domain-rules/database/README.md +161 -161
  123. package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -793
  124. package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -1132
  125. package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -868
  126. package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -805
  127. package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -621
  128. package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -965
  129. package/augment-extensions/domain-rules/database/module.json +28 -28
  130. package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -624
  131. package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -588
  132. package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -856
  133. package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -778
  134. package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -963
  135. package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -1076
  136. package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -697
  137. package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -671
  138. package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -607
  139. package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -907
  140. package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -783
  141. package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -980
  142. package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -485
  143. package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -521
  144. package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -858
  145. package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -934
  146. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -23
  147. package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -26
  148. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -23
  149. package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -26
  150. package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -23
  151. package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -26
  152. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -23
  153. package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -26
  154. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -23
  155. package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -26
  156. package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -27
  157. package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -26
  158. package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -23
  159. package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -26
  160. package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -23
  161. package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -26
  162. package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -23
  163. package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -26
  164. package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -23
  165. package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -26
  166. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -23
  167. package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -26
  168. package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -23
  169. package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -26
  170. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -23
  171. package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -26
  172. package/augment-extensions/domain-rules/mcp/README.md +150 -150
  173. package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -522
  174. package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -520
  175. package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -570
  176. package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -427
  177. package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -435
  178. package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -502
  179. package/augment-extensions/domain-rules/mcp/module.json +49 -49
  180. package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -595
  181. package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -345
  182. package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -687
  183. package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -636
  184. package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -484
  185. package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -360
  186. package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -393
  187. package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -194
  188. package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -625
  189. package/augment-extensions/domain-rules/security/README.md +41 -41
  190. package/augment-extensions/domain-rules/security/module.json +28 -28
  191. package/augment-extensions/domain-rules/security/rules/authentication-security.md +361 -361
  192. package/augment-extensions/domain-rules/security/rules/encryption.md +208 -208
  193. package/augment-extensions/domain-rules/security/rules/input-validation.md +294 -294
  194. package/augment-extensions/domain-rules/security/rules/owasp-top-10.md +339 -339
  195. package/augment-extensions/domain-rules/security/rules/secure-coding.md +293 -293
  196. package/augment-extensions/domain-rules/security/rules/web-security.md +268 -268
  197. package/augment-extensions/domain-rules/seo-sales-marketing/ANNOUNCEMENT.md +143 -0
  198. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/README.md +140 -136
  199. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/SCHEMA-VALIDATION-REPORT.md +216 -216
  200. package/augment-extensions/domain-rules/seo-sales-marketing/TEST-VALIDATION.md +129 -0
  201. package/augment-extensions/domain-rules/seo-sales-marketing/USAGE-GUIDES.md +254 -0
  202. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/brand-kit-example.yaml +292 -292
  203. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/campaign-brief-example.yaml +389 -389
  204. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/content-calendar-example.yaml +643 -643
  205. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/email-newsletter-example.md +376 -376
  206. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/landing-page-example.md +934 -934
  207. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/ppc-ad-copy-example.md +301 -301
  208. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/seo-blog-post-example.md +347 -347
  209. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/social-media-campaign-example.md +606 -606
  210. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/module.json +50 -50
  211. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/affiliate-influencer-marketing.md +593 -593
  212. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/asset-management.md +418 -418
  213. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/brand-consistency.md +210 -210
  214. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/content-marketing.md +337 -337
  215. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/conversion-optimization.md +455 -455
  216. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/direct-sales.md +499 -499
  217. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/email-marketing.md +439 -439
  218. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/legal-compliance.md +227 -227
  219. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/ppc-advertising.md +569 -569
  220. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/seo-optimization.md +470 -470
  221. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/social-media-marketing.md +414 -414
  222. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/universal-marketing.md +177 -177
  223. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/asset-inventory.schema.json +247 -247
  224. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/brand-kit.schema.json +326 -326
  225. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/campaign-brief.schema.json +342 -342
  226. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/color-palette.schema.json +223 -223
  227. package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/content-template.schema.json +383 -383
  228. package/augment-extensions/domain-rules/wordpress/README.md +163 -163
  229. package/augment-extensions/domain-rules/wordpress/module.json +32 -32
  230. package/augment-extensions/domain-rules/wordpress/rules/coding-standards.md +617 -617
  231. package/augment-extensions/domain-rules/wordpress/rules/directory-structure.md +270 -270
  232. package/augment-extensions/domain-rules/wordpress/rules/file-patterns.md +423 -423
  233. package/augment-extensions/domain-rules/wordpress/rules/gutenberg-blocks.md +493 -493
  234. package/augment-extensions/domain-rules/wordpress/rules/performance.md +568 -568
  235. package/augment-extensions/domain-rules/wordpress/rules/plugin-development.md +510 -510
  236. package/augment-extensions/domain-rules/wordpress/rules/project-detection.md +251 -251
  237. package/augment-extensions/domain-rules/wordpress/rules/rest-api.md +501 -501
  238. package/augment-extensions/domain-rules/wordpress/rules/security.md +564 -564
  239. package/augment-extensions/domain-rules/wordpress/rules/theme-development.md +388 -388
  240. package/augment-extensions/domain-rules/wordpress/rules/woocommerce.md +441 -441
  241. package/augment-extensions/domain-rules/wordpress-plugin/README.md +139 -139
  242. package/augment-extensions/domain-rules/wordpress-plugin/examples/ajax-plugin.md +1599 -1599
  243. package/augment-extensions/domain-rules/wordpress-plugin/examples/custom-post-type-plugin.md +1727 -1727
  244. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block-plugin.md +428 -428
  245. package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block.md +422 -422
  246. package/augment-extensions/domain-rules/wordpress-plugin/examples/mvc-plugin.md +1623 -1623
  247. package/augment-extensions/domain-rules/wordpress-plugin/examples/object-oriented-plugin.md +1343 -1343
  248. package/augment-extensions/domain-rules/wordpress-plugin/examples/rest-endpoint.md +734 -734
  249. package/augment-extensions/domain-rules/wordpress-plugin/examples/settings-page-plugin.md +1350 -1350
  250. package/augment-extensions/domain-rules/wordpress-plugin/examples/simple-procedural-plugin.md +503 -503
  251. package/augment-extensions/domain-rules/wordpress-plugin/examples/singleton-plugin.md +971 -971
  252. package/augment-extensions/domain-rules/wordpress-plugin/module.json +53 -53
  253. package/augment-extensions/domain-rules/wordpress-plugin/rules/activation-hooks.md +770 -770
  254. package/augment-extensions/domain-rules/wordpress-plugin/rules/admin-interface.md +874 -874
  255. package/augment-extensions/domain-rules/wordpress-plugin/rules/ajax-handlers.md +629 -629
  256. package/augment-extensions/domain-rules/wordpress-plugin/rules/asset-management.md +559 -559
  257. package/augment-extensions/domain-rules/wordpress-plugin/rules/context-providers.md +709 -709
  258. package/augment-extensions/domain-rules/wordpress-plugin/rules/cron-jobs.md +736 -736
  259. package/augment-extensions/domain-rules/wordpress-plugin/rules/database-management.md +1057 -1057
  260. package/augment-extensions/domain-rules/wordpress-plugin/rules/documentation-standards.md +463 -463
  261. package/augment-extensions/domain-rules/wordpress-plugin/rules/frontend-functionality.md +478 -478
  262. package/augment-extensions/domain-rules/wordpress-plugin/rules/gutenberg-blocks.md +818 -818
  263. package/augment-extensions/domain-rules/wordpress-plugin/rules/internationalization.md +416 -416
  264. package/augment-extensions/domain-rules/wordpress-plugin/rules/migration.md +667 -667
  265. package/augment-extensions/domain-rules/wordpress-plugin/rules/performance-optimization.md +878 -878
  266. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-architecture.md +693 -693
  267. package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-structure.md +352 -352
  268. package/augment-extensions/domain-rules/wordpress-plugin/rules/rest-api.md +818 -818
  269. package/augment-extensions/domain-rules/wordpress-plugin/rules/scaffolding-workflow.md +624 -624
  270. package/augment-extensions/domain-rules/wordpress-plugin/rules/security-best-practices.md +866 -866
  271. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing-patterns.md +1165 -1165
  272. package/augment-extensions/domain-rules/wordpress-plugin/rules/testing.md +414 -414
  273. package/augment-extensions/domain-rules/wordpress-plugin/rules/vscode-integration.md +751 -751
  274. package/augment-extensions/domain-rules/wordpress-plugin/rules/woocommerce-integration.md +949 -949
  275. package/augment-extensions/domain-rules/wordpress-plugin/rules/wordpress-org-submission.md +458 -458
  276. package/augment-extensions/examples/design-patterns/README.md +37 -37
  277. package/augment-extensions/examples/design-patterns/examples/behavioral-patterns.md +370 -370
  278. package/augment-extensions/examples/design-patterns/examples/creational-patterns.md +250 -250
  279. package/augment-extensions/examples/design-patterns/examples/structural-patterns.md +264 -264
  280. package/augment-extensions/examples/design-patterns/module.json +27 -27
  281. package/augment-extensions/examples/gutenberg-block-plugin/README.md +101 -101
  282. package/augment-extensions/examples/gutenberg-block-plugin/examples/testimonial-block.md +428 -428
  283. package/augment-extensions/examples/gutenberg-block-plugin/module.json +40 -40
  284. package/augment-extensions/examples/rest-api-plugin/README.md +98 -98
  285. package/augment-extensions/examples/rest-api-plugin/examples/task-manager-api.md +1299 -1299
  286. package/augment-extensions/examples/rest-api-plugin/module.json +40 -40
  287. package/augment-extensions/examples/woocommerce-extension/README.md +98 -98
  288. package/augment-extensions/examples/woocommerce-extension/examples/product-customizer.md +763 -763
  289. package/augment-extensions/examples/woocommerce-extension/module.json +40 -40
  290. package/augment-extensions/workflows/beads/README.md +135 -135
  291. package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +278 -278
  292. package/augment-extensions/workflows/beads/module.json +55 -55
  293. package/augment-extensions/workflows/beads/rules/best-practices.md +398 -398
  294. package/augment-extensions/workflows/beads/rules/file-format.md +327 -327
  295. package/augment-extensions/workflows/beads/rules/manual-setup.md +315 -315
  296. package/augment-extensions/workflows/beads/rules/workflow.md +326 -326
  297. package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -145
  298. package/augment-extensions/workflows/beads-integration/README.md +143 -143
  299. package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -32
  300. package/augment-extensions/workflows/beads-integration/config/schema.json +140 -140
  301. package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -293
  302. package/augment-extensions/workflows/beads-integration/module.json +75 -75
  303. package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -219
  304. package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -256
  305. package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -607
  306. package/augment-extensions/workflows/database/README.md +195 -195
  307. package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -295
  308. package/augment-extensions/workflows/database/examples/migration-example.md +498 -498
  309. package/augment-extensions/workflows/database/examples/optimization-example.md +496 -496
  310. package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -444
  311. package/augment-extensions/workflows/database/module.json +42 -42
  312. package/augment-extensions/workflows/database/rules/data-migration.md +249 -249
  313. package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -339
  314. package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -352
  315. package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -435
  316. package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -535
  317. package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -305
  318. package/augment-extensions/workflows/database/rules/workflow.md +458 -458
  319. package/augment-extensions/workflows/wordpress-plugin/README.md +232 -232
  320. package/augment-extensions/workflows/wordpress-plugin/ai-prompts.md +839 -839
  321. package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md +854 -854
  322. package/augment-extensions/workflows/wordpress-plugin/examples/complete-plugin-example.md +540 -540
  323. package/augment-extensions/workflows/wordpress-plugin/examples/custom-post-type-example.md +1083 -1083
  324. package/augment-extensions/workflows/wordpress-plugin/examples/feature-addition-workflow.md +669 -669
  325. package/augment-extensions/workflows/wordpress-plugin/examples/plugin-creation-workflow.md +597 -597
  326. package/augment-extensions/workflows/wordpress-plugin/examples/secure-form-handler-example.md +925 -925
  327. package/augment-extensions/workflows/wordpress-plugin/examples/security-audit-workflow.md +752 -752
  328. package/augment-extensions/workflows/wordpress-plugin/examples/wordpress-org-submission-workflow.md +773 -773
  329. package/augment-extensions/workflows/wordpress-plugin/module.json +49 -49
  330. package/augment-extensions/workflows/wordpress-plugin/rules/best-practices.md +942 -942
  331. package/augment-extensions/workflows/wordpress-plugin/rules/development-workflow.md +702 -702
  332. package/augment-extensions/workflows/wordpress-plugin/rules/submission-workflow.md +728 -728
  333. package/augment-extensions/workflows/wordpress-plugin/rules/testing-workflow.md +775 -775
  334. package/augment-extensions/writing-standards/screenplay/README.md +339 -300
  335. package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -121
  336. package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -153
  337. package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -243
  338. package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -213
  339. package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -164
  340. package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -95
  341. package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -116
  342. package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -151
  343. package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -67
  344. package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -142
  345. package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -184
  346. package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -204
  347. package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -181
  348. package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -2
  349. package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -70
  350. package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -2
  351. package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -399
  352. package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -407
  353. package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -293
  354. package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -293
  355. package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -401
  356. package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -293
  357. package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -409
  358. package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -293
  359. package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -293
  360. package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -268
  361. package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -294
  362. package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -293
  363. package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -294
  364. package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -293
  365. package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -289
  366. package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -293
  367. package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -294
  368. package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -293
  369. package/augment-extensions/writing-standards/screenplay/module.json +124 -124
  370. package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -339
  371. package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -329
  372. package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -169
  373. package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -437
  374. package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -263
  375. package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -261
  376. package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -315
  377. package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -0
  378. package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -413
  379. package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -372
  380. package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -374
  381. package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -443
  382. package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -207
  383. package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -444
  384. package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -331
  385. package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -334
  386. package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -299
  387. package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -263
  388. package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -412
  389. package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -370
  390. package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -374
  391. package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -339
  392. package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -277
  393. package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -393
  394. package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -332
  395. package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -247
  396. package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -200
  397. package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -233
  398. package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -245
  399. package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -221
  400. package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -159
  401. package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -2
  402. package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -1449
  403. package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -64
  404. package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -2
  405. package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -520
  406. package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -499
  407. package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -497
  408. package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -492
  409. package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -509
  410. package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -490
  411. package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -499
  412. package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -501
  413. package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -499
  414. package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -498
  415. package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -499
  416. package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -508
  417. package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -500
  418. package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -158
  419. package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -2
  420. package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -643
  421. package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -311
  422. package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -562
  423. package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -538
  424. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -432
  425. package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -637
  426. package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -66
  427. package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -2
  428. package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -458
  429. package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -490
  430. package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -458
  431. package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -459
  432. package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -491
  433. package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -491
  434. package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -490
  435. package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -464
  436. package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -461
  437. package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -489
  438. package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -494
  439. package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -483
  440. package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -489
  441. package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -496
  442. package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -463
  443. package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -0
  444. package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -0
  445. package/cli/MODULES.md +302 -302
  446. package/cli/dist/cli.js +109 -22
  447. package/cli/dist/cli.js.map +1 -1
  448. package/cli/dist/commands/gui.d.ts.map +1 -1
  449. package/cli/dist/commands/gui.js +54 -6
  450. package/cli/dist/commands/gui.js.map +1 -1
  451. package/cli/dist/commands/init.d.ts.map +1 -1
  452. package/cli/dist/commands/init.js +76 -23
  453. package/cli/dist/commands/init.js.map +1 -1
  454. package/cli/dist/commands/self-remove.d.ts.map +1 -1
  455. package/cli/dist/commands/self-remove.js +48 -74
  456. package/cli/dist/commands/self-remove.js.map +1 -1
  457. package/cli/dist/commands/show.d.ts +11 -0
  458. package/cli/dist/commands/show.d.ts.map +1 -1
  459. package/cli/dist/commands/show.js +120 -0
  460. package/cli/dist/commands/show.js.map +1 -1
  461. package/cli/dist/commands/showCompleted.d.ts +21 -0
  462. package/cli/dist/commands/showCompleted.d.ts.map +1 -0
  463. package/cli/dist/commands/showCompleted.js +225 -0
  464. package/cli/dist/commands/showCompleted.js.map +1 -0
  465. package/cli/dist/commands/skill.js +88 -88
  466. package/cli/dist/commands/update.d.ts +2 -0
  467. package/cli/dist/commands/update.d.ts.map +1 -1
  468. package/cli/dist/commands/update.js +67 -1
  469. package/cli/dist/commands/update.js.map +1 -1
  470. package/cli/dist/utils/beadsCompletedChecker.d.ts +72 -0
  471. package/cli/dist/utils/beadsCompletedChecker.d.ts.map +1 -0
  472. package/cli/dist/utils/beadsCompletedChecker.js +198 -0
  473. package/cli/dist/utils/beadsCompletedChecker.js.map +1 -0
  474. package/cli/dist/utils/catalog-sync.js +13 -13
  475. package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
  476. package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
  477. package/cli/dist/utils/extractCommandHelp.js +250 -0
  478. package/cli/dist/utils/extractCommandHelp.js.map +1 -0
  479. package/cli/dist/utils/install-rules.js +55 -55
  480. package/cli/dist/utils/mcp-integration.js +44 -44
  481. package/cli/dist/utils/rule-install-hooks.js +8 -8
  482. package/modules.md +667 -630
  483. package/package.json +85 -85
@@ -1,607 +1,607 @@
1
- # Relational Query Optimization
2
-
3
- ## Overview
4
-
5
- This document covers query optimization techniques for relational databases, including query execution plans, JOIN optimization, subquery strategies, N+1 query prevention, and database-specific optimizations.
6
-
7
- ---
8
-
9
- ## Query Execution Plans
10
-
11
- ### Understanding Execution Plans
12
-
13
- **Purpose**: Visualize how the database executes a query
14
-
15
- **Key concepts:**
16
- - **Scan types**: Sequential scan, index scan, index-only scan
17
- - **Join methods**: Nested loop, hash join, merge join
18
- - **Cost estimates**: Relative cost of operations
19
- - **Row estimates**: Expected number of rows processed
20
-
21
- ### Analyzing Execution Plans
22
-
23
- #### PostgreSQL
24
-
25
- ```sql
26
- -- Basic execution plan
27
- EXPLAIN
28
- SELECT u.name, o.total
29
- FROM users u
30
- JOIN orders o ON o.user_id = u.id
31
- WHERE u.created_at > '2024-01-01';
32
-
33
- -- Execution plan with actual runtime statistics
34
- EXPLAIN ANALYZE
35
- SELECT u.name, o.total
36
- FROM users u
37
- JOIN orders o ON o.user_id = u.id
38
- WHERE u.created_at > '2024-01-01';
39
-
40
- -- Detailed execution plan with buffer usage
41
- EXPLAIN (ANALYZE, BUFFERS)
42
- SELECT u.name, o.total
43
- FROM users u
44
- JOIN orders o ON o.user_id = u.id
45
- WHERE u.created_at > '2024-01-01';
46
- ```
47
-
48
- **Key metrics:**
49
- - **Seq Scan**: Full table scan (slow for large tables)
50
- - **Index Scan**: Using index to find rows (fast)
51
- - **Index Only Scan**: Using covering index (fastest)
52
- - **Bitmap Heap Scan**: Using index bitmap (good for multiple conditions)
53
-
54
- #### MySQL
55
-
56
- ```sql
57
- -- Execution plan
58
- EXPLAIN
59
- SELECT u.name, o.total
60
- FROM users u
61
- JOIN orders o ON o.user_id = u.id
62
- WHERE u.created_at > '2024-01-01';
63
-
64
- -- Extended execution plan
65
- EXPLAIN FORMAT=JSON
66
- SELECT u.name, o.total
67
- FROM users u
68
- JOIN orders o ON o.user_id = u.id
69
- WHERE u.created_at > '2024-01-01';
70
-
71
- -- Analyze query (executes and shows stats)
72
- EXPLAIN ANALYZE
73
- SELECT u.name, o.total
74
- FROM users u
75
- JOIN orders o ON o.user_id = u.id
76
- WHERE u.created_at > '2024-01-01';
77
- ```
78
-
79
- #### SQL Server
80
-
81
- ```sql
82
- -- Show execution plan
83
- SET SHOWPLAN_TEXT ON;
84
- GO
85
- SELECT u.name, o.total
86
- FROM users u
87
- JOIN orders o ON o.user_id = u.id
88
- WHERE u.created_at > '2024-01-01';
89
- GO
90
- SET SHOWPLAN_TEXT OFF;
91
- GO
92
-
93
- -- Include actual execution plan
94
- SET STATISTICS PROFILE ON;
95
- GO
96
- SELECT u.name, o.total
97
- FROM users u
98
- JOIN orders o ON o.user_id = u.id
99
- WHERE u.created_at > '2024-01-01';
100
- GO
101
- SET STATISTICS PROFILE OFF;
102
- GO
103
- ```
104
-
105
- ---
106
-
107
- ## JOIN Optimization
108
-
109
- ### JOIN Types and Performance
110
-
111
- #### INNER JOIN
112
-
113
- ```sql
114
- -- ✅ GOOD: Use INNER JOIN for required relationships
115
- SELECT u.name, o.total
116
- FROM users u
117
- INNER JOIN orders o ON o.user_id = u.id;
118
-
119
- -- ❌ BAD: Implicit join (less readable)
120
- SELECT u.name, o.total
121
- FROM users u, orders o
122
- WHERE o.user_id = u.id;
123
- ```
124
-
125
- #### LEFT JOIN
126
-
127
- ```sql
128
- -- ✅ GOOD: Use LEFT JOIN when right side is optional
129
- SELECT u.name, COUNT(o.id) AS order_count
130
- FROM users u
131
- LEFT JOIN orders o ON o.user_id = u.id
132
- GROUP BY u.id, u.name;
133
-
134
- -- ❌ BAD: Using LEFT JOIN when INNER JOIN would work
135
- SELECT u.name, o.total
136
- FROM users u
137
- LEFT JOIN orders o ON o.user_id = u.id
138
- WHERE o.id IS NOT NULL; -- This makes it an INNER JOIN
139
- ```
140
-
141
- ### JOIN Order Optimization
142
-
143
- **Principle**: Join smaller result sets first
144
-
145
- ```sql
146
- -- ❌ BAD: Large table first
147
- SELECT *
148
- FROM orders o
149
- JOIN users u ON u.id = o.user_id
150
- WHERE u.email = 'user@example.com';
151
-
152
- -- ✅ GOOD: Filter first, then join
153
- SELECT *
154
- FROM users u
155
- JOIN orders o ON o.user_id = u.id
156
- WHERE u.email = 'user@example.com';
157
-
158
- -- ✅ BETTER: Use subquery to filter first
159
- SELECT *
160
- FROM (
161
- SELECT id FROM users WHERE email = 'user@example.com'
162
- ) u
163
- JOIN orders o ON o.user_id = u.id;
164
- ```
165
-
166
- ### Multiple JOINs
167
-
168
- ```sql
169
- -- ✅ GOOD: Join in logical order
170
- SELECT u.name, o.total, p.name AS product_name
171
- FROM users u
172
- JOIN orders o ON o.user_id = u.id
173
- JOIN order_items oi ON oi.order_id = o.id
174
- JOIN products p ON p.id = oi.product_id
175
- WHERE u.created_at > '2024-01-01';
176
- ```
177
-
178
- ### JOIN Method Selection
179
-
180
- **Database chooses based on:**
181
- - Table sizes
182
- - Available indexes
183
- - Join conditions
184
- - Statistics
185
-
186
- **Common methods:**
187
- - **Nested Loop**: Good for small datasets, indexed joins
188
- - **Hash Join**: Good for large datasets, equality conditions
189
- - **Merge Join**: Good for sorted data, range conditions
190
-
191
- ---
192
-
193
- ## Subquery vs JOIN
194
-
195
- ### When to Use Subqueries
196
-
197
- ```sql
198
- -- ✅ GOOD: Subquery for existence check
199
- SELECT *
200
- FROM users u
201
- WHERE EXISTS (
202
- SELECT 1 FROM orders o WHERE o.user_id = u.id
203
- );
204
-
205
- -- ✅ GOOD: Subquery for scalar value
206
- SELECT u.name,
207
- (SELECT COUNT(*) FROM orders WHERE user_id = u.id) AS order_count
208
- FROM users u;
209
-
210
- -- ❌ BAD: Subquery in WHERE with IN (can be slow)
211
- SELECT *
212
- FROM users
213
- WHERE id IN (SELECT user_id FROM orders);
214
-
215
- -- ✅ BETTER: Use JOIN instead
216
- SELECT DISTINCT u.*
217
- FROM users u
218
- JOIN orders o ON o.user_id = u.id;
219
- ```
220
-
221
- ### Correlated vs Non-Correlated Subqueries
222
-
223
- ```sql
224
- -- ❌ BAD: Correlated subquery (executes for each row)
225
- SELECT u.name,
226
- (SELECT COUNT(*) FROM orders o WHERE o.user_id = u.id) AS order_count
227
- FROM users u;
228
-
229
- -- ✅ BETTER: Use JOIN with GROUP BY
230
- SELECT u.name, COUNT(o.id) AS order_count
231
- FROM users u
232
- LEFT JOIN orders o ON o.user_id = u.id
233
- GROUP BY u.id, u.name;
234
- ```
235
-
236
- ---
237
-
238
- ## Avoiding N+1 Queries
239
-
240
- ### The N+1 Problem
241
-
242
- **Problem**: Executing 1 query to get N records, then N queries to get related data
243
-
244
- ```javascript
245
- // ❌ BAD: N+1 queries
246
- const users = await db.query('SELECT * FROM users');
247
- for (const user of users) {
248
- const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
249
- user.orders = orders;
250
- }
251
- ```
252
-
253
- ### Solutions
254
-
255
- #### 1. Use JOINs
256
-
257
- ```javascript
258
- // ✅ GOOD: Single query with JOIN
259
- const result = await db.query(`
260
- SELECT u.*, o.id AS order_id, o.total, o.created_at AS order_date
261
- FROM users u
262
- LEFT JOIN orders o ON o.user_id = u.id
263
- `);
264
-
265
- // Group results by user
266
- const users = groupByUser(result);
267
- ```
268
-
269
- #### 2. Use Batch Loading
270
-
271
- ```javascript
272
- // ✅ GOOD: Batch load related data
273
- const users = await db.query('SELECT * FROM users');
274
- const userIds = users.map(u => u.id);
275
-
276
- const orders = await db.query(
277
- 'SELECT * FROM orders WHERE user_id = ANY(?)',
278
- [userIds]
279
- );
280
-
281
- // Map orders to users
282
- const ordersByUser = groupBy(orders, 'user_id');
283
- users.forEach(user => {
284
- user.orders = ordersByUser[user.id] || [];
285
- });
286
- ```
287
-
288
- #### 3. Use DataLoader (GraphQL)
289
-
290
- ```javascript
291
- // ✅ GOOD: Use DataLoader for batching
292
- const orderLoader = new DataLoader(async (userIds) => {
293
- const orders = await db.query(
294
- 'SELECT * FROM orders WHERE user_id = ANY(?)',
295
- [userIds]
296
- );
297
- return userIds.map(id => orders.filter(o => o.user_id === id));
298
- });
299
-
300
- // Usage
301
- const orders = await orderLoader.load(userId);
302
- ```
303
-
304
- ---
305
-
306
- ## SELECT Optimization
307
-
308
- ### Select Only Needed Columns
309
-
310
- ```sql
311
- -- ❌ BAD: Select all columns
312
- SELECT * FROM users;
313
-
314
- -- ✅ GOOD: Select only needed columns
315
- SELECT id, email, name FROM users;
316
-
317
- -- ✅ BETTER: Use covering index
318
- CREATE INDEX idx_users_email_name ON users(email, name);
319
- SELECT email, name FROM users WHERE email = 'user@example.com';
320
- ```
321
-
322
- ### Avoid SELECT DISTINCT When Possible
323
-
324
- ```sql
325
- -- ❌ BAD: DISTINCT to hide duplicate rows
326
- SELECT DISTINCT u.name
327
- FROM users u
328
- JOIN orders o ON o.user_id = u.id;
329
-
330
- -- ✅ BETTER: Use GROUP BY
331
- SELECT u.name
332
- FROM users u
333
- JOIN orders o ON o.user_id = u.id
334
- GROUP BY u.id, u.name;
335
-
336
- -- ✅ BEST: Use EXISTS if you only need to check existence
337
- SELECT u.name
338
- FROM users u
339
- WHERE EXISTS (SELECT 1 FROM orders WHERE user_id = u.id);
340
- ```
341
-
342
- ---
343
-
344
- ## WHERE Clause Optimization
345
-
346
- ### Use Indexes Effectively
347
-
348
- ```sql
349
- -- ✅ GOOD: Indexed column in WHERE
350
- SELECT * FROM users WHERE email = 'user@example.com';
351
-
352
- -- ❌ BAD: Function on indexed column (can't use index)
353
- SELECT * FROM users WHERE LOWER(email) = 'user@example.com';
354
-
355
- -- ✅ BETTER: Use functional index
356
- CREATE INDEX idx_users_email_lower ON users(LOWER(email));
357
- SELECT * FROM users WHERE LOWER(email) = 'user@example.com';
358
- ```
359
-
360
- ### Avoid OR Conditions
361
-
362
- ```sql
363
- -- ❌ BAD: OR condition (may not use indexes efficiently)
364
- SELECT * FROM users WHERE email = 'user@example.com' OR name = 'John';
365
-
366
- -- ✅ BETTER: Use UNION
367
- SELECT * FROM users WHERE email = 'user@example.com'
368
- UNION
369
- SELECT * FROM users WHERE name = 'John';
370
-
371
- -- ✅ BEST: Use IN for same column
372
- SELECT * FROM users WHERE status IN ('active', 'pending');
373
- ```
374
-
375
- ### Use BETWEEN for Ranges
376
-
377
- ```sql
378
- -- ❌ BAD: Multiple comparisons
379
- SELECT * FROM orders WHERE created_at >= '2024-01-01' AND created_at <= '2024-12-31';
380
-
381
- -- ✅ GOOD: Use BETWEEN
382
- SELECT * FROM orders WHERE created_at BETWEEN '2024-01-01' AND '2024-12-31';
383
- ```
384
-
385
- ---
386
-
387
- ## Aggregation Optimization
388
-
389
- ### Use Indexes for GROUP BY
390
-
391
- ```sql
392
- -- ✅ GOOD: Index on GROUP BY column
393
- CREATE INDEX idx_orders_user_id ON orders(user_id);
394
-
395
- SELECT user_id, COUNT(*) AS order_count
396
- FROM orders
397
- GROUP BY user_id;
398
- ```
399
-
400
- ### Avoid HAVING When Possible
401
-
402
- ```sql
403
- -- ❌ BAD: HAVING filters after aggregation
404
- SELECT user_id, COUNT(*) AS order_count
405
- FROM orders
406
- GROUP BY user_id
407
- HAVING user_id > 100;
408
-
409
- -- ✅ BETTER: WHERE filters before aggregation
410
- SELECT user_id, COUNT(*) AS order_count
411
- FROM orders
412
- WHERE user_id > 100
413
- GROUP BY user_id;
414
- ```
415
-
416
- ### Use Materialized Views for Complex Aggregations
417
-
418
- ```sql
419
- -- ✅ GOOD: Precompute expensive aggregations
420
- CREATE MATERIALIZED VIEW user_order_stats AS
421
- SELECT
422
- u.id,
423
- u.name,
424
- COUNT(o.id) AS order_count,
425
- SUM(o.total) AS total_spent,
426
- MAX(o.created_at) AS last_order_date
427
- FROM users u
428
- LEFT JOIN orders o ON o.user_id = u.id
429
- GROUP BY u.id, u.name;
430
-
431
- -- Refresh periodically
432
- REFRESH MATERIALIZED VIEW user_order_stats;
433
-
434
- -- Query is now fast
435
- SELECT * FROM user_order_stats WHERE order_count > 10;
436
- ```
437
-
438
- ---
439
-
440
- ## Pagination Strategies
441
-
442
- ### Offset-Based Pagination
443
-
444
- ```sql
445
- -- ❌ BAD: Large offset (slow for deep pages)
446
- SELECT * FROM orders
447
- ORDER BY created_at DESC
448
- LIMIT 20 OFFSET 10000;
449
-
450
- -- ✅ BETTER: Use indexed column for ordering
451
- CREATE INDEX idx_orders_created_at ON orders(created_at DESC);
452
- SELECT * FROM orders
453
- ORDER BY created_at DESC
454
- LIMIT 20 OFFSET 100;
455
- ```
456
-
457
- ### Cursor-Based Pagination
458
-
459
- ```sql
460
- -- ✅ BEST: Use cursor (keyset pagination)
461
- -- First page
462
- SELECT * FROM orders
463
- WHERE created_at < NOW()
464
- ORDER BY created_at DESC
465
- LIMIT 20;
466
-
467
- -- Next page (using last created_at from previous page)
468
- SELECT * FROM orders
469
- WHERE created_at < '2024-01-15 10:30:00'
470
- ORDER BY created_at DESC
471
- LIMIT 20;
472
- ```
473
-
474
- **Benefits:**
475
- - ✅ Consistent performance regardless of page depth
476
- - ✅ No duplicate or missing rows when data changes
477
- - ✅ Works well with real-time data
478
-
479
- ### Seek Method (Best for Large Datasets)
480
-
481
- ```sql
482
- -- ✅ BEST: Seek method with composite key
483
- CREATE INDEX idx_orders_created_id ON orders(created_at DESC, id DESC);
484
-
485
- -- First page
486
- SELECT * FROM orders
487
- ORDER BY created_at DESC, id DESC
488
- LIMIT 20;
489
-
490
- -- Next page (using last created_at and id from previous page)
491
- SELECT * FROM orders
492
- WHERE (created_at, id) < ('2024-01-15 10:30:00', 12345)
493
- ORDER BY created_at DESC, id DESC
494
- LIMIT 20;
495
- ```
496
-
497
- ---
498
-
499
- ## Database-Specific Optimizations
500
-
501
- ### PostgreSQL
502
-
503
- ```sql
504
- -- Use EXPLAIN ANALYZE to identify slow queries
505
- EXPLAIN (ANALYZE, BUFFERS)
506
- SELECT * FROM orders WHERE user_id = 123;
507
-
508
- -- Use partial indexes for filtered queries
509
- CREATE INDEX idx_active_users ON users(email) WHERE status = 'active';
510
-
511
- -- Use VACUUM ANALYZE to update statistics
512
- VACUUM ANALYZE orders;
513
-
514
- -- Use parallel query execution
515
- SET max_parallel_workers_per_gather = 4;
516
-
517
- -- Use LATERAL joins for correlated subqueries
518
- SELECT u.*, recent_orders.*
519
- FROM users u
520
- LEFT JOIN LATERAL (
521
- SELECT * FROM orders WHERE user_id = u.id ORDER BY created_at DESC LIMIT 5
522
- ) recent_orders ON true;
523
- ```
524
-
525
- ### MySQL
526
-
527
- ```sql
528
- -- Use EXPLAIN to analyze queries
529
- EXPLAIN SELECT * FROM orders WHERE user_id = 123;
530
-
531
- -- Use FORCE INDEX to force index usage
532
- SELECT * FROM orders FORCE INDEX (idx_user_id) WHERE user_id = 123;
533
-
534
- -- Use query cache (MySQL 5.7 and earlier)
535
- SET GLOBAL query_cache_size = 268435456; -- 256MB
536
-
537
- -- Optimize table to reclaim space
538
- OPTIMIZE TABLE orders;
539
-
540
- -- Analyze table to update statistics
541
- ANALYZE TABLE orders;
542
- ```
543
-
544
- ### SQL Server
545
-
546
- ```sql
547
- -- Use execution plan
548
- SET SHOWPLAN_TEXT ON;
549
-
550
- -- Use query hints
551
- SELECT * FROM orders WITH (INDEX(idx_user_id)) WHERE user_id = 123;
552
-
553
- -- Update statistics
554
- UPDATE STATISTICS orders;
555
-
556
- -- Rebuild indexes
557
- ALTER INDEX idx_user_id ON orders REBUILD;
558
- ```
559
-
560
- ---
561
-
562
- ## Query Optimization Checklist
563
-
564
- ### Before Writing Queries
565
-
566
- - [ ] Understand the data model and relationships
567
- - [ ] Identify required columns (avoid SELECT *)
568
- - [ ] Check existing indexes
569
- - [ ] Consider query frequency and data volume
570
-
571
- ### While Writing Queries
572
-
573
- - [ ] Use appropriate JOIN types
574
- - [ ] Filter early (WHERE before JOIN when possible)
575
- - [ ] Use indexes effectively
576
- - [ ] Avoid functions on indexed columns
577
- - [ ] Use prepared statements for security and performance
578
-
579
- ### After Writing Queries
580
-
581
- - [ ] Analyze execution plan
582
- - [ ] Check for table scans on large tables
583
- - [ ] Verify indexes are being used
584
- - [ ] Test with production-like data volumes
585
- - [ ] Monitor query performance in production
586
-
587
- ### Optimization Techniques
588
-
589
- - [ ] Add indexes on frequently queried columns
590
- - [ ] Use covering indexes for index-only scans
591
- - [ ] Rewrite subqueries as JOINs when appropriate
592
- - [ ] Use batch loading to avoid N+1 queries
593
- - [ ] Implement cursor-based pagination for large datasets
594
- - [ ] Cache frequently accessed data
595
- - [ ] Use materialized views for complex aggregations
596
-
597
- ---
598
-
599
- ## Related Documentation
600
-
601
- - **relational-databases.md**: Relational database fundamentals
602
- - **relational-indexing.md**: Indexing strategies
603
- - **relational-schema-design.md**: Schema design and normalization
604
- - **performance-optimization.md**: General performance optimization
605
- - **relational-transactions.md**: Transaction management
606
-
607
-
1
+ # Relational Query Optimization
2
+
3
+ ## Overview
4
+
5
+ This document covers query optimization techniques for relational databases, including query execution plans, JOIN optimization, subquery strategies, N+1 query prevention, and database-specific optimizations.
6
+
7
+ ---
8
+
9
+ ## Query Execution Plans
10
+
11
+ ### Understanding Execution Plans
12
+
13
+ **Purpose**: Visualize how the database executes a query
14
+
15
+ **Key concepts:**
16
+ - **Scan types**: Sequential scan, index scan, index-only scan
17
+ - **Join methods**: Nested loop, hash join, merge join
18
+ - **Cost estimates**: Relative cost of operations
19
+ - **Row estimates**: Expected number of rows processed
20
+
21
+ ### Analyzing Execution Plans
22
+
23
+ #### PostgreSQL
24
+
25
+ ```sql
26
+ -- Basic execution plan
27
+ EXPLAIN
28
+ SELECT u.name, o.total
29
+ FROM users u
30
+ JOIN orders o ON o.user_id = u.id
31
+ WHERE u.created_at > '2024-01-01';
32
+
33
+ -- Execution plan with actual runtime statistics
34
+ EXPLAIN ANALYZE
35
+ SELECT u.name, o.total
36
+ FROM users u
37
+ JOIN orders o ON o.user_id = u.id
38
+ WHERE u.created_at > '2024-01-01';
39
+
40
+ -- Detailed execution plan with buffer usage
41
+ EXPLAIN (ANALYZE, BUFFERS)
42
+ SELECT u.name, o.total
43
+ FROM users u
44
+ JOIN orders o ON o.user_id = u.id
45
+ WHERE u.created_at > '2024-01-01';
46
+ ```
47
+
48
+ **Key metrics:**
49
+ - **Seq Scan**: Full table scan (slow for large tables)
50
+ - **Index Scan**: Using index to find rows (fast)
51
+ - **Index Only Scan**: Using covering index (fastest)
52
+ - **Bitmap Heap Scan**: Using index bitmap (good for multiple conditions)
53
+
54
+ #### MySQL
55
+
56
+ ```sql
57
+ -- Execution plan
58
+ EXPLAIN
59
+ SELECT u.name, o.total
60
+ FROM users u
61
+ JOIN orders o ON o.user_id = u.id
62
+ WHERE u.created_at > '2024-01-01';
63
+
64
+ -- Extended execution plan
65
+ EXPLAIN FORMAT=JSON
66
+ SELECT u.name, o.total
67
+ FROM users u
68
+ JOIN orders o ON o.user_id = u.id
69
+ WHERE u.created_at > '2024-01-01';
70
+
71
+ -- Analyze query (executes and shows stats)
72
+ EXPLAIN ANALYZE
73
+ SELECT u.name, o.total
74
+ FROM users u
75
+ JOIN orders o ON o.user_id = u.id
76
+ WHERE u.created_at > '2024-01-01';
77
+ ```
78
+
79
+ #### SQL Server
80
+
81
+ ```sql
82
+ -- Show execution plan
83
+ SET SHOWPLAN_TEXT ON;
84
+ GO
85
+ SELECT u.name, o.total
86
+ FROM users u
87
+ JOIN orders o ON o.user_id = u.id
88
+ WHERE u.created_at > '2024-01-01';
89
+ GO
90
+ SET SHOWPLAN_TEXT OFF;
91
+ GO
92
+
93
+ -- Include actual execution plan
94
+ SET STATISTICS PROFILE ON;
95
+ GO
96
+ SELECT u.name, o.total
97
+ FROM users u
98
+ JOIN orders o ON o.user_id = u.id
99
+ WHERE u.created_at > '2024-01-01';
100
+ GO
101
+ SET STATISTICS PROFILE OFF;
102
+ GO
103
+ ```
104
+
105
+ ---
106
+
107
+ ## JOIN Optimization
108
+
109
+ ### JOIN Types and Performance
110
+
111
+ #### INNER JOIN
112
+
113
+ ```sql
114
+ -- ✅ GOOD: Use INNER JOIN for required relationships
115
+ SELECT u.name, o.total
116
+ FROM users u
117
+ INNER JOIN orders o ON o.user_id = u.id;
118
+
119
+ -- ❌ BAD: Implicit join (less readable)
120
+ SELECT u.name, o.total
121
+ FROM users u, orders o
122
+ WHERE o.user_id = u.id;
123
+ ```
124
+
125
+ #### LEFT JOIN
126
+
127
+ ```sql
128
+ -- ✅ GOOD: Use LEFT JOIN when right side is optional
129
+ SELECT u.name, COUNT(o.id) AS order_count
130
+ FROM users u
131
+ LEFT JOIN orders o ON o.user_id = u.id
132
+ GROUP BY u.id, u.name;
133
+
134
+ -- ❌ BAD: Using LEFT JOIN when INNER JOIN would work
135
+ SELECT u.name, o.total
136
+ FROM users u
137
+ LEFT JOIN orders o ON o.user_id = u.id
138
+ WHERE o.id IS NOT NULL; -- This makes it an INNER JOIN
139
+ ```
140
+
141
+ ### JOIN Order Optimization
142
+
143
+ **Principle**: Join smaller result sets first
144
+
145
+ ```sql
146
+ -- ❌ BAD: Large table first
147
+ SELECT *
148
+ FROM orders o
149
+ JOIN users u ON u.id = o.user_id
150
+ WHERE u.email = 'user@example.com';
151
+
152
+ -- ✅ GOOD: Filter first, then join
153
+ SELECT *
154
+ FROM users u
155
+ JOIN orders o ON o.user_id = u.id
156
+ WHERE u.email = 'user@example.com';
157
+
158
+ -- ✅ BETTER: Use subquery to filter first
159
+ SELECT *
160
+ FROM (
161
+ SELECT id FROM users WHERE email = 'user@example.com'
162
+ ) u
163
+ JOIN orders o ON o.user_id = u.id;
164
+ ```
165
+
166
+ ### Multiple JOINs
167
+
168
+ ```sql
169
+ -- ✅ GOOD: Join in logical order
170
+ SELECT u.name, o.total, p.name AS product_name
171
+ FROM users u
172
+ JOIN orders o ON o.user_id = u.id
173
+ JOIN order_items oi ON oi.order_id = o.id
174
+ JOIN products p ON p.id = oi.product_id
175
+ WHERE u.created_at > '2024-01-01';
176
+ ```
177
+
178
+ ### JOIN Method Selection
179
+
180
+ **Database chooses based on:**
181
+ - Table sizes
182
+ - Available indexes
183
+ - Join conditions
184
+ - Statistics
185
+
186
+ **Common methods:**
187
+ - **Nested Loop**: Good for small datasets, indexed joins
188
+ - **Hash Join**: Good for large datasets, equality conditions
189
+ - **Merge Join**: Good for sorted data, range conditions
190
+
191
+ ---
192
+
193
+ ## Subquery vs JOIN
194
+
195
+ ### When to Use Subqueries
196
+
197
+ ```sql
198
+ -- ✅ GOOD: Subquery for existence check
199
+ SELECT *
200
+ FROM users u
201
+ WHERE EXISTS (
202
+ SELECT 1 FROM orders o WHERE o.user_id = u.id
203
+ );
204
+
205
+ -- ✅ GOOD: Subquery for scalar value
206
+ SELECT u.name,
207
+ (SELECT COUNT(*) FROM orders WHERE user_id = u.id) AS order_count
208
+ FROM users u;
209
+
210
+ -- ❌ BAD: Subquery in WHERE with IN (can be slow)
211
+ SELECT *
212
+ FROM users
213
+ WHERE id IN (SELECT user_id FROM orders);
214
+
215
+ -- ✅ BETTER: Use JOIN instead
216
+ SELECT DISTINCT u.*
217
+ FROM users u
218
+ JOIN orders o ON o.user_id = u.id;
219
+ ```
220
+
221
+ ### Correlated vs Non-Correlated Subqueries
222
+
223
+ ```sql
224
+ -- ❌ BAD: Correlated subquery (executes for each row)
225
+ SELECT u.name,
226
+ (SELECT COUNT(*) FROM orders o WHERE o.user_id = u.id) AS order_count
227
+ FROM users u;
228
+
229
+ -- ✅ BETTER: Use JOIN with GROUP BY
230
+ SELECT u.name, COUNT(o.id) AS order_count
231
+ FROM users u
232
+ LEFT JOIN orders o ON o.user_id = u.id
233
+ GROUP BY u.id, u.name;
234
+ ```
235
+
236
+ ---
237
+
238
+ ## Avoiding N+1 Queries
239
+
240
+ ### The N+1 Problem
241
+
242
+ **Problem**: Executing 1 query to get N records, then N queries to get related data
243
+
244
+ ```javascript
245
+ // ❌ BAD: N+1 queries
246
+ const users = await db.query('SELECT * FROM users');
247
+ for (const user of users) {
248
+ const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
249
+ user.orders = orders;
250
+ }
251
+ ```
252
+
253
+ ### Solutions
254
+
255
+ #### 1. Use JOINs
256
+
257
+ ```javascript
258
+ // ✅ GOOD: Single query with JOIN
259
+ const result = await db.query(`
260
+ SELECT u.*, o.id AS order_id, o.total, o.created_at AS order_date
261
+ FROM users u
262
+ LEFT JOIN orders o ON o.user_id = u.id
263
+ `);
264
+
265
+ // Group results by user
266
+ const users = groupByUser(result);
267
+ ```
268
+
269
+ #### 2. Use Batch Loading
270
+
271
+ ```javascript
272
+ // ✅ GOOD: Batch load related data
273
+ const users = await db.query('SELECT * FROM users');
274
+ const userIds = users.map(u => u.id);
275
+
276
+ const orders = await db.query(
277
+ 'SELECT * FROM orders WHERE user_id = ANY(?)',
278
+ [userIds]
279
+ );
280
+
281
+ // Map orders to users
282
+ const ordersByUser = groupBy(orders, 'user_id');
283
+ users.forEach(user => {
284
+ user.orders = ordersByUser[user.id] || [];
285
+ });
286
+ ```
287
+
288
+ #### 3. Use DataLoader (GraphQL)
289
+
290
+ ```javascript
291
+ // ✅ GOOD: Use DataLoader for batching
292
+ const orderLoader = new DataLoader(async (userIds) => {
293
+ const orders = await db.query(
294
+ 'SELECT * FROM orders WHERE user_id = ANY(?)',
295
+ [userIds]
296
+ );
297
+ return userIds.map(id => orders.filter(o => o.user_id === id));
298
+ });
299
+
300
+ // Usage
301
+ const orders = await orderLoader.load(userId);
302
+ ```
303
+
304
+ ---
305
+
306
+ ## SELECT Optimization
307
+
308
+ ### Select Only Needed Columns
309
+
310
+ ```sql
311
+ -- ❌ BAD: Select all columns
312
+ SELECT * FROM users;
313
+
314
+ -- ✅ GOOD: Select only needed columns
315
+ SELECT id, email, name FROM users;
316
+
317
+ -- ✅ BETTER: Use covering index
318
+ CREATE INDEX idx_users_email_name ON users(email, name);
319
+ SELECT email, name FROM users WHERE email = 'user@example.com';
320
+ ```
321
+
322
+ ### Avoid SELECT DISTINCT When Possible
323
+
324
+ ```sql
325
+ -- ❌ BAD: DISTINCT to hide duplicate rows
326
+ SELECT DISTINCT u.name
327
+ FROM users u
328
+ JOIN orders o ON o.user_id = u.id;
329
+
330
+ -- ✅ BETTER: Use GROUP BY
331
+ SELECT u.name
332
+ FROM users u
333
+ JOIN orders o ON o.user_id = u.id
334
+ GROUP BY u.id, u.name;
335
+
336
+ -- ✅ BEST: Use EXISTS if you only need to check existence
337
+ SELECT u.name
338
+ FROM users u
339
+ WHERE EXISTS (SELECT 1 FROM orders WHERE user_id = u.id);
340
+ ```
341
+
342
+ ---
343
+
344
+ ## WHERE Clause Optimization
345
+
346
+ ### Use Indexes Effectively
347
+
348
+ ```sql
349
+ -- ✅ GOOD: Indexed column in WHERE
350
+ SELECT * FROM users WHERE email = 'user@example.com';
351
+
352
+ -- ❌ BAD: Function on indexed column (can't use index)
353
+ SELECT * FROM users WHERE LOWER(email) = 'user@example.com';
354
+
355
+ -- ✅ BETTER: Use functional index
356
+ CREATE INDEX idx_users_email_lower ON users(LOWER(email));
357
+ SELECT * FROM users WHERE LOWER(email) = 'user@example.com';
358
+ ```
359
+
360
+ ### Avoid OR Conditions
361
+
362
+ ```sql
363
+ -- ❌ BAD: OR condition (may not use indexes efficiently)
364
+ SELECT * FROM users WHERE email = 'user@example.com' OR name = 'John';
365
+
366
+ -- ✅ BETTER: Use UNION
367
+ SELECT * FROM users WHERE email = 'user@example.com'
368
+ UNION
369
+ SELECT * FROM users WHERE name = 'John';
370
+
371
+ -- ✅ BEST: Use IN for same column
372
+ SELECT * FROM users WHERE status IN ('active', 'pending');
373
+ ```
374
+
375
+ ### Use BETWEEN for Ranges
376
+
377
+ ```sql
378
+ -- ❌ BAD: Multiple comparisons
379
+ SELECT * FROM orders WHERE created_at >= '2024-01-01' AND created_at <= '2024-12-31';
380
+
381
+ -- ✅ GOOD: Use BETWEEN
382
+ SELECT * FROM orders WHERE created_at BETWEEN '2024-01-01' AND '2024-12-31';
383
+ ```
384
+
385
+ ---
386
+
387
+ ## Aggregation Optimization
388
+
389
+ ### Use Indexes for GROUP BY
390
+
391
+ ```sql
392
+ -- ✅ GOOD: Index on GROUP BY column
393
+ CREATE INDEX idx_orders_user_id ON orders(user_id);
394
+
395
+ SELECT user_id, COUNT(*) AS order_count
396
+ FROM orders
397
+ GROUP BY user_id;
398
+ ```
399
+
400
+ ### Avoid HAVING When Possible
401
+
402
+ ```sql
403
+ -- ❌ BAD: HAVING filters after aggregation
404
+ SELECT user_id, COUNT(*) AS order_count
405
+ FROM orders
406
+ GROUP BY user_id
407
+ HAVING user_id > 100;
408
+
409
+ -- ✅ BETTER: WHERE filters before aggregation
410
+ SELECT user_id, COUNT(*) AS order_count
411
+ FROM orders
412
+ WHERE user_id > 100
413
+ GROUP BY user_id;
414
+ ```
415
+
416
+ ### Use Materialized Views for Complex Aggregations
417
+
418
+ ```sql
419
+ -- ✅ GOOD: Precompute expensive aggregations
420
+ CREATE MATERIALIZED VIEW user_order_stats AS
421
+ SELECT
422
+ u.id,
423
+ u.name,
424
+ COUNT(o.id) AS order_count,
425
+ SUM(o.total) AS total_spent,
426
+ MAX(o.created_at) AS last_order_date
427
+ FROM users u
428
+ LEFT JOIN orders o ON o.user_id = u.id
429
+ GROUP BY u.id, u.name;
430
+
431
+ -- Refresh periodically
432
+ REFRESH MATERIALIZED VIEW user_order_stats;
433
+
434
+ -- Query is now fast
435
+ SELECT * FROM user_order_stats WHERE order_count > 10;
436
+ ```
437
+
438
+ ---
439
+
440
+ ## Pagination Strategies
441
+
442
+ ### Offset-Based Pagination
443
+
444
+ ```sql
445
+ -- ❌ BAD: Large offset (slow for deep pages)
446
+ SELECT * FROM orders
447
+ ORDER BY created_at DESC
448
+ LIMIT 20 OFFSET 10000;
449
+
450
+ -- ✅ BETTER: Use indexed column for ordering
451
+ CREATE INDEX idx_orders_created_at ON orders(created_at DESC);
452
+ SELECT * FROM orders
453
+ ORDER BY created_at DESC
454
+ LIMIT 20 OFFSET 100;
455
+ ```
456
+
457
+ ### Cursor-Based Pagination
458
+
459
+ ```sql
460
+ -- ✅ BEST: Use cursor (keyset pagination)
461
+ -- First page
462
+ SELECT * FROM orders
463
+ WHERE created_at < NOW()
464
+ ORDER BY created_at DESC
465
+ LIMIT 20;
466
+
467
+ -- Next page (using last created_at from previous page)
468
+ SELECT * FROM orders
469
+ WHERE created_at < '2024-01-15 10:30:00'
470
+ ORDER BY created_at DESC
471
+ LIMIT 20;
472
+ ```
473
+
474
+ **Benefits:**
475
+ - ✅ Consistent performance regardless of page depth
476
+ - ✅ No duplicate or missing rows when data changes
477
+ - ✅ Works well with real-time data
478
+
479
+ ### Seek Method (Best for Large Datasets)
480
+
481
+ ```sql
482
+ -- ✅ BEST: Seek method with composite key
483
+ CREATE INDEX idx_orders_created_id ON orders(created_at DESC, id DESC);
484
+
485
+ -- First page
486
+ SELECT * FROM orders
487
+ ORDER BY created_at DESC, id DESC
488
+ LIMIT 20;
489
+
490
+ -- Next page (using last created_at and id from previous page)
491
+ SELECT * FROM orders
492
+ WHERE (created_at, id) < ('2024-01-15 10:30:00', 12345)
493
+ ORDER BY created_at DESC, id DESC
494
+ LIMIT 20;
495
+ ```
496
+
497
+ ---
498
+
499
+ ## Database-Specific Optimizations
500
+
501
+ ### PostgreSQL
502
+
503
+ ```sql
504
+ -- Use EXPLAIN ANALYZE to identify slow queries
505
+ EXPLAIN (ANALYZE, BUFFERS)
506
+ SELECT * FROM orders WHERE user_id = 123;
507
+
508
+ -- Use partial indexes for filtered queries
509
+ CREATE INDEX idx_active_users ON users(email) WHERE status = 'active';
510
+
511
+ -- Use VACUUM ANALYZE to update statistics
512
+ VACUUM ANALYZE orders;
513
+
514
+ -- Use parallel query execution
515
+ SET max_parallel_workers_per_gather = 4;
516
+
517
+ -- Use LATERAL joins for correlated subqueries
518
+ SELECT u.*, recent_orders.*
519
+ FROM users u
520
+ LEFT JOIN LATERAL (
521
+ SELECT * FROM orders WHERE user_id = u.id ORDER BY created_at DESC LIMIT 5
522
+ ) recent_orders ON true;
523
+ ```
524
+
525
+ ### MySQL
526
+
527
+ ```sql
528
+ -- Use EXPLAIN to analyze queries
529
+ EXPLAIN SELECT * FROM orders WHERE user_id = 123;
530
+
531
+ -- Use FORCE INDEX to force index usage
532
+ SELECT * FROM orders FORCE INDEX (idx_user_id) WHERE user_id = 123;
533
+
534
+ -- Use query cache (MySQL 5.7 and earlier)
535
+ SET GLOBAL query_cache_size = 268435456; -- 256MB
536
+
537
+ -- Optimize table to reclaim space
538
+ OPTIMIZE TABLE orders;
539
+
540
+ -- Analyze table to update statistics
541
+ ANALYZE TABLE orders;
542
+ ```
543
+
544
+ ### SQL Server
545
+
546
+ ```sql
547
+ -- Use execution plan
548
+ SET SHOWPLAN_TEXT ON;
549
+
550
+ -- Use query hints
551
+ SELECT * FROM orders WITH (INDEX(idx_user_id)) WHERE user_id = 123;
552
+
553
+ -- Update statistics
554
+ UPDATE STATISTICS orders;
555
+
556
+ -- Rebuild indexes
557
+ ALTER INDEX idx_user_id ON orders REBUILD;
558
+ ```
559
+
560
+ ---
561
+
562
+ ## Query Optimization Checklist
563
+
564
+ ### Before Writing Queries
565
+
566
+ - [ ] Understand the data model and relationships
567
+ - [ ] Identify required columns (avoid SELECT *)
568
+ - [ ] Check existing indexes
569
+ - [ ] Consider query frequency and data volume
570
+
571
+ ### While Writing Queries
572
+
573
+ - [ ] Use appropriate JOIN types
574
+ - [ ] Filter early (WHERE before JOIN when possible)
575
+ - [ ] Use indexes effectively
576
+ - [ ] Avoid functions on indexed columns
577
+ - [ ] Use prepared statements for security and performance
578
+
579
+ ### After Writing Queries
580
+
581
+ - [ ] Analyze execution plan
582
+ - [ ] Check for table scans on large tables
583
+ - [ ] Verify indexes are being used
584
+ - [ ] Test with production-like data volumes
585
+ - [ ] Monitor query performance in production
586
+
587
+ ### Optimization Techniques
588
+
589
+ - [ ] Add indexes on frequently queried columns
590
+ - [ ] Use covering indexes for index-only scans
591
+ - [ ] Rewrite subqueries as JOINs when appropriate
592
+ - [ ] Use batch loading to avoid N+1 queries
593
+ - [ ] Implement cursor-based pagination for large datasets
594
+ - [ ] Cache frequently accessed data
595
+ - [ ] Use materialized views for complex aggregations
596
+
597
+ ---
598
+
599
+ ## Related Documentation
600
+
601
+ - **relational-databases.md**: Relational database fundamentals
602
+ - **relational-indexing.md**: Indexing strategies
603
+ - **relational-schema-design.md**: Schema design and normalization
604
+ - **performance-optimization.md**: General performance optimization
605
+ - **relational-transactions.md**: Transaction management
606
+
607
+