@funnycode/myclaude 0.1.55 → 0.1.60

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 (499) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +63 -0
  3. package/README.zh-CN.md +63 -0
  4. package/dist/SKILL-r7zmg5v7.md +3 -0
  5. package/dist/cli-mvr5k580.md +3 -0
  6. package/dist/myclaude.js +14230 -8799
  7. package/dist/myclaude.mjs +14230 -8799
  8. package/dist/server-zyhc2a9z.md +3 -0
  9. package/package.json +128 -128
  10. package/seed/marketplaces/ecc/.opencode/package-lock.json +169 -169
  11. package/seed/marketplaces/ecc/commands/aside.md +164 -164
  12. package/seed/marketplaces/ecc/commands/auto-update.md +28 -28
  13. package/seed/marketplaces/ecc/commands/build-fix.md +66 -66
  14. package/seed/marketplaces/ecc/commands/checkpoint.md +78 -78
  15. package/seed/marketplaces/ecc/commands/code-review.md +289 -289
  16. package/seed/marketplaces/ecc/commands/cost-report.md +107 -107
  17. package/seed/marketplaces/ecc/commands/cpp-build.md +173 -173
  18. package/seed/marketplaces/ecc/commands/cpp-review.md +132 -132
  19. package/seed/marketplaces/ecc/commands/cpp-test.md +251 -251
  20. package/seed/marketplaces/ecc/commands/ecc-guide.md +93 -93
  21. package/seed/marketplaces/ecc/commands/evolve.md +178 -178
  22. package/seed/marketplaces/ecc/commands/fastapi-review.md +39 -39
  23. package/seed/marketplaces/ecc/commands/feature-dev.md +49 -49
  24. package/seed/marketplaces/ecc/commands/flutter-build.md +164 -164
  25. package/seed/marketplaces/ecc/commands/flutter-review.md +116 -116
  26. package/seed/marketplaces/ecc/commands/flutter-test.md +144 -144
  27. package/seed/marketplaces/ecc/commands/gan-build.md +103 -103
  28. package/seed/marketplaces/ecc/commands/gan-design.md +39 -39
  29. package/seed/marketplaces/ecc/commands/go-build.md +183 -183
  30. package/seed/marketplaces/ecc/commands/go-review.md +148 -148
  31. package/seed/marketplaces/ecc/commands/go-test.md +268 -268
  32. package/seed/marketplaces/ecc/commands/gradle-build.md +70 -70
  33. package/seed/marketplaces/ecc/commands/harness-audit.md +84 -84
  34. package/seed/marketplaces/ecc/commands/hookify-configure.md +14 -14
  35. package/seed/marketplaces/ecc/commands/hookify-help.md +46 -46
  36. package/seed/marketplaces/ecc/commands/hookify-list.md +21 -21
  37. package/seed/marketplaces/ecc/commands/hookify.md +50 -50
  38. package/seed/marketplaces/ecc/commands/instinct-export.md +66 -66
  39. package/seed/marketplaces/ecc/commands/instinct-import.md +114 -114
  40. package/seed/marketplaces/ecc/commands/instinct-status.md +59 -59
  41. package/seed/marketplaces/ecc/commands/jira.md +106 -106
  42. package/seed/marketplaces/ecc/commands/kotlin-build.md +174 -174
  43. package/seed/marketplaces/ecc/commands/kotlin-review.md +140 -140
  44. package/seed/marketplaces/ecc/commands/kotlin-test.md +312 -312
  45. package/seed/marketplaces/ecc/commands/learn-eval.md +116 -116
  46. package/seed/marketplaces/ecc/commands/learn.md +74 -74
  47. package/seed/marketplaces/ecc/commands/loop-start.md +36 -36
  48. package/seed/marketplaces/ecc/commands/loop-status.md +77 -77
  49. package/seed/marketplaces/ecc/commands/marketing-campaign.md +129 -129
  50. package/seed/marketplaces/ecc/commands/model-route.md +30 -30
  51. package/seed/marketplaces/ecc/commands/multi-backend.md +162 -162
  52. package/seed/marketplaces/ecc/commands/multi-execute.md +319 -319
  53. package/seed/marketplaces/ecc/commands/multi-frontend.md +162 -162
  54. package/seed/marketplaces/ecc/commands/multi-plan.md +272 -272
  55. package/seed/marketplaces/ecc/commands/multi-workflow.md +195 -195
  56. package/seed/marketplaces/ecc/commands/plan-prd.md +160 -160
  57. package/seed/marketplaces/ecc/commands/plan.md +200 -200
  58. package/seed/marketplaces/ecc/commands/pm2.md +276 -276
  59. package/seed/marketplaces/ecc/commands/pr.md +184 -184
  60. package/seed/marketplaces/ecc/commands/project-init.md +86 -86
  61. package/seed/marketplaces/ecc/commands/projects.md +39 -39
  62. package/seed/marketplaces/ecc/commands/promote.md +41 -41
  63. package/seed/marketplaces/ecc/commands/prp-commit.md +112 -112
  64. package/seed/marketplaces/ecc/commands/prp-implement.md +385 -385
  65. package/seed/marketplaces/ecc/commands/prp-plan.md +502 -502
  66. package/seed/marketplaces/ecc/commands/prp-pr.md +184 -184
  67. package/seed/marketplaces/ecc/commands/prp-prd.md +447 -447
  68. package/seed/marketplaces/ecc/commands/prune.md +31 -31
  69. package/seed/marketplaces/ecc/commands/python-review.md +297 -297
  70. package/seed/marketplaces/ecc/commands/quality-gate.md +33 -33
  71. package/seed/marketplaces/ecc/commands/refactor-clean.md +84 -84
  72. package/seed/marketplaces/ecc/commands/resume-session.md +156 -156
  73. package/seed/marketplaces/ecc/commands/review-pr.md +37 -37
  74. package/seed/marketplaces/ecc/commands/rust-build.md +187 -187
  75. package/seed/marketplaces/ecc/commands/rust-review.md +142 -142
  76. package/seed/marketplaces/ecc/commands/rust-test.md +308 -308
  77. package/seed/marketplaces/ecc/commands/santa-loop.md +175 -175
  78. package/seed/marketplaces/ecc/commands/save-session.md +275 -275
  79. package/seed/marketplaces/ecc/commands/security-scan.md +92 -92
  80. package/seed/marketplaces/ecc/commands/sessions.md +339 -339
  81. package/seed/marketplaces/ecc/commands/setup-pm.md +80 -80
  82. package/seed/marketplaces/ecc/commands/skill-create.md +174 -174
  83. package/seed/marketplaces/ecc/commands/skill-health.md +54 -54
  84. package/seed/marketplaces/ecc/commands/test-coverage.md +73 -73
  85. package/seed/marketplaces/ecc/commands/update-codemaps.md +76 -76
  86. package/seed/marketplaces/ecc/commands/update-docs.md +88 -88
  87. package/seed/marketplaces/ecc/skills/accessibility/SKILL.md +146 -146
  88. package/seed/marketplaces/ecc/skills/agent-architecture-audit/SKILL.md +256 -256
  89. package/seed/marketplaces/ecc/skills/agent-eval/SKILL.md +145 -145
  90. package/seed/marketplaces/ecc/skills/agent-harness-construction/SKILL.md +73 -73
  91. package/seed/marketplaces/ecc/skills/agent-introspection-debugging/SKILL.md +153 -153
  92. package/seed/marketplaces/ecc/skills/agent-payment-x402/SKILL.md +224 -224
  93. package/seed/marketplaces/ecc/skills/agent-sort/SKILL.md +215 -215
  94. package/seed/marketplaces/ecc/skills/agentic-engineering/SKILL.md +63 -63
  95. package/seed/marketplaces/ecc/skills/agentic-os/SKILL.md +387 -387
  96. package/seed/marketplaces/ecc/skills/ai-first-engineering/SKILL.md +51 -51
  97. package/seed/marketplaces/ecc/skills/ai-regression-testing/SKILL.md +385 -385
  98. package/seed/marketplaces/ecc/skills/android-clean-architecture/SKILL.md +339 -339
  99. package/seed/marketplaces/ecc/skills/angular-developer/SKILL.md +154 -154
  100. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-animations.md +160 -160
  101. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-aria.md +410 -410
  102. package/seed/marketplaces/ecc/skills/angular-developer/references/cli.md +86 -86
  103. package/seed/marketplaces/ecc/skills/angular-developer/references/component-harnesses.md +59 -59
  104. package/seed/marketplaces/ecc/skills/angular-developer/references/component-styling.md +91 -91
  105. package/seed/marketplaces/ecc/skills/angular-developer/references/components.md +117 -117
  106. package/seed/marketplaces/ecc/skills/angular-developer/references/creating-services.md +97 -97
  107. package/seed/marketplaces/ecc/skills/angular-developer/references/data-resolvers.md +69 -69
  108. package/seed/marketplaces/ecc/skills/angular-developer/references/define-routes.md +67 -67
  109. package/seed/marketplaces/ecc/skills/angular-developer/references/defining-providers.md +72 -72
  110. package/seed/marketplaces/ecc/skills/angular-developer/references/di-fundamentals.md +120 -120
  111. package/seed/marketplaces/ecc/skills/angular-developer/references/e2e-testing.md +56 -56
  112. package/seed/marketplaces/ecc/skills/angular-developer/references/effects.md +83 -83
  113. package/seed/marketplaces/ecc/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  114. package/seed/marketplaces/ecc/skills/angular-developer/references/host-elements.md +80 -80
  115. package/seed/marketplaces/ecc/skills/angular-developer/references/injection-context.md +63 -63
  116. package/seed/marketplaces/ecc/skills/angular-developer/references/inputs.md +101 -101
  117. package/seed/marketplaces/ecc/skills/angular-developer/references/linked-signal.md +59 -59
  118. package/seed/marketplaces/ecc/skills/angular-developer/references/loading-strategies.md +61 -61
  119. package/seed/marketplaces/ecc/skills/angular-developer/references/mcp.md +108 -108
  120. package/seed/marketplaces/ecc/skills/angular-developer/references/navigate-to-routes.md +69 -69
  121. package/seed/marketplaces/ecc/skills/angular-developer/references/outputs.md +86 -86
  122. package/seed/marketplaces/ecc/skills/angular-developer/references/reactive-forms.md +122 -122
  123. package/seed/marketplaces/ecc/skills/angular-developer/references/rendering-strategies.md +44 -44
  124. package/seed/marketplaces/ecc/skills/angular-developer/references/resource.md +77 -77
  125. package/seed/marketplaces/ecc/skills/angular-developer/references/route-animations.md +56 -56
  126. package/seed/marketplaces/ecc/skills/angular-developer/references/route-guards.md +52 -52
  127. package/seed/marketplaces/ecc/skills/angular-developer/references/router-lifecycle.md +45 -45
  128. package/seed/marketplaces/ecc/skills/angular-developer/references/router-testing.md +87 -87
  129. package/seed/marketplaces/ecc/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  130. package/seed/marketplaces/ecc/skills/angular-developer/references/signal-forms.md +795 -795
  131. package/seed/marketplaces/ecc/skills/angular-developer/references/signals-overview.md +94 -94
  132. package/seed/marketplaces/ecc/skills/angular-developer/references/tailwind-css.md +69 -69
  133. package/seed/marketplaces/ecc/skills/angular-developer/references/template-driven-forms.md +114 -114
  134. package/seed/marketplaces/ecc/skills/angular-developer/references/testing-fundamentals.md +65 -65
  135. package/seed/marketplaces/ecc/skills/api-connector-builder/SKILL.md +120 -120
  136. package/seed/marketplaces/ecc/skills/api-design/SKILL.md +523 -523
  137. package/seed/marketplaces/ecc/skills/architecture-decision-records/SKILL.md +179 -179
  138. package/seed/marketplaces/ecc/skills/article-writing/SKILL.md +79 -79
  139. package/seed/marketplaces/ecc/skills/automation-audit-ops/SKILL.md +142 -142
  140. package/seed/marketplaces/ecc/skills/autonomous-agent-harness/SKILL.md +273 -273
  141. package/seed/marketplaces/ecc/skills/autonomous-loops/SKILL.md +610 -610
  142. package/seed/marketplaces/ecc/skills/backend-patterns/SKILL.md +561 -561
  143. package/seed/marketplaces/ecc/skills/benchmark/SKILL.md +93 -93
  144. package/seed/marketplaces/ecc/skills/benchmark-optimization-loop/SKILL.md +69 -69
  145. package/seed/marketplaces/ecc/skills/blender-motion-state-inspection/SKILL.md +164 -164
  146. package/seed/marketplaces/ecc/skills/blueprint/SKILL.md +105 -105
  147. package/seed/marketplaces/ecc/skills/brand-voice/SKILL.md +97 -97
  148. package/seed/marketplaces/ecc/skills/brand-voice/references/voice-profile-schema.md +55 -55
  149. package/seed/marketplaces/ecc/skills/browser-qa/SKILL.md +87 -87
  150. package/seed/marketplaces/ecc/skills/bun-runtime/SKILL.md +84 -84
  151. package/seed/marketplaces/ecc/skills/canary-watch/SKILL.md +107 -107
  152. package/seed/marketplaces/ecc/skills/carrier-relationship-management/SKILL.md +212 -212
  153. package/seed/marketplaces/ecc/skills/cisco-ios-patterns/SKILL.md +163 -163
  154. package/seed/marketplaces/ecc/skills/ck/SKILL.md +147 -147
  155. package/seed/marketplaces/ecc/skills/ck/commands/forget.mjs +44 -44
  156. package/seed/marketplaces/ecc/skills/ck/commands/info.mjs +24 -24
  157. package/seed/marketplaces/ecc/skills/ck/commands/init.mjs +143 -143
  158. package/seed/marketplaces/ecc/skills/ck/commands/list.mjs +40 -40
  159. package/seed/marketplaces/ecc/skills/ck/commands/migrate.mjs +202 -202
  160. package/seed/marketplaces/ecc/skills/ck/commands/resume.mjs +36 -36
  161. package/seed/marketplaces/ecc/skills/ck/commands/save.mjs +210 -210
  162. package/seed/marketplaces/ecc/skills/ck/commands/shared.mjs +387 -387
  163. package/seed/marketplaces/ecc/skills/ck/hooks/session-start.mjs +224 -224
  164. package/seed/marketplaces/ecc/skills/claude-devfleet/SKILL.md +103 -103
  165. package/seed/marketplaces/ecc/skills/click-path-audit/SKILL.md +244 -244
  166. package/seed/marketplaces/ecc/skills/clickhouse-io/SKILL.md +439 -439
  167. package/seed/marketplaces/ecc/skills/code-tour/SKILL.md +236 -236
  168. package/seed/marketplaces/ecc/skills/codebase-onboarding/SKILL.md +233 -233
  169. package/seed/marketplaces/ecc/skills/coding-standards/SKILL.md +549 -549
  170. package/seed/marketplaces/ecc/skills/compose-multiplatform-patterns/SKILL.md +299 -299
  171. package/seed/marketplaces/ecc/skills/configure-ecc/SKILL.md +384 -384
  172. package/seed/marketplaces/ecc/skills/connections-optimizer/SKILL.md +189 -189
  173. package/seed/marketplaces/ecc/skills/content-engine/SKILL.md +131 -131
  174. package/seed/marketplaces/ecc/skills/content-hash-cache-pattern/SKILL.md +161 -161
  175. package/seed/marketplaces/ecc/skills/context-budget/SKILL.md +135 -135
  176. package/seed/marketplaces/ecc/skills/continuous-agent-loop/SKILL.md +45 -45
  177. package/seed/marketplaces/ecc/skills/continuous-learning/SKILL.md +131 -131
  178. package/seed/marketplaces/ecc/skills/continuous-learning/config.json +18 -18
  179. package/seed/marketplaces/ecc/skills/continuous-learning/evaluate-session.sh +69 -69
  180. package/seed/marketplaces/ecc/skills/continuous-learning-v2/SKILL.md +360 -360
  181. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer-loop.sh +322 -322
  182. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer.md +198 -198
  183. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/session-guardian.sh +150 -150
  184. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/start-observer.sh +248 -248
  185. package/seed/marketplaces/ecc/skills/continuous-learning-v2/config.json +8 -8
  186. package/seed/marketplaces/ecc/skills/continuous-learning-v2/hooks/observe.sh +498 -498
  187. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/detect-project.sh +322 -322
  188. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/instinct-cli.py +1826 -1826
  189. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/lib/homunculus-dir.sh +31 -31
  190. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/migrate-homunculus.sh +62 -62
  191. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/test_parse_instinct.py +1018 -1018
  192. package/seed/marketplaces/ecc/skills/cost-aware-llm-pipeline/SKILL.md +183 -183
  193. package/seed/marketplaces/ecc/skills/cost-tracking/SKILL.md +147 -147
  194. package/seed/marketplaces/ecc/skills/council/SKILL.md +203 -203
  195. package/seed/marketplaces/ecc/skills/cpp-coding-standards/SKILL.md +723 -723
  196. package/seed/marketplaces/ecc/skills/cpp-testing/SKILL.md +324 -324
  197. package/seed/marketplaces/ecc/skills/crosspost/SKILL.md +111 -111
  198. package/seed/marketplaces/ecc/skills/csharp-testing/SKILL.md +321 -321
  199. package/seed/marketplaces/ecc/skills/customer-billing-ops/SKILL.md +140 -140
  200. package/seed/marketplaces/ecc/skills/customs-trade-compliance/SKILL.md +263 -263
  201. package/seed/marketplaces/ecc/skills/dart-flutter-patterns/SKILL.md +563 -563
  202. package/seed/marketplaces/ecc/skills/dashboard-builder/SKILL.md +108 -108
  203. package/seed/marketplaces/ecc/skills/data-scraper-agent/SKILL.md +764 -764
  204. package/seed/marketplaces/ecc/skills/data-throughput-accelerator/SKILL.md +72 -72
  205. package/seed/marketplaces/ecc/skills/database-migrations/SKILL.md +429 -429
  206. package/seed/marketplaces/ecc/skills/deep-research/SKILL.md +159 -159
  207. package/seed/marketplaces/ecc/skills/defi-amm-security/SKILL.md +166 -166
  208. package/seed/marketplaces/ecc/skills/deployment-patterns/SKILL.md +427 -427
  209. package/seed/marketplaces/ecc/skills/design-system/SKILL.md +82 -82
  210. package/seed/marketplaces/ecc/skills/django-celery/SKILL.md +457 -457
  211. package/seed/marketplaces/ecc/skills/django-patterns/SKILL.md +734 -734
  212. package/seed/marketplaces/ecc/skills/django-security/SKILL.md +593 -593
  213. package/seed/marketplaces/ecc/skills/django-tdd/SKILL.md +729 -729
  214. package/seed/marketplaces/ecc/skills/django-verification/SKILL.md +469 -469
  215. package/seed/marketplaces/ecc/skills/dmux-workflows/SKILL.md +191 -191
  216. package/seed/marketplaces/ecc/skills/docker-patterns/SKILL.md +364 -364
  217. package/seed/marketplaces/ecc/skills/documentation-lookup/SKILL.md +90 -90
  218. package/seed/marketplaces/ecc/skills/dotnet-patterns/SKILL.md +321 -321
  219. package/seed/marketplaces/ecc/skills/e2e-testing/SKILL.md +326 -326
  220. package/seed/marketplaces/ecc/skills/ecc-guide/SKILL.md +189 -189
  221. package/seed/marketplaces/ecc/skills/ecc-tools-cost-audit/SKILL.md +160 -160
  222. package/seed/marketplaces/ecc/skills/email-ops/SKILL.md +121 -121
  223. package/seed/marketplaces/ecc/skills/energy-procurement/SKILL.md +228 -228
  224. package/seed/marketplaces/ecc/skills/enterprise-agent-ops/SKILL.md +50 -50
  225. package/seed/marketplaces/ecc/skills/error-handling/SKILL.md +376 -376
  226. package/seed/marketplaces/ecc/skills/eval-harness/SKILL.md +270 -270
  227. package/seed/marketplaces/ecc/skills/evm-token-decimals/SKILL.md +130 -130
  228. package/seed/marketplaces/ecc/skills/exa-search/SKILL.md +107 -107
  229. package/seed/marketplaces/ecc/skills/fal-ai-media/SKILL.md +288 -288
  230. package/seed/marketplaces/ecc/skills/fastapi-patterns/SKILL.md +327 -327
  231. package/seed/marketplaces/ecc/skills/finance-billing-ops/SKILL.md +127 -127
  232. package/seed/marketplaces/ecc/skills/flox-environments/SKILL.md +496 -496
  233. package/seed/marketplaces/ecc/skills/flutter-dart-code-review/SKILL.md +435 -435
  234. package/seed/marketplaces/ecc/skills/foundation-models-on-device/SKILL.md +243 -243
  235. package/seed/marketplaces/ecc/skills/frontend-a11y/SKILL.md +446 -446
  236. package/seed/marketplaces/ecc/skills/frontend-design-direction/SKILL.md +92 -92
  237. package/seed/marketplaces/ecc/skills/frontend-patterns/SKILL.md +642 -642
  238. package/seed/marketplaces/ecc/skills/frontend-slides/SKILL.md +184 -184
  239. package/seed/marketplaces/ecc/skills/frontend-slides/STYLE_PRESETS.md +330 -330
  240. package/seed/marketplaces/ecc/skills/frontend-slides/animation-patterns.md +122 -122
  241. package/seed/marketplaces/ecc/skills/frontend-slides/html-template.md +419 -419
  242. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/export-pdf.sh +418 -418
  243. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/extract-pptx.py +96 -96
  244. package/seed/marketplaces/ecc/skills/frontend-slides/viewport-base.css +153 -153
  245. package/seed/marketplaces/ecc/skills/fsharp-testing/SKILL.md +280 -280
  246. package/seed/marketplaces/ecc/skills/gan-style-harness/SKILL.md +278 -278
  247. package/seed/marketplaces/ecc/skills/gateguard/SKILL.md +125 -125
  248. package/seed/marketplaces/ecc/skills/git-workflow/SKILL.md +715 -715
  249. package/seed/marketplaces/ecc/skills/github-ops/SKILL.md +144 -144
  250. package/seed/marketplaces/ecc/skills/golang-patterns/SKILL.md +674 -674
  251. package/seed/marketplaces/ecc/skills/golang-testing/SKILL.md +720 -720
  252. package/seed/marketplaces/ecc/skills/google-workspace-ops/SKILL.md +95 -95
  253. package/seed/marketplaces/ecc/skills/healthcare-cdss-patterns/SKILL.md +245 -245
  254. package/seed/marketplaces/ecc/skills/healthcare-emr-patterns/SKILL.md +159 -159
  255. package/seed/marketplaces/ecc/skills/healthcare-eval-harness/SKILL.md +207 -207
  256. package/seed/marketplaces/ecc/skills/healthcare-phi-compliance/SKILL.md +145 -145
  257. package/seed/marketplaces/ecc/skills/hermes-imports/SKILL.md +88 -88
  258. package/seed/marketplaces/ecc/skills/hexagonal-architecture/SKILL.md +276 -276
  259. package/seed/marketplaces/ecc/skills/hipaa-compliance/SKILL.md +78 -78
  260. package/seed/marketplaces/ecc/skills/homelab-network-readiness/SKILL.md +169 -169
  261. package/seed/marketplaces/ecc/skills/homelab-network-setup/SKILL.md +129 -129
  262. package/seed/marketplaces/ecc/skills/homelab-pihole-dns/SKILL.md +274 -274
  263. package/seed/marketplaces/ecc/skills/homelab-vlan-segmentation/SKILL.md +311 -311
  264. package/seed/marketplaces/ecc/skills/homelab-wireguard-vpn/SKILL.md +305 -305
  265. package/seed/marketplaces/ecc/skills/hookify-rules/SKILL.md +128 -128
  266. package/seed/marketplaces/ecc/skills/inventory-demand-planning/SKILL.md +247 -247
  267. package/seed/marketplaces/ecc/skills/investor-materials/SKILL.md +96 -96
  268. package/seed/marketplaces/ecc/skills/investor-outreach/SKILL.md +91 -91
  269. package/seed/marketplaces/ecc/skills/ios-icon-gen/SKILL.md +157 -157
  270. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/generate_icons.swift +258 -258
  271. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/iconify_gen.sh +235 -235
  272. package/seed/marketplaces/ecc/skills/iterative-retrieval/SKILL.md +211 -211
  273. package/seed/marketplaces/ecc/skills/ito-basket-compare/SKILL.md +63 -63
  274. package/seed/marketplaces/ecc/skills/ito-data-atlas-agent/SKILL.md +63 -63
  275. package/seed/marketplaces/ecc/skills/ito-market-intelligence/SKILL.md +60 -60
  276. package/seed/marketplaces/ecc/skills/ito-trade-planner/SKILL.md +67 -67
  277. package/seed/marketplaces/ecc/skills/java-coding-standards/SKILL.md +383 -383
  278. package/seed/marketplaces/ecc/skills/jira-integration/SKILL.md +293 -293
  279. package/seed/marketplaces/ecc/skills/jpa-patterns/SKILL.md +151 -151
  280. package/seed/marketplaces/ecc/skills/knowledge-ops/SKILL.md +154 -154
  281. package/seed/marketplaces/ecc/skills/kotlin-coroutines-flows/SKILL.md +284 -284
  282. package/seed/marketplaces/ecc/skills/kotlin-exposed-patterns/SKILL.md +719 -719
  283. package/seed/marketplaces/ecc/skills/kotlin-ktor-patterns/SKILL.md +689 -689
  284. package/seed/marketplaces/ecc/skills/kotlin-patterns/SKILL.md +711 -711
  285. package/seed/marketplaces/ecc/skills/kotlin-testing/SKILL.md +824 -824
  286. package/seed/marketplaces/ecc/skills/laravel-patterns/SKILL.md +415 -415
  287. package/seed/marketplaces/ecc/skills/laravel-plugin-discovery/SKILL.md +229 -229
  288. package/seed/marketplaces/ecc/skills/laravel-security/SKILL.md +285 -285
  289. package/seed/marketplaces/ecc/skills/laravel-tdd/SKILL.md +283 -283
  290. package/seed/marketplaces/ecc/skills/laravel-verification/SKILL.md +179 -179
  291. package/seed/marketplaces/ecc/skills/latency-critical-systems/SKILL.md +73 -73
  292. package/seed/marketplaces/ecc/skills/lead-intelligence/SKILL.md +321 -321
  293. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/enrichment-agent.md +85 -85
  294. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/mutual-mapper.md +75 -75
  295. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/outreach-drafter.md +98 -98
  296. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/signal-scorer.md +60 -60
  297. package/seed/marketplaces/ecc/skills/liquid-glass-design/SKILL.md +279 -279
  298. package/seed/marketplaces/ecc/skills/llm-trading-agent-security/SKILL.md +146 -146
  299. package/seed/marketplaces/ecc/skills/logistics-exception-management/SKILL.md +222 -222
  300. package/seed/marketplaces/ecc/skills/make-interfaces-feel-better/SKILL.md +151 -151
  301. package/seed/marketplaces/ecc/skills/manim-video/SKILL.md +89 -89
  302. package/seed/marketplaces/ecc/skills/manim-video/assets/network_graph_scene.py +52 -52
  303. package/seed/marketplaces/ecc/skills/market-research/SKILL.md +75 -75
  304. package/seed/marketplaces/ecc/skills/marketing-campaign/SKILL.md +113 -113
  305. package/seed/marketplaces/ecc/skills/mcp-server-patterns/SKILL.md +69 -69
  306. package/seed/marketplaces/ecc/skills/messages-ops/SKILL.md +104 -104
  307. package/seed/marketplaces/ecc/skills/mle-workflow/SKILL.md +346 -346
  308. package/seed/marketplaces/ecc/skills/motion-advanced/SKILL.md +596 -596
  309. package/seed/marketplaces/ecc/skills/motion-foundations/SKILL.md +299 -299
  310. package/seed/marketplaces/ecc/skills/motion-patterns/SKILL.md +435 -435
  311. package/seed/marketplaces/ecc/skills/motion-ui/SKILL.md +575 -575
  312. package/seed/marketplaces/ecc/skills/mysql-patterns/SKILL.md +412 -412
  313. package/seed/marketplaces/ecc/skills/nanoclaw-repl/SKILL.md +33 -33
  314. package/seed/marketplaces/ecc/skills/nestjs-patterns/SKILL.md +230 -230
  315. package/seed/marketplaces/ecc/skills/netmiko-ssh-automation/SKILL.md +173 -173
  316. package/seed/marketplaces/ecc/skills/network-bgp-diagnostics/SKILL.md +167 -167
  317. package/seed/marketplaces/ecc/skills/network-config-validation/SKILL.md +210 -210
  318. package/seed/marketplaces/ecc/skills/network-interface-health/SKILL.md +152 -152
  319. package/seed/marketplaces/ecc/skills/nextjs-turbopack/SKILL.md +57 -57
  320. package/seed/marketplaces/ecc/skills/nodejs-keccak256/SKILL.md +102 -102
  321. package/seed/marketplaces/ecc/skills/nutrient-document-processing/SKILL.md +167 -167
  322. package/seed/marketplaces/ecc/skills/nuxt4-patterns/SKILL.md +100 -100
  323. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/SKILL.md +288 -288
  324. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.py +224 -224
  325. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.sh +5 -5
  326. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  327. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  328. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  329. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  330. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  331. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/output-template.md +166 -166
  332. package/seed/marketplaces/ecc/skills/opensource-pipeline/SKILL.md +255 -255
  333. package/seed/marketplaces/ecc/skills/parallel-execution-optimizer/SKILL.md +72 -72
  334. package/seed/marketplaces/ecc/skills/perl-patterns/SKILL.md +504 -504
  335. package/seed/marketplaces/ecc/skills/perl-security/SKILL.md +503 -503
  336. package/seed/marketplaces/ecc/skills/perl-testing/SKILL.md +475 -475
  337. package/seed/marketplaces/ecc/skills/plan-orchestrate/SKILL.md +262 -262
  338. package/seed/marketplaces/ecc/skills/plankton-code-quality/SKILL.md +236 -236
  339. package/seed/marketplaces/ecc/skills/postgres-patterns/SKILL.md +147 -147
  340. package/seed/marketplaces/ecc/skills/prediction-market-oracle-research/SKILL.md +63 -63
  341. package/seed/marketplaces/ecc/skills/prediction-market-risk-review/SKILL.md +60 -60
  342. package/seed/marketplaces/ecc/skills/prisma-patterns/SKILL.md +371 -371
  343. package/seed/marketplaces/ecc/skills/product-capability/SKILL.md +141 -141
  344. package/seed/marketplaces/ecc/skills/product-lens/SKILL.md +92 -92
  345. package/seed/marketplaces/ecc/skills/production-audit/SKILL.md +206 -206
  346. package/seed/marketplaces/ecc/skills/production-scheduling/SKILL.md +238 -238
  347. package/seed/marketplaces/ecc/skills/project-flow-ops/SKILL.md +111 -111
  348. package/seed/marketplaces/ecc/skills/prompt-optimizer/SKILL.md +398 -398
  349. package/seed/marketplaces/ecc/skills/python-patterns/SKILL.md +750 -750
  350. package/seed/marketplaces/ecc/skills/python-testing/SKILL.md +816 -816
  351. package/seed/marketplaces/ecc/skills/pytorch-patterns/SKILL.md +396 -396
  352. package/seed/marketplaces/ecc/skills/quality-nonconformance/SKILL.md +260 -260
  353. package/seed/marketplaces/ecc/skills/quarkus-patterns/SKILL.md +722 -722
  354. package/seed/marketplaces/ecc/skills/quarkus-security/SKILL.md +467 -467
  355. package/seed/marketplaces/ecc/skills/quarkus-tdd/SKILL.md +811 -811
  356. package/seed/marketplaces/ecc/skills/quarkus-verification/SKILL.md +479 -479
  357. package/seed/marketplaces/ecc/skills/ralphinho-rfc-pipeline/SKILL.md +67 -67
  358. package/seed/marketplaces/ecc/skills/recsys-pipeline-architect/SKILL.md +114 -114
  359. package/seed/marketplaces/ecc/skills/recursive-decision-ledger/SKILL.md +79 -79
  360. package/seed/marketplaces/ecc/skills/redis-patterns/SKILL.md +403 -403
  361. package/seed/marketplaces/ecc/skills/regex-vs-llm-structured-text/SKILL.md +220 -220
  362. package/seed/marketplaces/ecc/skills/remotion-video-creation/SKILL.md +43 -43
  363. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/3d.md +86 -86
  364. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/animations.md +29 -29
  365. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/charts-bar-chart.tsx +173 -173
  366. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-typewriter.tsx +100 -100
  367. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-word-highlight.tsx +108 -108
  368. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets.md +78 -78
  369. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/audio.md +172 -172
  370. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/calculate-metadata.md +104 -104
  371. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/can-decode.md +75 -75
  372. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/charts.md +58 -58
  373. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/compositions.md +146 -146
  374. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/display-captions.md +126 -126
  375. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/extract-frames.md +229 -229
  376. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/fonts.md +152 -152
  377. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-audio-duration.md +58 -58
  378. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-dimensions.md +68 -68
  379. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-duration.md +58 -58
  380. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/gifs.md +138 -138
  381. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/images.md +130 -130
  382. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/import-srt-captions.md +67 -67
  383. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/lottie.md +67 -67
  384. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-dom-nodes.md +34 -34
  385. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-text.md +143 -143
  386. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/sequencing.md +106 -106
  387. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/tailwind.md +11 -11
  388. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/text-animations.md +20 -20
  389. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/timing.md +179 -179
  390. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transcribe-captions.md +19 -19
  391. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transitions.md +122 -122
  392. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/trimming.md +52 -52
  393. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/videos.md +171 -171
  394. package/seed/marketplaces/ecc/skills/repo-scan/SKILL.md +78 -78
  395. package/seed/marketplaces/ecc/skills/research-ops/SKILL.md +112 -112
  396. package/seed/marketplaces/ecc/skills/returns-reverse-logistics/SKILL.md +240 -240
  397. package/seed/marketplaces/ecc/skills/rules-distill/SKILL.md +264 -264
  398. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-rules.sh +58 -58
  399. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-skills.sh +129 -129
  400. package/seed/marketplaces/ecc/skills/rust-patterns/SKILL.md +499 -499
  401. package/seed/marketplaces/ecc/skills/rust-testing/SKILL.md +500 -500
  402. package/seed/marketplaces/ecc/skills/safety-guard/SKILL.md +75 -75
  403. package/seed/marketplaces/ecc/skills/santa-method/SKILL.md +306 -306
  404. package/seed/marketplaces/ecc/skills/scientific-db-pubmed-database/SKILL.md +175 -175
  405. package/seed/marketplaces/ecc/skills/scientific-db-uspto-database/SKILL.md +177 -177
  406. package/seed/marketplaces/ecc/skills/scientific-pkg-gget/SKILL.md +166 -166
  407. package/seed/marketplaces/ecc/skills/scientific-thinking-literature-review/SKILL.md +192 -192
  408. package/seed/marketplaces/ecc/skills/scientific-thinking-scholar-evaluation/SKILL.md +160 -160
  409. package/seed/marketplaces/ecc/skills/search-first/SKILL.md +182 -182
  410. package/seed/marketplaces/ecc/skills/security-bounty-hunter/SKILL.md +99 -99
  411. package/seed/marketplaces/ecc/skills/security-review/SKILL.md +503 -503
  412. package/seed/marketplaces/ecc/skills/security-review/cloud-infrastructure-security.md +361 -361
  413. package/seed/marketplaces/ecc/skills/security-scan/SKILL.md +165 -165
  414. package/seed/marketplaces/ecc/skills/seo/SKILL.md +154 -154
  415. package/seed/marketplaces/ecc/skills/skill-comply/SKILL.md +58 -58
  416. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/compliant_trace.jsonl +5 -5
  417. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/noncompliant_trace.jsonl +3 -3
  418. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/tdd_spec.yaml +44 -44
  419. package/seed/marketplaces/ecc/skills/skill-comply/prompts/classifier.md +24 -24
  420. package/seed/marketplaces/ecc/skills/skill-comply/prompts/scenario_generator.md +62 -62
  421. package/seed/marketplaces/ecc/skills/skill-comply/prompts/spec_generator.md +42 -42
  422. package/seed/marketplaces/ecc/skills/skill-comply/pyproject.toml +15 -15
  423. package/seed/marketplaces/ecc/skills/skill-comply/scripts/classifier.py +85 -85
  424. package/seed/marketplaces/ecc/skills/skill-comply/scripts/grader.py +124 -124
  425. package/seed/marketplaces/ecc/skills/skill-comply/scripts/parser.py +107 -107
  426. package/seed/marketplaces/ecc/skills/skill-comply/scripts/report.py +170 -170
  427. package/seed/marketplaces/ecc/skills/skill-comply/scripts/run.py +127 -127
  428. package/seed/marketplaces/ecc/skills/skill-comply/scripts/runner.py +186 -186
  429. package/seed/marketplaces/ecc/skills/skill-comply/scripts/scenario_generator.py +70 -70
  430. package/seed/marketplaces/ecc/skills/skill-comply/scripts/spec_generator.py +72 -72
  431. package/seed/marketplaces/ecc/skills/skill-comply/scripts/utils.py +13 -13
  432. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_grader.py +197 -197
  433. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_parser.py +90 -90
  434. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_runner.py +172 -172
  435. package/seed/marketplaces/ecc/skills/skill-scout/SKILL.md +140 -140
  436. package/seed/marketplaces/ecc/skills/skill-stocktake/SKILL.md +194 -194
  437. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/quick-diff.sh +87 -87
  438. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/save-results.sh +56 -56
  439. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/scan.sh +170 -170
  440. package/seed/marketplaces/ecc/skills/social-graph-ranker/SKILL.md +154 -154
  441. package/seed/marketplaces/ecc/skills/social-publisher/SKILL.md +115 -115
  442. package/seed/marketplaces/ecc/skills/springboot-patterns/SKILL.md +314 -314
  443. package/seed/marketplaces/ecc/skills/springboot-security/SKILL.md +272 -272
  444. package/seed/marketplaces/ecc/skills/springboot-tdd/SKILL.md +158 -158
  445. package/seed/marketplaces/ecc/skills/springboot-verification/SKILL.md +231 -231
  446. package/seed/marketplaces/ecc/skills/strategic-compact/SKILL.md +131 -131
  447. package/seed/marketplaces/ecc/skills/swift-actor-persistence/SKILL.md +143 -143
  448. package/seed/marketplaces/ecc/skills/swift-concurrency-6-2/SKILL.md +216 -216
  449. package/seed/marketplaces/ecc/skills/swift-protocol-di-testing/SKILL.md +190 -190
  450. package/seed/marketplaces/ecc/skills/swiftui-patterns/SKILL.md +259 -259
  451. package/seed/marketplaces/ecc/skills/tdd-workflow/SKILL.md +463 -463
  452. package/seed/marketplaces/ecc/skills/team-builder/SKILL.md +168 -168
  453. package/seed/marketplaces/ecc/skills/terminal-ops/SKILL.md +109 -109
  454. package/seed/marketplaces/ecc/skills/tinystruct-patterns/SKILL.md +203 -203
  455. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/architecture.md +90 -90
  456. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/data-handling.md +60 -60
  457. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/database.md +99 -99
  458. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/routing.md +64 -64
  459. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/system-usage.md +97 -97
  460. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/testing.md +72 -72
  461. package/seed/marketplaces/ecc/skills/token-budget-advisor/SKILL.md +133 -133
  462. package/seed/marketplaces/ecc/skills/ui-demo/SKILL.md +465 -465
  463. package/seed/marketplaces/ecc/skills/ui-to-vue/SKILL.md +134 -134
  464. package/seed/marketplaces/ecc/skills/uncloud/SKILL.md +343 -343
  465. package/seed/marketplaces/ecc/skills/unified-notifications-ops/SKILL.md +187 -187
  466. package/seed/marketplaces/ecc/skills/verification-loop/SKILL.md +126 -126
  467. package/seed/marketplaces/ecc/skills/video-editing/SKILL.md +310 -310
  468. package/seed/marketplaces/ecc/skills/videodb/SKILL.md +374 -374
  469. package/seed/marketplaces/ecc/skills/videodb/reference/api-reference.md +550 -550
  470. package/seed/marketplaces/ecc/skills/videodb/reference/capture-reference.md +407 -407
  471. package/seed/marketplaces/ecc/skills/videodb/reference/capture.md +101 -101
  472. package/seed/marketplaces/ecc/skills/videodb/reference/editor.md +443 -443
  473. package/seed/marketplaces/ecc/skills/videodb/reference/generative.md +331 -331
  474. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream-reference.md +564 -564
  475. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream.md +65 -65
  476. package/seed/marketplaces/ecc/skills/videodb/reference/search.md +230 -230
  477. package/seed/marketplaces/ecc/skills/videodb/reference/streaming.md +406 -406
  478. package/seed/marketplaces/ecc/skills/videodb/reference/use-cases.md +118 -118
  479. package/seed/marketplaces/ecc/skills/videodb/scripts/ws_listener.py +282 -282
  480. package/seed/marketplaces/ecc/skills/visa-doc-translate/README.md +86 -86
  481. package/seed/marketplaces/ecc/skills/visa-doc-translate/SKILL.md +117 -117
  482. package/seed/marketplaces/ecc/skills/vite-patterns/SKILL.md +449 -449
  483. package/seed/marketplaces/ecc/skills/windows-desktop-e2e/SKILL.md +887 -887
  484. package/seed/marketplaces/ecc/skills/workspace-surface-audit/SKILL.md +125 -125
  485. package/seed/marketplaces/ecc/skills/x-api/SKILL.md +234 -234
  486. package/seed/marketplaces/ecc/.claude/commands/add-language-rules.md +0 -39
  487. package/seed/marketplaces/ecc/.claude/commands/database-migration.md +0 -36
  488. package/seed/marketplaces/ecc/.claude/commands/feature-development.md +0 -38
  489. package/seed/marketplaces/ecc/.claude/ecc-tools.json +0 -334
  490. package/seed/marketplaces/ecc/.claude/enterprise/controls.md +0 -15
  491. package/seed/marketplaces/ecc/.claude/homunculus/instincts/inherited/everything-claude-code-instincts.yaml +0 -162
  492. package/seed/marketplaces/ecc/.claude/identity.json +0 -14
  493. package/seed/marketplaces/ecc/.claude/package-manager.json +0 -4
  494. package/seed/marketplaces/ecc/.claude/research/everything-claude-code-research-playbook.md +0 -21
  495. package/seed/marketplaces/ecc/.claude/rules/everything-claude-code-guardrails.md +0 -43
  496. package/seed/marketplaces/ecc/.claude/rules/node.md +0 -56
  497. package/seed/marketplaces/ecc/.claude/skills/everything-claude-code/SKILL.md +0 -442
  498. package/seed/marketplaces/ecc/.claude/team/everything-claude-code-team-config.json +0 -15
  499. 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.