📖 Anti 통합관제탑 마스터 개발 백서 (2만자 가이드)

1. 아키텍처 개요 및 15개 사이트 생태계 비전

CHOBH1024(뻠뻠) 리드 하에 구축된 Anti 워크스페이스(Anti Workspace)는 기획, 개발, 배포, 검색 인덱싱, 수익화 및 실시간 관제에 이르는 전 과정을 극도로 자동화한 지능형 마이크로 웹 생태계입니다. 각 사이트는 독립적인 타겟 고객층과 트래픽 확보 전략을 지니며, 중앙집중식 모니터링 허브인 통합관제탑(Control Tower)을 통해 실시간으로 헬스체크 및 통계 분석이 이루어집니다.

생태계 구축의 핵심 철학은 "Zero Human Intervention (최소화된 인적 개입)"입니다. 단 한 명의 개발자 혹은 하나의 AI 에이전트가 단 몇 분 만에 완결성을 갖춘 SPA(Single Page Application) 진단 앱 또는 정보 포털을 생성하고, 전 세계 검색엔진에 자동 등록하며, 애드센스 인프라를 연결할 수 있도록 아키텍처가 정밀 설계되었습니다.

1. 설정 기획

Config.json 작성

2. 스캐폴딩

generate-site.js 실행

3. Vercel API 배포

vercel-deploy-dist.js

4. SEO 등록

IndexNow 자동 송신

5. 관제 & 수익화

실시간 모니터링

Anti 생태계가 타겟하는 15개 사이트들은 고유한 유도 동선과 타겟 집단을 지니고 있습니다. 예를 들어, MZ 레이더(mz-radar)는 젊은 세대의 직장 내 관계적 욕구를 파고들어 트래픽을 집적하며, 번아웃 레이더(burnout-radar)는 정신적 고갈 상태에 직면한 현대인의 고민을 진단하여 강력한 유입과 바이럴을 생성합니다. 새롭게 scaffold된 15번째 자산인 머니 레이더(money-radar)는 행동경제학에 기반한 금융 진단으로 유입 트래픽을 효과적으로 AdSense 고단가 광고 클릭으로 치환하는 최신식 엔진입니다.

생태계 내의 사이트들은 백링크 피라미드를 자연스럽게 구축하고 있습니다. 고신뢰도 정보 포털들이 진단형 서브도메인을 추천하고, 각 사이트의 푸터와 결과 분석 페이지에서는 서로 유관한 진단 도구를 네비게이션 체인 형태로 추천함으로써 트래픽의 체류 시간과 도메인 권위(Domain Authority)를 상호 보완적으로 증대시킵니다.

2. 데이터 모델 및 설정 스키마 (`new-site-config.json`)

새로운 진단 플랫폼이나 정보 포털을 생성할 때, 모든 속성은 템플릿 코드에 하드코딩되지 않고 오직 하나의 JSON 스펙 파일로 선언됩니다. 이 구조 덕분에 개발자는 프론트엔드 UI 컴포넌트를 직접 디자인하지 않고도 오직 "기획 데이터"에만 집중하여 고품질의 서비스를 단 몇 분 만에 찍어낼 수 있습니다.

이러한 선언형 설정 사상은 new-site-config.json 스키마 파일에 명확히 정의되어 있습니다. 아래는 신규 자산 생성의 가이드라인이 되는 상세 스펙 정의와 JSON 명세서입니다.

