TypeScript에서 지리 차단된 기능 극복하기: 시니어 아키텍트의 접근법

Source: Dev.to

이해하기 위한 과제

Geo‑blocking은 일반적으로 사용자의 IP 위치를 감지하고 기능 접근성을 제한하거나 변경하는 방식으로 작동합니다. 많은 레거시 시스템이나 문서화가 부족한 코드베이스는 지리적 위치에 대한 명시적인 마커나 설정이 없기 때문에, 시니어 아키텍트는 이 문제에 체계적으로 접근해야 합니다. 핵심은 테스트 중에 다양한 지역을 시뮬레이션하여 기능 접근성을 검증하는 것이며, 이는 모두 TypeScript 환경 내에서 이루어집니다.

전략 개요

다음 세 가지 핵심 단계에 집중합니다:

• 환경 변수나 API를 모킹하여 다양한 사용자 위치를 시뮬레이션합니다.
• 테스트 래퍼 또는 유틸리티를 만들어 위치 기반 테스트를 간소화합니다.
• 포괄적인 테스트를 구현하여 지리적 영역별 기능 접근성을 검증합니다.

단계 1: TypeScript에서 지리 위치 모킹

직접적인 문서가 부족한 경우, 시스템이 위치를 어떻게 감지하는지 파악하는 것이 중요합니다. 일반적으로 IP 기반 지리 위치는 외부 API나 내장 서비스를 통해 호출됩니다. 다음은 이를 모킹하는 방법입니다:

// geoLocationService.ts
export interface Location {
  countryCode: string;
  city?: string;
}

export function fetchUserLocation(): Promise {
  // In production, this would call an external API
  return fetch('/api/location')
    .then(res => res.json());
}

// Mock this during tests
export function mockLocation(location: Location) {
  (fetchUserLocation as any) = () => Promise.resolve(location);
}

테스트에서는 fetchUserLocation을 오버라이드하여 다양한 위치를 시뮬레이션할 수 있습니다.

단계 2: 위치 인식 테스트 유틸리티 구축

위치를 기반으로 기능 접근성을 확인하는 유틸리티 함수를 만들면 테스트 자동화가 쉬워집니다:

export async function testFeatureAccess(
  feature: string,
  allowedCountries: string[]
): Promise {
  const location = await fetchUserLocation();
  if (allowedCountries.includes(location.countryCode)) {
    console.log(`Feature ${feature} should be accessible in ${location.countryCode}`);
    return true;
  } else {
    console.log(`Feature ${feature} is restricted in ${location.countryCode}`);
    return false;
  }
}

이 추상화 덕분에 어떤 국가가 접근 권한을 가져야 하는지 지정하고, 프로그램matically 검증할 수 있습니다.

단계 3: 견고한 테스트 구현

여러 지리적 영역에 대해 합성 데이터를 사용해 테스트를 자동화합니다:

import { mockLocation, testFeatureAccess } from './geoUtils';

describe('Geo-blocked features test', () => {
  const featureName = 'PremiumContent';
  const allowedCountries = ['US', 'GB', 'CA'];

  const testLocations = [
    { countryCode: 'US' },
    { countryCode: 'FR' },
    { countryCode: 'CA' },
    { countryCode: 'JP' }
  ];

  testLocations.forEach(location => {
    it(`should verify access in ${location.countryCode}`, async () => {
      mockLocation(location);
      const hasAccess = await testFeatureAccess(featureName, allowedCountries);
      if (allowedCountries.includes(location.countryCode)) {
        expect(hasAccess).toBe(true);
      } else {
        expect(hasAccess).toBe(false);
      }
    });
  });
});

마무리 생각

명시적인 문서가 없는 상태에서 지리적 제한을 다루려면 유연하고 테스트 중심적인 접근이 필요합니다. 지리 위치 데이터를 시뮬레이션하고 테스트를 자동화함으로써 시니어 아키텍트는 기능 접근성이 비즈니스 및 법적 요구사항에 부합하는지 보장할 수 있습니다. 환경을 모듈화하고, 가능한 한 빨리 지리 위치 흐름을 문서화하여 향후 개발 작업을 간소화하세요.

🛠️ QA 팁

Pro Tip: Use TempoMail USA for generating disposable test accounts.