Comment: comment 모듈 추가 및 application, api 작성

.github/ISSUE_TEMPLATE/01. main-issue.yml

@@ -1,6 +1,6 @@
 name: Main Issue
 description: Describe the task list.
-title: "[MAIN] "
+title: "☀️ "
 #labels: []
 #projects: []
 #assignees:
@@ -9,7 +9,7 @@ body:
   - type: markdown
     attributes:
       value: |
-        Thanks for taking the time to fill out this bug report!
+        Thanks for taking the time to fill out this issue!
 #  - type: input
 #    id: contact
 #    attributes:

.github/ISSUE_TEMPLATE/03. bug-report.yml

@@ -0,0 +1,93 @@
+name: Bug Report
+description: Describe the bug you encountered.
+title: "🐞 "
+labels: ["type: bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  - type: dropdown
+    id: bug-type
+    attributes:
+      label: 🐞 Bug Types (Multiple)
+      description: |
+        어떤 종류의 문제인가요?
+
+        - 🐞 오류 (에러, 예외 발생, 논리적 오류 등)
+        - 🏗 컨벤션·리팩터링 (코드 스타일, 아키텍처 등)
+        - ⚡️ 성능 (지연, 과도한 자원, 병목 현상 등)
+        - ✏️ 오타·설명 오류 (문서, 문자열, 주석, 식별자 등)
+        - 🔧 기타 (빌드, 환경변수 등)
+
+        **❗️ 보안 취약점은 pkw19961027@gmail.com으로 메일 부탁드립니다.**
+
+        <br />\* 다중 선택
+      multiple: true
+      options:
+        - 🐞 오류
+        - 🏗 컨벤션·리팩터링
+        - ⚡️ 성능
+        - ✏️ 오타·설명 오류
+        - 🔧 기타
+      default: 0
+    validations:
+      required: true
+  - type: input
+    id: summary
+    attributes:
+      label: <br /> 💬 Summary of the Bug
+      description: 버그를 한 문장 정도로 요약해 주세요.
+      placeholder: ex. 로그인 후 화면이 멈춥니다.
+    validations:
+      required: true
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: <br /> 🔁 오류 재현 (Reproduction Steps)
+      description: 버그를 재현하기 위한 구체적인 단계들을 순서대로 적어 주세요.
+      placeholder: |
+        1. 
+        2. 
+        3. 
+
+    validations:
+      required: false
+  - type: textarea
+    id: logs
+    attributes:
+      label: <br /> 📝 관련 로그 (Logs)
+      description: 에러 메시지나 로그가 있다면 복사해서 붙여 주세요.
+      placeholder: |
+        Error: Cannot read property 'foo' of undefined
+          at …
+      render: console
+    validations:
+      required: false
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: <br /> 🎯 기대 동작 (Expected Behavior)
+      description: 정상적으로 동작했을 때 어떤 결과가 나와야 하는지 설명해 주세요.
+      placeholder: ex. 로그인 후 대시보드 페이지가 보여야 합니다.
+    validations:
+      required: true
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: <br /> 🔍 실제 동작 (Actual Behavior)
+      description: 어떤 동작이 나타나는지 설명해 주세요.
+      placeholder: ex. 로그인 후 버튼이 반응하지 않습니다.
+    validations:
+      required: true
+  - type: textarea
+    id: additional-note
+    attributes:
+      label: <br /> 부연 설명 (Additional Notes)
+      description: 관련 브랜치나 커밋, Active profile, 환경변수 등 기타 참고할 만한 정보가 있으면 적어 주세요.
+      placeholder: Tell us any other details you think will help us fix this!
+      value: |
+        <!-- main 브랜치를 대상으로 하지 않을 경우, 관련 브랜치나 커밋을 명시해 주세요. -->
+        <!-- Active profiles, 테스트용 환경변수(공개 가능한 범위만) 등 필요한 정보를 입력해 주세요. -->
+    validations:
+      required: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,5 +1,3 @@
-# Pull Request
-
 ## Issues
 
 - Resolves #0
@@ -11,12 +9,26 @@
 - 주요 변경 사항에 대한 간단한 설명을 작성해 주세요.
 - 관련 이슈 번호를 포함해 주세요 (예: `#123`).
 
+<br />
+
+## Review Points
+
+<!-- 리뷰어가 중점적으로 확인해야 할 항목을 작성해 주세요. -->
+<!-- (Ex: 구현 로직, API 스펙, 테스트 케이스 등) -->
+
+- 상세한 리뷰를 원하는 영역은 작업 의도와 함께 설명해 주세요.
+
+<br />
+
 ## How Has This Been Tested?
 
 - 변경 사항을 테스트하는 방법에 대해 설명해 주세요.
 - 어떤 환경에서 테스트가 이루어졌는지 명시해 주세요.
 
+<!-- 테스트를 생략하거나 육안으로 실행만 확인했다고 쓸 수도 있습니다. -->
+
+<br />
+
 ## Additional Notes
 
 - 이 PR과 관련된 추가적인 정보가 있다면 여기에 기재해 주세요.
-

build.gradle.kts

@@ -10,9 +10,6 @@ plugins {
 }
 
 allprojects {
-    group = "me.nettee"
-    version = "1.0-SNAPSHOT"
-
     repositories {
         mavenCentral()
     }
@@ -34,7 +31,18 @@ subprojects {
         }
     }
 
+    configurations {
+        compileOnly {
+            extendsFrom(configurations.annotationProcessor.get())
+        }
+        configureEach {
+            exclude(group = "org.springframework.boot", module = "spring-boot-starter-logging")
+        }
+    }
+
     dependencies {
+        // FIXME determine the placement of logging library later
+        implementation("org.springframework.boot:spring-boot-starter-log4j2")
         if(project.name != "common") {
             api(project(":common"))
         }

core/core.settings.gradle.kts

@@ -9,10 +9,14 @@ include(
     ":jpa-core",
     ":exception-handler-core",
     ":cors-api",
-    ":cors-webmvc"
+    ":cors-webmvc",
+    ":snowflake-id-api",
+    ":snowflake-id-hibernate",
 )
 
 project(":jpa-core").projectDir = core["jpa-core"]!!
 project(":exception-handler-core").projectDir = core["exception-handler-core"]!!
 project(":cors-webmvc").projectDir = core["nettee-cors-webmvc"]!!
-project(":cors-api").projectDir = core["nettee-cors-api"]!!
+project(":cors-api").projectDir = core["nettee-cors-api"]!!
+project(":snowflake-id-api").projectDir = core["nettee-snowflake-id-api"]!!
+project(":snowflake-id-hibernate").projectDir = core["nettee-snowflake-id-hibernate"]!!

core/jpa-core/build.gradle.kts

@@ -1,5 +1,6 @@
 dependencies {
-    implementation("org.springframework.boot:spring-boot-starter-data-jpa")
+    api(project(":snowflake-id-hibernate"))
+    api("org.springframework.boot:spring-boot-starter-data-jpa")
 
     // querydsl
     implementation("com.querydsl:querydsl-jpa:${dependencyManagement.importedProperties["querydsl.version"]}:jakarta")

core/jpa-core/src/main/java/nettee/jpa/support/SnowflakeBaseEntity.java

@@ -0,0 +1,16 @@
+package nettee.jpa.support;
+
+import jakarta.persistence.Id;
+import jakarta.persistence.MappedSuperclass;
+import lombok.Getter;
+import nettee.hibenate.annotation.SnowflakeGenerated;
+
+import java.io.Serializable;
+
+@Getter
+@MappedSuperclass
+public abstract class SnowflakeBaseEntity implements Serializable {
+    @Id
+    @SnowflakeGenerated
+    private Long id;
+}

core/jpa-core/src/main/java/nettee/jpa/support/SnowflakeBaseTimeEntity.java

@@ -0,0 +1,21 @@
+package nettee.jpa.support;
+
+import jakarta.persistence.EntityListeners;
+import jakarta.persistence.MappedSuperclass;
+import lombok.Getter;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import java.time.Instant;
+
+@Getter
+@MappedSuperclass
+@EntityListeners(AuditingEntityListener.class)
+public class SnowflakeBaseTimeEntity extends SnowflakeBaseEntity {
+    @CreatedDate
+    private Instant createdAt;
+
+    @LastModifiedDate
+    private Instant updatedAt;
+}

core/snowflake/nettee-snowflake-id-api/build.gradle.kts

@@ -0,0 +1,3 @@
+dependencies {
+    compileOnly("org.springframework.boot:spring-boot-autoconfigure:3.4.3")
+}

core/snowflake/nettee-snowflake-id-api/src/main/java/nettee/snowflake/constants/SnowflakeConstants.java

@@ -0,0 +1,25 @@
+package nettee.snowflake.constants;
+
+public final class SnowflakeConstants {
+    // 한국 시간(KST): 2025-03-26 23:40:00 기준점
+    public static final long NETTEE_EPOCH = 1_743_000_000_000L;
+    public static final String PREFIX = "nettee.persistence.snowflake";
+
+    private SnowflakeConstants() {}
+
+    public static final class SnowflakeDefault {
+        public static final int WORKER_ID_BIT_SIZE = 5;
+        public static final int DATACENTER_ID_BIT_SIZE = 5;
+        public static final int SEQUENCE_BIT_SIZE = 12;
+
+        public static final int WORKER_ID_SHIFT = SEQUENCE_BIT_SIZE;
+        public static final int DATACENTER_ID_SHIFT = SEQUENCE_BIT_SIZE + WORKER_ID_BIT_SIZE;
+        public static final int TIMESTAMP_LEFT_SHIFT = SEQUENCE_BIT_SIZE + WORKER_ID_BIT_SIZE + DATACENTER_ID_BIT_SIZE;
+
+        public static final long SEQUENCE_MASK = ~(-1L << SEQUENCE_BIT_SIZE);
+        public static final long MAX_WORKER_ID = ~(-1L << WORKER_ID_BIT_SIZE);
+        public static final long MAX_DATACENTER_ID = ~(-1L << DATACENTER_ID_BIT_SIZE);
+
+        private SnowflakeDefault() {}
+    }
+}

core/snowflake/nettee-snowflake-id-api/src/main/java/nettee/snowflake/exception/InvalidDatacenterIdException.java

@@ -0,0 +1,18 @@
+package nettee.snowflake.exception;
+
+import static nettee.snowflake.constants.SnowflakeConstants.SnowflakeDefault.MAX_DATACENTER_ID;
+
+public class InvalidDatacenterIdException extends RuntimeException {
+
+    private final long datacenterId;
+
+    public InvalidDatacenterIdException(long datacenterId) {
+        super("Datacenter ID can't be greater than %d or less than 0. Input: %d"
+                .formatted(MAX_DATACENTER_ID, datacenterId));
+        this.datacenterId = datacenterId;
+    }
+
+    public long getDatacenterId() {
+        return datacenterId;
+    }
+}

core/snowflake/nettee-snowflake-id-api/src/main/java/nettee/snowflake/exception/InvalidWorkerIdException.java

@@ -0,0 +1,18 @@
+package nettee.snowflake.exception;
+
+import static nettee.snowflake.constants.SnowflakeConstants.SnowflakeDefault.MAX_WORKER_ID;
+
+public class InvalidWorkerIdException extends RuntimeException{
+
+    private final long workerId;
+
+    public InvalidWorkerIdException(final long workerId) {
+        super("Worker ID can't be greater than %d or less than 0. Input: %d"
+                .formatted(MAX_WORKER_ID, workerId));
+        this.workerId = workerId;
+    }
+
+    public long getWorkerId() {
+        return workerId;
+    }
+}

core/snowflake/nettee-snowflake-id-api/src/main/java/nettee/snowflake/persistence/id/Snowflake.java

@@ -0,0 +1,66 @@
+package nettee.snowflake.persistence.id;
+
+import nettee.snowflake.properties.SnowflakeProperties;
+import nettee.snowflake.validator.SnowflakeConstructingValidator;
+
+import static nettee.snowflake.constants.SnowflakeConstants.NETTEE_EPOCH;
+import static nettee.snowflake.constants.SnowflakeConstants.SnowflakeDefault.*;
+
+public class Snowflake {
+    private final long datacenterId;
+    private final long workerId;
+    private final long epoch;
+
+    private long sequence = 0L;
+    private long lastTimestamp = -1L;
+
+    public Snowflake(SnowflakeProperties properties) {
+        this(properties.datacenterId(), properties.workerId(), properties.epoch());
+    }
+
+    public Snowflake(long datacenterId, long workerId, long epoch) {
+        SnowflakeConstructingValidator.validateDatacenterId(datacenterId);
+        SnowflakeConstructingValidator.validateWorkerId(workerId);
+
+        this.workerId = workerId;
+        this.datacenterId = datacenterId;
+        this.epoch = epoch >= 0 ? epoch : NETTEE_EPOCH;
+    }
+
+    public synchronized long nextId() {
+        long timestamp = timeGen();
+
+        if (timestamp < lastTimestamp) {
+            throw new RuntimeException(String.format(
+                    "Clock moved backwards. Refusing to generate id for %d milliseconds", lastTimestamp - timestamp
+            ));
+        }
+
+        if (lastTimestamp == timestamp) {
+            sequence = (sequence + 1) & SEQUENCE_MASK;
+            if (sequence == 0) {
+                timestamp = tilNextMillis(lastTimestamp);
+            }
+        } else {
+            sequence = 0L;
+        }
+
+        lastTimestamp = timestamp;
+        return ((timestamp - epoch) << TIMESTAMP_LEFT_SHIFT) |
+                (datacenterId << DATACENTER_ID_SHIFT) |
+                (workerId << WORKER_ID_SHIFT) |
+                sequence;
+    }
+
+    private long tilNextMillis(long lastTimestamp) {
+        long timestamp = timeGen();
+        while (timestamp <= lastTimestamp) {
+            timestamp = timeGen();
+        }
+        return timestamp;
+    }
+
+    private long timeGen() {
+        return System.currentTimeMillis();
+    }
+}