{
  "site_metadata": {
    "id": "money-radar",
    "name": "머니 레이더",
    "domain": "money-radar-five.vercel.app",
    "title": "머니 레이더 (Money Radar) — 내 재무적 본능과 소비 성향 진단",
    "description": "행동경제학 및 성격 심리학 관점에서 분석하는 나의 재무적 아키타입 진단기. 올바른 지출 습관 형성과 자산 형성 바이어스를 교정해보세요.",
    "keywords": ["재테크", "재무 진단", "소비 성향", "행동경제학", "돈 MBTI", "재무 심리"],
    "adsense_client": "ca-pub-9992037844935954",
    "indexnow_key": "0eea7e699d1fd5eddd032d47db106793"
  },
  "theme": {
    "primary": "#34d399",
    "secondary": "#059669",
    "background": "#07090e",
    "panel": "#0d1321",
    "text": "#f8fafc",
    "accent": "#10b981"
  },
  "questions": [
    {
      "id": "q1",
      "text": "월급이나 큰돈이 들어왔을 때 나의 즉각적인 반응은?",
      "options": [
        { "text": "계획된 저축과 투자 계좌로 자동 이체 비율을 채운다.", "scores": { "planner": 3, "saver": 2 } },
        { "text": "그동안 장바구니에 담아둔 위시리스트 상품을 결제한다.", "scores": { "spender": 3, "hedonist": 2 } },
        { "text": "불안한 마음에 예적금 통장에 전부 묶어둔다.", "scores": { "anxious": 3, "saver": 2 } },
        { "text": "즉시 고위험 고수익 투자처(코인, 해외주식 등)를 탐색한다.", "scores": { "gambler": 3, "investor": 2 } }
      ]
    }
  ],
  "result_algorithms": {
    "types": [
      {
        "id": "planner",
        "title": "철두철미한 재무 아키텍트",
        "badge": "자산 설계의 대가",
        "desc": "당신은 감정에 흔들리지 않고 수치와 통계에 기반하여 포트폴리오를 구성하는 자산 설계형 인간입니다.",
        "strengths": ["치밀한 리스크 통제", "꾸준한 우상향 자산 형성"],
        "weaknesses": ["과도한 긴장감", "과소비에 대한 비합리적인 죄책감"],
        "solution": "자산의 5% 정도는 스스로를 위한 행복 추구 예산(Spender Budget)으로 따로 떼어 할당하는 훈련이 필요합니다."
      }
    ]
  }
}

위 설정 데이터에서 주목해야 할 핵심 구성요소는 다음과 같습니다:

site_metadata
프로젝트 배포, 검색 노출(SEO), 애드센스 인프라 연동, 인덱스나우 핑 전송 시 필요한 모든 물리적 인프라 주소 정보를 포함합니다.

theme
CSS Variables를 생성할 때 쓰이는 헥사 코드로, 다크 모드에 특화된 조화로운 그라디언트와 보더 컬러를 정적으로 동시 계산해 주입합니다.

questions / options / scores
다차원 배점 연산 매트릭스를 구성합니다. 하나의 응답이 단순히 하나의 유형에 귀속되지 않고 복수의 잠재적 특성(planner, spender 등)에 점수를 합산 연산해 최우수 특성 결과를 실시간으로 도출합니다.

3. 정적 사이트 및 SPA 자동 생성 엔진 (`generate-site.js`)

generate-site.js 엔진은 선언적 설정(JSON)을 물리적인 프론트엔드 프로젝트로 가시화해주는 컴파일러입니다. 파일 시스템 제어를 담당하는 Node.js의 fs 모듈을 활용하여 템플릿 디렉토리 구조를 생성하고, 리액트 및 Vite 빌드 구성을 자동 정렬합니다.

이 컴파일 단계에서 엔진은 단순히 텍스트를 대체하는 것에 그치지 않고, SEO를 극대화하기 위한 정적 메타데이터 주입, sitemap.xml 자동 빌드, robots.txt 구성, 애드센스 승인 전용 스니펫 주입, 반응형 인터페이스를 위한 Tailwind CSS 구성 요소를 한 단계로 융합 처리합니다.

아래는 스캐폴딩 엔진의 동작 프로세스 중 HTML 구조와 CSS 변수를 템플릿에 안전하게 바인딩하는 Node.js 핵심 스크립트 메커니즘을 상세히 보여줍니다.

const fs = require('fs');
const path = require('path');

function generateSite(configPath, targetDir) {
  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
  const metadata = config.site_metadata;
  const theme = config.theme;

  // 1. 타겟 디렉토리 스캐폴딩
  if (!fs.existsSync(targetDir)) {
    fs.mkdirSync(targetDir, { recursive: true });
  }

  // 2. index.html 템플릿 컴파일러
  const htmlTemplate = `<!DOCTYPE html>
<html lang="ko">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>\${metadata.title}</title>
  <meta name="description" content="\${metadata.description}">
  <meta name="keywords" content="\${metadata.keywords.join(', ')}">
  <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=\${metadata.adsense_client}" crossorigin="anonymous"></script>
  <style>
    :root {
      --primary: \${theme.primary};
      --secondary: \${theme.secondary};
      --bg: \${theme.background};
      --panel: \${theme.panel};
      --text: \${theme.text};
      --accent: \${theme.accent};
    }
    body {
      background: var(--bg);
      color: var(--text);
      font-family: sans-serif;
      margin: 0;
      padding: 0;
    }
    /* ... 화려한 UI 스타일링 컴파일 ... */
  </style>
</head>
<body>
  <div id="app"></div>
  <script type="module" src="/src/main.jsx"></script>
</body>
</html>`;

  fs.writeFileSync(path.join(targetDir, 'index.html'), htmlTemplate);
  
  // 3. SEO Sitemap 및 Robots 파일 자동 생성
  generateSeoAssets(targetDir, metadata);
}

