feat: jpa, messaging, notification, mongo, graphql 어댑터터 리펙토링

docker-compose.local.yml

@@ -5,8 +5,11 @@
 #   docker compose -f docker-compose.yml -f docker-compose.local.yml up
 #
 # Local intent:
-#   - Starts a local PostgreSQL database for integration testing without Testcontainers.
-#   - Wires the app environment to point at the local DB.
+#   - Wires the app environment to point at the shared `db` service, which lives in
+#     docker-compose.infra.yml and starts only for lanes whose Compose profile names it.
+#   - Declares no depends_on: a depends_on aimed at a profiled service makes every lane that does
+#     not enable that profile fail to render at all, and ordering is the runtime-smoke wrapper's
+#     job — it knows which services a lane actually starts.
 #   - Keeps read-only filesystem and memory limits from the base compose.
 #   - Publishes the DB on the loopback interface only, so a host-side run
 #     (`./gradlew :app-bootstrap:bootRun`, IDE) reaches the same database the
@@ -15,10 +18,19 @@
 
 services:
   app:
+    # Optional, because src/.env is operator input and a fresh clone does not have one. Before this
+    # was marked optional, untracking that file made `docker compose config` fail outright on a
+    # clone — the environment override that exists for convenience became a hard prerequisite for
+    # rendering the stack at all. The tracked contract is src/.env.example; copy it.
     env_file:
-      - ./src/.env
+      - path: ./src/.env
+        required: false
     # Wire the app to the local Postgres service on the internal network.
     environment:
+      # Explicit, not inherited. A Compose profile selects services; it says nothing about which
+      # environment the application believes it is in, and the two drifting is how a dev stack ends
+      # up running local's settings.
+      SPRING_PROFILES_ACTIVE: "local"
       TZ: "UTC"
       LANG: "C.UTF-8"
       LC_ALL: "C.UTF-8"
@@ -30,9 +42,6 @@ services:
       APP_DATASOURCE_URL: "jdbc:postgresql://db:5432/${POSTGRES_DB:-ca_skeleton}"
       APP_DATASOURCE_USERNAME: "${APP_DATASOURCE_USERNAME:-ca_skeleton}"
       APP_DATASOURCE_PASSWORD: "${APP_DATASOURCE_PASSWORD:-ca_skeleton}"
-    depends_on:
-      db:
-        condition: service_healthy
     healthcheck:
       test:
         - "CMD"
@@ -46,49 +55,10 @@ services:
       start_period: 20s
       retries: 12
     networks:
-      - caskeleton-local
-
-  db:
-    image: postgres:16-alpine
-    environment:
-      POSTGRES_DB: "${POSTGRES_DB:-ca_skeleton}"
-      POSTGRES_USER: "${APP_DATASOURCE_USERNAME:-ca_skeleton}"
-      POSTGRES_PASSWORD: "${APP_DATASOURCE_PASSWORD:-ca_skeleton}"
-      TZ: "UTC"
-    # Persist data between restarts; remove the volume to start fresh.
-    volumes:
-      - type: volume
-        source: caskeleton-db-data
-        target: /var/lib/postgresql/data
-    # The containerised app reaches this over the internal network and needs no host port. A
-    # host-side run does: src/.env is the dotenv source bootRun reads, and its committed
-    # APP_DATASOURCE_URL is jdbc:postgresql://localhost:5433/ca_skeleton. With the port unpublished
-    # that default named an address nothing in the repository provisioned, so every bootRun died in
-    # the startup migration phase with a connection refusal.
-    #
-    # Bound to 127.0.0.1, never 0.0.0.0: the database is reachable from this machine and from
-    # nowhere else on the network. Host 5433 (not 5432) so a PostgreSQL already installed on the
-    # host keeps its conventional port.
-    ports:
-      - "127.0.0.1:5433:5432"
-    networks:
-      - caskeleton-local
-    healthcheck:
-      test:
-        [
-          "CMD-SHELL",
-          "pg_isready -U ${APP_DATASOURCE_USERNAME:-ca_skeleton} -d ${POSTGRES_DB:-ca_skeleton}",
-        ]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-      start_period: 30s
-    restart: unless-stopped
+      - caskeleton-infra
 
 networks:
-  caskeleton-local:
-    driver: bridge
+  # Defined in docker-compose.infra.yml, where the services that share it live.
+  caskeleton-infra:
+    external: false
 
-volumes:
-  caskeleton-db-data:
-    driver: local