hola

Hola는 매니아와 고급 사용자를 위해 설계된 현대적인 홈 랩 앱 배포 플랫폼입니다. 웹 대시보드에서 개인 서버에 자체 호스팅 애플리케이션을 발견, 설치, 관리할 수 있는 안내형 사용자 경험을 제공합니다. 이 프로젝트는 Bun 워크스페이스를 사용하는 TypeScript 우선 모노레포로, React 웹 UI, Bun 기반 서버 API, 공유 타입, CLI, SDK, Docker Compose 스택을 포함합니다. 구현된 기능으로는 검색 및 세부 정보가 있는 앱 카탈로그, 환경 변수 편집이 가능한 안내 설치 마법사, Docker Compose 오버라이드, 구성/비밀 파일 업로드, 엄격한 검증, 사전 점검이 있습니다. 배포 수명 주기 제어(시작, 중지, 재시작, 삭제, 롤백), Traefik 기반 라우팅, 상태 확인, 실시간 로그, 상태 보기도 제공됩니다. 상태는 재시작 후에도 유지되며, 인증은 관리자 API 키를 사용합니다. 아직 구현되지 않은 로드맵 항목에는 알림, UI 복원이 포함된 예약 백업, 외부 ID 공급자를 통한 애플리케이션 SSO가 있습니다. 이 프로젝트는 명시적으로 로컬/자체 호스팅 환경을 대상으로 하며, 엔터프라이즈 또는 멀티 테넌트 사용 사례는 대상이 아닙니다. 모노레포 구조에는 웹, 서버, 공유, CLI, SDK, 컴포즈 패키지가 포함됩니다. 기술 스택은 Bun 1.3.14, TypeScript 6.x, Vite, React, TailwindCSS, React Router, SSE를 사용하는 Bun 네이티브 HTTP를 사용합니다. 설치가 간단합니다. 한 줄 설치 프로그램이 Docker 및 Docker Compose v2가 있는 호스트에 프로덕션 스택(Traefik + 웹 + 서버)을 설정합니다. CLI는 별도로 설치할 수 있으며 환경 변수를 통해 기존 서버를 가리키도록 구성할 수 있습니다. 개발자를 위해 저장소는 개발, 테스트(실제 Docker 통합 테스트 포함), 타입 검사, 린팅, 빌드 스크립트를 제공합니다. 문서는 아키텍처, 운영, 인증 결정, 기여 지침을 다룹니다.