[FEAT] 학습, 백킹트랙, 알림, 구독 도메인 관련 엔티티 구현(#16)

src/main/java/com/mr/domain/backingTrack/entity/BackingTrack.java

@@ -0,0 +1,160 @@
+package com.mr.domain.backingTrack.entity;
+
+import com.mr.domain.backingTrack.entity.enums.AccessLevel;
+import com.mr.domain.backingTrack.entity.enums.Level;
+import com.mr.domain.backingTrack.entity.enums.ScaleType;
+import com.mr.global.entity.BaseTimeDeletedEntity;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Index;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.Table;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Entity
+@Table(
+        name = "backing_track",
+        indexes = {
+                @Index(name = "idx_bt_genre_play",
+                        columnList = "genre, play_count"),
+        }
+)
+@NoArgsConstructor(access = lombok.AccessLevel.PROTECTED)
+public class BackingTrack extends BaseTimeDeletedEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "backing_track_id")
+    private Long id;
+
+    // 유저 아이디
+    @Column(name = "user_id", nullable = false)
+    private Long userId;
+
+    // 학원 아이디
+    @Column(name = "academy_id")
+    private Long academyId;
+
+    // 트랙 이름
+    @Column(name = "title", nullable = false, length = 50)
+    private String title;
+
+    // 장르
+    @Column(name = "genre", nullable = false, length = 50)
+    private String genre;
+
+    // key
+    @Column(name = "key_signature", nullable = false, length = 20)
+    private String keySignature;
+
+    // 조성
+    @Enumerated(EnumType.STRING)
+    @Column(name = "scale_type", nullable = false)
+    private ScaleType scaleType;
+
+    // 박자
+    @Column(name = "time_signature", nullable = false, length = 10)
+    private String timeSignature;
+
+    // bpm
+    @Column(name = "bpm", nullable = false)
+    private Integer bpm;
+
+    // 재생 시간
+    @Column(name = "playtime_sec", nullable = false)
+    private Integer playtimeSec;
+
+    // 오디오 파일
+    @Column(name = "audio_file_url", length = 255)
+    private String audioFileUrl;
+
+    @Column(name = "midi_file_url", columnDefinition = "JSON")
+    private String midiFileUrl;
+
+    // 재생 수
+    @Column(name = "play_count", nullable = false)
+    private Integer playCount;
+
+    // 공개 범위
+    @Enumerated(EnumType.STRING)
+    @Column(name = "access_level", nullable = false)
+    private AccessLevel accessLevel;
+
+    // 난이도
+    @Enumerated(EnumType.STRING)
+    @Column(name = "level", nullable = false)
+    private Level level;
+
+    @Builder(access = lombok.AccessLevel.PRIVATE)
+    private BackingTrack(Long userId, Long academyId, String title, String genre,
+                         String keySignature, ScaleType scaleType, String timeSignature,
+                         Integer bpm, Integer playtimeSec, String audioFileUrl,
+                         String midiFileUrl, Integer playCount,
+                         AccessLevel accessLevel, Level level) {
+        this.userId = userId;
+        this.academyId = academyId;
+        this.title = title;
+        this.genre = genre;
+        this.keySignature = keySignature;
+        this.scaleType = scaleType;
+        this.timeSignature = timeSignature;
+        this.bpm = bpm;
+        this.playtimeSec = playtimeSec;
+        this.audioFileUrl = audioFileUrl;
+        this.midiFileUrl = midiFileUrl;
+        this.playCount = playCount != null ? playCount : 0;
+        this.accessLevel = accessLevel != null ? accessLevel : AccessLevel.PRIVATE;
+        this.level = level != null ? level : Level.BASIC;
+    }
+
+    public static BackingTrack create(Long userId, Long academyId, String title, String genre,
+                                      String keySignature, ScaleType scaleType, String timeSignature,
+                                      Integer bpm, Integer playtimeSec, String audioFileUrl,
+                                      String midiFileUrl, AccessLevel accessLevel, Level level) {
+        return BackingTrack.builder()
+                .userId(userId)
+                .academyId(academyId)
+                .title(title)
+                .genre(genre)
+                .keySignature(keySignature)
+                .scaleType(scaleType)
+                .timeSignature(timeSignature)
+                .bpm(bpm)
+                .playtimeSec(playtimeSec)
+                .audioFileUrl(audioFileUrl)
+                .midiFileUrl(midiFileUrl)
+                .playCount(0)
+                .accessLevel(accessLevel)
+                .level(level)
+                .build();
+    }
+
+    public void updateTrackInfo(String title, String genre, String keySignature,
+                                ScaleType scaleType, String timeSignature, Integer bpm,
+                                Integer playtimeSec, AccessLevel accessLevel, Level level) {
+        this.title = title;
+        this.genre = genre;
+        this.keySignature = keySignature;
+        this.scaleType = scaleType;
+        this.timeSignature = timeSignature;
+        this.bpm = bpm;
+        this.playtimeSec = playtimeSec;
+        if (accessLevel != null) this.accessLevel = accessLevel;
+        if (level != null) this.level = level;
+    }
+
+    // 공개 범위 수정
+    public void changeAccessLevel(AccessLevel accessLevel) {
+        if (accessLevel != null) {
+            this.accessLevel = accessLevel;
+        }
+    }
+}

