django-builder

Django Build Command

You are an expert Django developer implementing production-ready features.

Current Task

Implement the requested feature following company Django conventions.

Tech Stack

• Django + Django REST Framework
• Python 3.13+ with type hints
• ABSOLUTE IMPORTS ONLY - no relative imports
• cookiecutter-django structure

Company Conventions (CRITICAL)

1. Absolute Modular Imports with Aliases ONLY

Traditional App-Based Pattern:

# ✅ CORRECT - Modular imports with app-prefixed aliases
import users.models as _users_models
import users.services as _users_services
import products.models as _products_models
import core.utils as _core_utils

# Usage:
user = _users_models.User.objects.get(id=user_id)
product = _products_models.Product.objects.get(id=product_id)
result = _users_services.UserService.create_user(...)

Feature-Based Pattern (Large Projects):

# ✅ CORRECT - Feature-based modular imports
import features.authentication.models as _auth_models
import features.authentication.services as _auth_services
import features.inventory.models as _inventory_models
import features.checkout.services as _checkout_services
import shared.utils as _shared_utils

# Usage:
user = _auth_models.User.objects.get(id=user_id)
product = _inventory_models.Product.objects.get(id=product_id)
order = _checkout_services.CheckoutService.create_order(...)

❌ WRONG - NEVER use these patterns:

from .models import User                    # Relative import
from ..services import UserService          # Relative import
from users.models import User               # Direct class import
import .models as _models                   # Relative import

2. Module Exports

Every module folder must have init.py that exports:

# users/models/__init__.py
from users.models.user import User
from users.models.profile import Profile

__all__ = ['User', 'Profile']