Featured Articles

Decision Records

  1. Architecture
    Jan 2026
    Details
    Support i18n with SEO Improvement
    ArticleADRNext.jsSEOSSRi18ninternationalizationmetadatatranslation

    next-intl, 메타데이터, 사이트맵 생성 자동화로 다중 언어 지원

    Related:Article
  2. Architecture
    Jan 2026
    Details
    Cesium Viewer Lifecycle Management and Crash Prevention
    ADRCesiumReactWebGLcontextlifecycle

    cesium-utils 경로에서 빠른 페이지 전환 시 앱이 종료되는 현상 발생: 전역 변수였던 viewer 를 route 마다 할당하고, async 가드를 설정하는 등으로 해결

  3. Architecture
    Dec 2025
    Details
    Package Build Pipeline and Type Safety in CI
    ADRBuildCIMonorepoTurborepoTypeScripttsup

    웹 앱이 패키지 소스를 직접 사용하던 방식에서 빌드된 결과물을 사용하는 방식으로 전환, 이에 따른 CI 과정 업데이트

  4. Architecture
    Dec 2025
    Details
    RSC Directives and Bundler Limitations
    ADRArchitectureDXNext.jsRSCReactbundler

    분리했던 UI 패키지를 다시 웹 앱에 통합, 리액트의 directive 를 유지하지 못하는 번들러의 한계 발견

  5. Infrastructure
    Dec 2025
    Details
    Automatic Type Generation for OpenAPI
    APIDXOpenAPISwaggerTypeScriptautomation

    Swagger/OpenAPI 사양을 따르는 API 에 대한 TypeScript 타입 생성 자동화 도입

  6. Architecture
    Dec 2025
    Details
    Renewal of Header Component
    ADRFramer MotionUI/UXdesignexperimentalstate-driven

    Header 컴포넌트 재설계: langing page, 네비게이션 바, 화면 전환 마스킹의 세 가지 역할을 동시에 수행하는 state-driven 컴포넌트

  7. Infrastructure
    Dec 2025
    Details
    Storybook + Vitest Integration for Component Testing
    DXStorybooktesting

    @storybook/addon-vitest 애드온을 활용해 Storybook 과 Vitest 를 통합, UI 컴포넌트의 동작 단위 테스트를 단일화

  8. Performance
    Nov 2025
    Details
    Timeline Improvement
    ADRNext.jsSSRSoCarchitectureoptimizationperformancerefactoring

    타임라인의 컨텐츠 부분을 Next.js 의 parallel & intercepting route 패턴을 적용해 마크다운 parsing 을 분리, HTML 크기를 319 KB 에서 257 KB 로 약 19% 감소

  9. Architecture
    Nov 2025
    Details
    Portfolio to Playground Reconstruction
    ADRNext.jsarchitecturerefactoring

    Portfolio 영역을 Playground 로 재정의하고, 파일 기반의 dynamic routes 를 static 으로 변경하되 `cesium-utils` 페이지 구성을 참고하여 하나의 configuration 이 route 목록을 관리하도록 수정

  10. Architecture
    Nov 2025
    Details
    Blog System Migration
    PlaygroundADRASTCMSMarkdowncompatibilitydatabase-drivenmigrationpipeline

    파일 기준으로 route 를 생성하던 기존 방식에서 데이터베이스 기준으로 생성하도록 블로그 시스템을 개편, markdown 렌더링을 위한 커스텀 파이프라인 구현

    Related:Playground
  11. Infrastructure
    Oct 2025
    Details
    Serverless Database Integration
    ArticleNeonPrismadatabaseedge computingserverless

    Backend 서버를 추가로 관리하지 않기 위해 Prisma ORM 과 Neon 의 serverless PostgreSQL 데이터베이스를 통합

    Related:Article
  12. Architecture
    Oct 2025
    Details
    Timeline Implementation
    ADRcomponentdesign

    2001: 스페이스 오디세이의 모노리스(monolith)로부터 영감을 받은 디자인으로 프로젝트에 대한 타임라인 컴포넌트 구현

  13. Infrastructure
    Sep 2025
    Details
    Testing Framework Migration
    DXJestPlaywrightVitesttesting

    단위 테스트 라이브러리를 Jest 에서 Vite 로 이관하고, E2E 테스트를 위한 Playwright 추가

  14. Architecture
    Sep 2025
    Details
    Cesium Utils Page Architecture Overhaul
    ArticleNext.jsSoCZustandarchitecturecontextportabilityrefactor

    Next.js 의 private folder 패턴, route 로 제한한 context 등을 활용한 리팩토링으로 서비스의 이식성, 높은 응집성 및 관심사 분리 원칙 달성

    Related:Article
  15. Performance
    Sep 2025
    Details
    Resium Removal: Native Cesium
    CesiumReactbundleoptimizationperformance

    Cesium 의 React 버전인 Resium 라이브러리를 걷어내고, Cesium 뷰어를 관리할 컴포넌트를 직접 구현해 1MB 의 번들 크기 감소

  16. Experiment
    Jul 2025
    Details
    Micro-Frontend Experiment
    ArticleMFEmulti-zoneperformancereversal

    Next.js 의 multi-zone 을 활용한 MFE 아키텍쳐를 시도했으나, 약 77% 의 성능 저하 가능성을 확인하고 기존으로 되돌림

    Related:Article
  17. Infrastructure
    Jul 2025
    Details
    Docker Build Optimization
    ArticleCI/CDDevOpsDockeroptimization

    도커 이미지 크기 최적화(526MB 에서 346MB 로 약 34% 감소) 및 레이어 효율성 99% 달성

    Related:Article
  18. Performance
    Jun 2025
    Details
    Bundle Optimization
    Articlebundlelazy loadingoptimizationperformance

    모듈 의존성 분석 및 lazy-loading 전략을 통해 66-72% 의 번들 크기 감소 달성

    Related:Article
  19. Infrastructure
    Mar 2025
    Details
    Package Manager Migration
    ArticlePNPMYarn Berrymonorepopackage manager

    Vercel 배포 환경 및 standalone 빌드 옵션 제약으로 인해 패키지 매니저를 Yarn Berry PnP 에서 PNPM 으로 전환

    Related:Article
  20. Architecture
    Mar 2025
    Details
    Monorepo Architecture
    ADRYarn Berryarchitecturemonoreposcalability

    기존 단일 어플리케이션을 모노레포 아키텍쳐로 전환하며 공유 패키지들을 분리

  21. Foundation
    Sep 2024
    Details
    Project Inception
    Next.jsPnPTypeScriptYarn Berry

    Yarn Berry 를 포함한 여러 개발 도구들을 사용한 단일 Next.js 어플리케이션 생성

