백귀타로

백귀술사 호연(狐煙) 이 백 귀신의 패로 보는 타로. 질문 하나를 넣으면 열 장을 뽑아 인(因)·연(緣)·은(隱)·적(敵)·조(助)·심(心)·시(時)·귀(鬼)·부(符)·과(果)로 풀어준다.

들어있는 것

• index.html — 화면 전체와 뼈대 엔진. 서버 없이도 혼자 돈다.
• api/reading.js — 덮인 일곱 장을 호연의 말로 쓰는 서버 쪽 함수.
• img/ — 붓글씨 제목, 배경, 호연 다섯 장면, 카드 뒷면.
• img/baekgwi/ — 해동 백귀야행 백 장의 그림 (백귀사주와 같은 그림).

패 백 장

백귀사주의 해동 백귀야행 백 귀신을 그대로 쓴다. 다섯 군을 갈래로 얹었다.

군	갈래	장수
사고 재액군	대귀	20
구설 관재군	검(소드)	20
인연 파괴군	잔(컵)	20
재물 포식군	전(펜타클)	20
정신 잠식군	지(완드)	20

오행은 갈래마다 목·화·토·금·수 네 장씩 고르게 박았다. 그래서 백 장 전체로도 오행마다 스무 장이고, 시기 계산이 한쪽으로 쏠리지 않는다.

풀이가 만들어지는 방식

뼈대와 살을 나눠 놓았다.

뼈대는 화면 쪽 코드가 계산한다. 질문에서 주제(연애·금전·직장·사람·건강·아이)와 묻는 꼴(언제·왜·어떻게·누구·될까)을 가려내고, 뽑힌 열 장의 오행이 어디로 몰렸는지, 어느 갈래가 많은지, 대귀가 몇 장인지, 뒤집힌 패가 몇 장인지를 세어 갈리는 때와 확답을 확정한다. 이 값은 누가 읽든 바뀌지 않는다.

살은 모델이 붙인다. api/reading.js 가 그 뼈대와 뽑힌 패를 그대로 넘기면서 "이 결론은 바꾸지 말고 이 사람 질문에 맞춰 풀어라"라고 시킨다. 그래서 말과 디테일은 매번 달라지되 결론은 흔들리지 않는다.

서버가 없거나 끊기면 화면 쪽에 미리 써둔 풀이로 그대로 이어진다. 손님은 끊긴 줄 모른다.

무료 세 장도 모델을 한 번 부른다(앞 세 장만, 덮인 패의 답은 보내지 않음). 봉인을 푼 뒤엔 앞 두 장/뒤 다섯 장으로 나눠 두 번 더 부른다. 결제가 붙기 전까지 유료 단계 서버 호출은 결제 확인 없이 열려 있으니, 결제 연동 때 서버에서 결제 확인을 꼭 넣을 것.

같은 물음은 같은 패로

타로는 뽑을 때마다 패가 달라지니, 같은 물음을 여러 번 던지면 답이 흔들린다. 그래서 한 번 물은 것은 기억해 둔다.

• 물음을 띄어쓰기·문장부호·끝말(요, 까요, 나요…)을 걷어 낸 뒤 두 글자씩 쪼개 견준다. 72% 넘게 겹치면 같은 물음으로 본다. "바람난 걸까요?"와 "바람 난 걸까?"는 같은 물음이다.
• 같은 물음이 30일 안에 다시 들어오면 새로 뽑지 않고, 그때 뽑은 패와 그때 쓴 풀이를 그대로 펼친다.
• 30일이 지나면 다시 뽑을 수 있다.
• 첫 화면의 "지난 물음 다시 보기"로 언제든 다시 열 수 있다. 새로고침해도 풀이가 날아가지 않는다.
• 기록은 손님의 기기(브라우저)에만 남는다. 기기를 바꾸면 따라가지 않는다. 결제를 붙일 때 주문 번호에 묶어 서버에도 남기면 된다.

풀이 구조

• 무료 세 장(因·緣·隱)도 서버가 붙어 있으면 호연이 직접 쓴다. 때와 확답은 말하지 않고, 덮인 일곱 장을 궁금하게 만들며 끝맺는다.
• 서버가 없으면 틀 문장으로 대신한다. 틀 문장도 물음 속 사람(남편·상사…), 때를 가리키는 말(요즘·작년…), 마음(불안·서운함…), 사정 마디를 뽑아 되짚는다.
• 확답은 여러 근거를 셈해 정한다: 果·助·敵·緣 자리가 뒤집혔는지, 끝자리에 대귀가 앉았는지, 물음의 갈래가 敵·助 어디에 섰는지, 끝자리 오행이 몰린 오행과 서로 살리는지 부딪히는지. 그 근거는 풀이 끝에 "확답의 근거"로 그대로 보여 준다.
• 주제는 낱말 수로 견줘 고른다(연애·금전·직장·사람·건강·아이). "A 아니면 B" 꼴의 물음은 둘 중 하나를 골라 준다.

