개인 정보 · 사진 KV 자동 등록
MIDMEAL (미드밀) 기본 골격(배너·전문 컨설팅 6분야·하단 신청하기)은 그대로 유지하고, 개인 사진 · 성함 · 전화걸기 · 문자하기 · 카톡하기 · 오시는길 정보만 개인별로 등록합니다. 등록 즉시 전용 주소(?id=개인ID)와 사진 URL(/api/photo/개인ID)이 자동 생성됩니다.
https://midmeal.pages.dev/?id=hong
등록된 개인 명함 목록 (0명)
등록된 개인을 클릭해 실시간 미리보기, 정보 수정, 전용 링크 복사, 삭제를 바로 할 수 있습니다.
MIDMEAL (미드밀) Cloudflare KV 구조 & 사용 설명서
하나의 midmeal.pages.dev 템플릿으로 수백 명의 개인 명함을 관리하고, 사진까지 자동 등록·노출하는 Cloudflare Pages Functions + KV 구조입니다.
1. KV 네임스페이스 바인딩 정보
| 항목 | 설정 값 |
|---|---|
| Cloudflare Pages 프로젝트 | midmeal (https://midmeal.pages.dev) |
| KV 바인딩 변수명 (Variable name) | MIDMEAL_KV |
| KV Namespace ID | bf419d522ccd44f899a8ca696c1b90e1 |
| 개인 정보 저장 키 | card:<개인ID> (JSON + 목록용 metadata) |
| 개인 얼굴 사진 저장 키 | photo:<개인ID> (이미지 바이너리 · /api/photo/<개인ID>) |
| 상단 전체 이미지 저장 키 | banner:<개인ID> (선택 · 미등록 시 기본 배너 사용 · /api/banner/<개인ID>) |
| 개인 명함 접속 URL | https://midmeal.pages.dev/?id=<개인ID> |
2. 사진 자동 등록 동작 방식
- 개인 명함 KV 등록 탭에서 개인 고유 ID(예:
hong), 사진 파일, 이름, 휴대전화(전화걸기·문자하기), 카카오톡 링크(카톡하기), 주소(오시는길)를 입력합니다. - KV에 개인정보 + 사진 자동 등록 버튼을 누르면 브라우저가 사진을 800px로 자동 최적화한 뒤
POST /api/cards로 전송합니다. - 서버(Cloudflare Pages Functions)가 사진 바이너리를
photo:hong에 자동 저장하고, 프로필 이미지 경로를/api/photo/hong?v=타임스탬프로 자동 연결한 뒤 개인 정보를card:hong에 저장합니다. - 발급된
https://midmeal.pages.dev/?id=hong링크로 접속하면 MIDMEAL (미드밀) 기본 골격(배너·전문 컨설팅 6분야·하단 신청하기)에 해당 개인의 사진·전화·문자·카톡·지도 정보가 즉시 자동 반영됩니다. - 카카오톡으로 개인 링크를 공유해도 미들웨어(
functions/_middleware.js)가og:title·og:description은 개인 정보로,og:image는 미드밀 공식 OG 이미지로 자동 적용합니다.
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 → midmeal → Settings → Variables and Secrets에서 ADMIN_KEY 환경변수를 추가하면, 관리자 키 입력 시에만 등록/삭제가 허용됩니다.
기본 골격 배너 및 샘플 프로필 이미지
?id= 없이 접속했을 때 보이는 기본 템플릿 화면의 배너와 샘플 프로필 이미지입니다.
기본 골격 텍스트
기본 템플릿 연락처 & 지도 설정
비워둔 항목은 정보 카드에서 자동으로 숨겨집니다.
전문 컨설팅 분야 (총 6개 고정)
홈페이지에 2×3 고정 그리드로 표시되며, 각 카드 클릭 시 상세 본문과 상담 신청 버튼이 열립니다.
주문서 / 템플릿 JSON 불러오기
주문서_편집원본_AGS-*.json 파일이나 기존에 내보낸 템플릿 설정 JSON을 업로드하면 이름, 직책, 연락처, 주소 등이 즉시 자동 반영됩니다.
여기를 클릭하거나 JSON 파일을 끌어다 놓으세요
지원 형식: 주문서_편집원본_*.json / 템플릿 설정 .json템플릿 내보내기 & 초기화
현재 편집한 내용을 JSON 백업으로 저장하거나 배포용 단일 HTML 파일로 내려받을 수 있습니다.