Thinking in
Soft Logic.

딱딱한 코드를 부드럽게 우려냅니다.
AI, ARM 윈도우, 그리고 Matcha Logic의 기록들.

Welcome Preamble

말차 로직 카페에 오신 것을 환영합니다

이곳은 기획과 논리를 정성스레 다듬고, 에이전트와 함께 한 줄의 코드로 우려내는 차분한 기술 공간입니다. 찻잔을 들기 전, 오늘 정성껏 준비한 세 가지 핵심 허브 메뉴와 여정의 레시피를 천천히 음미해 보세요.

Sequence of Thoughts

Latest Brewing

View All Posts
Interactive Brewing Console

실시간 다도 API 테스터

말차 로직의 다실(茶室) API와 직접 통신해 보세요. 원하는 메뉴를 선택하고 신호를 보내면, AI 찻잔이 그 결과를 가볍게 우려냅니다.

Tip: coffee를 호출하면 무슨 일이 일어날까요?

본 블로그는 차(Tea) 전용 엔진으로 글을 우려냅니다.

MATCHA-BREWING-API v1.0.0
GET/api/brew/

// Select a drink and click BREW() to start API request

> Ready to infusion...

Last 5 Updates

System Logs

Full History
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 (상세 장비)**로 명칭을 함께 개편했습니다.
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)와의 심층 비평 협업 대화를 추가하고 배경 설명 영역의 디자인을 개편했습니다. 또한, 특정 비정상적인 접근 시 지정된 에러 페이지로 부드럽게 안내하도록 우회 리다이렉트 경로 규칙을 적용했습니다.