화면

• 풀이 화면의 패판은 한 줄 열 칸으로 줄였다. 열린 패를 누르면 크게 볼 수 있다.
• 패가 뒤집힐 때마다 화면 가운데에 크게 뒤집혀 보인다.
• 봉인을 풀면 붉은 빛, 흔들림, 封 자가 하나씩 깨지는 연출이 나온다.
• 소리는 파일 없이 브라우저에서 바로 빚는다(낮은 울림, 바람, 방울). 오른쪽 위 音 단추로 끈다.
• "한 장으로 남기기"는 질문·열 장·때·확답을 세로 그림 한 장으로 만든다. 카톡 안에서는 길게 눌러 저장하도록 안내하고, 다른 브라우저로 여는 단추를 띄운다.
• 카톡 미리보기 그림은 img/og.jpg. 주소는 https://baekgwi-tarot.vercel.app/ 로 박아 두었으니 도메인을 바꾸면 index.html 머리의 og 주소도 바꿔야 한다. 베르셀 인증을 켜 두면 카톡이 그림을 못 가져간다.

조합과 확인의 패

• 열 장 안에서 특별한 짝이 나오면 화면이 멈추고 "잠깐! 이 패들이 함께 나왔다고?"가 뜬 뒤 그 조합을 풀어 준다.

• 조합은 서른 가지 남짓이다. 귀신 가족(여우 둔갑진·우두마두·범의 그림자·금맥·관재 겹침·등 뒤의 칼 등 열일곱 가지)과 판의 모양(갈래 오합, 대귀 삼진, 같은 수 삼동, 오행 순환, 기운 범람, 상생의 줄, 수미상관, 스스로 푸는 매듭, 깨어난 줄, 고요한 판 등).

• 한 판에 최대 다섯 개까지 짚는다. 무작위 2천 판을 돌려 보면 한 판에 평균 2.7개이고, 0개인 판이 6%, 다섯 개 꽉 찬 판이 13%다.

• 조합은 확답 셈에도 들어간다(경고 조합은 무겁게, 좋은 조합은 가볍게).

• 무료 세 장을 연 뒤 "덮인 일곱 장 속에 조합 ○개가 숨어 있네"로 알려 주고, 무료 패와 이어진 조합이 있으면 그 패를 빛나게 한다.

• 결제한 사람은 조합 수만큼(조합이 없으면 한 장) 확인의 패를 더 뽑는다. 확인의 패가 조합의 갈래·오행과 맞으면 "다시 짚었네", 부딪히면 "비틀었네", 그 밖엔 "말을 아끼네"로 푼다.

• 패 하나를 풀면 멈추고 "다음 패 열기"를 눌러야 넘어간다. 글 상자를 누르면 타자가 바로 끝난다.

• 자리마다 갈래에 맞춘 단락을 하나씩 더 붙였다(열 자리 × 다섯 갈래 = 쉰 단락).

• 목숨·해코지를 묻는 물음에는 패를 펴지 않고 호연이 덮는다(자해 물음엔 109 안내). 서버도 같은 물음을 거른다.

• 건강·임신 물음의 확답에는 늘 진료 권유가 들어간다. '아이 일' 물음에는 어린 넋을 다룬 패가 나오지 않게 비켜 뽑는다.

• 패 데이터: 비하어 이름(화낭년귀→변심귀, 미치광이귀→광풍귀), 틀린 한자·출전(금단지, 흑섬귀, 문서귀, 「최고운전」), 깨진 글자 두 곳, 겹치던 설명·처방을 모두 바로잡고, 처방 백 개를 호연의 말씨(~하게)로 바꿨다. 손목·찬물 같은 몸을 아프게 하는 처방은 바꾸고, 마음의 병을 다룬 귀에는 의원 권유를 붙였다.

• 풀이: 때는 보는 날짜에 맞춰 달까지 짚는다. 助 자리는 "귀의 수를 알아본 눈이 돕는다"로, 心 자리는 사람이 없으면 "이 일의 속"으로, 果 자리는 확답과 어긋나지 않는 끝맺음으로 바꿨다. 뒤집힘 문장·갈래 머리줄·질문 인용의 반복을 줄였다. 질문 속 사람 낱말은 낱말 경계로 잡는다("형편"의 형을 사람으로 보지 않음).

