말차 로직 카페에 오신 것을 환영합니다
이곳은 기획과 논리를 정성스레 다듬고, 에이전트와 함께 한 줄의 코드로 우려내는 차분한 기술 공간입니다. 찻잔을 들기 전, 오늘 정성껏 준비한 세 가지 핵심 허브 메뉴와 여정의 레시피를 천천히 음미해 보세요.
The Menu
실시간 다도 API 테스터
말차 로직의 다실(茶室) API와 직접 통신해 보세요. 원하는 메뉴를 선택하고 신호를 보내면, AI 찻잔이 그 결과를 가볍게 우려냅니다.
본 블로그는 차(Tea) 전용 엔진으로 글을 우려냅니다.
// Select a drink and click BREW() to start API request
> Ready to infusion...
v3.3.0MatchaLogic Tools 신설 및 slate-modern 색상 체계 개편2026. 8. 22.
말차 로직의 새로운 유틸리티 섹션인 MatchaLogic Tools를 신설하고, 디자인 시스템의 slate 색상군을 slate-modern으로 업그레이드하며 블로그 페이지의 디테일을 보정했습니다.
-
MatchaLogic Tools 신설 및 계산기 2종 배포:
- 일상 유틸리티 도구를 모아볼 수 있는 허브 페이지(
/tools)를 새로 구축했습니다. - 파일 용량과 다운로드 속도를 입력하여 소요 시간을 상세히 예측해 주는 다운로드 시간 계산기와 물타기 후 최종 평단가를 시뮬레이션해 주는 주식 평단가 계산기를 추가했습니다.
- 공용 푸터(
Footer.astro)의 Workspace & Tooling 섹션에 도구함 링크를 연동했습니다.
- 일상 유틸리티 도구를 모아볼 수 있는 허브 페이지(
-
디자인 시스템
slate-modern도입 및 블로그 레이아웃 보완:- 기존의 딱딱한 slate 컬러 스키마를 보다 현대적이고 따뜻한 감성을 지닌
slate-modern색상군으로 전면 교체했습니다. - 새로운 색상 체계 변경에 발맞추어, 블로그 포스트 상세 본문 및 리스트 영역의 가독성과 배경/테두리 대비 등 디자인 디테일을 전체적으로 정교하게 다듬었습니다.
- 기존 푸터 내 Tool Cabinet 항목을 디자인 콘셉트에 맞게 **Ingredients (상세 장비)**로 명칭을 함께 개편했습니다.
- 기존의 딱딱한 slate 컬러 스키마를 보다 현대적이고 따뜻한 감성을 지닌
v3.2.1Decap CMS 관련 파일 및 설정 제거2026. 8. 22.
더 이상 사용하지 않는 Git 기반 CMS인 Decap CMS(구 Netlify CMS) 관련 설정과 UI 요소를 프로젝트에서 완전히 제거하고 시스템을 최적화했습니다.
- CMS 파일 및 관리자 페이지 제거:
public/admin/폴더 내의 CMS 설정(config.yml)과 진입점(index.html)을 삭제하여/admin경로를 통한 CMS 접근을 차단했습니다. - 라우팅 및 크롤러 규칙 업데이트:
public/_redirects파일에서/admin리다이렉트 규칙을 제거하고,public/robots.txt에서 크롤러 대상Disallow: /admin/규칙을 삭제했습니다. - UI 및 환경 설정 정보 정리:
src/pages/kitchen.astro파일 트리 텍스트 및 Core Dependencies의 Decap CMS 카드 요소를 제거하였으며, 푸터의 관련 외부 링크와siteConfig.ts내 버전 관리 정보를 모두 정리했습니다.
v3.2.0GA4 연동 및 개인정보처리방침 페이지 도입2026. 8. 12.
웹사이트의 서비스 분석을 위해 구글 애널리틱스 4(GA4)를 도입하고, 법적 고지 준수와 스팸 차단을 동시에 달성할 수 있도록 전용 개인정보처리방침 페이지를 신설했습니다.
- 환경 변수 기반 GA4 연동:
PUBLIC_GA_ID환경 변수를 사용하여 GA4 추적 스크립트를 조건부로 로드하도록 구현했습니다. 로컬 개발 환경(.env)에서는 비워둠으로써 실제 수집 서버로 더미 트래픽이 쌓이지 않도록 안전장치를 마련했습니다. - 개인정보처리방침 페이지 신설:
UtilityPageLayout.astro템플릿을 기반으로/privacy페이지를 추가하여 GA4 데이터 수집 사실을 고지했습니다. 검색 엔진에 과하게 노출되는 것을 제어하기 위해noindex={true}를 설정했습니다. - 이메일 수집 봇 스팸 방지: 개인정보 책임자 문의 이메일 노출 시, 스패머 수집 봇에 긁히지 않도록
PUBLIC_CONTACT_EMAIL환경 변수를 받아와 브라우저 단에서 자바스크립트로 분할 결합(Obfuscate) 후 렌더링되게 설계했습니다. - 하단 내비게이션 연결: 웹사이트 최하단 푸터(
Footer.astro) 컴포넌트에Privacy링크를 추가하여 방문자가 언제든 고지 문서에 접근할 수 있도록 동선을 다듬었습니다.
v3.1.0Origin 페이지 개편 및 STAGE 요약 섹션 추가2026. 8. 6.
말차 로직의 태동과 성장 역사를 한눈에 탐색할 수 있도록 Origin 페이지를 전면 리팩토링하고 신규 기능을 도입했습니다.
- 데이터 계층 분리:
origin.astro에 내장되어 있던 연대기 데이터를 독립된 데이터 모듈(src/data/originData.ts)로 분리해 정규화하고 유지보수 효율을 높였습니다. - STAGE 요약 섹션 신설: 히어로 영역 바로 아래에 각 단계를 대표하는 아이콘들과 부드러운 점선으로 연결된 헤더 요약 맵을 배치했습니다. 클릭 시 해당 단계 카드로 부드럽게 스크롤링되는 앵커 네비게이션을 지원합니다.
- 디렉티브 디자인 조율: 각 단계 아이콘은 고유한 크루 테마색을 활용하되 Stage 1, 2는 연한 투명도로 스며들게 구성하고 Stage 3는 선명하게 대비를 주었습니다.
- 콘텐츠 및 규격 동기화:
about.astro페이지의 스토리 요약 텍스트를 수정하고, 적용된 슬레이트(Slate) 색 스펙트럼 명세를/palette페이지에 정식 등록했습니다.
v3.0.1About 페이지 협업 대화 추가 및 우회 리다이렉트 경로 적용2026. 8. 6.
About 페이지에 크루 클로드(Claude)와의 심층 비평 협업 대화를 추가하고 배경 설명 영역의 디자인을 개편했습니다. 또한, 특정 비정상적인 접근 시 지정된 에러 페이지로 부드럽게 안내하도록 우회 리다이렉트 경로 규칙을 적용했습니다.