공교육 다문화 수업과 국방 다국적 연합작전의 0초 시차 동기화: ZeliClock의 TimeZoneInfo 기반 글로벌 멀티 타임존 실시간 렌더링과 스레드 안전 파일 영속화 아키텍처

private void AddClock_Click(object sender, RoutedEventArgs e)
{
    if (_selectedCity == null) return;

    string windowsTzId;
    try
    {
        // 1. IANA 타임존 ID를 Windows 네이티브 타임존 ID로 무손실 정규화
        windowsTzId = TimeZoneConverter.TZConvert.IanaToWindows(_selectedCity.IanaTimeZone);
    }
    catch
    {
        // 변환 실패 시 원본 IANA 문자열을 Fallback으로 유지
        windowsTzId = _selectedCity.IanaTimeZone;
    }

    // 2. 동일 타임존 중복 등록 방지 가드
    if (_clocks.Any(c => c.TimeZoneId == windowsTzId))
    {
        StatusText.Text = string.Format(Loc.Get("Clock_AlreadyAdded"), _selectedCity.CityName);
        return;
    }

    string flag = GeoSearchResult.GetFlagEmoji(_selectedCity.CountryCode);
    AddClockToUI(windowsTzId, $"{flag} {_selectedCity.CityName}", flag);

    RebuildClockUI();
    SaveClocks();
}

var now = TimeZoneInfo.ConvertTime(DateTimeOffset.UtcNow, tzi);
var offset = tzi.GetUtcOffset(DateTimeOffset.UtcNow);

// 음수/양수 오프셋을 엄격한 ISO/UTC 규격으로 포맷팅 (+/- 부호 및 2자리 분 분리)
string offsetStr = offset >= TimeSpan.Zero
    ? $"UTC+{offset.Hours}:{offset.Minutes:D2}"
    : $"UTC{offset.Hours}:{Math.Abs(offset.Minutes):D2}";

private void StartTimer()
{
    // 200ms 주기로 초 단위 전환 즉시 감지 (지터 0화)
    _timer = new DispatcherTimer { Interval = TimeSpan.FromMilliseconds(200) };
    _timer.Tick += (_, _) => UpdateAllClocks();
    _timer.Start();
}

private void UpdateAllClocks()
{
    var utcNow = DateTimeOffset.UtcNow;

    // 핵심: 사용자가 도시를 추가/삭제하는 도중 순회하더라도
    // InvalidOperationException (Collection was modified)이 발생하지 않도록 스냅샷 생성
    foreach (var clock in _clocks.ToList())
    {
        try
        {
            if (string.IsNullOrWhiteSpace(clock.TimeZoneId)) continue;

            var tzi = TimeZoneInfo.FindSystemTimeZoneById(clock.TimeZoneId);
            var now = TimeZoneInfo.ConvertTime(utcNow, tzi);
            
            // PropertyChanged 이벤트를 통해 바인딩된 텍스트블록만 선택적 리드로우
            clock.CurrentTime = now.ToString("HH:mm:ss");
            clock.CurrentDate = now.ToString("yyyy-MM-dd (ddd)");
        }
        catch (TimeZoneNotFoundException) { }
        catch (ArgumentException) { }
    }

    // 로컬 물리 PC 시각 동시 갱신
    LocalTimeText.Text = string.Format(Loc.Get("Clock_LocalTime"), DateTime.Now.ToString("HH:mm:ss"));
}

private GeoSearchResult GetKoreanFallback(string query)
{
    // 인터넷 단절(Air-Gap) 환경에서도 100% 즉시 동작하는 글로벌 거점 딕셔너리
    var map = new Dictionary<string, GeoSearchResult>
    {
        { "시카고", new GeoSearchResult { CityName = "Chicago", Admin1 = "Illinois", CountryCode = "US", IanaTimeZone = "America/Chicago" }},
        { "뉴욕", new GeoSearchResult { CityName = "New York", Admin1 = "New York", CountryCode = "US", IanaTimeZone = "America/New_York" }},
        { "서울", new GeoSearchResult { CityName = "Seoul", Admin1 = "Seoul", CountryCode = "KR", IanaTimeZone = "Asia/Seoul" }},
        { "도쿄", new GeoSearchResult { CityName = "Tokyo", Admin1 = "Tokyo", CountryCode = "JP", IanaTimeZone = "Asia/Tokyo" }},
        { "베이징", new GeoSearchResult { CityName = "Beijing", Admin1 = "Beijing", CountryCode = "CN", IanaTimeZone = "Asia/Shanghai" }},
        { "북경", new GeoSearchResult { CityName = "Beijing", Admin1 = "Beijing", CountryCode = "CN", IanaTimeZone = "Asia/Shanghai" }},
        { "런던", new GeoSearchResult { CityName = "London", Admin1 = "England", CountryCode = "GB", IanaTimeZone = "Europe/London" }},
        { "파리", new GeoSearchResult { CityName = "Paris", Admin1 = "Ile-de-France", CountryCode = "FR", IanaTimeZone = "Europe/Paris" }},
        { "엘에이", new GeoSearchResult { CityName = "Los Angeles", Admin1 = "California", CountryCode = "US", IanaTimeZone = "America/Los_Angeles" }},
        { "la", new GeoSearchResult { CityName = "Los Angeles", Admin1 = "California", CountryCode = "US", IanaTimeZone = "America/Los_Angeles" }},
        { "샌프란시스코", new GeoSearchResult { CityName = "San Francisco", Admin1 = "California", CountryCode = "US", IanaTimeZone = "America/Los_Angeles" }},
        { "시드니", new GeoSearchResult { CityName = "Sydney", Admin1 = "New South Wales", CountryCode = "AU", IanaTimeZone = "Australia/Sydney" }},
        { "베트남", new GeoSearchResult { CityName = "Ho Chi Minh", Admin1 = "Vietnam", CountryCode = "VN", IanaTimeZone = "Asia/Ho_Chi_Minh" }},
        { "방콕", new GeoSearchResult { CityName = "Bangkok", Admin1 = "Bangkok", CountryCode = "TH", IanaTimeZone = "Asia/Bangkok" }}
    };

    foreach (var kvp in map)
    {
        if (query.Contains(kvp.Key) || kvp.Key.Contains(query))
            return kvp.Value;
    }
    return null;
}

private static readonly object _fileLock = new object();

private void SaveClocks()
{
    // 파일 쓰기 시 단일 스레드 진입 보장으로 동시성 파괴 방어
    lock (_fileLock)
    {
        try
        {
            string path = GetConfigFilePath();
            var lines = _clocks.Select(c => $"{c.TimeZoneId}|{c.DisplayName}|{c.CountryFlag}");
            File.WriteAllText(path, string.Join(Environment.NewLine, lines));
        }
        catch (Exception ex)
        {
            System.Diagnostics.Debug.WriteLine($"[ZeliClock] Save Error: {ex.Message}");
        }
    }
}

private void BtnPin_Click(object sender, RoutedEventArgs e)
{
    if (AppWindow?.Presenter is not OverlappedPresenter presenter) return;
    
    _isPinned = !_isPinned;
    presenter.IsAlwaysOnTop = _isPinned;

    // 시각적 피드백: 고정 상태 시 에메랄드 오로라 글로우 활성화
    TxtPin.Opacity = _isPinned ? 1.0 : 0.5;
    PinBg.Color = _isPinned
        ? Windows.UI.Color.FromArgb(0x35, 0x0E, 0xA7, 0x6C)
        : Windows.UI.Color.FromArgb(0x15, 0xFF, 0xFF, 0xFF);
}