feat(cli): clusterName 환경별 소스명 매핑 + 운영 소스 3-모드 결정 조회(datasource options/ls) + 검증·문서 · v0.32.0

README.md

@@ -24,6 +24,9 @@ yakcloud dev down     # 정리
 
 ## 매니페스트 매핑 (`yakcloud.yaml`)
 ```yaml
+requires:
+  - { name: appdb, type: postgresql }   # 논리 이름(안정 키). 환경별 실제 소스명은 clusterName 으로 오버레이(→ reference 참고)
+
 workloads:
   - name: web
     build: ./            # 이 디렉터리(Dockerfile)를 CI 가 빌드
@@ -36,4 +39,4 @@ workloads:
 
 ## 다른 스택으로 교체
 `app.py`(+`Dockerfile`)를 원하는 언어/프레임워크로 교체하되 위 3계약 유지.
-소스별 주입 env 전체 목록은 `../reference/DATA-SOURCES.md` 참고.
+소스 바인딩 상세는 `../reference/DATA-SOURCES.md` 참고 — 주입 env 전체 목록뿐 아니라 환경별 실제 소스명 매핑(`requires[].clusterName`, 논리 `name` ↔ 실제 소스명 분리), 환경 오버레이(base + `environments.<env>`, 차이만) 병합, 운영 소스 3모드(shared/remote/local) 결정과 `yakcloud datasource ls`/`datasource options` 조회를 함께 다룬다.