refactor: adapter 구현중..

src/README.md

@@ -431,13 +431,51 @@ Boot 기본값이 바뀌어도 wire 계약이 조용히 깨지지 않게 합니
 - **`APP_SECURITY_CORS_ALLOW_CREDENTIALS`** — `true` | `false`.
 - **`APP_SECURITY_CORS_MAX_AGE`** — preflight 캐시 TTL(초).
 
+### 프로파일과 데이터베이스
+
+프로파일마다 데이터스토어가 다르고, 그 차이는 `app-bootstrap/src/main/resources/application-*.yml`
+가 소유합니다.
+
+| 프로파일 | 데이터스토어 | 스키마 소유자 | 외부 인프라 |
+| --- | --- | --- | --- |
+| `local` (기본) | H2 in-memory | Hibernate `ddl-auto: create-drop` | 없음 |
+| `dev` | PostgreSQL | Flyway `db/migration/postgresql` | 필요 |
+| `prod` | PostgreSQL | Flyway `db/migration/postgresql` | 필요 |
+
+`local` 은 `./gradlew :app-bootstrap:bootRun` 의 기본값(`src/.env` 의 `SPRING_PROFILES_ACTIVE=local`)
+이라 Docker 없이 바로 뜹니다. 아래 `APP_DATASOURCE_*` 값은 `local` 에서는 쓰이지 않고
+`application-local.yml` 이 덮어씁니다.
+
+`local` 이 검증하는 것은 wiring·요청/응답·애플리케이션 로직이고, **검증하지 않는 것은 migration 과
+vendor 동작**입니다. H2 에는 migration tree 가 없어 migration 에만 존재하는 테이블(capability schema
+registry, polling-delivery·inbox stream, Spring Integration lock)이 만들어지지 않습니다. 해당
+capability 는 `local` 기본값에서 꺼져 있고, 켜면 테이블 없음으로 실패합니다.
+
+`dev` 를 호스트에서 띄우려면(`SPRING_PROFILES_ACTIVE=dev`) PostgreSQL 이 필요합니다.
+`docker-compose.local.yml` 의 `db` 서비스가 루프백(`127.0.0.1:5433`)에만 게시하며, 이 주소가
+아래 `APP_DATASOURCE_URL` 의 커밋된 기본값입니다. 저장소 루트에서 실행합니다.
+
+```bash
+docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --wait db
+```
+
+컨테이너로 띄우는 `./gradlew bootstrap` 경로는 이 호스트 포트를 쓰지 않습니다. compose 가 app
+컨테이너의 `APP_DATASOURCE_URL` 을 내부 네트워크 주소 `jdbc:postgresql://db:5432/...` 로 덮어씁니다.
+
+`ca-skeleton.persistence.vendor`(`postgresql` | `h2`)가 어느 vendor 구성을 조립할지 고르는 단일
+스위치입니다. 값이 둘 중 하나가 아니면 기동이 실패하고, prod 에서 `h2` 이거나 datasource URL 이
+`jdbc:h2:` 이면 `PersistenceVendorProdSafetyValidator` 가 기동을 거부합니다(env 로 덮어써도 동일).
+
 ### Database (Postgres)
 
-- **`APP_DATASOURCE_URL`** — JDBC URL(예: `jdbc:postgresql://host:5432/dbname`).
+- **`APP_DATASOURCE_URL`** — JDBC URL(예: `jdbc:postgresql://host:5432/dbname`). `dev`·`prod` 에서
+  쓰이며, 커밋된 기본값 `jdbc:postgresql://localhost:5433/ca_skeleton` 은 위 compose `db` 서비스의
+  호스트 주소입니다.
 - **`APP_DATASOURCE_USERNAME`** / **`APP_DATASOURCE_PASSWORD`** — DB 접속 계정.
 - **`APP_DATASOURCE_DRIVER`** — Hibernate dialect 에 맞는 드라이버(예: `org.postgresql.Driver`).
 - **`APP_DATASOURCE_DDL_AUTO`** — `none` | `validate` | `update` | `create` | `create-drop`. **prod
-  는 `validate` 또는 `none`**, local 은 `update` 가 편리합니다.
+  는 `validate` 또는 `none`**(`JpaSchemaSafetyValidator` 가 기동 시 강제). `local` 은 이 값을 쓰지
+  않습니다 — `application-local.yml` 이 `create-drop` 으로 고정합니다.
 - **`APP_DATASOURCE_SHOW_SQL`** — `true` 면 SQL 을 로그로 echo.
 - **`APP_DATASOURCE_FORMAT_SQL`** — SQL pretty-print(`SHOW_SQL=true` 일 때만 의미 있음).
 - **`APP_DATASOURCE_OPEN_IN_VIEW`** — Hibernate OSIV. **prod 에서는 피하세요.**