삼성화재 RC 디지털 명함 KV 다중 설계사 등록 · samsungfire.pages.dev 저장됨
기본 명함 열기
SAMSUNGFIRE_KV 연결 상태 확인 중...

삼성화재 설계사(RC) 개인 정보 · 얼굴 사진 KV 자동 등록

삼성화재 공통 명함 골격(프리미엄 배너·6대 핵심 보장 컨설팅·하단 무료 보장분석 신청)은 동시에 하나의 파일을 공유하고, 설계사별 얼굴 사진 · 성함 · 직책 · 전화걸기 · 문자하기 · 카톡하기 · 오시는길 정보만 KV에 등록합니다. 등록 즉시 전용 주소(?id=설계사ID)와 사진 URL(/api/photo/설계사ID)이 자동 생성됩니다.

발급 주소: https://samsungfire.pages.dev/?id=hong
상단 전체 이미지 미리보기
등록하지 않으면 삼성화재 기본 상단 배너 이미지가 자동으로 적용됩니다.
설계사 사진 미리보기
사진을 선택하면 자동으로 최적화(800px)되어 KV에 함께 등록됩니다.

등록된 삼성화재 설계사 명함 목록 (0명)

등록된 설계사를 클릭해 실시간 미리보기, 정보·사진 수정, 전용 링크 복사, 삭제를 바로 할 수 있습니다.

목록을 불러오는 중입니다...

삼성화재 Cloudflare KV 다중 사용자 구조 & 사용 설명서

단 하나의 samsungfire.pages.dev 템플릿 파일로 수백 명의 삼성화재 설계사(RC) 명함을 동시에 운영하고, 얼굴 사진과 연락처를 개인별로 자동 노출하는 Cloudflare Pages Functions + KV 구조입니다.

1. KV 네임스페이스 바인딩 정보

항목 설정 값
Cloudflare Pages 프로젝트 samsungfire (https://samsungfire.pages.dev)
KV 바인딩 변수명 (Variable name) SAMSUNGFIRE_KV
KV Namespace ID 5f28e2eb4f374875a1fcd5f188a0c92c
설계사 정보 저장 키 card:<설계사ID> (JSON + 목록용 metadata)
설계사 얼굴 사진 저장 키 photo:<설계사ID> (이미지 바이너리 · /api/photo/<설계사ID>)
상단 전체 배너 저장 키 banner:<설계사ID> (선택 · 미등록 시 기본 배너 사용 · /api/banner/<설계사ID>)
설계사 명함 접속 URL https://samsungfire.pages.dev/?id=<설계사ID>

2. 여러 설계사가 같은 파일을 공유하는 동작 원리

  1. 설계사 명함 KV 등록 탭에서 설계사 고유 ID(예: hong, kim_rc), 얼굴 사진 파일, 성함, 직책, 휴대전화, 카카오톡 링크, 지점 주소를 입력합니다.
  2. KV에 설계사 정보 + 사진 자동 등록 버튼을 누르면 브라우저가 사진을 800px로 최적화한 뒤 POST /api/cards로 전송합니다.
  3. 서버(Cloudflare Pages Functions)가 사진 바이너리를 photo:hong에 저장하고, 프로필 이미지 경로를 /api/photo/hong?v=타임스탬프로 자동 연결한 뒤 설계사 정보를 card:hong에 저장합니다.
  4. 발급된 https://samsungfire.pages.dev/?id=hong 링크로 접속하면 공통 템플릿 파일(index.html)의 6대 핵심 보장 컨설팅은 그대로 공유하면서, 해당 설계사의 얼굴 사진·이름·전화·문자·카톡·지점 지도가 즉시 렌더링됩니다.
  5. 카카오톡으로 개인 링크를 공유하면 미들웨어(functions/_middleware.js)가 og:title·og:description은 해당 설계사 정보로, og:image는 삼성화재 공식 OG 이미지(/media/og-samsungfire.jpg)로 자동 적용합니다.

3. API 엔드포인트 명세

Method & Path 설명
GET /api/cards KV에 등록된 전체 설계사 명함 목록 조회
POST /api/cards 설계사 정보 + 사진 자동 등록/수정 (JSON 또는 multipart/form-data 지원)
GET /api/cards/:id 특정 설계사 ID의 명함 JSON 조회
DELETE /api/cards/:id 설계사 정보(card::id), 사진(photo::id), 배너(banner::id) 동시 삭제
GET /api/photo/:id KV에 저장된 설계사 프로필 사진 바이너리 직접 서빙
GET /api/banner/:id KV에 저장된 설계사 커스텀 상단 배너 이미지 바이너리 직접 서빙

4. 보안 설정(선택) & 재배포 명령어

외부에서 임의로 등록/삭제하지 못하도록 Cloudflare Dashboard → Workers & Pages → samsungfire → Settings → Variables and Secrets에서 ADMIN_KEY 환경변수를 추가하면, 관리자 키 입력 시에만 등록/삭제가 허용됩니다.

wrangler pages deploy . --project-name samsungfire --branch main

기본 골격 배너 및 샘플 프로필 이미지

?id= 없이 접속했을 때 보이는 기본 템플릿 화면의 배너와 샘플 프로필 이미지입니다.

배너 미리보기
프로필 미리보기

기본 골격 텍스트

고객 배포용으로 사용할 때는 끌 수 있습니다.

기본 템플릿 연락처 & 지도 설정

비워둔 항목은 정보 카드에서 자동으로 숨겨집니다.

삼성화재 핵심 컨설팅 분야 (총 6개 고정)

홈페이지에 2×3 고정 그리드로 표시되며, 각 카드 클릭 시 상세 본문과 상담 신청 버튼이 열립니다.

주문서 / 템플릿 JSON 불러오기

주문서_편집원본_AGS-*.json 파일이나 기존에 내보낸 템플릿 설정 JSON을 업로드하면 이름, 직책, 연락처, 주소 등이 즉시 자동 반영됩니다.

여기를 클릭하거나 JSON 파일을 끌어다 놓으세요

지원 형식: 주문서_편집원본_*.json / 템플릿 설정 .json

템플릿 내보내기 & 초기화

현재 편집한 내용을 JSON 백업으로 저장하거나 배포용 단일 HTML 파일로 내려받을 수 있습니다.

저장되었습니다.