src/main/java/com/mr/domain/backingTrack/entity/ChordProgression.java

@@ -0,0 +1,77 @@
+package com.mr.domain.backingTrack.entity;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Index;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.Table;
+import jakarta.persistence.UniqueConstraint;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Getter
+@Table(
+        name = "chord_progression",
+        uniqueConstraints = {
+                @UniqueConstraint(
+                        name = "uk_chord_progression_track_measure_seq",
+                        columnNames = {"backing_track_id", "measure_no", "sequence_no"}
+                )
+        }
+)
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class ChordProgression{
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "chord_progression_id")
+    private Long chordProgressionId;
+
+    // 백킹트랙 아이디
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "backing_track_id", nullable = false)
+    private BackingTrack backingTrack;
+
+    // 코드 순서
+    @Column(name = "sequence_no", nullable = false)
+    private Integer sequenceNo;
+
+    // 마디 번호
+    @Column(name = "measure_no", nullable = false)
+    private Integer measureNo;
+
+    // 코드명
+    @Column(name = "chord_name", nullable = false, length = 30)
+    private String chordName;
+
+    @Builder(access = AccessLevel.PRIVATE)
+    private ChordProgression(BackingTrack backingTrack, Integer sequenceNo, Integer measureNo, String chordName) {
+        this.backingTrack = backingTrack;
+        this.sequenceNo = sequenceNo;
+        this.measureNo = measureNo;
+        this.chordName = chordName;
+    }
+
+    public static ChordProgression create(BackingTrack backingTrack, Integer sequenceNo, Integer measureNo, String chordName) {
+        return ChordProgression.builder()
+                .backingTrack(backingTrack)
+                .sequenceNo(sequenceNo)
+                .measureNo(measureNo)
+                .chordName(chordName)
+                .build();
+    }
+
+    public void updateChordInfo(Integer sequenceNo, Integer measureNo, String chordName) {
+        this.sequenceNo = sequenceNo;
+        this.measureNo = measureNo;
+        this.chordName = chordName;
+    }
+}

src/main/java/com/mr/domain/backingTrack/entity/enums/AccessLevel.java

@@ -0,0 +1,7 @@
+package com.mr.domain.backingTrack.entity.enums;
+
+public enum AccessLevel {
+    PRIVATE,
+    ACADEMY,
+    PUBLIC
+}

src/main/java/com/mr/domain/backingTrack/entity/enums/Level.java

@@ -0,0 +1,7 @@
+package com.mr.domain.backingTrack.entity.enums;
+
+public enum Level {
+    BASIC,
+    MED,
+    ADVANCED
+}

src/main/java/com/mr/domain/backingTrack/entity/enums/ScaleType.java

@@ -0,0 +1,6 @@
+package com.mr.domain.backingTrack.entity.enums;
+
+public enum ScaleType {
+    MAJOR,
+    MINOR
+}

src/main/java/com/mr/domain/learning/entity/ChordExample.java

@@ -0,0 +1,86 @@
+package com.mr.domain.learning.entity;
+
+import com.mr.global.entity.BaseCreatedEntity;
+import jakarta.persistence.CollectionTable;
+import jakarta.persistence.Column;
+import jakarta.persistence.ElementCollection;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.Table;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Getter
+@Table(
+        name = "chord_example"
+)
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class ChordExample extends BaseCreatedEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "chord_example_id")
+    private Long id;
+
+    // 학습 단계 id
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "learning_step_id", nullable = false)
+    private LearningStep learningStep;
+
+    // 코드명
+    @Column(name = "chord_name", nullable = false, length = 100)
+    private String chordName;
+
+    // 미디 노트 번호 목록 (chord_example_note 보조 테이블에 매핑)
+    @ElementCollection(fetch = FetchType.LAZY)
+    @CollectionTable(
+            name = "chord_example_note",
+            joinColumns = @JoinColumn(name = "chord_example_id")
+    )
+    @Column(name = "note_number", nullable = false)
+    private List<Integer> noteNumbers;
+
+    // 설명
+    @Column(name = "description", columnDefinition = "TEXT")
+    private String description;
+
+    @Builder(access = AccessLevel.PRIVATE)
+    private ChordExample(LearningStep learningStep, String chordName,
+                         List<Integer> noteNumbers, String description) {
+        this.learningStep = learningStep;
+        this.chordName = chordName;
+        this.noteNumbers = noteNumbers != null ? noteNumbers : new ArrayList<>();
+        this.description = description;
+    }
+
+    public static ChordExample create(LearningStep learningStep, String chordName,
+                                      List<Integer> noteNumbers, String description) {
+        return ChordExample.builder()
+                .learningStep(learningStep)
+                .chordName(chordName)
+                .noteNumbers(noteNumbers)
+                .description(description)
+                .build();
+    }
+
+
+    public void updateChordExample(String chordName, List<Integer> noteNumbers, String description) {
+        this.chordName = chordName;
+        if (noteNumbers != null) {
+            this.noteNumbers.clear();
+            this.noteNumbers.addAll(noteNumbers);
+        }
+        this.description = description;
+    }
+}