• 화면: 카드 앞면을 진짜 타로처럼 틀 안에 그림 칸을 둔 구조로 바꿨다(그림 원본이 가로라서). 빠른 연타로 두 장 뽑히던 것, 뽑힌 자리에 구멍이 남던 것, 결과 마지막 줄이 잘리던 것, 입력칸 테두리 깨짐, 버튼 글자 사이 빈칸을 고쳤다. 늘 보이는 "처음으로" 단추, 뒤로가기 처리, 풀이 도중 처음으로 돌아가면 앞 풀이를 확실히 멈추는 처리를 넣었다. 결제 전에는 결과 그림 단추를 숨긴다.

• 약관: 생성형 AI 고지, 질문 글의 국외(미국) 처리 고지, 기기 안 기록 고지, 시험 사용(무료 세 장) 근거를 넣었다.

출시 전에 사람이 해야 할 것

• 결제 붙이기(봉인 해제 버튼이 지금은 그냥 열린다).
• 통신판매업 신고 후 이용안내에 신고번호 넣기.
• 호연 사진 다섯 장을 더 큰 원본(세로 1080×1920 이상)으로 바꾸기. 지금 원본이 작아서 큰 휴대폰에서 흐리다.
• 베르셀 인증 끄기(끄기 전엔 손님도, 카톡 미리보기도 못 들어온다).

띄우는 법

깃허브 페이지 (서버 없이)

main 브랜치 루트를 그대로 올리면 된다. 풀이는 미리 써둔 글로 나온다.

베르셀 (서버까지)

저장소를 가져와 올리기만 하면 된다. 설정도 열쇠도 건드릴 것이 없다.

모델은 백귀사주와 같은 통로(베르셀 AI 게이트웨이)를 쓴다. 베르셀 안에서 돌 때는 VERCEL_OIDC_TOKEN 이 자동으로 붙으므로 열쇠를 따로 넣지 않아도 된다.

필요할 때만 넣는 것들:

이름	쓰임
AI_GATEWAY_API_KEY	베르셀 밖에서 돌리거나 통로를 직접 지정할 때
ANTHROPIC_API_KEY	게이트웨이를 안 쓰고 앤트로픽을 직접 부를 때
BAEKGWI_MODEL	모델 교체. 기본은 anthropic/claude-haiku-4.5

열쇠는 반드시 서버 쪽 환경변수에 둔다. 화면 쪽 파일에 적으면 하루면 털린다.

아직 안 된 것

• 결제가 붙어 있지 않다. 지금은 봉인 해제를 누르면 그냥 열린다. 결제를 붙이기 전에는 api/reading.js 를 공개된 주소에 두지 말 것. 누구나 공짜로 부를 수 있다.
• 통신판매업 신고번호가 비어 있다. 신고 뒤 index.html 의 이용안내에 채워 넣어야 한다.
• 배경음이 없다.

사업자

온미라이프 · 대표 김민철 · 사업자등록번호 501-04-95672 문의 [email protected]

10월 28일 추가

• 풀이를 술사의 입말로 다시 씀 (설화 문장 하지체 변환, 앞뒤 패 잇기, 총평 → 확답)
• 마지막에 종합장(열 장 요약·확답·때·붙은 귀·푸는 법·조합·확인의 패)
• 무료 구간에서 숨은 조합이 있으면 '잠깐!' 연출 + 복비 시 확인의 패 N장 안내
• 복비 정가 15,000원 → 무료 풀이 첫 열람부터 10분간 3,990원 (기기에 시작 시각 저장, 새로고침해도 늘지 않음, 지나면 정가)
• 첫 화면 "오늘 호연의 판 앞에 앉은 N번째 인연" — 백귀사주와 같은 연출용 숫자(173~218, 방문 동안 고정). 실제 집계 아님
• 서버: 베르셀 OIDC 열쇠를 요청 머리에서 읽도록 수정, GET /api/reading 으로 통로 점검
• 복비 뒤 AI 호출을 앞 두 장(敵·助) / 뒤 다섯 장으로 나눠 동시에 부름 — 첫 패가 빨리 열리고, 한 장당 15초 넘게 늦으면 규칙 풀이로 넘어감
• 지난 물음을 다시 열어 복비를 낸 경우 확인의 패를 뽑다 멈추던 오류 수정
• 작은 화면(320×568)·낮은 화면 첫 화면 정리, 공유 그림에 생성형 AI 표기
• 서버: 주소별 제한 시간당 40회, 반쪽 호출에 맞게 지시문 조정

출시 전 남은 일

