Gemini AI를 사용하여 OpenCart 3 기반의 멀티 테넌트 이커머스 SaaS 플랫폼을 구축한 방법

Gemini AI를 사용하여 OpenCart 3 기반의 멀티 테넌트 이커머스 SaaS 플랫폼을 구축한 방법

안녕하세요 Dev.to 여러분! 제 이름은 Alex입니다. 몇 년 전 저는 슬로바키아로 이주했습니다. 공장과 산업 현장에서 몇 년간 근무한 후, 육체적으로 힘든 일에 지쳐 스스로를 위해 일하기로 결심했습니다. 저는 HTML/CSS, PHP, 그리고 Linux 서버 관리 분야에서 쌓은 모든 경험을 저만의 제품인 Hostatto.com 이커머스 플랫폼을 만드는 데 쏟아붓고 싶었습니다.

Gemini가 코드를 작성할 수 있다는 사실을 발견한 후, 저는 이전에는 혼자서 구축할 수 없었던 것, 즉 단일 서버에서 빠르고 효율적으로 작동하며 확장 가능한 온라인 스토어 생성 플랫폼을 만들기 위해 Gemini를 사용하기로 결정했습니다.

저는 제품 관리자(Product Manager), 시스템 아키텍트(System Architect), 그리고 품질 보증 엔지니어(Quality Assurance Engineer) 역할을 수행했고, Gemini는 저의 기술적 요구 사항과 사양을 바탕으로 코드를 생성했습니다.

아래에서는 이 플랫폼의 기술적 아키텍처(Architecture)에 대해 설명하겠습니다.

1. 멀티 테넌트 아키텍처 (공유 파일 시스템, 고객별 개별 데이터베이스)

이커머스 SaaS 플랫폼을 설계할 때 가장 큰 과제는 자원을 낭비하지 않으면서 단일 VPS 서버에서 효율적인 확장성(Scalability)을 달성하는 것입니다. 저는 처음부터 모든 고객을 위해 애플리케이션 파일의 별도 복사본을 배포하는 방식을 거부했습니다.

대신, 플랫폼은 다음과 같은 방식으로 환경을 동적으로 분리합니다.

공유 애플리케이션 코드 (Shared Application Code)

모든 온라인 스토어는 단일 공유 코드베이스(Codebase)에서 실행됩니다. 제가 업데이트를 출시하거나, 시스템 파일을 최적화하거나, 버그를 수정할 때마다 그 변경 사항은 모든 스토어에 즉시 적용됩니다.

격리된 데이터베이스 (Isolated Databases)

각 스토어는 전용 MySQL 데이터베이스를 할당받습니다. 복잡한 접두사가 붙은 테이블을 공유하지 않으므로, 완전한 데이터 격리(Data Isolation)와 향상된 보안을 보장합니다.

**프로세스 격리 (Process Isolation)

스토어들은 동일한 PHP 실행 프로세스를 공유하지 않습니다. 모든 고객은 격리된 PHP-FPM 풀 소켓 (php8.1-fpm-storeN.sock), 엄격한 open_basedir 제한, 그리고 잠재적으로 위험한 PHP 함수 비활성화를 할당받아 계정 간 데이터 접근을 방지합니다.

아래 다이어그램은 전체 아키텍처를 보여줍니다.

2. 자동화된 스토어 프로비저닝 시스템 (Automated Store Provisioning System)

사용자 등록부터 완전히 작동하는 온라인 스토어 구축까지 걸리는 시간은 단 몇 초에 불과하며, 수동 개입이 필요하지 않습니다.

사용자가 계정을 생성하면, 일련의 자동화된 백그라운드 프로세스 체인이 시작됩니다.

프로세스 초기화 (Process Initialization)

PHP 스크립트가 일련의 백그라운드 Bash 유틸리티를 안전하게 실행합니다.

파일 시스템 준비 (File System Preparation)

