mirror of
https://github.com/HackSoftware/Django-Styleguide.git
synced 2024-09-21 19:38:58 +03:00
27 lines
888 B
Markdown
27 lines
888 B
Markdown
# Django Styleguide
|
|
|
|
Django styleguide used in [HackSoft](https://hacksoft.io) projects.
|
|
|
|
Expect often updates as we discuss & decide upon different things.
|
|
|
|
## Overview
|
|
|
|
**In Django, business logic should live in:**
|
|
|
|
* Model properties (with some exceptions).
|
|
* Model `clean` method for additional validations (with some exceptions).
|
|
* Services - functions, that take care of code written to the database.
|
|
* Selectors - functions, that take care of code taken from the database.
|
|
|
|
**In Django, business logic should not live in:**
|
|
|
|
* APIs and Views.
|
|
* Serializers and Forms.
|
|
* Form tags.
|
|
* Model `save` method.
|
|
|
|
**Model properties vs selectors:**
|
|
|
|
* If the model property spans multiple relations, it should better be a selector.
|
|
* If a model property, added to some list API, will cause `N + 1` problem that cannot be easily solved with `select_related`, it should better be a selector.
|