feat: 공지 리스트/상세/작성 본 구현

Modules/Data/Sources/Network/Endpoint/APIEndpoints.swift

@@ -398,7 +398,7 @@ extension APIEndpoints {
             query["cursor"] = cursor
         }
 
-        return try Endpoint(path: "comment/\(postId)",
+        return try Endpoint(path: "comment/post/\(postId)",
                             authenticationType: .accessToken,
                             method: .get,
                             headerParameters: HTTPHeader.getReceiveJsonHeader(),
@@ -408,7 +408,7 @@ extension APIEndpoints {
     static func createComment(postId: Int,
                               comment: String,
                               mentions: [Int]) throws -> Endpoint<CommentResponse> {
-        return try Endpoint(path: "comment/\(postId)",
+        return try Endpoint(path: "comment/post/\(postId)",
                             authenticationType: .accessToken,
                             method: .post,
                             headerParameters: HTTPHeader.getSendAndReceiveJsonHeader(),
@@ -439,7 +439,7 @@ extension APIEndpoints {
                                    commentId: Int,
                                    comment: String,
                                    mentions: [Int]) throws -> Endpoint<CommentResponse> {
-        return try Endpoint(path: "comment/\(postId)/\(commentId)",
+        return try Endpoint(path: "comment/post/\(postId)/\(commentId)",
                             authenticationType: .accessToken,
                             method: .post,
                             headerParameters: HTTPHeader.getSendAndReceiveJsonHeader(),
@@ -456,7 +456,7 @@ extension APIEndpoints {
             cursorQuery["cursor"] = nextCursor
         }
 
-        return try Endpoint(path: "comment/\(postId)/\(commentId)",
+        return try Endpoint(path: "comment/post/\(postId)/\(commentId)",
                             authenticationType: .accessToken,
                             method: .get,
                             headerParameters: HTTPHeader.getReceiveJsonHeader(),
@@ -465,7 +465,7 @@ extension APIEndpoints {
 
     // MARK: - Like
     static func likeComment(commentId: Int) throws -> Endpoint<CommentResponse> {
-        return try Endpoint(path: "comment/\(commentId)/likes",
+        return try Endpoint(path: "comment/post/\(commentId)/likes",
                             authenticationType: .accessToken,
                             method: .post,
                             headerParameters: HTTPHeader.getReceiveJsonHeader())
@@ -600,7 +600,7 @@ extension APIEndpoints {
 
     static func subscribeMeetNotify(type: SubscribeType,
                                     isSubscribe: Bool) throws -> Endpoint<Void> {
-        
+
         let path = isSubscribe ? "notification/subscribe" : "notification/unsubscribe"
         return try Endpoint(path: path,
                             authenticationType: .accessToken,
@@ -609,3 +609,103 @@ extension APIEndpoints {
                             bodyParameters: ["topics": ["\(type.rawValue)"]])
     }
 }
+
+// MARK: - 공지 (Notice)
+extension APIEndpoints {
+    // 공지 리스트 — GET /notice/list/{meetId}
+    static func fetchNoticeList(meetId: Int,
+                                size: Int?,
+                                cursor: String?) throws -> Endpoint<PageResponse<NoticeResponse>> {
+        var query: [String: Any] = [:]
+        if let size { query["size"] = size }
+        if let cursor, !cursor.isEmpty { query["cursor"] = cursor }
+
+        return try Endpoint(path: "notice/list/\(meetId)",
+                            authenticationType: .accessToken,
+                            method: .get,
+                            headerParameters: HTTPHeader.getReceiveJsonHeader(),
+                            queryParameters: query)
+    }
+
+    // 공지 단건 상세 — GET /notice/detail/{noticeId}
+    static func fetchNoticeDetail(noticeId: Int) throws -> Endpoint<NoticeResponse> {
+        return try Endpoint(path: "notice/detail/\(noticeId)",
+                            authenticationType: .accessToken,
+                            method: .get,
+                            headerParameters: HTTPHeader.getReceiveJsonHeader())
+    }
+
+    // 공지 생성 — POST /notice/create
+    static func createNotice(meetId: Int,
+                             content: String) throws -> Endpoint<NoticeResponse> {
+        return try Endpoint(path: "notice/create",
+                            authenticationType: .accessToken,
+                            method: .post,
+                            headerParameters: HTTPHeader.getSendAndReceiveJsonHeader(),
+                            bodyParameters: ["meetId": meetId,
+                                             "content": content])
+    }
+
+    // 공지 수정 — PATCH /notice/update/{noticeId}
+    static func updateNotice(noticeId: Int,
+                             meetId: Int,
+                             content: String) throws -> Endpoint<NoticeResponse> {
+        return try Endpoint(path: "notice/update/\(noticeId)",
+                            authenticationType: .accessToken,
+                            method: .patch,
+                            headerParameters: HTTPHeader.getSendAndReceiveJsonHeader(),
+                            bodyParameters: ["meetId": meetId,
+                                             "content": content])
+    }
+
+    // 공지 삭제 — DELETE /notice/{noticeId}
+    static func deleteNotice(noticeId: Int) throws -> Endpoint<Void> {
+        return try Endpoint(path: "notice/\(noticeId)",
+                            authenticationType: .accessToken,
+                            method: .delete,
+                            headerParameters: HTTPHeader.getReceiveAllHeader())
+    }
+
+    // 공지 고정 — PATCH /notice/pin/{noticeId}
+    static func pinNotice(noticeId: Int) throws -> Endpoint<NoticeResponse> {
+        return try Endpoint(path: "notice/pin/\(noticeId)",
+                            authenticationType: .accessToken,
+                            method: .patch,
+                            headerParameters: HTTPHeader.getReceiveJsonHeader())
+    }
+
+    // 공지 고정 해제 — DELETE /notice/pin/{noticeId}
+    static func unpinNotice(noticeId: Int) throws -> Endpoint<NoticeResponse> {
+        return try Endpoint(path: "notice/pin/\(noticeId)",
+                            authenticationType: .accessToken,
+                            method: .delete,
+                            headerParameters: HTTPHeader.getReceiveJsonHeader())
+    }
+
+    // 공지 댓글 조회 — GET /comment/notice/{noticeId}
+    static func fetchNoticeCommentList(noticeId: Int,
+                                       size: Int?,
+                                       cursor: String?) throws -> Endpoint<PageResponse<NoticeCommentResponse>> {
+        var query: [String: Any] = [:]
+        if let size { query["size"] = size }
+        if let cursor, !cursor.isEmpty { query["cursor"] = cursor }
+
+        return try Endpoint(path: "comment/notice/\(noticeId)",
+                            authenticationType: .accessToken,
+                            method: .get,
+                            headerParameters: HTTPHeader.getReceiveJsonHeader(),
+                            queryParameters: query)
+    }
+
+    // 공지 댓글 생성 — POST /comment/notice/{noticeId}
+    static func createNoticeComment(noticeId: Int,
+                                    content: String,
+                                    mentions: [Int]) throws -> Endpoint<NoticeCommentResponse> {
+        return try Endpoint(path: "comment/notice/\(noticeId)",
+                            authenticationType: .accessToken,
+                            method: .post,
+                            headerParameters: HTTPHeader.getSendAndReceiveJsonHeader(),
+                            bodyParameters: ["contents": content,
+                                             "mentions": mentions])
+    }
+}

Modules/Data/Sources/Network/Protocols/NetworkService.swift

@@ -19,6 +19,7 @@ public protocol NetworkSessionManager {
 
 public protocol NetworkErrorLogger {
     func log(request: URLRequest)
+    func log(response: HTTPURLResponse, data: Data?)
     func log(responseData data: Data?)
     func log(error: Error)
 }

Modules/Data/Sources/Network/Response/Notice/NoticeCommentResponse.swift

@@ -0,0 +1,40 @@
+//
+//  NoticeCommentResponse.swift
+//  Data
+//
+//  Created by CatSlave on 5/26/26.
+//
+//  서버 NoticeCommentClientResponse — 공지 댓글 객체.
+//  Post 댓글과 달리 likes/replies/mentions 정보가 응답에 없어 Comment 도메인의 일부만 채운다.
+//
+
+import Foundation
+import Domain
+
+struct NoticeCommentResponse: Decodable {
+    let commentId: Int?
+    let version: Int?
+    let content: String?
+    let parentId: Int?
+    let writer: UserInfoResponse?
+    let time: String?
+    let noticeId: Int?
+}
+
+extension NoticeCommentResponse {
+    func toDomain() -> Comment {
+        let date = DateManager.parseServerFullDate(string: time)
+        return .init(id: commentId,
+                     postId: noticeId,
+                     parentId: parentId,
+                     writerId: writer?.userId,
+                     writerName: writer?.nickname,
+                     writerThumbnailPath: writer?.image,
+                     comment: content,
+                     createdDate: date,
+                     isLiked: false,
+                     likeCount: 0,
+                     replyCount: 0,
+                     mentions: [])
+    }
+}

Modules/Data/Sources/Network/Response/Notice/NoticeResponse.swift

@@ -17,6 +17,7 @@ struct NoticeResponse: Decodable {
     let meetId: Int?
     let type: String?
     let content: String?
+    let writer: UserInfoResponse?   // 공지 작성자 (isExistBadgeCount는 응답에 없어도 옵셔널이라 디코딩 OK)
     let pinned: Bool?
     let createdAt: String?
 }
@@ -29,6 +30,7 @@ extension NoticeResponse {
             meetId: meetId,
             type: NoticeType(rawValue: type ?? ""),
             content: content,
+            writer: writer?.toDomain(),
             isPinned: pinned ?? false,
             createdAt: DateManager.parseServerFullDate(string: createdAt)
         )

Modules/Data/Sources/PersistentStorages/UserDefaults/ReviewSuggestionStorage.swift

@@ -0,0 +1,31 @@
+//
+//  ReviewSuggestionStorage.swift
+//  Mople
+//
+//  Created by CatSlave on 6/12/26.
+//
+
+import Foundation
+
+private enum UserDefaultsKey: String {
+    case suggestedReviewPostIds
+}
+
+/// 후기 작성 추천 알럿의 노출 이력을 게시글 단위로 관리한다.
+/// - 같은 후기 게시글에 다시 들어와도 알럿이 매번 뜨지 않고, 게시글마다 최초 1회만 노출되도록 한다.
+public extension UserDefaults {
+
+    /// 해당 게시글에서 후기 추천 알럿을 이미 노출했는지 여부
+    static func hasSuggestedReview(postId: Int) -> Bool {
+        let shownIds = UserDefaults.standard.array(forKey: UserDefaultsKey.suggestedReviewPostIds.rawValue) as? [Int] ?? []
+        return shownIds.contains(postId)
+    }
+
+    /// 해당 게시글의 후기 추천 알럿 노출 이력을 기록한다.
+    static func markSuggestedReview(postId: Int) {
+        var shownIds = UserDefaults.standard.array(forKey: UserDefaultsKey.suggestedReviewPostIds.rawValue) as? [Int] ?? []
+        guard !shownIds.contains(postId) else { return }
+        shownIds.append(postId)
+        UserDefaults.standard.set(shownIds, forKey: UserDefaultsKey.suggestedReviewPostIds.rawValue)
+    }
+}

Modules/Data/Sources/Repositories/Notice/DefaultNoticeRepo.swift

@@ -0,0 +1,99 @@
+//
+//  DefaultNoticeRepo.swift
+//  Data
+//
+//  Created by CatSlave on 5/26/26.
+//
+
+import Foundation
+import Domain
+
+public final class DefaultNoticeRepo: BaseRepositories, NoticeRepo {
+
+    // MARK: - 공지 CRUD
+    public func fetchNoticeList(meetId: Int,
+                                size: Int?,
+                                cursor: String?) async throws -> Page<Notice> {
+        let response: PageResponse<NoticeResponse> = try await self.networkService.authenticatedRequest {
+            try APIEndpoints.fetchNoticeList(meetId: meetId,
+                                             size: size,
+                                             cursor: cursor)
+        }
+        return Page(totalCount: response.totalCount ?? 0,
+                    content: response.content.map { $0.toDomain() },
+                    info: response.page?.toDomain())
+    }
+
+    public func fetchNoticeDetail(noticeId: Int) async throws -> Notice {
+        let response: NoticeResponse = try await self.networkService.authenticatedRequest {
+            try APIEndpoints.fetchNoticeDetail(noticeId: noticeId)
+        }
+        return response.toDomain()
+    }
+
+    public func createNotice(meetId: Int,
+                             content: String) async throws -> Notice {
+        let response: NoticeResponse = try await self.networkService.authenticatedRequest {
+            try APIEndpoints.createNotice(meetId: meetId,
+                                          content: content)
+        }
+        return response.toDomain()
+    }
+
+    public func updateNotice(noticeId: Int,
+                             meetId: Int,
+                             content: String) async throws -> Notice {
+        let response: NoticeResponse = try await self.networkService.authenticatedRequest {
+            try APIEndpoints.updateNotice(noticeId: noticeId,
+                                          meetId: meetId,
+                                          content: content)
+        }
+        return response.toDomain()
+    }
+
+    public func deleteNotice(noticeId: Int) async throws {
+        return try await self.networkService.authenticatedRequest {
+            try APIEndpoints.deleteNotice(noticeId: noticeId)
+        }
+    }
+
+    // MARK: - 고정 토글
+    public func pinNotice(noticeId: Int) async throws -> Notice {
+        let response: NoticeResponse = try await self.networkService.authenticatedRequest {
+            try APIEndpoints.pinNotice(noticeId: noticeId)
+        }
+        return response.toDomain()
+    }
+
+    public func unpinNotice(noticeId: Int) async throws -> Notice {
+        let response: NoticeResponse = try await self.networkService.authenticatedRequest {
+            try APIEndpoints.unpinNotice(noticeId: noticeId)
+        }
+        return response.toDomain()
+    }
+
+    // MARK: - 공지 댓글
+    public func fetchNoticeCommentList(noticeId: Int,
+                                       size: Int?,
+                                       cursor: String?) async throws -> Page<Comment> {
+        let response: PageResponse<NoticeCommentResponse> = try await self.networkService.authenticatedRequest {
+            try APIEndpoints.fetchNoticeCommentList(noticeId: noticeId,
+                                                    size: size,
+                                                    cursor: cursor)
+        }
+        return Page(totalCount: response.totalCount ?? 0,
+                    content: response.content.map { $0.toDomain() },
+                    info: response.page?.toDomain())
+    }
+
+    public func createNoticeComment(noticeId: Int,
+                                    content: String,
+                                    mentions: [Int]) async throws -> Comment {
+        let response: NoticeCommentResponse = try await self.networkService.authenticatedRequest {
+            try APIEndpoints.createNoticeComment(noticeId: noticeId,
+                                                 content: content,
+                                                 mentions: mentions)
+        }
+        return response.toDomain()
+    }
+}

Modules/Domain/Sources/Entities/Meet/Meet.swift

@@ -35,3 +35,20 @@ public struct Meet {
         self.pinnedNotice = pinnedNotice
     }
 }
+
+public extension Meet {
+    // pinnedNotice는 let 이라 부분 갱신 불가 — copy with replacement 헬퍼.
+    // 공지 핀 토글 알림 수신 시 모임상세 상태를 새 인스턴스로 갱신할 때 사용.
+    func with(pinnedNotice: Notice?) -> Meet {
+        return Meet(
+            isCreator: isCreator,
+            meetSummary: meetSummary,
+            sinceDays: sinceDays,
+            creatorId: creatorId,
+            memberCount: memberCount,
+            firstPlanDate: firstPlanDate,
+            version: version,
+            pinnedNotice: pinnedNotice
+        )
+    }
+}

Modules/Domain/Sources/Entities/Notice/Notice.swift

@@ -15,6 +15,7 @@ public struct Notice: Hashable {
     public let meetId: Int?
     public let type: NoticeType?
     public let content: String?
+    public let writer: UserInfo?   // 공지 작성자 (백엔드 writer 응답)
     public let isPinned: Bool
     public let createdAt: Date?
 
@@ -23,13 +24,15 @@ public struct Notice: Hashable {
                 meetId: Int? = nil,
                 type: NoticeType? = nil,
                 content: String? = nil,
+                writer: UserInfo? = nil,
                 isPinned: Bool = false,
                 createdAt: Date? = nil) {
         self.noticeId = noticeId
         self.version = version
         self.meetId = meetId
         self.type = type
         self.content = content
+        self.writer = writer
         self.isPinned = isPinned
         self.createdAt = createdAt
     }