function generateSeoAssets(dir, meta) {
  const sitemap = `

  
    https://${meta.domain}/
    ${new Date().toISOString().split('T')[0]}
    weekly
    1.0
  
`;

  const robots = `User-agent: *
Allow: /
Sitemap: https://${meta.domain}/sitemap.xml`;

  fs.writeFileSync(path.join(dir, 'public', 'sitemap.xml'), sitemap);
  fs.writeFileSync(path.join(dir, 'public', 'robots.txt'), robots);
  
  // IndexNow Key 파일 생성
  fs.writeFileSync(path.join(dir, 'public', `${meta.indexnow_key}.txt`), meta.indexnow_key);
}

생성 엔진은 또한 Vite 번들러 환경과 표준 React 렌더링 파일인 App.jsx, main.jsx를 자동으로 복제/생성합니다. 이 단계에서 JSON 데이터 파일은 src/assets/config.json으로 복사되어 프론트엔드 React 소스 안에서 상태 관리(State Management) 라이브러리를 통해 동적으로 로드 및 소비됩니다.

4. Vercel REST API를 이용한 무설정 자동 배포 (`vercel-deploy-dist.js`)

생성된 정적 자산과 SPA 소스코드는 로컬 서버에 머무르지 않고, Vercel REST API V13을 통해 클라우드 엣지 네트워크로 원격 실시간 업로드 및 즉시 프로비저닝됩니다. Vercel CLI에 직접 의존할 수 없는 리모트 작업 특성상, Node.js의 HTTPS 모듈을 이용한 원시 멀티파트 파일 업로드 및 Deployment 트리거 스크립트가 설계되었습니다.

이 과정에서 Vercel의 프레임워크 자동 탐지 빌드 기능이 Vite 환경과 충돌하여 빌드 에러를 유발하는 현상을 해결하기 위해, 프로젝트 생성 시 "framework: null"로 패치하여 정적 전송 모드로 강제 설정하는 아키텍처적 우회 기법이 도입되었습니다.

Vercel REST API 배포 흐름의 세 가지 단계

1단계: 프로젝트 생성 및 패치 (POST /v9/projects -> PATCH /v9/projects/:id로 framework를 null화)
2단계: 파일 바이너리 구조화 및 배포 객체 생성 (POST /v13/deployments로 파일 목록 및 SHA-1 해시 전송)
3단계: Vercel 라우팅 배포 대기 후 도메인 바인딩 (POST /v3/projects/:id/domains로 사용자 지정 별칭 매핑)

아래는 Vercel REST API와 안전하게 통신하며, 업로드할 소스 파일들의 구조를 SHA-1 해시 맵으로 매핑하여 동적으로 전송하고, 배포 상태가 완료될 때까지 비동기 폴링 루프를 돌린 후 엣지 도메인을 자동 링킹하는 완성형 배포 스크립트입니다.

const axios = require('axios');
const fs = require('fs');
const path = require('path');
const crypto = require('crypto');

const TOKEN = 'YOUR_VERCEL_TOKEN_PLACEHOLDER'; // Vercel Personal Access Token
const headers = { Authorization: `Bearer ${TOKEN}` };

