Add platform infrastructure configuration

infrastructure/controllers/keycloak-operator/README.md

@@ -0,0 +1,35 @@
+# Keycloak Operator
+
+상태: `26.7.0` 실제 적용, Operator와 Keycloak Server 각각 `1/1` Ready  
+namespace는 `baseline` enforce·`restricted` warn이다. 공식 Operator 적용 시
+restricted 필드 경고가 있었지만 baseline 정책에서 rollout은 성공했으므로 이를
+restricted 준수 완료로 표현하지 않는다.
+
+이 디렉터리는 Keycloak Operator의 유일한 Kustomize 빌드 루트다. 공식 Keycloak
+Kubernetes 리소스를 직접 참조하며 업스트림 매니페스트를 복제하거나 수정하지
+않는다.
+
+## 고정된 원본
+
+- 저장소: <https://github.com/keycloak/keycloak-k8s-resources>
+- 리소스 경로: `kubernetes`
+- Keycloak 및 Operator 버전: `26.7.0`
+- 설치 모드: `keycloak` namespace 범위
+
+업스트림 namespace 범위 Deployment는 각 컨트롤러의 감시 namespace를
+`JOSDK_WATCH_CURRENT`로 설정한다. 이 단일 인스턴스 홈 클러스터에서는 프리뷰
+상태인 `cluster-wide` Overlay로 전환하지 않는다.
+
+이 디렉터리에서 다음과 같이 렌더링한다.
+
+```bash
+kubectl kustomize infrastructure/controllers/keycloak-operator
+```
+
+remote 참조가 Kustomize 캐시에 없으면 네트워크 접근이 필요하다. Argo CD가 고정된
+GitHub 원본을 가져올 수 있어야 한다.
+
+## 공식 참고 문서
+
+- <https://www.keycloak.org/operator/installation>
+- <https://github.com/keycloak/keycloak-k8s-resources/tree/26.7.0/kubernetes>