VEFA Factory: Fleet Management System (VEFA Factory: 3D FMS)

VEFA Factory: 3D FMS is an edge-deployed, local-network 3D printing factory coordinator designed to discover, monitor, coordinate, and automate 10 or more 3D printers across mixed-hardware fleets (Klipper/Moonraker, Bambu Lab LAN mode, PrusaLink/OctoPrint).

Built specifically for commercial additive manufacturing workshops, print-on-demand studios, and maker factories to eliminate machine idle time, prevent filament runout losses, and streamline operator floor handover via spool-aware consecutive printing, two-way actionable SMS alerts, consensual MCP scheduling, and dynamic technician shift routing.

---

Release Milestones (Isolated for Posterity)

Every major milestone is self-contained and frozen in its own dedicated directory:

Milestone	Directory	Core Milestone Focus
v0.1.0	VEFA_Factory_3D_FMS_v0.1.0/	10-printer mixed fleet MVP, Onboarding Wizard (/wizard), Spool-aware consecutive scheduler, Two-way SMS, Mobile floor view (/mobile).
v0.1.1	VEFA_Factory_3D_FMS_v0.1.1/	Safe DevOps edition: Passive Wire-Tap Transport Guard, Glass Cockpit (/dev), RTT jitter matrix, Decoupled step sandboxes.
v0.1.2	VEFA_Factory_3D_FMS_v0.1.2/	Consensual APIs & MCP edition: Granular Arming Gate (PIN protected), Pre-flight G-code linter, Native MCP Server (/api/mcp).
v0.1.3	VEFA_Factory_3D_FMS_v0.1.3/	Shift operations edition: Dynamic Technician Roster, 1-click & SMS phone hot-swapping, 15-min alert escalation loop, Bed-side printable QR labels, Native camera snapshots.
v0.2.0	roadmap_v0.2.md	Autonomous Floor Operations & Operator Handover (Multi-Cam Live Matrix, Spool Barcode Allocation, Batch Run-Lists, Shift Handover Reports).

---

System Architecture

flowchart TB
    subgraph EdgeServer ["VEFA Factory: 3D FMS v0.1.3 Core (Port 3000)"]
        Dashboard["Factory Floor Console (/)\n(10-Printer Matrix • Live Telemetry • Camera Previews)"]
        Mobile["Mobile Floor Touch Console (/mobile)\n(QR Deep-Link • 1-Tap Bed Clear • SMS Cheat Sheet)"]
        DevCockpit["Dev Team Glass Cockpit (/dev)\n(Wire-Tap Sniffer • RTT Jitter • CLI Replicator)"]
        MCPServer["Native Model Context Protocol (MCP) Server (/api/mcp)\n(JSON-RPC 2.0 Agent Scheduling Tools)"]

        subgraph CoreServices ["Core Services"]
            WireTap["Passive Wire-Tap Transport Guard\n(GET-Only Whitelist • Granular Arming Gate PIN: 1234)"]
            Scheduler["Spool-Aware Consecutive Scheduler\n(Auto-Dispatch • Shadow Dispatch Engine)"]
            Linter["Pre-Flight G-code Linter\n(Envelope Bounds • Temp Safety • Forbidden G-code)"]
            ShiftRouter["Multi-Technician Shift & Rack Router\n(Dynamic Phone Swapping • 15-min Escalation)"]
            CameraQR["Camera & QR Label Engine\n(Printable SVG QR Codes • Native Snapshot HUD)"]
            Database[("Local Embedded SQLite Database\n(node:sqlite in WAL Mode)")]
        end
    end

    subgraph FactoryFleet ["Workshop Floor (10+ Mixed-Fleet 3D Printers)"]
        Bambu["Bambu Lab Fleet (X1-C, P1S, A1 Mini)"]
        Klipper["Klipper / Voron Fleet (Voron 2.4, Trident, K1 Max)"]
        Prusa["Prusa Fleet (MK4 #1, MK4 #2)"]
    end

    subgraph FloorTeam ["Technician Roster & Supervisors"]
        TechA["Rack A Technician (+1-555-0199)"]
        TechB["Rack B Technician (+1-555-0199)"]
        TechC["Rack C Technician (+1-555-0244)"]
        Supervisor["Shift Supervisor (+1-555-0100)"]
    end

    Dashboard & Mobile & DevCockpit & MCPServer <--> CoreServices
    CoreServices <--> WireTap
    WireTap <--> FactoryFleet
    ShiftRouter <--> FloorTeam

