کش دولایه با Nginx و Redis برای ترافیک ناگهانی کمپین‌ها

proxy_cache_path /var/cache/nginx/micro levels=1:2 keys_zone=micro:20m max_size=1g inactive=10m use_temp_path=off;

map $http_cookie $skip_cache {
    default            0;
    ~*session          1;   # هر کاربر واردشده
    ~*cart             1;
}

server {
    location / {
        proxy_pass http://app;
        proxy_cache micro;
        proxy_cache_key "$scheme$host$request_uri";
        proxy_cache_valid 200 5s;
        proxy_cache_lock on;
        proxy_cache_lock_timeout 5s;
        proxy_cache_use_stale updating error timeout http_500 http_502 http_503;
        proxy_cache_bypass $skip_cache;
        proxy_no_cache $skip_cache;
        add_header X-Cache $upstream_cache_status always;   # HIT / MISS / BYPASS
    }

    location ~ ^/(cart|checkout|account|api)/ {
        proxy_pass http://app;          # بدون کش
    }
}

const inflight = new Map<string, Promise<unknown>>();

/** cache-aside با جلوگیری از هجوم هم‌زمان: درخواست‌های هم‌زمان یک کلید، یک کوئری مشترک دارند. */
export async function cached<T>(key: string, ttlSec: number, load: () => Promise<T>): Promise<T> {
  const hit = await redis.get(key);
  if (hit) return JSON.parse(hit) as T;
  if (inflight.has(key)) return inflight.get(key) as Promise<T>;
  const p = load()
    .then(async (value) => {
      await redis.set(key, JSON.stringify(value), 'EX', ttlSec);
      return value;
    })
    .finally(() => inflight.delete(key));
  inflight.set(key, p);
  return p;
}

// هنگام ویرایش دسته‌بندی در پنل:
export const invalidateCategories = () => redis.del('categories:tree', 'menu:main');