플랫폼은 필요한 스토어 디렉토리를 생성하고, 공유 스토리지 리소스를 마운트하며, 최소 권한 원칙 (Principle of Least Privilege)에 따라 엄격한 권한을 적용합니다.

데이터베이스 배포 (Database Deployment)

준비된 OpenCart 3 데이터베이스 덤프가 새로 생성된 데이터베이스로 임포트됩니다.

데이터베이스 사용자를 위한 암호학적으로 안전한 무작위 비밀번호가 자동으로 생성됩니다.

설정 생성 (Configuration Generation)

플랫폼은 다음 항목들을 위한 고유한 설정 파일을 자동으로 생성합니다:

• Nginx 가상 호스트 (Virtual Hosts);
• 전용 PHP-FPM 풀 (Dedicated PHP-FPM pools);
• Monit 모니터링;
• 백업 스케줄링 (Backup scheduling);
• 서비스 재로드 (Service Reload)

Nginx, PHP-FPM, Monit이 설정을 안전하게 재로드하고 시스템 캐시가 삭제되면, 새로운 스토어를 즉시 사용할 수 있게 됩니다.

전체 배포 프로세스는 완전히 자동화되어 있으며 고객에게는 보이지 않게 진행됩니다.

3. 서버 레벨 성능 최적화 (Server-Level Performance Optimization)

최고의 웹사이트 성능을 보장하기 위해 몇 가지 핵심적인 아키텍처 결정이 구현되었습니다.

무거운 프레임워크 대신 순수 CSS (Pure CSS) 사용

스토어프런트 (Storefront) 인터페이스는 Bootstrap, Tailwind 및 기타 CSS 프레임워크를 전혀 사용하지 않습니다.

시맨틱 HTML (Semantic HTML)과 경량 CSS를 사용하면 다음과 같은 이점이 있습니다:

• 최소한의 페이지 크기;
• 빠른 렌더링 성능;
• 배포 직후 높은 GTmetrix 점수.

Nginx를 활용한 공격적인 FastCGI 캐싱 (FastCGI Caching)

Nginx는 정적 리소스를 제공하고 웹 서버 레벨에서 제품 카탈로그 페이지를 직접 캐싱합니다.

동적 기능이 올바르게 작동하도록 엄격한 캐시 우회 (Cache bypass) 규칙이 구현되었습니다. 다음의 경우 캐싱이 자동으로 비활성화됩니다:

• POST 요청;
• 장바구니 (Shopping cart) 페이지;
• 결제 (Checkout) 페이지;
• 로그인한 사용자.

4. 모니터링, 신뢰성 및 지능형 백업 (Monitoring, Reliability, and Intelligent Backups)

인프라의 유일한 운영자로서, 저는 플랫폼이 탄력적이고 자동화되며 자가 치유 (Self-healing)가 가능해야 했습니다.

Monit을 이용한 모니터링

백그라운드 모니터링 서비스가 개별 PHP-FPM 풀 프로세스의 상태를 지속적으로 확인합니다.

프로세스가 중단되거나 충돌하면, Monit이 영향을 받은 서비스를 자동으로 재시작하여 수동 개입 없이도 최대 가동 시간 (Uptime)을 보장합니다.

지능형 클라우드 백업

매일 자동화된 스크립트가 스토어 파일과 데이터베이스를 아카이브한 후, rclone을 사용하여 Google Drive로 백업을 업로드합니다.

수백 개의 스토어를 동시에 백업할 때 Google API 속도 제한 (Rate limits)을 피하기 위해, 무작위 Cron 스케줄링 지연 (Randomized Cron scheduling delays)을 구현했습니다.

결론

개발 파트너로서 인공지능을 활용함으로써 이 전체 인프라를 설계, 디버깅 및 구현할 수 있었습니다.

결론적으로, OpenCart를 만들어준 Daniel Kerr와 코드 생성 및 Hostatto.com 구현을 도와준 Gemini에게 감사를 표합니다.