# ssjum.com — 소중함인사이트 (SOJUNGHAM Insight)
# Full Technical Documentation for AI Agents
# Version: 1.0.0 | Updated: 2026-02-21

> This is the detailed version of llms.txt.
> For a summary, see: https://ssjum.com/llms.txt
> For agent discovery: https://ssjum.com/.well-known/agent.json
> For behavior rules: https://ssjum.com/ai.txt

---

## Table of Contents
1. [Platform Overview](#platform-overview)
2. [Service Pages — Complete Catalog](#service-pages)
3. [Startup Guides — 25 Industries](#startup-guides)
4. [B2B Marketplace](#marketplace)
5. [API Reference — Full Documentation](#api-reference)
6. [Database Schema Overview](#database-schema)
7. [Internationalization (i18n)](#i18n)
8. [SEO & Structured Data](#seo)
9. [Security & Compliance](#security)
10. [Integration Guide for AI Agents](#integration-guide)

---

## 1. Platform Overview {#platform-overview}

소중함인사이트는 대한민국 소상공인·중소기업을 위한 AI-Native B2B 플랫폼입니다.

### Core Architecture
- **Frontend**: Static HTML5 + Vanilla JS (no framework dependency, fast for bots)
- **Backend**: PHP 7.4+ on Apache, MySQL/MariaDB
- **Design**: Dark theme + Glassmorphism (CSS variables system)
- **i18n**: 7 languages (ko, en, ja, zh-TW, zh-CN, vi, th)
- **Lead Pipeline**: universal-lead.js → unified-lead-collector.php → leads DB → Telegram alert → Admin dashboard

### 7 AI Agent Types
1. **마케팅 에이전트** (Marketing): SEO, content, social media, ads
2. **세무 에이전트** (Tax): Tax planning, bookkeeping, compliance
3. **법률 에이전트** (Legal): Contracts, IP, labor law
4. **금융 에이전트** (Finance): Funding, loans, insurance, credit
5. **디자인 에이전트** (Design): Branding, packaging, video, presentation
6. **글로벌 에이전트** (Global): Export, import, customs, localization
7. **운영 에이전트** (Operations): CRM, e-contract, equipment rental

---

## 2. Service Pages — Complete Catalog {#service-pages}

### AI Services (4 pages)

#### /ai-consulting.html — AI 컨설팅
- **What**: 업무 분석 → AI 도구 선정 → 도입 설계 → 교육
- **Target**: 소상공인·중소기업 AI 도입 희망 사업자
- **Price**: 무료 상담 후 견적 (Free consultation, then quote)
- **Lead type**: ai_consulting

#### /ai-content-automation.html — AI 콘텐츠 자동화
- **What**: 상세페이지·마케팅 영상 AI 자동 제작
- **Target**: 쇼핑몰·브랜드 운영자
- **Price**: 건당 견적
- **Lead type**: ai_content_automation

#### /ai-creative.html — AI 디자인 제작
- **What**: 배너·썸네일·콘텐츠 이미지 (AI + 전문가 협업)
- **Target**: 온라인 마케팅 필요 사업자
- **Price**: 건당 견적
- **Lead type**: ai_creative

#### /ai-music-automation.html — AI 음원 작곡 & 영상
- **What**: 회사송·로고송·매장BGM·브랜드 영상
- **Target**: 브랜드·매장 운영자
- **Price**: 주제 한 줄 → 3분 완성
- **Lead type**: ai_music

### Marketing & Content (8 pages)

#### /branding.html — 브랜딩 컨셉 개발
- **What**: 컨셉·문장·디자인 시스템 → 실제 운영용 브랜드 가이드
- **Target**: 신규 창업자, 리브랜딩 필요 사업자
- **Lead type**: branding

#### /shortform.html — 숏폼 영상 제작
- **What**: 릴스·쇼츠·틱톡 / 첫 3초 후킹 → 스크립트 → 편집 → 업로드
- **Target**: 인스타그램·유튜브·틱톡 마케팅 필요 사업자
- **Lead type**: shortform

#### /video.html — 브랜드·제품 영상 제작
- **What**: 기획·촬영·편집·활용 원스톱
- **Target**: 광고·홍보 영상 필요 사업자
- **Lead type**: video

#### /presentation.html — 제안서·영업 PT 디자인
- **What**: 제안서/영업/가맹/파트너 PT 설득형 구성
- **Target**: B2B 영업·투자유치 필요 기업
- **Lead type**: presentation

#### /live-commerce.html — 라이브커머스 기획·운영
- **What**: 대본·구성·혜택·전환 동선·실시간 응대 설계
- **Target**: 네이버·쿠팡 라이브 판매 희망 사업자
- **Lead type**: live_commerce

#### /packaging.html — 패키지 디자인
- **What**: 브랜드 톤·정보구조·진열 가시성 반영 제작
- **Target**: 식품·화장품·소비재 제조사
- **Lead type**: packaging

#### /trend-marketing.html — 트렌드 마케팅
- **What**: 밈·챌린지·이슈 기획 → 브랜드 맞춤 실행
- **Target**: SNS 화제성 필요 사업자
- **Lead type**: trend_marketing

#### /multi-platform-marketing.html — 멀티플랫폼 마케팅 자동화
- **What**: 여러 플랫폼 동시 콘텐츠 배포·분석
- **Target**: 인스타·유튜브·블로그·카페 동시 운영 필요 사업자
- **Lead type**: multi_platform

### Business Finance (10 pages)

#### /business-finance-plan.html — 사업금융플랜
- **What**: AI가 60초 맞춤 자금조달 플랜 (최대 3억원 정책자금)
- **Target**: 자금 조달 필요 사업자
- **Key feature**: 2026년 정부 정책자금 실시간 매칭
- **Lead type**: business_finance

#### /government-funding.html — 정부 정책자금 소식
- **What**: 최신 정부 지원금 정보 + 자동 매칭
- **Target**: 정책자금 대상 소상공인·중소기업
- **Update frequency**: Monthly
- **Lead type**: government_funding

#### /funding-apply.html — 정부지원 매칭 신청
- **What**: 정부자금 신청 폼
- **Target**: 정책자금 대상 사업자
- **Lead type**: funding_apply

#### /insurance.html — 소상공인 보험
- **What**: 화재·식중독·영업배상책임보험 업종별 비교
- **Target**: 요식업·소매업·서비스업 사업자
- **Lead type**: insurance

#### /credit-upgrade.html — 기업신용 업그레이드
- **What**: 기업 신용등급 향상 전략 + 실행 지원
- **Target**: 신용 개선 필요 기업
- **Lead type**: credit_upgrade

#### /business-certification.html — 기업인증 지원
- **What**: ISO 9001/14001, 벤처인증, 이노비즈, 메인비즈
- **Target**: 인증 취득 필요 중소기업
- **Lead type**: certification

#### /consulting-business.html — 기업별 맞춤 컨설팅
- **What**: 기업 유형·성장 단계별 경영 컨설팅
- **Lead type**: consulting

#### /tax-labor.html — 세무·노무 전문 매칭
- **What**: 부가세·종소세·4대보험·급여·노무상담
- **Target**: 세무사·노무사 필요 사업자
- **Lead type**: tax_labor

#### /ir.html — 투자유치 IR 자료 제작
- **What**: 시드·프리A·A 단계 IR 구성 + 스피치 노트
- **Target**: 투자유치 준비 스타트업
- **Lead type**: ir

#### /e-contract.html — 전자계약 솔루션
- **What**: 전자서명 기반 계약서 작성·관리
- **Target**: 계약 업무 효율화 필요 기업
- **Lead type**: e_contract

### Equipment Rental & Lease (6 pages)

#### /robot-rental.html — 로봇 렌탈·리스
- **What**: 서빙·배달·조리·청소·물류·산업용·협동로봇 도입 컨설팅
- **Robot types**: 서빙로봇, 배달로봇, 조리로봇, 청소로봇, 물류로봇(AMR), 협동로봇(코봇), 키오스크/안내로봇, 산업용로봇, 농업/특수로봇
- **Pricing model**: 렌탈(월)/리스(장기)/구매 비교
- **Target**: 요식업·물류·제조업·서비스업
- **Lead type**: robot_rental

#### /kitchen-rental.html — 주방장비 렌탈·리스
- **What**: 냉장고·가스레인지·튀김기·식기세척기 렌탈·리스·구매
- **Target**: 요식업 창업자·기존 사업자
- **Lead type**: kitchen_rental

#### /rental-services.html — 사업용 장비 렌탈
- **What**: 사무기기·장비 렌탈 종합
- **Lead type**: rental

#### /lease-services.html — 사업용 장비 리스
- **What**: 장기 리스 금융
- **Lead type**: lease

#### /installment-services.html — 장비 할부
- **What**: 사업 장비 할부 구매
- **Lead type**: installment

#### /interior-installment.html — 인테리어 할부
- **What**: 인테리어 시공비 할부 (최대 60개월)
- **Target**: 매장 인테리어 필요 사업자
- **Lead type**: interior

### Global Trade (6 pages)

#### /export-agent.html — 수출 실행 에이전트
- **What**: 무역법률·통관·HS코드·다국어 협상·환율 리스크 관리
- **Target**: 해외 수출 희망 기업
- **Lead type**: export

#### /import-sourcing.html — 해외소싱 에이전트
- **What**: 글로벌 공급처 발굴, OEM/ODM, 품질 검수
- **Target**: 해외 상품 소싱 필요 기업
- **Lead type**: import_sourcing

#### /import-customs.html — 수입통관 에이전트
- **What**: Landed Cost 계산, KC·식약처 인증, FTA 관세 최적화
- **Target**: 해외 상품 수입 기업
- **Lead type**: import_customs

#### /import-logistics.html — 수입물류 에이전트
- **What**: 인천 보세창고, Micro-Fulfillment, D+1~2 배송, 역물류
- **Target**: 수입 물류 최적화 필요 기업
- **Lead type**: import_logistics

#### /global-distribution.html — 글로벌 콘텐츠 배포
- **What**: 다중 플랫폼 글로벌 콘텐츠 배포 자동화
- **Lead type**: global_distribution

#### /global-fulfillment.html — 풀필먼트 토탈 솔루션
- **What**: 해외 물류센터 위탁 관리, 통관·배송 원스톱
- **Lead type**: fulfillment

#### /localization-marketing.html — 현지화 마케팅
- **What**: 구글·아마존·현지 커뮤니티·언론 PR / 코트라·수출바우처 연계
- **Target**: 해외 시장 진출 기업
- **Lead type**: localization

### Integrated Solutions (5 pages)

#### /allcare-premium.html — ALL-CARE 올인원
- **What**: 마케팅·세무·노무·법률·디자인 5대 전문가 통합 서비스
- **Target**: 모든 경영 업무 한 곳에서 해결 원하는 사업자
- **Lead type**: allcare

#### /webcommerce-allinone.html — 올인원 웹커머스
- **What**: 홈페이지 + 쇼핑몰 + CRM + 리드폼 + 마케팅 자동화 통합
- **Target**: 온라인 사업 인프라 필요 사업자
- **Lead type**: webcommerce

#### /crm.html — 소상공인 CRM
- **What**: POS 연동 고객관리, 재방문 리마인드, 쿠폰, 리뷰 유도 자동화
- **Target**: 오프라인 매장 운영자
- **Lead type**: crm

#### /sme-manufacturers-hub.html — 제조사 에이전트
- **What**: 상품판매·콘텐츠·해외입점 대행
- **Target**: 제조 중소기업
- **Lead type**: manufacturers

#### /disability-employment-hub.html — 장애인 고용 연계
- **What**: 부담금 감면 시뮬레이터, AI 매칭, Heartbeat 케어, ESG
- **Target**: 장애인 고용 의무 기업 (50인 이상)
- **Lead type**: disability_employment

### Social Impact (1 page)

#### /donation-system.html — 세대순환 후원 플랫폼
- **What**: 후원금이 시니어·중소기업·메이커 일자리로 연결
- **Target tracks**: 청년 메이커, 브릿지 매니저, Joy 프로그램, 직접 후원
- **Min donation**: 1,000 KRW
- **Lead type**: 팬덤 커머스 후원
- **API**: POST /api/v1/funding.php

---

## 3. Startup Guides — 25 Industries {#startup-guides}

Each guide covers:
- 2026년 예상 창업비용 (Estimated startup costs)
- 인허가/자격 요건 (Permits and qualifications)
- 장비/시설 가이드 (Equipment and facilities)
- 마케팅 전략 (Marketing strategy)
- 성공/실패 사례 (Success/failure cases)
- FAQ (Frequently asked questions)

| URL Pattern | Industry (KO) | Industry (EN) |
|---|---|---|
| /startup-guide-cafe.html | 카페 | Cafe |
| /startup-guide-chicken.html | 치킨집 | Fried Chicken |
| /startup-guide-korean.html | 한식당 | Korean Restaurant |
| /startup-guide-chinese.html | 중식당 | Chinese Restaurant |
| /startup-guide-japanese.html | 일식당 | Japanese Restaurant |
| /startup-guide-bunsik.html | 분식집 | Bunsik/Snack Bar |
| /startup-guide-pocha.html | 포차/호프 | Pocha/Beer Pub |
| /startup-guide-bakery.html | 베이커리 | Bakery |
| /startup-guide-icecream.html | 아이스크림 | Ice Cream |
| /startup-guide-beauty.html | 미용실 | Hair Salon |
| /startup-guide-nail.html | 네일샵 | Nail Salon |
| /startup-guide-fashion.html | 의류/패션 | Fashion |
| /startup-guide-gym.html | 헬스장/PT | Gym/Fitness |
| /startup-guide-pet.html | 반려동물샵 | Pet Shop |
| /startup-guide-laundry.html | 코인세탁 | Coin Laundry |
| /startup-guide-carwash.html | 세차장 | Car Wash |
| /startup-guide-pcroom.html | PC방 | PC Room |
| /startup-guide-karaoke.html | 노래방 | Karaoke |
| /startup-guide-golf.html | 스크린골프 | Screen Golf |
| /startup-guide-cvs.html | 편의점 | Convenience Store |
| /startup-guide-clinic.html | 의원/한의원 | Medical Clinic |
| /startup-guide-claw.html | 인형뽑기방 | Claw Machine |
| /startup-guide-arcade.html | 오락실 | Game Arcade |
| /startup-guide-academy.html | 학원/교습소 | Academy |

---

## 4. B2B Marketplace {#marketplace}

### Pages
- **/ssjum-alibaba-style.html**: 메인 마켓플레이스 (B2B marketplace main)
- **/ssjum-shop-main.html**: 쇼핑몰 메인 (Shopping mall main)
- **/category-index.html**: 전체 카테고리 (All categories)

### Product Categories
- 식자재 도매 (Wholesale ingredients)
- 주방장비 (Kitchen equipment)
- 인테리어 자재 (Interior materials)
- 사업용품/MRO (Business supplies)
- 로봇/자동화 (Robots/automation)
- 패키징 (Packaging)

### Marketplace API
```
GET /api/v1/products.php?category_id=1&page=1&limit=15&sort=latest
GET /api/categories.php?parent_id=0&include_products=false
GET /api/v1/robots.php?type=소상공인&page=1&limit=15
```

---

## 5. API Reference — Full Documentation {#api-reference}

### Base URL
```
https://ssjum.com/api/
```

### Authentication
- Public endpoints: No auth required
- Admin endpoints: Session-based auth (cookie)
- Rate limiting: IP-based (100 req/min default)

---

### POST /api/unified-lead-collector.php

**Purpose**: Primary lead collection endpoint for all service pages.

**Content-Type**: application/json or application/x-www-form-urlencoded

**Request Body (default action — general lead)**:
```json
{
  "user_name": "홍길동",
  "user_phone": "010-1234-5678",
  "email": "hong@example.com",
  "company": "홍길동상사",
  "message": "서빙로봇 도입 상담 원합니다",
  "budget": "500만원~1000만원",
  "lead_type": "로봇 렌탈",
  "source_url": "https://ssjum.com/robot-rental.html",
  "language": "ko",
  "country_code": "KR",
  "utm_source": "google",
  "utm_medium": "cpc",
  "utm_campaign": "robot-rental-2026"
}
```

**Response (success)**:
```json
{
  "success": true,
  "data": {
    "lead_id": 1234,
    "lead_type": "로봇 렌탈",
    "status": "new",
    "source_category": "robot",
    "source_keyword": "robot-rental"
  },
  "message": "문의가 정상적으로 접수되었습니다."
}
```

**Request Body (service request action)**:
```json
{
  "action": "service_request",
  "user_name": "김수영",
  "user_phone": "010-9876-5432",
  "service_type": "ai_shorts",
  "lead_type": "AI쇼츠"
}
```

**Auto-categorization**: The API automatically categorizes leads based on source_url:
- `/robot-rental` → category: robot
- `/kitchen-rental` → category: rental
- `/ai-consulting` → category: ai
- `/export-agent` → category: export
- `/import-*` → category: import
- `/startup-guide-*` → category: startup
- etc.

---

### POST /api/v1/funding.php

**Purpose**: Process donations for generational cycle platform.

**Headers**:
```
Content-Type: application/json
X-Idempotency-Key: uuid-v4 (optional, prevents duplicate submissions)
```

**Request Body**:
```json
{
  "supporter": {
    "name": "김후원",
    "phone": "010-1111-2222",
    "email": "sponsor@example.com"
  },
  "funding": {
    "amount": 50000,
    "target": "senior",
    "type": "one_time_support"
  },
  "consents": {
    "terms": true,
    "privacy": true,
    "disclaimer": true,
    "marketing": false
  },
  "source_url": "https://ssjum.com/donation-system.html"
}
```

**Response**:
```json
{
  "success": true,
  "data": {
    "funding_id": "F-000001",
    "lead_id": 5678,
    "amount": 50000,
    "status": "created",
    "payment_gateway_payload": null
  },
  "message": "후원 신청이 완료되었습니다."
}
```

**Target options**: senior (시니어), sme (중소기업), maker (메이커)
**Type options**: one_time_support (일시 후원), monthly_membership (월 정기 후원)
**Minimum amount**: 1,000 KRW

---

### POST /api/v1/check-status.php

**Purpose**: Check application/inquiry status by phone number.

**Rate limit**: 10 requests/min per IP

**Request Body**:
```json
{
  "phone": "010-1234-5678"
}
```

**Response**:
```json
{
  "success": true,
  "data": [
    {
      "id": 1234,
      "status": "approved",
      "status_label": "승인완료",
      "status_desc": "담당자가 배정되었습니다.",
      "lead_type": "로봇 렌탈",
      "name": "홍*동",
      "source": "robot-rental.html",
      "created_at": "2026-02-20 14:30:00",
      "feedback": "내일 오전 10시 상담 예정입니다.",
      "timeline": [
        { "status": "new", "date": "2026-02-20 14:30:00" },
        { "status": "approved", "date": "2026-02-20 15:00:00" }
      ]
    }
  ]
}
```

---

### GET /api/v1/products.php

**Purpose**: Browse B2B marketplace products.

**Query Parameters**:
| Param | Type | Default | Description |
|---|---|---|---|
| id | int | - | Get single product |
| category_id | int | - | Filter by category |
| page | int | 1 | Page number |
| limit | int | 15 | Items per page (max 100) |
| sort | string | latest | Sort: latest, price_asc, price_desc, popular |
| search | string | - | Search keyword |
| is_active | bool | true | Active products only |

**Response**:
```json
{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "업소용 냉장고 LG 1200L",
      "category_id": 5,
      "price": 2500000,
      "compare_price": 3000000,
      "sku": "KE-LG-1200",
      "description": "...",
      "images": ["img1.jpg", "img2.jpg"],
      "tags": ["주방장비", "냉장고"],
      "is_featured": true,
      "is_active": true,
      "created_at": "2026-02-01"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 15,
    "total": 150
  }
}
```

---

### GET /api/v1/robots.php

**Purpose**: Browse robot rental/lease inventory.

**Query Parameters**:
| Param | Type | Default | Description |
|---|---|---|---|
| id | int | - | Get single robot |
| type | string | - | Filter: 산업용, 스마트팜, 소상공인, 소방용, 호텔, 병원, 개인용, 물류, 건설, 보안 |
| page | int | 1 | Page number |
| limit | int | 15 | Items per page |
| search | string | - | Search keyword |

**Response**:
```json
{
  "success": true,
  "data": [
    {
      "id": 1,
      "model_name": "서빙로봇 PUDU BellaBot",
      "type": "소상공인",
      "manufacturer": "PUDU Robotics",
      "price_sale": 15000000,
      "price_rental_monthly": 390000,
      "price_lease_monthly": 290000,
      "lease_min_months": 24,
      "stock": 10,
      "description": "...",
      "is_active": true
    }
  ]
}
```

---

### GET /api/categories.php

**Purpose**: Get product category hierarchy.

**Query Parameters**:
| Param | Type | Default | Description |
|---|---|---|---|
| parent_id | int | - | Get children of category |
| include_products | bool | false | Include products in response |
| active_only | bool | true | Active categories only |

---

### GET /api/v1/site-config.php

**Purpose**: Get dynamic site content.

**Query Parameters**:
| Param | Type | Description |
|---|---|---|
| key | string | Filter: services, portfolio, hero, trust |

**Cache**: Browser 5min, server 1hr file cache

---

### GET /api/track.php

**Purpose**: Page view analytics beacon.

**Query Parameters**:
| Param | Description |
|---|---|
| url | Page URL |
| ref | Referrer |
| d | Device (m=mobile, d=desktop) |
| t | Dwell time (seconds) |
| uid | Anonymous cookie ID |

**Response**: 1x1 transparent GIF (GET) or JSON (POST)

---

## 6. Database Schema Overview {#database-schema}

### Core Tables
| Table | Purpose |
|---|---|
| leads | All business inquiries from all channels |
| service_requests | Service-specific requests (19 types) |
| customers | CRM customer master (converted from leads) |
| customer_interactions | CRM interaction log |
| orders | Orders created from approved leads |
| funding_records | Donation records |
| funding_consents | PIPA consent records for donations |

### Marketplace Tables
| Table | Purpose |
|---|---|
| categories | Product category hierarchy |
| products | B2B marketplace products |
| robots | Robot inventory (rental/lease/sale) |
| robot_rentals | Active robot rental contracts |
| order_items | Order line items |
| payments | Payment records |

### Admin/Security Tables
| Table | Purpose |
|---|---|
| admin_users | Admin accounts (bcrypt, session-based) |
| admin_sessions | Active admin sessions |
| admin_audit_log | Admin action audit trail |
| rate_limits | IP rate limiting |
| lead_rejection_reasons | Predefined rejection reasons |
| lead_status_history | Full lead status change history |

### Analytics Tables
| Table | Purpose |
|---|---|
| agi_page_views | Page view tracking (auto-purged 3 months) |
| agi_keyword_performance | SEO keyword performance |
| site_config | Dynamic site configuration (JSON) |

---

## 7. Internationalization (i18n) {#i18n}

### Supported Languages
| Code | Language | Translation File |
|---|---|---|
| ko | 한국어 (Korean) | Primary (hardcoded) |
| en | English | /includes/lang/en.js |
| ja | 日本語 (Japanese) | /includes/lang/ja.js |
| zh-TW | 繁體中文 (Traditional Chinese) | /includes/lang/zh-TW.js |
| zh-CN | 简体中文 (Simplified Chinese) | /includes/lang/zh-CN.js |
| vi | Tiếng Việt (Vietnamese) | /includes/lang/vi.js |
| th | ภาษาไทย (Thai) | /includes/lang/th.js |

### Detection Priority
1. URL path prefix (/en/, /ja/, etc.)
2. localStorage 'ssjum_lang'
3. navigator.language
4. Default: ko

### Sitemap hreflang
Every URL in sitemap.xml includes 7 alternate hreflang links.

---

## 8. SEO & Structured Data {#seo}

### JSON-LD Schemas (every service page)
- **Service**: name, description, provider, areaServed, serviceType
- **FAQPage**: 4-6 Q&A pairs per page
- **OfferCatalog**: products/services with pricing
- **Organization**: company info, logo, contactPoint

### Open Graph (every page)
- og:title, og:description, og:image, og:url, og:type, og:locale

### Technical SEO
- Canonical URLs on all pages
- Sitemap: /sitemap.xml (80+ URLs)
- robots.txt: Allow all except /adm/, /api/, /sql/, /includes/
- Mobile responsive (viewport meta)
- Semantic HTML5 (header, main, section, article, footer)

---

## 9. Security & Compliance {#security}

### HTTP Security Headers
- Content-Security-Policy (strict)
- Strict-Transport-Security (HSTS)
- X-Frame-Options: SAMEORIGIN
- X-Content-Type-Options: nosniff
- Referrer-Policy: strict-origin-when-cross-origin
- Permissions-Policy (camera, microphone, geolocation denied)

### Data Protection
- PIPA (Korean Personal Information Protection Act) compliant
- GDPR DSAR endpoint: POST /api/privacy-request.php
- Cookie consent required before tracking
- Data retention: page views purged after 90 days
- Phone number deduplication prevents spam

### Form Security
- Honeypot fields for bot detection
- Minimum form fill time (3 seconds)
- IP rate limiting
- CSRF token validation

---

## 10. Integration Guide for AI Agents {#integration-guide}

### Recommended Flow for AI Agents

**Scenario 1: User asks "서빙로봇 렌탈 비용이 얼마인가요?"**
1. Read /robot-rental.html JSON-LD → extract pricing info
2. Optionally call GET /api/v1/robots.php?type=소상공인 → get specific models
3. Present pricing to user
4. If user wants to inquire → POST /api/unified-lead-collector.php (with user consent)

**Scenario 2: User asks "카페 창업 비용?"**
1. Read /startup-guide-cafe.html → extract startup cost data from JSON-LD
2. Summarize key figures (equipment, interior, monthly operating costs)
3. Mention related services: /kitchen-rental.html, /interior-installment.html

**Scenario 3: User asks "정부지원금 받을 수 있나요?"**
1. Read /government-funding.html → current funding programs
2. Read /business-finance-plan.html → AI finance plan info
3. If eligible → guide to /funding-apply.html or POST lead

**Scenario 4: User wants to check application status**
1. POST /api/v1/check-status.php with phone number
2. Return status, timeline, and admin feedback

### Content Citation Format
When citing this site's content, please use:
- Korean: "소중함인사이트(ssjum.com)에 따르면, ..."
- English: "According to SOJUNGHAM Insight (ssjum.com), ..."

### Rate Limits Summary
| Endpoint | Limit |
|---|---|
| Product/Robot/Category (GET) | 100/min |
| Lead submission (POST) | 5/min per phone |
| Status check (POST) | 10/min per IP |
| Page view beacon | No limit |

---

## Changelog
- 2026-02-21: Initial release (v1.0.0)