[Feat] 제보하기 화면 구현(2차), 역지오코딩 로직 구현 (#66)

* feat: 위치 정보 fetch 로직 구현

* feat: 제보하기 카테고리 tableView VC구현

* refactor: 코드리뷰 반영

* feat: asset 추가

Author: taipaise

Projects/DataSource/Sources/Common/DataSourceDependencyAssembler.swift

@@ -40,5 +40,13 @@ public struct DataSourceDependencyAssembler: DependencyAssemblerProtocol {
         DIContainer.shared.register(type: AppConfigRepositoryProtocol.self) { _ in
             return AppConfigRepository()
         }
+
+        DIContainer.shared.register(type: LocationRepositoryProtocol.self) { _ in
+            return LocationRepository()
+        }
+
+        DIContainer.shared.register(type: ReportRepositoryProtocol.self) { _ in
+            return ReportRepository()
+        }
     }
 }

Projects/DataSource/Sources/Common/Enum/AppProperties.swift

@@ -15,4 +15,8 @@ public enum AppProperties {
     public static var kakaoNativeKey: String {
         Bundle.main.object(forInfoDictionaryKey: "KakaoNativeKey") as? String ?? ""
     }
+
+    public static var kakaoApiKey: String {
+        Bundle.main.object(forInfoDictionaryKey: "KakaoAPIKey") as? String ?? ""
+    }
 }

Projects/DataSource/Sources/DTO/KakaoLocationResponseDTO.swift

@@ -0,0 +1,139 @@
+//
+//  KakaoLocationResponseDTO.swift
+//  DataSource
+//
+//  Created by 이동현 on 11/10/25.
+//
+
+import Domain
+import Foundation
+
+struct KakaoLocationResponseDTO: Codable {
+    let meta: Meta
+    let documents: [Document]
+
+    struct Meta: Codable {
+        let totalCount: Int
+        let pageableCount: Int?
+        let isEnd: Bool?
+
+        enum CodingKeys: String, CodingKey {
+            case totalCount = "total_count"
+            case pageableCount = "pageable_count"
+            case isEnd = "is_end"
+        }
+    }
+}
+
+// MARK: - Document
+struct Document: Codable {
+    let roadAddress: KakaoRoadAddress?
+    let address: KakaoAddress?
+
+    let addressName: String?
+    let y: String? // 위도 (latitude)
+    let x: String? // 경도 (longitude)
+    let addressType: String?
+
+    enum CodingKeys: String, CodingKey {
+        case addressName = "address_name"
+        case y, x
+        case addressType = "address_type"
+        case address
+        case roadAddress = "road_address"
+    }
+
+    var latitude: Double?  {
+        if let y, let v = Double(y) { return v }
+        if let v = address?.latitude { return v }
+        if let v = roadAddress?.latitude { return v }
+        return nil
+    }
+
+    var longitude: Double? {
+        if let x, let v = Double(x) { return v }
+        if let v = address?.longitude { return v }
+        if let v = roadAddress?.longitude { return v }
+        return nil
+    }
+}
+
+// MARK: - KakaoRoadAddress (도로명 주소)
+struct KakaoRoadAddress: Codable {
+    let addressName: String
+    let region1depthName: String
+    let region2depthName: String
+    let region3depthName: String
+    let roadName: String
+    let undergroundYn: String?
+    let mainBuildingNo: String?
+    let subBuildingNo: String?
+    let buildingName: String?
+    let zoneNo: String?
+    let y: String?
+    let x: String?
+
+    enum CodingKeys: String, CodingKey {
+        case addressName = "address_name"
+        case region1depthName = "region_1depth_name"
+        case region2depthName = "region_2depth_name"
+        case region3depthName = "region_3depth_name"
+        case roadName = "road_name"
+        case undergroundYn = "underground_yn"
+        case mainBuildingNo = "main_building_no"
+        case subBuildingNo = "sub_building_no"
+        case buildingName = "building_name"
+        case zoneNo = "zone_no"
+        case y, x
+    }
+
+    var latitude: Double?  { y.flatMap(Double.init) }
+    var longitude: Double? { x.flatMap(Double.init) }
+}
+
+// MARK: - Address (지번 주소)
+struct KakaoAddress: Codable {
+    let addressName: String
+    let region1depthName: String
+    let region2depthName: String
+    let region3depthName: String
+    let region3depthHName: String?
+    let hCode: String?
+    let bCode: String?
+    let mountainYn: String?
+    let mainAddressNo: String?
+    let subAddressNo: String?
+    let x: String?
+    let y: String?
+    let zipCode: String?
+
+    enum CodingKeys: String, CodingKey {
+        case addressName = "address_name"
+        case region1depthName = "region_1depth_name"
+        case region2depthName = "region_2depth_name"
+        case region3depthName = "region_3depth_name"
+        case region3depthHName = "region_3depth_h_name"
+        case hCode = "h_code"
+        case bCode = "b_code"
+        case mountainYn = "mountain_yn"
+        case mainAddressNo = "main_address_no"
+        case subAddressNo = "sub_address_no"
+        case x, y
+        case zipCode = "zip_code"
+    }
+
+    var latitude: Double?  { y.flatMap(Double.init) }
+    var longitude: Double? { x.flatMap(Double.init) }
+}
+
+// MARK: - Mapping
+extension KakaoLocationResponseDTO {
+    func toLocationEntity(fallbackLongitude: Double? = nil, fallbackLatitude: Double? = nil) -> LocationEntity? {
+        guard let doc = documents.first else { return nil }
+        let longitude = doc.longitude ?? fallbackLongitude
+        let latitude = doc.latitude  ?? fallbackLatitude
+        let address = doc.roadAddress?.addressName ?? doc.address?.addressName
+
+        return LocationEntity(longitude: longitude ?? 0, latitude: latitude ?? 0, address: address)
+    }
+}

