Multi-Tenancy Quick Reference¶

# settings.py - Already configured
MICBOARD_MULTI_SITE_MODE = False
MICBOARD_MSP_ENABLED = False

# settings.py
INSTALLED_APPS = ['django.contrib.sites', 'micboard', ...]
SITE_ID = 1
MICBOARD_MULTI_SITE_MODE = True

python manage.py migrate sites
python manage.py makemigrations micboard
python manage.py migrate micboard

# settings.py
INSTALLED_APPS = [
    'django.contrib.sites',
    'micboard',
    'micboard.multitenancy',  # Add this
    ...
]
SITE_ID = 1
MICBOARD_MULTI_SITE_MODE = True
MICBOARD_MSP_ENABLED = True
MIDDLEWARE += ['micboard.multitenancy.middleware.TenantMiddleware']

python manage.py migrate sites
python manage.py makemigrations micboard_multitenancy
python manage.py migrate micboard_multitenancy
python manage.py makemigrations micboard
python manage.py migrate micboard

from micboard.services import DeviceService

# Single-site (default)
receivers = DeviceService.get_active_receivers()

# Multi-site
receivers = DeviceService.get_active_receivers(site_id=1)

# MSP mode
receivers = DeviceService.get_active_receivers(
    organization_id=org.id,
    campus_id=campus.id  # Optional
)

from micboard.services import LocationService

# Get all locations (tenant-aware)
locations = LocationService.get_all_locations(
    organization_id=org.id,
    campus_id=campus.id
)

from micboard.services import ManufacturerService

# Sync devices for organization
result = ManufacturerService.sync_devices_for_manufacturer(
    manufacturer_code='shure',
    organization_id=org.id,
    campus_id=campus.id
)

from micboard.multitenancy.models import Organization, Campus

# Create organization
org = Organization.objects.create(
    name='University A',
    slug='university-a',
    site_id=1,
    subscription_tier='enterprise',
    max_devices=500
)

# Create campus
campus = Campus.objects.create(
    organization=org,
    name='North Campus',
    slug='north',
    city='Boston',
    state='MA'
)

# Assign buildings
from micboard.models import Building
Building.objects.filter(name__contains='Engineering').update(
    organization=org,
    campus=campus
)

from micboard.multitenancy.models import OrganizationMembership
from django.contrib.auth.models import User

user = User.objects.get(username='av_tech')

# Add user to organization
membership = OrganizationMembership.objects.create(
    user=user,
    organization=org,
    campus=campus,  # Optional: limit to campus
    role='operator'  # viewer/operator/admin/owner
)

from micboard.multitenancy.managers import TenantAwareManager

class MyModel(models.Model):
    objects = TenantAwareManager()

# Usage
qs = MyModel.objects.for_organization(organization=org)
qs = MyModel.objects.for_campus(campus_id=campus.id)
qs = MyModel.objects.for_user(user=request.user)

def my_view(request):
    # Access current organization
    org = request.organization  # Set by TenantMiddleware
    campus_id = request.campus_id

    # Use in service calls
    receivers = DeviceService.get_active_receivers(
        organization_id=org.id if org else None
    )

# Allow users to switch between organizations
def switch_org(request, org_id):
    # Verify user has access
    if OrganizationMembership.objects.filter(
        user=request.user,
        organization_id=org_id,
        is_active=True
    ).exists():
        request.session['current_organization_id'] = org_id
    return redirect('dashboard')

# settings.py
MICBOARD_SUBDOMAIN_ROUTING = True
MICBOARD_ROOT_DOMAIN = 'micboard.example.com'

# Access via subdomain
# university-a.micboard.example.com → Organization(slug='university-a')
# church-b.micboard.example.com → Organization(slug='church-b')

# Check permissions
if membership.can_modify_devices():
    # Allow device changes
    pass

if membership.can_manage_users():
    # Allow user management
    pass

micboard/
├── multitenancy/
│   ├── __init__.py          # Conditional imports
│   ├── models.py            # Organization/Campus/Membership
│   ├── managers.py          # TenantAwareManager
│   ├── middleware.py        # TenantMiddleware
│   ├── admin.py             # Django admin
│   └── apps.py              # App config
├── settings/
│   └── multitenancy.py      # Settings template
└── models/
    └── locations.py         # Updated for tenant support

docs/
├── multitenancy.md          # Full documentation
└── archive/root/MULTITENANCY_IMPLEMENTATION.md  # Implementation summary

# ✅ All of these work
DeviceService.get_active_receivers()
DeviceService.get_active_receivers(organization_id=1)
DeviceService.get_active_receivers(site_id=1, campus_id=2)

from micboard.multitenancy.models import Organization
from micboard.services import DeviceService

# Create test organization
org = Organization.objects.create(name='Test Org', slug='test', site_id=1)

# Test isolation
receivers = DeviceService.get_active_receivers(organization_id=org.id)
assert all(r.location.building.organization == org for r in receivers)

# Assign buildings to default org
org = Organization.objects.first()
Building.objects.filter(organization__isnull=True).update(organization=org)

# Check memberships
from micboard.multitenancy.models import OrganizationMembership
OrganizationMembership.objects.filter(user=user, is_active=True)

# Ensure Django settings loaded before importing multitenancy
import django
django.setup()
from micboard.multitenancy import is_msp_enabled

# No configuration needed - runs with zero overhead
MICBOARD_MSP_ENABLED = False

MICBOARD_MSP_ENABLED = True
MICBOARD_SITE_ISOLATION = 'campus'

# Campus-specific users
OrganizationMembership.objects.create(
    user=av_tech,
    organization=university,
    campus=north_campus,
    role='operator'
)

MICBOARD_MSP_ENABLED = True
MICBOARD_SITE_ISOLATION = 'organization'
MICBOARD_ALLOW_CROSS_ORG_VIEW = False
MICBOARD_SUBDOMAIN_ROUTING = True

# Each customer is separate organization
church_a = Organization.objects.create(name='Church A', ...)
church_b = Organization.objects.create(name='Church B', ...)