System Architecture

System Architecture

Logical Architecture

React 18 + Vite (Browser UI)  ──>  FastAPI 2.1 (HTTP + WebSocket)
      │                                    │
      ├── Canvas Views + WebAudio          ├── NumPy / SciPy DSP Engine
      └── Local Browser DSP Fallback       ├── Canonical Nodes + Kahn Engine
                                           ├── Python + S-Expression Sandbox
                                           └── Vibration Workbench + Plot Renderer

Processing Pipeline Order

The standard /api/process route applies processing stages in a strict deterministic sequence:

1. Signal Generation or File Ingestion
2. Gain / DC Offset / Quantization / Hilbert Envelope Extraction
3. Fail-Closed Filter Execution (Butterworth, Chebyshev, Elliptic, Bessel, FIR, Median)
4. FFT, Phase & Metric Telemetry (THD, SNR, SINAD, SFDR, ENOB)
5. Spectrogram Generation & JSON Response