Repolode
karlomikus

karlomikus/bar-assistant

칵테일 레시피, 재료, 재고 관리에 특화된 홈 바용 셀프 호스팅 API 서버입니다.

스타
1,117
포크
59
열린 이슈
15
마지막 커밋
그저께

어떤 프로젝트인가요?

Bar Assistant는 홈 바를 정리하고 관리할 수 있는 셀프 호스팅 백엔드입니다. 범용 레시피 관리 도구와 달리 재료 대체품, 기본 재료, ABV 계산, 단위 변환 등 칵테일에 특화된 개념을 중심으로 설계되었습니다. 칵테일 레시피 500개 이상과 카테고리가 지정된 기본 재료 250개 이상이 포함된 카탈로그를 제공합니다.

사용자는 멤버와 역할을 설정해 여러 개의 바를 만들고, 보유 재료를 관리하며, ABV, 기본 재료, 태그 또는 필요한 재료 보유 여부를 기준으로 레시피를 필터링할 수 있습니다. 없는 재료를 바탕으로 장보기 목록을 만들고 재료 가격으로 칵테일 가격을 계산할 수도 있습니다. URL, JSON, YAML 또는 컬렉션에서 레시피를 가져올 수 있으며, 공개 링크나 인쇄 기능으로 공유할 수 있습니다.

이 저장소에는 Docker 이미지로 배포되는 API 서버만 포함되어 있습니다. 캐싱과 세션에는 Redis를 사용하고, 검색에는 Meilisearch를 선택적으로 사용할 수 있으며, Prometheus 메트릭 엔드포인트도 제공합니다. 그래픽 인터페이스를 사용하려면 별도의 웹 클라이언트인 Salt Rim이 필요합니다.

핵심 기능

  • 01칵테일 레시피 500개 이상과 기본 재료 250개 이상으로 구성된 카탈로그
  • 02재고 기반 레시피 필터링 및 장보기 목록 생성
  • 03사용자 지정 재료 대체품, 변형 레시피, 평점 및 메모
  • 04멤버, 사용자 역할, 개인용 액세스 토큰을 지원하는 다중 바 관리
  • 05URL, JSON, YAML 또는 컬렉션에서 레시피 가져오기
  • 06재료 가격을 바탕으로 칵테일 가격 자동 계산
  • 07선택적 싱글 사인온(SSO) 및 Meilisearch 기반 검색

활용 사례

  • 집에 있는 주류와 믹서를 파악하고 만들 수 있는 음료 찾기
  • 칵테일 파티나 새 레시피를 위한 장보기 목록 만들기
  • 홈 바 메뉴를 운영하거나 공개 링크로 친구와 레시피 공유하기
  • 사용자 지정 프런트엔드나 연동을 위한 칵테일 레시피 API 셀프 호스팅하기

빠른 시작

  1. 1

    Docker 이미지를 가져옵니다(버전 태그를 지정해야 하며, latest 태그는 없습니다).

    docker pull barassistant/server:v4
  2. 2

    Docker 이미지로 서버를 실행하고 필요에 따라 환경 변수를 설정합니다.

사용 전 알아둘 점

  • Redis와 선택적으로 Meilisearch가 필요하므로 셀프 호스팅에는 여러 서비스가 필요합니다.
  • API 서버만 제공하므로 웹 인터페이스를 사용하려면 Salt Rim과 같은 별도의 클라이언트가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

bar-assistant은(는) 무엇인가요?
칵테일 레시피, 재료, 재고 관리에 특화된 홈 바용 셀프 호스팅 API 서버입니다. Bar Assistant는 홈 바를 정리하고 관리할 수 있는 셀프 호스팅 백엔드입니다. 범용 레시피 관리 도구와 달리 재료 대체품, 기본 재료, ABV 계산, 단위 변환 등 칵테일에 특화된 개념을 중심으로 설계되었습니다. 칵테일 레시피 500개 이상과 카테고리가 지정된 기본 재료 250개 이상이 포함된 카탈로그를 제공합니다.
bar-assistant은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
bar-assistant은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
bar-assistant은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. bar-assistant의 마지막 커밋은 2026년 11월 5일입니다.
bar-assistant은(는) 어디에 사용할 수 있나요?
집에 있는 주류와 믹서를 파악하고 만들 수 있는 음료 찾기 칵테일 파티나 새 레시피를 위한 장보기 목록 만들기 홈 바 메뉴를 운영하거나 공개 링크로 친구와 레시피 공유하기 사용자 지정 프런트엔드나 연동을 위한 칵테일 레시피 API 셀프 호스팅하기
bar-assistant는 어떻게 설치하나요?
Docker 이미지를 가져옵니다(버전 태그를 지정해야 하며, latest 태그는 없습니다).: docker pull barassistant/server:v4 Docker 이미지로 서버를 실행하고 필요에 따라 환경 변수를 설정합니다.
bar-assistant은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/karlomikus/bar-assistant

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트