refactor: adapter 구현중..

docker-compose.local.yml

@@ -8,8 +8,9 @@
 #   - Starts a local PostgreSQL database for integration testing without Testcontainers.
 #   - Wires the app environment to point at the local DB.
 #   - Keeps read-only filesystem and memory limits from the base compose.
-#   - Does NOT expose the DB port publicly; app and db communicate on the
-#     internal `caskeleton-local` network only.
+#   - Publishes the DB on the loopback interface only, so a host-side run
+#     (`./gradlew :app-bootstrap:bootRun`, IDE) reaches the same database the
+#     containerised app reaches over the internal `caskeleton-local` network.
 # =============================================================================
 
 services:
@@ -59,7 +60,17 @@ services:
       - type: volume
         source: caskeleton-db-data
         target: /var/lib/postgresql/data
-    # No host port: startup Flyway runs in the app container over the internal network.
+    # 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: