multitenetsaas/backend/tests/contract/test_tenants_get.py

"""
Contract test for GET /tenants endpoint.
This test MUST fail before implementation.
"""

import pytest
from django.test import TestCase
from django.urls import reverse
from rest_framework.test import APIClient
from rest_framework import status
import json


class TenantsGetContractTest(TestCase):
    def setUp(self):
        self.client = APIClient()
        self.tenants_url = '/api/v1/tenants/'

        # Admin authentication header
        self.admin_auth = {'HTTP_AUTHORIZATION': 'Bearer admin_token'}

    def test_get_tenants_success(self):
        """Test successful retrieval of tenants list."""
        response = self.client.get(
            self.tenants_url,
            **self.admin_auth
        )

        # This should fail before implementation
        assert response.status_code == status.HTTP_200_OK

        data = response.json()
        assert 'tenants' in data
        assert isinstance(data['tenants'], list)

        # Check pagination structure
        assert 'pagination' in data
        pagination = data['pagination']
        assert 'page' in pagination
        assert 'limit' in pagination
        assert 'total' in pagination
        assert 'pages' in pagination

    def test_get_tenants_unauthorized(self):
        """Test tenants list retrieval without authentication."""
        response = self.client.get(self.tenants_url)

        assert response.status_code == status.HTTP_401_UNAUTHORIZED

    def test_get_tenants_forbidden(self):
        """Test tenants list retrieval by non-admin user."""
        non_admin_auth = {'HTTP_AUTHORIZATION': 'Bearer user_token'}

        response = self.client.get(
            self.tenants_url,
            **non_admin_auth
        )

        assert response.status_code == status.HTTP_403_FORBIDDEN

    def test_get_tenants_with_pagination(self):
        """Test tenants list retrieval with pagination parameters."""
        params = {
            'page': 2,
            'limit': 10
        }

        response = self.client.get(
            self.tenants_url,
            data=params,
            **self.admin_auth
        )

        assert response.status_code == status.HTTP_200_OK

        data = response.json()
        assert data['pagination']['page'] == 2
        assert data['pagination']['limit'] == 10

    def test_get_tenants_with_search(self):
        """Test tenants list retrieval with search parameter."""
        params = {
            'search': 'test'
        }

        response = self.client.get(
            self.tenants_url,
            data=params,
            **self.admin_auth
        )

        assert response.status_code == status.HTTP_200_OK

        data = response.json()
        # All returned tenants should match search criteria
        for tenant in data['tenants']:
            assert 'test' in tenant['name'].lower()

    def test_get_tenants_filter_by_status(self):
        """Test tenants list retrieval filtered by status."""
        params = {
            'status': 'ACTIVE'
        }

        response = self.client.get(
            self.tenants_url,
            data=params,
            **self.admin_auth
        )

        assert response.status_code == status.HTTP_200_OK

        data = response.json()
        # All returned tenants should have the specified status
        for tenant in data['tenants']:
            assert tenant['status'] == 'ACTIVE'

    def test_get_tenants_data_structure(self):
        """Test that tenant data structure matches the contract."""
        response = self.client.get(
            self.tenants_url,
            **self.admin_auth
        )

        if response.status_code == status.HTTP_200_OK and len(response.json()['tenants']) > 0:
            tenant = response.json()['tenants'][0]

            # Required fields according to contract
            required_fields = [
                'id', 'name', 'slug', 'email', 'phone', 'business_type',
                'subscription_plan', 'pricing_model', 'status', 'created_at'
            ]

            for field in required_fields:
                assert field in tenant

            # Field types
            assert isinstance(tenant['id'], str)
            assert isinstance(tenant['name'], str)
            assert isinstance(tenant['slug'], str)
            assert isinstance(tenant['email'], str)
            assert tenant['business_type'] in ['RETAIL', 'HEALTHCARE', 'EDUCATION', 'LOGISTICS', 'BEAUTY']
            assert tenant['subscription_plan'] in ['STARTER', 'GROWTH', 'PRO', 'ENTERPRISE']
            assert tenant['pricing_model'] in ['SUBSCRIPTION', 'PERPETUAL']
            assert tenant['status'] in ['PENDING', 'ACTIVE', 'SUSPENDED', 'TERMINATED']