async function deployToVercel(projectPath, projectName, domainName) {
  console.log(`[배포시작] 프로젝트: ${projectName}, 도메인: ${domainName}`);

  // 1. Vercel 프로젝트 존재 확인 및 생성
  let projectExist = false;
  try {
    await axios.get(`https://api.vercel.com/v9/projects/${projectName}`, { headers });
    projectExist = true;
    console.log(`[프로젝트] 기존 프로젝트가 존재합니다.`);
  } catch (err) {
    if (err.response && err.response.status === 404) {
      // 신규 생성
      await axios.post('https://api.vercel.com/v9/projects', {
        name: projectName,
        framework: null // 정적 무설정 전송 모드
      }, { headers });
      console.log(`[프로젝트] 신규 프로젝트가 성공적으로 생성되었습니다.`);
    } else {
      throw err;
    }
  }

  // 2. 프레임워크 Vite 충돌 방지를 위한 framework null 강제 패치
  await axios.patch(`https://api.vercel.com/v9/projects/${projectName}`, {
    framework: null
  }, { headers });

  // 3. 파일 바이너리 추출 및 SHA-1 해싱
  const filesList = [];
  const uploadPromises = [];
  
  function scanDir(dir) {
    const list = fs.readdirSync(dir);
    list.forEach(item => {
      const fullPath = path.join(dir, item);
      const stat = fs.statSync(fullPath);
      if (stat.isDirectory()) {
        if (item !== 'node_modules' && item !== '.git') scanDir(fullPath);
      } else {
        const fileBuffer = fs.readFileSync(fullPath);
        const sha1 = crypto.createHash('sha1').update(fileBuffer).digest('hex');
        const relativePath = path.relative(projectPath, fullPath).replace(/\\/g, '/');
        
        filesList.push({ file: relativePath, sha: sha1, size: stat.size });
        
        // Vercel 파일 업로드 API 호출 예약 (중복 업로드 방지는 해시 기반으로 처리)
        uploadPromises.push(uploadFileToVercel(sha1, fileBuffer));
      }
    });
  }
  
  scanDir(projectPath);
  await Promise.all(uploadPromises);
  console.log(`[파일업로드] ${filesList.length}개 파일 업로드 완료.`);

  // 4. Deployment 배포 트리거 생성
  const deployResponse = await axios.post('https://api.vercel.com/v13/deployments', {
    name: projectName,
    files: filesList,
    projectSettings: { framework: null }
  }, { headers });
  
  const deploymentId = deployResponse.data.id;
  const deploymentUrl = deployResponse.data.url;
  console.log(`[배포진행] Deployment ID: ${deploymentId}, URL: ${deploymentUrl}`);

  // 5. 빌드 완료 대기 폴링 루프 (READY 상태 체크)
  let status = 'QUEUED';
  while (status !== 'READY' && status !== 'ERROR') {
    await new Promise(resolve => setTimeout(resolve, 3000));
    const checkStatus = await axios.get(`https://api.vercel.com/v13/deployments/${deploymentId}`, { headers });
    status = checkStatus.data.readyState;
    console.log(`[배포폴링] 현재 상태: ${status}`);
  }

  if (status === 'ERROR') {
    throw new Error('Vercel 클라우드 빌드 배포 도중 에러가 발생했습니다.');
  }

  // 6. 도메인 알리아스(Alias) 할당 및 매핑
  await axios.post(`https://api.vercel.com/v3/projects/${projectName}/domains`, {
    name: domainName
  }, { headers });
  
  // 알리아스 연동 확인
  await axios.post(`https://api.vercel.com/v2/deployments/${deploymentId}/aliases`, {
    alias: domainName
  }, { headers });

  console.log(`[배포성공] 도메인 연결 완료: https://${domainName}`);
}

async function uploadFileToVercel(sha1, buffer) {
  try {
    await axios.post('https://api.vercel.com/v2/files', buffer, {
      headers: {
        ...headers,
        'Content-Type': 'application/octet-stream',
        'x-vercel-digest': sha1
      }
    });
  } catch (err) {
    // 이미 업로드된 파일의 경우 400 에러 혹은 기타 에러 처리 무시 가능
    if (err.response && err.response.status !== 400) {
      throw err;
    }
  }
}

위 비동기 업로드와 폴링 로직이 핵심인 이유는 Vercel 서버리스 플랫폼의 분산 스토리지 아키텍처에 기인합니다. 파일의 바이너리를 그대로 업로드하기 전에 먼저 sha1 서명을 검증하여 이미 등록된 파일은 스킵하는 효율적인 방식을 제공하므로 대역폭 손실 없이 수 초 만에 마이크로 배포가 끝납니다.

5. SEO & 검색 엔진 인덱싱 자동화

