GolemUI: 선언적 JSON 기반 폼 엔진

GolemUI는 JSON 정의로부터 동적 사용자 인터페이스를 생성하도록 설계된 오픈 소스 선언적 폼 엔진입니다. 폼 구조를 렌더링 로직에서 분리함으로써, GolemUI는 개발자가 데이터베이스나 대규모 언어 모델(LLM)을 통해 폼 스키마를 저장, 버전 관리 및 생성하면서 다양한 프론트엔드 프레임워크에 걸쳐 일관된 UI를 유지할 수 있도록 합니다.

핵심 아키텍처 및 기능

GolemUI는 JSON 기반의 폼 생성 방식을 활용하여, 폼의 상태와 구조가 하드코딩된 컴포넌트가 아닌 데이터 정의에 의해 제어될 수 있도록 합니다.

JSON 엔진 및 프레임워크 간 지원

핵심 엔진은 JSON 정의를 처리하여 UI 컴포넌트를 렌더링합니다. 이 아키텍처를 통해 단일 폼 정의를 다음과 같은 여러 환경에서 렌더링할 수 있습니다:

• React
• Angular
• Vue
• Lit
• Vanilla JavaScript

헤드리스 컴포넌트 및 스타일링

GolemUI는 CSS 변수를 사용하여 스타일링할 수 있는 28개의 헤드리스 컴포넌트를 제공합니다. 유연성을 보장하기 위해, 이 라이브러리는 Material UI, Shoelace 또는 커스텀 빌드된 컴포넌트와 같은 서드파티 컴포넌트 라이브러리를 통합할 수 있는 API를 제공합니다.

타입 기반 작성 레이어

가공되지 않은 JSON을 직접 작성하는 수동 작업을 피하기 위해, GolemUI는 타입 기반 작성 레이어(typed authoring layer)를 포함합니다. 이 프로그래밍 방식의 인터페이스를 통해 개발자는 타입 API를 사용하여 폼을 구축할 수 있으며, 이는 내부 JSON 정의를 생성하여 개발자 경험(DX)을 개선하고 구문 오류를 줄여줍니다.

MCP를 통한 LLM 통합

GolemUI는 결정론적 Model Context Protocol (MCP) 구현을 포함합니다. 이 도구 세트는 LLM이 유효한 JSON 폼 정의와 코드를 생성하도록 돕기 위해 설계되었으며, AI가 반환하는 출력이 엔진의 스키마를 준수하도록 보장하는 검증 도구를 제공합니다.

커뮤니티 피드백 및 기술적 고려 사항

출시 이후, GolemUI 커뮤니티는 라이브러리의 구현 및 장기적인 유지보수에 관한 몇 가지 기술적 질문과 우려 사항을 제기했습니다.

타입 안정성 및 필드 관계

일부 사용자는 JSON 정의 내의 필드 관계가 문자열로 표현된다는 점에 주목했습니다. 이는 이러한 관계에 대한 빌드 타임 구문 체크나 자동 완성 기능의 부재에 대한 우려로 이어졌으며, 이는 대규모 폼에서 유지보수를 복잡하게 만들 가능성이 있습니다.

스키마 진화 및 마이그레이션

GolemUI가 스키마 마이그레이션을 어떻게 처리하는지에 대한 질문이 제기되었습니다. 특히, 데이터베이스에 수천 개의 JSON 정의를 저장하는 사용자들을 위해, 커뮤니티는 컴포넌트 API의 변경을 처리하기 위한 내장된 버전 관리 시스템이나 마이그레이션 전략이 존재하는지 명확한 설명을 요구하고 있습니다.

기존 솔루션과의 비교

업계 전문가들은 "데이터 구조를 폼으로 변환"하는 개념이 새로운 것이 아니라고 지적하며, JSONForms와 같은 기존 프로젝트를 언급했습니다. 이는 GolemUI가 기존의 대안들과 비교했을 때 시장에 충분히 독특한 가치 제안을 제공하는지에 대한 논쟁으로 이어졌습니다.

보고된 이슈

초기 사용자들은 날짜 범위 선택기(date range picker)가 예상대로 작동하지 않거나 초기 컴포넌트 세트에 파일 입력 타입이 없는 것과 같은 특정 기능적 버그를를 보고했습니다.

"모든 필드 관계는 문자열로 표현되는 것 같습니다. 이는 자동 완성이나 빌드 타임 구문 또는 타입 체크를를 사용할 수 없을 수도 있음을 시사합니다."

"스키마 마이그레이션을 어떻게 처리하나요? 만약 누군가가 데이터베이스에 수천 개의 JSON 폼 정의를 저장하고 컴포넌트 API가 변경된다면, 마이그레이션 전략이나 내장된 버전 관리 시스템이 있나요?"