연락처 관리 앱 [STEP 3] Hong, Effie

ContactManager/ContactManager.xcodeproj/project.pbxproj

@@ -10,6 +10,7 @@
 		F42BF4772B54CA9C0067C8E8 /* ContactValidationError.swift in Sources */ = {isa = PBXBuildFile; fileRef = F42BF4762B54CA9C0067C8E8 /* ContactValidationError.swift */; };
 		F42BF4792B54CB6C0067C8E8 /* AddContactError.swift in Sources */ = {isa = PBXBuildFile; fileRef = F42BF4782B54CB6C0067C8E8 /* AddContactError.swift */; };
 		F42BF47B2B54CC620067C8E8 /* AddContact.swift in Sources */ = {isa = PBXBuildFile; fileRef = F42BF47A2B54CC620067C8E8 /* AddContact.swift */; };
+		F44184BE2B594C3D0011CB5B /* ContactUnavailableConfiguration.swift in Sources */ = {isa = PBXBuildFile; fileRef = F44184BD2B594C3D0011CB5B /* ContactUnavailableConfiguration.swift */; };
 		F456EA732B49511C001BE636 /* Contact.swift in Sources */ = {isa = PBXBuildFile; fileRef = F456EA722B49511C001BE636 /* Contact.swift */; };
 		F456EA762B4951E9001BE636 /* ContactList.swift in Sources */ = {isa = PBXBuildFile; fileRef = F456EA752B4951E9001BE636 /* ContactList.swift */; };
 		F456EA7A2B4954E4001BE636 /* ListContactUseCase.swift in Sources */ = {isa = PBXBuildFile; fileRef = F456EA792B4954E4001BE636 /* ListContactUseCase.swift */; };
@@ -49,6 +50,7 @@
 		F42BF4762B54CA9C0067C8E8 /* ContactValidationError.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ContactValidationError.swift; sourceTree = "<group>"; };
 		F42BF4782B54CB6C0067C8E8 /* AddContactError.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AddContactError.swift; sourceTree = "<group>"; };
 		F42BF47A2B54CC620067C8E8 /* AddContact.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AddContact.swift; sourceTree = "<group>"; };
+		F44184BD2B594C3D0011CB5B /* ContactUnavailableConfiguration.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ContactUnavailableConfiguration.swift; sourceTree = "<group>"; };
 		F456EA722B49511C001BE636 /* Contact.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Contact.swift; sourceTree = "<group>"; };
 		F456EA752B4951E9001BE636 /* ContactList.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ContactList.swift; sourceTree = "<group>"; };
 		F456EA792B4954E4001BE636 /* ListContactUseCase.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ListContactUseCase.swift; sourceTree = "<group>"; };
@@ -137,6 +139,7 @@
 				F4B1787B2B539320005B8E78 /* Formatter.swift */,
 				F4B1788A2B53F0B1005B8E78 /* ContactMakable.swift */,
 				F42BF4762B54CA9C0067C8E8 /* ContactValidationError.swift */,
+				F44184BD2B594C3D0011CB5B /* ContactUnavailableConfiguration.swift */,
 			);
 			path = Common;
 			sourceTree = "<group>";
@@ -392,6 +395,7 @@
 				F456EA902B497E16001BE636 /* ContactRepository.swift in Sources */,
 				F4B178892B53C095005B8E78 /* AddContactCoordinator.swift in Sources */,
 				F456EA8A2B495C14001BE636 /* ContactListDataSource.swift in Sources */,
+				F44184BE2B594C3D0011CB5B /* ContactUnavailableConfiguration.swift in Sources */,
 				F4B178702B529351005B8E78 /* AddContactViewController.swift in Sources */,
 				F456EA762B4951E9001BE636 /* ContactList.swift in Sources */,
 				F456EA8C2B495E13001BE636 /* ReusableCell.swift in Sources */,

ContactManager/ContactManager/Common/ContactMakable.swift

@@ -6,15 +6,31 @@
 //
 
 protocol ContactMakable {
-    func makeContact(from request: AddContact.Request) throws -> Contact
+    func makeContact(from request: AddContact.CreatContact.Request) throws -> Contact
+    func makeExistingContact(from request: AddContact.UpdateContact.Request) throws -> Contact
 }
 