Loading

---

Key Capabilities

1. Dynamic Technician Roster & Shift Hot-Swapping (/api/technicians)

• Per-Rack Routing: Priority alerts route to the designated technician's mobile phone based on rack assignment (Rack A $\to$ Tech A, Rack B $\to$ Tech B, Rack C $\to$ Tech C).
• 1-Click & Inbound SMS Hot-Swapping:
  • Swap phone numbers directly from the web dashboard or on the shop floor via SMS:
    • SWAP RACK A TO +15559876543
    • ON DUTY RACK B
    • ROSTER (returns current on-duty technician names, phones, and rack stations)
• 15-Minute Floor Escalation Fallback:
  • When a print finishes or a bed cools, an escalation timer begins. If the primary technician does not clear the bed within 15 minutes, an escalation alert automatically dispatches to the Shift Supervisor.

2. Bed-Side Printable QR Labels & Mobile 1-Tap Action (/api/printers/:id/qr)

• Printable Industrial SVG QR Labels: Every machine has an instant, vector printable QR label sticker.
• Floor Deep-Link: Technicians scan the physical QR code on the printer frame with their smartphone camera, immediately opening that machine's card on /mobile with a 1-tap "Confirm Bed Cleared" button.

3. Native Camera Snapshot & Telemetry HUD (/api/printers/:id/snapshot)

• Zero Heavy ML Dependencies: Ingests native HTTP snapshot streams from Moonraker, PrusaLink, and Bambu Lab without requiring high-overhead GPU containers.
• Fallback HUD: Renders clean, high-contrast dark-mode telemetry cards with extruder temperatures, bed cooldown progress, and active layer numbers.

4. Spool Decrementing & Low-Filament Warnings

• Automatic Filament Deductions: Deducts consumed filament weight ($W_{\text{job}}$) from the active spool upon job completion.
• Advance Warning: Automatically texts the rack technician when a spool drops below $100\text{g}$ remaining weight so a replacement spool can be staged before the next job.

5. Native Model Context Protocol (MCP) Server (/api/mcp)

• Standard JSON-RPC 2.0 server enabling external autonomous AI agents to manage the factory floor.
• Tools exposed: get_fleet_status, query_printer_capabilities, lint_gcode_file, probe_printer_readiness, evaluate_consecutive_queue, set_printer_armed_state.

---

Quickstart & Installation

Prerequisites

• Node.js version 20 or higher (node -v)
• Git

1. Clone & Install Dependencies

git clone https://github.com/your-org/vefa-factory-3d-fms.git
cd vefa-factory-3d-fms
npm install

2. Start the Server

npm start

3. Access Web Interfaces

• Factory Floor Command Console: http://localhost:3000
• Mobile Floor Operator App: http://localhost:3000/mobile
• Dev Team Glass Cockpit: http://localhost:3000/dev
• Setup & Onboarding Wizard: http://localhost:3000/wizard

---

Automated Verification Suites

VEFA Factory includes four comprehensive test suites:

# 1. Technician Roster, Shift Swapping & Escalation Suite (v0.1.3)
npm run test:roster

# 2. Consensual API Contracts, MCP Server & Arming Gate Suite (v0.1.2)
npm run test:consensual

# 3. Transport Wire-Tap Safety Interlock Suite (v0.1.1)
npm run test:safety

# 4. Spool-Aware Consecutive Scheduler & SMS Integration Suite (v0.1.0)
npm test

All 4 test suites execute with 100% pass rates.

---

License

MIT License © 2026 ConsultDevin.