📐 모델 데이터 구조 정의 - devlink-community/gaesubang-app GitHub Wiki

이 문서는 개수방 앱의 데이터 모델 구조를 설명합니다. 시스템을 이해하기 위한 기본적인 모델 정의와 각 모델의 속성들을 포함하고 있습니다. 현재 제공된 데이터 모델은 UI 모델 객체로, 사용자 인터페이스에서 상태 관리와 UI 렌더링을 위해 사용됩니다. 데이터베이스 설계나 외부 시스템과의 데이터 전송을 위한 **DTO(Data Transfer Object)**는 따로 설계되어야 합니다.

그룹은 사용자들이 함께 모여 활동하는 단위로, 게시판 또는 커뮤니티 그룹과 같은 역할을 합니다.

• members: 해당 그룹에 속한 멤버들. 각 멤버는 Member 모델로 표현됩니다.
• hashTags: 그룹과 관련된 해시태그들을 여러 개 담을 수 있는 리스트입니다.

시스템 사용자를 나타내는 모델로, 그룹에 가입하거나 게시글을 작성하는 등의 활동을 하는 엔티티입니다.

• email: 이메일 주소는 멤버의 고유 정보를 식별하는 중요한 요소입니다.
• onAir: 멤버의 온라인 상태를 표시하며, 실시간 연결된 상태를 나타냅니다.

커뮤니티 내에서 사용자가 작성한 게시물을 나타내는 모델입니다.

• likes: 각 게시글에 대한 좋아요 정보로, 여러 명의 사용자가 게시글에 좋아요를 눌렀을 때 그 정보를 List 타입으로 기록합니다.

게시글에 대한 좋아요 정보를 나타내는 모델입니다.

• 각 Like는 게시글 ID와 멤버 ID를 연결하여, 어떤 멤버가 어떤 게시글에 좋아요를 눌렀는지 나타냅니다.

게시글에 대한 댓글을 나타내는 모델입니다.

• content: 사용자가 작성한 댓글 내용입니다.
• createdAt: 댓글이 작성된 시간을 기록합니다.

게시글이나 그룹에 태그된 해시태그 정보를 나타냅니다.

• content: 해시태그 내용 (예: "#Flutter", "#DevLink")을 기록합니다.

학습이나 활동 시간을 기록하는 타이머 모델입니다.

• totalTime은 타이머가 측정한 전체 시간을 기록하며, minTime은 최소 설정 시간입니다.

그룹 활동에 대한 출석 정보를 기록하는 모델입니다.

• date와 time은 멤버가 활동을 시작한 날짜와 시간을 기록합니다.

사용자에게 전달되는 알림 정보를 기록하는 모델입니다.

• isRead: 알림을 읽었는지 여부를 나타냅니다.

이 모델들은 다음과 같은 관계를 가집니다:

• Group은 여러 Member를 포함 (1:N)
• Post는 한 Member에 의해 작성됨 (N:1)
• Post는 여러 Like와 Comment를 가질 수 있음 (1:N)
• Member는 여러 Post, Comment, Like를 생성할 수 있음 (1:N)
• HashTag는 여러 Post나 Group에 연결될 수 있음 (N:M)
• Timer와 Attendance는 특정 Member에 연결됨 (N:1)
• Notification은 특정 Member에게 전달됨 (N:1)

%% 개수방 데이터 모델 관계 다이어그램
graph TD
    A[Group] -->|1:N| B[Member]
    A -->|N:M| F[HashTag]
    C[Post] -->|N:1| B
    C -->|1:N| D[Like]
    C -->|1:N| E[Comment]
    B -->|1:N| C
    B -->|1:N| E
    B -->|1:N| D
    G[Timer] -->|N:1| B
    H[Attendance] -->|N:1| B
    I[Notification] -->|N:1| B

현재 개수방 데이터 모델은 UI 모델 객체로 설계되어 있으며, 주로 화면 렌더링 및 사용자 상호작용과 관련된 상태를 관리하는 데 중점을 두고 있습니다. 하지만 **DTO(Data Transfer Object)**는 데이터베이스 또는 API와의 데이터 전송을 위한 객체입니다.

1. 데이터베이스와의 통신: DTO는 데이터베이스와의 통신에서 단순한 데이터 구조로 사용됩니다. 이 모델들은 UI 모델과는 달리 비즈니스 로직을 포함하지 않으며, 단순한 데이터 전송을 담당합니다.
2. 외부 시스템과의 통신: DTO는 외부 시스템(예: REST API)과 데이터를 주고받을 때 사용됩니다. 현재 UI 모델은 외부 시스템과의 데이터 전송을 고려하지 않으므로, 이를 위한 DTO 설계가 추가적으로 필요합니다.
3. 변환 및 직렬화: DTO는 JSON과 같은 형식으로 직렬화되거나 역직렬화됩니다. 이로 인해 데이터베이스에서 값을 가져올 때나 외부 API와 연결될 때 필요한 변환 작업이 포함될 수 있습니다.

따라서 개수방 앱 프로젝트에서 DTO 설계는 향후 외부 시스템과의 통신을 위한 중요한 부분이 될 것입니다. 이 작업은 데이터 모델의 확장성과 유지보수성을 고려할 때 필요합니다.