월하명감 코덱스 종합검수서

월하명감 종합 정밀 검수 결과 요약

Codex CLI(gpt-6.1-sol, 추론 강도 xhigh 최대치)로 읽기 전용 정밀 감사를 수행한 결과입니다. 파일 변조 없이 코드·실제 렌더 화면·합성 입력 재현으로 확인된 항목만 정리했습니다.

코드 반영 현황 (v11.91) 전체 10항목 + 디자인 8항목(총 18항목) 및 만세력·대운연동표·즉답기 코드 반영 완료 — 실결제 PG 가맹점 키 발급 후 환경변수 연결만 남음
검수 방식 및 범위 읽기 전용 정밀 감사 (소스 해시 불변 확인) · 트랙 1: 결제·권한·퍼널·PDF·카탈로그 전체 구조 / 트랙 2: 모바일·PC 8개 실화면 및 CSS·PDF 디자인 해부
1. 전체적인 것 판정 공개 유료 출시 준비도 42 / 100 (P0 수정 전 실결제 오픈 보류 권고) — 일반 리포트 결제 검증·서명 PDF 등 기본 뼈대는 갖춰졌으나, 유료 생활도구 2종 무결제 해금(P0-01), CRM 구독 연락처 덮어쓰기(P0-02), PortOne 모바일 복귀 누락(P0-03), 자동 해금 독립 플래그(P0-04) 수정이 선행되어야 합니다.
2. 디자인적인 것 판정 일러스트 자산은 우수하나 UI 장식 누적이 고급스러움을 깎는 상태 — index.html의 절제 규칙을 뒤이어 로드되는 CSS가 다시 둥근 카드·네이비 박스·금색 라벨·과대 붓글씨로 덮어쓰고 있으며, 구매 후 웹 열람실이 책 지면이 아닌 중첩 대시보드 카드처럼 보입니다.

1. 전체적인 것 — 코드 수정 우선순위 Top 10

완료 10 / 10
완료 코드 구분 수정 항목 및 대상 위치 확인된 결함 내용 및 해결 기준
O-01 P0 필수
유료 이름풀이·택일을 서버 결제·권한 체계에 편입
index.html:5631, server.py:3707
현재 util_name_harmony·util_taekil이 PG 결제 없이 로컬 unlockPaidUtility()로 즉시 열리며 서버도 무인증으로 전체 결과를 반환함. 일반 리포트와 동일한 서버 주문·PG 승인·세션 해금 검사를 적용.
O-02 P0 필수
CRM 기존 고객 조회·연락처 변경에 소유 확인 적용
wolha_crm_and_kakao.py:495, server.py:4798
공개 /api/crm/subscribe에 타인의 이메일·전화번호만 보내도 기존 고객 프로필이 덮어써지고 subToken이 반환됨. 신규 가입과 기존 변경을 분리하고 토큰 또는 OTP 소유 검증을 강제.
O-03 P0 필수
운영 플래그(AUTO_UNLOCK)·PG 필수값·공개 URL 시작 시 검증
server.py:123, wolha_tab4_payment_tracking.py:1049
WOLHA_BETA_MODE=0이어도 WOLHA_BETA_AUTO_UNLOCK=1이 남으면 유료 본문이 공짜로 열림. 운영 모드에서는 우회 플래그·불완전 PG 설정·localhost 공개 주소 fallback을 즉시 차단.
O-04 P0 필수
PortOne 모바일 리다이렉트 복귀 및 서버 주문 기반 결제 완료 통합
wolha_tab4_payment_tracking.js:549, wolha_tab4_payment_tracking.py:1519
PortOne.requestPayment()에 redirectUrl 및 모바일 복귀 처리가 없고, Toss 복귀도 단일 localStorage 슬롯에 의존함. 서버 주문을 기준으로 복귀·웹훅·환불 동기화를 일원화.
O-05 P1 권장
상세·결제창·PG 요청 금액 단일화 및 영속 지갑 통합
wolha_jangseogak_v9.js:1611, wolha_tab4_payment_tracking.py:569
상세 화면(복돈 5,000원 전액 차감 32,400원), 결제창(한도 3,000원 적용 34,400원), 서버 지갑(0원 시 37,400원) 표시 금액 불일치 해소 및 세션 적립금의 인증 지갑 이전 연결.
O-06 P1 권장
PDF 캐시 키에 결과 revision·타로·상대·가족·펫 반영 및 타로 PDF 스키마 통일
munhak_dynamic_pdf_builder.py:1810, 2569, server.py:4107
동일 명식에서 타로 카드·궁합 상대·가족·펫이 바뀌어도 이전 캐시 PDF가 반환되는 결함 수정, 타로 PDF의 posLabel/coreMsg/isReversed 누락 수정.
O-07 P1 권장
구매 복구 조회 시 전역 250건 선제한 제거
wolha_crm_and_kakao.py:879
서비스 전체 최근 250개 세션을 먼저 자른 뒤 전화번호를 찾아 누적 주문 250건 이후 구매 복구가 막히는 쿼리를 고객 연락처·주문 기준 직접 조회로 수정.
O-08 P1 권장
보관함 프로필 고유 ID·입력 해시 적용 및 가족·펫 날짜 엄격 검증
index.html:7082, 8450, server.py:2966
상품ID__이름 키 충돌로 생년월일 수정 후에도 예전 결과를 재사용하는 문제와, 가족·펫의 잘못된 날짜(2024-02-31)가 1982-10-10으로 조용히 대체되는 문제 수정.
O-09 P1 권장
조간운세 토큰 URL 정제·개인 후기 쿠폰 소유권·개인정보 삭제 정책 일치
wolha_tab4_payment_tracking.js:16, v9_backend_services.py:1285, index.html:5933
분석 URL에서 daily_sub 토큰 제거, 공개 쿠폰 목록에서 타인의 개인 후기 보상 코드 분리, 안내문과 실제 서버 보관·삭제·외부 API 처리 정책 일치.
O-10 P1 권장
제외 17종 신규 생성 차단·오류 응답 복구·자동 생성 후기 문구 및 단과 중복 정비
server.py:2496, 3057, index.html:8416, wolha_prose_and_verticals.py:1185
비활성 17종 직접 호출 차단, API 오류 JSON 수신 시 무한 멈춤 방지, 19종 자동 생성 문구의 '실제 열람 고객 후기' 표기 제거, 재물운·부동산운 등 중복 문단 분리.

2. 디자인적인 것 — 체감 고급스러움 최우선 수술 Top 8

완료 8 / 8
완료 코드 우선순위 수술 항목 및 대상 셀렉터 걷어낼 AI·과장 요소 및 교정 기준
D-01 최우선
CSS 중복 덮어쓰기(!important) 단일 기준 정리
index.html:4697, wolha_original_engine.css:93, 3865
index.html의 직각·백색 절제 규칙 위에 wolha_original_engine.css가 다시 22px 둥근 카드·그림자·그라데이션을 덧칠하는 이중 구조를 단일 디자인 토큰으로 통합.
D-02 최우선
맞춤 추천 패널의 네이비·골드 외피 및 0/60 도감 명패 제거
wolha_tab2_benchmark_ui.css:13-99, wolha_tab2_benchmark_ui.js:172
#0E1B2E 네이비 그라데이션 박스, 금색 CURATED INDEX 영문 라벨, 육십갑자 0/60 수집 버튼을 걷어내고 조용한 흰 지면과 단정한 선택 버튼으로 교체.
D-03 최우선
웹 열람실(리더)을 대시보드 카드 중첩에서 연속 백색 책 지면으로 재편집
wolha_jangseogak_v9.css:2985-3760, wolha_tab2_benchmark_ui.css:129-207
거대한 네이비 표지 카드(.hero), 반투명 요약 박스(.hero-lead), CHAPTER DIGEST 3줄 요약 카드 중첩과 중복 문장을 걷어내고 본문 폭을 318px에서 346px 이상의 편안한 단행본 지면으로 확장.
D-04 상위
홈 히어로·상품 카드의 과대 붓글씨 축소 및 중복 제목·인기 리본 정리
wolha_original_engine.css:3917, 3983, 4182, index.html:355
모바일 히어로 제목(44.5px→34~36px), 카드 안 붓글씨(38~48px→24~28px) 축소, 검정 '인기 1' 리본·붉은 깜빡임 점(.live-pulse) 및 이미지 안팎 상품명 중복 정리.
D-05 상위
모바일 상품 카드 가격 표시 복원 및 백색 페이월 경계 명확화
wolha_original_engine.css:4230, wolha_jangseogak_v9.js:3251, 4023
display:none으로 숨겨진 모바일 상품 가격을 단정하게 노출해 비교 가능하게 만들고, 무료 열람 종료 지점·유료 제공 범위·결제 행동이 한눈에 보이는 백색 페이월 구현.
D-06 상위
상담 인트로·상품 상세의 과장 장식 제거 및 2줄 CTA 버튼 분리
wolha_original_engine.css:466, 1789, wolha_original_engine.js:900
상담 단계 금색·블러 알약(.cf-step-node)과 하늘색 제목 그라데이션 제거, 상세 이미지 위 4줄 설명문을 2줄 제목으로 축약, 버튼 안 가격·혜택 문구를 보조 텍스트로 분리.
D-07 중위
데스크톱(1440px) 홈 520px 폭 감옥 해제 및 상단 5겹 띠 축약
wolha_original_engine.css:8-12, wolha_v10_11_popup_crm_visual.js:1874
PC에서도 .app-shell을 520px로 묶어 좌우 460px이 비는 구조를 해제해 홈은 최대 1120px(4열 카드), 독서 본문만 640~680px로 분리하고 상단 배너 누적을 1줄로 통합.
D-08 중위
푸터 노란색 남용·하단 중복 여백·하단 탭바 시트감·PDF 밑줄 및 한자 줄바꿈 교정
index.html:4235, 5069, wolha_original_engine.css:3776, 4377, munhak_dynamic_pdf_builder.py:2146
푸터 노란색은 카카오 채널 버튼 1곳에만 남기고 중복 하단 패딩(120px+108px) 정리, 하단 탭바 상단 둥근 그림자 제거, PDF 본문 strong 일괄 밑줄 및 丁未/年 고아 줄바꿈 수정.

1. 전체적인 것 정밀 검수 원문 (기능·결제·보안·퍼널·콘텐츠)

Codex(gpt-6.1-sol, xhigh) 트랙 1 원문 전체입니다. 좌측 목차를 누르면 해당 결함 항목으로 바로 이동합니다.

1. 총평 및 출시 준비도 진단

공개 유료 출시 준비도: 42/100. 일반 고객 대상 실결제 오픈은 보류해야 합니다.

한 줄 진단: 상품·화면·결과물의 외형은 갖췄지만, 일부 유료 기능의 결제 누락, CRM 소유권 검증, 모바일 결제 복귀, 구매 복구, PDF 개인화가 아직 일관된 서버 권한·주문 체계로 연결되지 않았습니다.

점수는 확인된 결함과 검증 공백을 반영한 출시 준비도 판단입니다. 실제 전환율이나 고객 만족도를 측정한 점수는 아닙니다.

이 보고서는 지금까지 확보한 현재 코드, 최종 함수 덮어쓰기 순서, 서브에이전트 조사, 분리한 함수의 합성 입력 재현 결과를 종합한 것입니다. 추가 파일 읽기나 명령 실행 없이 작성했습니다.

감사 범위와 증거 수준

  • 코드·DB·AI-HANDOFF.md를 생성하거나 수정하지 않았습니다.
  • 주요 파일 15개의 점검 전후 SHA-256이 동일했습니다.
  • Python 10개 파일의 구문 분석, 외부 JavaScript 6개와 인라인 스크립트 3개의 문법 검사를 통과했습니다. 이는 기능 정상 동작을 보증하지 않습니다.
  • 실제 고객 프로필·주문을 변경하거나, 실결제·메시지 발송·새 PDF 렌더를 실행하지 않았습니다.
  • DB는 읽기 전용으로 집계만 확인했습니다. 읽은 DB 본체 스냅샷에는 BETA_BYPASS 7건, OWNER_BYPASS 2건, PENDING 3건, PAID 0건이 있었습니다. WAL 및 별도 운영 환경까지 포함한 실거래 현황으로 확대 해석할 수 없습니다.
  • 실제 스마트폰의 카카오톡·인스타그램·네이버 인앱 브라우저, 결제수단별 왕복, PDF 실물 조판과 발급 시간은 미실측입니다. 아래에서 코드상 확정된 결함과 환경에 따라 발동하는 결함을 구분했습니다.

