@funnycode/myclaude 0.1.69 → 0.1.71

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 (497) hide show
  1. package/LICENSE +21 -21
  2. package/dist/SKILL-r7zmg5v7.md +3 -0
  3. package/dist/cli-mvr5k580.md +3 -0
  4. package/dist/myclaude.js +8870 -14056
  5. package/dist/myclaude.mjs +8870 -14056
  6. package/dist/server-zyhc2a9z.md +3 -0
  7. package/package.json +125 -125
  8. package/seed/marketplaces/ecc/.opencode/package-lock.json +169 -169
  9. package/seed/marketplaces/ecc/commands/aside.md +164 -164
  10. package/seed/marketplaces/ecc/commands/auto-update.md +28 -28
  11. package/seed/marketplaces/ecc/commands/build-fix.md +66 -66
  12. package/seed/marketplaces/ecc/commands/checkpoint.md +78 -78
  13. package/seed/marketplaces/ecc/commands/code-review.md +289 -289
  14. package/seed/marketplaces/ecc/commands/cost-report.md +107 -107
  15. package/seed/marketplaces/ecc/commands/cpp-build.md +173 -173
  16. package/seed/marketplaces/ecc/commands/cpp-review.md +132 -132
  17. package/seed/marketplaces/ecc/commands/cpp-test.md +251 -251
  18. package/seed/marketplaces/ecc/commands/ecc-guide.md +93 -93
  19. package/seed/marketplaces/ecc/commands/evolve.md +178 -178
  20. package/seed/marketplaces/ecc/commands/fastapi-review.md +39 -39
  21. package/seed/marketplaces/ecc/commands/feature-dev.md +49 -49
  22. package/seed/marketplaces/ecc/commands/flutter-build.md +164 -164
  23. package/seed/marketplaces/ecc/commands/flutter-review.md +116 -116
  24. package/seed/marketplaces/ecc/commands/flutter-test.md +144 -144
  25. package/seed/marketplaces/ecc/commands/gan-build.md +103 -103
  26. package/seed/marketplaces/ecc/commands/gan-design.md +39 -39
  27. package/seed/marketplaces/ecc/commands/go-build.md +183 -183
  28. package/seed/marketplaces/ecc/commands/go-review.md +148 -148
  29. package/seed/marketplaces/ecc/commands/go-test.md +268 -268
  30. package/seed/marketplaces/ecc/commands/gradle-build.md +70 -70
  31. package/seed/marketplaces/ecc/commands/harness-audit.md +84 -84
  32. package/seed/marketplaces/ecc/commands/hookify-configure.md +14 -14
  33. package/seed/marketplaces/ecc/commands/hookify-help.md +46 -46
  34. package/seed/marketplaces/ecc/commands/hookify-list.md +21 -21
  35. package/seed/marketplaces/ecc/commands/hookify.md +50 -50
  36. package/seed/marketplaces/ecc/commands/instinct-export.md +66 -66
  37. package/seed/marketplaces/ecc/commands/instinct-import.md +114 -114
  38. package/seed/marketplaces/ecc/commands/instinct-status.md +59 -59
  39. package/seed/marketplaces/ecc/commands/jira.md +106 -106
  40. package/seed/marketplaces/ecc/commands/kotlin-build.md +174 -174
  41. package/seed/marketplaces/ecc/commands/kotlin-review.md +140 -140
  42. package/seed/marketplaces/ecc/commands/kotlin-test.md +312 -312
  43. package/seed/marketplaces/ecc/commands/learn-eval.md +116 -116
  44. package/seed/marketplaces/ecc/commands/learn.md +74 -74
  45. package/seed/marketplaces/ecc/commands/loop-start.md +36 -36
  46. package/seed/marketplaces/ecc/commands/loop-status.md +77 -77
  47. package/seed/marketplaces/ecc/commands/marketing-campaign.md +129 -129
  48. package/seed/marketplaces/ecc/commands/model-route.md +30 -30
  49. package/seed/marketplaces/ecc/commands/multi-backend.md +162 -162
  50. package/seed/marketplaces/ecc/commands/multi-execute.md +319 -319
  51. package/seed/marketplaces/ecc/commands/multi-frontend.md +162 -162
  52. package/seed/marketplaces/ecc/commands/multi-plan.md +272 -272
  53. package/seed/marketplaces/ecc/commands/multi-workflow.md +195 -195
  54. package/seed/marketplaces/ecc/commands/plan-prd.md +160 -160
  55. package/seed/marketplaces/ecc/commands/plan.md +200 -200
  56. package/seed/marketplaces/ecc/commands/pm2.md +276 -276
  57. package/seed/marketplaces/ecc/commands/pr.md +184 -184
  58. package/seed/marketplaces/ecc/commands/project-init.md +86 -86
  59. package/seed/marketplaces/ecc/commands/projects.md +39 -39
  60. package/seed/marketplaces/ecc/commands/promote.md +41 -41
  61. package/seed/marketplaces/ecc/commands/prp-commit.md +112 -112
  62. package/seed/marketplaces/ecc/commands/prp-implement.md +385 -385
  63. package/seed/marketplaces/ecc/commands/prp-plan.md +502 -502
  64. package/seed/marketplaces/ecc/commands/prp-pr.md +184 -184
  65. package/seed/marketplaces/ecc/commands/prp-prd.md +447 -447
  66. package/seed/marketplaces/ecc/commands/prune.md +31 -31
  67. package/seed/marketplaces/ecc/commands/python-review.md +297 -297
  68. package/seed/marketplaces/ecc/commands/quality-gate.md +33 -33
  69. package/seed/marketplaces/ecc/commands/refactor-clean.md +84 -84
  70. package/seed/marketplaces/ecc/commands/resume-session.md +156 -156
  71. package/seed/marketplaces/ecc/commands/review-pr.md +37 -37
  72. package/seed/marketplaces/ecc/commands/rust-build.md +187 -187
  73. package/seed/marketplaces/ecc/commands/rust-review.md +142 -142
  74. package/seed/marketplaces/ecc/commands/rust-test.md +308 -308
  75. package/seed/marketplaces/ecc/commands/santa-loop.md +175 -175
  76. package/seed/marketplaces/ecc/commands/save-session.md +275 -275
  77. package/seed/marketplaces/ecc/commands/security-scan.md +92 -92
  78. package/seed/marketplaces/ecc/commands/sessions.md +339 -339
  79. package/seed/marketplaces/ecc/commands/setup-pm.md +80 -80
  80. package/seed/marketplaces/ecc/commands/skill-create.md +174 -174
  81. package/seed/marketplaces/ecc/commands/skill-health.md +54 -54
  82. package/seed/marketplaces/ecc/commands/test-coverage.md +73 -73
  83. package/seed/marketplaces/ecc/commands/update-codemaps.md +76 -76
  84. package/seed/marketplaces/ecc/commands/update-docs.md +88 -88
  85. package/seed/marketplaces/ecc/skills/accessibility/SKILL.md +146 -146
  86. package/seed/marketplaces/ecc/skills/agent-architecture-audit/SKILL.md +256 -256
  87. package/seed/marketplaces/ecc/skills/agent-eval/SKILL.md +145 -145
  88. package/seed/marketplaces/ecc/skills/agent-harness-construction/SKILL.md +73 -73
  89. package/seed/marketplaces/ecc/skills/agent-introspection-debugging/SKILL.md +153 -153
  90. package/seed/marketplaces/ecc/skills/agent-payment-x402/SKILL.md +224 -224
  91. package/seed/marketplaces/ecc/skills/agent-sort/SKILL.md +215 -215
  92. package/seed/marketplaces/ecc/skills/agentic-engineering/SKILL.md +63 -63
  93. package/seed/marketplaces/ecc/skills/agentic-os/SKILL.md +387 -387
  94. package/seed/marketplaces/ecc/skills/ai-first-engineering/SKILL.md +51 -51
  95. package/seed/marketplaces/ecc/skills/ai-regression-testing/SKILL.md +385 -385
  96. package/seed/marketplaces/ecc/skills/android-clean-architecture/SKILL.md +339 -339
  97. package/seed/marketplaces/ecc/skills/angular-developer/SKILL.md +154 -154
  98. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-animations.md +160 -160
  99. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-aria.md +410 -410
  100. package/seed/marketplaces/ecc/skills/angular-developer/references/cli.md +86 -86
  101. package/seed/marketplaces/ecc/skills/angular-developer/references/component-harnesses.md +59 -59
  102. package/seed/marketplaces/ecc/skills/angular-developer/references/component-styling.md +91 -91
  103. package/seed/marketplaces/ecc/skills/angular-developer/references/components.md +117 -117
  104. package/seed/marketplaces/ecc/skills/angular-developer/references/creating-services.md +97 -97
  105. package/seed/marketplaces/ecc/skills/angular-developer/references/data-resolvers.md +69 -69
  106. package/seed/marketplaces/ecc/skills/angular-developer/references/define-routes.md +67 -67
  107. package/seed/marketplaces/ecc/skills/angular-developer/references/defining-providers.md +72 -72
  108. package/seed/marketplaces/ecc/skills/angular-developer/references/di-fundamentals.md +120 -120
  109. package/seed/marketplaces/ecc/skills/angular-developer/references/e2e-testing.md +56 -56
  110. package/seed/marketplaces/ecc/skills/angular-developer/references/effects.md +83 -83
  111. package/seed/marketplaces/ecc/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  112. package/seed/marketplaces/ecc/skills/angular-developer/references/host-elements.md +80 -80
  113. package/seed/marketplaces/ecc/skills/angular-developer/references/injection-context.md +63 -63
  114. package/seed/marketplaces/ecc/skills/angular-developer/references/inputs.md +101 -101
  115. package/seed/marketplaces/ecc/skills/angular-developer/references/linked-signal.md +59 -59
  116. package/seed/marketplaces/ecc/skills/angular-developer/references/loading-strategies.md +61 -61
  117. package/seed/marketplaces/ecc/skills/angular-developer/references/mcp.md +108 -108
  118. package/seed/marketplaces/ecc/skills/angular-developer/references/navigate-to-routes.md +69 -69
  119. package/seed/marketplaces/ecc/skills/angular-developer/references/outputs.md +86 -86
  120. package/seed/marketplaces/ecc/skills/angular-developer/references/reactive-forms.md +122 -122
  121. package/seed/marketplaces/ecc/skills/angular-developer/references/rendering-strategies.md +44 -44
  122. package/seed/marketplaces/ecc/skills/angular-developer/references/resource.md +77 -77
  123. package/seed/marketplaces/ecc/skills/angular-developer/references/route-animations.md +56 -56
  124. package/seed/marketplaces/ecc/skills/angular-developer/references/route-guards.md +52 -52
  125. package/seed/marketplaces/ecc/skills/angular-developer/references/router-lifecycle.md +45 -45
  126. package/seed/marketplaces/ecc/skills/angular-developer/references/router-testing.md +87 -87
  127. package/seed/marketplaces/ecc/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  128. package/seed/marketplaces/ecc/skills/angular-developer/references/signal-forms.md +795 -795
  129. package/seed/marketplaces/ecc/skills/angular-developer/references/signals-overview.md +94 -94
  130. package/seed/marketplaces/ecc/skills/angular-developer/references/tailwind-css.md +69 -69
  131. package/seed/marketplaces/ecc/skills/angular-developer/references/template-driven-forms.md +114 -114
  132. package/seed/marketplaces/ecc/skills/angular-developer/references/testing-fundamentals.md +65 -65
  133. package/seed/marketplaces/ecc/skills/api-connector-builder/SKILL.md +120 -120
  134. package/seed/marketplaces/ecc/skills/api-design/SKILL.md +523 -523
  135. package/seed/marketplaces/ecc/skills/architecture-decision-records/SKILL.md +179 -179
  136. package/seed/marketplaces/ecc/skills/article-writing/SKILL.md +79 -79
  137. package/seed/marketplaces/ecc/skills/automation-audit-ops/SKILL.md +142 -142
  138. package/seed/marketplaces/ecc/skills/autonomous-agent-harness/SKILL.md +273 -273
  139. package/seed/marketplaces/ecc/skills/autonomous-loops/SKILL.md +610 -610
  140. package/seed/marketplaces/ecc/skills/backend-patterns/SKILL.md +561 -561
  141. package/seed/marketplaces/ecc/skills/benchmark/SKILL.md +93 -93
  142. package/seed/marketplaces/ecc/skills/benchmark-optimization-loop/SKILL.md +69 -69
  143. package/seed/marketplaces/ecc/skills/blender-motion-state-inspection/SKILL.md +164 -164
  144. package/seed/marketplaces/ecc/skills/blueprint/SKILL.md +105 -105
  145. package/seed/marketplaces/ecc/skills/brand-voice/SKILL.md +97 -97
  146. package/seed/marketplaces/ecc/skills/brand-voice/references/voice-profile-schema.md +55 -55
  147. package/seed/marketplaces/ecc/skills/browser-qa/SKILL.md +87 -87
  148. package/seed/marketplaces/ecc/skills/bun-runtime/SKILL.md +84 -84
  149. package/seed/marketplaces/ecc/skills/canary-watch/SKILL.md +107 -107
  150. package/seed/marketplaces/ecc/skills/carrier-relationship-management/SKILL.md +212 -212
  151. package/seed/marketplaces/ecc/skills/cisco-ios-patterns/SKILL.md +163 -163
  152. package/seed/marketplaces/ecc/skills/ck/SKILL.md +147 -147
  153. package/seed/marketplaces/ecc/skills/ck/commands/forget.mjs +44 -44
  154. package/seed/marketplaces/ecc/skills/ck/commands/info.mjs +24 -24
  155. package/seed/marketplaces/ecc/skills/ck/commands/init.mjs +143 -143
  156. package/seed/marketplaces/ecc/skills/ck/commands/list.mjs +40 -40
  157. package/seed/marketplaces/ecc/skills/ck/commands/migrate.mjs +202 -202
  158. package/seed/marketplaces/ecc/skills/ck/commands/resume.mjs +36 -36
  159. package/seed/marketplaces/ecc/skills/ck/commands/save.mjs +210 -210
  160. package/seed/marketplaces/ecc/skills/ck/commands/shared.mjs +387 -387
  161. package/seed/marketplaces/ecc/skills/ck/hooks/session-start.mjs +224 -224
  162. package/seed/marketplaces/ecc/skills/claude-devfleet/SKILL.md +103 -103
  163. package/seed/marketplaces/ecc/skills/click-path-audit/SKILL.md +244 -244
  164. package/seed/marketplaces/ecc/skills/clickhouse-io/SKILL.md +439 -439
  165. package/seed/marketplaces/ecc/skills/code-tour/SKILL.md +236 -236
  166. package/seed/marketplaces/ecc/skills/codebase-onboarding/SKILL.md +233 -233
  167. package/seed/marketplaces/ecc/skills/coding-standards/SKILL.md +549 -549
  168. package/seed/marketplaces/ecc/skills/compose-multiplatform-patterns/SKILL.md +299 -299
  169. package/seed/marketplaces/ecc/skills/configure-ecc/SKILL.md +384 -384
  170. package/seed/marketplaces/ecc/skills/connections-optimizer/SKILL.md +189 -189
  171. package/seed/marketplaces/ecc/skills/content-engine/SKILL.md +131 -131
  172. package/seed/marketplaces/ecc/skills/content-hash-cache-pattern/SKILL.md +161 -161
  173. package/seed/marketplaces/ecc/skills/context-budget/SKILL.md +135 -135
  174. package/seed/marketplaces/ecc/skills/continuous-agent-loop/SKILL.md +45 -45
  175. package/seed/marketplaces/ecc/skills/continuous-learning/SKILL.md +131 -131
  176. package/seed/marketplaces/ecc/skills/continuous-learning/config.json +18 -18
  177. package/seed/marketplaces/ecc/skills/continuous-learning/evaluate-session.sh +69 -69
  178. package/seed/marketplaces/ecc/skills/continuous-learning-v2/SKILL.md +360 -360
  179. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer-loop.sh +322 -322
  180. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer.md +198 -198
  181. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/session-guardian.sh +150 -150
  182. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/start-observer.sh +248 -248
  183. package/seed/marketplaces/ecc/skills/continuous-learning-v2/config.json +8 -8
  184. package/seed/marketplaces/ecc/skills/continuous-learning-v2/hooks/observe.sh +498 -498
  185. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/detect-project.sh +322 -322
  186. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/instinct-cli.py +1826 -1826
  187. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/lib/homunculus-dir.sh +31 -31
  188. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/migrate-homunculus.sh +62 -62
  189. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/test_parse_instinct.py +1018 -1018
  190. package/seed/marketplaces/ecc/skills/cost-aware-llm-pipeline/SKILL.md +183 -183
  191. package/seed/marketplaces/ecc/skills/cost-tracking/SKILL.md +147 -147
  192. package/seed/marketplaces/ecc/skills/council/SKILL.md +203 -203
  193. package/seed/marketplaces/ecc/skills/cpp-coding-standards/SKILL.md +723 -723
  194. package/seed/marketplaces/ecc/skills/cpp-testing/SKILL.md +324 -324
  195. package/seed/marketplaces/ecc/skills/crosspost/SKILL.md +111 -111
  196. package/seed/marketplaces/ecc/skills/csharp-testing/SKILL.md +321 -321
  197. package/seed/marketplaces/ecc/skills/customer-billing-ops/SKILL.md +140 -140
  198. package/seed/marketplaces/ecc/skills/customs-trade-compliance/SKILL.md +263 -263
  199. package/seed/marketplaces/ecc/skills/dart-flutter-patterns/SKILL.md +563 -563
  200. package/seed/marketplaces/ecc/skills/dashboard-builder/SKILL.md +108 -108
  201. package/seed/marketplaces/ecc/skills/data-scraper-agent/SKILL.md +764 -764
  202. package/seed/marketplaces/ecc/skills/data-throughput-accelerator/SKILL.md +72 -72
  203. package/seed/marketplaces/ecc/skills/database-migrations/SKILL.md +429 -429
  204. package/seed/marketplaces/ecc/skills/deep-research/SKILL.md +159 -159
  205. package/seed/marketplaces/ecc/skills/defi-amm-security/SKILL.md +166 -166
  206. package/seed/marketplaces/ecc/skills/deployment-patterns/SKILL.md +427 -427
  207. package/seed/marketplaces/ecc/skills/design-system/SKILL.md +82 -82
  208. package/seed/marketplaces/ecc/skills/django-celery/SKILL.md +457 -457
  209. package/seed/marketplaces/ecc/skills/django-patterns/SKILL.md +734 -734
  210. package/seed/marketplaces/ecc/skills/django-security/SKILL.md +593 -593
  211. package/seed/marketplaces/ecc/skills/django-tdd/SKILL.md +729 -729
  212. package/seed/marketplaces/ecc/skills/django-verification/SKILL.md +469 -469
  213. package/seed/marketplaces/ecc/skills/dmux-workflows/SKILL.md +191 -191
  214. package/seed/marketplaces/ecc/skills/docker-patterns/SKILL.md +364 -364
  215. package/seed/marketplaces/ecc/skills/documentation-lookup/SKILL.md +90 -90
  216. package/seed/marketplaces/ecc/skills/dotnet-patterns/SKILL.md +321 -321
  217. package/seed/marketplaces/ecc/skills/e2e-testing/SKILL.md +326 -326
  218. package/seed/marketplaces/ecc/skills/ecc-guide/SKILL.md +189 -189
  219. package/seed/marketplaces/ecc/skills/ecc-tools-cost-audit/SKILL.md +160 -160
  220. package/seed/marketplaces/ecc/skills/email-ops/SKILL.md +121 -121
  221. package/seed/marketplaces/ecc/skills/energy-procurement/SKILL.md +228 -228
  222. package/seed/marketplaces/ecc/skills/enterprise-agent-ops/SKILL.md +50 -50
  223. package/seed/marketplaces/ecc/skills/error-handling/SKILL.md +376 -376
  224. package/seed/marketplaces/ecc/skills/eval-harness/SKILL.md +270 -270
  225. package/seed/marketplaces/ecc/skills/evm-token-decimals/SKILL.md +130 -130
  226. package/seed/marketplaces/ecc/skills/exa-search/SKILL.md +107 -107
  227. package/seed/marketplaces/ecc/skills/fal-ai-media/SKILL.md +288 -288
  228. package/seed/marketplaces/ecc/skills/fastapi-patterns/SKILL.md +327 -327
  229. package/seed/marketplaces/ecc/skills/finance-billing-ops/SKILL.md +127 -127
  230. package/seed/marketplaces/ecc/skills/flox-environments/SKILL.md +496 -496
  231. package/seed/marketplaces/ecc/skills/flutter-dart-code-review/SKILL.md +435 -435
  232. package/seed/marketplaces/ecc/skills/foundation-models-on-device/SKILL.md +243 -243
  233. package/seed/marketplaces/ecc/skills/frontend-a11y/SKILL.md +446 -446
  234. package/seed/marketplaces/ecc/skills/frontend-design-direction/SKILL.md +92 -92
  235. package/seed/marketplaces/ecc/skills/frontend-patterns/SKILL.md +642 -642
  236. package/seed/marketplaces/ecc/skills/frontend-slides/SKILL.md +184 -184
  237. package/seed/marketplaces/ecc/skills/frontend-slides/STYLE_PRESETS.md +330 -330
  238. package/seed/marketplaces/ecc/skills/frontend-slides/animation-patterns.md +122 -122
  239. package/seed/marketplaces/ecc/skills/frontend-slides/html-template.md +419 -419
  240. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/export-pdf.sh +418 -418
  241. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/extract-pptx.py +96 -96
  242. package/seed/marketplaces/ecc/skills/frontend-slides/viewport-base.css +153 -153
  243. package/seed/marketplaces/ecc/skills/fsharp-testing/SKILL.md +280 -280
  244. package/seed/marketplaces/ecc/skills/gan-style-harness/SKILL.md +278 -278
  245. package/seed/marketplaces/ecc/skills/gateguard/SKILL.md +125 -125
  246. package/seed/marketplaces/ecc/skills/git-workflow/SKILL.md +715 -715
  247. package/seed/marketplaces/ecc/skills/github-ops/SKILL.md +144 -144
  248. package/seed/marketplaces/ecc/skills/golang-patterns/SKILL.md +674 -674
  249. package/seed/marketplaces/ecc/skills/golang-testing/SKILL.md +720 -720
  250. package/seed/marketplaces/ecc/skills/google-workspace-ops/SKILL.md +95 -95
  251. package/seed/marketplaces/ecc/skills/healthcare-cdss-patterns/SKILL.md +245 -245
  252. package/seed/marketplaces/ecc/skills/healthcare-emr-patterns/SKILL.md +159 -159
  253. package/seed/marketplaces/ecc/skills/healthcare-eval-harness/SKILL.md +207 -207
  254. package/seed/marketplaces/ecc/skills/healthcare-phi-compliance/SKILL.md +145 -145
  255. package/seed/marketplaces/ecc/skills/hermes-imports/SKILL.md +88 -88
  256. package/seed/marketplaces/ecc/skills/hexagonal-architecture/SKILL.md +276 -276
  257. package/seed/marketplaces/ecc/skills/hipaa-compliance/SKILL.md +78 -78
  258. package/seed/marketplaces/ecc/skills/homelab-network-readiness/SKILL.md +169 -169
  259. package/seed/marketplaces/ecc/skills/homelab-network-setup/SKILL.md +129 -129
  260. package/seed/marketplaces/ecc/skills/homelab-pihole-dns/SKILL.md +274 -274
  261. package/seed/marketplaces/ecc/skills/homelab-vlan-segmentation/SKILL.md +311 -311
  262. package/seed/marketplaces/ecc/skills/homelab-wireguard-vpn/SKILL.md +305 -305
  263. package/seed/marketplaces/ecc/skills/hookify-rules/SKILL.md +128 -128
  264. package/seed/marketplaces/ecc/skills/inventory-demand-planning/SKILL.md +247 -247
  265. package/seed/marketplaces/ecc/skills/investor-materials/SKILL.md +96 -96
  266. package/seed/marketplaces/ecc/skills/investor-outreach/SKILL.md +91 -91
  267. package/seed/marketplaces/ecc/skills/ios-icon-gen/SKILL.md +157 -157
  268. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/generate_icons.swift +258 -258
  269. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/iconify_gen.sh +235 -235
  270. package/seed/marketplaces/ecc/skills/iterative-retrieval/SKILL.md +211 -211
  271. package/seed/marketplaces/ecc/skills/ito-basket-compare/SKILL.md +63 -63
  272. package/seed/marketplaces/ecc/skills/ito-data-atlas-agent/SKILL.md +63 -63
  273. package/seed/marketplaces/ecc/skills/ito-market-intelligence/SKILL.md +60 -60
  274. package/seed/marketplaces/ecc/skills/ito-trade-planner/SKILL.md +67 -67
  275. package/seed/marketplaces/ecc/skills/java-coding-standards/SKILL.md +383 -383
  276. package/seed/marketplaces/ecc/skills/jira-integration/SKILL.md +293 -293
  277. package/seed/marketplaces/ecc/skills/jpa-patterns/SKILL.md +151 -151
  278. package/seed/marketplaces/ecc/skills/knowledge-ops/SKILL.md +154 -154
  279. package/seed/marketplaces/ecc/skills/kotlin-coroutines-flows/SKILL.md +284 -284
  280. package/seed/marketplaces/ecc/skills/kotlin-exposed-patterns/SKILL.md +719 -719
  281. package/seed/marketplaces/ecc/skills/kotlin-ktor-patterns/SKILL.md +689 -689
  282. package/seed/marketplaces/ecc/skills/kotlin-patterns/SKILL.md +711 -711
  283. package/seed/marketplaces/ecc/skills/kotlin-testing/SKILL.md +824 -824
  284. package/seed/marketplaces/ecc/skills/laravel-patterns/SKILL.md +415 -415
  285. package/seed/marketplaces/ecc/skills/laravel-plugin-discovery/SKILL.md +229 -229
  286. package/seed/marketplaces/ecc/skills/laravel-security/SKILL.md +285 -285
  287. package/seed/marketplaces/ecc/skills/laravel-tdd/SKILL.md +283 -283
  288. package/seed/marketplaces/ecc/skills/laravel-verification/SKILL.md +179 -179
  289. package/seed/marketplaces/ecc/skills/latency-critical-systems/SKILL.md +73 -73
  290. package/seed/marketplaces/ecc/skills/lead-intelligence/SKILL.md +321 -321
  291. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/enrichment-agent.md +85 -85
  292. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/mutual-mapper.md +75 -75
  293. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/outreach-drafter.md +98 -98
  294. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/signal-scorer.md +60 -60
  295. package/seed/marketplaces/ecc/skills/liquid-glass-design/SKILL.md +279 -279
  296. package/seed/marketplaces/ecc/skills/llm-trading-agent-security/SKILL.md +146 -146
  297. package/seed/marketplaces/ecc/skills/logistics-exception-management/SKILL.md +222 -222
  298. package/seed/marketplaces/ecc/skills/make-interfaces-feel-better/SKILL.md +151 -151
  299. package/seed/marketplaces/ecc/skills/manim-video/SKILL.md +89 -89
  300. package/seed/marketplaces/ecc/skills/manim-video/assets/network_graph_scene.py +52 -52
  301. package/seed/marketplaces/ecc/skills/market-research/SKILL.md +75 -75
  302. package/seed/marketplaces/ecc/skills/marketing-campaign/SKILL.md +113 -113
  303. package/seed/marketplaces/ecc/skills/mcp-server-patterns/SKILL.md +69 -69
  304. package/seed/marketplaces/ecc/skills/messages-ops/SKILL.md +104 -104
  305. package/seed/marketplaces/ecc/skills/mle-workflow/SKILL.md +346 -346
  306. package/seed/marketplaces/ecc/skills/motion-advanced/SKILL.md +596 -596
  307. package/seed/marketplaces/ecc/skills/motion-foundations/SKILL.md +299 -299
  308. package/seed/marketplaces/ecc/skills/motion-patterns/SKILL.md +435 -435
  309. package/seed/marketplaces/ecc/skills/motion-ui/SKILL.md +575 -575
  310. package/seed/marketplaces/ecc/skills/mysql-patterns/SKILL.md +412 -412
  311. package/seed/marketplaces/ecc/skills/nanoclaw-repl/SKILL.md +33 -33
  312. package/seed/marketplaces/ecc/skills/nestjs-patterns/SKILL.md +230 -230
  313. package/seed/marketplaces/ecc/skills/netmiko-ssh-automation/SKILL.md +173 -173
  314. package/seed/marketplaces/ecc/skills/network-bgp-diagnostics/SKILL.md +167 -167
  315. package/seed/marketplaces/ecc/skills/network-config-validation/SKILL.md +210 -210
  316. package/seed/marketplaces/ecc/skills/network-interface-health/SKILL.md +152 -152
  317. package/seed/marketplaces/ecc/skills/nextjs-turbopack/SKILL.md +57 -57
  318. package/seed/marketplaces/ecc/skills/nodejs-keccak256/SKILL.md +102 -102
  319. package/seed/marketplaces/ecc/skills/nutrient-document-processing/SKILL.md +167 -167
  320. package/seed/marketplaces/ecc/skills/nuxt4-patterns/SKILL.md +100 -100
  321. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/SKILL.md +288 -288
  322. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.py +224 -224
  323. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.sh +5 -5
  324. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  325. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  326. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  327. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  328. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  329. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/output-template.md +166 -166
  330. package/seed/marketplaces/ecc/skills/opensource-pipeline/SKILL.md +255 -255
  331. package/seed/marketplaces/ecc/skills/parallel-execution-optimizer/SKILL.md +72 -72
  332. package/seed/marketplaces/ecc/skills/perl-patterns/SKILL.md +504 -504
  333. package/seed/marketplaces/ecc/skills/perl-security/SKILL.md +503 -503
  334. package/seed/marketplaces/ecc/skills/perl-testing/SKILL.md +475 -475
  335. package/seed/marketplaces/ecc/skills/plan-orchestrate/SKILL.md +262 -262
  336. package/seed/marketplaces/ecc/skills/plankton-code-quality/SKILL.md +236 -236
  337. package/seed/marketplaces/ecc/skills/postgres-patterns/SKILL.md +147 -147
  338. package/seed/marketplaces/ecc/skills/prediction-market-oracle-research/SKILL.md +63 -63
  339. package/seed/marketplaces/ecc/skills/prediction-market-risk-review/SKILL.md +60 -60
  340. package/seed/marketplaces/ecc/skills/prisma-patterns/SKILL.md +371 -371
  341. package/seed/marketplaces/ecc/skills/product-capability/SKILL.md +141 -141
  342. package/seed/marketplaces/ecc/skills/product-lens/SKILL.md +92 -92
  343. package/seed/marketplaces/ecc/skills/production-audit/SKILL.md +206 -206
  344. package/seed/marketplaces/ecc/skills/production-scheduling/SKILL.md +238 -238
  345. package/seed/marketplaces/ecc/skills/project-flow-ops/SKILL.md +111 -111
  346. package/seed/marketplaces/ecc/skills/prompt-optimizer/SKILL.md +398 -398
  347. package/seed/marketplaces/ecc/skills/python-patterns/SKILL.md +750 -750
  348. package/seed/marketplaces/ecc/skills/python-testing/SKILL.md +816 -816
  349. package/seed/marketplaces/ecc/skills/pytorch-patterns/SKILL.md +396 -396
  350. package/seed/marketplaces/ecc/skills/quality-nonconformance/SKILL.md +260 -260
  351. package/seed/marketplaces/ecc/skills/quarkus-patterns/SKILL.md +722 -722
  352. package/seed/marketplaces/ecc/skills/quarkus-security/SKILL.md +467 -467
  353. package/seed/marketplaces/ecc/skills/quarkus-tdd/SKILL.md +811 -811
  354. package/seed/marketplaces/ecc/skills/quarkus-verification/SKILL.md +479 -479
  355. package/seed/marketplaces/ecc/skills/ralphinho-rfc-pipeline/SKILL.md +67 -67
  356. package/seed/marketplaces/ecc/skills/recsys-pipeline-architect/SKILL.md +114 -114
  357. package/seed/marketplaces/ecc/skills/recursive-decision-ledger/SKILL.md +79 -79
  358. package/seed/marketplaces/ecc/skills/redis-patterns/SKILL.md +403 -403
  359. package/seed/marketplaces/ecc/skills/regex-vs-llm-structured-text/SKILL.md +220 -220
  360. package/seed/marketplaces/ecc/skills/remotion-video-creation/SKILL.md +43 -43
  361. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/3d.md +86 -86
  362. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/animations.md +29 -29
  363. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/charts-bar-chart.tsx +173 -173
  364. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-typewriter.tsx +100 -100
  365. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-word-highlight.tsx +108 -108
  366. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets.md +78 -78
  367. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/audio.md +172 -172
  368. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/calculate-metadata.md +104 -104
  369. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/can-decode.md +75 -75
  370. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/charts.md +58 -58
  371. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/compositions.md +146 -146
  372. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/display-captions.md +126 -126
  373. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/extract-frames.md +229 -229
  374. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/fonts.md +152 -152
  375. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-audio-duration.md +58 -58
  376. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-dimensions.md +68 -68
  377. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-duration.md +58 -58
  378. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/gifs.md +138 -138
  379. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/images.md +130 -130
  380. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/import-srt-captions.md +67 -67
  381. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/lottie.md +67 -67
  382. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-dom-nodes.md +34 -34
  383. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-text.md +143 -143
  384. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/sequencing.md +106 -106
  385. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/tailwind.md +11 -11
  386. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/text-animations.md +20 -20
  387. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/timing.md +179 -179
  388. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transcribe-captions.md +19 -19
  389. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transitions.md +122 -122
  390. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/trimming.md +52 -52
  391. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/videos.md +171 -171
  392. package/seed/marketplaces/ecc/skills/repo-scan/SKILL.md +78 -78
  393. package/seed/marketplaces/ecc/skills/research-ops/SKILL.md +112 -112
  394. package/seed/marketplaces/ecc/skills/returns-reverse-logistics/SKILL.md +240 -240
  395. package/seed/marketplaces/ecc/skills/rules-distill/SKILL.md +264 -264
  396. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-rules.sh +58 -58
  397. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-skills.sh +129 -129
  398. package/seed/marketplaces/ecc/skills/rust-patterns/SKILL.md +499 -499
  399. package/seed/marketplaces/ecc/skills/rust-testing/SKILL.md +500 -500
  400. package/seed/marketplaces/ecc/skills/safety-guard/SKILL.md +75 -75
  401. package/seed/marketplaces/ecc/skills/santa-method/SKILL.md +306 -306
  402. package/seed/marketplaces/ecc/skills/scientific-db-pubmed-database/SKILL.md +175 -175
  403. package/seed/marketplaces/ecc/skills/scientific-db-uspto-database/SKILL.md +177 -177
  404. package/seed/marketplaces/ecc/skills/scientific-pkg-gget/SKILL.md +166 -166
  405. package/seed/marketplaces/ecc/skills/scientific-thinking-literature-review/SKILL.md +192 -192
  406. package/seed/marketplaces/ecc/skills/scientific-thinking-scholar-evaluation/SKILL.md +160 -160
  407. package/seed/marketplaces/ecc/skills/search-first/SKILL.md +182 -182
  408. package/seed/marketplaces/ecc/skills/security-bounty-hunter/SKILL.md +99 -99
  409. package/seed/marketplaces/ecc/skills/security-review/SKILL.md +503 -503
  410. package/seed/marketplaces/ecc/skills/security-review/cloud-infrastructure-security.md +361 -361
  411. package/seed/marketplaces/ecc/skills/security-scan/SKILL.md +165 -165
  412. package/seed/marketplaces/ecc/skills/seo/SKILL.md +154 -154
  413. package/seed/marketplaces/ecc/skills/skill-comply/SKILL.md +58 -58
  414. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/compliant_trace.jsonl +5 -5
  415. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/noncompliant_trace.jsonl +3 -3
  416. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/tdd_spec.yaml +44 -44
  417. package/seed/marketplaces/ecc/skills/skill-comply/prompts/classifier.md +24 -24
  418. package/seed/marketplaces/ecc/skills/skill-comply/prompts/scenario_generator.md +62 -62
  419. package/seed/marketplaces/ecc/skills/skill-comply/prompts/spec_generator.md +42 -42
  420. package/seed/marketplaces/ecc/skills/skill-comply/pyproject.toml +15 -15
  421. package/seed/marketplaces/ecc/skills/skill-comply/scripts/classifier.py +85 -85
  422. package/seed/marketplaces/ecc/skills/skill-comply/scripts/grader.py +124 -124
  423. package/seed/marketplaces/ecc/skills/skill-comply/scripts/parser.py +107 -107
  424. package/seed/marketplaces/ecc/skills/skill-comply/scripts/report.py +170 -170
  425. package/seed/marketplaces/ecc/skills/skill-comply/scripts/run.py +127 -127
  426. package/seed/marketplaces/ecc/skills/skill-comply/scripts/runner.py +186 -186
  427. package/seed/marketplaces/ecc/skills/skill-comply/scripts/scenario_generator.py +70 -70
  428. package/seed/marketplaces/ecc/skills/skill-comply/scripts/spec_generator.py +72 -72
  429. package/seed/marketplaces/ecc/skills/skill-comply/scripts/utils.py +13 -13
  430. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_grader.py +197 -197
  431. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_parser.py +90 -90
  432. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_runner.py +172 -172
  433. package/seed/marketplaces/ecc/skills/skill-scout/SKILL.md +140 -140
  434. package/seed/marketplaces/ecc/skills/skill-stocktake/SKILL.md +194 -194
  435. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/quick-diff.sh +87 -87
  436. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/save-results.sh +56 -56
  437. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/scan.sh +170 -170
  438. package/seed/marketplaces/ecc/skills/social-graph-ranker/SKILL.md +154 -154
  439. package/seed/marketplaces/ecc/skills/social-publisher/SKILL.md +115 -115
  440. package/seed/marketplaces/ecc/skills/springboot-patterns/SKILL.md +314 -314
  441. package/seed/marketplaces/ecc/skills/springboot-security/SKILL.md +272 -272
  442. package/seed/marketplaces/ecc/skills/springboot-tdd/SKILL.md +158 -158
  443. package/seed/marketplaces/ecc/skills/springboot-verification/SKILL.md +231 -231
  444. package/seed/marketplaces/ecc/skills/strategic-compact/SKILL.md +131 -131
  445. package/seed/marketplaces/ecc/skills/swift-actor-persistence/SKILL.md +143 -143
  446. package/seed/marketplaces/ecc/skills/swift-concurrency-6-2/SKILL.md +216 -216
  447. package/seed/marketplaces/ecc/skills/swift-protocol-di-testing/SKILL.md +190 -190
  448. package/seed/marketplaces/ecc/skills/swiftui-patterns/SKILL.md +259 -259
  449. package/seed/marketplaces/ecc/skills/tdd-workflow/SKILL.md +463 -463
  450. package/seed/marketplaces/ecc/skills/team-builder/SKILL.md +168 -168
  451. package/seed/marketplaces/ecc/skills/terminal-ops/SKILL.md +109 -109
  452. package/seed/marketplaces/ecc/skills/tinystruct-patterns/SKILL.md +203 -203
  453. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/architecture.md +90 -90
  454. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/data-handling.md +60 -60
  455. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/database.md +99 -99
  456. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/routing.md +64 -64
  457. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/system-usage.md +97 -97
  458. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/testing.md +72 -72
  459. package/seed/marketplaces/ecc/skills/token-budget-advisor/SKILL.md +133 -133
  460. package/seed/marketplaces/ecc/skills/ui-demo/SKILL.md +465 -465
  461. package/seed/marketplaces/ecc/skills/ui-to-vue/SKILL.md +134 -134
  462. package/seed/marketplaces/ecc/skills/uncloud/SKILL.md +343 -343
  463. package/seed/marketplaces/ecc/skills/unified-notifications-ops/SKILL.md +187 -187
  464. package/seed/marketplaces/ecc/skills/verification-loop/SKILL.md +126 -126
  465. package/seed/marketplaces/ecc/skills/video-editing/SKILL.md +310 -310
  466. package/seed/marketplaces/ecc/skills/videodb/SKILL.md +374 -374
  467. package/seed/marketplaces/ecc/skills/videodb/reference/api-reference.md +550 -550
  468. package/seed/marketplaces/ecc/skills/videodb/reference/capture-reference.md +407 -407
  469. package/seed/marketplaces/ecc/skills/videodb/reference/capture.md +101 -101
  470. package/seed/marketplaces/ecc/skills/videodb/reference/editor.md +443 -443
  471. package/seed/marketplaces/ecc/skills/videodb/reference/generative.md +331 -331
  472. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream-reference.md +564 -564
  473. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream.md +65 -65
  474. package/seed/marketplaces/ecc/skills/videodb/reference/search.md +230 -230
  475. package/seed/marketplaces/ecc/skills/videodb/reference/streaming.md +406 -406
  476. package/seed/marketplaces/ecc/skills/videodb/reference/use-cases.md +118 -118
  477. package/seed/marketplaces/ecc/skills/videodb/scripts/ws_listener.py +282 -282
  478. package/seed/marketplaces/ecc/skills/visa-doc-translate/README.md +86 -86
  479. package/seed/marketplaces/ecc/skills/visa-doc-translate/SKILL.md +117 -117
  480. package/seed/marketplaces/ecc/skills/vite-patterns/SKILL.md +449 -449
  481. package/seed/marketplaces/ecc/skills/windows-desktop-e2e/SKILL.md +887 -887
  482. package/seed/marketplaces/ecc/skills/workspace-surface-audit/SKILL.md +125 -125
  483. package/seed/marketplaces/ecc/skills/x-api/SKILL.md +234 -234
  484. package/seed/marketplaces/ecc/.claude/commands/add-language-rules.md +0 -39
  485. package/seed/marketplaces/ecc/.claude/commands/database-migration.md +0 -36
  486. package/seed/marketplaces/ecc/.claude/commands/feature-development.md +0 -38
  487. package/seed/marketplaces/ecc/.claude/ecc-tools.json +0 -334
  488. package/seed/marketplaces/ecc/.claude/enterprise/controls.md +0 -15
  489. package/seed/marketplaces/ecc/.claude/homunculus/instincts/inherited/everything-claude-code-instincts.yaml +0 -162
  490. package/seed/marketplaces/ecc/.claude/identity.json +0 -14
  491. package/seed/marketplaces/ecc/.claude/package-manager.json +0 -4
  492. package/seed/marketplaces/ecc/.claude/research/everything-claude-code-research-playbook.md +0 -21
  493. package/seed/marketplaces/ecc/.claude/rules/everything-claude-code-guardrails.md +0 -43
  494. package/seed/marketplaces/ecc/.claude/rules/node.md +0 -56
  495. package/seed/marketplaces/ecc/.claude/skills/everything-claude-code/SKILL.md +0 -442
  496. package/seed/marketplaces/ecc/.claude/team/everything-claude-code-team-config.json +0 -15
  497. package/seed/marketplaces/ecc/.vscode/settings.json +0 -17
