참고Reference · v1 preview

FAQ · 용어집FAQ & glossary

자주 묻는 질문

샌드박스가 있나요?: 알파부터 vdas_pk_test_ 키로 견본 머신 3대와 재생 샷을 제공할 계획이에요. 이 랜딩의 실샷 픽스처가 그 견본 데이터의 원형이에요.
머신이 여러 그룹이면?: 그룹마다 장치 키(…-G1, …-G2)가 있고 샷·텔레메트리는 장치 키 단위예요. 머신 객체가 그룹들을 묶어 보여 줘요.
곡선 데이터의 시간축이 균일하지 않은데요?: 허브가 CAN 수신 시각을 그대로 기록해요. 보통 100 ms 이지만 첫 샘플 구간은 어긋날 수 있어요. t_s 를 믿고 리샘플하세요.
개인정보는?: 샷에는 바리스타 이름이 없어요. 메모는 머신 소유자가 쓴 자유 텍스트라 소유자 책임 범위예요. 전시 QR 페이지의 바리스타·원두 표기는 전시 행사 설정에서만 와요.
왜 원격 추출이 없나요?: 사람이 없는 상태에서 뜨거운 물이 나오는 것은 화상·침수 위험이라, 계약 조건과 안전 심사 없이는 열지 않아요. 포터필터 감지 기반 자동 추출도 "샷 1회당 1회, 불확실하면 아무것도 안 함" 원칙으로 보드 안에서만 돌아요.

허브 (Hub): 머신 안의 Raspberry Pi 예요. 화면·로컬 웹·저울·OTA·클라우드 체크인을 맡아요.
brew_ctrl · keypad: 그룹마다 한 쌍인 제어 보드예요. 온도·펌프·밸브·패들을 제어하고(brew_ctrl) 물리 키를 읽어요(keypad).
장치 키 (device key): 서버 행의 키예요. 1그룹은 머신 시리얼 그대로, 다중 그룹은 <시리얼>-G<n>.
번들 (bundle): keypad · brew_ctrl · Pi 소프트웨어 3종을 한 버전으로 묶은 OTA 단위예요. 보드별로 따로 배포하지 않아요.
드리프트 (drift): 서버가 기대하는 번들과 머신이 보고한 번들이 다른 상태예요.
허용 목록 (whitelist): 원격으로 바꿀 수 있는 설정 키의 닫힌 목록이에요. 목록에 없으면 경로 자체가 없어요.
epoch: 설정 세대 번호예요. 쓰기 때 expected_epoch 로 동시 수정을 막아요.
Scale 모드: 저울 목표 무게에서 멈추는 추출 모드예요. 보드는 목표 무게 + 30 mL 를 안전 상한으로 잠가 둬요.
ToF: 포터필터 장착을 보는 거리 센서예요. 자동 린스·자동 추출의 근거예요.

Is there a sandbox?: From alpha, vdas_pk_test_ keys give three sample machines with replayed shots.
Multi-group machines?: One device key per group; shots and telemetry are per device key.
Why no remote extraction?: Unattended hot water is a scald and flood risk; it is not opened without contract terms and a safety review.

Hub: The Raspberry Pi inside the machine: display, local web, scales, OTA, cloud check-in.
brew_ctrl · keypad: The pair of control boards per group.
Device key: Server row key: the serial for 1-group machines, <serial>-G<n> otherwise.
Bundle: keypad + brew_ctrl + Pi software as one OTA version.
Drift: expected bundle ≠ reported bundle.
Allow-list: The closed set of remotely writable keys.
epoch: Settings generation; expected_epoch prevents lost updates.