♻️ [Refactor] UMCFoundation 정비: 하드닝·공용 유틸 이식·FlexibleDecoding 통일·xcconfig 시크릿 주입 (#938)

* docs: 이슈 생성 규칙 및 Type/우선순위/Projects 자동화 문서화

- git-workflow.md: `이슈 생성 규칙` 섹션 추가 (템플릿·라벨·이슈 Type 매핑표)
- Type은 생성 직후 REST PATCH로 설정 (gh 2.83.1 `--type` 미지원)
- Priority/Projects는 project 스코프 필요 — iOS 보드 #3, 한글 `우선순위` 필드 안내
- CLAUDE.md: 레퍼런스 인덱스의 Git Workflow 항목에 이슈 규칙 반영

* docs: 이슈 생성 시 보드·우선순위·네이티브 Priority/Effort 기본 설정 명시

- 이슈 생성 = 제목/라벨/Type + 보드#3·우선순위 + 네이티브 Priority·Effort 기본 채움
- 보드 `우선순위`(한글) ↔ 네이티브 `Priority`(영어)를 같은 우선순위 레벨로 일치 규칙 추가
- 네이티브 이슈 Fields(베타) 설정 방식(setIssueFieldValue) 및 스킬 4-4·4-5 참조 반영

* 📄 Docs: Tuist 파일별 이관 매핑 문서 추가

레거시 AppProduct 766개 Swift 파일을 UMCApp Tuist 모듈로
옮길 때의 파일별 목적지를 정리. 확정 필요 항목은 개발
에이전트 분석으로 목적지 확정 후 반영.

* ♻️ [Refactor] UMCFoundation 로케일 버그·포매터 캐싱·FoundationModels 가드·헤더 정리

* ✨ [Feat] UMCFoundation 공용 유틸 이식(Date+KST/Calendar·Error+Cancellation·String) + 테스트

* ✨ [Feat] xcconfig 기반 시크릿/환경(BASE_URL Debug·Release) 주입

* ♻️ [Refactor] 앱 Notification.Name 정의 단일 파일(Notification+Names) 통합

* ♻️ [Refactor] FlexibleDecoding 단일 소스 통일(절삭 정규화·swallow 통일)·Date 중복 제거

- Activity 내부 ext + Notice 5개 private ext 삭제 → UMCFoundation 정규 헬퍼로 통일
- 숫자→String 은 정수 절삭('1'), optional-string 은 bad-type swallow 로 정규화
- CLAUDE.md 규칙 #3 canonical 네이밍(decodeIntFlexible*) 정합
- Date+HourMinutes 중복 제거 → Foundation toHourMinutes() 사용

Author: JEONG-J

UMCApp/Core/Foundation/Sources/Enums/MemberStatus.swift

@@ -1,6 +1,6 @@
 //
 //  MemberStatus.swift
-//  CoreEnum
+//  UMCFoundation
 //
 
 import Foundation

UMCApp/Core/Foundation/Sources/Error/Error+Cancellation.swift

@@ -0,0 +1,38 @@
+//
+//  Error+Cancellation.swift
+//  UMCFoundation
+//
+//  Created by euijjang97 on 7/5/26.
+//
+//  Swift Concurrency 취소를 판별하기 위한 공용 헬퍼.
+//  Task 취소는 실패가 아니므로 에러 Alert/로깅 대상에서 제외해야 합니다.
+//
+
+import Foundation
+
+public extension Error {
+
+    /// 이 에러가 "취소"에 해당하는지 여부.
+    ///
+    /// `CancellationError`(구조적 동시성 취소)와 `URLError(.cancelled)`(네트워크 요청 취소)를
+    /// 모두 취소로 간주합니다. ViewModel에서 취소된 작업을 사용자 에러로 표시하지 않도록
+    /// 분기할 때 사용합니다.
+    ///
+    /// ```swift
+    /// do {
+    ///     try await useCase.execute()
+    /// } catch {
+    ///     guard !error.isCancellation else { return }
+    ///     errorHandler.handle(error, context: ...)
+    /// }
+    /// ```
+    var isCancellation: Bool {
+        if self is CancellationError {
+            return true
+        }
+        if let urlError = self as? URLError, urlError.code == .cancelled {
+            return true
+        }
+        return false
+    }
+}

UMCApp/Core/Foundation/Sources/Error/Handler/ErrorHandler.swift

@@ -6,8 +6,10 @@
 //
 
 import Foundation
-import FoundationModels
 import os.log
+#if canImport(FoundationModels)
+import FoundationModels
+#endif
 
 /// 앱 전역에서 발생하는 에러를 중앙 집중식으로 처리하는 핸들러.
 ///
@@ -193,9 +195,11 @@ public final class ErrorHandler {
         }
 
         // 9. LanguageModelSession.GenerationError → DomainError 변환
+        #if canImport(FoundationModels)
         if let generationError = error as? LanguageModelSession.GenerationError {
             return .domain(.custom(message: describeGenerationError(generationError)))
         }
+        #endif
 
         // 10. 알 수 없는 에러
         return .unknown(message: error.localizedDescription)
@@ -212,6 +216,7 @@ public final class ErrorHandler {
         }
     }
 
