아키텍처 - GEO Score AI

System Architecture v2026

🗺️ 플랫폼 아키텍처

22개 페이지 · 9개 API · 3계층 측정 신호 · AXOS 온톨로지 (22 노드 / 27 관계)

🔌 API 엔드포인트 (총 9개)

기존 4 + 신규 4 + 헬스체크 1

🔍 POST /api/analyze core

URL 또는 content 모드를 받아 새 10 KPI를 산출. 외부 인프라 측정(robots/sitemap/색인/백링크) 포함.

🎁 POST /api/recommend

진단 결과를 토대로 6단계 등급에 매핑된 솔루션·우선순위를 반환.

💬 POST /api/chat

도메인 RAG 기반 AI 상담사. 진단 결과를 컨텍스트로 답변.

🎯 POST /api/cep-discover

CEP(Customer Entry Point) 5단계 발굴 — 카테고리 진입 순간을 자동 추출.

✨ POST /api/rewrite-content NEW

입력 콘텐츠를 90점 이상까지 자동 재작성. 자가 검증 루프(최대 3회) 동작.

🌳 POST /api/derive-30 NEW

핵심 주제에서 30개 질문형 파생 콘텐츠 트리를 자동 생성.

🔍 POST /api/citation-test NEW

AI 인용성 실제 검증 — 10개 가상 질문으로 인용 빈도/위치 측정.

📋 POST /api/generate-report NEW

영업용 단일 HTML 리포트 생성 — 진단·CEP·재작성·파생 결과 통합.

❤️ GET /api/health

서버 상태·환경 변수 점검.

📄 페이지 구성 (총 22개)

진입 3 · 진단 결과 8(+1 통합) · 기능 8 · 리소스 3

🚪 진입 (3)

index.html · analyzing.html · dashboard.html

📈 진단 결과 단독 (8)

result-overview · result-kpi · result-problems · result-comparison · result-solution · result-ontology · result-cep · result-rewrite

📋 통합 결과 NEW

result-tabs.html — 위 8개를 탭으로 묶은 단일 페이지.

🛠️ 기능 (8)

cep.html · rewrite.html · derive.html🆕 · citation-test.html🆕 · generate-report.html🆕 · proposal.html🆕 · chatbot.html · admin.html

📚 리소스 (3)

manual.html · architecture.html · ontology.html

📡 측정 신호 (3계층)

외부 인프라 4신호 · 콘텐츠 10 KPI · ai_writing 5신호

🌐 외부 인프라 (4신호)

robots.txt — 7봇 차단 검출 (GPTBot · ClaudeBot · ChatGPT-User · PerplexityBot · Google-Extended · Amazonbot · CCBot)
sitemap.xml — URL 수 + lastmod
색인 휴리스틱 — sitemap × 0.6 + 내부링크 × 1.2
백링크 휴리스틱 — 외부링크 × 0.6 + 언론키워드 × 1.5

🎯 ai_writing 5신호 → KPI 9 aiCitation 직접 산출

질문형 H2 ≥ 50%
정의문 H2 ≥ 50%
브랜드 반복 ≥ 50%
외부 신호 ≥ 30%
CTA 도달률 ≥ 50%

📊 콘텐츠 10 KPI · 가중치 합 100%

#	KPI	가중치	설명
1	botAccess	14%	AI 봇 접근 허용 여부 (robots.txt)
2	sitemapStatus	10%	sitemap.xml 존재 · 최신성
3	indexExposure	13%	색인 노출 추정치
4	structuredData	12%	JSON-LD · Schema.org 구조화 데이터
5	pageInfo	8%	title · meta · OG 태그
6	contentDepth	10%	콘텐츠 깊이 · 길이 · 정보량
7	externalAuthority	9%	외부 권위 (백링크 휴리스틱)
8	eeat	8%	경험·전문성·권위·신뢰
9	aiCitation	10%	AI 인용 가능성 (ai_writing 5신호 직접 산출)
10	cepScene	6%	CEP 장면 매핑 정도