핵심 질문에 대한 판정

점검 질문판정
무료 8종·유료 24종 분류가 정확한가가격 분류는 정확합니다. 다만 유료 24종 중 이름풀이·택일 2종은 정상 PG 결제 없이 열립니다.
외부 고객이 WOLHA_BETA_MODE=0에서 정상 구매할 수 있는가일반 리포트의 서버 결제 검증은 구현되어 있습니다. 그러나 별도 자동 해금 플래그, PortOne 모바일 복귀, 브라우저 저장소 소실 경로 때문에 출시 합격 판정은 불가합니다.
오너 전용 UI가 외부 고객에게 그대로 열리는가최종 UI에는 외부 호스트의 오너 모드 차단이 있고, 주요 관리자 API도 서버 권한을 확인합니다. 일반 고객의 관리자 API 탈취는 입증하지 못했습니다.
상담 인트로와 상세 모달이 항상 중복되는가현재 최종 일반 클릭 경로는 긴 상세 서문을 자동 경유하지 않습니다. 중복 모달을 주된 현행 결함으로 잡는 것은 부정확합니다.
제외 17종의 죽은 업셀이 남았는가활성 무료 업셀에서 제외 상품으로 연결되는 실제 클릭 불능 링크는 확인하지 못했습니다. 다만 신규 상담 API에는 활성 32종 제한이 없습니다.
모바일 PDF가 blob: 때문에 무조건 실패하는가주 경로는 서명된 실제 PDF URL이며 인앱 대응도 있습니다. 실제 저장 성공은 별도 실기기 검증이 필요합니다.
콘텐츠가 가격만큼 차별화되어 있는가분량은 충분하지만, 표본에서 서로 다른 단과의 본문이 그대로 중복됐습니다. 특히 복수 구매의 설득력이 약합니다.

현재 정상적으로 구현된 방어

다음은 이번 감사에서 확인한 개선 사항입니다. 과거 보고서의 문제를 현재 결함처럼 반복하면 안 됩니다.

  • 일반 리포트 결제의 서버 금액 검증, 사전 주문 결속, 주문·결제 키 중복 방지.
  • 쿠폰·복돈 차감과 적립의 원자적 처리.
  • 전화번호 지갑 접근을 위한 서명형 지갑 토큰.
  • 보관함 개별 조회의 세션 소유권 검사와 잠긴 본문 제거.
  • 관리자 전용 보관함 목록·고객 목록·관리 API.
  • PDF 발급의 세션·해금 검사와 다운로드 URL 서명.
  • 본인·궁합 상대 주 입력의 엄격한 날짜·윤달 검증.
  • 본문 HTML의 이스케이프 처리.

주요 근거는 wolha_tab4_payment_tracking.py:1519, wolha_tab4_payment_tracking.py:1692, wolha_tab4_payment_tracking.py:1948, server.py:4392, server.py:4006, wolha_prose_and_verticals.py:73입니다.


2. [P0 · 출시 전 반드시 고쳐야 할 치명적 결함 / 외부 실제 고객 접속 및 WOLHA_BETA_MODE=0 전환 시 터질 버그]

P0-01. 유료 이름풀이·택일이 PG 승인 없이 전체 해금됩니다

근거: index.html:5631, index.html:10239, index.html:10253, server.py:3720, server.py:3730, server.py:4718

발동 조건: 외부 일반 고객이 util_name_harmony 또는 util_taekil의 전체 결과 구매 버튼을 누릅니다. 베타 모드가 꺼져 있어도 동일합니다.

원인

구매 버튼은 unlockPaidUtility()를 직접 호출합니다. 이 함수는 다음 작업만 합니다.

  1. 보유 복돈이 있으면 판매가 범위에서 일부 차감.
  2. state.unlockedUtils에 상품ID__이름 추가.
  3. 로컬 상태 저장.
  4. 전체 결과 다시 표시.

PG 호출, 서버 주문 생성, 남은 현금 결제, 서버 구매 권한 확인이 없습니다. 서버의 생활도구 API도 인증 없이 전체 이름풀이 분석과 택일 목록을 반환합니다.

재현

실제 JavaScript 함수를 분리해 복돈 0원·판매가 9,900원으로 실행했는데도 해금 목록이 저장됐습니다. 서버 생활도구 함수 역시 인증 정보 없이 전체 결과를 반환하는 경로를 확인했습니다.

프로필이 없는 경우에는 반대 오류도 있습니다. 로컬 복돈을 차감하고 상품ID__손님을 저장하지만, isUtilUnlocked()는 활성 프로필이 없으면 계속 false를 반환합니다. 고객은 복돈만 잃고 해금 상태는 인정받지 못할 수 있습니다.

해결책

  • 생활도구도 일반 리포트와 같은 서버 주문·PG·해금 체계에 편입.
  • 미구매 요청에는 서버에서 티저만 반환.
  • 전체 결과는 결제한 세션의 권한으로 판정.
  • 프로필 없는 구매는 먼저 입력 등록으로 연결.
  • 로컬 저장소를 구매 권한의 근거로 사용하지 않도록 제거.

P0-02. 이메일·전화번호만으로 기존 CRM 고객 정보를 변경하고 구독 토큰을 받을 수 있습니다

근거: server.py:4798, wolha_crm_and_kakao.py:495, wolha_crm_and_kakao.py:508, wolha_crm_and_kakao.py:544, wolha_crm_and_kakao.py:973

발동 조건: 공격자가 기존 고객의 이메일 또는 전화번호를 알고 공개 /api/crm/subscribe를 호출합니다.

원인

구독 토큰이 없어도 이메일·전화번호가 일치하면 기존 고객을 선택합니다. 이후 이름·생일·연락처·수신 동의를 갱신하고 기존 subToken을 반환합니다.

반환된 토큰을 사용하는 daily-magic 조회는 프로필의 이메일·전화번호·생년월일 등을 반환합니다.

재현

가상 고객과 가상 연결 객체로 실제 함수를 실행해 다음을 확인했습니다.

  • 이메일만으로 기존 구독 토큰 반환.
  • 해당 토큰으로 기존 전화번호 조회.
  • 같은 이메일과 새 전화번호를 제출해 기존 연락처 변경.

실제 고객·DB·메시지 발송은 사용하지 않았습니다.

영향

고객 연락처와 개인화 링크에 대한 비인가 접근이 가능합니다. 공개 가입 요청이 즉시 발송 함수로 이어져 반복 메일·알림톡 발송 경로도 됩니다.

유료 구매 권한 전체가 이 경로로 탈취된다는 것까지 입증한 것은 아닙니다.

해결책

  • 신규 가입과 기존 고객 변경 분리.
  • 기존 정보 조회·변경과 기존 토큰 반환에는 검증된 구독 토큰 또는 OTP 요구.
  • 연락처 변경은 새 연락처의 소유 확인까지 수행.
  • 공개 가입과 발송에 횟수 제한·중복 방지 적용.

P0-03. PortOne 모바일 리다이렉트 결제의 복귀·해금 경로가 없습니다

근거: wolha_tab4_payment_tracking.js:549, wolha_tab4_payment_tracking.js:569, wolha_tab4_payment_tracking.js:591

PortOne을 정식 결제로 선택할 때 발동하는 조건부 P0입니다.

원인

  • PortOne.requestPayment()에 redirectUrl이 없습니다.
  • Promise 반환값만 처리합니다.
  • 주문 복귀 정보 저장은 Toss 분기에만 있습니다.
  • 페이지 복귀 처리도 Toss의 paymentKey/orderId를 전제로 합니다.

영향

모바일 리다이렉트가 필요한 PG·결제수단에서 결제 UI가 표시되지 않거나, 결제 후 복귀·서버 검증·해금이 완결되지 않을 수 있습니다.

모든 모바일 결제가 항상 실패한다고 단정한 것은 아니며, 실제 가맹점에서 결제를 실행해 관측한 장애도 아닙니다. 그러나 모바일 지원에 필요한 코드 경로가 누락된 것은 확정입니다.

해결책

PortOne의 redirectUrl, paymentId 결과 해석, 서버 주문 조회·검증, 해금 재시도를 구현해야 합니다. PC Promise와 모바일 리다이렉트가 같은 서버 완료 처리로 합류해야 합니다.

PortOne 공식 문서도 모바일 지원 시 redirectUrl과 리다이렉트 결과 처리를 요구합니다. PortOne 결제창 연동 안내

P0-04. WOLHA_BETA_MODE=0만으로 유료 자동 해금이 꺼지지 않습니다

근거: server.py:123, server.py:3125, server.py:3226, server.py:3267, server.py:3329

WOLHA_BETA_AUTO_UNLOCK=1이 배포 환경에 남아 있을 때 발동하는 조건부 P0입니다. 두 플래그의 현재 기본값은 모두 0입니다.

원인

SERVER_BETA_TRIAL_ALLOWED는 WOLHA_BETA_AUTO_UNLOCK만 보고 결정됩니다. 상담 생성 경로는 이 값만으로 유료 세션을 해금하고 전체 본문·v9Book·부적을 반환합니다.

재현

실제 상담 함수를 분리한 실행 결과입니다.

설정결과
BETA_MODE=0, AUTO_UNLOCK=0잠금, 유료 본문 비공개
BETA_MODE=0, AUTO_UNLOCK=1해금, 유료 본문 공개

실제 배포 프로세스의 환경변수 값은 확인하지 않았습니다.

해결책

  • 자동 해금은 베타 모드와 자동 해금 플래그가 모두 참일 때만 허용.
  • 운영 모드에서 우회 플래그가 켜져 있으면 서버 시작 거부.
  • 운영 설정 검증을 서버와 public-config의 같은 정책 함수로 통일.

3. [P1 · 결제 전환율·고객 신뢰도를 깎아먹는 구조·퍼널·기능·카탈로그 정합성 문제]

P1-01. 상세 안내·결제창·PG의 금액이 서로 달라질 수 있습니다

근거: index.html:5491, wolha_original_engine.js:471, wolha_original_engine.js:1375, wolha_jangseogak_v9.js:1611, wolha_tab4_payment_tracking.js:497, wolha_tab4_payment_tracking.py:1157

첫 방문 복돈 5,000원은 로컬 상태에 지급됩니다. 상세·업셀은 이를 전액 차감하지만, 결제창은 최대 3,000원·판매가 30% 등의 한도를 적용합니다. 서버는 실제 지갑 잔액으로 다시 계산합니다.

복돈 사용을 선택한 경우 다음과 같은 차이가 가능합니다.

표시 위치·조건평생사주 37,400원타로 9,900원
상세에서 로컬 복돈 5,000원 전액 차감32,400원4,900원
결제창에서 할인 한도 적용34,400원6,930원
서버 지갑 잔액이 0원인 경우 PG 요청37,400원9,900원

서버가 클라이언트 금액을 믿지 않는 것은 맞습니다. 문제는 정정된 금액을 고객에게 다시 제시하지 않고 PG 요청을 진행한다는 점입니다.

호출자도 반환된 authoritativeAmount로 finalPay와 로컬 후처리를 일관되게 갱신하지 않습니다. 서버 해금 검증은 저장된 주문 금액을 사용하므로, 이를 “할인 때문에 무조건 해금 거절된다”고 설명하면 부정확합니다.

해결책: 서버 견적과 잔액을 먼저 받아 상세·결제창·PG·적립 표시를 통일해야 합니다. 웰컴 복돈은 서버 원장에 실제 지급하거나 사용할 수 없는 로컬 표시를 제거해야 합니다.

P1-02. 결제 복귀와 지급 복구가 브라우저 저장소에 과도하게 의존합니다

근거: wolha_tab4_payment_tracking.js:511, wolha_tab4_payment_tracking.js:525, wolha_tab4_payment_tracking.js:603, wolha_tab4_payment_tracking.js:685

Toss 복귀에 필요한 세션·상품·추가 결제 정보를 단일 localStorage pending 슬롯에 저장합니다. 저장 실패는 무시하고 결제를 진행합니다.