+    #if canImport(FoundationModels)
     private func describeGenerationError(_ error: LanguageModelSession.GenerationError) -> String {
         switch error {
         case .exceededContextWindowSize:
@@ -236,6 +241,7 @@ public final class ErrorHandler {
             return "AI 처리 중 문제가 발생했습니다."
         }
     }
+    #endif
 
     private func describeDecodingError(_ error: DecodingError) -> String {
         switch error {

UMCApp/Core/Foundation/Sources/Error/Handler/Notification+Error.swift

@@ -0,0 +1,81 @@
+//
+//  Date+Calendar.swift
+//  UMCFoundation
+//
+//  Created by euijjang97 on 7/5/26.
+//
+//  캘린더 UI(월 그리드, 요일 헤더 등) 구성에 필요한 날짜 계산 유틸리티.
+//  KST 기준 그레고리력(`Calendar.kstGregorian`)을 사용합니다.
+//
+
+import Foundation
+
+public extension Date {
+
+    // MARK: - Month
+
+    /// KST 기준 해당 월의 첫째 날 00:00 시각.
+    var startOfMonth: Date {
+        let calendar = Calendar.kstGregorian
+        let components = calendar.dateComponents([.year, .month], from: self)
+        return calendar.date(from: components) ?? self
+    }
+
+    /// KST 기준 해당 월의 마지막 날 00:00 시각.
+    var endOfMonth: Date {
+        let calendar = Calendar.kstGregorian
+        let start = startOfMonth
+        return calendar.date(byAdding: DateComponents(month: 1, day: -1), to: start) ?? self
+    }
+
+    /// KST 기준 해당 월에 포함된 모든 날짜(각 날의 00:00)를 순서대로 반환합니다.
+    ///
+    /// 월간 캘린더 그리드를 그릴 때 사용합니다.
+    func datesInMonth() -> [Date] {
+        let calendar = Calendar.kstGregorian
+        guard let range = calendar.range(of: .day, in: .month, for: self) else {
+            return []
+        }
+
+        let start = startOfMonth
+        return range.compactMap { day in
+            calendar.date(byAdding: .day, value: day - 1, to: start)
+        }
+    }
+
+    // MARK: - Comparison
+
+    /// KST 기준 같은 날(연·월·일)인지 여부.
+    func isSameDay(_ other: Date) -> Bool {
+        Calendar.kstGregorian.isDate(self, inSameDayAs: other)
+    }
+}
+
+// MARK: - Weekday Symbols
+
+public extension Date {
+
+    /// 요일 심볼 표기 스타일.
+    enum WeekdaySymbolStyle {
+        /// 짧은 형태 (예: "일", "월")
+        case short
+        /// 매우 짧은 형태 (한국어에서는 `short`와 동일하게 동작)
+        case veryShort
+    }
+
+    /// 한국어 로케일 기준 요일 심볼 배열(일요일 시작)을 반환합니다.
+    ///
+    /// - Parameter style: 심볼 표기 스타일.
+    /// - Returns: `["일", "월", "화", "수", "목", "금", "토"]` 형태의 배열.
+    static func weekDaySymbols(style: WeekdaySymbolStyle = .short) -> [String] {
+        var calendar = Calendar(identifier: .gregorian)
+        calendar.locale = Locale(identifier: "ko_KR")
+
+        switch style {
+        case .short:
+            return calendar.shortWeekdaySymbols
+        case .veryShort:
+            return calendar.veryShortWeekdaySymbols
+        }
+    }
+}

UMCApp/Core/Foundation/Sources/Extensions/Date+Calendar.swift

@@ -88,7 +88,7 @@ private extension Date {
 
     static let hourMinuteFormatter: Foundation.DateFormatter = {
         let formatter = Foundation.DateFormatter()
-        formatter.locale = Locale(identifier: "ko_KR_POSIX")
+        formatter.locale = Locale(identifier: "en_US_POSIX")
         formatter.timeZone = .current
         formatter.dateFormat = "HH:mm"
         return formatter

…n/Sources/Extensions/DateFormatter.swift …Sources/Extensions/Date+Formatting.swiftUMCApp/Core/Foundation/Sources/Extensions/DateFormatter.swift renamed to UMCApp/Core/Foundation/Sources/Extensions/Date+Formatting.swift UMCApp/Core/Foundation/Sources/Extensions/DateFormatter.swift renamed to UMCApp/Core/Foundation/Sources/Extensions/Date+Formatting.swift

@@ -0,0 +1,69 @@
+//
+//  Date+KST.swift
+//  UMCFoundation
+//
+//  Created by euijjang97 on 7/5/26.
+//
+//  KST(Asia/Seoul) 타임존 경계를 다루기 위한 유틸리티.
+//  서버는 UTC 기준으로 시각을 저장하지만, 화면 표시와 "하루 종일" 판정은
+//  한국 로컬 기준이어야 하므로 KST 경계 계산을 이 파일로 모읍니다.
+//
+
+import Foundation
+
+// MARK: - TimeZone / Calendar
+
+public extension TimeZone {
+    /// 한국 표준시(Asia/Seoul). 식별자 조회 실패 시 현재 타임존으로 폴백합니다.
+    static let kst: TimeZone = .init(identifier: "Asia/Seoul") ?? .current
+}
+
+public extension Calendar {
+    /// KST 기준 그레고리력 캘린더.
+    static let kstGregorian: Calendar = {
+        var calendar = Calendar(identifier: .gregorian)
+        calendar.timeZone = .kst
+        return calendar
+    }()
+}
+
+// MARK: - Date + KST 경계
+
+public extension Date {
+
+    /// KST 기준 그 날의 시작(00:00:00) 시각.
+    var kstStartOfDay: Date {
+        Calendar.kstGregorian.startOfDay(for: self)
+    }
+
+    /// KST 기준 그 날의 끝(다음 날 00:00:00 직전) 시각.
+    var kstEndOfDay: Date {
+        let calendar = Calendar.kstGregorian
+        let start = calendar.startOfDay(for: self)
+        return calendar.date(byAdding: DateComponents(day: 1, second: -1), to: start) ?? self
+    }
+
+    /// KST 기준 그 날의 시작 시각을 UTC ISO8601 문자열로 반환합니다.
+    ///
+    /// 서버에 "해당 날짜 00:00(KST)" 이후를 조회하는 파라미터로 사용합니다.
+    var kstStartOfDayUTCISO8601: String {
+        ServerDateTimeConverter.toUTCDateTimeString(kstStartOfDay)
+    }
+
+    /// KST 기준 그 날의 끝 시각을 UTC ISO8601 문자열로 반환합니다.
+    var kstEndOfDayUTCISO8601: String {
+        ServerDateTimeConverter.toUTCDateTimeString(kstEndOfDay)
+    }
+}
+
+// MARK: - ClosedRange<Date>
+
+public extension ClosedRange where Bound == Date {
+
+    /// KST 기준으로 이 구간이 하루 전체(00:00 ~ 23:59:59)를 덮는지 여부.
+    ///
+    /// 종일 일정(all-day) 판정에 사용합니다.
+    var isAllDayInKST: Bool {
+        lowerBound == lowerBound.kstStartOfDay && upperBound == lowerBound.kstEndOfDay
+    }
+}