Simulator-Only MVP · Static Portfolio · No Hardware

Americano Robot Arm
Digital Twin

A browser-native digital twin wired to the MVP state model:
order → precheck → brew → dispense → clean.

21 tests passing simulator-only HardwareAdapter mock NO-GO: physical actuation
Operator Demo Cockpit

Demo script

Full sequence

Speed 1x

Auto runs the full MVP sequence. Step command advances one adapter command at a time so you can inspect state, telemetry, and motion.

Runtime state

StateIDLE
Commandwaiting
Safetyall gates green
VerdictPASS_WITH_RUNTIME_BACKLOG
Step

Telemetry

Command packet: waiting

Fault scenarios

Manual jog visual dry-run

Manual jog is visual-only maintainer dry-run. It logs intent but never arms hardware.

State timeline

Event log

System Architecture
Pipeline Overview

Request-to-cup command flow for the simulator MVP. No real hardware at any layer.

RecipeEngine
SafetyInterlock
HardwareAdapter
SimulatorAdapter

RecipeEngine

Drives the state machine through brew steps. Emits commands: move_to_portafilter, start_extraction, wait_extraction_done, dispense_water, clean.

SafetyInterlock

Gate before every motion. Checks cup, human presence, overheat, and E-stop. Blocks execution and holds DEFAULT DENY until all gates pass.

HardwareAdapter

Abstract interface for robot arm, brewer, water dispenser. In this MVP always backed by SimulatorAdapter. No real SDK calls.

SimulatorAdapter

In-process mock. Logs commands, advances state, emits telemetry. Zero serial / socket / camera code. All actuation is visual-only.

Safety Boundary
Physical Actuation: NO-GO

This system is simulator-only. The following capabilities are not present in this codebase and will not be added without a separate hardware milestone.

NO-GO — Not Implemented

  • Real robot arm SDK calls
  • Serial / socket / camera connections
  • Heater / pump / grinder / valve control
  • Backend / database / authentication
  • Physical safety certification
  • Food-service readiness claims

In Scope — Simulator Only

  • State machine simulation
  • SafetyInterlock gate enforcement
  • E-stop and fault scenario demos
  • Telemetry visualization (browser)
  • Digital twin canvas (p5.js)
  • pytest suite (21 tests)

Remaining approval gates before any hardware path: SDK integration review, physical safety certification, food-service compliance review, hardware adapter implementation and sign-off.

Proof & Evidence
Verification Status

Simulator MVP as of M3 milestone. All checks are static — no CI integration or live hardware required.

21
tests passing
pytest suite
SIM
simulator-only
HardwareAdapter mock
NO-GO
physical actuation
not implemented
PASS
verify_mvp.py
all checks
python3 -m pytest -q tests → 21 passed ✓ python3 scripts/verify_mvp.py → PASS ✓ python3 scripts/verify_phase2_readiness.py → PASS_WITH_RUNTIME_BACKLOG ✓

This portfolio page is suitable for static hosting. Run python3 -m http.server 8765 and open /web/digital-twin.html, then call window.runBrowserSmoke() in the console to verify the contract.