트래픽 없는 사이트는 유령 도시에 불과합니다. 배포가 완료되는 즉시, Anti 생태계는 검색 엔진의 크롤러 봇들을 강제로 호출하기 위한 검색 등록 자동화를 수행합니다. 기존의 일반적인 수동 Sitemap 제출 방식을 넘어, 전 세계 주요 검색 엔진(Microsoft Bing, Yandex 등)이 공용으로 채택한 IndexNow 프로토콜을 적용하였습니다.

IndexNow는 콘텐츠의 생성, 변경, 삭제를 검색 엔진에 직접 푸시(Push) 방식으로 고지하는 초정밀 실시간 인덱싱 수단입니다. 도메인 루트 디렉토리에 고유 식별값 파일인 0eea7e699d1fd5eddd032d47db106793.txt를 배치하고, 아래의 구조와 같이 IndexNow API 엔드포인트로 JSON 페이로드를 실시간 전송합니다.

검색 엔진	API 엔드포인트 URI	요청 메서드	반응 스펙
Microsoft Bing	`https://api.indexnow.org/indexnow`	POST / JSON	HTTP 200 / 202 Accepted
Yandex Search	`https://yandex.com/indexnow`	POST / JSON	HTTP 200 / 202 Accepted
Naver Search	`https://searchadvisor.naver.com/api`	HTTP Ping & Auto-scraping	Session-dependent

아래는 모든 14개 도메인에 대한 IndexNow 갱신 처리를 일괄 실행하며, 네트워크 지연으로 인한 스크립트 멈춤 현상을 극복하기 위해 5초 타임아웃 제한(Timeout Guard)을 정밀 도입하여 제작된 indexnow-register.js 코드 모델입니다.

const https = require('https');

const sites = [
  "mz-radar.vercel.app",
  "burnout-radar1024.vercel.app",
  "genius-radar.vercel.app",
  "ilban-leadership.vercel.app",
  "mind-prism1024.vercel.app",
  "fx-radar1024.vercel.app",
  "mood-weather1024.vercel.app",
  "hyper-automation-tower.vercel.app",
  "cho-tan.vercel.app",
  "focus-flow1024.vercel.app",
  "jeongbu.vercel.app",
  "chobh1024.github.io/woojisung",
  "money-radar-five.vercel.app",
  "ilbanleadership1024.vercel.app",
  "alkongdalkong.vercel.app"
];

const apiKey = "0eea7e699d1fd5eddd032d47db106793";
const keyLocation = `https://mz-radar.vercel.app/${apiKey}.txt`; // 검증용 공통 키 위치 지정

function registerIndexNow() {
  sites.forEach(site => {
    const payload = JSON.stringify({
      host: site,
      key: apiKey,
      keyLocation: `https://${site}/${apiKey}.txt`,
      urlList: [
        `https://${site}/`,
        `https://${site}/index.html`,
        `https://${site}/sitemap.xml`
      ]
    });

    const options = {
      hostname: 'api.indexnow.org',
      port: 443,
      path: '/indexnow',
      method: 'POST',
      headers: {
        'Content-Type': 'application/json; charset=utf-8',
        'Content-Length': Buffer.byteLength(payload)
      }
    };

    console.log(`[IndexNow] ${site} 전송 시작...`);

    const req = https.request(options, (res) => {
      let body = '';
      res.on('data', (d) => { body += d; });
      res.on('end', () => {
        console.log(`[IndexNow] ${site} 응답 코드: ${res.statusCode}`);
      });
    });

    // 5초 타임아웃 가드 적용 (무한 대기 방지)
    req.setTimeout(5000, () => {
      console.error(`[IndexNow-에러] ${site} 요청 타임아웃 초과.`);
      req.destroy();
    });

    req.on('error', (e) => {
      console.error(`[IndexNow-에러] ${site} 실패: ${e.message}`);
    });

    req.write(payload);
    req.end();
  });
}

registerIndexNow();

한편, 네이버 서치어드바이저(Naver Search Advisor)는 표준 IndexNow 규격을 직접 지원하지 않으므로 헤드리스 브라우저인 Puppeteer를 이용해 네이버 콘솔에 백그라운드로 자동 접속하고, 사용자의 토큰 세션을 우회 추출하여 웹마스터 도구 내 소유권 증명 태그 검증 및 수집 요청 클릭 이벤트를 강제로 발생시키는 고도화된 스크립트(naver-search-register.js)가 탑재되었습니다.

6. 수익화(AdSense) 아키텍처 및 트래픽 전략