같은 탭 새로고침은 sessionStorage로 보완하지만, 다음 상황은 해결하지 못합니다.

  • 결제 앱에서 다른 브라우저로 복귀.
  • 인앱 저장소 소실.
  • 저장 실패.
  • 두 구매 흐름이 같은 pending 슬롯을 덮어씀.
  • 세션 토큰과 주문 문맥이 서로 다른 저장소 상태로 남음.

서버에는 이미 주문에 결속된 세션이 있지만, 저장소 없이 인증된 주문을 찾아 완료 처리하는 경로가 연결되어 있지 않습니다.

Toss는 인증 후 서버 승인이 완료돼야 결제가 완결됩니다. 복귀 실패를 모두 “돈만 빠져나감”으로 표현하면 안 됩니다. 반면 결제가 이미 완료되는 제공자 경로에서는 상품 지급 누락 위험이 있습니다. Toss 결제 흐름 안내

해결책: 서버 주문을 기준으로 복귀·웹훅·재시도가 같은 멱등 완료 처리에 합류해야 합니다. 브라우저 저장소는 편의 정보로만 사용해야 합니다.

P1-03. 정상 결제 이후 환불·취소와 열람 권한을 동기화하는 경로가 없습니다

근거: wolha_tab4_payment_tracking.py:1324, wolha_tab4_payment_tracking.py:1765, wolha_tab4_payment_tracking.py:1863, server.py:4603

승인 직후 원장 저장 실패를 보상 취소하는 코드는 있습니다. 그러나 검사한 서버에는 정상 결제의 나중 환불·취소를 수신해 다음 상태를 조정하는 경로가 없습니다.

  • 열람 권한.
  • 적립 복돈.
  • 사용한 쿠폰.
  • 평생사주 승급 크레딧.
  • 구매·매출 분석 이벤트.

완료 주문 재시도는 로컬 PAID 원장으로 멱등 성공을 반환합니다. PG 관리자에서 취소된 상태를 자동 반영하는 구현은 확인하지 못했습니다.

해결책: 서명 검증된 PG 웹훅, 주문 상태 재조회, 취소·환불 후 권한 및 잔액 조정 정책을 구현해야 합니다. 실제 환불 피해가 발생했다는 관찰은 아닙니다.

P1-04. PDF 캐시가 다른 카드·상대·가족·펫 결과를 같은 파일로 취급합니다

근거: munhak_dynamic_pdf_builder.py:2533, munhak_dynamic_pdf_builder.py:2569, munhak_dynamic_pdf_builder.py:2602, server.py:4107

캐시 키는 기본 명식과 일부 질문 데이터를 포함하지만, 실제 결과를 구분하는 다음 값이 빠집니다.

  • 전체 본문과 보드.
  • 타로 카드와 정·역방향.
  • 상대 명식.
  • 가족·펫 입력.
  • 일부 관계 상태.

실제 서버 PDF 호출은 partnerBirthDate도 전달하지 않습니다.

합성 결과에서 본인·상품·질문을 고정하고 카드·상대 생일·펫 이름과 본문을 변경해도 같은 캐시 해시가 나왔습니다. 기존 파일이 있으면 본문을 다시 만들지 않고 반환합니다.

영향: 웹 결과와 PDF가 다른 유료 납품 결함입니다.

해결책: 세션 ID + 결과 revision + 렌더러 버전으로 캐시를 분리하거나 최종 렌더 입력 전체를 정규화해 해시해야 합니다.

P1-05. 이름이 같은 명식은 생년월일 수정 후에도 이전 결과를 자동 재사용합니다

근거: index.html:7082, index.html:8450, wolha_original_engine.js:2100

보관함 키가 상품ID__이름이고, 일반 상품의 재사용 검사도 상품·이름·해금 여부만 봅니다.

예를 들어 ‘가족’이라는 이름으로 1990년생 결과를 소장한 뒤 같은 이름의 생년월일을 1991년으로 수정하면, 같은 상품 클릭 시 이전 결과를 바로 열 수 있습니다. 다른 사람을 같은 호칭으로 저장해도 충돌합니다.

해결책: 프로필 고유 ID와 생성 입력 해시를 사용해야 합니다. 기존 소장본은 보존하되 수정 전 명식임을 표시하고, 새 명식 감정을 명시적으로 시작해야 합니다.

P1-06. 가족·반려동물의 불가능한 생일이 1982-10-10으로 조용히 대체됩니다

근거: server.py:2944, server.py:2966, server.py:2973, server.py:428

가족·펫 hydration은 calc_saju()를 엄격 검증 없이 호출합니다.

합성 입력 2024-02-31을 가족과 펫에 각각 넣었을 때 둘 다 오류 없이 solarIso=1982-10-10이 반환됐습니다.

본인·궁합 상대 주 입력은 server.py:3074, server.py:3095에서 엄격 검증합니다. 이 결함은 가족·펫 경로에 한정됩니다.

해결책: 모든 생년월일에 같은 엄격 검증을 적용하고, 잘못된 가족·펫 항목을 명시해야 합니다. server.py:2946의 클라이언트 extraCtx 조기 반환도 서버가 허용한 입력을 재계산하는 방식으로 제한해야 합니다.

P1-07. 최근 250건 밖의 구매 결과는 정상 연락처·주문번호로도 복구되지 않습니다

근거: wolha_crm_and_kakao.py:879, wolha_crm_and_kakao.py:900, wolha_crm_and_kakao.py:914

복구 API가 서비스 전체의 최근 해금 세션 250개를 먼저 조회하고 그 안에서 전화번호를 찾습니다.

다른 고객의 신규 결과가 누적돼 본인 세션이 범위 밖으로 밀리면, 정확한 번호·주문번호를 입력해도 “기록을 찾지 못했습니다”로 끝납니다. OTP 검증에 도달하지 못할 수도 있습니다.

데이터 삭제가 아니라 복구 경로의 결함입니다.

해결책: 인증된 연락처·주문에 연결된 세션을 먼저 지정해 조회해야 합니다. 전역 제한을 소유권 필터보다 앞에 적용하면 안 됩니다.

P1-08. 조간운세 인증 토큰이 분석·광고 URL에 남습니다

근거: wolha_tab4_payment_tracking.js:16, wolha_tab4_payment_tracking.js:110, wolha_tab4_payment_tracking.js:213, wolha_tab4_payment_tracking.py:44, wolha_tab4_payment_tracking.py:2335, wolha_v10_11_popup_crm_visual.js:1775

실제 구독 링크의 daily_sub가 민감 URL 정제 목록에 없습니다.

실제 정제 함수에 합성 URL을 넣었을 때 paymentKey는 제거됐지만 daily_sub=SYNTHETIC_PRIVATE_TOKEN은 남았습니다.

영향: 토큰이 attribution과 서버 이벤트 URL에 저장됩니다. 분석·광고 연동이 설정되면 GA4·CAPI 등의 이벤트 URL로 전달되는 경로도 있습니다. 실제 운영에서 유출된 기록을 확인한 것은 아닙니다.

해결책: 브라우저·서버 정제 목록을 수정하고, 토큰은 초기 메모리에 보관한 뒤 주소창에서 제거해야 합니다. 매직링크 소비 함수도 메모리 값을 사용하도록 함께 변경해야 합니다.

P1-09. 개인정보 보관·삭제 안내가 서버 동작과 다릅니다

근거: index.html:5421, index.html:5907, index.html:5933, index.html:5934, server.py:3174, server.py:3268, server.py:4766

세 가지 불일치가 있습니다.

  • 명식 입력 화면은 브라우저에만 저장한다고 안내하지만 무료·유료 상담 세션은 서버 DB에 저장됩니다.
  • 최대 1년 보관 후 자동 파기를 안내하지만 해당 자동 파기 경로는 검사한 서버에 없습니다.
  • 보관함 삭제 시 서버·기기에서 즉시 삭제한다고 안내하지만 일반 고객의 서버 삭제 API는 오너 권한으로 차단됩니다.

로컬 전체 비우기는 서버 기록을 삭제하지 않습니다.

해결책: 실제 저장 범위를 정확히 안내하고, 본인 소유 데이터 삭제와 보존기간 작업을 구현해야 합니다. 결제 보존 기록과 상담 원문은 별도 보존 정책으로 관리해야 합니다.

P1-10. 환경에 Gemini 키가 있으면 질문 원문이 자동으로 외부 전송됩니다

근거: saju_v9_master_engine.py:1073, saju_v9_master_engine.py:1537, saju_v9_master_engine.py:1540, index.html:5931

현재 또는 상위 .env와 환경변수에서 키를 자동 탐색합니다. Gemini 키가 있고 질문이 있으면 이름·일주·신강약·용신·질문 원문을 Google API로 전송합니다.

개인정보 방침의 “제3자 제공이나 무단 광고성 마케팅에 절대 활용하지 않는다”는 포괄 문구만으로 실제 외부 처리 경로를 설명할 수 없습니다.

실제 배포 키 존재 여부는 확인하지 않았고, 이번 감사에서는 키 조회와 외부 호출을 실행하지 않았습니다. 법적 처리위탁·제3자 제공 분류 자체를 확정한 것도 아닙니다.

해결책: 명시적 외부 보강 설정, 전송 항목 고지, 민감정보 최소화가 필요합니다. 외부 보강이 필요 없다면 키 존재만으로 활성화되는 자동 경로를 제거하는 편이 단순합니다.

P1-11. 단과 상품 본문의 차별성이 부족해 재구매 가치가 약합니다

근거: wolha_prose_and_verticals.py:1149, wolha_prose_and_verticals.py:1185, wolha_prose_and_verticals.py:1203, saju_human_writer.py:2341

동일 합성 명식·이름·빈 고민으로 실제 엔진을 실행하고 제목·메타·위젯을 제외한 본문 문단을 비교했습니다.

상품가격장수본문 문단본문 글자 수
평생사주37,400원1516430,510
재물운29,800원1011621,664
부동산운24,800원1011621,664
신년운세27,400원1011322,188
직업운25,900원1011621,664

이 표본에서 확인한 내용입니다.

  • 재물운과 부동산운은 본문 116개 문단이 모두 일치했습니다.
  • 재물운 116개와 신년운세 113개 문단은 평생사주 본문에 그대로 포함됐습니다.
  • 평생사주 안에도 완전 중복 문단 6개가 있었습니다.
  • 같은 카드·질문으로 만든 속마음 타로와 3개월 연애 타로도 본문 19개 문단과 tarotMetrics가 같았습니다.

모든 고객·모든 입력에서 결과 전체가 같다는 뜻은 아닙니다. 제목·보드·일부 특화 장치는 다릅니다. 그러나 구현이 기존 장을 복사해 제목과 배치를 바꾸는 방식이어서 별도 구매의 이유가 약합니다.

해결책: 상품별 입력·판단 항목·시간 축·조건·행동 결과를 달리해야 합니다. 즉시 조치로는 중복 단과의 교차 판매를 제한하고 평생사주에 포함되는 내용을 명시해야 합니다.

P1-12. 코드가 생성한 공통 문장을 ‘실제 열람 고객 후기’로 표시합니다

근거: server.py:2496, index.html:7439

상품명만 바꿔 넣는 공통 후기 문장에 “실제 열람 고객 후기”를 붙입니다. 최종 활성 카탈로그 32종 중 19종에 이 문구가 들어갑니다.

별도로 작성된 모든 후기가 허위라는 판단은 아닙니다. 현재 자동 생성 문장이 실제 고객 경험담처럼 표시되는 경로가 있다는 것이 확정 사실입니다.

해결책: 구매 검증·작성일·공개 동의를 갖춘 후기만 실제 후기로 표시하고 나머지는 제거하거나 예시임을 밝혀야 합니다.

P1-13. 정상 JSON 오류 응답이 로딩 화면을 멈추게 할 수 있습니다

근거: index.html:8416, index.html:8424, index.html:8438, wolha_jangseogak_v9.js:3251

상담 요청 후 res.ok, data.ok를 확인하지 않습니다. 오류 JSON도 활성 세션에 넣습니다.

최종 리더는 product가 없으면 조용히 반환합니다. JSON 파싱 자체는 성공했으므로 catch의 오류 화면도 실행되지 않습니다.