+import Foundation
+
 struct ContactFactory: ContactMakable {
-    func makeContact(from request: AddContact.Request) throws -> Contact {
+    func makeContact(from request: AddContact.CreatContact.Request) throws -> Contact {
+        let id = makeID()
+        let name = try validateName(request.name)
+        let age = try validateAge(request.age)
+        let phoneNumber = try validatePhoneNumber(request.phoneNumber)
+        return Contact(id: id, name: name, phoneNumber: phoneNumber, age: age)
+    }
+
+    func makeExistingContact(from request: AddContact.UpdateContact.Request) throws -> Contact {
+        let id = request.id
         let name = try validateName(request.name)
         let age = try validateAge(request.age)
         let phoneNumber = try validatePhoneNumber(request.phoneNumber)
-        return Contact(name: name, phoneNumber: phoneNumber, age: age)
+        return Contact(id: id, name: name, phoneNumber: phoneNumber, age: age)
+    }
+
+    private func makeID() -> Int {
+        return UUID().hashValue
     }
 
     private func validateName(_ name: String) throws -> String {

ContactManager/ContactManager/Common/ContactUnavailableConfiguration.swift

@@ -0,0 +1,25 @@
+//
+//  ContactUnavailableConfiguration.swift
+//  ContactManager
+//
+//  Created by Effie on 1/18/24.
+//
+
+import UIKit
+
+enum ContactUnavailableConfiguration {
+    static let noContacts: UIContentUnavailableConfiguration = {
+        var config = UIContentUnavailableConfiguration.empty()
+        config.image = UIImage(systemName: "person.crop.circle")
+        config.text = "저장된 연락처 없음"
+        config.secondaryText = "저장된 연락처 목록이 여기 표시됩니다."
+        return config
+    }()
+
+    static let noSearchingResults: UIContentUnavailableConfiguration = {
+        var config = UIContentUnavailableConfiguration.search()
+        config.text = "검색 결과 없음"
+        config.secondaryText = "조건과 일치하는 검색 결과가 없습니다."
+        return config
+    }()
+}

ContactManager/ContactManager/Data/ContactRepository.swift

@@ -8,9 +8,17 @@
 import Foundation
 
 protocol ContactRepository {
+    func requestContact(id: Int) throws -> Contact
+
     func requestContacts() throws -> [Contact]
 
     func addContact(_ newContact: Contact) throws
+
+    func removeContact(contactID: Int) throws
+
+    func searchContact(with queries: [String]) throws -> [Contact]
+
+    func updateContact(with updatedContact: Contact) throws
 }
 
 struct ContactRepositoryImpl: ContactRepository {
@@ -28,13 +36,67 @@ struct ContactRepositoryImpl: ContactRepository {
         self.fileProvider = fileProvider
     }
 
+    func requestContact(id: Int) throws -> Contact {
+        do {
+            return try self.contactList.getContact(id: id)
+        } catch ContactListError.invalidID {
+            throw ContactRepositoryError.notFound
+        }
+    }
+
     func requestContacts() throws -> [Contact] {
-        return self.contactList.getContacts()
+        let contacts = self.contactList.getContacts()
+        guard contacts.isEmpty == false else { throw ContactRepositoryError.noContacts }
+        return contacts
     }
 
     func addContact(_ newContact: Contact) throws {
         self.contactList.addContact(newContact)
     }
+
+    func removeContact(contactID: Int) throws {
+        do {
+            try self.contactList.deleteContact(contactID: contactID)
+        } catch ContactListError.invalidIndex {
+            throw ContactRepositoryError.cannotRemove
+        } catch {
+            throw error
+        }
+    }
+
+    func searchContact(with queries: [String]) throws -> [Contact] {
+        let contacts = self.contactList.getContacts()
+        var matches = contacts
+        for query in queries {
+            matches = matches.filter { contact in self.match(query, to: contact) }
+        }
+        guard matches.isEmpty == false else { throw ContactRepositoryError.noSearchingResult }
+        return matches
+    }
+
+    func updateContact(with updatedContact: Contact) throws {
+        do {
+            try self.contactList.updateContact(with: updatedContact)
+        } catch {
+            throw ContactRepositoryError.cannotUpdate
+        }
+    }
+
+    private func match(_ query: String, to contact: Contact) -> Bool {
+        // 이름에 쿼리가 포함되는지 확인
+        var result = contact.name.localizedCaseInsensitiveContains(query)
+
+        // 숫자로 바꿀 수 있는 쿼리라면 나이와 같은지 확인
+        if let number = Int(query) {
+            result = result || (contact.age == number)
+        }
+
+        // 하이픈을 제외한 전화번호와 일치하는 부분이 있는지
+        let purePhoneNumberString = contact.phoneNumber.filter { ch in ch.isNumber }
+        result = result || (purePhoneNumberString.localizedStandardContains(query))
+
+        return result
+    }
 }
 
 extension ContactRepositoryImpl {

ContactManager/ContactManager/Data/ContactRepositoryError.swift

@@ -11,13 +11,29 @@ enum ContactRepositoryError: LocalizedError {
     case notFoundAtBundle
     case cannotDecode
 
+    case noContacts
+    case cannotRemove
+    case noSearchingResult
+    case notFound
+    case cannotUpdate
+
     var errorDescription: String? {
         var description: String = "\(String(describing: Self.self)).\(String(describing: self)): "
         switch self {
         case .notFoundAtBundle:
             description += "요청된 파일을 번들에서 찾을 수 없음"
         case .cannotDecode:
             description += "요청된 타입으로 디코딩 실패"
+        case .cannotRemove:
+            description += "인덱스 문제로 삭제 실패"
+        case .noContacts:
+            description += "연락처 데이터 없음"
+        case .noSearchingResult:
+            description += "조건에 맞는 연락처 없음"
+        case .notFound:
+            description += "전달한 ID의 연락처 없음"
+        case .cannotUpdate:
+            description += "ID 문제로 업데이트 실패"
         }
         return description
     }
@@ -30,6 +46,16 @@ extension ContactRepositoryError: AlertableError {
             return .init(body: "표시할 연락처가 없어요.")
         case .cannotDecode:
             return .init(body: "데이터를 알맞은 형태로 바꿔줄 수 없어요.")
+        case .cannotRemove:
+            return .init(body: "선택한 연락처를 삭제할 수 없어요.")
+        case .noContacts:
+            return .init(body: "저장된 연락처가 없어요.")
+        case .noSearchingResult:
+            return .init(body: "검색 결과가 없어요.")
+        case .notFound:
+            return .init(body: "선택한 연락처가 존재하지 않아요.")
+        case .cannotUpdate:
+            return .init(body: "편집한 내용을 저장할 수 없어요.")
         }
     }
 }

ContactManager/ContactManager/Domain/AddContact/AddContact.swift

@@ -6,9 +6,26 @@
 //
 
 enum AddContact {
-    struct Request {
-        let name: String
-        let age: String
-        let phoneNumber: String
+    enum CreatContact {
+        struct Request {
+            let name: String
+            let age: String
+            let phoneNumber: String
+        }
+    }
+
+    enum FetchContact {
+        struct Request {
+            let id: Int
+        }
+    }
+
+    enum UpdateContact {
+        struct Request {
+            let id: Int
+            let name: String
+            let age: String
+            let phoneNumber: String
+        }
     }
 }

ContactManager/ContactManager/Domain/AddContact/AddContactUseCase.swift

@@ -20,7 +20,17 @@ struct AddContactUseCase {
         self.factory = factory
     }
 
-    func saveNewContact(request: AddContact.Request) {
+    func fetchContact(request: AddContact.FetchContact.Request) {
+        do {
+            let id = request.id
+            let contact = try self.repository.requestContact(id: id)
+            presenter?.presentFetchContact(result: .success(contact))
+        } catch {
+            presenter?.presentFetchContact(result: .failure(error))
+        }
+    }
+
+    func saveNewContact(request: AddContact.CreatContact.Request) {
         do {
             let contact = try factory.makeContact(from: request)
             try repository.addContact(contact)
@@ -30,7 +40,17 @@ struct AddContactUseCase {
         }
     }
 
-    func confirmCancel(request: AddContact.Request) {
+    func updateNewContact(request: AddContact.UpdateContact.Request) {
+        do {
+            let contact = try factory.makeExistingContact(from: request)
+            try repository.updateContact(with: contact)
+            presenter?.presentUpdateContact(result: .success(()))
+        } catch {
+            presenter?.presentUpdateContact(result: .failure(error))
+        }
+    }
+
+    func confirmCancel(request: AddContact.CreatContact.Request) {
         do {
             try confirmIfCancellable(request: request)
             presenter?.presentCancelConfirmation(result: .success(()))
@@ -39,7 +59,7 @@ struct AddContactUseCase {
         }
     }
 
-    private func confirmIfCancellable(request: AddContact.Request) throws {
+    private func confirmIfCancellable(request: AddContact.CreatContact.Request) throws {
         guard request.name.isEmpty,
               request.age.isEmpty,
               request.phoneNumber.isEmpty else {
@@ -51,6 +71,8 @@ struct AddContactUseCase {
 import Foundation
 
 protocol AddContactPresentable: NSObjectProtocol {
+    func presentFetchContact(result: Result<Contact, Error>)
     func presentAddContact(result: Result<Void, Error>)
     func presentCancelConfirmation(result: Result<Void, Error>)
+    func presentUpdateContact(result: Result<Void, Error>)
 }

ContactManager/ContactManager/Domain/ListContact/ListContactUseCase.swift

@@ -23,10 +23,33 @@ struct ListContactUseCase {
             presenter?.presentListContact(result: .failure(error))
         }
     }
+
+    func deleteContact(contactID: Int) {
+        do {
+            try repository.removeContact(contactID: contactID)
+            presenter?.presentDeleteContact(result: .success(()))
+        } catch {
+            presenter?.presentDeleteContact(result: .failure(error))
+        }
+    }
+
+    func searchContact(with query: String) {
+        let trimmedQuery = query.trimmingCharacters(in: .whitespacesAndNewlines)
+        let queries = trimmedQuery.components(separatedBy: .whitespacesAndNewlines)
+        do {
+            let matchingContacts = try repository.searchContact(with: queries)
+            let successInfo = ListContact.SuccessInfo(contacts: matchingContacts)
+            presenter?.presentSearchContact(result: .success(successInfo))
+        } catch {
+            presenter?.presentSearchContact(result: .failure(error))
+        }
+    }
 }
 
 import Foundation
 
 protocol ListContactPresentable: NSObjectProtocol {
     func presentListContact(result: Result<ListContact.SuccessInfo, Error>)
+    func presentDeleteContact(result: Result<Void, Error>)
+    func presentSearchContact(result: Result<ListContact.SuccessInfo, Error>)
 }

ContactManager/ContactManager/Domain/Model/Contact.swift

@@ -6,6 +6,8 @@
 //
 
 struct Contact: Hashable, Decodable {
+    let id: Int
+
     let name: String
 
     let phoneNumber: String

ContactManager/ContactManager/Domain/Model/ContactList.swift

@@ -14,6 +14,13 @@ final class ContactList {
         self.contacts = contacts
     }
 
+    func getContact(id: Int) throws -> Contact {
+        guard let contact = self.contacts.first(where: { contact in contact.id == id }) else {
+            throw ContactListError.invalidID
+        }
+        return contact
+    }
+
     func getContacts() -> [Contact] {
         return self.contacts
     }
@@ -26,19 +33,22 @@ final class ContactList {
         self.contacts.insert(newContact, at: 0)
     }
 
-    func deleteContact(at index: Index) throws {
-        guard validateIndex(index) else { throw ContactListError.invalidIndex }
+    func deleteContact(contactID: Int) throws {
+        let index = try getIndexofContact(id: contactID)
         self.contacts.remove(at: index)
     }
 
-    func updateContact(at index: Index, with newContact: Contact) throws {
-        guard validateIndex(index) else { throw ContactListError.invalidIndex }
+    func updateContact(with newContact: Contact) throws {
+        let index = try getIndexofContact(id: newContact.id)
         self.contacts[index] = newContact
     }
 }
 
 extension ContactList {
-    private func validateIndex(_ index: Index) -> Bool {
-        return self.contacts.indices.contains(index)
+    private func getIndexofContact(id: Int) throws -> Index {
+        guard let index = self.contacts.firstIndex(where: { contact in contact.id == id }) else {
+            throw ContactListError.invalidID
+        }
+        return index
     }
 }