---

name: tg-standards description: > Django development standards for the Tellurium Games World of Darkness application. Use when: creating/editing models (characters, items, locations), implementing CRUD views, building forms, creating templates, configuring URLs, working with permissions, caching, migrations, testing, validation, deployment, or management commands. Triggers on: model inheritance patterns, polymorphic models, view mixins, gameline-specific code (vampire/werewolf/mage/wraith/changeling/demon/mummy/hunter), tg-card components, XP/freebie transactions, ST permissions, character templates, frontend styling.

TG Standards

Django patterns and conventions for the World of Darkness application.

Decision Tree

What are you working on?

Core Conventions (Always Apply)

Model Type Registration

Copytype = "model_name"      # Snake_case, matches URL pattern
gameline = "gameline"    # vtm, wta, mta, wto, ctd, dtf, mtr, htr

URL Namespace Pattern

Copyapp:gameline:action:model_type

Required Model Methods

Copydef get_absolute_url(self):
    return reverse("app:gameline:detail:model_type", kwargs={"pk": self.pk})

def get_update_url(self):
    return reverse("app:gameline:update:model_type", kwargs={"pk": self.pk})
# get_heading() inherited from core.models.Model - returns f"{gameline}_heading"

Mixin Stacking Order

Copyclass MyUpdateView(EditPermissionMixin, MessageMixin, UpdateView): pass
class MyListView(VisibilityFilterMixin, ListView): pass
class MyCreateView(LoginRequiredMixin, MessageMixin, CreateView): pass

Template Classes

Use tg-card, tg-table, tg-badge, tg-btn (not Bootstrap defaults).

Gameline Headings

Use {{ object.get_heading }} for dynamic class.

File Location Pattern

Quick Checklist

New Model

• Proper base class (Character/Human, ItemModel, LocationModel, or Model)
• type and gameline set
• __str__, get_absolute_url, get_update_url
• Meta with verbose_name, verbose_name_plural, ordering
• Migration created

New View

• Correct mixin order
• select_related/prefetch_related for optimization
• Form class selection based on permissions in UpdateView

New Template

• Extends appropriate base
• Uses tg-* classes
• Gameline heading on cards
• Loads {% load dots sanitize_text %} if using those filters