해결책: 성공 상태와 결과 스키마를 확인한 후에만 활성 세션을 변경하고, 실패 시 원인·입력 수정·재시도 동선을 표시해야 합니다.

P1-14. 공개 카탈로그와 신규 생성 API의 판매 범위가 다릅니다

근거: server.py:2662, server.py:2678, server.py:3057

카탈로그는 전체 49종 중 32종으로 필터링하지만 신규 상담 API는 전체 CATALOG_BY_ID에서 상품을 찾습니다. 제외 상품도 직접 ID를 보내 생성할 수 있고, 알 수 없는 ID는 오류 대신 기본 상품으로 대체합니다.

제외 17종은 다음과 같습니다.

free_boss_type
free_burnout_comfort
free_focus_time
free_joseon_pastlife
free_love_formula
free_money_leak
free_noble_radar
free_youth_hope
saju_nobles
saju_spouse_portrait
tarot_career_move
tarot_image
tarot_signal
util_fengshui
util_naming_create
util_saju_wiki
util_talisman_gallery

해결책: 신규 생성·판매는 활성 ID만 허용하고, 기존 구매 복원은 별도 권한 경로에서 유지해야 합니다. 잘못된 상품 ID는 명시적으로 거절해야 합니다.

다만 다음은 실제 죽은 링크로 확정하지 않았습니다.

  • index.html:7236은 오래된 인라인 스토리 ID를 활성 카탈로그로 필터링합니다.
  • saju_v9_master_engine.py:2235의 crossSell.saju_nobles는 현재 로드 UI에서 소비하는 렌더러를 확인하지 못했습니다.
  • server.py:2929의 무료 기본 업셀은 활성 재회·재물·시험·평생사주 등으로 연결됩니다.
  • 활성 번들에서 제외 ID는 확인되지 않았습니다.

P1-15. 운영 준비 상태와 실제 필수 설정이 일치하지 않습니다

근거: wolha_tab4_payment_tracking.py:192, wolha_tab4_payment_tracking.py:1049, wolha_tab4_payment_tracking.py:1064, wolha_tab4_payment_tracking.js:549, server.py:4833

두 가지 조건부 운영 결함입니다.

  • PortOne 준비 판정: pgLiveReady는 Store ID 또는 IMP 코드와 시크릿 존재를 보지만 실제 V2 프런트 호출에는 Store ID와 Channel Key가 모두 필요합니다. 준비 상태가 true여도 프런트 결제 분기에 들어가지 못할 설정 조합이 있습니다.
  • 외부 URL: 허용된 공개 호스트나 WOLHA_PUBLIC_URL이 없으면 공개 주소가 http://127.0.0.1:8765로 fallback할 수 있습니다. 외부 고객의 CRM 링크·공유 주소가 로컬 주소를 가리킬 수 있습니다.

서버가 127.0.0.1에 바인딩되는 것은 터널·프록시 구조에서 정상일 수 있습니다. 이를 곧바로 외부 접속 불가 결함으로 판단하지 않았습니다.

해결책: 운영 모드 시작 시 선택한 PG의 정확한 필수 설정과 공개 HTTPS 주소를 검증해야 합니다. 외부 운영 상태에서 localhost fallback을 허용하면 안 됩니다.


4. [P2 · 모바일 인앱 브라우저(카톡/인스타)·콘텐츠 밀도·성능·운영 디테일 개선 사항]

P2-01. 무료 결과를 다시 열면 무료 전용 요약과 업셀 문맥이 사라집니다

근거: server.py:3136, server.py:3190, server.py:4440, wolha_original_engine.js:1795, wolha_original_engine.js:1866

최초 무료 응답에는 다음이 있습니다.

  • isFreeTeaserOnly
  • freeSuriSnapshot
  • lockedFreeUpsellPreviews
  • upsellProduct

저장 시 일부가 빠지고 복원 응답에서는 isFreeTeaserOnly까지 누락됩니다. 재방문 때 무료 전용 분기가 실패해 일반 해금 화면으로 들어갑니다.

해결책: 최초·저장·복원에 같은 결과 스키마를 사용해야 합니다.

무료 PDF가 이 누락만으로 무단 발급되는 것은 아닙니다. index.html:9663의 가격 검사와 서버 무료 PDF 차단이 있습니다.

P2-02. 무료 보관함에도 사용 불가능한 PDF·추가질문 버튼을 표시합니다

근거: wolha_jangseogak_v9.js:4738, server.py:4024

보관함 카드가 타로 여부만 보고 PDF·추가질문 버튼을 그립니다. 무료 non-tarot에도 버튼이 생기지만 무료 PDF 발급은 서버가 거절합니다.

해결책: 상품 유형·무료 티저·구매 권한으로 CTA를 결정해야 합니다.

P2-03. 다른 고객의 개인 후기 쿠폰을 공개 목록에서 가져와 사용할 수 있습니다

근거: server.py:4512, v9_backend_services.py:1285, v9_backend_services.py:1337, v9_backend_services.py:1431, wolha_tab4_payment_tracking.py:2060

공개 쿠폰 목록에 미사용 개인 후기 코드가 포함됩니다. 검증과 최종 소비에 발급 소유자 확인이 없습니다.

가상 쿠폰 행으로 실제 목록·검증 함수를 실행해 개인 코드 노출과 무관한 세션의 3,000원 할인 인정을 확인했습니다.

영향: 다른 고객이 먼저 쓰면 원래 고객의 보상이 소진됩니다.

해결책: 공개 캠페인과 개인 보상을 분리하고 개인 쿠폰을 고객 소유권에 결속해야 합니다.

P2-04. 3% 적립 복돈이 다음 구매나 OTP 인증 후 지갑으로 이어지지 않습니다

근거: wolha_tab4_payment_tracking.py:569, wolha_tab4_payment_tracking.py:2087, server.py:3576

미인증 구매는 sess: 지갑에 적립합니다. 다음 구매는 새 세션을 사용하고, OTP 후에는 ph: 지갑을 사용합니다. 기존 잔액을 옮기는 코드가 없습니다.

가상 잔액 900원은 기존 세션에서 사용됐지만 새 세션과 인증된 전화번호 지갑에서는 사용되지 않았습니다.

해결책: 영속 고객 지갑을 사용하거나 본인인증 후 세션 잔액을 원자적으로 통합해야 합니다.

P2-05. 타로 PDF가 실제 배열 위치·핵심 해석·정역방향을 잃습니다

근거: saju_human_writer.py:2263, saju_human_writer.py:2274, saju_human_writer.py:2276, munhak_dynamic_pdf_builder.py:1810, munhak_dynamic_pdf_builder.py:1813

생성기는 posLabel, isReversed, coreMsg를 만들지만 PDF는 positionLabel, coreMessage를 읽습니다.

실제 PDF 위젯 함수의 분리 실행에서 카드 이름은 들어갔지만 위치·역방향 핵심 문구는 빠지고 “새로운 흐름을 여는 핵심 카드”라는 일반 문장으로 대체됐습니다.

해결책: 생성·웹·PDF 스키마를 통일하고 정·역방향 해석을 그대로 표시해야 합니다.

P2-06. 연애 타로 상품의 질문 구조와 수치 의미가 충분히 구분되지 않습니다

근거: saju_human_writer.py:2303, saju_human_writer.py:2341

타로 상품 분기는 직업·돈·이미지와 나머지 그룹 중심입니다. 속마음·3개월 연애·재회가 같은 분기로 들어갑니다.

수치는 정해진 테이블의 가중 평균입니다. 실제 성사 확률을 검증한 모델은 확인하지 못했습니다.

해결책: 상품별 spread 위치와 시간 축을 분리하고 수치는 ‘해석 지표’로 설명해야 합니다. 속마음은 관계 신호, 3개월은 월별 변화, 재회는 확인 조건과 행동 기준이 달라야 합니다.

P2-07. 상대 생일이 없는 궁합에도 가상의 상대 일주와 점수가 나올 수 있습니다

근거: server.py:3090, wolha_prose_and_verticals.py:692, wolha_prose_and_verticals.py:725, wolha_prose_and_verticals.py:770

서버는 상대 날짜가 없으면 partner_saju=None으로 진행합니다. 특화 보드는 고정 매핑으로 상대 일주를 채우고 본인 명식으로 점수를 계산할 수 있습니다.

일부 상품의 프런트 필수 입력 제어와 별개로 서버 계약이 허술합니다. 본인 기준 이상형 풀이와 실제 두 사람 궁합이 같은 필드로 표현되는 것도 문제입니다.

해결책: 실제 두 사람 비교 상품은 상대 정보를 서버에서 필수 검증하고, 이상형 분석은 별도 모델·명칭으로 표시해야 합니다.

P2-08. PDF 발급은 직렬 대기이며 ‘2~4초’ 안내를 보증할 근거가 없습니다

근거: munhak_dynamic_pdf_builder.py:2444, munhak_dynamic_pdf_builder.py:2620, munhak_dynamic_pdf_builder.py:2623, wolha_tab4_payment_tracking.js:376

단일 렌더 worker와 전역 lock을 사용하며 HTTP 요청이 결과를 기다립니다. 동시 요청에서 대기가 누적되고 timeout 후 작업이 계속될 가능성도 있습니다.

“OS 메인 스레드가 PDF 때문에 멈춘다”는 진단은 부정확합니다. 문제는 작업 직렬화·요청 대기·재시도 관리입니다.

해결책: 작업 ID·상태 조회·중복 작업 합치기·대기 안내를 제공하고 동시 발급을 측정해야 합니다.

P2-09. 구매자 PDF가 발급 수량 기준 정리로 사라질 수 있습니다

근거: server.py:3872, wolha_tab4_payment_tracking.py:533

PDF는 90일뿐 아니라 최신 500개 초과 파일도 삭제합니다. 짧은 기간에 발급이 많으면 아직 유효한 서명 링크가 404가 될 수 있습니다.

해결책: 세션·구매·파일 참조를 기준으로 보존하고, 정리된 파일도 권한 확인 후 재발급되도록 해야 합니다.

P2-10. PDF의 폰트·쪽수·실물 조판은 아직 합격 판정을 내릴 수 없습니다

근거: munhak_dynamic_pdf_builder.py:2410, munhak_dynamic_pdf_builder.py:2421, munhak_dynamic_pdf_builder.py:2629

  • 폰트는 local(...)에 의존합니다.
  • 인쇄 쪽수 표시는 실제 PDF 페이지 수가 아닌 챕터 인덱스 기반입니다.
  • 실제 렌더 후 페이지 수를 반환하지만 인쇄된 쪽수와의 일치 검증은 별개입니다.

새 PDF를 생성하지 않았으므로 실제 한글 누락·빈 페이지·잘림이 발생했다고 확정하지 않았습니다.

해결책: 배포 환경의 폰트를 고정하고, 장문·타로·가족·펫·추가질문 표본의 실제 PDF를 렌더해 확인해야 합니다.

P2-11. 모바일 PDF 대응은 있지만 인앱 저장 성공을 확정해서 안내합니다

근거: wolha_tab4_payment_tracking.js:357, wolha_tab4_payment_tracking.js:364, wolha_tab4_payment_tracking.js:387, wolha_jangseogak_v9.js:4182

현재 주 경로는 다음 장치를 갖췄습니다.

  • 서명된 실제 PDF URL.
  • PC에서 클릭 시 빈 창을 먼저 여는 방식.
  • 인앱/iOS에서 화면 내 열기·저장 링크 제공.
  • 인앱에서는 새 창 강제 호출을 피하는 분기.

따라서 “현재 PDF는 blob 방식이라 무조건 실패한다”는 진단은 틀립니다.

남은 문제는 실기기 검증 없이 “깨짐 없이 바로 저장”한다고 확정 안내하는 점입니다. download 속성의 동작은 브라우저에 따라 달라집니다. MDN 다운로드 속성 설명

해결책: 카톡·인스타·네이버의 iOS/Android 조합에서 열기·저장·뒤로가기·외부 브라우저 전환을 확인하고 실패 시 같은 주문을 복구할 경로를 제공해야 합니다.

P2-12. 영상 기본 속성은 갖췄지만 초기 전송·재방문 성능은 별도 개선이 필요합니다

근거: index.html:4964, index.html:5996, index.html:6420, server.py:4312, index.html:10969

