Cocoa 기반 클라이언트 아키텍처 설계
macOS 운영 체제에서 공식 12306 데스크톱 애플리케이션은 기능이 제한적이거나 부재한 상태이다. 이에 따라 별도의 가상화 레이어나 브라우저 샌드박스 우회 없이 순수 Swift와 Objective-C를 활용하여 네이티브 UI 렌더링과 네트워크 통신을 처리하는 전용 클라이언트 소프트웨어가 개발되고 있다. 해당 프로젝트는 AppKit 프레임워크를 기준으로 윈도우 레이아웃, 메뉴 바, 그리고 시스템 트레이 기능을 매칭하며, 외부 HTTP 클라이언트 라이브러리를 통해 철도 예약 REST API와 직접 동기화된다.
핵심 모듈 및 로직 구조
예매 흐름은 크게 좌석 현황 조회, 조건 필터링, 알림 큐, 주문 상태 관리 네 가지 컴포넌트로 분할된다. 조회 엔진은 병렬 태스크를 통해 여러 출발일 데이터를 동시에フェッチ하고, 결과셋을 사전 정의된 테이블 뷰에 바인딩한다. 알림 시스템은 주기적인 상태 확인 사이클을 실행하여 지정된 노선의 잔여석이 변동할 경우 로컬 알림 또는 시스템 배지를 트리거한다. 하위 디렉토리 구조는 주로 Service/, OrderViewControllers/, RealmModel/, LunarCalendar/로 구성되어 있으며, 각 레이어는 단일 책임 원칙(SRP)에 따라 분리되어 유지보수성을 확보한다.
알림 및 상태 모니터링 구현 예시
기존의 순환 호출 방식 대신 비동기 퍼블리셔 패턴을 적용하여 메모리 누수를 방지하고 리소스 사용을 최적화한다. 다음과 같이 Combine 프레임워크를 활용한 관찰자 구조는 특정 경로의 좌석 상태를 주기적으로 폴링하고 변동 시 이벤트 스트림으로 방출하는 로직을 재구성한 예시다.
import Foundation
import Combine
struct RouteConfig {
let departureStation: String
let arrivalStation: String
let travelDate: DateComponents
}
class AvailabilityWatcher {
private var subscriptions = Set<AnyCancellable>()
private let networkSession: URLSessionProtocol
init(session: URLSessionProtocol) {
self.networkSession = session
}
func monitor(route: RouteConfig, pollingInterval: TimeInterval) -> AnyPublisher<Bool, Error> {
return Timer.publish(every: pollingInterval, on: .main, in: .default)
.autoconnect()
.flatMap { [weak self] _ -> Future<SeatInventory, Error> in
Future { promise in
guard let self = self else { return }
self.networkSession.requestTicketAvailability(for: route) { result in
switch result {
case .success(let inventory):
promise(.success(inventory))
case .failure(let error):
promise(.failure(error))
}
}
}
}
.map { $0.hasAvailableSeats }
.replaceError(with: false)
.receive(on: DispatchQueue.main)
.eraseToAnyPublisher()
}
}
빌드 환경 설정 및 의존성 관리
프로젝트의 서드파티 종속성은 외부 패키지 매니저를 통해 버전 충돌 없이 관리되며, Xcode 워크스페이스와 직접 매핑된다. 초기 설정 과정은 정적 변수 바인딩, 오류 체크, 플랫폼별 바이너리 캐싱 로직을 포함한 빌드 스크립트로 통합하여 일관된 컴파일을 보장한다.
#!/usr/bin/env bash
set -euo pipefail
PACKAGE_MANAGER="carthage"
REMOTE_SOURCE="https://gitcode.com/gh_mirrors/12/12306ForMac.git"
TARGET_WORKSPACE="RailApp_Source"
PLATFORM_FLAG="--platform macOS"
# 의존성 도구 가용성 검증
if ! which "$PACKAGE_MANAGER" > /dev/null 2>&1; then
echo "[INFO] Missing dependency tool. Installing via Homebrew..."
brew install "$PACKAGE_MANAGER"
fi
# 저장소 클론 (서브모듈 포함)
if [ ! -d "$TARGET_WORKSPACE" ]; then
git clone --recursive "$REMOTE_SOURCE" "$TARGET_WORKSPACE"
fi
cd "$TARGET_WORKSPACE" || exit 1
# macOS 아키텍처용 프레임워크 풀다운 및 빌드 캐시 활성화
echo "[BUILD] Resolving CocoaTouch dependencies..."
"$PACKAGE_MANAGER" bootstrap $PLATFORM_FLAG --cache-builds --no-build
echo "[SUCCESS] Framework synchronization complete. Launch Xcode project file to proceed."
데이터 영속화 및 로컬화 전략
사용자의 검색 기록, 즐겨찾기 경로, 인증 토큰 정보는 인메모리 컬렉션보다 장기 보존이 필요한 특성상 관계형 DB를 대체하는 객체 지향 영구 저장소를 활용한다. Realm Database는 스레드 안전성과 빠른 시리어라이제이션 속도를 제공하여 복잡한 예매 폼 데이터의 변경 사항을 실시간으로 마우스업하거나 백그라운드 작업 시에도 무결성을 유지한다. 언어 자원은 zh-Hans.lproj 폴더 내 플랫포머미스트 파일(Plist)로 관리되며, NSLocalizedString 키 맵핑을 통해 런타임 로캘 변경 시 UI 텍스트가 동적으로 재구성된다.
시스템 통합 및 보안 아키텍처
데스크톱 환경 특성에 맞는 OS 레벨 연동이 필요하다. 시스템 수면 모드를 차단하는 기능은 FSEventMonitor 및 PMIdleTimer APIs를 결합하여 장시간 대기 중 CPU 절전 상태 진입을 억제한다. 로그인 과정에서 발생하는 이미지 난독화 인식(Module: Dama.swift)은 외부 OCR 라이브러리 또는 클라우드 검증 단계를 거치며, 로컬에서는 해시값 변환 후 전송하여 원본 비트맵 노출을 차단한다. 인증 정보는 Keychain Access에 암호화된 형태로 저장되며, 네트워크 트래픽은 필수적으로 TLS 1.2 이상을 강제하고 페이로드 압축을 적용하여 대역폭과 프라이버시를 동시에 관리한다.
성능 튜닝 및 확장성 고려사항
대규모 좌석 목록 로드 시 Main Thread 블록킹을 피하기 위해 Lazy Table Loading과 페이지네이션 로직을 적용해야 한다. 조회 간격은 서버 과부하 방지 및 계정 제약 회피를 위해 기하급수적 백오프(Exponential Backoff) 알고리즘을 권장하며, 캐시 무효화 정책은 토큰 만료 시각 및 명시적 삭제 요청 두 가지 기준에서만触发하도록 설계한다. AlamoFire를 통한 HTTP 계층, PromiseKit의 콜백 체이닝, FMDB를 사용한 보조 데이터 베이스 연동은 모듈 간 결합도를 낮추어 향후 iOS/iPadOS 동일 코드베이스 포트나 WebAssembly 기반 웹 클라이언트 전환 시 레퍼턴셜 변경 비용을 최소화한다.