Projects/DataSource/Sources/Endpoint/LocationEndpoint.swift

@@ -0,0 +1,55 @@
+//
+//  LocationEndpoint.swift
+//  DataSource
+//
+//  Created by 이동현 on 11/10/25.
+//
+
+enum LocationEndpoint {
+    case fetchAddress(longitude: Double, latitude: Double)
+}
+
+extension LocationEndpoint: Endpoint {
+    var baseURL: String {
+        switch self {
+        case .fetchAddress:
+            "https://dapi.kakao.com/v2"
+        }
+    }
+
+    var path: String {
+        switch self {
+        case .fetchAddress:
+            return baseURL + "/local/geo/coord2address.json"
+        }
+    }
+
+    var method: HTTPMethod {
+        switch self {
+        case .fetchAddress:
+            return .get
+        }
+    }
+
+    var headers: [String : String] {
+        let headers: [String: String] = [
+            "Authorization": "KakaoAK \(AppProperties.kakaoApiKey)",
+        ]
+        return headers
+    }
+
+    var queryParameters: [String : String] {
+        switch self {
+        case .fetchAddress(let longitude, let latitude):
+            ["x": "\(longitude)", "y": "\(latitude)"]
+        }
+    }
+
+    var bodyParameters: [String : Any] {
+        return [:]
+    }
+
+    var isAuthorized: Bool {
+        return false
+    }
+}

Projects/DataSource/Sources/NetworkService/NetworkService.swift

@@ -81,13 +81,18 @@ final class NetworkService {
         guard !data.isEmpty else { throw NetworkError.emptyData }
 
         do {
-            let baseResponse = try decoder.decode(BaseResponse<T>.self, from: data)
+            let bitnagilResponse = try decoder.decode(BaseResponse<T>.self, from: data)
 
-            guard let responseDTO = baseResponse.data else { return nil }
+            guard let responseDTO = bitnagilResponse.data else { return nil }
 
             return responseDTO
         } catch {
-            throw NetworkError.decodingError
+            do {
+                let generalResponse = try decoder.decode(T.self, from: data)
+                return generalResponse
+            } catch {
+                throw NetworkError.decodingError
+            }
         }
     }
 }

Projects/DataSource/Sources/Repository/LocationRepository.swift