확인한 로드 소스의 영상 17개에는 playsinline이 있습니다. 대표 영상은 moov가 앞에 있어 스트리밍 시작에 유리한 구조였습니다.

확인한 파일 크기는 다음과 같습니다.

  • 기본 평생사주 상담 영상: 약 3.60MB.
  • 세로 Flow hero: 약 6.02MB.
  • Flow master: 약 11.82MB.
  • HTML과 직접 참조하는 로컬 CSS·JS·아이콘: 약 1.59MB.

이는 실제 첫 화면 전송량이나 LCP 측정값이 아닙니다. 전체 자산 612MB를 첫 화면 다운로드량으로 계산하면 안 됩니다.

HTML·CSS·JS 전반에 no-store를 적용해 재방문과 결제 복귀에서도 재전송 부담이 있습니다.

해결책: 버전이 있는 정적 자산은 캐시하고 HTML·개인화 API는 별도 정책을 적용해야 합니다. 대표 영상 외에는 가시성·사용자 동작을 기준으로 로드해야 합니다.

P2-13. 생성 API의 요청·메모리·저장 상한이 부족합니다

근거: server.py:3111, server.py:3267, server.py:4605, server.py:4824, v9_backend_services.py:458

앱 코드에서 다음 제어가 부족합니다.

  • 요청 본문 크기 상한.
  • 결제 전 콘텐츠 생성 횟수 제한.
  • 새 세션의 메모리 보관 상한.
  • 대기 작업 TTL.
  • 실행 동시성 상한.

OTP에는 별도 제한이 있지만 생성 API 전체를 보호하지 않습니다. 별도 프록시·WAF 정책은 확인하지 않았습니다.

해결책: 요청 크기 제한, 생성 rate limit, 작업·메모리 TTL, 동시성 상한을 적용해야 합니다.

P2-14. 사업자·브랜드·출처 표현을 운영 상태와 맞춰야 합니다

근거: index.html:5091, index.html:5094, wolha_jangseogak_v9.js:4229, munhak_dynamic_pdf_builder.py:738, server.py:287

  • 실결제로 전환해도 “정식 결제 연동 전 시범 운영” 문구가 남습니다.
  • 고객 화면과 PDF에 외부 출판사명이 정본 명칭처럼 표시됩니다.
  • KASI 절입시각을 고지하지만 현재 계산은 로컬 VSOP 기반입니다. KASI 기준과의 오차 대조 증거는 이번 감사에서 확보하지 못했습니다.

마지막 항목은 계산이 틀렸다는 판정이 아닙니다. 출처·정밀도 표현과 검증 근거를 맞춰야 한다는 지적입니다.

해결책: 운영 상태와 검증된 사업자 정보를 반영하고, 결과물은 월하명감 자체 명칭으로 통일해야 합니다. 정밀도 주장은 경계 시각 표본의 대조 결과로 뒷받침해야 합니다.

P2-15. 모바일 모달의 접근성과 복귀 동작이 미완성입니다

근거: index.html:5318, wolha_v10_11_popup_crm_visual.js:642

ESC·닫기 동작은 있습니다. 그러나 dialog 의미, 진입 시 포커스 이동, focus trap·배경 inert, 닫은 뒤 포커스 복귀가 부족합니다.

해결책: 모달 공통 계약을 만들고 모바일 키보드·뒤로가기·닫기 후 복귀·스크린리더를 확인해야 합니다. 실제 레이아웃 깨짐을 관측했다는 의미는 아닙니다.

P2-16. 활성 카탈로그의 누락 자산과 구버전 잔재를 구분해 정리해야 합니다

근거: v3_catalog_data.py:340, server.py:2472, index.html:8312, wolha_tab2_benchmark_engine.py:496

활성 데이터의 로컬 미디어 참조 320개 중 확인된 누락은 다음 1개입니다.

util_son_calendar
assets/folklore_plates/plate_12_bamboo_wind_courtyard.jpg

활성 카탈로그 데이터에서 박초시/bakchosi는 발견되지 않았습니다. 일부 주석·fallback·제외 상품 데이터에는 남지만, 이 사실만으로 현재 고객 노출 오류라고 할 수 없습니다.

해결책: 누락 자산을 교체하고 활성 카탈로그의 미디어 존재·상품 ID·가격·추천 연결을 자동 검사해야 합니다.

최종 화면·엔진 경로에서 확인한 구조

근거: index.html:10969, wolha_original_engine.js:2097, wolha_jangseogak_v9.js:3251, wolha_v10_11_popup_crm_visual.js:1500

  • 실제 스크립트 순서는 결제 추적 → original → v9 → daily lounge → popup CRM → tab2입니다.
  • 일반 상품 클릭은 최종 original 래퍼가 기본 서비스 열기를 skipStory=true로 호출합니다. 긴 상세 서문이 매번 자동 중복되는 구조는 아닙니다.
  • v9Book이 있는 결과는 v9 리더를 쓰고, 없으면 이전 original 리더로 넘깁니다.
  • 결제 렌더·승인에는 v9 구현 위에 CRM 래퍼가 적용됩니다.
  • 실제 고객 PDF 발급은 server.py:4107, server.py:4171의 build_munhak_dynamic_pdf()입니다.
  • pdf_book_builder.py:1484, pdf_unabridged_builder.py:1684의 현재 함수는 새 빌더를 호출하는 wrapper입니다. 대형 legacy 구현만 보고 현재 고객 PDF를 평가하면 안 됩니다.
  • 본문 rich HTML과 PDF 주요 본문은 이스케이프합니다. 이번 범위에서 이름·질문을 통한 직접 HTML 주입·SSRF·로컬 파일 삽입은 입증하지 못했습니다.
  • 인코딩된 관리자 HTML 경로는 원문 경로 비교를 우회해 HTML 껍데기를 열 수 있지만, 관리자 API는 별도 권한 검사합니다. 이를 관리자 권한 탈취로 과장하면 안 됩니다. 관련 경로는 server.py:4540, server.py:140입니다.

5. 우선순위 실행 로드맵 — 코드 수정만으로 즉시 해결 가능한 Top 10 작업 목록

순서작업주요 수정 대상완료 판정 기준
1이름풀이·택일을 서버 결제·권한 체계에 편입index.html:5631, server.py:3707외부·베타 0·복돈 0에서 미승인 전체 열람 불가. 정상 승인 후 해당 세션만 열림.
2CRM 기존 고객 조회·변경에 소유 확인 적용wolha_crm_and_kakao.py:466, server.py:4798이메일·전화번호만으로 기존 정보·토큰을 받거나 변경할 수 없음. 정상 토큰·OTP만 허용.
3운영 플래그·PG 설정·공개 URL을 시작 시 검증server.py:123, wolha_tab4_payment_tracking.py:1041운영 모드에서 자동 해금·불완전 PG 설정·localhost 공개 주소를 거부.
4Toss·PortOne의 복귀·웹훅·지급을 서버 주문 상태로 통합wolha_tab4_payment_tracking.js:447, wolha_tab4_payment_tracking.py:1519, server.py:4603저장소 소실·중복 복귀·응답 유실에도 한 번만 승인·지급. 취소·환불 상태도 반영.
5서버 견적·영속 지갑을 유일한 금액 기준으로 사용wolha_jangseogak_v9.js:1611, wolha_tab4_payment_tracking.py:1096, wolha_tab4_payment_tracking.py:569상세·결제창·PG·원장이 동일 금액. 웰컴 지원금과 적립금이 다음 구매에 실제 사용됨.
6PDF 캐시를 결과 revision에 결속하고 타로 스키마 통일munhak_dynamic_pdf_builder.py:2569, munhak_dynamic_pdf_builder.py:1810, server.py:4107카드·상대·가족·펫·질문 변경 시 올바른 PDF. 웹과 PDF의 핵심 해석 일치.
7구매 복구를 고객·주문 기준 조회로 변경wolha_crm_and_kakao.py:879전체 최근 250건 밖의 구매도 정상 복구. 다른 고객 주문은 조회 불가.
8프로필 고유 ID·입력 해시와 모든 날짜의 엄격 검증 도입index.html:7082, index.html:8450, server.py:2944이름 중복·생일 수정 시 옛 결과 오인 없음. 가족·펫의 불가능한 날짜는 명시적 거절.
9민감 토큰·개인 쿠폰·삭제 권한을 소유권에 맞춤wolha_tab4_payment_tracking.js:16, v9_backend_services.py:1285, server.py:4766daily_sub가 분석 URL에 없음. 개인 쿠폰은 본인만 사용. 본인 삭제·보존 작업이 안내와 일치.
10결과 계약·카탈로그·판매 문구를 실제 기능과 일치시킴index.html:8416, server.py:3057, server.py:3136, server.py:2496, wolha_prose_and_verticals.py:1185오류 응답 복구 가능, 무료 재방문 화면 일치, 제외 상품 신규 생성 차단, 자동 생성 ‘실제 후기’ 제거, 중복 단과의 포함 관계 명시.

출시 재심사의 최소 조건은 1~4번 수정과 검증입니다. 이후 5~8번을 통과해야 결제 금액, 적용 명식, 복원 결과, 내려받은 PDF가 같은 주문과 같은 고객 입력을 가리킨다고 신뢰할 수 있습니다.

현재 가장 먼저 고칠 곳은 생활도구 결제 누락과 CRM 소유권 검사입니다. 이어서 모바일 결제 왕복과 서버 주문 상태를 완성해야 합니다. 이 상태가 정리되기 전에 광고 유입이나 상품 수를 늘리면 매출보다 결제 문의·복구 문의·신뢰 손실이 먼저 늘어날 가능성이 큽니다.

2. 디자인적인 것 정밀 검수 원문 (화면 해부·살생부·컬러·타이포·여백)

Codex(gpt-6.1-sol, xhigh) 트랙 2 원문 전체입니다. 좌측 목차를 누르면 해당 화면 해부 및 수치 교정표로 바로 이동합니다.

1. 디자인 총평

월하명감은 일러스트의 완성도에 비해 UI의 편집과 절제가 부족합니다. 가장 크게 고급스러움을 깎는 요소는 ‘서로 다른 디자인 방향의 누적’, ‘정보보다 강한 장식’, ‘판매 화면과 독서 화면의 위계 혼선’입니다.

캐릭터, 서재 배경, 인장 로고는 브랜드 자산으로 충분히 쓸 만합니다. 특히 캐릭터의 표정과 의복, 따뜻한 조명은 서비스에 들어오게 만드는 힘이 있습니다. 그러나 이를 둘러싼 UI가 금색 명패, 검정 인기 리본, 대형 붓글씨, 유리 질감 버튼, 네이비 추천 패널, 카드형 요약문을 번갈아 내놓으면서 일관된 인상을 만들지 못합니다.

현재 화면을 지배하는 인상은 “정성스럽게 편집된 개인 단행본”보다 “고급스러워 보이는 장치를 계속 추가한 운세 커머스”에 가깝습니다.

먼저 감사 근거에서 바로잡아야 할 사항이 있습니다.

  • 01 모바일 상단에는 검정 혜택 배너·카톡 배너·명식 등록줄이 보이지 않습니다. 현재 모바일 CSS가 이를 숨깁니다. 세 줄이 모두 보이는 화면은 08 PC입니다.
  • 06과 07은 파일 SHA-256까지 같은 이미지입니다. 따라서 첨부 화면으로 잠금 전후의 차이, 실제 결제 페이월의 완성도를 확인할 수 없습니다. 아래에서는 공통 리더 화면의 문제와 잠금 상태 표현 문제를 구분했습니다.
  • 모바일 PNG는 780×1688 이미지에 담긴 390×844 화면입니다. 아래 화면 측정값은 원칙적으로 CSS px 기준입니다.
  • index.html 뒤에 로드되는 wolha_original_engine.css와 wolha_jangseogak_v9.css가 실제 외형을 크게 결정합니다. 요청하신 다섯 파일에 더해 이 CSS와 연결된 렌더러도 추적했습니다.
  • PDF는 지정 파일의 호출 경로를 따라가 실제 사용되는 생성기와 기존 42쪽 PDF의 표지·본문을 함께 확인했습니다. 새 PDF는 생성하지 않았습니다.

현재 디자인의 강점