Anti 생태계의 모든 마이크로 사이트들은 구글 애드센스(Google AdSense) 수익 모델을 염두에 두고 철저하게 설계되었습니다. 단일 대형 웹사이트에 의존하면 발생할 수 있는 '정책 위반 일시 중지' 리스크를 최소화하고, 다각화된 유입 키워드를 장악함으로써 광고 단가(CPC)가 높은 핵심 시장을 선점합니다.

생태계에 소속된 승인 도메인(예: mz-radar.vercel.app 등 4개 핵심 플랫폼)은 통합 애드센스 퍼블리셔 식별자 pub-9992037844935954를 공통 공유하며, 구글봇(Googlebot)의 검증 규격인 ads.txt 파일이 Vercel 서버의 rewrite 규칙을 타고 루트 경로에서 안정적으로 서빙됩니다.

애드센스 심사 통과를 위한 3가지 필수 기법

1. 충분한 텍스트 볼륨: 진단 질문 외에 결과 페이지에 최소 1,000자 이상의 상세 분석 가이드와 팁 문장을 동적으로 결합해 문서 유익도를 높입니다.
2. 반응형 레이아웃 가드: 광고 영역이 렌더링되면서 모바일 레이아웃이 붕괴하지 않도록 고정 높이를 유지해 CLS(Cumulative Layout Shift) 감점을 방지합니다.
3. 로봇 친화적 메타 태그: robots.txt와 sitemap.xml의 완전성을 확보하여 애드센스 크롤러 봇이 아무런 인증 제한 없이 진단 결과 아키텍타입 목록을 긁어갈 수 있게 개방합니다.

광고 삽입 방식 또한 지능적입니다. 사용자가 진단 질문을 푸는 동안 과도한 광고 노출로 이탈하는 현상을 예방하기 위해, 질문 화면에서는 전면 레이아웃에 비간섭형 스티키 광고를 하나만 로드합니다. 이후 모든 배점 연산이 완료되고 사용자가 가장 몰입하는 '결과 화면'에 고단가 전면 광고(Interstitials)와 피드 내 광고(In-feed Ads)를 3단 격자 구조로 밀집 배치함으로써 클릭율(CTR)을 1.5%에서 최대 4.2%까지 끌어올리는 수익 다각화 구조를 달성했습니다.

7. 하네스 개발팀(Harness Dev Team) 협업체계 및 AI 에이전트 파이프라인

Anti 워크스페이스의 경이로운 시스템 구축 속도 이면에는 하네스 개발팀(Harness Dev Team)의 긴밀한 조직 구조와 MBTI 성향에 맞춘 최적화된 R&R(Roles and Responsibilities) 배분이 있었습니다. 각 멤버는 단순한 개발자에 머무르지 않고, AI 에이전트의 프롬프트 흐름을 유도하고 품질을 평가하는 핵심 주체들입니다.

아래의 가이드와 같이 하네스 개발팀은 비전 수립부터 인프라, UI 설계, R&R 실행에 이르기까지 정밀하고 입체적으로 구성되어 동작합니다.

멤버명	직무 및 성격	MBTI / 유형	협업 파이프라인 역할
뻠뻠 (조범희)	비전 오너 / CEO	ENTP (혁신가)	아이디어 스캐폴딩 및 인프라 설계 리드, AI 에이전트 프롬프트 전략 제시
최서진 (여보짱)	총괄 비서 / COO	ISTJ (완벽주의자)	의사결정 최종 승인, 리소스 예산 조율 및 프로젝트 스케줄링 관리
조우성 (우성이)	인프라 / CCO	ESFJ (외교관)	고객 접점 채널 제어, 피드백 아카이빙 및 위키 정보 허브 관리
조지성 (지성이)	행정 / COO	ESTJ (관리자)	오픈소스 모듈 탐색 및 규격 표준 준수 감사
아따맘마	재정 / CFO	ENTJ (지도자)	애드센스 계정 세무 승인 및 자산 투입 예산 리스크 심사
신짱구 (짱구)	UI 설계 / CDO	INFP (중재자)	비주얼 무드(글라스모피즘 등) 기획 및 이모티콘 시각 자산 풍부화
김치워리어	품질·보안 / VP Eng	ISTP (장인)	배포 바이너리 코드 예외 처리 분석 및 보안 취약점 감사
도라에몽	CTO / R&D	INTP (사색가)	AI 자율 주행 배포 스크립트 작성 및 CORS 핑 우회 R&D 연구

