Scale Check — 7가지 포인트 프로덕션 준비 감사
당신은 읽기 전용 plan 모드로 /scale-check를 실행 중입니다. 당신의 작업은 아래 7가지 확장 질문에 대해 코드베이스를 검사하고, 명확하고 우선순위가 지정된 검증 및 수정 계획을 사용자 화면에 표시하는 것입니다.
대상 범위: $ARGUMENTS (비어 있으면 전체 저장소를 감사합니다).
철칙 (스캔 전 읽기)
- 보고, 변경하지 마십시오: 당신은 엄격하게 진단 및 계획 모드에 있습니다. 파일을 생성, 편집 또는 삭제하지 마십시오. 데이터베이스 마이그레이션, 상태 변경 명령 또는 네트워크 요청을 실행하지 마십시오.
- 발견 사항은 확인해야 할 단서이지, 사실이 아닙니다: 정적 저장소 분석은 외부 클라우드 대시보드, CDN 규칙, WAF 정책 또는 관리형 데이터베이스 설정을 볼 수 없습니다. 발견한 모든 문제를 확인해야 할 단서로 간주하고, 절대 보장된 버그로 간주하지 마십시오.
- 항상 정확한 위치를 인용하십시오: 모든 코드 단서에는
path/to/file:line및 관련된 특정 심볼 또는 쿼리가 포함되어야 합니다. 코드베이스에서 무언가가 누락된 경우, 명시적으로 보고하십시오: "저장소에서 찾을 수 없음 — 호스팅/클라우드 제공업체에서 확인하십시오." - 한 번에 하나씩 수정하고, 생존부터 시작하십시오: 최종 수정 계획은 항상 백업 (질문 5) 및 속도 제한 (질문 7) 부터 시작하고, 그 다음 공유 캐시를 통한 개인 데이터 유출 (질문 6), 그런 다음 일반적으로 성장하는 앱에 영향을 미치는 순서대로 남은 질문(루프 내 인덱스 및 쿼리 (Q1), 공유 읽기 (Q2), 두 개의 복사본으로 실행 (Q3), 요청 내 느린 작업 (Q4), 공개 자산 캐싱 (Q6의 나머지))을 정리하십시오.
실행 워크플로우
1단계: 스택 식별 (빠른 패스)
7가지 질문을 확인하기 전에, 프로젝트의 스택을 신속하게 식별하여 올바른 위치를 살펴보십시오:
- 매니페스트 및 프레임워크:
package.json,pyproject.toml,requirements.txt,go.mod,Cargo.toml또는Gemfile을 확인하십시오. - 데이터베이스 및 ORM:
schema.prisma, Drizzle 스키마 파일, TypeORM/Sequelize 모델, SQLAlchemy/Alembic 파일, Djangomodels.py또는 원시.sql마이그레이션 파일을 찾으십시오. - 진입점 및 라우트: API 라우트(
app/api/,pages/api/,src/routes/,controllers/,routers/,main.py,cmd/)를 찾으십시오. - 인프라 및 구성:
Dockerfile,docker-compose.yml,vercel.json,next.config.*,fly.toml,render.yaml,nginx.conf,.github/workflows/및README.md를 확인하십시오.
2단계: 7가지 질문 모두 조사
아래 7가지 질문 각각에 대해 대상 Glob, Grep 및 Read 패스를 실행하십시오. 어떤 질문도 건너뛰지 마십시오.
7가지 질문
질문 1: 루프 내 인덱스 및 쿼리
- 카드 약식: "데이터를 검색하거나 나열하는 페이지: 열에 인덱스가 있고, 루프 내에 쿼리가 있습니까?"
- 전체 진단 질문: 애플리케이션이 레코드를 나열, 필터링, 정렬 또는 검색하는 위치, 기본 데이터베이스 열(
WHERE,JOIN,ORDER BY, 외래 키)이 스키마에서 인덱스로 지원되는지 여부, 그리고 엔드포인트가 루프 내에서 데이터베이스 또는 API 쿼리를 실행(N+1 문제)하거나 페이지네이션 없이 바인딩되지 않은 행을 가져오는지 여부는 무엇입니까? - 찾는 위치 및 방법:
- 스키마 대 쿼리: 목록/검색 쿼리(
findMany,select,filter,WHERE,ILIKE,ORDER BY)를 인덱스 정의(@@index,index(),CREATE INDEX,db_index=True)와 비교하십시오. Prisma/SQLAlchemy는 명시적으로 선언되지 않는 한 외래 키나 정렬 열을 자동으로 인덱싱하지 않는 경우가 많습니다. - I/O가 포함된 루프: 라우트 핸들러와 서비스 함수에서
for (,for await,.map(async,forEach(async또는 반복 본문 내에서db.,prisma.,supabase.,session.execute또는fetch(를 호출하는 리스트 컴프리헨션을 Grep하십시오. - 바인딩되지 않은 읽기: 목록 엔드포인트가
take/limit상한을 적용하는지 또는 단일 요청이 전체 테이블을 메모리에 로드할 수 있는지 확인하십시오.
- 스키마 대 쿼리: 목록/검색 쿼리(
- 저장소 외부에 있을 수 있는 것 (오탐지 확인):
- 마이그레이션 파일에 커밋되지 않고 프로덕션 SQL 콘솔에서 수동으로 인덱스가 생성되었을 수 있습니다.
- 작은 조회 테이블(예: <50개의 정적 역할 또는 카테고리)은 누락된 인덱스에서 병목 현상이 발생하지 않지만, 사용자 생성 데이터에 대한 N+1 루프는 병목 현상이 발생합니다.
질문 2: 반복되는 공유 읽기
- 카드 약식: "자주 실행되고 모든 사람에게 동일한 결과를 반환하는 읽기 쿼리."
- 전체 진단 질문: 트래픽이 많은 읽기 쿼리 중 방문자마다 모든 요청에 대해 정확히 동일한 공개 데이터를 계산하거나 가져오는 쿼리(예: 랜딩 페이지 피드, 제품 카탈로그, 전역 구성, 리더보드 또는 공개 카운트)가 메모리, Redis/KV 또는 프레임워크의 데이터 캐시에 결과를 캐싱하지 않고 있습니까?
- 찾는 위치 및 방법:
- 사용자별 매개변수(
userId,sessionId,orgId) 없이 모든 페이지 로드 시 기본 데이터베이스에 접근하는 공개 라우트, 홈페이지, 레이아웃 로더 및 전역 미들웨어를 검사하십시오. - 공개 엔드포인트에서 실시간으로 실행되는 값비싼 집계(
COUNT(*),SUM(), 다중 테이블 조인)를 확인하십시오. - 기존 캐시 프리미티브(
unstable_cache,'use cache',revalidate, Redisget/set,@lru_cache,Cache-Control: s-maxage)를 찾아 공유 읽기가 이미 래핑되었는지 확인하십시오.
- 사용자별 매개변수(
- 저장소 외부에 있을 수 있는 것 (오탐지 확인):
- 업스트림 CDN(Cloudflare, CloudFront, Fastly)이 대시보드 페이지 규칙을 통해 에지에서 전체 공개 라우트를 이미 캐싱하고 있을 수 있습니다.
질문 3: 두 개의 복사본으로 실행 (무상태성 및 로컬 스토리지)
- 카드 약식: "앱이 두 개의 복사본으로 실행될 수 있으며, 하나의 서버 메모리 또는 디스크에 무엇이 저장되어 있습니까?"
- 전체 진단 질문: 트래픽이 급증하여 로드 밸런서 뒤에 두 번째 서버 인스턴스를 시작하거나(또는 자동 확장 서버리스 인스턴스에 배포) 단일 프로세스의 RAM에 상태가 저장되거나 단일 컨테이너의 로컬 파일 시스템에 기록되어 중단되는 것은 무엇입니까?
- 찾는 위치 및 방법:
- 프로세스 내 메모리 상태: 모듈 수준의
new Map(),new Set(), 전역 가변 배열/객체, 인메모리 세션 저장소(MemoryStore), 로컬 속도 제한 카운터 또는 모든 사용자가 동일한 Node/Python/Go 프로세스를 사용한다고 가정하는 프로세스 내 pub/sub(EventEmitter, 브리징되지 않은 WebSocketSet)을 Grep하십시오. - 로컬 디스크 종속성: 로컬 파일 쓰기(
fs.writeFile,fs.createWriteStream,open(..., 'w'),multer.diskStorage,/tmp또는./uploads저장소) 및 가변 런타임 데이터에 사용되는 로컬 임베디드 데이터베이스(sqlite,better-sqlite3,.db파일)를 Grep하십시오. - 프로세스 내 Cron 작업: 메인 웹 서버 진입점 내에서 부팅된
node-cron,setInterval또는APScheduler를 확인하십시오. 이는 두 인스턴스가 동시에 실행되면 중복 작업을 실행할 수 있습니다.
- 프로세스 내 메모리 상태: 모듈 수준의
- 저장소 외부에 있을 수 있는 것 (오탐지 확인):
- 엄격히 읽기 전용 캐시로 TTL과 함께 사용되는 모듈 수준
Map(또는 Prisma/Stripe와 같은 지연 싱글톤 SDK 클라이언트)은 여러 인스턴스에서 안전합니다. - 마운트된 영구 볼륨과 고정 세션을 사용하는 단일 VPS 앱은 의도적으로 단일 노드로 실행될 수 있습니다. 트레이드오프를 명확히 표시하고, 고장났다고 말하지 마십시오.
- 엄격히 읽기 전용 캐시로 TTL과 함께 사용되는 모듈 수준
질문 4: 웹 요청 내 느린 동기식 작업
- 카드 약식: "웹 요청이 AI 호출, 이메일 또는 파일과 같은 느린 작업을 수행하는 부분."
- 전체 진단 질문: HTTP 요청이 응답을 반환하기 전에 느리거나 예측 불가능하거나 무거운 작업(예: LLM/AI 생성 호출, 트랜잭션 이메일 전송, PDF 생성, 이미지/비디오 크기 조정, 대규모 CSV 구문 분석 또는 여러 타사 웹훅 체이닝)을 기다리는 동안 사용자 연결을 열어 두는 위치는 어디입니까?
- 찾는 위치 및 방법:
POST/PUT컨트롤러, 서버 액션 및 웹훅 핸들러를 요청 시작부터 응답 반환까지 추적하십시오.- AI SDK(
openai,@anthropic-ai,@google/genai,ai), 이메일 제공업체(resend,nodemailer,sendgrid,postmark), 미디어/파일 프로세서(sharp,ffmpeg,puppeteer,pdfkit) 또는 외부 API에 대한 중요한 요청 경로 내의await호출을 차단하는지 Grep하십시오. - 프로젝트에 백그라운드 큐 또는 비동기 워커 설정(
bullmq,inngest,trigger.dev,celery,sidekiq,waitUntil)이 있는지, 그리고 느린 호출이 실제로 이를 사용하는지 또는 우회하는지 확인하십시오.
- 저장소 외부에 있을 수 있는 것 (오탐지 확인):
- 스트리밍 AI 엔드포인트(
streamText, SSE, 청크 분할 응답)는 클라이언트에 토큰을 스트리밍하는 동안 열려 있도록 설계되었습니다. 무거운 동기식 전/후처리를 수행하거나 시간 제한 경계가 없는 경우에만 플래그를 지정하십시오.
- 스트리밍 AI 엔드포인트(
질문 5: 백업, 복제본 및 복원 경로
- 카드 약식: "어떤 백업 또는 복제본이 존재하는지, 어디에, 얼마나 자주, 그리고 복원 방법. 저장소에 없으면 그렇게 말하십시오."
- 전체 진단 질문: 어떤 자동화된 데이터베이스 및 스토리지 백업 또는 복제본이 존재하며, 어디에 저장되어 있고, 얼마나 자주 실행되며, 이를 복원하는 문서화되고 테스트된 절차가 있습니까? 백업 구성이 저장소에 표시되지 않으면 명시적으로 명시하십시오.
- 찾는 위치 및 방법:
pg_dump,mysqldump,sqlite3 .backup,wal-g,litestream, S3 백업 동기화 또는 복제본 구성을 위해 인프라 파일(docker-compose.yml, Terraform.tf, Pulumi, CloudFormation,fly.toml,.github/workflows/,scripts/,Makefile,crontab)을 검색하십시오.- 백업 일정, 특정 시점 복구(PITR) 또는 복원 명령에 대한 언급이 있는지
README.md,CONTRIBUTING.md,docs/또는runbooks/를 검색하십시오.
- 질문 5에 대한 필수 규칙:
- 관리형 데이터베이스(Supabase, Neon, RDS, PlanetScale, Railway, MongoDB Atlas)를 사용하는 대부분의 최신 앱에서 백업 설정은 클라우드 대시보드에 있으며, git에 없습니다.
- 저장소에서 백업 구성 및 복원 지침을 찾지 못하면 다음과 같이 명확하게 말하십시오: "저장소에서 백업 구성 또는 복원 런북을 찾을 수 없습니다. 데이터베이스 제공업체의 대시보드에서 자동 백업/PITR이 활성화되어 있는지 확인하고, 보존 빈도를 확인한 후 스테이징 데이터베이스에 대한 테스트 복원을 실행하십시오."
질문 6: 공개 자산 대 개인 데이터 캐싱
- 카드 약식: "모든 사용자에게 동일한 파일과 절대 캐시되어서는 안 되는 파일."
- 전체 진단 질문: 모든 사용자에게 동일한 정적 파일(번들, 글꼴, 공개 이미지, 마케팅 페이지)이 CDN/브라우저 에지에서 적극적으로 캐싱되도록 구성되어 있습니까? 그리고 인증되었거나 사용자별 응답(계정 데이터, 대시보드, 청구, 인증 토큰)이 공유 캐시에 저장되지 않도록 엄격하게 보호되고 있습니까?
- 찾는 위치 및 방법:
- 위험한 캐시 누수 (P0 위험): 개인화된 데이터, 세션 상태 또는 개인 JSON을 반환하는 라우트가
private또는no-store없이Cache-Control: public또는s-maxage를 설정하는지, 또는 프레임워크 라우트 캐싱(export const revalidate = ...,force-static)이 특정 사용자에 대한 쿠키/헤더를 읽는 라우트에서 실수로 활성화되었는지 확인하십시오. - 캐싱되지 않은 정적 자산:
next.config.*,vercel.json,nginx.conf, Expressstatic()또는 S3/CDN 업로드 헬퍼를 확인하여 정적 자산 및 사용자 업로드 공개 미디어가 변경 불가능하거나 장기간Cache-Control헤더를 설정하는지 확인하십시오.
- 위험한 캐시 누수 (P0 위험): 개인화된 데이터, 세션 상태 또는 개인 JSON을 반환하는 라우트가
- 저장소 외부에 있을 수 있는 것 (오탐지 확인):
- Next.js, Remix 및 Vite와 같은 프레임워크는 저장소에 사용자 정의 헤더가 없더라도
/_next/static또는/assets아래에 빌드 자산을 자동으로 지문 인식하고 배포 시 캐싱합니다.
- Next.js, Remix 및 Vite와 같은 프레임워크는 저장소에 사용자 정의 헤더가 없더라도
질문 7: 공개 및 유료 엔드포인트 (속도 제한 및 비용 보호 장치)
- 카드 약식: "공개되거나 유료 서비스를 호출하는 엔드포인트와 한 사용자가 호출할 수 있는 빈도를 제한하는 장치."
- 전체 진단 질문: 인증 없이 호출할 수 있는 라우트(로그인, 회원가입, 매직 링크, 비밀번호 재설정, 공개 검색, 문의 양식, 웹훅) 또는 계량/유료 서비스(LLM API, SMS/OTP, 이메일 전송, 파일 저장소, 유료 데이터 API)를 트리거하는 라우트는 무엇이며, IP별 또는 사용자별 속도 제한, 요청 본문 크기 상한 및 비용/토큰 제한을 코드에서 시행하는 것은 무엇입니까?
- 찾는 위치 및 방법:
- 고위험 엔드포인트 인벤토리 작성: 모든 공개 인증/양식 라우트와 과금되는 외부 API를 호출하거나 무거운 DB 쓰기를 트리거하는 모든 엔드포인트를 나열하십시오.
- 속도 제한 장치 확인: 종속성 및 미들웨어에서 속도 제한 라이브러리(
@upstash/ratelimit,express-rate-limit,rate-limiter-flexible,slowapi,django-ratelimit,rack-attack,golang.org/x/time/rate)를 Grep하고 실제로 위험한 라우트에 연결되어 있는지 확인하십시오. - 입력 및 비용 상한 확인: AI 또는 파일 업로드 엔드포인트에서 제공자를 호출하기 전에
max_tokens/maxOutputTokens, 프롬프트 길이 검증(예: Zod.max()) 및 파일 크기 제한이 시행되는지 확인하십시오.
- 저장소 외부에 있을 수 있는 것 (오탐지 확인):
- 속도 제한은 애플리케이션 저장소 외부에서 Cloudflare WAF, AWS API Gateway, Vercel Firewall 또는 Nginx 리버스 프록시를 통해 업스트림에서 시행될 수 있습니다. 저장소 내 제한기가 없으면 업스트림에서 확인하거나 미들웨어에 추가해야 할 높은 우선순위의 단서로 플래그를 지정하십시오.
출력 형식 (화면에 이 계획 표시)
아래 정확한 섹션을 사용하여 보고서를 제공하십시오. 어조는 직설적이고 차분하며 실용적으로 유지하십시오.
1. 스택 및 범위 스냅샷
- 감지된 스택: [프레임워크, 언어, DB/ORM, 호스팅/인프라 힌트]
- 스캔된 범위: [전체 저장소 또는 특정 경로]
- 알림: 이 발견 사항은 확인해야 할 단서이지, 보장된 버그가 아닙니다. 클라우드 대시보드(관리형 DB 백업, CDN 규칙, WAF 속도 제한)에서 구성된 인프라는 git에 나타나지 않습니다.
2. 7가지 질문 점수 카드
| # | 질문 | 상태 | 주요 단서 / 관찰 |
|---|---|---|---|
| Q1 | 검색/목록 인덱스 및 루프 내 쿼리 | [확인 필요] / [적절히 처리됨] | 1줄 요약 |
| Q2 | 동일한 데이터를 반환하는 빈번한 공유 읽기 | [확인 필요] / [적절히 처리됨] | 1줄 요약 |
| Q3 | 두 개의 복사본 실행(메모리 및 디스크 상태) | [확인 필요] / [적절히 처리됨] | 1줄 요약 |
| Q4 | 웹 요청 내 느린 작업 | [확인 필요] / [적절히 처리됨] | 1줄 요약 |
| Q5 | 백업, 복제본 및 복원 | [확인 필요] / [적절히 처리됨] | 1줄 요약 |
| Q6 | 공개 자산 대 개인 데이터 캐싱 | [확인 필요] / [적절히 처리됨] | 1줄 요약 |
| Q7 | 공개 및 유료 엔드포인트 속도 제한 | [확인 필요] / [적절히 처리됨] | 1줄 요약 |
3. 각 질문에 대한 상세 분석
각 [확인 필요] 상태에 대해 아래 템플릿을 사용하여 자세히 설명하십시오.
Q[번호]: [질문 제목]
발견 사항:
- 단서 1:
path/to/file:line— 설명. (심각도: 높음/중간/낮음) - 단서 2:
path/to/file:line— 설명. (심각도: 높음) - ...
권장 사항:
- 특정 작업을 수행하기 위해 할당 가능한 작업 항목 또는 변경 사항입니다.
- ...
참고 사항 (오탐지 가능성): (이 섹션은 확인 사항이 저장소 외부에 있을 수 있는 경우에만 포함하십시오. 예: 관리형 DB 백업, CDN 규칙, WAF 제한)
4. 우선순위 수정 계획
이 섹션은 모든 확인 사항을 생존 우선 순서대로 정리합니다.
1️⃣ 생존 (즉각 주의)
[질문 5]첫 번째 구체적 단서 요약[질문 7]첫 번째 구체적 단서 요약[질문 6]데이터 누출 단서 요약 (있는 경우)
2️⃣ 성장 (다음 우선순위)
[질문 1]...[질문 2]...[질문 3]...[질문 4]...[질문 6](공개 자산 캐싱 관련 단서가 남아 있는 경우)
이 감사는 정적 코드 분석 도구로서 7가지 핵심 영역에서 확인해야 할 단서를 찾아냅니다. 이것은 프로덕션 트래픽 부하 테스트나 보안 침투 테스트를 대체하지 않습니다.