강점판단
캐릭터와 세계관얼굴·의복·공간의 밀도가 높아 상품별 정체성을 만들 수 있습니다. UI가 차분해지면 자산 가치가 더 잘 드러납니다.
인장 로고축소해도 알아볼 수 있고, 흰 바탕과 함께 쓸 때 브랜드 인상이 분명합니다.
이미지 중심 구성사주라는 추상적인 상품에 인물과 장소를 부여한 선택은 유효합니다.
05 상세의 흰 권두언이미지 다음에 저자 정보와 인용문을 놓는 부분은 책의 인상을 만드는 데 도움이 됩니다.
본문 기본 행간실제 리더 본문의 16.5px / 1.84는 읽기 어려운 설정이 아닙니다. 본문보다 주변 프레임이 더 큰 문제입니다.

‘AI 티’를 만드는 핵심 원인 3가지

① 디자인 방향을 교체하지 않고, 이전 방향 위에 계속 덮었습니다

index.html에는 흰색·검정·직각 중심의 EDITORIAL DE-AI 규칙이 있습니다. 하지만 이후 CSS는 둥근 모서리, 금색 라벨, 네이비 카드, 대형 제목을 다시 적용합니다.

예를 들어 같은 .hero-stage가 다음처럼 바뀝니다.

위치선언
index.html:4755–4759border-radius: 2px, 그림자 제거
wolha_original_engine.css:93–98border-radius: 18px, 그림자 복원
같은 CSS 모바일 3865–3869border-radius: 22px, 최소 높이 468px

코드에는 절제하려는 방향과 화려하게 만들려는 방향이 함께 남아 있습니다. 화면별 차이도 이 누적 구조에서 나옵니다.

근거: index.html:4697, wolha_original_engine.css:93, 모바일 히어로 규칙:3865

② 서로 다른 중요도의 정보를 같은 강도로 강조합니다

인기 순위, 명사 이름, 상품명, 추천 기능, 수집 진행률, PDF 버튼, 챕터 키워드가 모두 눈에 띄려 합니다.

특히 ‘육십갑자 도감 0/60’은 상품을 고르는 순간의 핵심 정보가 아닌데도, 추천 기능 제목과 같은 상단 영역에서 금색 테두리를 두르고 등장합니다. 읽기 화면에서도 책의 권차, 개인정보, 제목, 요약문, 사주 속성 네 개가 한 카드 안에 들어갑니다.

정보의 순서보다 장식의 종류가 먼저 인식됩니다.

③ 구매 전 설득과 구매 후 독서가 비슷한 카드 문법을 씁니다

구매 전에는 그림과 혜택을 강조할 수 있습니다. 구매 후에는 본문이 가장 안정적인 요소가 되어야 합니다.

현재 리더는 큰 네이비 히어로, 연어색 강조, 반투명 요약 박스, 알약 네 개, 흰 요약 카드, 작은 키워드 박스로 시작합니다. 독자가 문장을 따라가기 전에 카드의 구획을 해석해야 합니다.


2. 화면별 정밀 디자인 해부

01 홈 상단

판정: 캐릭터의 매력은 강하지만, 간판·제목·보조 장치가 모두 커서 첫 화면의 긴장도가 높습니다.

실제로 쌓인 층

첨부 01 기준의 대략적인 위치입니다.

요소위치·크기
헤더높이 약 62px
GNB높이 약 47px
히어로 시작화면 상단에서 약 120px
히어로약 366×480px
하단 탭바높이 약 76px
헤더·GNB·탭바 합계약 185px, 화면 높이의 약 22%

따라서 01의 상단 200px 안에 배너 일곱 겹이 있다는 진단은 맞지 않습니다. 실제 문제는 두 개의 상단 탐색 띠, 큰 히어로 내부 장식, 큰 하단 탭바가 동시에 존재한다는 것입니다.

모바일 배너 숨김은 wolha_original_engine.css:3763–3773에 명시돼 있습니다. 모바일 상단 숨김 규칙 (wolha_original_engine.css:3763)

구체적인 결함

1. 로고와 GNB가 상품보다 먼저 큰 목소리를 냅니다.

  • 워드마크 25.5px / 900.
  • GNB 18px / 700.
  • 여섯 카테고리가 비슷한 굵기와 간격으로 나열됩니다.

로고가 충분히 강한데 메뉴까지 크게 키워, 상단이 간판 두 줄처럼 보입니다. 헤더 56px, GNB 44px, 메뉴 15px / 500~600 정도로 정리하는 편이 낫습니다.

근거: 워드마크·GNB 모바일 규칙:3793–3835

2. 히어로 안에 강조 장치가 중복됩니다.

한 이미지 위에 다음 요소가 놓입니다.

  • 빨간 점이 붙은 ‘전담 명사 대담’.
  • 검정 ‘인기 1’ 리본.
  • 좌우 반투명 원형 버튼.
  • 금색 명사 이름.
  • 대형 흰 상품명.
  • 인용부호가 붙은 설명.
  • 이미지 아래 여러 개의 진행 표시.

‘인기 1’ 리본과 명사 배지는 제거 우선순위가 높습니다. 이미지의 인물과 상품명이 이미 충분한 정보를 제공합니다.

3. 상품명이 그림을 압도합니다.

.home-hero-band .hero-title은 clamp(41px, 11.4vw, 50px) / 900 / 1.1입니다. 390px 화면에서는 약 44.5px입니다. 여기에 강한 이중 text-shadow가 더해집니다.

가독성을 확보하는 수준을 넘어 포스터 광고의 인상이 강합니다. 34~36px / 700 / 1.2, 그림자는 한 겹으로 줄이는 것이 적절합니다.

근거: 히어로 제목:3917–3926

4. 다음 섹션에서 같은 인물·같은 상품을 다시 크게 보여줍니다.

히어로 직후 ‘지금 가장 많이 찾는 명감’에서 같은 캐릭터가 반복됩니다. 첫 상품을 두 번 소개하면서 다른 상품을 비교할 기회가 늦어집니다. 대표 상품 히어로 다음에는 고민별 선택이나 다른 주제의 상품을 배치하는 편이 자연스럽습니다.

5. 하단 탭바가 독립된 바텀시트처럼 보입니다.

22px 상단 모서리, 위쪽 그림자, 큰 아이콘과 굵은 글씨가 바닥에 새로운 패널을 만듭니다.

현재는 안전 영역을 고려한 패딩이 있으므로 그 처리는 유지하고, 시각 높이를 56~60px + safe-area, 모서리 0, 그림자 제거, 아이콘 22~24px, 라벨 11~12px로 정리하는 것이 좋습니다.

근거: 하단 탭바:4377–4410


02 카드 그리드

판정: 추천 패널이 가장 전형적인 ‘고급스러움을 장식으로 설명하는 UI’입니다. 상품 카드에서는 과대 타이포와 가격 부재가 문제입니다.

추천 패널

.w3s-finder-card는 다음을 한꺼번에 사용합니다.

  • #0E1B2E → #162A45 → #1B3354 그라데이션.
  • #263E61 테두리.
  • 그림자.
  • 금색 영문 라벨.
  • 금색 테두리의 도감 버튼.
  • 구분선.
  • 바탕체 제목.
  • 다섯 개의 테두리 선택 버튼.

약 330px 높이의 패널이 상품 탐색 사이에 들어와 시선을 멈춥니다. 추천 기능 자체보다 패널의 존재감이 큽니다.

가장 먼저 걷어낼 것은 이 패널의 네이비 외피입니다.

추천안은 다음과 같습니다.

  • 흰 배경, 외곽 테두리·그림자 제거.
  • 제목: ‘어떤 이야기가 궁금하세요?’처럼 한 줄.
  • 설명: 한 줄 또는 생략.
  • 선택지는 동일 높이 44px의 간결한 목록·버튼.
  • 0/60 수집 정보는 도감 화면으로 이동.
  • CURATED INDEX는 제거.

근거: wolha_tab2_benchmark_ui.css:13–99, 추천 패널 마크업:172–178

상품 카드

1. 현재 모바일 홈은 상당 부분 가로 스와이프 구성입니다.

‘그리드’라는 코드 이름과 달리 모바일 홈의 .poster-grid는 display:flex, overflow-x:auto, 카드 폭 43.5vw입니다. 대표 상품 줄은 별도로 74vw입니다.

가로 스와이프 자체는 유효합니다. 다만 모든 상품군이 같은 방식이면 탐색이 반복적이고 비교가 느려집니다. 대표 상품 한 줄만 크게 쓰고, 나머지는 두 열 목록으로 보여주는 구성이 더 명확합니다.

근거: 대표 카드:3953–3968, 홈 상품 가로 목록:4557–4573

2. 이미지 안 제목과 이미지 아래 제목이 같은 일을 반복합니다.

그림 안에는 ‘평생사주’, 아래에는 ‘평생 종합사주 총람’이 나옵니다. 다시 설명문이 붙습니다. 큰 그림과 두 개의 큰 제목이 동일 상품을 반복 소개합니다.

  • 일반 카드 이미지 안 제목: 390px 화면에서 약 37.8px.
  • 대표 카드 이미지 안 제목: 약 48.4px.
  • 일반 카드 바깥 제목: 18.2px / 800.
  • 대표 카드 바깥 제목: 20.5px / 800.

특히 좁은 카드에 뷰포트 기준 vw로 제목을 키우고 white-space:nowrap을 걸어 둔 방식은 상품명이 길어질 때 취약합니다.

근거: 일반 카드 제목:4182–4208, 대표 카드 제목:3983–3994

3. 모바일에서 가격과 할인 정보가 통째로 숨겨집니다.

poster-price-row, poster-price-line은 display:none입니다. 화면이 단순해졌지만 구매 비교에 필요한 정보도 사라졌습니다.

가격은 장식 배지와 다르게 취급해야 합니다.

  • 카드명 16px / 600.
  • 설명 13px / 1.5.
  • 실제 상품 가격 15px / 600.
  • 혜택 설명 12px, 필요할 때 한 줄.

이 구조라면 할인 리본 없이도 상품을 비교할 수 있습니다.

근거: 가격 숨김:4230–4233

4. 섹션 제목의 반짝이 장식은 제거하는 편이 낫습니다.

장식의 색과 두꺼운 외곽선이 인장·서책의 톤과 연결되지 않습니다. 섹션명 자체를 21~22px / 600~700로 두면 충분합니다.


03 푸터

판정: 서비스의 마지막 인상을 ‘조용한 출판 브랜드’에서 ‘고객지원·공지 패널’로 바꿉니다.

구체적인 결함

1. 색의 역할이 너무 많습니다.

  • 푸터 바탕 #171614.
  • 고객지원 박스 #201E1B.
  • 박스 테두리 #332F29.
  • 카카오 버튼 #FEE500.
  • 링크 #FFE599.
  • 안내문 #FCD34D.
  • 환불 링크 #FDE68A.
  • 사업자 정보 #94A3B8.

검정 푸터를 선택한 것 자체는 문제가 아닙니다. 노란색 계열이 버튼, 링크, 안내문, 정책에 걸쳐 반복되면서 무엇을 먼저 봐야 하는지 흐려집니다.

근거: 푸터 스타일:2372–2435, 후속 색상 규칙:3627–3641, 푸터 마크업:5069–5096

2. 긴 정보를 작은 활자로 해결했습니다.

모바일 .footer-info-grid는 11px / 1.48입니다. 고객지원 안내는 그보다 크고 밝습니다. 사업자 정보와 해석 원리 고지는 뒤로 밀려 있습니다.

사업자 정보는 12px / 1.7, 정책 링크는 13px로 올리고, 정보를 문장 중간의 세로 막대로 연결하기보다 항목별 행으로 정리하는 편이 낫습니다. 필요한 고지 내용은 유지해야 합니다.

3. 아래쪽 빈 공간이 큽니다.

화면에는 저작권 표시 아래로 긴 검정 여백이 있고, 그 아래 흰 여백과 탭바가 이어집니다.

코드에는 푸터 padding-bottom:120px와 모바일 앱 셸 padding-bottom:108px가 함께 존재합니다. 바닥 보정의 책임이 나뉘어 있습니다.

근거: 푸터 하단 패딩:4235, 모바일 셸 패딩:3776–3778

교정 방향

푸터를 #F7F6F3 바탕과 #64645F 글씨로 바꾸고, 고객지원·정책·사업자 정보의 세 덩어리로 정리하는 방향을 권합니다. 카카오 노란색은 실제 채널 이동 버튼 한 곳에만 남깁니다.