@@ -0,0 +1,81 @@
+//
+//  LocationRepository.swift
+//  DataSource
+//
+//  Created by 이동현 on 11/9/25.
+//
+
+import CoreLocation
+import Domain
+
+final class LocationRepository: NSObject, LocationRepositoryProtocol {
+    private let networkService = NetworkService.shared
+    private let locationManager = CLLocationManager()
+    private var continuation: CheckedContinuation<LocationEntity?, Never>?
+    private var authContinuation: CheckedContinuation<CLAuthorizationStatus, Never>?
+
+    override init() {
+        super.init()
+        
+        locationManager.desiredAccuracy = kCLLocationAccuracyNearestTenMeters
+        locationManager.delegate = self
+    }
+
+    func fetchCoordinate() async -> LocationEntity? {
+        guard CLLocationManager.locationServicesEnabled() else { return nil }
+
+        let currentStatus = await requestAuthorizationIfNeeded()
+
+        if currentStatus == .authorizedAlways || currentStatus == .authorizedWhenInUse {
+            return await withCheckedContinuation { continuation in
+                self.continuation = continuation
+                locationManager.requestLocation()
+            }
+        } else {
+            return nil
+        }
+    }
+
+    func fetchAddress(coordinate: LocationEntity) async throws -> LocationEntity? {
+        let endpoint = LocationEndpoint.fetchAddress(longitude: coordinate.longitude, latitude: coordinate.latitude)
+
+        guard let response = try await networkService.request(endpoint: endpoint, type: KakaoLocationResponseDTO.self)
+        else { return nil }
+
+        let location = response.toLocationEntity(fallbackLongitude: coordinate.longitude, fallbackLatitude: coordinate.latitude)
+        return location
+    }
+
+    private func requestAuthorizationIfNeeded() async -> CLAuthorizationStatus {
+        let currentStatus = locationManager.authorizationStatus
+
+        switch currentStatus {
+        case .authorizedAlways, .authorizedWhenInUse:
+            return currentStatus
+        case .denied, .restricted:
+            return currentStatus
+        case .notDetermined:
+            return await withCheckedContinuation { (continuation: CheckedContinuation<CLAuthorizationStatus, Never>) in
+                self.authContinuation?.resume(returning: currentStatus)
+                self.authContinuation = continuation
+                self.locationManager.requestWhenInUseAuthorization()
+            }
+        default:
+            return currentStatus
+        }
+    }
+}
+
+extension LocationRepository: CLLocationManagerDelegate {
+    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
+        let coordinate = locations.last?.coordinate
+        let entity = coordinate.map { LocationEntity(longitude: $0.longitude, latitude: $0.latitude, address: nil) }
+        continuation?.resume(returning: entity)
+        continuation = nil
+    }
+
+    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
+        continuation?.resume(returning: nil)
+        continuation = nil
+    }
+}

Projects/DataSource/Sources/Repository/ReportRepository.swift

@@ -0,0 +1,14 @@
+//
+//  ReportRepository.swift
+//  DataSource
+//
+//  Created by 이동현 on 11/9/25.
+//
+
+import Domain
+
+final class ReportRepository: ReportRepositoryProtocol {
+    func report(reportEntity: Domain.ReportEntity) async {
+
+    }
+}

Projects/Domain/Sources/DomainDependencyAssembler.swift

@@ -62,5 +62,14 @@ public struct DomainDependencyAssembler: DependencyAssemblerProtocol {
 
             return RoutineUseCase(routineRepository: routineRepository)
         }
+
+        DIContainer.shared.register(type: ReportUseCaseProtocol.self) { container in
+            guard
+                let locationRepository = container.resolve(type: LocationRepositoryProtocol.self),
+                let reportRepository = container.resolve(type: ReportRepositoryProtocol.self)
+            else { fatalError("reportUseCase에 필요한 의존성이 등록되지 않았습니다.") }
+
+            return ReportUseCase(locationRepository: locationRepository, reportRepository: reportRepository)
+        }
     }
 }

Projects/Domain/Sources/Entity/Enum/ReportType.swift

@@ -6,7 +6,8 @@
 //
 
 public enum ReportType: String, CaseIterable {
+    case transportation
     case lamp
-    case road
-    case etc
+    case water
+    case convenience
 }

Projects/Domain/Sources/Entity/LocationEntity.swift

@@ -0,0 +1,22 @@
+//
+//  LocationEntity.swift
+//  Domain
+//
+//  Created by 이동현 on 11/9/25.
+//
+
+public struct LocationEntity {
+    public let longitude: Double
+    public let latitude: Double
+    public let address: String?
+
+    public init(
+        longitude: Double,
+        latitude: Double,
+        address: String?
+    ) {
+        self.longitude = longitude
+        self.latitude = latitude
+        self.address = address
+    }
+}