Refactor: 문서 목록 CQRS Read Model 전환 및 Domain Event Outbox 추가

build.gradle

@@ -25,7 +25,8 @@ repositories {
 
 test {
     testLogging {
-        events "passed", "skipped", "failed", "standardOut", "standardError"
+        events "skipped", "failed"
+        showStandardStreams = false
         exceptionFormat "full"
         showCauses true
         showExceptions true

infra/docker-compose.local.yml

@@ -0,0 +1,116 @@
+name: docsa-local
+
+services:
+  mysql:
+    image: mysql:9.4.0
+    container_name: docsa-mysql-local
+    restart: unless-stopped
+    environment:
+      MYSQL_DATABASE: ${LOCAL_MYSQL_DATABASE:-docsa}
+      MYSQL_USER: ${LOCAL_MYSQL_USER:-docsa}
+      MYSQL_PASSWORD: ${LOCAL_MYSQL_PASSWORD:-docsa}
+      MYSQL_ROOT_PASSWORD: ${LOCAL_MYSQL_ROOT_PASSWORD:-root}
+      TZ: Asia/Seoul
+    ports:
+      - "${LOCAL_MYSQL_PORT:-3306}:3306"
+    volumes:
+      - local_mysql_data:/var/lib/mysql
+      - ./mysql/my.cnf:/etc/mysql/conf.d/my.cnf:ro
+    healthcheck:
+      test: ["CMD-SHELL", "mysqladmin ping -h 127.0.0.1 -u$${MYSQL_USER} -p$${MYSQL_PASSWORD}"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+      start_period: 20s
+    networks:
+      - docsa_local_net
+
+  mongo:
+    image: mongo:8.0
+    container_name: docsa-mongo-local
+    restart: unless-stopped
+    command: ["mongod", "--replSet", "rs0", "--bind_ip_all"]
+    ports:
+      - "${LOCAL_MONGO_PORT:-27017}:27017"
+    volumes:
+      - local_mongo_data:/data/db
+    healthcheck:
+      test:
+        [
+          "CMD-SHELL",
+          "mongosh --quiet --eval 'try { rs.status().ok } catch (e) { rs.initiate({_id:\"rs0\",members:[{_id:0,host:\"localhost:27017\"}]}); 1 }' | grep 1"
+        ]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+      start_period: 10s
+    networks:
+      - docsa_local_net
+
+  mailpit:
+    image: axllent/mailpit:latest
+    container_name: docsa-mailpit-local
+    restart: unless-stopped
+    environment:
+      MP_SMTP_AUTH_ACCEPT_ANY: "1"
+      MP_SMTP_AUTH_ALLOW_INSECURE: "1"
+      MP_DATABASE: /data/mailpit.db
+      MP_MAX_MESSAGES: "5000"
+    ports:
+      - "${LOCAL_MAILPIT_SMTP_PORT:-1025}:1025"
+      - "${LOCAL_MAILPIT_WEB_PORT:-8025}:8025"
+    volumes:
+      - local_mailpit_data:/data
+    healthcheck:
+      test: ["CMD-SHELL", "wget -q --spider http://127.0.0.1:8025/readyz || exit 1"]
+      interval: 10s
+      timeout: 3s
+      retries: 5
+      start_period: 10s
+    networks:
+      - docsa_local_net
+
+  minio:
+    image: minio/minio:latest
+    container_name: docsa-minio-local
+    restart: unless-stopped
+    command: ["server", "/data", "--console-address", ":9001"]
+    environment:
+      MINIO_ROOT_USER: ${LOCAL_MINIO_ROOT_USER:-docsa-local}
+      MINIO_ROOT_PASSWORD: ${LOCAL_MINIO_ROOT_PASSWORD:-docsa-local-password}
+      MINIO_API_CORS_ALLOW_ORIGIN: ${LOCAL_MINIO_CORS_ALLOW_ORIGIN:-http://localhost:3000,http://localhost:5173}
+      TZ: Asia/Seoul
+    ports:
+      - "${LOCAL_MINIO_API_PORT:-9000}:9000"
+      - "${LOCAL_MINIO_CONSOLE_PORT:-9001}:9001"
+    volumes:
+      - local_minio_data:/data
+    networks:
+      - docsa_local_net
+
+  minio-init:
+    image: minio/mc:latest
+    container_name: docsa-minio-init-local
+    depends_on:
+      - minio
+    environment:
+      LOCAL_MINIO_ROOT_USER: ${LOCAL_MINIO_ROOT_USER:-docsa-local}
+      LOCAL_MINIO_ROOT_PASSWORD: ${LOCAL_MINIO_ROOT_PASSWORD:-docsa-local-password}
+      LOCAL_MINIO_BUCKET: ${LOCAL_MINIO_BUCKET:-docsa-local}
+    entrypoint: >
+      /bin/sh -c "
+      until mc alias set local http://minio:9000 ${LOCAL_MINIO_ROOT_USER:-docsa-local} ${LOCAL_MINIO_ROOT_PASSWORD:-docsa-local-password}; do sleep 2; done;
+      mc mb --ignore-existing local/${LOCAL_MINIO_BUCKET:-docsa-local};
+      mc anonymous set download local/${LOCAL_MINIO_BUCKET:-docsa-local};
+      "
+    networks:
+      - docsa_local_net
+
+volumes:
+  local_mysql_data:
+  local_mongo_data:
+  local_mailpit_data:
+  local_minio_data:
+
+networks:
+  docsa_local_net:

infra/docker-compose.stg.yml

@@ -6,17 +6,6 @@ services:
     container_name: docsa-app-stg
     restart: unless-stopped
     env_file: .stg.env
-    environment:
-      SPRING_DATA_MONGODB_URI: ${SPRING_DATA_MONGODB_URI}
-      SPRING_MAIL_USERNAME: ${SPRING_MAIL_USERNAME}
-      #SPRING_MAIL_PASSWORD: ${SPRING_MAIL_PASSWORD}
-      SPRING_DATASOURCE_URL: ${SPRING_DATASOURCE_URL}
-      SPRING_DATASOURCE_USERNAME: ${SPRING_DATASOURCE_USERNAME}
-      SPRING_DATASOURCE_PASSWORD: ${SPRING_DATASOURCE_PASSWORD}
-      SERVER_SERVLET_SESSION_COOKIE_NAME: ${SESSION_COOKIE_NAME}
-      SERVER_SERVLET_SESSION_COOKIE_DOMAIN: ${SESSION_COOKIE_DOMAIN}
-      SPRINGDOC_SWAGGER-UI_SERVERS_URL: ${SWAGGER_SERVER_URL}
-      SPRING_JPA_HIBERNATE_DDL_AUTO: ${DDL_AUTO}
     depends_on:
        mysql:
           condition: service_healthy

infra/docker-compose.yml

@@ -6,16 +6,6 @@ services:
     container_name: docsa-app
     restart: unless-stopped
     env_file: .env
-    environment:
-      SPRING_DATA_MONGODB_URI: ${SPRING_DATA_MONGODB_URI}
-      SPRING_MAIL_USERNAME: ${SPRING_MAIL_USERNAME}
-      SPRING_MAIL_PASSWORD: ${SPRING_MAIL_PASSWORD}
-      SPRING_DATASOURCE_URL: ${SPRING_DATASOURCE_URL}
-      SPRING_DATASOURCE_USERNAME: ${SPRING_DATASOURCE_USERNAME}
-      SPRING_DATASOURCE_PASSWORD: ${SPRING_DATASOURCE_PASSWORD}
-      SERVER_SERVLET_SESSION_COOKIE_NAME: ${SESSION_COOKIE_NAME}
-      SERVER_SERVLET_SESSION_COOKIE_DOMAIN: ${SESSION_COOKIE_DOMAIN}
-      SPRINGDOC_SWAGGER-UI_SERVERS_URL: ${SWAGGER_SERVER_URL}
     depends_on:
       mysql:
         condition: service_healthy

infra/scripts/backfill-doc-list-docker.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+
+COMPOSE_FILE="${BACKFILL_COMPOSE_FILE:-"$ROOT_DIR/infra/docker-compose.stg.yml"}"
+SERVICE="${BACKFILL_SERVICE:-app}"
+PROFILES="${BACKFILL_PROFILES:-stg,backfill}"
+BATCH_SIZE="${DOC_LIST_READ_MODEL_BACKFILL_BATCH_SIZE:-1000}"
+DDL_AUTO="${BACKFILL_DDL_AUTO:-validate}"
+
+echo "[backfill] composeFile=$COMPOSE_FILE service=$SERVICE profiles=$PROFILES batchSize=$BATCH_SIZE ddlAuto=$DDL_AUTO"
+
+docker compose -f "$COMPOSE_FILE" run --rm \
+  -e SPRING_PROFILES_ACTIVE="$PROFILES" \
+  -e SPRING_JPA_HIBERNATE_DDL_AUTO="$DDL_AUTO" \
+  -e DDL_AUTO="$DDL_AUTO" \
+  -e DOC_LIST_READ_MODEL_BACKFILL_BATCH_SIZE="$BATCH_SIZE" \
+  -e MONGO_LOCAL_CLEANUP_ENABLED=false \
+  -e PERF_SEED_USER_COUNT=0 \
+  "$SERVICE"

infra/scripts/cert_renew.sh

@@ -11,19 +11,21 @@ ENV_FILE="$ROOT/docsa-alert.env"
 notify_slack () {
   local msg="$1"
   [[ -z "${SLACK_WEBHOOK_URL:-}" ]] && return 0
+
+  local payload
+  payload="$(python3 -c 'import json, sys; print(json.dumps({"text": sys.argv[1]}))' "$msg")"
+
   curl -sS -X POST -H 'Content-type: application/json' \
-    --data "{\"text\":${msg@Q}}" \
+    --data "$payload" \
     "$SLACK_WEBHOOK_URL" >/dev/null 2>&1 || true
 }
 
 # ---- 1) certbot renew 실행 ----
 out="$(
   docker compose run --rm --no-deps certbot_renew \
-    certbot renew --webroot -w /var/www/certbot 2>&1 || true
+    renew --webroot -w /var/www/certbot 2>&1 || true
 )"
 
-echo "$out"
-
 # ---- 2) 실패 감지 ----
 # certbot이 실패할 때 자주 나오는 문구 위주로 (오탐 줄임)
 if echo "$out" | grep -Eqi \

perf/cleanup_perf_docs.sh

@@ -61,7 +61,7 @@ login_cookie() {
   cookie="$(
     grep -i '^set-cookie:' "${headers}" \
       | tr -d '\r' \
-      | sed -n "s/^set-cookie:[[:space:]]*${SESSION_COOKIE_NAME}=\\([^;]*\\).*/\\1/p" \
+      | sed -n "s/^[Ss][Ee][Tt]-[Cc][Oo][Oo][Kk][Ii][Ee]:[[:space:]]*${SESSION_COOKIE_NAME}=\\([^;]*\\).*/\\1/p" \
       | head -n 1
   )"
   rm -f "${headers}" "${body}"

src/main/java/io/ejangs/docsa/DocsaApplication.java

@@ -4,7 +4,6 @@
 import io.swagger.v3.oas.annotations.info.Info;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.scheduling.annotation.EnableAsync;
 import org.springframework.scheduling.annotation.EnableScheduling;
 
 @OpenAPIDefinition(
@@ -14,7 +13,6 @@
                 description = "Docsa의 백엔드 API 명세입니다."
         )
 )
-@EnableAsync
 @EnableScheduling
 @SpringBootApplication
 public class DocsaApplication {

src/main/java/io/ejangs/docsa/domain/branch/app/BranchQueryService.java → src/main/java/io/ejangs/docsa/domain/branch/app/BranchReader.java

@@ -4,18 +4,16 @@
 import io.ejangs.docsa.domain.branch.entity.Branch;
 import io.ejangs.docsa.domain.commit.entity.Commit;
 import io.ejangs.docsa.domain.edge.dto.graph.BranchGraphDto;
-import io.ejangs.docsa.domain.doc.entity.Doc;
 import io.ejangs.docsa.global.exception.CustomException;
 import io.ejangs.docsa.global.exception.errorcode.BranchErrorCode;
-import io.ejangs.docsa.global.util.RenewUpdatedAtHelper;
 import java.util.List;
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
 @Service
 @RequiredArgsConstructor
-public class BranchQueryService {
+public class BranchReader {
 
     private final BranchRepository branchRepository;
 
@@ -29,31 +27,11 @@ public List<BranchGraphDto> getBranchGraphList(Long docId) {
         return branchRepository.findBranchGraphDtoList(docId);
     }
 
-    public Branch save(Branch branch) {
-        return branchRepository.save(branch);
-    }
-
-    public Branch createBranch(Doc doc, String branchName) {
-        Branch branch = branchRepository.save(Branch.builder().name(branchName).doc(doc).build());
-        RenewUpdatedAtHelper.touch(branch);
-        return branch;
-    }
-
-    public Branch createBranch(Doc doc, String branchName, Commit fromCommit) {
-        Branch branch = Branch.builder().name(branchName).doc(doc).fromCommit(fromCommit).build();
-        return branchRepository.save(branch);
-    }
-
     @Transactional(readOnly = true)
     public boolean existsSubBranchByFromCommitIds(List<Long> commitIds) {
         return branchRepository.existsByFromCommitIdIn(commitIds);
     }
 
-    public void delete(Branch branch) {
-        branchRepository.delete(branch);
-    }
-
-    //TODO: 검증하는 메소드는 별도의 ex.ValidationService로 분리(모든 도메인)
     public void checkBranchInDocOwnedByUser(Long documentId, Long branchId, Long userId) {
         boolean exists =
                 branchRepository.existsByIdAndDocIdAndDocUserId(branchId, documentId, userId);