데이터스케쳐스 위키

기술적·교육적 콘텐츠를 정리하는 내부 개발 지식 기반(Knowledge Base) 입니다. 마케팅 사이트, API, 위키, AI 캔버스를 하나의 pnpm 모노레포로 운영하며, 모든 서비스의 설계 결정과 운영 가이드는 이곳에 기록합니다.

DataSketchers(데이터스케쳐스) 는 2025년 6월 서울시립대학교 캠퍼스타운에서 설립된 스타트업입니다. 사업자등록번호 349-81-03411.

빠른 시작

아래 카드에서 시작할 지점을 선택하세요.

카테고리	설명	문서
🚀 시작하기	개발 환경 셋업, 저장소 클론, 로컬 실행	getting-started
🏗️ 아키텍처	모노레포 구조, Astro static + i18n, Go API, 배포 흐름	architecture
🤖 AI	D-SKET Canvas의 멀티벤더 LLM 추상화 레이어	ai
🎨 디자인 시스템	색상/타이포/라운딩 토큰, 반응형 그리드	design-system
🛠️ 운영 & 배포	nginx, docker-compose, cloudflared 터널, CI/CD	ops

모노레포 & 사이트 아키텍처

다이어그램은 현재 배포된 전체 구조를 요약합니다.

flowchart LR
    subgraph Repo["data-sketchers-team-land-v3 (pnpm workspace)"]
        SITE["apps/site (Astro 5, 정적 사이트)"]
        WIKI["apps/wiki (MkDocs, 이 위키)"]
        API["apps/api (Go + Chi + SQLite + S3)"]
        BLOG["apps/blog (Astro + GitLab Pages)"]
    end

    CI["GitLab CI/CD"]
    KANIKO["kaniko → nginx 이미지"]
    TUNNEL["cloudflared 터널 (data-sketchers.com)"]

    SITE --> CI
    WIKI --> CI
    BLOG --> CI
    API --> KANIKO
    KANIKO --> TUNNEL
    TUNNEL --> USER["사용자 브라우저"]

!!! note "언어 구조" 이 사이트는 한국어 우선(Korean-first) 구조이며, /en 경로로 영어 변형을 제공합니다. static-i18n 플러그인이 _suffix 문서 구조로 KO(접미사 없음)와 EN(.en.md) 페이지를 자동 매핑합니다.

!!! tip "도움이 되는 링크" - 운영 사이트: https://data-sketchers.com - 마케팅 저장소: apps/site — Astro 5, pnpm - API 저장소: apps/api — Go + Chi - CI/CD: GitLab .gitlab-ci.yml

문서 기여 방법

apps/wiki/docs/ 아래에 Markdown 파일을 추가/수정합니다.
한국어 페이지는 foo.md, 영어 twin은 foo.en.md로 함께 작성합니다.
시작하기의 체크리스트를 따라 PR을 생성합니다.

MkDocs를 로컬에서 미리보려면 apps/wiki에서 mkdocs serve 를 실행하세요.