HTTP 캐시 헤더 — 저장과 재사용을 정하는 계약

# FastAPI — response 당 Cache-Control 설정, globally 아님
from fastapi import FastAPI, Response

app = FastAPI()

@app.get('/api/health')
async def health(response: Response):
    response.headers['Cache-Control'] = 'public, max-age=10'
    return {'ok': True}

@app.get('/api/me')
async def me(response: Response):
    # User 당 데이터 — share-cache 절대 안 함
    response.headers['Cache-Control'] = 'private, no-store'
    return {'user_id': 'u_42'}

@app.get('/api/posts')
async def list_posts(response: Response):
    # 자주 변하는 list — 짧은 캐시, revalidation 용 ETag, auth 용 Vary
    response.headers['Cache-Control'] = 'private, max-age=60, must-revalidate'
    response.headers['ETag']          = '"v17-abc"'
    response.headers['Vary']          = 'Accept-Encoding, Authorization'
    return {'items': [...]}

@app.get('/assets/app.abc123.css')
async def static_asset(response: Response):
    # Hashed filename — content 변할 수 없음; 영원 캐시
    response.headers['Cache-Control'] = 'public, max-age=31536000, immutable'
    return Response('body{...}', media_type='text/css')

# Canonical Cache-Control 패턴 셋

# 1. Versioned static asset — 영원 캐시
GET /assets/app.abc123.css HTTP/1.1

HTTP/1.1 200 OK
Content-Type: text/css
Cache-Control: public, max-age=31536000, immutable

# 2. API list — 짧은 캐시 + conditional revalidation + Vary
GET /api/posts HTTP/1.1
Authorization: Bearer abc

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: private, max-age=60, must-revalidate
ETag: "v17-abc"
Vary: Accept-Encoding, Authorization

# 3. 민감 개인 데이터 — 절대 캐시 안 함
GET /api/me HTTP/1.1
Authorization: Bearer abc

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: private, no-store

// Client 쪽 — Cache API + stale-while-revalidate 동작 가진 fetch
// (현대 브라우저가 server header 의 stale-while-revalidate 자동 처리)

// 그냥 정상 fetch; 브라우저가 Cache-Control 존중
const resp = await fetch('/api/posts');
const data = await resp.json();

// Client 에서 specific 캐시 정책 opt-in 도 가능
const freshOnly = await fetch('/api/posts', { cache: 'no-cache' });    // 항상 revalidate
const neverNetwork = await fetch('/api/posts', { cache: 'force-cache' }); // 캐시 있으면 서빙
const noCache = await fetch('/api/posts', { cache: 'no-store' });      // 캐시 완전 건너뜀

// 세밀 control 위한 Service Worker
// (여기 자세히 안 함 — fetch event + caches.match + cache.put 패턴)