Merge pull request #484 from Finders-Official/chore/gcp-migration-prep-#483

[CHORE] 새 GCP 프로젝트(finders-487717) 마이그레이션 준비 (#483)

Author: IISweetHeartII

.github/workflows/deploy-dev.yml

@@ -51,7 +51,7 @@ jobs:
 
       - name: Load Deploy Config from Terraform
         run: |
-          gcloud storage cp gs://finders-terraform-state/deploy-config.json /tmp/deploy-config.json
+          gcloud storage cp gs://finders-487717-tf-state/deploy-config.json /tmp/deploy-config.json
           echo "GCE_NAME=$(jq -r .gce_name /tmp/deploy-config.json)" >> $GITHUB_ENV
           echo "GCE_ZONE=$(jq -r .gce_zone /tmp/deploy-config.json)" >> $GITHUB_ENV
 

.github/workflows/deploy.yml

@@ -51,7 +51,7 @@ jobs:
 
       - name: Load Deploy Config from Terraform
         run: |
-          gcloud storage cp gs://finders-terraform-state/deploy-config.json /tmp/deploy-config.json
+          gcloud storage cp gs://finders-487717-tf-state/deploy-config.json /tmp/deploy-config.json
           echo "GCE_NAME=$(jq -r .gce_name /tmp/deploy-config.json)" >> $GITHUB_ENV
           echo "GCE_ZONE=$(jq -r .gce_zone /tmp/deploy-config.json)" >> $GITHUB_ENV
 

.github/workflows/terraform.yml

@@ -45,7 +45,7 @@ jobs:
           service_account: ${{ secrets.WIF_SERVICE_ACCOUNT }}
 
       - name: Download Terraform Variables
-        run: gcloud storage cp gs://finders-terraform-state/terraform.tfvars terraform.tfvars
+        run: gcloud storage cp gs://finders-487717-tf-state/terraform.tfvars terraform.tfvars
 
       - name: Terraform Format Check
         id: fmt
@@ -119,4 +119,4 @@ jobs:
         if: github.ref == 'refs/heads/develop' && github.event_name == 'push'
         run: |
           terraform output -raw deploy_config > /tmp/deploy-config.json
-          gcloud storage cp /tmp/deploy-config.json gs://finders-terraform-state/deploy-config.json
+          gcloud storage cp /tmp/deploy-config.json gs://finders-487717-tf-state/deploy-config.json

.gitignore

@@ -111,6 +111,8 @@ sql/local/
 *.tfstate
 *.tfstate.*
 .terraform/
+*.tfplan
+tfplan
 crash.log
 crash.*.log
 *.tfvars

CLAUDE.md

@@ -60,17 +60,17 @@ terraform validate            # 문법 검증
 
 | 항목 | 값 |
 |------|-----|
-| GCP Project ID | `project-37afc2aa-d3d3-4a1a-8cd` |
+| GCP Project ID | `finders-487717` |
 | Region | `asia-northeast3` (Seoul) |
 | VPC | `finders-vpc` (3 subnets, 6 firewall rules) |
-| GCE | `finders-server-v2` (e2-medium, internal IP `10.0.2.2`) |
+| GCE | `finders-server` (e2-medium, internal IP `10.0.2.2`) |
 | Cloud SQL | `finders-db` (MySQL 8.0, private IP `10.68.240.3`) |
-| Databases | `finders` (prod), `finders_dev` (dev) |
-| GCS | `finders-public`, `finders-private` |
+| Databases | `finders_prod` (prod), `finders_dev` (dev) |
+| GCS | `finders-487717-public`, `finders-487717-private` |
 | Cloud Run | `img-resizer` |
 | Artifact Registry | `finders-docker` (API), `finders-image` (resizer) |
 | Secret Manager | `finders-prod-config`, `finders-dev-config` (JSON) |
-| Terraform State | `gs://finders-terraform-state/` |
+| Terraform State | `gs://finders-487717-tf-state/` |
 | Domains | `api.finders.it.kr` (prod), `dev-api.finders.it.kr` (dev) |
 
 ## Architecture

docs/architecture/ERD.md

@@ -176,8 +176,8 @@ CreditRelatedType:PHOTO_RESTORATION,PAYMENT  // credit_history.related_type
 
 | 버킷                | 용도                        | 접근 방식            |
 |-------------------|---------------------------|------------------|
-| `finders-public`  | 공개 이미지 (현상소, 게시글, 프로필 등)  | 직접 URL           |
-| `finders-private` | 비공개 파일 (스캔 사진, 서류, AI 복원) | Signed URL (1시간) |
+| `finders-487717-public`  | 공개 이미지 (현상소, 게시글, 프로필 등)  | 직접 URL           |
+| `finders-487717-private` | 비공개 파일 (스캔 사진, 서류, AI 복원) | Signed URL (1시간) |
 
 ### 경로 규칙
 
@@ -212,10 +212,10 @@ CreditRelatedType:PHOTO_RESTORATION,PAYMENT  // credit_history.related_type
 
 ```java
 // public 버킷: 직접 URL 반환
-"https://storage.googleapis.com/finders-public/profiles/123/abc.jpg"
+"https://storage.googleapis.com/finders-487717-public/profiles/123/abc.jpg"
 
 // private 버킷: Signed URL 반환 (1시간 유효)
-        "https://storage.googleapis.com/finders-private/temp/orders/456/scans/def.jpg?X-Goog-Signature=..."
+        "https://storage.googleapis.com/finders-487717-private/temp/orders/456/scans/def.jpg?X-Goog-Signature=..."
 ```
 
 ---

docs/architecture/INFRASTRUCTURE.md

@@ -39,7 +39,7 @@ develop → main (PR) → prod 환경 자동 배포
     ┌──────────────────────┼──────────────────────────┐
     │  private-app-subnet  │  (10.0.2.0/24)           │
     │                      ▼                          │
-    │              ┌─── GCE finders-server-v2 ───┐    │
+     │              ┌─── GCE finders-server ───┐    │
     │              │   (e2-medium, 10.0.2.2)     │    │
     │              │                             │    │
     │              │   cloudflared ──► Traefik   │    │
@@ -60,7 +60,7 @@ develop → main (PR) → prod 환경 자동 배포
     │  private-db-subnet     │  (10.0.3.0/24)         │
     │                        ▼                        │
     │              Cloud SQL (finders-db)              │
-    │          MySQL 8.0 │ Private IP: 10.68.240.3    │
+     │          MySQL 8.0 │ Private IP: 10.68.240.3    │
     │       ┌─────────────┴─────────────┐             │
     │       │    finders (prod)         │             │
     │       │    finders_dev (dev)      │             │
@@ -69,9 +69,9 @@ develop → main (PR) → prod 환경 자동 배포
 
     ┌─ GCP 관리형 서비스 (VPC 외부) ──────────────────┐
     │                                                  │
-    │  Cloud Storage          Artifact Registry        │
-    │  ├─ finders-public      ├─ finders-docker (API)  │
-    │  └─ finders-private     └─ finders-image (resizer)│
+     │  Cloud Storage          Artifact Registry        │
+     │  ├─ finders-487717-public      ├─ finders-docker (API)  │
+     │  └─ finders-487717-private     └─ finders-image (resizer)│
     │                                                  │
     │  Cloud Run              Secret Manager           │
     │  └─ img-resizer         ├─ finders-prod-config   │
@@ -92,15 +92,15 @@ develop → main (PR) → prod 환경 자동 배포
 
 | 항목 | 값 |
 |------|-----|
-| 프로젝트 | My First Project |
-| 프로젝트 ID | project-37afc2aa-d3d3-4a1a-8cd |
+| 프로젝트 | Finders |
+| 프로젝트 ID | finders-487717 |
 | 리전 | asia-northeast3 (서울) |
 
 ---
 
 ## Terraform Infrastructure (IaC)
 
-인프라를 코드로 관리(IaC)하기 위해 Terraform을 사용합니다. State는 `gs://finders-terraform-state/`에 저장됩니다.
+인프라를 코드로 관리(IaC)하기 위해 Terraform을 사용합니다. State는 `gs://finders-487717-tf-state/`에 저장됩니다.
 
 ### 모듈 구조
 
@@ -124,9 +124,9 @@ infra/
 | 카테고리 | 리소스 |
 |----------|--------|
 | **Networking** | VPC (`finders-vpc`), 3 Subnets, 6 Firewall Rules, Cloud Router, Cloud NAT, Static IP |
-| **Compute** | GCE (`finders-server-v2`) |
-| **Database** | Cloud SQL (`finders-db`), 2 Databases (`finders`, `finders_dev`) |
-| **Storage** | GCS (`finders-public`, `finders-private`) |
+| **Compute** | GCE (`finders-server`) |
+| **Database** | Cloud SQL (`finders-db`), 2 Databases (`finders_prod`, `finders_dev`) |
+| **Storage** | GCS (`finders-487717-public`, `finders-487717-private`) |
 | **Registry** | Artifact Registry (`finders-docker`, `finders-image`) |
 | **Serverless** | Cloud Run (`img-resizer`) |
 | **Security** | Secret Manager (2), WIF Pool + Provider, IAM Bindings |
@@ -168,7 +168,7 @@ GitHub Actions가 GCP에 접근할 때 서비스 계정 키 없이 인증하는
 
 - **Pool**: `finders-pool`
 - **Provider**: `github-provider`
-- **Service Account**: `terraform-ci@project-37afc2aa-d3d3-4a1a-8cd.iam.gserviceaccount.com`
+- **Service Account**: `terraform-ci@finders-487717.iam.gserviceaccount.com`
 - **조건**: `Finders-Official/BE` 리포지토리의 GitHub Actions만 허용
 
 ---
@@ -229,7 +229,7 @@ GCE 인스턴스에 외부 IP가 없으므로, Docker 이미지 pull 등 **Googl
 
 | 항목 | 값 |
 |------|-----|
-| 인스턴스 이름 | `finders-server-v2` |
+| 인스턴스 이름 | `finders-server` |
 | 머신 유형 | e2-medium |
 | vCPU / RAM | 2 vCPU / 4 GB |
 | 부팅 디스크 | Ubuntu 22.04 LTS, 20GB |
@@ -262,10 +262,11 @@ GCE 인스턴스에 외부 IP가 없으므로, Docker 이미지 pull 등 **Googl
 ### SSH 접속 방법
 
 ```bash
-gcloud compute ssh finders-server-v2 \
+gcloud compute ssh finders-server \
   --zone=asia-northeast3-a \
-  --project=project-37afc2aa-d3d3-4a1a-8cd \
-  --tunnel-through-iap
+  --project=finders-487717 \
+  --tunnel-through-iap \
+  -- -L 3307:10.68.240.3:3306
 ```
 
 ---
@@ -336,16 +337,16 @@ Cloud SQL에 공개 IP가 없으므로 IAP 터널을 통해서만 접속 가능
 
 ```bash
 # 1. 터널 열기 (로컬 3307 → Cloud SQL 3306)
-gcloud compute ssh finders-server-v2 \
+gcloud compute ssh finders-server \
   --zone=asia-northeast3-a \
-  --project=project-37afc2aa-d3d3-4a1a-8cd \
+  --project=finders-487717 \
   --tunnel-through-iap \
   -- -L 3307:10.68.240.3:3306
 
 # 2. DB 클라이언트 연결
 Host: localhost
 Port: 3307
-Database: finders_dev (또는 finders)
+Database: finders_dev (또는 finders_prod)
 User: finders
 Password: [Secret Manager 참조]
 ```
@@ -370,8 +371,8 @@ Password: [Secret Manager 참조]
 
 | 버킷 | 용도 | 접근 방식 |
 |------|------|----------|
-| `finders-public` | 공개 이미지 (프로필, 현상소, 게시글) | 직접 URL (`allUsers:objectViewer`) |
-| `finders-private` | 비공개 파일 (스캔 사진, 서류, AI 복원) | Signed URL |
+| `finders-487717-public` | 공개 이미지 (프로필, 현상소, 게시글) | 직접 URL (`allUsers:objectViewer`) |
+| `finders-487717-private` | 비공개 파일 (스캔 사진, 서류, AI 복원) | Signed URL |
 
 ### 공통 설정
 

docs/development/CONVENTIONS.md

@@ -68,7 +68,7 @@ GCS 이미지 저장 필드명 규칙:
 | 레이어 | 필드명 | 저장값 | 예시 |
 |--------|--------|--------|------|
 | **Entity/DB** | `objectPath` | GCS 경로 | `posts/123/abc.jpg` |
-| **Response DTO** | `imageUrl` | 전체 URL | `https://storage.googleapis.com/finders-public/posts/123/abc.jpg` |
+| **Response DTO** | `imageUrl` | 전체 URL | `https://storage.googleapis.com/finders-487717-public/posts/123/abc.jpg` |
 | **Request DTO** | `objectPath` | GCS 경로 (presigned URL 업로드 후) | `temp/456/xyz.jpg` |
 
 ```java

docs/guides/GCS_SETUP.md

@@ -10,8 +10,8 @@
 
 | 버킷 | 용도 | 접근 방식 |
 |------|------|----------|
-| `finders-public` | 공개 이미지 (프로필, 현상소, 게시글) | 직접 URL |
-| `finders-private` | 비공개 파일 (스캔 사진, 서류, AI 복원) | Signed URL |
+| `finders-487717-public` | 공개 이미지 (프로필, 현상소, 게시글) | 직접 URL |
+| `finders-487717-private` | 비공개 파일 (스캔 사진, 서류, AI 복원) | Signed URL |
 
 ---
 
@@ -40,7 +40,7 @@ sudo apt-get update && sudo apt-get install -y google-cloud-cli
 gcloud auth login
 
 # 2. 프로젝트 설정
-gcloud config set project project-37afc2aa-d3d3-4a1a-8cd
+gcloud config set project finders-487717
 
 # 3. ADC 설정 (GCS 접근용) - 가장 중요!
 gcloud auth application-default login
@@ -52,8 +52,8 @@ gcloud auth application-default login
 
 ```bash
 # GCS 버킷 접근 테스트
-gsutil ls gs://finders-public
-gsutil ls gs://finders-private
+gsutil ls gs://finders-487717-public
+gsutil ls gs://finders-487717-private
 ```
 
 ---
@@ -139,10 +139,10 @@ gcloud iam service-accounts add-iam-policy-binding \
 
 ```
 # Public (직접 접근)
-https://storage.googleapis.com/finders-public/profiles/123/abc.jpg
+https://storage.googleapis.com/finders-487717-public/profiles/123/abc.jpg
 
 # Private (Signed URL)
-https://storage.googleapis.com/finders-private/orders/456/scan.jpg?X-Goog-Signature=...
+https://storage.googleapis.com/finders-487717-private/orders/456/scan.jpg?X-Goog-Signature=...
 ```
 
 ---
@@ -152,9 +152,9 @@ https://storage.googleapis.com/finders-private/orders/456/scan.jpg?X-Goog-Signat
 ### 로컬 개발
 - [ ] gcloud CLI 설치 완료
 - [ ] `gcloud auth login` 실행
-- [ ] `gcloud config set project project-37afc2aa-d3d3-4a1a-8cd` 실행
+- [ ] `gcloud config set project finders-487717` 실행
 - [ ] `gcloud auth application-default login` 실행
-- [ ] `gsutil ls gs://finders-public` 접근 확인
+- [ ] `gsutil ls gs://finders-487717-public` 접근 확인
 
 ## StorageService 메서드 사용 방식
 ### 메서드 비교: generate vs get

docs/guides/LOCAL_DEVELOPMENT.md

@@ -18,7 +18,7 @@ gcloud --version
 gcloud auth login
 
 # 프로젝트 설정
-gcloud config set project project-37afc2aa-d3d3-4a1a-8cd
+gcloud config set project finders-487717
 ```
 
 ## 3. 서비스 계정 Impersonation 설정
@@ -84,7 +84,7 @@ http://localhost:8080/swagger-ui.html 접속 → **[TEST] Storage** 섹션
 ## 주의사항
 
 - Impersonation 인증은 **1시간 후 만료**됩니다. 만료 시 3번 단계를 다시 실행하세요.
-- 테스트 시 실제 GCS 버킷(`finders-private`, `finders-public`)에 접근합니다.
+- 테스트 시 실제 GCS 버킷(`finders-487717-private`, `finders-487717-public`)에 접근합니다.
 - 테스트 파일은 `temp/` 경로에 업로드하면 30일 후 자동 삭제됩니다.
 - `[TEST] Storage` API는 **local 프로필에서만** 활성화됩니다.