삼성화재 설계사(RC) 개인 정보 · 얼굴 사진 KV 자동 등록
삼성화재 공통 명함 골격(프리미엄 배너·6대 핵심 보장 컨설팅·하단 무료 보장분석 신청)은 동시에 하나의 파일을 공유하고, 설계사별 얼굴 사진 · 성함 · 직책 · 전화걸기 · 문자하기 · 카톡하기 · 오시는길 정보만 KV에 등록합니다. 등록 즉시 전용 주소(?id=설계사ID)와 사진 URL(/api/photo/설계사ID)이 자동 생성됩니다.
https://samsungfire.pages.dev/?id=hong
등록된 삼성화재 설계사 명함 목록 (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. 여러 설계사가 같은 파일을 공유하는 동작 원리
- 설계사 명함 KV 등록 탭에서 설계사 고유 ID(예:
hong,kim_rc), 얼굴 사진 파일, 성함, 직책, 휴대전화, 카카오톡 링크, 지점 주소를 입력합니다. - KV에 설계사 정보 + 사진 자동 등록 버튼을 누르면 브라우저가 사진을 800px로 최적화한 뒤
POST /api/cards로 전송합니다. - 서버(Cloudflare Pages Functions)가 사진 바이너리를
photo:hong에 저장하고, 프로필 이미지 경로를/api/photo/hong?v=타임스탬프로 자동 연결한 뒤 설계사 정보를card:hong에 저장합니다. - 발급된
https://samsungfire.pages.dev/?id=hong링크로 접속하면 공통 템플릿 파일(index.html)의 6대 핵심 보장 컨설팅은 그대로 공유하면서, 해당 설계사의 얼굴 사진·이름·전화·문자·카톡·지점 지도가 즉시 렌더링됩니다. - 카카오톡으로 개인 링크를 공유하면 미들웨어(
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 환경변수를 추가하면, 관리자 키 입력 시에만 등록/삭제가 허용됩니다.
기본 골격 배너 및 샘플 프로필 이미지
?id= 없이 접속했을 때 보이는 기본 템플릿 화면의 배너와 샘플 프로필 이미지입니다.
기본 골격 텍스트
기본 템플릿 연락처 & 지도 설정
비워둔 항목은 정보 카드에서 자동으로 숨겨집니다.
삼성화재 핵심 컨설팅 분야 (총 6개 고정)
홈페이지에 2×3 고정 그리드로 표시되며, 각 카드 클릭 시 상세 본문과 상담 신청 버튼이 열립니다.
주문서 / 템플릿 JSON 불러오기
주문서_편집원본_AGS-*.json 파일이나 기존에 내보낸 템플릿 설정 JSON을 업로드하면 이름, 직책, 연락처, 주소 등이 즉시 자동 반영됩니다.
여기를 클릭하거나 JSON 파일을 끌어다 놓으세요
지원 형식: 주문서_편집원본_*.json / 템플릿 설정 .json템플릿 내보내기 & 초기화
현재 편집한 내용을 JSON 백업으로 저장하거나 배포용 단일 HTML 파일로 내려받을 수 있습니다.