마켓 · 크립토 브리핑 — 배포용 PWA 패키지
이 폴더는 미국 증시 · 가상화폐 데일리 브리핑 PWA "마켓 · 크립토 브리핑"의 소스예요.
(index.html, manifest.json, sw.js, icons/ 4개 파일 세트, og-image.png)
배포 현황 (2026.08.27 기준)
- 실제 서비스 주소: https://market-crypto-briefing.vercel.app/
- 이 GitHub 저장소(pitr1000-blip/market-crypto-briefing)가 Vercel 프로젝트와
Git 연동되어 있어요. main 브랜치에 커밋을 push하면 Vercel이 자동으로
감지해서 몇 초~몇 분 안에 새 버전을 배포해요.
- 원래 매일 아침 PDF로 만들어 카카오톡으로 보내던 "미증시 및 가상화폐
briefing"을 이 웹 대시보드로 완전히 대체했어요. PDF+카카오톡 발송은
더 이상 쓰지 않아요.
수정하는 방법
- 급하게 한 군데만 고칠 때: GitHub 저장소에서 해당 파일(예: index.html)을
열어 연필(✏️) 아이콘으로 바로 편집 → "Commit changes"로 main에 커밋
→ Vercel이 알아서 재배포
- 통째로 갈아끼울 때: 해당 파일을 "Add file" → "Upload files"로 다시
업로드해도 됩니다
매일 아침 데이터 자동 갱신
- Code 루틴 "미증시·가상화폐 브리핑 자동 배포 (GitHub push)"가 매일 아침
7시에 자동 실행돼요. 미국 증시(다우/나스닥/S&P500/러셀2000, 섹터,
등락 상위, 채권/유가/달러/금, 연준, 오늘 일정)와 가상화폐(BTC/ETH/
SOL/XRP 가격, ETF 자금 흐름, 미결제약정/펀딩레이트/청산 규모, BTC
지지·저항선, 이슈 심층분석)를 새로 조회해서 index.html의 데이터
부분만 갈아끼우고 main에 push해요. 레이아웃·CSS·JS 로직은 건드리지
않아요.
- "실행 성공" 표시만으로는 실제로 데이터가 바뀌었는지 알 수 없어요 —
확인하려면 GitHub의 커밋 로그와 Vercel의 Deployments 탭을 같이
확인하세요.
수치 교차검증 & 출처 표시 (필수)
- 모든 수치(특히 가격·등락률)는 단일 소스만 보고 쓰지 말고 최소 2곳
이상의 소스로 교차검증하세요. 소스 간 값이 다르면 서로 일치하는
구간(레인지)을 쓰거나, 다수 소스가 모이는 값을 채택하세요. 검색
결과에 나온 값 하나를 그대로 채택하지 마세요 — 실제로 ZEC 가격을
단일 이상치($823)로 잘못 기재해 바이낸스 실거래가와 크게 어긋난
적이 있어요.
- index.html 맨 아래(디스클레이머 다음)에 "데이터 출처" 섹션이 있어요.
매일 데이터를 갱신할 때 이 섹션의 링크 목록도 그날 실제로 참고한
출처로 갈아끼우세요. 이 섹션은 레이아웃이 아니라 "데이터"의 일부로
취급해서, 데이터만 갱신하는 날에도 항상 업데이트해야 해요.
서비스워커(오프라인 캐시) 주의
- sw.js는 HTML 페이지(navigate 요청)는 네트워크 우선, 아이콘 같은
정적 자산만 캐시 우선으로 만들어져 있어요. 이래야 매일 브라우저를
다시 열 때 어제 데이터에 갇히지 않아요. sw.js를 손댈 일이 있으면
이 전략을 절대 "캐시 우선"으로 바꾸지 마세요 — am-briefing-pwa에서
실제로 이 문제를 겪고 고쳤어요.
홈 화면에 앱처럼 설치하기
- Android(Chrome): 메뉴 → "홈 화면에 추가"
- iOS(Safari): 공유 버튼 → "홈 화면에 추가"
누르면 아이콘이 생기고 앱처럼 전체 화면으로 실행돼요.
카카오톡/슬랙 등에 링크 공유 시 미리보기 카드
디스클레이머
- "본 리포트는 정보 제공 목적으로 작성되었으며 투자자문이 아닙니다"
- "가상화폐는 원금 전액 손실이 가능한 고위험 자산입니다"
매일 갱신 시에도 이 두 문구는 항상 유지돼야 해요.