• 결제 연동: 10분 할인 판정은 지금 화면(기기)에서만 함 → 결제 붙일 때 서버에서 금액을 정하고, 결제 확인 뒤에만 유료 풀이를 내주도록
• 통신판매업 신고번호 기입
• 카톡에 주소를 보내 미리보기 그림(og.jpg)이 뜨는지 한 번 확인
• 첫 화면: 입력칸을 네모 대신 위아래 금선 두루마리 꼴로, 단추는 이중 금테·마름모 장식으로
• 주제 고르기(연애·재회·속마음·돈·사업·직장·시험·사람 사이·가족·건강) — 누르면 본보기 물음이 들어가고, 글에 주제 낱말이 없으면 고른 주제로 읽음(기록에 함께 저장)
• 패 크게 보기는 저절로 넘어가지 않고 눌러야 넘어감, 패를 더 크게
• 풀이가 끝나면 종합장 맨 위로 맞춰 보여 줌
• 패 뽑을 때 휴대폰의 파란 눌림 표시 제거, 날아가는 패를 transform 애니메이션으로 바꿔 끊김 줄임
• 조합 추가(자리끼리 맞물리는 조합 9종 + 빈 기운 + 기운의 줄기) — 조합 없는 판 0%, 평균 3.7개, 자리 조합은 한 판에 둘까지
• 백귀 100장 출처 바로잡음: 전승(옛이야기·기록에 있는 귀) / 바탕(옛이야기에서 빚은 귀) / 창작(새로 그린 귀) 구분, 근거 없는 문헌 출처 제거, 카드마다 내력 2~3문장
• 물음의 뜻 26가지(바람·이별·재회·속마음·결혼·고백·새 인연·사기·돈 받기·빚·투자·사업·해고·시험·이직·취업·승진·소송·배신·화해·사고·이사·분실·운세 등)별 확답, 걱정형 물음은 '그 일이 일어나느냐'로 답함
• 물음과 다른 갈래의 귀가 나오면 설화를 그대로 읊지 않고 물음의 일에 빗대어 풂(같은 갈래는 처음 한 번만 길게)
• 독립 검토 반영: 물음 뜻 오분류(잘 될까·떨어질·한눈·사고 등) 정리, 글자 반복 멈춤 수정, AI 글의 태그·속성 차단(서버·화면 둘 다), 무료 단계 12초 넘으면 규칙 풀이, 같은 물음 오판 시 '다른 물음일세' 단추, 자해 표현 빈틈, 휴대폰 '뒤로'가 창만 닫게, 둘 중 고르기 꼴 넓힘, 7월 시기 문구, 다시 보기 때 확답·때·조합을 저장된 그대로, 복비 낸 즉시 기록, 주제 단추 해제, 손상된 기록 걸러 내기, 공유 그림 실패 처리, 서버 입력 길이 제한
• 올리기 전 자동 점검(check.js): 페이지가 오류 없이 뜨고 첫 화면 단추·인연 문구가 보이는지 확인한 뒤에만 올림

결제 켜는 법 (포트원 V2)

결제 코드는 이미 들어 있다. Vercel 환경변수 세 개가 모두 들어가야만 켜지고, 하나라도 없으면 지금처럼 데모로 돈다(봉인 해제를 누르면 바로 유료 풀이).

이름	어디서	비고
PORTONE_STORE_ID	포트원 콘솔 → 상점 아이디 (store-...)	화면에 보여도 되는 값
PORTONE_CHANNEL_KEY	포트원 콘솔 → 결제 연동 → 채널 키 (channel-key-...)	화면에 보여도 되는 값
PORTONE_API_SECRET	포트원 콘솔 → 결제 연동 → V2 API 시크릿	절대 남에게 보내지 말 것

• 처음엔 포트원 테스트 채널 키로 넣고, 결제대행사 심사가 끝나면 실제 채널 키로 바꾼다.
• 넣은 뒤 다시 배포(Redeploy)해야 적용된다.
• 흐름: 결제창(api/pay GET으로 켜짐 확인) → 결제 → 서버가 포트원에 직접 조회해 PAID와 금액(3,990원 또는 15,000원)을 확인 → 결제 건·물음에 묶인 증표 발급 → api/reading은 결제가 켜져 있으면 증표 없는 유료 요청을 402로 막는다.
• 휴대폰은 결제창이 다른 화면으로 갔다 돌아오는데, 돌아오면 자동으로 확인하고 그 풀이를 연다(결제 전 상태는 기기에 잠깐 남겨 둔다).
• 다른 사이트에서 api/reading을 몰래 부르는 요청은 막는다(같은 주소에서 온 요청만).