필요한 하단 공간은 탭바 실제 높이와 안전 영역을 합친 한 군데의 값으로 관리해야 합니다.


04~05 상담·상세 모달

04 상담 인트로

판정: 캐릭터 연출은 좋지만, 입장 화면의 장식과 설명이 과합니다.

상단에는 뒤로 가기, 브랜드, ‘바로 결과’, 네 개의 알약 단계가 있습니다. 하단에는 명사 명패, 부제, 대형 제목, 인사말, 긴 CTA, 목차 링크가 쌓입니다.

캐릭터를 충분히 보여주려는 의도는 읽힙니다. 하지만 하단의 모든 문구가 중앙 정렬돼 있어 세로 포스터 한 장을 다시 읽는 느낌입니다.

문제의 핵심 수치

  • 단계 알약: 12.2px / 700.
  • 명사 명패: 14.5px / 800.
  • 부제: 16.5px / 700.
  • 제목: clamp(41px,11.4vw,48px) / 900.
  • CTA: 18.5px / 800, 상하 패딩 19px.

근거: 모바일 상담 스타일:4432–4471

걷어낼 요소

  • 단계 표시의 개별 배경·테두리·블러.
  • 현재 단계의 금색 그라데이션과 그림자.
  • 제목의 흰색→하늘색 그라데이션.
  • ‘전담 감정’ 명패의 외곽선.
  • CTA 안의 긴 설명.

단계는 1 / 3 · 생년월일 입력처럼 현재 위치를 짧게 보여주는 방식이 더 조용합니다. 제목은 32~36px, 인사말은 16px / 1.65, CTA는 16px / 600, 높이 56px로 정리할 수 있습니다.

현재 제목 그라데이션은 index.html:1130–1140, 단계 효과는 wolha_original_engine.css:1789–1813에 있습니다. 상담 제목 효과 (index.html:1130), 단계 알약 효과 (wolha_original_engine.css:1789)

05 상품 상세

판정: 이미지 아래 권두언은 방향이 좋고, 이미지 위 긴 헤드라인과 하단 CTA가 이를 해칩니다.

여기서는 실제 렌더러를 정확히 구분해야 합니다.

현재 05의 주요 셀렉터는 .sd-hero-hook이 아니라 .wh-hero-headline입니다. wolha_original_engine.js가 상세 생성 함수를 덮어쓰고 .wh-hero-stage 구조를 렌더링합니다.

근거: 현재 상세 오버라이드:2044–2060, 현재 상세 마크업:619–646

1. 이미지 위에 제목 대신 설명 문단이 올라가 있습니다.

.wh-hero-headline은 26px / 1.38입니다. 크기만 놓고 보면 과하지 않지만, 긴 문장을 네 줄가량 배치해 약 140px 높이의 텍스트 면을 만듭니다.

‘어려운 한자 암호 0%’, 명사 이름, 초년·중년·말년, 돈그릇, 한 권의 책이라는 설명을 한 번에 담고 있습니다. 그림의 하단을 넓게 어둡게 만들어야 하고, 인물의 손과 책도 가려집니다.

이미지에는 짧은 제목 두 줄만 남기고, 긴 설명은 아래 흰 지면으로 내려야 합니다.

근거: 상세 헤드라인:451–475

2. 가격이 그림 위의 금색 메타 정보로 처리됩니다.

담당자와 가격이 같은 높이에서 양쪽으로 갈라집니다. 가격은 이미지 장식보다 구매 정보 영역에 두는 편이 정확합니다.

기본 표시가 37,400원과 화면의 복돈 적용 32,400원은 구분해서 보여줘야 합니다. 현재 코드는 보유 복돈을 판매가에서 차감해 netPrice를 계산합니다.

근거: 가격 계산:2066–2068

3. CTA가 한 문장 안에 행동·무료 범위·가격을 모두 넣습니다.

현재 버튼은 다음 정보를 한 번에 전달합니다.

생년월일 입력하고 감정 시작하기 + 초권 무료 + 복돈가

결과적으로 두 줄 버튼이 됩니다. 버튼은 ‘무료 풀이 시작하기’, 가격과 무료 범위는 버튼 위나 아래의 12~13px 설명으로 분리하는 편이 낫습니다.

근거: 상세 CTA 문구:900–905

유지할 부분: .wh-epigraph의 흰 바탕, 작은 저자 정보, 인용문 구성. 이 부분은 과한 장식 없이 책의 분위기를 만듭니다.


06 페이월

판정: 첨부 06으로는 페이월 디자인을 승인할 수 없습니다. 화면에 잠금 범위·구매 정보·결제 행동이 보이지 않습니다.

06은 07과 같은 프롤로그 화면입니다. 하단 주요 행동도 구매가 아니라 ‘다음 · 1장 · 타고난 성향’입니다.

이 사실만으로 유료 본문이 무단으로 열렸다고 판단할 수는 없습니다. 프롤로그가 무료 범위일 수도 있습니다. 다만 현재 첨부 화면에는 사용자가 무료 범위와 유료 범위를 구별할 시각적 단서가 없습니다.

코드상으로도 renderReadingSheetContent(data, isUnlocked)는 v9Book이 없는 경우에만 이전 렌더러로 isUnlocked를 전달합니다. 확인한 새 리더 분기에서는 그 값으로 잠금 화면을 나누는 처리가 보이지 않습니다.

근거: 리더 진입 분기:3251–3260, 공통 리더 구성:4023–4118

필요한 페이월 편집 구조

페이월은 다음 순서로 한 번에 이해돼야 합니다.

  1. 무료 열람이 끝나는 지점.
  2. 구매하면 열리는 내용 세 가지.
  3. 웹 열람·PDF 등 제공 형식.
  4. 상품 가격과 적용 혜택.
  5. 결제 버튼.

네이비 히어로, 도감 수집률, 추가 질문, PDF 홍보를 함께 펼칠 필요는 없습니다. 흰 지면에서 짧은 제목 24px, 본문 15px / 1.7, 가격 24px / 700, CTA 높이 56px 정도면 충분합니다.


07 웹 열람실

판정: 현재 프롤로그는 프리미엄 단행본의 첫 장보다 개인화 대시보드의 첫 카드에 가깝습니다.

독서를 방해하는 구조

1. 본문 앞의 탐색 UI가 세 줄입니다.

  • 모달 제목 바.
  • 현재 챕터와 질문·PDF·목차 버튼.
  • 가로 챕터 알약 목록.

첨부 화면에서 상단 약 150px, 하단 약 78px가 탐색 영역입니다. 전체 높이의 약 27%입니다. 그 사이 큰 히어로가 다시 약 385px를 차지합니다.

첫 화면에서 실제 산문을 읽을 공간이 매우 적습니다.

근거: 상단 툴바·챕터 목록:2869–2943, 하단 버튼:3721–3739

2. 큰 카드 안에 다시 카드와 알약을 넣습니다.

현재 .hero에는 다음이 들어갑니다.

  • 흰 권차 알약.
  • 이름·생년월일·프롤로그 위치.
  • 네이비 바탕의 대형 제목.
  • 연어색 강조 #F0B7A8.
  • 반투명 요약 박스.
  • 사주 속성 알약 네 개.

.hero-lead는 배경 rgba(255,255,255,.1), 패딩 13px 15px, 반경 14px입니다. 제목 아래 문단조차 별도의 UI 부품이 됩니다.

근거: 히어로·알약:2985–3035, 요약 박스 재정의:3751–3760, 권차·속성 마크업:4035–4048

3. 같은 요약문을 연속으로 읽게 합니다.

네이비 카드 안의 ‘겉으로는 누구보다…’ 문장이 다음 CHAPTER DIGEST의 결론에 다시 등장합니다. 요약이 독서를 돕기보다 스크롤을 늘립니다.

리더 생성 순서도 히어로 다음에 삼행 요지 카드를 바로 붙입니다.

근거: 리더 요약 배치:4043–4053, 삼행 요지 생성:199–217

4. 요약 카드의 문법이 지나치게 복잡합니다.

.t2-3line-card 안에는 외곽 테두리, 그림자, 영문 라벨, 키워드 박스, 진한 구분선, 항목별 테두리 라벨이 있습니다.

‘세 줄 요약’이 실제로는 여러 줄의 대시보드입니다. ‘이 장의 요지’라는 작은 제목과 세 개의 문장으로 충분합니다.

근거: 삼행 요지 스타일:129–207

본문 타이포그래피는 무엇이 문제인가

실제 .cw-body p는 다음과 같습니다.

  • font-size:16.5px.
  • line-height:1.84, 약 30.4px.
  • 문단 아래 16px.
  • 자간 -0.015em.
  • 글씨색 #2B3441.

행간은 충분합니다. 일괄적으로 더 키울 이유는 없습니다.

문제는 바깥 여백 14px에 카드 내부 여백 22px가 더해져, 390px 화면에서 본문 폭이 약 318px까지 줄어든다는 점입니다. 여기에 요약 박스의 내부 패딩이 다시 붙으면 한 줄이 더 짧아집니다.

근거: 리더 바깥·카드 여백:2946–2959, 본문 설정:3402–3408

권장하는 독서 화면

  • 흰색 또는 아주 옅은 종이색의 연속 지면.
  • 좌우 여백 20~24px.
  • 장 제목 26px / 1.45.
  • 본문 17px / 1.85.
  • 문단 사이 18~20px.
  • 절 사이 36~40px.
  • 사주 용어·원국·도표는 관련 문단 뒤에 배치.
  • PDF·추가 질문은 보조 메뉴로 이동.
  • 목차 진입점은 한 곳.
  • 첫 장에서 비활성 ‘이전 장’ 버튼은 공간을 차지하지 않도록 처리.

현재 원문 전체가 <details>의 ‘단행본 원문 전체 읽기’ 안에 들어가는 구조도 재검토해야 합니다. 구매 후 주된 독서 경험이 무엇인지 명확히 정해야 합니다.

근거: 원문 접기 구조:3996–4011


08 데스크톱 & PDF

데스크톱

판정: 1440px PC 화면에서 모바일 앱을 중앙에 놓은 상태입니다. 데스크톱 커머스의 레이아웃으로는 미완성입니다.

앱 셸 폭은 520px입니다. 1440px 화면에서 콘텐츠가 약 36%를 사용하고, 좌우에 약 460px씩 남습니다.

독서 화면의 폭 제한은 필요합니다. 홈 커머스까지 같은 폭을 쓰면 상품 비교와 탐색의 효율이 낮습니다.

원인은 다음 공통 규칙입니다.

.app-shell,
.fullpage-modal .fp-card,
.sheet-overlay .reading-sheet,
.counsel-flow-overlay .cf-shell {
  max-width: 520px !important;
}

근거: 공통 폭 제한:8–12

PC 첫 화면은 실제로 정보 띠 다섯 개를 거칩니다.

  1. 헤더.
  2. GNB.
  3. 검정 복돈 배너.
  4. 카톡 구독 배너.
  5. 명식 등록줄.

히어로는 약 259px부터 시작합니다. 카톡 줄은 전체 노란 배너가 아니라 흰 바탕에 노란 Ch 표식이 붙은 형태입니다. 색상 표현을 정확히 하더라도, 상품을 보기 전 다섯 번 수평으로 끊기는 구조는 여전히 산만합니다.

카톡 줄의 삽입 위치는 wolha_v10_11_popup_crm_visual.js:1874–1881에서 확인됩니다. 카톡 배너 삽입 코드 (wolha_v10_11_popup_crm_visual.js:1874)

PC 권장 구조

  • 홈 콘텐츠 최대 폭 1120px.
  • 좌우 기본 여백 40~48px.
  • 히어로는 그림과 상품 설명을 나누는 두 열.
  • 상품 목록은 4열.
  • 본문 리더는 별도 본문 폭 640~680px.
  • 명식과 복돈은 헤더 보조 메뉴에 통합.
  • 상시 혜택 안내는 한 줄로 제한.
  • 홈 외곽은 #F5F4F1, 실제 콘텐츠는 #FFFFFF.

PDF

중요한 호출 경로 차이가 있습니다.