@@ -1,734 +1,734 @@
1
- ---
2
- name: django-patterns
3
- description: Django architecture patterns, REST API design with DRF, ORM best practices, caching, signals, middleware, and production-grade Django apps.
4
- origin: ECC
5
- ---
6
-
7
- # Django Development Patterns
8
-
9
- Production-grade Django architecture patterns for scalable, maintainable applications.
10
-
11
- ## When to Activate
12
-
13
- - Building Django web applications
14
- - Designing Django REST Framework APIs
15
- - Working with Django ORM and models
16
- - Setting up Django project structure
17
- - Implementing caching, signals, middleware
18
-
19
- ## Project Structure
20
-
21
- ### Recommended Layout
22
-
23
- ```
24
- myproject/
25
- ├── config/
26
- │ ├── __init__.py
27
- │ ├── settings/
28
- │ │ ├── __init__.py
29
- │ │ ├── base.py # Base settings
30
- │ │ ├── development.py # Dev settings
31
- │ │ ├── production.py # Production settings
32
- │ │ └── test.py # Test settings
33
- │ ├── urls.py
34
- │ ├── wsgi.py
35
- │ └── asgi.py
36
- ├── manage.py
37
- └── apps/
38
- ├── __init__.py
39
- ├── users/
40
- │ ├── __init__.py
41
- │ ├── models.py
42
- │ ├── views.py
43
- │ ├── serializers.py
44
- │ ├── urls.py
45
- │ ├── permissions.py
46
- │ ├── filters.py
47
- │ ├── services.py
48
- │ └── tests/
49
- └── products/
50
- └── ...
51
- ```
52
-
53
- ### Split Settings Pattern
54
-
55
- ```python
56
- # config/settings/base.py
57
- from pathlib import Path
58
-
59
- BASE_DIR = Path(__file__).resolve().parent.parent.parent
60
-
61
- SECRET_KEY = env('DJANGO_SECRET_KEY')
62
- DEBUG = False
63
- ALLOWED_HOSTS = []
64
-
65
- INSTALLED_APPS = [
66
- 'django.contrib.admin',
67
- 'django.contrib.auth',
68
- 'django.contrib.contenttypes',
69
- 'django.contrib.sessions',
70
- 'django.contrib.messages',
71
- 'django.contrib.staticfiles',
72
- 'rest_framework',
73
- 'rest_framework.authtoken',
74
- 'corsheaders',
75
- # Local apps
76
- 'apps.users',
77
- 'apps.products',
78
- ]
79
-
80
- MIDDLEWARE = [
81
- 'django.middleware.security.SecurityMiddleware',
82
- 'whitenoise.middleware.WhiteNoiseMiddleware',
83
- 'django.contrib.sessions.middleware.SessionMiddleware',
84
- 'corsheaders.middleware.CorsMiddleware',
85
- 'django.middleware.common.CommonMiddleware',
86
- 'django.middleware.csrf.CsrfViewMiddleware',
87
- 'django.contrib.auth.middleware.AuthenticationMiddleware',
88
- 'django.contrib.messages.middleware.MessageMiddleware',
89
- 'django.middleware.clickjacking.XFrameOptionsMiddleware',
90
- ]
91
-
92
- ROOT_URLCONF = 'config.urls'
93
- WSGI_APPLICATION = 'config.wsgi.application'
94
-
95
- DATABASES = {
96
- 'default': {
97
- 'ENGINE': 'django.db.backends.postgresql',
98
- 'NAME': env('DB_NAME'),
99
- 'USER': env('DB_USER'),
100
- 'PASSWORD': env('DB_PASSWORD'),
101
- 'HOST': env('DB_HOST'),
102
- 'PORT': env('DB_PORT', default='5432'),
103
- }
104
- }
105
-
106
- # config/settings/development.py
107
- from .base import *
108
-
109
- DEBUG = True
110
- ALLOWED_HOSTS = ['localhost', '127.0.0.1']
111
-
112
- DATABASES['default']['NAME'] = 'myproject_dev'
113
-
114
- INSTALLED_APPS += ['debug_toolbar']
115
-
116
- MIDDLEWARE += ['debug_toolbar.middleware.DebugToolbarMiddleware']
117
-
118
- EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'
119
-
120
- # config/settings/production.py
121
- from .base import *
122
-
123
- DEBUG = False
124
- ALLOWED_HOSTS = env.list('ALLOWED_HOSTS')
125
- SECURE_SSL_REDIRECT = True
126
- SESSION_COOKIE_SECURE = True
127
- CSRF_COOKIE_SECURE = True
128
- SECURE_HSTS_SECONDS = 31536000
129
- SECURE_HSTS_INCLUDE_SUBDOMAINS = True
130
- SECURE_HSTS_PRELOAD = True
131
-
132
- # Logging
133
- LOGGING = {
134
- 'version': 1,
135
- 'disable_existing_loggers': False,
136
- 'handlers': {
137
- 'file': {
138
- 'level': 'WARNING',
139
- 'class': 'logging.FileHandler',
140
- 'filename': '/var/log/django/django.log',
141
- },
142
- },
143
- 'loggers': {
144
- 'django': {
145
- 'handlers': ['file'],
146
- 'level': 'WARNING',
147
- 'propagate': True,
148
- },
149
- },
150
- }
151
- ```
152
-
153
- ## Model Design Patterns
154
-
155
- ### Model Best Practices
156
-
157
- ```python
158
- from django.db import models
159
- from django.contrib.auth.models import AbstractUser
160
- from django.core.validators import MinValueValidator, MaxValueValidator
161
-
162
- class User(AbstractUser):
163
- """Custom user model extending AbstractUser."""
164
- email = models.EmailField(unique=True)
165
- phone = models.CharField(max_length=20, blank=True)
166
- birth_date = models.DateField(null=True, blank=True)
167
-
168
- USERNAME_FIELD = 'email'
169
- REQUIRED_FIELDS = ['username']
170
-
171
- class Meta:
172
- db_table = 'users'
173
- verbose_name = 'user'
174
- verbose_name_plural = 'users'
175
- ordering = ['-date_joined']
176
-
177
- def __str__(self):
178
- return self.email
179
-
180
- def get_full_name(self):
181
- return f"{self.first_name} {self.last_name}".strip()
182
-
183
- class Product(models.Model):
184
- """Product model with proper field configuration."""
185
- name = models.CharField(max_length=200)
186
- slug = models.SlugField(unique=True, max_length=250)
187
- description = models.TextField(blank=True)
188
- price = models.DecimalField(
189
- max_digits=10,
190
- decimal_places=2,
191
- validators=[MinValueValidator(0)]
192
- )
193
- stock = models.PositiveIntegerField(default=0)
194
- is_active = models.BooleanField(default=True)
195
- category = models.ForeignKey(
196
- 'Category',
197
- on_delete=models.CASCADE,
198
- related_name='products'
199
- )
200
- tags = models.ManyToManyField('Tag', blank=True, related_name='products')
201
- created_at = models.DateTimeField(auto_now_add=True)
202
- updated_at = models.DateTimeField(auto_now=True)
203
-
204
- class Meta:
205
- db_table = 'products'
206
- ordering = ['-created_at']
207
- indexes = [
208
- models.Index(fields=['slug']),
209
- models.Index(fields=['-created_at']),
210
- models.Index(fields=['category', 'is_active']),
211
- ]
212
- constraints = [
213
- models.CheckConstraint(
214
- check=models.Q(price__gte=0),
215
- name='price_non_negative'
216
- )
217
- ]
218
-
219
- def __str__(self):
220
- return self.name
221
-
222
- def save(self, *args, **kwargs):
223
- if not self.slug:
224
- self.slug = slugify(self.name)
225
- super().save(*args, **kwargs)
226
- ```
227
-
228
- ### QuerySet Best Practices
229
-
230
- ```python
231
- from django.db import models
232
-
233
- class ProductQuerySet(models.QuerySet):
234
- """Custom QuerySet for Product model."""
235
-
236
- def active(self):
237
- """Return only active products."""
238
- return self.filter(is_active=True)
239
-
240
- def with_category(self):
241
- """Select related category to avoid N+1 queries."""
242
- return self.select_related('category')
243
-
244
- def with_tags(self):
245
- """Prefetch tags for many-to-many relationship."""
246
- return self.prefetch_related('tags')
247
-
248
- def in_stock(self):
249
- """Return products with stock > 0."""
250
- return self.filter(stock__gt=0)
251
-
252
- def search(self, query):
253
- """Search products by name or description."""
254
- return self.filter(
255
- models.Q(name__icontains=query) |
256
- models.Q(description__icontains=query)
257
- )
258
-
259
- class Product(models.Model):
260
- # ... fields ...
261
-
262
- objects = ProductQuerySet.as_manager() # Use custom QuerySet
263
-
264
- # Usage
265
- Product.objects.active().with_category().in_stock()
266
- ```
267
-
268
- ### Manager Methods
269
-
270
- ```python
271
- class ProductManager(models.Manager):
272
- """Custom manager for complex queries."""
273
-
274
- def get_or_none(self, **kwargs):
275
- """Return object or None instead of DoesNotExist."""
276
- try:
277
- return self.get(**kwargs)
278
- except self.model.DoesNotExist:
279
- return None
280
-
281
- def create_with_tags(self, name, price, tag_names):
282
- """Create product with associated tags."""
283
- product = self.create(name=name, price=price)
284
- tags = [Tag.objects.get_or_create(name=name)[0] for name in tag_names]
285
- product.tags.set(tags)
286
- return product
287
-
288
- def bulk_update_stock(self, product_ids, quantity):
289
- """Bulk update stock for multiple products."""
290
- return self.filter(id__in=product_ids).update(stock=quantity)
291
-
292
- # In model
293
- class Product(models.Model):
294
- # ... fields ...
295
- custom = ProductManager()
296
- ```
297
-
298
- ## Django REST Framework Patterns
299
-
300
- ### Serializer Patterns
301
-
302
- ```python
303
- from rest_framework import serializers
304
- from django.contrib.auth.password_validation import validate_password
305
- from .models import Product, User
306
-
307
- class ProductSerializer(serializers.ModelSerializer):
308
- """Serializer for Product model."""
309
-
310
- category_name = serializers.CharField(source='category.name', read_only=True)
311
- average_rating = serializers.FloatField(read_only=True)
312
- discount_price = serializers.SerializerMethodField()
313
-
314
- class Meta:
315
- model = Product
316
- fields = [
317
- 'id', 'name', 'slug', 'description', 'price',
318
- 'discount_price', 'stock', 'category_name',
319
- 'average_rating', 'created_at'
320
- ]
321
- read_only_fields = ['id', 'slug', 'created_at']
322
-
323
- def get_discount_price(self, obj):
324
- """Calculate discount price if applicable."""
325
- if hasattr(obj, 'discount') and obj.discount:
326
- return obj.price * (1 - obj.discount.percent / 100)
327
- return obj.price
328
-
329
- def validate_price(self, value):
330
- """Ensure price is non-negative."""
331
- if value < 0:
332
- raise serializers.ValidationError("Price cannot be negative.")
333
- return value
334
-
335
- class ProductCreateSerializer(serializers.ModelSerializer):
336
- """Serializer for creating products."""
337
-
338
- class Meta:
339
- model = Product
340
- fields = ['name', 'description', 'price', 'stock', 'category']
341
-
342
- def validate(self, data):
343
- """Custom validation for multiple fields."""
344
- if data['price'] > 10000 and data['stock'] > 100:
345
- raise serializers.ValidationError(
346
- "Cannot have high-value products with large stock."
347
- )
348
- return data
349
-
350
- class UserRegistrationSerializer(serializers.ModelSerializer):
351
- """Serializer for user registration."""
352
-
353
- password = serializers.CharField(
354
- write_only=True,
355
- required=True,
356
- validators=[validate_password],
357
- style={'input_type': 'password'}
358
- )
359
- password_confirm = serializers.CharField(write_only=True, style={'input_type': 'password'})
360
-
361
- class Meta:
362
- model = User
363
- fields = ['email', 'username', 'password', 'password_confirm']
364
-
365
- def validate(self, data):
366
- """Validate passwords match."""
367
- if data['password'] != data['password_confirm']:
368
- raise serializers.ValidationError({
369
- "password_confirm": "Password fields didn't match."
370
- })
371
- return data
372
-
373
- def create(self, validated_data):
374
- """Create user with hashed password."""
375
- validated_data.pop('password_confirm')
376
- password = validated_data.pop('password')
377
- user = User.objects.create(**validated_data)
378
- user.set_password(password)
379
- user.save()
380
- return user
381
- ```
382
-
383
- ### ViewSet Patterns
384
-
385
- ```python
386
- from rest_framework import viewsets, status, filters
387
- from rest_framework.decorators import action
388
- from rest_framework.response import Response
389
- from rest_framework.permissions import IsAuthenticated, IsAdminUser
390
- from django_filters.rest_framework import DjangoFilterBackend
391
- from .models import Product
392
- from .serializers import ProductSerializer, ProductCreateSerializer
393
- from .permissions import IsOwnerOrReadOnly
394
- from .filters import ProductFilter
395
- from .services import ProductService
396
-
397
- class ProductViewSet(viewsets.ModelViewSet):
398
- """ViewSet for Product model."""
399
-
400
- queryset = Product.objects.select_related('category').prefetch_related('tags')
401
- permission_classes = [IsAuthenticated, IsOwnerOrReadOnly]
402
- filter_backends = [DjangoFilterBackend, filters.SearchFilter, filters.OrderingFilter]
403
- filterset_class = ProductFilter
404
- search_fields = ['name', 'description']
405
- ordering_fields = ['price', 'created_at', 'name']
406
- ordering = ['-created_at']
407
-
408
- def get_serializer_class(self):
409
- """Return appropriate serializer based on action."""
410
- if self.action == 'create':
411
- return ProductCreateSerializer
412
- return ProductSerializer
413
-
414
- def perform_create(self, serializer):
415
- """Save with user context."""
416
- serializer.save(created_by=self.request.user)
417
-
418
- @action(detail=False, methods=['get'])
419
- def featured(self, request):
420
- """Return featured products."""
421
- featured = self.queryset.filter(is_featured=True)[:10]
422
- serializer = self.get_serializer(featured, many=True)
423
- return Response(serializer.data)
424
-
425
- @action(detail=True, methods=['post'])
426
- def purchase(self, request, pk=None):
427
- """Purchase a product."""
428
- product = self.get_object()
429
- service = ProductService()
430
- result = service.purchase(product, request.user)
431
- return Response(result, status=status.HTTP_201_CREATED)
432
-
433
- @action(detail=False, methods=['get'], permission_classes=[IsAuthenticated])
434
- def my_products(self, request):
435
- """Return products created by current user."""
436
- products = self.queryset.filter(created_by=request.user)
437
- page = self.paginate_queryset(products)
438
- serializer = self.get_serializer(page, many=True)
439
- return self.get_paginated_response(serializer.data)
440
- ```
441
-
442
- ### Custom Actions
443
-
444
- ```python
445
- from rest_framework.decorators import api_view, permission_classes
446
- from rest_framework.permissions import IsAuthenticated
447
- from rest_framework.response import Response
448
-
449
- @api_view(['POST'])
450
- @permission_classes([IsAuthenticated])
451
- def add_to_cart(request):
452
- """Add product to user cart."""
453
- product_id = request.data.get('product_id')
454
- quantity = request.data.get('quantity', 1)
455
-
456
- try:
457
- product = Product.objects.get(id=product_id)
458
- except Product.DoesNotExist:
459
- return Response(
460
- {'error': 'Product not found'},
461
- status=status.HTTP_404_NOT_FOUND
462
- )
463
-
464
- cart, _ = Cart.objects.get_or_create(user=request.user)
465
- CartItem.objects.create(
466
- cart=cart,
467
- product=product,
468
- quantity=quantity
469
- )
470
-
471
- return Response({'message': 'Added to cart'}, status=status.HTTP_201_CREATED)
472
- ```
473
-
474
- ## Service Layer Pattern
475
-
476
- ```python
477
- # apps/orders/services.py
478
- from typing import Optional
479
- from django.db import transaction
480
- from .models import Order, OrderItem
481
-
482
- class OrderService:
483
- """Service layer for order-related business logic."""
484
-
485
- @staticmethod
486
- @transaction.atomic
487
- def create_order(user, cart: Cart) -> Order:
488
- """Create order from cart."""
489
- order = Order.objects.create(
490
- user=user,
491
- total_price=cart.total_price
492
- )
493
-
494
- for item in cart.items.all():
495
- OrderItem.objects.create(
496
- order=order,
497
- product=item.product,
498
- quantity=item.quantity,
499
- price=item.product.price
500
- )
501
-
502
- # Clear cart
503
- cart.items.all().delete()
504
-
505
- return order
506
-
507
- @staticmethod
508
- def process_payment(order: Order, payment_data: dict) -> bool:
509
- """Process payment for order."""
510
- # Integration with payment gateway
511
- payment = PaymentGateway.charge(
512
- amount=order.total_price,
513
- token=payment_data['token']
514
- )
515
-
516
- if payment.success:
517
- order.status = Order.Status.PAID
518
- order.save()
519
- # Send confirmation email
520
- OrderService.send_confirmation_email(order)
521
- return True
522
-
523
- return False
524
-
525
- @staticmethod
526
- def send_confirmation_email(order: Order):
527
- """Send order confirmation email."""
528
- # Email sending logic
529
- pass
530
- ```
531
-
532
- ## Caching Strategies
533
-
534
- ### View-Level Caching
535
-
536
- ```python
537
- from django.views.decorators.cache import cache_page
538
- from django.utils.decorators import method_decorator
539
-
540
- @method_decorator(cache_page(60 * 15), name='dispatch') # 15 minutes
541
- class ProductListView(generic.ListView):
542
- model = Product
543
- template_name = 'products/list.html'
544
- context_object_name = 'products'
545
- ```
546
-
547
- ### Template Fragment Caching
548
-
549
- ```django
550
- {% load cache %}
551
- {% cache 500 sidebar %}
552
- ... expensive sidebar content ...
553
- {% endcache %}
554
- ```
555
-
556
- ### Low-Level Caching
557
-
558
- ```python
559
- from django.core.cache import cache
560
-
561
- def get_featured_products():
562
- """Get featured products with caching."""
563
- cache_key = 'featured_products'
564
- products = cache.get(cache_key)
565
-
566
- if products is None:
567
- products = list(Product.objects.filter(is_featured=True))
568
- cache.set(cache_key, products, timeout=60 * 15) # 15 minutes
569
-
570
- return products
571
- ```
572
-
573
- ### QuerySet Caching
574
-
575
- ```python
576
- from django.core.cache import cache
577
-
578
- def get_popular_categories():
579
- cache_key = 'popular_categories'
580
- categories = cache.get(cache_key)
581
-
582
- if categories is None:
583
- categories = list(Category.objects.annotate(
584
- product_count=Count('products')
585
- ).filter(product_count__gt=10).order_by('-product_count')[:20])
586
- cache.set(cache_key, categories, timeout=60 * 60) # 1 hour
587
-
588
- return categories
589
- ```
590
-
591
- ## Signals
592
-
593
- ### Signal Patterns
594
-
595
- ```python
596
- # apps/users/signals.py
597
- from django.db.models.signals import post_save
598
- from django.dispatch import receiver
599
- from django.contrib.auth import get_user_model
600
- from .models import Profile
601
-
602
- User = get_user_model()
603
-
604
- @receiver(post_save, sender=User)
605
- def create_user_profile(sender, instance, created, **kwargs):
606
- """Create profile when user is created."""
607
- if created:
608
- Profile.objects.create(user=instance)
609
-
610
- @receiver(post_save, sender=User)
611
- def save_user_profile(sender, instance, **kwargs):
612
- """Save profile when user is saved."""
613
- instance.profile.save()
614
-
615
- # apps/users/apps.py
616
- from django.apps import AppConfig
617
-
618
- class UsersConfig(AppConfig):
619
- default_auto_field = 'django.db.models.BigAutoField'
620
- name = 'apps.users'
621
-
622
- def ready(self):
623
- """Import signals when app is ready."""
624
- import apps.users.signals
625
- ```
626
-
627
- ## Middleware
628
-
629
- ### Custom Middleware
630
-
631
- ```python
632
- # middleware/active_user_middleware.py
633
- import time
634
- from django.utils.deprecation import MiddlewareMixin
635
-
636
- class ActiveUserMiddleware(MiddlewareMixin):
637
- """Middleware to track active users."""
638
-
639
- def process_request(self, request):
640
- """Process incoming request."""
641
- if request.user.is_authenticated:
642
- # Update last active time
643
- request.user.last_active = timezone.now()
644
- request.user.save(update_fields=['last_active'])
645
-
646
- class RequestLoggingMiddleware(MiddlewareMixin):
647
- """Middleware for logging requests."""
648
-
649
- def process_request(self, request):
650
- """Log request start time."""
651
- request.start_time = time.time()
652
-
653
- def process_response(self, request, response):
654
- """Log request duration."""
655
- if hasattr(request, 'start_time'):
656
- duration = time.time() - request.start_time
657
- logger.info(f'{request.method} {request.path} - {response.status_code} - {duration:.3f}s')
658
- return response
659
- ```
660
-
661
- ## Performance Optimization
662
-
663
- ### N+1 Query Prevention
664
-
665
- ```python
666
- # Bad - N+1 queries
667
- products = Product.objects.all()
668
- for product in products:
669
- print(product.category.name) # Separate query for each product
670
-
671
- # Good - Single query with select_related
672
- products = Product.objects.select_related('category').all()
673
- for product in products:
674
- print(product.category.name)
675
-
676
- # Good - Prefetch for many-to-many
677
- products = Product.objects.prefetch_related('tags').all()
678
- for product in products:
679
- for tag in product.tags.all():
680
- print(tag.name)
681
- ```
682
-
683
- ### Database Indexing
684
-
685
- ```python
686
- class Product(models.Model):
687
- name = models.CharField(max_length=200, db_index=True)
688
- slug = models.SlugField(unique=True)
689
- category = models.ForeignKey('Category', on_delete=models.CASCADE)
690
- created_at = models.DateTimeField(auto_now_add=True)
691
-
692
- class Meta:
693
- indexes = [
694
- models.Index(fields=['name']),
695
- models.Index(fields=['-created_at']),
696
- models.Index(fields=['category', 'created_at']),
697
- ]
698
- ```
699
-
700
- ### Bulk Operations
701
-
702
- ```python
703
- # Bulk create
704
- Product.objects.bulk_create([
705
- Product(name=f'Product {i}', price=10.00)
706
- for i in range(1000)
707
- ])
708
-
709
- # Bulk update
710
- products = Product.objects.all()[:100]
711
- for product in products:
712
- product.is_active = True
713
- Product.objects.bulk_update(products, ['is_active'])
714
-
715
- # Bulk delete
716
- Product.objects.filter(stock=0).delete()
717
- ```
718
-
719
- ## Quick Reference
720
-
721
- | Pattern | Description |
722
- |---------|-------------|
723
- | Split settings | Separate dev/prod/test settings |
724
- | Custom QuerySet | Reusable query methods |
725
- | Service Layer | Business logic separation |
726
- | ViewSet | REST API endpoints |
727
- | Serializer validation | Request/response transformation |
728
- | select_related | Foreign key optimization |
729
- | prefetch_related | Many-to-many optimization |
730
- | Cache first | Cache expensive operations |
731
- | Signals | Event-driven actions |
732
- | Middleware | Request/response processing |
733
-
734
- Remember: Django provides many shortcuts, but for production applications, structure and organization matter more than concise code. Build for maintainability.
1
+ ---
2
+ name: django-patterns
3
+ description: Django architecture patterns, REST API design with DRF, ORM best practices, caching, signals, middleware, and production-grade Django apps.
4
+ origin: ECC
5
+ ---
6
+
7
+ # Django Development Patterns
8
+
9
+ Production-grade Django architecture patterns for scalable, maintainable applications.
10
+
11
+ ## When to Activate
12
+
13
+ - Building Django web applications
14
+ - Designing Django REST Framework APIs
15
+ - Working with Django ORM and models
16
+ - Setting up Django project structure
17
+ - Implementing caching, signals, middleware
18
+
19
+ ## Project Structure
20
+
21
+ ### Recommended Layout
22
+
23
+ ```
24
+ myproject/
25
+ ├── config/
26
+ │ ├── __init__.py
27
+ │ ├── settings/
28
+ │ │ ├── __init__.py
29
+ │ │ ├── base.py # Base settings
30
+ │ │ ├── development.py # Dev settings
31
+ │ │ ├── production.py # Production settings
32
+ │ │ └── test.py # Test settings
33
+ │ ├── urls.py
34
+ │ ├── wsgi.py
35
+ │ └── asgi.py
36
+ ├── manage.py
37
+ └── apps/
38
+ ├── __init__.py
39
+ ├── users/
40
+ │ ├── __init__.py
41
+ │ ├── models.py
42
+ │ ├── views.py
43
+ │ ├── serializers.py
44
+ │ ├── urls.py
45
+ │ ├── permissions.py
46
+ │ ├── filters.py
47
+ │ ├── services.py
48
+ │ └── tests/
49
+ └── products/
50
+ └── ...
51
+ ```
52
+
53
+ ### Split Settings Pattern
54
+
55
+ ```python
56
+ # config/settings/base.py
57
+ from pathlib import Path
58
+
59
+ BASE_DIR = Path(__file__).resolve().parent.parent.parent
60
+
61
+ SECRET_KEY = env('DJANGO_SECRET_KEY')
62
+ DEBUG = False
63
+ ALLOWED_HOSTS = []
64
+
65
+ INSTALLED_APPS = [
66
+ 'django.contrib.admin',
67
+ 'django.contrib.auth',
68
+ 'django.contrib.contenttypes',
69
+ 'django.contrib.sessions',
70
+ 'django.contrib.messages',
71
+ 'django.contrib.staticfiles',
72
+ 'rest_framework',
73
+ 'rest_framework.authtoken',
74
+ 'corsheaders',
75
+ # Local apps
76
+ 'apps.users',
77
+ 'apps.products',
78
+ ]
79
+
80
+ MIDDLEWARE = [
81
+ 'django.middleware.security.SecurityMiddleware',
82
+ 'whitenoise.middleware.WhiteNoiseMiddleware',
83
+ 'django.contrib.sessions.middleware.SessionMiddleware',
84
+ 'corsheaders.middleware.CorsMiddleware',
85
+ 'django.middleware.common.CommonMiddleware',
86
+ 'django.middleware.csrf.CsrfViewMiddleware',
87
+ 'django.contrib.auth.middleware.AuthenticationMiddleware',
88
+ 'django.contrib.messages.middleware.MessageMiddleware',
89
+ 'django.middleware.clickjacking.XFrameOptionsMiddleware',
90
+ ]
91
+
92
+ ROOT_URLCONF = 'config.urls'
93
+ WSGI_APPLICATION = 'config.wsgi.application'
94
+
95
+ DATABASES = {
96
+ 'default': {
97
+ 'ENGINE': 'django.db.backends.postgresql',
98
+ 'NAME': env('DB_NAME'),
99
+ 'USER': env('DB_USER'),
100
+ 'PASSWORD': env('DB_PASSWORD'),
101
+ 'HOST': env('DB_HOST'),
102
+ 'PORT': env('DB_PORT', default='5432'),
103
+ }
104
+ }
105
+
106
+ # config/settings/development.py
107
+ from .base import *
108
+
109
+ DEBUG = True
110
+ ALLOWED_HOSTS = ['localhost', '127.0.0.1']
111
+
112
+ DATABASES['default']['NAME'] = 'myproject_dev'
113
+
114
+ INSTALLED_APPS += ['debug_toolbar']
115
+
116
+ MIDDLEWARE += ['debug_toolbar.middleware.DebugToolbarMiddleware']
117
+
118
+ EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'
119
+
120
+ # config/settings/production.py
121
+ from .base import *
122
+
123
+ DEBUG = False
124
+ ALLOWED_HOSTS = env.list('ALLOWED_HOSTS')
125
+ SECURE_SSL_REDIRECT = True
126
+ SESSION_COOKIE_SECURE = True
127
+ CSRF_COOKIE_SECURE = True
128
+ SECURE_HSTS_SECONDS = 31536000
129
+ SECURE_HSTS_INCLUDE_SUBDOMAINS = True
130
+ SECURE_HSTS_PRELOAD = True
131
+
132
+ # Logging
133
+ LOGGING = {
134
+ 'version': 1,
135
+ 'disable_existing_loggers': False,
136
+ 'handlers': {
137
+ 'file': {
138
+ 'level': 'WARNING',
139
+ 'class': 'logging.FileHandler',
140
+ 'filename': '/var/log/django/django.log',
141
+ },
142
+ },
143
+ 'loggers': {
144
+ 'django': {
145
+ 'handlers': ['file'],
146
+ 'level': 'WARNING',
147
+ 'propagate': True,
148
+ },
149
+ },
150
+ }
151
+ ```
152
+
153
+ ## Model Design Patterns
154
+
155
+ ### Model Best Practices
156
+
157
+ ```python
158
+ from django.db import models
159
+ from django.contrib.auth.models import AbstractUser
160
+ from django.core.validators import MinValueValidator, MaxValueValidator
161
+
162
+ class User(AbstractUser):
163
+ """Custom user model extending AbstractUser."""
164
+ email = models.EmailField(unique=True)
165
+ phone = models.CharField(max_length=20, blank=True)
166
+ birth_date = models.DateField(null=True, blank=True)
167
+
168
+ USERNAME_FIELD = 'email'
169
+ REQUIRED_FIELDS = ['username']
170
+
171
+ class Meta:
172
+ db_table = 'users'
173
+ verbose_name = 'user'
174
+ verbose_name_plural = 'users'
175
+ ordering = ['-date_joined']
176
+
177
+ def __str__(self):
178
+ return self.email
179
+
180
+ def get_full_name(self):
181
+ return f"{self.first_name} {self.last_name}".strip()
182
+
183
+ class Product(models.Model):
184
+ """Product model with proper field configuration."""
185
+ name = models.CharField(max_length=200)
186
+ slug = models.SlugField(unique=True, max_length=250)
187
+ description = models.TextField(blank=True)
188
+ price = models.DecimalField(
189
+ max_digits=10,
190
+ decimal_places=2,
191
+ validators=[MinValueValidator(0)]
192
+ )
193
+ stock = models.PositiveIntegerField(default=0)
194
+ is_active = models.BooleanField(default=True)
195
+ category = models.ForeignKey(
196
+ 'Category',
197
+ on_delete=models.CASCADE,
198
+ related_name='products'
199
+ )
200
+ tags = models.ManyToManyField('Tag', blank=True, related_name='products')
201
+ created_at = models.DateTimeField(auto_now_add=True)
202
+ updated_at = models.DateTimeField(auto_now=True)
203
+
204
+ class Meta:
205
+ db_table = 'products'
206
+ ordering = ['-created_at']
207
+ indexes = [
208
+ models.Index(fields=['slug']),
209
+ models.Index(fields=['-created_at']),
210
+ models.Index(fields=['category', 'is_active']),
211
+ ]
212
+ constraints = [
213
+ models.CheckConstraint(
214
+ check=models.Q(price__gte=0),
215
+ name='price_non_negative'
216
+ )
217
+ ]
218
+
219
+ def __str__(self):
220
+ return self.name
221
+
222
+ def save(self, *args, **kwargs):
223
+ if not self.slug:
224
+ self.slug = slugify(self.name)
225
+ super().save(*args, **kwargs)
226
+ ```
227
+
228
+ ### QuerySet Best Practices
229
+
230
+ ```python
231
+ from django.db import models
232
+
233
+ class ProductQuerySet(models.QuerySet):
234
+ """Custom QuerySet for Product model."""
235
+
236
+ def active(self):
237
+ """Return only active products."""
238
+ return self.filter(is_active=True)
239
+
240
+ def with_category(self):
241
+ """Select related category to avoid N+1 queries."""
242
+ return self.select_related('category')
243
+
244
+ def with_tags(self):
245
+ """Prefetch tags for many-to-many relationship."""
246
+ return self.prefetch_related('tags')
247
+
248
+ def in_stock(self):
249
+ """Return products with stock > 0."""
250
+ return self.filter(stock__gt=0)
251
+
252
+ def search(self, query):
253
+ """Search products by name or description."""
254
+ return self.filter(
255
+ models.Q(name__icontains=query) |
256
+ models.Q(description__icontains=query)
257
+ )
258
+
259
+ class Product(models.Model):
260
+ # ... fields ...
261
+
262
+ objects = ProductQuerySet.as_manager() # Use custom QuerySet
263
+
264
+ # Usage
265
+ Product.objects.active().with_category().in_stock()
266
+ ```
267
+
268
+ ### Manager Methods
269
+
270
+ ```python
271
+ class ProductManager(models.Manager):
272
+ """Custom manager for complex queries."""
273
+
274
+ def get_or_none(self, **kwargs):
275
+ """Return object or None instead of DoesNotExist."""
276
+ try:
277
+ return self.get(**kwargs)
278
+ except self.model.DoesNotExist:
279
+ return None
280
+
281
+ def create_with_tags(self, name, price, tag_names):
282
+ """Create product with associated tags."""
283
+ product = self.create(name=name, price=price)
284
+ tags = [Tag.objects.get_or_create(name=name)[0] for name in tag_names]
285
+ product.tags.set(tags)
286
+ return product
287
+
288
+ def bulk_update_stock(self, product_ids, quantity):
289
+ """Bulk update stock for multiple products."""
290
+ return self.filter(id__in=product_ids).update(stock=quantity)
291
+
292
+ # In model
293
+ class Product(models.Model):
294
+ # ... fields ...
295
+ custom = ProductManager()
296
+ ```
297
+
298
+ ## Django REST Framework Patterns
299
+
300
+ ### Serializer Patterns
301
+
302
+ ```python
303
+ from rest_framework import serializers
304
+ from django.contrib.auth.password_validation import validate_password
305
+ from .models import Product, User
306
+
307
+ class ProductSerializer(serializers.ModelSerializer):
308
+ """Serializer for Product model."""
309
+
310
+ category_name = serializers.CharField(source='category.name', read_only=True)
311
+ average_rating = serializers.FloatField(read_only=True)
312
+ discount_price = serializers.SerializerMethodField()
313
+
314
+ class Meta:
315
+ model = Product
316
+ fields = [
317
+ 'id', 'name', 'slug', 'description', 'price',
318
+ 'discount_price', 'stock', 'category_name',
319
+ 'average_rating', 'created_at'
320
+ ]
321
+ read_only_fields = ['id', 'slug', 'created_at']
322
+
323
+ def get_discount_price(self, obj):
324
+ """Calculate discount price if applicable."""
325
+ if hasattr(obj, 'discount') and obj.discount:
326
+ return obj.price * (1 - obj.discount.percent / 100)
327
+ return obj.price
328
+
329
+ def validate_price(self, value):
330
+ """Ensure price is non-negative."""
331
+ if value < 0:
332
+ raise serializers.ValidationError("Price cannot be negative.")
333
+ return value
334
+
335
+ class ProductCreateSerializer(serializers.ModelSerializer):
336
+ """Serializer for creating products."""
337
+
338
+ class Meta:
339
+ model = Product
340
+ fields = ['name', 'description', 'price', 'stock', 'category']
341
+
342
+ def validate(self, data):
343
+ """Custom validation for multiple fields."""
344
+ if data['price'] > 10000 and data['stock'] > 100:
345
+ raise serializers.ValidationError(
346
+ "Cannot have high-value products with large stock."
347
+ )
348
+ return data
349
+
350
+ class UserRegistrationSerializer(serializers.ModelSerializer):
351
+ """Serializer for user registration."""
352
+
353
+ password = serializers.CharField(
354
+ write_only=True,
355
+ required=True,
356
+ validators=[validate_password],
357
+ style={'input_type': 'password'}
358
+ )
359
+ password_confirm = serializers.CharField(write_only=True, style={'input_type': 'password'})
360
+
361
+ class Meta:
362
+ model = User
363
+ fields = ['email', 'username', 'password', 'password_confirm']
364
+
365
+ def validate(self, data):
366
+ """Validate passwords match."""
367
+ if data['password'] != data['password_confirm']:
368
+ raise serializers.ValidationError({
369
+ "password_confirm": "Password fields didn't match."
370
+ })
371
+ return data
372
+
373
+ def create(self, validated_data):
374
+ """Create user with hashed password."""
375
+ validated_data.pop('password_confirm')
376
+ password = validated_data.pop('password')
377
+ user = User.objects.create(**validated_data)
378
+ user.set_password(password)
379
+ user.save()
380
+ return user
381
+ ```
382
+
383
+ ### ViewSet Patterns
384
+
385
+ ```python
386
+ from rest_framework import viewsets, status, filters
387
+ from rest_framework.decorators import action
388
+ from rest_framework.response import Response
389
+ from rest_framework.permissions import IsAuthenticated, IsAdminUser
390
+ from django_filters.rest_framework import DjangoFilterBackend
391
+ from .models import Product
392
+ from .serializers import ProductSerializer, ProductCreateSerializer
393
+ from .permissions import IsOwnerOrReadOnly
394
+ from .filters import ProductFilter
395
+ from .services import ProductService
396
+
397
+ class ProductViewSet(viewsets.ModelViewSet):
398
+ """ViewSet for Product model."""
399
+
400
+ queryset = Product.objects.select_related('category').prefetch_related('tags')
401
+ permission_classes = [IsAuthenticated, IsOwnerOrReadOnly]
402
+ filter_backends = [DjangoFilterBackend, filters.SearchFilter, filters.OrderingFilter]
403
+ filterset_class = ProductFilter
404
+ search_fields = ['name', 'description']
405
+ ordering_fields = ['price', 'created_at', 'name']
406
+ ordering = ['-created_at']
407
+
408
+ def get_serializer_class(self):
409
+ """Return appropriate serializer based on action."""
410
+ if self.action == 'create':
411
+ return ProductCreateSerializer
412
+ return ProductSerializer
413
+
414
+ def perform_create(self, serializer):
415
+ """Save with user context."""
416
+ serializer.save(created_by=self.request.user)
417
+
418
+ @action(detail=False, methods=['get'])
419
+ def featured(self, request):
420
+ """Return featured products."""
421
+ featured = self.queryset.filter(is_featured=True)[:10]
422
+ serializer = self.get_serializer(featured, many=True)
423
+ return Response(serializer.data)
424
+
425
+ @action(detail=True, methods=['post'])
426
+ def purchase(self, request, pk=None):
427
+ """Purchase a product."""
428
+ product = self.get_object()
429
+ service = ProductService()
430
+ result = service.purchase(product, request.user)
431
+ return Response(result, status=status.HTTP_201_CREATED)
432
+
433
+ @action(detail=False, methods=['get'], permission_classes=[IsAuthenticated])
434
+ def my_products(self, request):
435
+ """Return products created by current user."""
436
+ products = self.queryset.filter(created_by=request.user)
437
+ page = self.paginate_queryset(products)
438
+ serializer = self.get_serializer(page, many=True)
439
+ return self.get_paginated_response(serializer.data)
440
+ ```
441
+
442
+ ### Custom Actions
443
+
444
+ ```python
445
+ from rest_framework.decorators import api_view, permission_classes
446
+ from rest_framework.permissions import IsAuthenticated
447
+ from rest_framework.response import Response
448
+
449
+ @api_view(['POST'])
450
+ @permission_classes([IsAuthenticated])
451
+ def add_to_cart(request):
452
+ """Add product to user cart."""
453
+ product_id = request.data.get('product_id')
454
+ quantity = request.data.get('quantity', 1)
455
+
456
+ try:
457
+ product = Product.objects.get(id=product_id)
458
+ except Product.DoesNotExist:
459
+ return Response(
460
+ {'error': 'Product not found'},
461
+ status=status.HTTP_404_NOT_FOUND
462
+ )
463
+
464
+ cart, _ = Cart.objects.get_or_create(user=request.user)
465
+ CartItem.objects.create(
466
+ cart=cart,
467
+ product=product,
468
+ quantity=quantity
469
+ )
470
+
471
+ return Response({'message': 'Added to cart'}, status=status.HTTP_201_CREATED)
472
+ ```
473
+
474
+ ## Service Layer Pattern
475
+
476
+ ```python
477
+ # apps/orders/services.py
478
+ from typing import Optional
479
+ from django.db import transaction
480
+ from .models import Order, OrderItem
481
+
482
+ class OrderService:
483
+ """Service layer for order-related business logic."""
484
+
485
+ @staticmethod
486
+ @transaction.atomic
487
+ def create_order(user, cart: Cart) -> Order:
488
+ """Create order from cart."""
489
+ order = Order.objects.create(
490
+ user=user,
491
+ total_price=cart.total_price
492
+ )
493
+
494
+ for item in cart.items.all():
495
+ OrderItem.objects.create(
496
+ order=order,
497
+ product=item.product,
498
+ quantity=item.quantity,
499
+ price=item.product.price
500
+ )
501
+
502
+ # Clear cart
503
+ cart.items.all().delete()
504
+
505
+ return order
506
+
507
+ @staticmethod
508
+ def process_payment(order: Order, payment_data: dict) -> bool:
509
+ """Process payment for order."""
510
+ # Integration with payment gateway
511
+ payment = PaymentGateway.charge(
512
+ amount=order.total_price,
513
+ token=payment_data['token']
514
+ )
515
+
516
+ if payment.success:
517
+ order.status = Order.Status.PAID
518
+ order.save()
519
+ # Send confirmation email
520
+ OrderService.send_confirmation_email(order)
521
+ return True
522
+
523
+ return False
524
+
525
+ @staticmethod
526
+ def send_confirmation_email(order: Order):
527
+ """Send order confirmation email."""
528
+ # Email sending logic
529
+ pass
530
+ ```
531
+
532
+ ## Caching Strategies
533
+
534
+ ### View-Level Caching
535
+
536
+ ```python
537
+ from django.views.decorators.cache import cache_page
538
+ from django.utils.decorators import method_decorator
539
+
540
+ @method_decorator(cache_page(60 * 15), name='dispatch') # 15 minutes
541
+ class ProductListView(generic.ListView):
542
+ model = Product
543
+ template_name = 'products/list.html'
544
+ context_object_name = 'products'
545
+ ```
546
+
547
+ ### Template Fragment Caching
548
+
549
+ ```django
550
+ {% load cache %}
551
+ {% cache 500 sidebar %}
552
+ ... expensive sidebar content ...
553
+ {% endcache %}
554
+ ```
555
+
556
+ ### Low-Level Caching
557
+
558
+ ```python
559
+ from django.core.cache import cache
560
+
561
+ def get_featured_products():
562
+ """Get featured products with caching."""
563
+ cache_key = 'featured_products'
564
+ products = cache.get(cache_key)
565
+
566
+ if products is None:
567
+ products = list(Product.objects.filter(is_featured=True))
568
+ cache.set(cache_key, products, timeout=60 * 15) # 15 minutes
569
+
570
+ return products
571
+ ```
572
+
573
+ ### QuerySet Caching
574
+
575
+ ```python
576
+ from django.core.cache import cache
577
+
578
+ def get_popular_categories():
579
+ cache_key = 'popular_categories'
580
+ categories = cache.get(cache_key)
581
+
582
+ if categories is None:
583
+ categories = list(Category.objects.annotate(
584
+ product_count=Count('products')
585
+ ).filter(product_count__gt=10).order_by('-product_count')[:20])
586
+ cache.set(cache_key, categories, timeout=60 * 60) # 1 hour
587
+
588
+ return categories
589
+ ```
590
+
591
+ ## Signals
592
+
593
+ ### Signal Patterns
594
+
595
+ ```python
596
+ # apps/users/signals.py
597
+ from django.db.models.signals import post_save
598
+ from django.dispatch import receiver
599
+ from django.contrib.auth import get_user_model
600
+ from .models import Profile
601
+
602
+ User = get_user_model()
603
+
604
+ @receiver(post_save, sender=User)
605
+ def create_user_profile(sender, instance, created, **kwargs):
606
+ """Create profile when user is created."""
607
+ if created:
608
+ Profile.objects.create(user=instance)
609
+
610
+ @receiver(post_save, sender=User)
611
+ def save_user_profile(sender, instance, **kwargs):
612
+ """Save profile when user is saved."""
613
+ instance.profile.save()
614
+
615
+ # apps/users/apps.py
616
+ from django.apps import AppConfig
617
+
618
+ class UsersConfig(AppConfig):
619
+ default_auto_field = 'django.db.models.BigAutoField'
620
+ name = 'apps.users'
621
+
622
+ def ready(self):
623
+ """Import signals when app is ready."""
624
+ import apps.users.signals
625
+ ```
626
+
627
+ ## Middleware
628
+
629
+ ### Custom Middleware
630
+
631
+ ```python
632
+ # middleware/active_user_middleware.py
633
+ import time
634
+ from django.utils.deprecation import MiddlewareMixin
635
+
636
+ class ActiveUserMiddleware(MiddlewareMixin):
637
+ """Middleware to track active users."""
638
+
639
+ def process_request(self, request):
640
+ """Process incoming request."""
641
+ if request.user.is_authenticated:
642
+ # Update last active time
643
+ request.user.last_active = timezone.now()
644
+ request.user.save(update_fields=['last_active'])
645
+
646
+ class RequestLoggingMiddleware(MiddlewareMixin):
647
+ """Middleware for logging requests."""
648
+
649
+ def process_request(self, request):
650
+ """Log request start time."""
651
+ request.start_time = time.time()
652
+
653
+ def process_response(self, request, response):
654
+ """Log request duration."""
655
+ if hasattr(request, 'start_time'):
656
+ duration = time.time() - request.start_time
657
+ logger.info(f'{request.method} {request.path} - {response.status_code} - {duration:.3f}s')
658
+ return response
659
+ ```
660
+
661
+ ## Performance Optimization
662
+
663
+ ### N+1 Query Prevention
664
+
665
+ ```python
666
+ # Bad - N+1 queries
667
+ products = Product.objects.all()
668
+ for product in products:
669
+ print(product.category.name) # Separate query for each product
670
+
671
+ # Good - Single query with select_related
672
+ products = Product.objects.select_related('category').all()
673
+ for product in products:
674
+ print(product.category.name)
675
+
676
+ # Good - Prefetch for many-to-many
677
+ products = Product.objects.prefetch_related('tags').all()
678
+ for product in products:
679
+ for tag in product.tags.all():
680
+ print(tag.name)
681
+ ```
682
+
683
+ ### Database Indexing
684
+
685
+ ```python
686
+ class Product(models.Model):
687
+ name = models.CharField(max_length=200, db_index=True)
688
+ slug = models.SlugField(unique=True)
689
+ category = models.ForeignKey('Category', on_delete=models.CASCADE)
690
+ created_at = models.DateTimeField(auto_now_add=True)
691
+
692
+ class Meta:
693
+ indexes = [
694
+ models.Index(fields=['name']),
695
+ models.Index(fields=['-created_at']),
696
+ models.Index(fields=['category', 'created_at']),
697
+ ]
698
+ ```
699
+
700
+ ### Bulk Operations
701
+
702
+ ```python
703
+ # Bulk create
704
+ Product.objects.bulk_create([
705
+ Product(name=f'Product {i}', price=10.00)
706
+ for i in range(1000)
707
+ ])
708
+
709
+ # Bulk update
710
+ products = Product.objects.all()[:100]
711
+ for product in products:
712
+ product.is_active = True
713
+ Product.objects.bulk_update(products, ['is_active'])
714
+
715
+ # Bulk delete
716
+ Product.objects.filter(stock=0).delete()
717
+ ```
718
+
719
+ ## Quick Reference
720
+
721
+ | Pattern | Description |
722
+ |---------|-------------|
723
+ | Split settings | Separate dev/prod/test settings |
724
+ | Custom QuerySet | Reusable query methods |
725
+ | Service Layer | Business logic separation |
726
+ | ViewSet | REST API endpoints |
727
+ | Serializer validation | Request/response transformation |
728
+ | select_related | Foreign key optimization |
729
+ | prefetch_related | Many-to-many optimization |
730
+ | Cache first | Cache expensive operations |
731
+ | Signals | Event-driven actions |
732
+ | Middleware | Request/response processing |
733
+
734
+ Remember: Django provides many shortcuts, but for production applications, structure and organization matter more than concise code. Build for maintainability.