11단계 (착수): "3년 안에 전부 바꾸자!"
2 
32단계 (6개월): 요구사항 분석 중
4요건이 계속 늘어남
5레거시 시스템에서 "몰랐던" 비즈니스 규칙 발견
6 
73단계 (18개월): 개발 중
8레거시와 신규 시스템이 병렬로 운영 필요 → 이중 유지 비용 발생
9연동 복잡도 폭발
10 
114단계 (30개월): 전환 계획 무산
12"일단 레거시를 유지하면서 신규에 기능만 추가하자"
13→ 결국 두 개의 레거시 시스템이 생겨남

1[1단계: API 파사드 구축]
2레거시 시스템
3    ↕
4[API Gateway / Facade Layer]  ← 새로 만드는 것
5    ↕
6외부 시스템/사용자

1[2단계: 새 기능은 새 서비스로]
2레거시 시스템 (기존 기능 유지)
3    ↕
4[API Gateway]
5    ↕
6새 마이크로서비스 (신규 기능)

1[3단계: 레거시 기능을 하나씩 이전]
2레거시 시스템 (점점 줄어듦)
3    ↕
4[API Gateway]
5    ↕
6새 마이크로서비스 (점점 늘어남)

1[최종: 레거시 은퇴]
2[API Gateway]
3    ↕
4새 마이크로서비스 시스템 (전체)

1// API Gateway (Facade Layer) 구현 예시
2// 레거시와 신규 서비스를 라우팅
3 
4interface LegacyAccountService {
5  getAccountBalance(accountNo: string): Promise<LegacyBalanceResponse>;
6}
7 
8interface NewAccountService {
9  getBalance(accountId: string): Promise<BalanceResponse>;
10}
11 
12class AccountServiceFacade {
13  constructor(
14    private legacy: LegacyAccountService,
15    private newService: NewAccountService,
16    private featureFlags: FeatureFlagService
17  ) {}
18 
19  async getBalance(accountId: string): Promise<BalanceResponse> {
20    // 피처 플래그로 트래픽을 점진적으로 전환
21    const useNewService = await this.featureFlags.isEnabled(
22      'new-account-service',
23      { accountId }
24    );
25    
26    if (useNewService) {
27      // 신규 서비스 호출
28      return this.newService.getBalance(accountId);
29    } else {
30      // 레거시 호출 + 응답 형식 변환
31      const legacyResponse = await this.legacy.getAccountBalance(accountId);
32      return this.transformLegacyResponse(legacyResponse);
33    }
34  }
35 
36  private transformLegacyResponse(legacy: LegacyBalanceResponse): BalanceResponse {
37    return {
38      accountId: legacy.ACCT_NO,
39      balance: parseFloat(legacy.BAL_AMT) / 100,  // 레거시는 전으로 저장
40      currency: legacy.CURR_CD || 'KRW',
41      updatedAt: this.parseKoreanDate(legacy.UPD_DT)
42    };
43  }
44}

11주차: 내부 테스트 트래픽 1%만 신규 서비스로
22주차: 10%로 확대, 오류율 모니터링
34주차: 50%로 확대, 성능 비교
48주차: 100%로 전환
512주차: 레거시 해당 기능 비활성화

1// 불변 감사 로그 (수정/삭제 불가)
2interface AuditLog {
3  eventId: string;          // UUID
4  timestamp: string;        // ISO 8601
5  userId: string;           // 직원 ID
6  action: string;           // 'read' | 'write' | 'approve' | 'reject'
7  resourceType: string;     // 'account' | 'transfer' | 'loan'
8  resourceId: string;       // 계좌번호 등
9  ipAddress: string;        // 접근 IP
10  result: 'success' | 'failure';
11  hash: string;             // 이전 로그 해시 (체인 구조)
12}
13 
14// 감사 로그는 별도 불변 스토리지에 저장
15// (PostgreSQL Append-only 테이블 또는 전용 감사 DB)
16CREATE TABLE audit_logs (
17  event_id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
18  timestamp TIMESTAMPTZ NOT NULL DEFAULT NOW(),
19  -- ... 기타 컬럼
20) WITH (autovacuum_enabled = false);  -- 자동 삭제 방지
21 
22-- 삭제 방지 규칙
23CREATE RULE no_delete_audit AS ON DELETE TO audit_logs DO INSTEAD NOTHING;
24CREATE RULE no_update_audit AS ON UPDATE TO audit_logs DO INSTEAD NOTHING;

1[1~3개월: 준비 단계]
2□ 레거시 시스템 전수 조사 (기능 목록, 데이터 흐름 맵)
3□ 비즈니스 로직 문서화 (DB 저장 프로시저 역공학 포함)
4□ 규제 준수 체크리스트 작성
5□ API Facade 아키텍처 설계
6□ 파일럿 도메인 선정 (가장 독립적인 도메인)
7 
8[4~9개월: 파일럿 실행]
9□ API Gateway/Facade 레이어 구축
10□ 파일럿 도메인 신규 서비스 개발
11□ 레거시 ↔ 신규 데이터 동기화 설계
12□ 스테이징 환경 검증
13□ 규제 기관 사전 협의 (필요 시)
14 
15[10~18개월: 확장]
16□ 파일럿 결과 기반 전환 패턴 표준화
17□ 2~3개 도메인 동시 전환
18□ 데이터 마이그레이션 검증
19□ 성능 테스트 (레거시 동등 이상)
20 
21[19~24개월: 레거시 축소]
22□ 전환된 도메인의 레거시 기능 비활성화
23□ 레거시 운영 비용 단계적 절감
24□ 전체 시스템 안정화
25□ 감사 및 컴플라이언스 최종 검토

1# 레거시 ↔ 신규 시스템 데이터 정합성 검증
2def verify_account_migration(legacy_db, new_db, sample_size=10000):
3    legacy_accounts = legacy_db.query(
4        "SELECT ACCT_NO, BAL_AMT FROM ACCOUNTS ORDER BY RANDOM() LIMIT %s",
5        sample_size
6    )
7    
8    mismatches = []
9    for acct in legacy_accounts:
10        new_balance = new_db.get_balance(acct.ACCT_NO)
11        legacy_balance = float(acct.BAL_AMT) / 100
12        
13        if abs(new_balance - legacy_balance) > 0.01:  # 1원 오차 허용
14            mismatches.append({
15                'account': acct.ACCT_NO,
16                'legacy': legacy_balance,
17                'new': new_balance,
18                'diff': abs(new_balance - legacy_balance)
19            })
20    
21    accuracy = (sample_size - len(mismatches)) / sample_size * 100
22    return accuracy, mismatches