Feature/#25 - Project CRUD ORM과 Secret-Project 링크 메서드 구현

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,6 +1,6 @@
 <!--
-🙏 PR 제목 컨벤션 (Gitmoji + 타입 + 이슈 번호 + 작업 요약)
-예시: ✨ Feat: #167 예약 취소 구현
+🙏 PR 제목 컨벤션 (타입/#이슈 번호 - 작업 요약)
+예시: Feature/#167 - 예약 취소 구현
 ※ PR 생성 시 Assignees 및 Labels 설정도 잊지 마세요!
 -->
 

Projects/DVData/Sources/RepositoryImpl/Project/ProjectRepositoryImpl.swift

@@ -0,0 +1,149 @@
+// Copyright © 2026 Devault. All rights reserved
+
+import DVDomain
+import Foundation
+import SwiftData
+
+@ModelActor
+public actor ProjectRepositoryImpl: ProjectRepository {
+    public func create(_ project: DVDomain.Project) async throws -> DVDomain.Project {
+        do {
+            if try fetchLocalProject(id: project.id) != nil {
+                throw ProjectRepositoryError.duplicateID(id: project.id)
+            }
+
+            if try containsProjectName(project.name, excluding: nil) {
+                throw ProjectRepositoryError.duplicateName(name: project.name)
+            }
+
+            let localProject = SwiftDataModel.Project(
+                id: project.id,
+                name: project.name,
+                createdAt: project.createdAt,
+                updatedAt: project.updatedAt
+            )
+
+            modelContext.insert(localProject)
+            try modelContext.save()
+
+            return localProject.toDomain()
+        } catch let error as ProjectRepositoryError {
+            throw error
+        } catch {
+            throw ProjectRepositoryError.persistenceFailed
+        }
+    }
+
+    public func fetch(id: UUID) async throws -> DVDomain.Project? {
+        do {
+            guard let localProject = try fetchLocalProject(id: id) else {
+                return nil
+            }
+            return localProject.toDomain()
+        } catch let error as ProjectRepositoryError {
+            throw error
+        } catch {
+            throw ProjectRepositoryError.persistenceFailed
+        }
+    }
+
+    public func fetchAll() async throws -> [DVDomain.Project] {
+        do {
+            let descriptor = FetchDescriptor<SwiftDataModel.Project>(
+                sortBy: [SortDescriptor(\.name, order: .forward)]
+            )
+            let localProjects = try modelContext.fetch(descriptor)
+            return localProjects.map { $0.toDomain() }
+        } catch let error as ProjectRepositoryError {
+            throw error
+        } catch {
+            throw ProjectRepositoryError.persistenceFailed
+        }
+    }
+
+    public func patch(id: UUID, with patch: ProjectPatch) async throws -> DVDomain.Project {
+        do {
+            guard let localProject = try fetchLocalProject(id: id) else {
+                throw ProjectRepositoryError.notFound(id: id)
+            }
+
+            let shouldSave = try apply(patch, to: localProject)
+            if shouldSave {
+                try modelContext.save()
+            }
+
+            return localProject.toDomain()
+        } catch let error as ProjectRepositoryError {
+            throw error
+        } catch {
+            throw ProjectRepositoryError.persistenceFailed
+        }
+    }
+
+    public func delete(id: UUID) async throws {
+        do {
+            guard let localProject = try fetchLocalProject(id: id) else {
+                throw ProjectRepositoryError.notFound(id: id)
+            }
+
+            modelContext.delete(localProject)
+            try modelContext.save()
+        } catch let error as ProjectRepositoryError {
+            throw error
+        } catch {
+            throw ProjectRepositoryError.persistenceFailed
+        }
+    }
+}
+
+extension ProjectRepositoryImpl {
+    private func fetchLocalProject(id: UUID) throws -> SwiftDataModel.Project? {
+        var descriptor = FetchDescriptor<SwiftDataModel.Project>(
+            predicate: #Predicate { $0.id == id }
+        )
+        descriptor.fetchLimit = 1
+        return try modelContext.fetch(descriptor).first
+    }
+
+    /// ProjectPatch를 SwiftData model에 반영하고 저장 필요 여부를 반환한다.
+    private func apply(
+        _ patch: ProjectPatch,
+        to project: SwiftDataModel.Project
+    ) throws -> Bool {
+        var shouldSave = false
+
+        if case let .set(name) = patch.name {
+            if try containsProjectName(name, excluding: project.id) {
+                throw ProjectRepositoryError.duplicateName(name: name)
+            }
+            project.name = name
+            shouldSave = true
+        }
+
+        if case let .set(updatedAt) = patch.updatedAt {
+            project.updatedAt = updatedAt
+            shouldSave = true
+        }
+
+        return shouldSave
+    }
+
+    /// 비교용 이름 key를 기준으로 같은 이름의 Project가 있는지 확인한다.
+    private func containsProjectName(
+        _ name: String,
+        excluding excludedID: UUID?
+    ) throws -> Bool {
+        let nameKey = projectNameKey(name)
+        let descriptor = FetchDescriptor<SwiftDataModel.Project>()
+        let projects = try modelContext.fetch(descriptor)
+
+        return projects.contains { project in
+            let isExcluded = excludedID.map { project.id == $0 } ?? false // 자기 자신 제외
+            return !isExcluded && projectNameKey(project.name) == nameKey
+        }
+    }
+
+    private func projectNameKey(_ name: String) -> String {
+        name.lowercased()
+    }
+}

Projects/DVData/Sources/RepositoryImpl/Secret/InMemorySecretQueryFilter.swift

@@ -19,10 +19,10 @@ enum InMemorySecretQueryFilter {
             return true
         }
 
-        let fields = [
+        let fields: [String?] = [
             secret.name,
-            secret.secretType,
-            secret.subType,
+            secret.secretType.rawValue,
+            secret.subType?.rawValue,
             secret.service,
             secret.environment,
             secret.memo,

Projects/DVData/Sources/RepositoryImpl/Secret/SecretRepositoryImpl.swift

@@ -15,8 +15,8 @@ public actor SecretRepositoryImpl: SecretRepository {
             let localSecret = SwiftDataModel.Secret(
                 id: secret.id,
                 name: secret.name,
-                secretType: secret.secretType,
-                subType: secret.subType,
+                secretType: secret.secretType.rawValue,
+                subType: secret.subType?.rawValue,
                 service: secret.service,
                 environment: secret.environment,
                 expiresAt: secret.expiresAt,
@@ -117,6 +117,81 @@ public actor SecretRepositoryImpl: SecretRepository {
             throw SecretRepositoryError.persistenceFailed
         }
     }
+
+    public func fetchProjects(secretID: UUID) async throws -> [DVDomain.Project] {
+        do {
+            guard let localSecret = try fetchLocalSecret(id: secretID) else {
+                throw SecretRepositoryError.notFound(id: secretID)
+            }
+
+            return localSecret.projects
+                .sorted { $0.name < $1.name }
+                .map { $0.toDomain() }
+        } catch let error as SecretRepositoryError {
+            throw error
+        } catch {
+            throw SecretRepositoryError.persistenceFailed
+        }
+    }
+
+    public func linkProject(secretID: UUID, projectID: UUID) async throws {
+        do {
+            guard let localSecret = try fetchLocalSecret(id: secretID) else {
+                throw SecretRepositoryError.notFound(id: secretID)
+            }
+
+            guard let localProject = try fetchLocalProject(id: projectID) else {
+                throw SecretRepositoryError.projectNotFound(id: projectID)
+            }
+
+            if try fetchLocalProjectLink(secretID: secretID, projectID: projectID) != nil {
+                throw SecretRepositoryError.duplicateProjectLink(
+                    secretID: secretID,
+                    projectID: projectID
+                )
+            }
+
+            let link = SwiftDataModel.SecretProjectLink(
+                project: localProject,
+                secret: localSecret
+            )
+            modelContext.insert(link)
+            try modelContext.save()
+        } catch let error as SecretRepositoryError {
+            throw error
+        } catch {
+            throw SecretRepositoryError.persistenceFailed
+        }
+    }
+
+    public func unlinkProject(secretID: UUID, projectID: UUID) async throws {
+        do {
+            guard try fetchLocalSecret(id: secretID) != nil else {
+                throw SecretRepositoryError.notFound(id: secretID)
+            }
+
+            guard try fetchLocalProject(id: projectID) != nil else {
+                throw SecretRepositoryError.projectNotFound(id: projectID)
+            }
+
+            guard let link = try fetchLocalProjectLink(
+                secretID: secretID,
+                projectID: projectID
+            ) else {
+                throw SecretRepositoryError.projectLinkNotFound(
+                    secretID: secretID,
+                    projectID: projectID
+                )
+            }
+
+            modelContext.delete(link)
+            try modelContext.save()
+        } catch let error as SecretRepositoryError {
+            throw error
+        } catch {
+            throw SecretRepositoryError.persistenceFailed
+        }
+    }
 }
 
 extension SecretRepositoryImpl {
@@ -128,16 +203,40 @@ extension SecretRepositoryImpl {
         return try modelContext.fetch(descriptor).first
     }
 
+    private func fetchLocalProject(id: UUID) throws -> SwiftDataModel.Project? {
+        var descriptor = FetchDescriptor<SwiftDataModel.Project>(
+            predicate: #Predicate { $0.id == id }
+        )
+        descriptor.fetchLimit = 1
+        return try modelContext.fetch(descriptor).first
+    }
+
+    private func fetchLocalProjectLink(
+        secretID: UUID,
+        projectID: UUID
+    ) throws -> SwiftDataModel.SecretProjectLink? {
+        let linkKey = projectLinkKey(secretID: secretID, projectID: projectID)
+        var descriptor = FetchDescriptor<SwiftDataModel.SecretProjectLink>(
+            predicate: #Predicate { $0.linkKey == linkKey }
+        )
+        descriptor.fetchLimit = 1
+        return try modelContext.fetch(descriptor).first
+    }
+
+    private func projectLinkKey(secretID: UUID, projectID: UUID) -> String {
+        "\(projectID.uuidString):\(secretID.uuidString)"
+    }
+
     /// SecretPatch를 SwiftData model에 반영
     private func apply(_ patch: SecretPatch, to secret: SwiftDataModel.Secret) {
         if case let .set(name) = patch.name {
             secret.name = name
         }
         if case let .set(secretType) = patch.secretType {
-            secret.secretType = secretType
+            secret.secretType = secretType.rawValue
         }
         if case let .set(subType) = patch.subType {
-            secret.subType = subType
+            secret.subType = subType?.rawValue
         }
         if case let .set(service) = patch.service {
             secret.service = service

Projects/DVData/Sources/Storage/Local/Models/Project.swift

@@ -1,5 +1,6 @@
 // Copyright © 2026 Devault. All rights reserved
 
+import DVDomain
 import Foundation
 import SwiftData
 
@@ -32,3 +33,14 @@ extension SwiftDataModel {
         }
     }
 }
+
+extension SwiftDataModel.Project {
+    func toDomain() -> DVDomain.Project {
+        DVDomain.Project(
+            id: id,
+            name: name,
+            createdAt: createdAt,
+            updatedAt: updatedAt
+        )
+    }
+}

Projects/DVData/Sources/Storage/Local/Models/Secret.swift

@@ -80,8 +80,8 @@ extension SwiftDataModel.Secret {
         return DVDomain.Secret(
             id: id,
             name: name,
-            secretType: secretType,
-            subType: subType,
+            secretType: DVDomain.SecretType(rawValue: secretType) ?? .etc,
+            subType: subType.flatMap(DVDomain.SecretSubType.init(rawValue:)),
             service: service,
             environment: environment,
             expiresAt: expiresAt,

Projects/DVDomain/Sources/Entity/Project.swift

@@ -0,0 +1,22 @@
+// Copyright © 2026 Devault. All rights reserved
+
+import Foundation
+
+public struct Project: Equatable, Identifiable, Sendable {
+    public var id: UUID
+    public var name: String
+    public var createdAt: Date
+    public var updatedAt: Date
+
+    public init(
+        id: UUID,
+        name: String,
+        createdAt: Date,
+        updatedAt: Date
+    ) {
+        self.id = id
+        self.name = name
+        self.createdAt = createdAt
+        self.updatedAt = updatedAt
+    }
+}

Projects/DVDomain/Sources/Entity/Secret.swift

@@ -5,8 +5,8 @@ import Foundation
 public struct Secret: Equatable, Identifiable, Sendable {
     public var id: UUID
     public var name: String
-    public var secretType: String
-    public var subType: String?
+    public var secretType: SecretType
+    public var subType: SecretSubType?
     public var service: String?
     public var environment: String?
     public var expiresAt: Date?
@@ -21,8 +21,8 @@ public struct Secret: Equatable, Identifiable, Sendable {
     public init(
         id: UUID,
         name: String,
-        secretType: String,
-        subType: String? = nil,
+        secretType: SecretType,
+        subType: SecretSubType? = nil,
         service: String? = nil,
         environment: String? = nil,
         expiresAt: Date? = nil,