Feat/#331 FileManagerService 생성 및 github json 다운로드 구현

Projects/App/Project.swift

@@ -6,6 +6,7 @@ let project = Project(name: "App") {
         MainFeature()
         Data()
         FirebaseModule()
+        FileManagerService()
         SwiftLintScript()
         UIKitInfoPlist()
         AppInfoPlist(displayName: .displayName, marketingVersion: .marketingVersion, buildVersion: .buildVersion)

Projects/App/Sources/AppDelegate+Register.swift

@@ -14,25 +14,32 @@ import Data
 import Domain
 import NetworkService
 import FirebaseModule
+import FileManagerService
 
 extension AppDelegate {
     func registerDependencies() {
         let firebaseLogger = FirebaseLoggerImpl()
         DIContainer.setLogger(firebaseLogger)
 
+        // MARK: Service
         DIContainer.register(type: ForceUpdateService.self, DefaultForceUpdateService())
         DIContainer.register(type: CoreDataService.self, DefaultCoreDataService())
         DIContainer.register(type: NetworkService.self, DefaultNetworkService())
         DIContainer.register(type: LocationService.self, DefaultLocationService())
+        DIContainer.register(type: FileManagerService.self, DefaultFileManagerService())
+        DIContainer.register(type: LocalNotificationService.self, DefaultLocalNotificationService())
+        DIContainer.register(type: RegularAlarmEditingService.self, DefaultRegularAlarmEditingService())
 
+        // MARK: Repository
         DIContainer.register(type: FavoritesRepository.self, DefaultFavoritesRepository())
         DIContainer.register(type: BusStopArrivalInfoRepository.self, DefaultBusStopArrivalInfoRepository())
         DIContainer.register(type: StationListRepository.self, DefaultStationListRepository())
         DIContainer.register(type: RegularAlarmRepository.self, DefaultRegularAlarmRepository())
-        DIContainer.register(type: LocalNotificationService.self, DefaultLocalNotificationService())
-        DIContainer.register(type: RegularAlarmEditingService.self, DefaultRegularAlarmEditingService())
         DIContainer.register(type: VersionCheckRepository.self, DefaultVersionCheckRepository())
+        DIContainer.register(type: BusStationVersionRepository.self, DefaultBusStationVersionRepository())
+        DIContainer.register(type: GithubFileDownloadRepository.self, DefaultGithubFileDownloadRepository())
 
+        // MARK: UseCase
         DIContainer.register(type: FavoritesUseCase.self, DefaultFavoritesUseCase())
         DIContainer.register(type: RegularAlarmUseCase.self, DefaultRegularAlarmUseCase())
         DIContainer.register(type: AddRegularAlarmUseCase.self, DefaultAddRegularAlarmUseCase())
@@ -41,5 +48,6 @@ extension AppDelegate {
         DIContainer.register(type: NearMapUseCase.self, DefaultNearMapUseCase())
         DIContainer.register(type: FirebaseLogger.self, firebaseLogger)
         DIContainer.register(type: VersionCheckUseCase.self, DefaultVersionCheckUseCase())
+        DIContainer.register(type: UpdateBusStationListUseCase.self, DefaultUpdateBusStationListUseCase())
     }
 }

Projects/App/Sources/Coordinator/AppCoordinator.swift

@@ -8,24 +8,30 @@
 
 import UIKit
 
+import Core
+import Domain
 import FeatureDependency
 import MainFeature
 import BusStopFeature
+import RxSwift
 
 final class AppCoordinator: Coordinator {
     var parent: Coordinator?
     var childs: [Coordinator] = []
     var navigationController: UINavigationController
     public var coordinatorType: CoordinatorType = .app
     private let coordinatorProvider = DefaultCoordinatorProvider()
+    private let disposeBag = DisposeBag()
 
     init(navigationController: UINavigationController) {
         self.navigationController = navigationController
     }
 
     func start() {
+        checkAndDownloadBusStationList()
+
         let tabBarCoordinator = TabBarCoordinator(
-            navigationController: navigationController, 
+            navigationController: navigationController,
             coordinatorProvider: coordinatorProvider
         )
         childs.append(tabBarCoordinator)
@@ -43,4 +49,19 @@ final class AppCoordinator: Coordinator {
         childs.append(busStopCoordinator)
         busStopCoordinator.start()
     }
+
+    private func checkAndDownloadBusStationList() {
+        @Injected var useCase: UpdateBusStationListUseCase
+
+        useCase.execute()
+            .subscribe(
+                onError: { error in
+                    print("🚏❌ bus_station_list.json 업데이트 실패: \(error)")
+                },
+                onCompleted: {
+                    print("🚏✅ bus_station_list.json 업데이트 확인 및 처리 완료")
+                }
+            )
+            .disposed(by: disposeBag)
+    }
 }

Projects/Core/Sources/Extension/String+.swift

@@ -34,6 +34,15 @@ public extension String {
         return serverKey
     }
 
+    static var githubAccessToken: Self {
+        guard let any = Bundle.main.object(forInfoDictionaryKey: "GITHUB_ACCESS_TOKEN"),
+              let githubAccessToken = any as? String
+        else {
+            return ""
+        }
+        return githubAccessToken
+    }
+
     /// domain url
     static var domainURL: Self {
         guard let any = Bundle.main.object(

Projects/Data/Project.swift

@@ -7,6 +7,7 @@ let project = Project(name: "Data") {
         NetworkService()
         CoreDataService()
         FirebaseInterface()
+        FileManagerService()
         FrameworkInfoPlist(marketingVersion: .marketingVersion)
     }
 }

Projects/Data/Sources/Repository/DefaultBusStationVersionRepository.swift

@@ -0,0 +1,33 @@
+import Foundation
+
+import Domain
+import NetworkService
+import Core
+
+import RxSwift
+
+public final class DefaultBusStationVersionRepository: BusStationVersionRepository {
+    @Injected private var networkService: NetworkService
+
+    @UserDefaultsWrapper(key: "busStationDataVersion", defaultValue: nil)
+    private var localVersion: String?
+
+    public init() { }
+
+    public func fetchRemoteVersion() -> Observable<BusStationVersion> {
+        let endPoint = GithubFileDownloadEndPoint(
+            repo: "BusStationData",
+            filePath: "bus_station_version.json"
+        )
+        return networkService.request(endPoint: endPoint)
+            .decode(type: BusStationVersion.self, decoder: JSONDecoder())
+    }
+
+    public func fetchLocalVersion() -> String? {
+        return localVersion
+    }
+
+    public func save(version: String) {
+        localVersion = version
+    }
+}

Projects/Data/Sources/Repository/DefaultGithubFileDownloadRepository.swift

@@ -0,0 +1,38 @@
+import Foundation
+
+import Domain
+import FileManagerService
+import NetworkService
+import Core
+
+import RxSwift
+
+public final class DefaultGithubFileDownloadRepository: GithubFileDownloadRepository {
+    @Injected private var networkService: NetworkService
+    @Injected private var fileManagerService: FileManagerService
+
+    public init() { }
+
+    public func downloadFile(
+        repo: String,
+        filePath: String,
+        directoryName: String,
+        fileName: String
+    ) -> Observable<Void> {
+        let endPoint = GithubFileDownloadEndPoint(
+            repo: repo,
+            filePath: filePath
+        )
+        return networkService.request(endPoint: endPoint)
+            .flatMap { [weak self] data -> Observable<Void> in
+                guard let self = self else {
+                    return .error(RxError.unknown) // Or a custom error
+                }
+                return self.fileManagerService.save(
+                    data: data,
+                    directoryName: directoryName,
+                    fileName: fileName
+                )
+            }
+    }
+}

Projects/Domain/Sources/Entity/BusStationVersion.swift

@@ -0,0 +1,5 @@
+import Foundation
+
+public struct BusStationVersion: Decodable {
+    public let busStationVersion: String
+}

Projects/Domain/Sources/RepositoryInterface/BusStationVersionRepository.swift

@@ -0,0 +1,14 @@
+import Foundation
+
+import RxSwift
+
+public protocol BusStationVersionRepository {
+    /// 원격 저장소에서 최신 버스 정류장 데이터의 버전 정보를 가져옵니다.
+    func fetchRemoteVersion() -> Observable<BusStationVersion>
+
+    /// 로컬에 저장된 버스 정류장 데이터의 버전 정보를 가져옵니다.
+    func fetchLocalVersion() -> String?
+
+    /// 로컬에 새로운 버스 정류장 데이터의 버전 정보를 저장합니다.
+    func save(version: String)
+}

Projects/Domain/Sources/RepositoryInterface/GithubFileDownloadRepository.swift

@@ -0,0 +1,12 @@
+import Foundation
+
+import RxSwift
+
+public protocol GithubFileDownloadRepository {
+    func downloadFile(
+        repo: String,
+        filePath: String,
+        directoryName: String,
+        fileName: String
+    ) -> Observable<Void>
+}

Projects/Domain/Sources/UseCase/UpdateBusStationListUseCase.swift

@@ -0,0 +1,60 @@
+import Foundation
+import Core
+import RxSwift
+
+public protocol UpdateBusStationListUseCase {
+    func execute() -> Observable<Void>
+}
+
+public final class DefaultUpdateBusStationListUseCase: UpdateBusStationListUseCase {
+    @Injected private var versionRepository: BusStationVersionRepository
+    @Injected private var fileDownloadRepository: GithubFileDownloadRepository
+
+    public init() { }
+
+    public func execute() -> Observable<Void> {
+        return versionRepository.fetchRemoteVersion()
+            .do(onNext: { remoteVersion in
+                print("🚏 버스정류장 원격 버전 확인: \(remoteVersion.busStationVersion)")
+            }, onError: { error in
+                print("🚏 버스정류장 원격 버전 확인 중 에러 발생: \(error)")
+            })
+            .flatMap { [weak self] remoteVersion -> Observable<Void> in
+                guard let self = self else { return .error(RxError.unknown) }
+
+                let localVersion = self.versionRepository.fetchLocalVersion()
+                print("🚏 버스정류장 로컬 버전 확인: \(localVersion ?? "기존 파일 없음")")
+
+                let needsUpdate = localVersion != remoteVersion.busStationVersion
+                print("🚏 [버스정류장 버전 비교]")
+                print("로컬: \(localVersion ?? "파일 없음")")
+                print("원격: \(remoteVersion.busStationVersion)")
+
+                if needsUpdate {
+                    return self.downloadAndSave(
+                        newVersion: remoteVersion.busStationVersion
+                    )
+                } else {
+                    print("🚏 버스정류장 정보가 이미 최신 버전입니다.")
+                    return .just(())
+                }
+            }
+    }
+
+    private func downloadAndSave(newVersion: String) -> Observable<Void> {
+        print("🚏 downloadAndSave 호출. bus_station_list.json 다운로드")
+        return fileDownloadRepository.downloadFile(
+            repo: "BusStationData",
+            filePath: "bus_station_list.json",
+            directoryName: "jsons",
+            fileName: "bus_station_list.json"
+        )
+        .do(onNext: { _ in
+
+            self.versionRepository.save(version: newVersion)
+            print("🚏 로컬에 최신 버스정류장 정보 저장")
+        }, onError: { error in
+            print("🚏 파일 다운로드 중 에러 발생: \(error)")
+        })
+    }
+}

Projects/FileManagerService/Project.swift

@@ -0,0 +1,9 @@
+import ProjectDescription
+import ProjectDescriptionHelpers
+
+let project = Project(name: "FileManagerService") {
+    FileManagerService {
+        Domain()
+        FrameworkInfoPlist(marketingVersion: .marketingVersion)
+    }
+}