⚠️ 페널티 매트릭스

조건	적용 페널티
structuredData < 30	전 KPI -15%
indexExposure < 20	aiCitation 강제 ≤ 25
AI 봇 5종+ 차단	전 KPI -30%

🏆 6단계 등급 체계

95 / 85 / 70 / 55 / 40 컷오프

등급	점수 범위	의미
A+	95 ~ 100	Premium
A	85 ~ 94	우수
B	70 ~ 84	보통
C	55 ~ 69	미흡
D	40 ~ 54	부족
F	0 ~ 39	위급

🗺️ 권장 경로 5단계 매트릭스

등급	권장 경로
F	신규 개발 필수
D	신규 개발 권장
C	비교 검토
B	부분 개선
A+ / A	강화

🕸️ AXOS 온톨로지 시스템

8종 노드 + 9종 관계 · 22 노드 · 27 관계로 GEO 도메인 모델링

🧩 노드 8종

Actor · Process · Data · System · Artifact · Decision · Event · Issue

🔗 관계 9종

FLOW · INPUT · OUTPUT · USES · CREATES · DECIDES · TRIGGERS · CAUSES · BLOCKS

📐 모델 규모

22 노드 · 27 관계 — GEO 진단/재작성/CEP/검증/리포트 도메인 전체를 포괄.

🔄 데이터 흐름 (Sequence)

📁 디렉토리 구조

geo-score-ai/
├── index.html                 # 메인 (Hero + 진단 폼)
├── analyzing.html             # 진단 진행 화면
├── dashboard.html             # 대시보드 (이력 + 추이)
│
├── result-tabs.html           # 🆕 8개 결과 통합 페이지 (탭)
├── result-overview.html       # 진단 개요
├── result-kpi.html            # 10 KPI 상세
├── result-problems.html       # 문제 도출
├── result-comparison.html     # 경쟁사 비교
├── result-solution.html       # 솔루션 추천
├── result-ontology.html       # AXOS 온톨로지 뷰
├── result-cep.html            # CEP 결과
├── result-rewrite.html        # 90점 재작성 결과
│
├── cep.html                   # 🎯 CEP 5단계 발굴
├── rewrite.html               # ✨ 90점 글 재작성
├── derive.html                # 🆕 🌳 30개 파생
├── citation-test.html         # 🆕 🔍 인용성 검증
├── generate-report.html       # 🆕 📋 영업용 단일 HTML 리포트
├── proposal.html              # 🆕 AI최적화 홈페이지 개발 제안서
├── chatbot.html               # 💬 AI 상담사
├── admin.html                 # 🔐 관리자
│
├── manual.html                # 📖 사용 매뉴얼
├── architecture.html          # 🗺️ 시스템 아키텍처 (현재)
├── ontology.html              # 🕸️ 3D 온톨로지
│
├── api/                       # Vercel Serverless Functions (9개)
│   ├── analyze.js             # 10 KPI + 외부측정
│   ├── recommend.js           # 솔루션 추천
│   ├── chat.js                # AI 상담사
│   ├── cep-discover.js        # CEP 5단계 발굴
│   ├── rewrite-content.js     # 🆕 90점 자동 재작성 (자가검증)
│   ├── derive-30.js           # 🆕 30개 질문형 파생
│   ├── citation-test.js       # 🆕 10개 가상 질문 인용 검증
│   ├── generate-report.js     # 🆕 단일 HTML 리포트
│   └── health.js              # 헬스 체크
│
├── js/
│   ├── kpi-config.js          # 10 KPI · 가중치 · 페널티
│   ├── common.js              # Session · History · API client
│   ├── chart.js               # SVG 차트
│   ├── ai_writing.js          # 5신호 측정 → aiCitation
│   └── ontology.js            # AXOS 22 노드 / 27 관계
│
├── css/
│   ├── main.css               # 디자인 시스템
│   └── dashboard.css          # 대시보드 스타일
│
├── package.json
├── vercel.json
├── .env.example               # GEMINI_API_KEY
└── .gitignore