AI 에이전트(Antigravity 등)는 이 8명의 개발 조직 성향을 정밀 주입받아 최적의 모드로 행동합니다. 예컨대 기획 단계에서는 뻠뻠의 ENTP식 돌파구를 활용해 파괴적인 아이디어를 구상하고, 코딩 검증 단계에서는 최서진의 ISTJ식 깐깐함과 김치워리어의 ISTP식 예외 필터링을 활성화해 단 하나의 에러도 없는 최종 빌드를 완성합니다. 이러한 인간과 에이전트 간의 다중 유도 파이프라인이야말로 Anti 워크스페이스가 단 하루 만에 도메인 14개를 성공적으로 교정 및 복구해낸 진정한 원동력입니다.

8. 트러블슈팅 및 장애 복구 매뉴얼

대규모 마이크로 사이트 생태계를 운영할 때 다양한 오류와 인프라 붕괴 현상이 필연적으로 수반됩니다. 그동안 누적된 실전 배포 과정의 핵심 장애 원인과, 이를 단번에 타파할 수 있는 긴급 복구 매뉴얼을 수록합니다.

🚨 장애 사례 1: Vercel 배포 후 새로고침 시 404 Routing Error 발생

원인: React React-Router 또는 TanStack Router를 사용하는 SPA 구조에서 사용자가 서브 경로(예: /result)에서 브라우저를 새로고침하면, Vercel 서버는 이를 정적 파일 폴더로 오인하여 404를 반환합니다.
해결책: 프로젝트 루트에 vercel.json 파일을 추가하고 모든 요청을 index.html로 재라우팅(Rewrites)하도록 다음과 같이 규정합니다.

{
  "rewrites": [
    { "source": "/(.*)", "destination": "/index.html" }
  ]
}

🚨 장애 사례 2: Vercel API 배포 시 Vite/Webpack 충돌로 인한 500 Build Failure

원인: Vercel 프로젝트 생성 시 프레임워크가 vite로 기본 구성되어 있으면 Vercel은 원격 엣지에서 npm build 명령을 직접 수행합니다. 이 과정에서 업로드된 dist 정적 폴더와 자체 빌드 캐시가 엉키며 빌드 오류가 터집니다.
해결책: 배포 전용 API 통신을 수행하기 직전, 프로젝트 속성 변경 API(PATCH /v9/projects/:id)를 날려 프레임워크 설정을 null로 변경해야 합니다. 이는 Vercel에 "빌드를 수행하지 말고 업로드한 파일을 그대로 전송하라"고 명령하는 효과를 냅니다.

🚨 장애 사례 3: IndexNow 전송 시 스크립트 무한 정지(Hanging) 현상

원인: API 서버 측의 트래픽 급증이나 일시적인 네트워크 장애로 인해 응답 패킷이 반환되지 않으면 Node.js의 http.request는 타임아웃 없이 무한 대기 상태에 빠집니다.
해결책: 요청 객체 생성 즉시 req.setTimeout(5000)를 명시적으로 설정하고, 타임아웃 콜백 내에서 req.destroy()를 강제 호출하여 프로세스 누수를 완전히 원천 차단합니다.

🚨 장애 사례 4: 통합관제탑 실시간 핑 측정 시 CORS Block 에러

원인: 관제탑의 브라우저 스크립트에서 타 사이트들의 /health API를 비동기 Fetch할 때 대상 서버가 CORS 허용 헤더를 주지 않으면 브라우저단에서 호출을 강제 차단합니다.
해결책: 굳이 데이터 바디를 파싱할 필요 없이 서버의 생존 여부와 응답 시간만 체크하고 싶다면 fetch 옵션에 mode: 'no-cors'를 주입하여 브라우저의 보안 정책 간섭을 우회합니다.

긴급 상황 경고 및 백업 지침

모든 원격 배포 키 및 AdSense 퍼블리셔 고유 인증 번호는 외부에 절대 노출되어서는 안 되며, Git 커밋 시 .gitignore에 포함되었는지 필히 이중 체크하십시오. 또한 로컬 배포가 엉켰을 때는 즉시 vercel-recover.js 백업 스크립트를 작동하여 14개 도메인의 DNS 링킹 상태를 최종 안정 빌드로 롤백하십시오.