Intrinsic LonelinessIntrinsic Loneliness
Analysis
2026년 1월 21일
10분 소요
Intrinsic Loneliness
Epistemic Privacy 로부터 유발되는 존재론적 공포와 이를 극복해내기 위해 발달한 인간의 사회성
Perception OverlapPerception Overlap
Analysis
2026년 1월 15일
4분 소요
Perception Overlap
우리는 어떻게 서로를 이해하는가, 이해의 본질에 대한 탐구와 인식의 중첩으로 나아가는 방법
The Great Individuals: Masking DeficienciesThe Great Individuals: Masking Deficiencies
Analysis
2026년 1월 13일
4분 소요
The Great Individuals: Masking Deficiencies
뛰어난 개인 역량이란 무엇일까? 왜 조직은 뛰어난 개인이 떠난 자리를 수습하기가 어려울까?
The Three Discovery Layers of Organizational DysfunctionThe Three Discovery Layers of Organizational Dysfunction
Analysis
2026년 1월 9일
5분 소요
The Three Discovery Layers of Organizational Dysfunction
소프트웨어 아키텍쳐가 드러내는 조직의 병폐: 누가, 어떻게 발견할 수 있을까?
Software Architecture: A Mirror Of OrganizationSoftware Architecture: A Mirror Of Organization
Analysis
2025년 12월 4일
8분 소요
Software Architecture: A Mirror Of Organization
소프트웨어 아키텍쳐는 왜, 어떻게 조직 구조를 반영하는가?
Micro Frontend (MFE): Common Misconceptions and Case StudiesMicro Frontend (MFE): Common Misconceptions and Case Studies
Analysis
2025년 8월 5일
9분 소요
Micro Frontend (MFE): Common Misconceptions and Case Studies
Micro Frontend (MFE) 의 개념, 과장된 장점들, 오해들과 함께 구현 방법 조사 및 사례 연구
Cloud Native Application and MSA: compared to Android OSCloud Native Application and MSA: compared to Android OS
Analysis
2025년 5월 22일
7분 소요
Cloud Native Application and MSA: compared to Android OS
Cloud Native 어플리케이션과 Microservices Architecture (MSA) 에 대한 Android OS 와의 비교 분석 및 MSA 설계의 핵심 고려사항들