Municipal enterprises (report) | Notion

<aside> 🏢

Municipal enterprises (Entities): component overview, quick reference, security, then detailed sections.

</aside>

Summary

Model: Entity with fields title (unique), slug (32-char, unique), erdpou (optional), consumption (Decimal, 2 dp)
Relations: ForeignKey → Governor (related_name="entities")
Meta: ordering=-consumption, default_permissions=()
Signals: pre_save to auto-generate slug
Views: list_view, detail_view with @login_required, optional filters and pagination
URLs: list and detail pages by slug

Component quick reference

Component	Purpose	Key fields/aspects
models.py (Entity)	Legal entities / municipal enterprises	title (uniq), slug (32, uniq), erdpou (opt.), consumption (Decimal)
Relation to Governor	Supervisory hierarchy	ForeignKey, related_name="entities"
Meta	Model behavior	ordering=['-consumption']; default_permissions=()
Methods	Convenience access	str, get_absolute_url, get_devices
signals.py	Auto slug	pre_save → uuid.hex[:32] or random.choices
views.py	UI logic	list_view, detail_view, filters, pagination
urls.py	Routes	list, detail/:slug

Prod security quick notes

Auth required on list/detail
Roles and permissions: use custom permissions for narrow actions
Cookies and CSRF: Secure, HttpOnly, SameSite; CsrfViewMiddleware enabled
Audit: log Entity create/update and consumption changes