pdf_unabridged_builder.py 내부의 긴 구형 스타일을 현재 결과물의 원인으로 지목하면 잘못된 감사가 됩니다.

  • 기존 조판 함수는 _legacy_build_unabridged_master_pdf.
  • 현재 공개 함수 build_unabridged_master_pdf()는 build_munhak_dynamic_pdf()를 호출합니다.
  • 실제 주요 조판은 munhak_dynamic_pdf_builder.py에 있습니다.

근거: PDF 공개 함수:1684–1694, 실제 PDF 스타일:1947

기존 42쪽 PDF 표본 (munhak_v4_unabridged_eb93125284.pdf)의 표지·본문을 확인한 결과는 다음과 같습니다.

항목판단
표지 구성네이비 세로 띠와 흰 지면의 대비는 웹보다 잘 정리돼 있습니다.
표지 줄바꿈丁未年이 丁未와 年으로 갈라져 어색한 한 줄을 만듭니다. 의미 단위의 줄바꿈 통제가 필요합니다.
본문바탕체와 안정적인 행간으로 책의 인상이 납니다.
강조 장치절 제목, 맥점 요약, 위아래 선, 밑줄, 각주가 반복돼 설명서의 느낌이 강해지는 구간이 있습니다.
작은 정보표·주석은 8px대가 아니라 8pt대 설정이며, 인쇄와 휴대폰 축소 열람에서 별도 검토가 필요합니다.

실제 생성기의 .sec-block p는 9.9pt / 1.88, 문단 간격 2.8mm입니다. 줄간격은 약 18.6pt로 넉넉합니다. 장황한 문장까지 이 간격으로 이어지면 페이지가 느슨하고 길게 느껴질 수 있습니다.

  • 본문 제안: 10.5pt / 1.75~1.8.
  • 문단 사이: 3~3.5mm.
  • 주석: 8.8~9pt / 1.6.
  • 제목·요약·본문 중 두 단계만 선으로 구분.
  • .sec-block strong의 일괄 밑줄 제거.
  • 한자·연도·가격은 의미 단위 줄바꿈 제어.

근거: PDF 본문·강조:2136–2148, 요약·주석:2150–2184


3. 즉시 걷어내야 할 ‘AI 티’ 요소 살생부

아래의 ‘제거’는 기능과 정보를 삭제한다는 의미가 아니라, 불필요한 시각 장치를 걷어내거나 올바른 위치로 옮기라는 감사 의견입니다.

우선순위대상정확한 파일·라인·셀렉터조치
최상추천기의 네이비 그라데이션·외곽선·그림자wolha_tab2_benchmark_ui.css:13–20 .w3s-finder-card흰 지면으로 전환
최상추천 기능 옆 수집률 명패같은 파일 41–50 .w3s-codex-pill; wolha_tab2_benchmark_ui.js:175도감 화면으로 이동
최상영문 장식 라벨wolha_tab2_benchmark_ui.js:174,206 .w3s-kicker, .t2-3line-eyebrow‘맞춤 추천’, ‘이 장의 요지’로 축약
최상리더의 거대한 네이비 표지 카드wolha_jangseogak_v9.css:2985–3011 .hero, .hero h1 em연속 지면의 장 제목으로 전환
최상리더 요약문 속 반투명 박스같은 파일 3751–3760 .hero-lead배경·반경·내부 패딩 제거
최상요약 카드 안 키워드·항목별 박스wolha_tab2_benchmark_ui.css:129–207 .t2-3line-card, .t2-kw-pill, .t2-3line-tag짧은 문장 목록으로 단순화
상리더의 권차 알약과 속성 알약 네 개wolha_jangseogak_v9.js:4036–4048; CSS 3029–3035 .chip권차는 작은 서지 정보, 속성은 근거 영역으로 이동
상히어로 ‘인기 1’ 검정 리본index.html:4967; CSS 355–375 .hero-rank-ribbon홈 대표 이미지에서는 제거
상반복하는 붉은 점index.html:344–353 .live-pulse정적 정보로 전환하거나 제거
상히어로 대형 제목과 이중 그림자wolha_original_engine.css:3917–3926 .home-hero-band .hero-title34~36px / 700, 그림자 한 겹
상좁은 상품 카드의 대형 붓글씨같은 파일 4182–4191, 3983–3986 .pc-photo-title일반 카드 24~28px, 대표 카드 32~36px
상상담 단계의 금색·블러 알약같은 파일 1789–1813 .cf-step-node텍스트와 단순 진행 표시
상상담 제목의 하늘색 그라데이션index.html:1130–1140 .cf-cover-title단색 #FFFFFF
상상세 이미지 위 장문 헤드라인wolha_original_engine.css:466–475 .wh-hero-headline두 줄 제목만 유지, 설명은 아래로
상두 줄로 길어지는 상세 CTAwolha_original_engine.js:900–905; CSS 1180–1187 .btn-sd-instant행동 문구와 가격·범위 설명 분리
중푸터의 노랑·금색 안내문 반복index.html:5074–5086 인라인 스타일카카오 버튼 외에는 중립색 사용
중하단 탭바의 바텀시트 외형wolha_original_engine.css:4377–4391 .floating-dock상단 반경·그림자 제거
중PDF 본문의 일괄 밑줄 강조munhak_dynamic_pdf_builder.py:2146–2148 .sec-block strong굵기 중심 강조로 제한
조건부프로모션 팝업의 광채·동전·반짝이·캐릭터 부유 효과wolha_v10_11_popup_crm_visual.js:109–119,163–192,207,734–738수동 노출 화면을 정리할 때 함께 제거

마지막 프로모션 팝업은 이번 첨부에서 실제 노출된 요소가 아닙니다. 현재 1925–1927에는 자동 팝업 비활성화가 표시돼 있으므로, ‘접속 즉시 팝업이 떠서 방해한다’는 현재 결함으로 집계하지 않았습니다.


4. 컬러 · 타이포그래피 · 여백 시스템 교정안

권장 방향은 ‘백색 지면, 먹색 활자, 인장색 한 가지, 절제된 캐릭터 화보’입니다. 전통 분위기는 인장·그림·서체에서 만들고, 일반 UI는 차분하게 정리하는 편이 좋습니다.

컬러

역할BeforeAfter 제안
콘텐츠 지면순백·아이보리·청회색 혼재기본 #FFFFFF
외곽·보조 배경#F2F4F8, #F7F7F6, 여러 아이보리#F5F4F1
본문#2B3441, #1E293B, #333333#242420
보조 글씨#6B7684, #767676, #94A3B8#6B6B65
구분선청회색·금색·베이지 혼재#E8E6E0
브랜드 강조#8B1D1D, #A63A2B, #9E3B2E인장색 #8B2E2B로 통합
주요 버튼검정·네이비·테라코타·크림 혼재#20201D, 흰 글씨
이미지 위 글씨흰색·하늘색·금색 혼재기본 #FFFFFF
카카오노란색이 안내문·링크까지 확장실제 카카오 행동에만 #FEE500
리더 강조연어색·금색·네이비 박스먹색 굵기 중심, 인장색은 짧은 라벨에만

사주 도표의 오행색은 의미를 담고 있으므로 필요한 범위에서 유지할 수 있습니다. 일반 탐색 UI의 장식색과 분리해야 합니다.

타이포그래피

현재는 Pretendard, 경기천년바탕, 리디바탕, Noto Serif KR, MaruBuri, Cormorant Garamond가 여러 역할에 겹쳐 있습니다.

특히 경기천년바탕은 400과 700에 동일한 WOFF 파일을 지정합니다. 굵기 차이가 실제 별도 폰트 파일에 기반한 것으로 보기 어렵습니다.

근거: 폰트 등록:4520–4532

주요 서체는 다음 두 계열로 정리하는 안을 권합니다.

  • UI·가격·탐색: Pretendard.
  • 서책 제목·장문: Noto Serif KR, 실제 로드한 굵기 사용.
요소BeforeAfter 제안
모바일 워드마크25.5px / 90022px / 700
GNB18px / 70015px / 500, 선택 700
홈 히어로 제목약 44.5px / 900 / 1.134~36px / 700 / 1.2
섹션 제목23.5px / 80021~22px / 600~700 / 1.35
일반 카드명18.2px / 80016px / 600 / 1.45
이미지 안 일반 카드 제목약 37.8px / 90024~28px / 700 / 1.2
상담 CTA18.5px / 80016px / 600
상세 헤드라인26px / 1.38 장문26~28px / 1.4, 두 줄 이내
리더 장 제목22.5px / 800 네이비 카드26px / 600 / 1.45, 흰 지면
실제 리더 본문16.5px / 1.8417px / 1.85
요약문여러 크기·박스 혼재15px / 1.75
푸터 정보11px / 1.4812px / 1.7

장문 자간은 -0.015em에서 0~-0.01em 범위로 완화하고, 제목의 강한 음수 자간은 별도로 관리하는 것이 좋습니다.

여백과 형태

항목BeforeAfter 제안
모바일 좌우 기준선10·12·14·16·18·22px 혼재기본 20px, 화보만 12px 또는 화면 끝까지
리더 본문 폭카드 중첩으로 약 318px390px 화면에서 약 342~350px
문단 사이16px18~20px
절 사이카드 간격 12px 중심36~40px
홈 섹션 사이두꺼운 회색 띠 반복기본 40px, 필요 시 1px 선
버튼 높이패딩과 줄바꿈에 따라 변동주요 56px, 보조 44px
이미지 모서리2·16·18·20·22px 혼재기본 12px
일반 버튼 모서리2px~999px 혼재기본 8px
독서 본문카드 반경 20px외곽 카드 없음
그림자이미지·배지·버튼·패널에 중복일반 지면에서는 제거, 떠 있는 모달에만 제한

모든 모서리를 직각으로 만들 필요도, 모든 요소를 둥글게 만들 필요도 없습니다. 역할별로 두세 개의 값만 남기면 됩니다.


5. 체감 고급스러움을 끌어올릴 최우선 디자인 수술 Top 8

‘2배’는 이번 감사에서 측정한 지표가 아닙니다. 아래는 가장 적은 변경으로 시각적 체감 차이를 크게 만들 순서입니다.

순위수술완료 판정 기준
1현재 CSS의 최종 결정 위치 정리히어로·카드·리더의 색·글꼴·반경을 어디서 결정하는지 명확하고, 같은 셀렉터에 상반된 !important가 누적되지 않음
2추천 패널의 네이비·골드 외피 제거02에서 상품 그림 다음으로 큰 덩어리가 추천 박스가 되지 않음. 수집률은 별도 도감으로 이동
3웹 리더를 연속 지면으로 재편집큰 네이비 히어로와 중복 요약이 사라지고, 첫 화면에서 본문 읽기가 시작됨
4홈·상품 카드의 제목 크기와 중복 축소히어로 34~36px, 일반 카드명 16px 수준으로 정리. 그림 안팎에서 같은 상품명을 크게 반복하지 않음
5무료 범위·유료 범위·가격의 시각적 구분무료 열람 위치와 구매 후 제공 내용이 분명함. 상품 카드에서 가격 확인 가능. 실제 잠금 화면을 별도 캡처해 검증
6상담·상세의 긴 문구와 장식 정리이미지 위 설명은 두 줄 이내, CTA는 행동 중심 한 줄, 단계 표시는 배경 없는 간결한 구조
7PC 홈과 독서 화면의 폭 분리1440px에서 홈 최대 폭 약 1120px, 상품 비교 가능. 리더 본문은 640~680px로 독립 관리
8푸터·하단 탭바·PDF 강조 규칙 정리푸터의 노란색은 카카오 행동에 한정, 바닥 여백 중복 제거, PDF 한자 줄바꿈과 일괄 밑줄 교정

가장 먼저 승인할 디자인 방향은 “인물 화보가 주목을 끌고, UI는 조용하게 선택과 독서를 돕는 월하명감”입니다. 현재 캐릭터 자산은 살릴 가치가 높습니다. UI에서 금색 명패, 대형 활자, 중첩 카드, 반복 요약을 걷어내면 그 자산의 완성도가 훨씬 선명하게 드러납니다.

이번 점검에서는 파일을 생성·수정하지 않았습니다. AI-HANDOFF.md도 읽기만 했으며, 지정하신 다섯 소스 파일은 점검 전후 SHA-256이 동일함을 확인했습니다.