@funnycode/myclaude 0.1.71 → 0.1.73

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