콘텐츠로 이동

데이터스케쳐스 위키

기술적·교육적 콘텐츠를 정리하는 내부 개발 지식 기반(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["사용자 브라우저"]

언어 구조

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

도움이 되는 링크

  • 운영 사이트: https://data-sketchers.com
  • 마케팅 저장소: apps/site — Astro 5, pnpm
  • API 저장소: apps/api — Go + Chi
  • CI/CD: GitLab .gitlab-ci.yml

문서 기여 방법

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

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