spaxel/dashboard/index.html
jedarden 5ddb8973e2 feat(dashboard): interactive onboarding wizard for ESP32-S3 node provisioning
Web Serial-based wizard that takes a non-technical user from unboxed
ESP32-S3 to streaming CSI in under 5 minutes. 8-step state machine:
browser check → connect → flash firmware (esp-web-tools) → provision
WiFi → detect node → guided calibration → placement guidance → complete.

Includes sessionStorage persistence for resumability across page refreshes,
live CSI waveform during calibration, human-friendly error messages for
all failure modes, and comprehensive Jest test coverage (34 tests).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-28 02:36:58 -04:00

863 lines
22 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Spaxel Dashboard</title>
<style>
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
background: #1a1a2e;
color: #eee;
overflow: hidden;
}
#scene-container {
width: 100vw;
height: 100vh;
}
/* Status bar at top */
#status-bar {
position: fixed;
top: 0;
left: 0;
right: 0;
height: 40px;
background: rgba(0, 0, 0, 0.7);
display: flex;
align-items: center;
padding: 0 16px;
gap: 24px;
z-index: 100;
font-size: 14px;
}
.status-item {
display: flex;
align-items: center;
gap: 8px;
}
.status-dot {
width: 10px;
height: 10px;
border-radius: 50%;
background: #666;
}
.status-dot.connected {
background: #4caf50;
box-shadow: 0 0 8px #4caf50;
}
.status-dot.disconnected {
background: #f44336;
}
/* Amplitude chart overlay */
#chart-panel {
position: fixed;
bottom: 20px;
right: 20px;
width: 400px;
height: 260px;
background: rgba(0, 0, 0, 0.8);
border-radius: 8px;
padding: 12px;
z-index: 100;
}
#chart-title {
font-size: 12px;
color: #888;
margin-bottom: 6px;
}
#chart-title .link-id {
color: #4fc3f7;
font-family: monospace;
}
#amplitude-chart {
width: 100%;
height: 130px;
display: block;
}
#chart-divider {
border: none;
border-top: 1px solid rgba(255,255,255,0.08);
margin: 6px 0;
}
#timeseries-label {
font-size: 10px;
color: #555;
margin-bottom: 4px;
}
#timeseries-chart {
width: 100%;
height: 64px;
display: block;
}
/* Node list panel */
#node-panel {
position: fixed;
top: 60px;
left: 20px;
width: 280px;
max-height: calc(100vh - 80px);
background: rgba(0, 0, 0, 0.8);
border-radius: 8px;
padding: 12px;
z-index: 100;
overflow-y: auto;
}
#node-panel h3 {
font-size: 14px;
color: #888;
margin-bottom: 12px;
text-transform: uppercase;
letter-spacing: 1px;
}
.node-item {
padding: 8px;
margin-bottom: 4px;
background: rgba(255, 255, 255, 0.05);
border-radius: 4px;
font-size: 13px;
cursor: pointer;
transition: background 0.2s;
}
.node-item:hover {
background: rgba(255, 255, 255, 0.1);
}
.node-item.selected {
background: rgba(79, 195, 247, 0.2);
border: 1px solid rgba(79, 195, 247, 0.5);
}
.node-mac {
font-family: monospace;
color: #4fc3f7;
}
.node-status {
float: right;
font-size: 11px;
padding: 2px 6px;
border-radius: 3px;
}
.node-status.online {
background: rgba(76, 175, 80, 0.3);
color: #81c784;
}
.node-status.offline {
background: rgba(244, 67, 54, 0.3);
color: #e57373;
}
/* Empty state */
.empty-state {
text-align: center;
color: #666;
padding: 20px;
font-size: 13px;
}
/* Link list */
.link-section {
margin-top: 16px;
border-top: 1px solid rgba(255, 255, 255, 0.1);
padding-top: 12px;
}
.link-item {
padding: 6px 8px;
margin-bottom: 4px;
background: rgba(255, 255, 255, 0.03);
border-radius: 4px;
font-size: 12px;
cursor: pointer;
display: flex;
justify-content: space-between;
}
.link-item:hover {
background: rgba(255, 255, 255, 0.08);
}
.link-item.selected {
background: rgba(79, 195, 247, 0.2);
}
/* Presence badge */
.presence-badge {
font-size: 10px;
font-weight: 600;
padding: 2px 6px;
border-radius: 3px;
letter-spacing: 0.5px;
}
.presence-badge.motion {
background: rgba(244, 67, 54, 0.25);
color: #ef5350;
}
.presence-badge.clear {
background: rgba(76, 175, 80, 0.2);
color: #66bb6a;
}
/* Overall presence indicator in status bar */
#presence-indicator {
font-size: 12px;
font-weight: 600;
padding: 3px 8px;
border-radius: 4px;
transition: background 0.3s, color 0.3s;
}
#presence-indicator.motion {
background: rgba(244, 67, 54, 0.3);
color: #ef5350;
}
#presence-indicator.clear {
background: rgba(76, 175, 80, 0.15);
color: #66bb6a;
}
/* View preset buttons */
.view-btn {
background: rgba(255,255,255,0.08);
border: 1px solid rgba(255,255,255,0.15);
color: #ccc;
font-size: 12px;
padding: 3px 10px;
border-radius: 4px;
cursor: pointer;
transition: background 0.2s, color 0.2s;
}
.view-btn:hover { background: rgba(79,195,247,0.2); color: #4fc3f7; }
.view-btn.active { background: rgba(79,195,247,0.25); color: #4fc3f7; border-color: #4fc3f7; }
#floorplan-btn {
background: rgba(255,255,255,0.06);
border: 1px solid rgba(255,255,255,0.12);
color: #888;
font-size: 12px;
padding: 3px 10px;
border-radius: 4px;
cursor: pointer;
transition: background 0.2s;
}
#floorplan-btn:hover { background: rgba(255,255,255,0.12); color: #ccc; }
/* Presence panel */
#presence-panel {
position: fixed;
top: 60px;
right: 20px;
width: 300px;
background: rgba(0, 0, 0, 0.8);
border-radius: 8px;
padding: 12px;
z-index: 100;
}
#presence-header {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 10px;
}
#presence-header h3 {
font-size: 14px;
color: #888;
text-transform: uppercase;
letter-spacing: 1px;
margin: 0;
}
#presence-status {
font-size: 11px;
font-weight: 600;
padding: 2px 8px;
border-radius: 4px;
transition: background 0.3s, color 0.3s;
}
#presence-status.motion {
background: rgba(244, 67, 54, 0.3);
color: #ef5350;
}
#presence-status.clear {
background: rgba(76, 175, 80, 0.15);
color: #66bb6a;
}
#presence-list {
max-height: 200px;
overflow-y: auto;
}
.presence-row {
display: flex;
align-items: center;
gap: 8px;
padding: 5px 8px;
margin-bottom: 3px;
background: rgba(255, 255, 255, 0.03);
border-radius: 4px;
font-size: 12px;
cursor: pointer;
transition: background 0.2s;
}
.presence-row:hover {
background: rgba(255, 255, 255, 0.08);
}
.presence-row.selected {
background: rgba(79, 195, 247, 0.2);
}
.presence-dot {
width: 10px;
height: 10px;
border-radius: 50%;
flex-shrink: 0;
transition: background 0.3s;
}
.presence-dot.clear {
background: #66bb6a;
box-shadow: 0 0 6px rgba(102, 187, 106, 0.5);
}
.presence-dot.motion {
background: #ffa726;
box-shadow: 0 0 6px rgba(255, 167, 38, 0.5);
}
.presence-dot.high-confidence {
background: #ef5350;
box-shadow: 0 0 6px rgba(239, 83, 80, 0.5);
}
.presence-link-id {
font-family: monospace;
color: #aaa;
flex: 1;
}
.presence-rms {
font-family: monospace;
color: #888;
font-size: 11px;
}
#deltarms-label {
font-size: 10px;
color: #555;
margin-top: 8px;
margin-bottom: 4px;
}
#deltarms-chart {
width: 100%;
height: 80px;
display: block;
}
/* ===== Onboarding Wizard ===== */
#wizard-overlay {
position: fixed;
top: 0;
left: 0;
right: 0;
bottom: 0;
background: rgba(0, 0, 0, 0.85);
display: flex;
align-items: center;
justify-content: center;
z-index: 1000;
}
#wizard-card {
background: #1e1e3a;
border-radius: 12px;
padding: 28px 32px 20px;
max-width: 560px;
width: 92%;
max-height: 90vh;
overflow-y: auto;
box-shadow: 0 8px 32px rgba(0, 0, 0, 0.5);
}
#wizard-header {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 20px;
}
#wizard-header h1 {
font-size: 20px;
font-weight: 600;
color: #eee;
}
.wizard-close {
background: none;
border: none;
color: #888;
font-size: 24px;
cursor: pointer;
padding: 0 4px;
line-height: 1;
}
.wizard-close:hover {
color: #eee;
}
/* Step indicator */
#wizard-steps {
display: flex;
align-items: center;
justify-content: center;
margin-bottom: 24px;
gap: 0;
}
.wizard-step-dot {
width: 28px;
height: 28px;
border-radius: 50%;
display: flex;
align-items: center;
justify-content: center;
font-size: 11px;
font-weight: 600;
background: #333;
color: #666;
transition: all 0.3s;
flex-shrink: 0;
}
.wizard-step-dot.active {
background: #4fc3f7;
color: #fff;
box-shadow: 0 0 12px rgba(79, 195, 247, 0.5);
}
.wizard-step-dot.completed {
background: #4caf50;
color: #fff;
}
.wizard-step-line {
width: 20px;
height: 2px;
background: #333;
flex-shrink: 0;
}
.wizard-step-line.completed {
background: #4caf50;
}
/* Content */
#wizard-content {
min-height: 180px;
}
.wizard-step-content {
text-align: center;
}
.wizard-step-content h2 {
font-size: 18px;
margin-bottom: 8px;
color: #eee;
}
.wizard-step-content p {
color: #bbb;
font-size: 14px;
line-height: 1.5;
margin-bottom: 12px;
}
.wizard-muted {
color: #777 !important;
font-size: 13px !important;
}
.wizard-center-msg {
padding: 24px 0;
text-align: center;
}
.wizard-center-msg p {
color: #888;
margin-top: 12px;
}
.wizard-error {
color: #ef5350;
font-size: 13px;
padding: 10px;
background: rgba(239, 83, 80, 0.1);
border-radius: 4px;
text-align: left;
margin-top: 8px;
}
.wizard-success {
color: #66bb6a;
font-size: 14px;
font-weight: 500;
}
.wizard-warn {
color: #ffa726;
font-size: 13px;
}
.wizard-icon-large {
font-size: 48px;
margin-bottom: 12px;
}
.wizard-success-icon {
color: #66bb6a;
}
.wizard-list {
text-align: left;
color: #bbb;
font-size: 13px;
line-height: 1.8;
margin: 12px 0;
padding-left: 20px;
}
.wizard-list li {
margin-bottom: 4px;
}
.wizard-details {
text-align: left;
margin: 12px 0;
}
.wizard-details summary {
color: #888;
font-size: 13px;
cursor: pointer;
}
.wizard-details summary:hover {
color: #bbb;
}
/* Spinner */
.spinner {
display: inline-block;
width: 32px;
height: 32px;
border: 3px solid rgba(79, 195, 247, 0.2);
border-top-color: #4fc3f7;
border-radius: 50%;
animation: wizard-spin 0.8s linear infinite;
}
@keyframes wizard-spin {
to { transform: rotate(360deg); }
}
/* Progress bar */
.wizard-progress {
margin: 16px 0;
}
.progress-bar {
width: 100%;
height: 8px;
background: #333;
border-radius: 4px;
overflow: hidden;
}
.progress-fill {
height: 100%;
background: linear-gradient(90deg, #4fc3f7, #29b6f6);
border-radius: 4px;
transition: width 0.3s;
width: 0%;
}
.wizard-progress p {
font-size: 12px;
color: #888;
margin-top: 6px;
text-align: center;
}
/* Buttons */
.wizard-btn {
padding: 10px 24px;
border-radius: 6px;
font-size: 14px;
font-weight: 500;
cursor: pointer;
border: none;
transition: background 0.2s, opacity 0.2s;
}
.wizard-btn:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.wizard-btn-primary {
background: #4fc3f7;
color: #1a1a2e;
}
.wizard-btn-primary:hover:not(:disabled) {
background: #29b6f6;
}
.wizard-btn-secondary {
background: rgba(255, 255, 255, 0.1);
color: #ccc;
border: 1px solid rgba(255, 255, 255, 0.2);
}
.wizard-btn-secondary:hover:not(:disabled) {
background: rgba(255, 255, 255, 0.15);
}
#wizard-nav {
display: flex;
justify-content: space-between;
margin-top: 20px;
gap: 12px;
}
/* Form */
.wizard-form {
text-align: left;
margin-top: 16px;
}
.form-group {
margin-bottom: 12px;
}
.form-group label {
display: block;
font-size: 13px;
color: #aaa;
margin-bottom: 4px;
}
.form-group input {
width: 100%;
padding: 8px 12px;
background: rgba(255, 255, 255, 0.08);
border: 1px solid rgba(255, 255, 255, 0.15);
border-radius: 4px;
color: #eee;
font-size: 14px;
box-sizing: border-box;
}
.form-group input:focus {
outline: none;
border-color: #4fc3f7;
box-shadow: 0 0 0 2px rgba(79, 195, 247, 0.2);
}
.form-group input::placeholder {
color: #555;
}
/* ESP32 illustration */
.esp32-illustration {
margin: 16px auto;
text-align: center;
}
/* Calibration phases */
.calibrate-phase {
margin: 8px 0;
}
.calibrate-phase-number {
font-size: 11px;
color: #4fc3f7;
text-transform: uppercase;
letter-spacing: 1px;
margin-bottom: 4px;
}
.calibrate-phase h3 {
font-size: 16px;
color: #eee;
margin-bottom: 6px;
}
.calibrate-phase p {
color: #bbb;
font-size: 14px;
}
/* Add Node button in status bar */
#add-node-btn {
background: rgba(79, 195, 247, 0.15);
border: 1px solid rgba(79, 195, 247, 0.4);
color: #4fc3f7;
font-size: 12px;
padding: 3px 10px;
border-radius: 4px;
cursor: pointer;
transition: background 0.2s;
}
#add-node-btn:hover {
background: rgba(79, 195, 247, 0.25);
}
/* esp-web-install-button overrides */
esp-web-install-button {
display: block;
}
esp-web-install-button::part(button) {
background: #4fc3f7;
color: #1a1a2e;
border: none;
padding: 10px 24px;
border-radius: 6px;
font-size: 14px;
font-weight: 500;
cursor: pointer;
}
</style>
</head>
<body>
<!-- Status bar -->
<div id="status-bar">
<div class="status-item">
<div id="ws-status" class="status-dot disconnected"></div>
<span id="ws-status-text">Disconnected</span>
</div>
<div class="status-item">
<span>Nodes: <strong id="node-count">0</strong></span>
</div>
<div class="status-item">
<span>Links: <strong id="link-count">0</strong></span>
</div>
<div class="status-item">
<span id="presence-indicator" class="clear">CLEAR</span>
</div>
<div class="status-item" style="margin-left:auto; gap:6px;">
<button id="add-node-btn" onclick="SpaxelOnboard && SpaxelOnboard.start()">+ Add Node</button>
<button class="view-btn active" id="view-perspective" onclick="Viz3D.setViewPreset('perspective')">3D</button>
<button class="view-btn" id="view-topdown" onclick="Viz3D.setViewPreset('topdown')">Top</button>
<button class="view-btn" id="view-follow" onclick="Viz3D.setViewPreset('follow')">Follow</button>
<button id="floorplan-btn" onclick="document.getElementById('floorplan-input').click()">Floor plan</button>
<input id="floorplan-input" type="file" accept="image/*" style="display:none"
onchange="Viz3D.uploadFloorPlan(this.files[0]); this.value=''">
</div>
<div class="status-item">
<span>FPS: <strong id="fps-counter">0</strong></span>
</div>
</div>
<!-- 3D Scene container -->
<div id="scene-container"></div>
<!-- Node panel -->
<div id="node-panel">
<h3>Nodes</h3>
<div id="node-list">
<div class="empty-state">No nodes connected</div>
</div>
<div class="link-section">
<h3>Links</h3>
<div id="link-list">
<div class="empty-state">No links active</div>
</div>
</div>
</div>
<!-- Amplitude chart -->
<div id="chart-panel">
<div id="chart-title">Amplitude — <span class="link-id">no link selected</span></div>
<canvas id="amplitude-chart"></canvas>
<hr id="chart-divider">
<div id="timeseries-label">Mean amplitude (60 s)</div>
<canvas id="timeseries-chart"></canvas>
</div>
<!-- Presence panel -->
<div id="presence-panel">
<div id="presence-header">
<h3>Presence</h3>
<span id="presence-status" class="clear">CLEAR</span>
</div>
<div id="presence-list">
<div class="empty-state">No links active</div>
</div>
<div id="deltarms-label">Delta RMS (10 s)</div>
<canvas id="deltarms-chart"></canvas>
</div>
<!-- Three.js from CDN -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/r128/three.min.js"></script>
<!-- OrbitControls from CDN -->
<script src="https://cdn.jsdelivr.net/npm/three@0.128.0/examples/js/controls/OrbitControls.js"></script>
<!-- 3-D spatial visualisation layer -->
<script src="js/viz3d.js"></script>
<!-- Main application -->
<script src="js/app.js"></script>
<!-- esp-web-tools for firmware flashing (Web Serial) -->
<script type="module" src="https://espressif.github.io/esp-web-tools/dist/web/install-button.js"></script>
<!-- Onboarding wizard -->
<script src="js/onboard.js"></script>
<script>
// Keep view-preset buttons in sync with active state
['perspective','topdown','follow'].forEach(function(p) {
document.getElementById('view-' + p).addEventListener('click', function() {
document.querySelectorAll('.view-btn').forEach(function(b) { b.classList.remove('active'); });
this.classList.add('active');
});
});
</script>
</body>
</html>