# Roastbook

> 내가 호스팅하는 커피 기록 — 커피 봉지를 찍으면 라벨을 읽어 채워 주는, 내 서버에 직접 올리는 원두·추출 기록 앱.

- 페이지: https://tesign.com/item/roastbook/
- JSON: https://tesign.com/item/roastbook/index.json
- 영어 마크다운: https://tesign.com/en/item/roastbook/index.md
- 생성 시각: 2026-09-22 07:26 UTC

## 숫자

- 별 2 — GitHub에서 2026-09-14 23:21 UTC 확인
- 7일 별 증가 관측 없음 (GH Archive) (기준 2026-09-22 03:00 UTC)
- Show HN 1점 — 2026-09-21 06:15 UTC 관측
- 별 총합 = GitHub에서 마지막으로 확인한 값(stars_checked_at) + 그 뒤 GH Archive에서 관측한 증가. 24h·7d·30d 증가는 GH Archive 시간별 이벤트를 기준 시각(as_of)까지 합한 값. 우리 점수는 없습니다.

## 한눈에 보는 사실

- 라이선스: MIT (허용적) — https://spdx.org/licenses/MIT.html
- 사용 범위: 상업 이용·수정·재배포 가능. 저작권 고지는 유지.
- 오픈소스: 예
- 언어: TypeScript
- 플랫폼: web · linux
- 분류: 생산성
- 태그: 커피 · 자체 설치 · postgresql · ai 라벨 인식
- 바로 쓰기: 직접 서버에
- 출처: Show HN https://github.com/michidk/roastbook
- SELF-HOST: https://roastbook.vercel.app/

## 활동

- 마지막 커밋: 2026-09-14 14:10 UTC
- 최근 릴리스: [확인 필요]
- 기여자: [확인 필요]
- 열린 이슈 (PR 포함): [확인 필요]
- 만든 이: [확인 필요]
- GitHub 확인 시각: 2026-09-14 23:21 UTC

## 선정 신호와 근거

- 신규 · 생성 10h 만에 포착

## TESIGN TAKE

표본 데이터로 바로 써 보는 읽기 전용 데모가 있어, 설치하기 전에 진짜 화면부터 확인할 수 있다는 점이 실용적이다.

## 왜 볼 만한가

원두·로스터·추출 기록을 남기려 해도 대개 남의 서버에 데이터가 쌓인다. Roastbook은 자기 서버에 직접 올려 쓰는 방식이고, 봉지 사진 한 장으로 원산지·품종·로스팅 정도를 채우고 로스터 이름만 쳐도 웹사이트와 위치를 찾아 준다. 추출은 숫자 세 개만 입력해도 기록이 끝난다.

## 이걸로 무엇을 만들 수 있나

- PostgreSQL과 자체 저장소 위에서 돌고, 도커 컴포즈 한 줄이나 헬름 차트로 올린다. AI로 라벨을 읽거나 로스터를 조사하는 기능은 OPENAI_API_KEY를 넣어야 켜지고, 나머지는 키 없이도 그대로 쓸 수 있다. 계정·원격 측정·추가 결제가 없다고 저장소가 밝힌다.

## 누구에게 맞나

- 집에서 원두를 직접 추출하는 사람, 커피 기록을 자기 서버에 두고 싶은 사람.

## 5분 안에 시작하기

```
# roastbook.vercel.app의 읽기 전용 데모를 먼저 눌러 보고, 도커 컴포즈로 직접 올린다.
```

## 주의할 점

- 라벨 인식·로스터 조사 같은 AI 기능은 자신의 OpenAI 키가 있어야 켜지고, 그만큼 API 비용이 따로 든다. 아직 별 2개로 초기 프로젝트다.

## 영수증

- TESIGN이 처음 본 시각: 2026-09-14 23:06 UTC
- 출처 등록: 2026-09-14 13:06 UTC
- 선정: 2026-09-22 05:53 UTC
- TESIGN 게재: 2026-09-22 05:53 UTC
- 소개 글 마지막 수정: 2026-09-22 05:53 UTC

## 읽는 법

- 이 파일은 tesign.com 항목 페이지와 같은 빌드에서 같은 데이터로 만들어졌습니다. 소개 글은 편집자가 쓴 것이고, 숫자는 저장된 관측값입니다.
- JSON의 null은 관측하지 않았다는 뜻입니다 — 0이 아닙니다. 마크다운에서는 [확인 필요]로 적습니다.
- 별 총합 = GitHub에서 마지막으로 확인한 값(stars_checked_at) + 그 뒤 GH Archive에서 관측한 증가. 24h·7d·30d 증가는 GH Archive 시간별 이벤트를 기준 시각(as_of)까지 합한 값. 우리 점수는 없습니다.
- 요약이며 법적 조언이 아닙니다.

[대표 이미지] https://tesign.com/img/roastbook-fa2cf185e1.png