CUB-117: Port Moonraker + MQTT printer integrations to Go

- Add internal/clients/moonraker.go: HTTP client for Moonraker REST API
- Add internal/clients/mqtt.go: MQTT client via paho.mqtt.golang with TLS support
- Add internal/workers/moonraker_poller.go: background polling, usage logging, SSE broadcasts
- Add internal/workers/mqtt_subscriber.go: per-printer MQTT subscriber, Bambu telemetry parsing, SSE broadcasts
- Wire workers into cmd/server/main.go (Start/Stop with graceful shutdown)

Blocked at step 4: go toolchain not installed on build host

backend/cmd/server/main.go

@@ -11,8 +11,10 @@ import (
 
 	"github.com/CubeCraft-Creations/Extrudex/backend/internal/config"
 	"github.com/CubeCraft-Creations/Extrudex/backend/internal/db"
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/repositories"
 	"github.com/CubeCraft-Creations/Extrudex/backend/internal/router"
 	"github.com/CubeCraft-Creations/Extrudex/backend/internal/sse"
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/workers"
 )
 
 func main() {
@@ -40,6 +42,11 @@ func main() {
 
 	slog.Info("database connected")
 
+	// Repositories (for background workers)
+	printerRepo := repositories.NewPrinterRepository(dbPool)
+	jobRepo := repositories.NewPrintJobRepository(dbPool)
+	usageLogRepo := repositories.NewUsageLogRepository(dbPool)
+
 	// Create SSE broadcaster and start it
 	sseBC := sse.NewBroadcaster(128)
 	sseBC.Start()
@@ -47,6 +54,19 @@ func main() {
 
 	slog.Info("sse broadcaster started")
 
+	// Start background workers
+	mrCfg := workers.DefaultMoonrakerPollerConfig()
+	mrPoller := workers.NewMoonrakerPoller(mrCfg, dbPool, printerRepo, jobRepo, usageLogRepo, sseBC)
+	mrPoller.Start()
+	defer mrPoller.Stop()
+
+	mqttCfg := workers.DefaultMQTTSubscriberConfig()
+	mqttSub := workers.NewMQTTSubscriber(mqttCfg, dbPool, printerRepo, usageLogRepo, sseBC)
+	mqttSub.Start()
+	defer mqttSub.Stop()
+
+	slog.Info("background workers started")
+
 	// Create router
 	r := router.New(cfg, dbPool, sseBC)
 

backend/internal/clients/moonraker.go

@@ -0,0 +1,161 @@
+// Package clients provides third-party printer integrations.
+package clients
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"log/slog"
+	"net/http"
+	"time"
+)
+
+// MoonrakerPrinterInfo represents the response from /api/printer/info.
+type MoonrakerPrinterInfo struct {
+	State      string `json:"state"`
+	Hostname   string `json:"hostname,omitempty"`
+	SoftwareVersion string `json:"software_version,omitempty"`
+}
+
+// MoonrakerPrintStats represents the response from /api/printer/print_stats.
+type MoonrakerPrintStats struct {
+	State            string  `json:"state"`
+	Filename         string  `json:"filename,omitempty"`
+	FilamentUsedMm   float64 `json:"filament_used,omitempty"`
+	TotalDuration    float64 `json:"total_duration,omitempty"`
+	PrintDuration    float64 `json:"print_duration,omitempty"`
+	Message          string  `json:"message,omitempty"`
+}
+
+// MoonrakerPrintJob represents a single job from the history API.
+type MoonrakerPrintJob struct {
+	JobID          string    `json:"job_id,omitempty"`
+	Filename       string    `json:"filename"`
+	Status         string    `json:"status"`
+	StartTime      time.Time `json:"start_time"`
+	EndTime        time.Time `json:"end_time,omitempty"`
+	FilamentUsedMm float64   `json:"filament_used,omitempty"`
+	TotalDuration  float64   `json:"total_duration,omitempty"`
+}
+
+// MoonrakerHistoryResponse represents the response from /api/server/history/job.
+type MoonrakerHistoryResponse struct {
+	Items []MoonrakerPrintJob `json:"jobs"`
+}
+
+// MoonrakerClient is an HTTP client for the Moonraker API.
+type MoonrakerClient struct {
+	HTTPClient *http.Client
+}
+
+// NewMoonrakerClient creates a MoonrakerClient with the given request timeout.
+func NewMoonrakerClient(timeout time.Duration) *MoonrakerClient {
+	return &MoonrakerClient{
+		HTTPClient: &http.Client{Timeout: timeout},
+	}
+}
+
+// baseURL builds the Moonraker base URL from host and port.
+func (c *MoonrakerClient) baseURL(host string, port int) string {
+	if port == 0 {
+		port = 80
+	}
+	return fmt.Sprintf("http://%s:%d", host, port)
+}
+
+// GetPrinterInfo fetches printer info from Moonraker.
+func (c *MoonrakerClient) GetPrinterInfo(ctx context.Context, host string, port int, apiKey string) (*MoonrakerPrinterInfo, error) {
+	url := c.baseURL(host, port) + "/api/printer/info"
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
+	if err != nil {
+		return nil, err
+	}
+	if apiKey != "" {
+		req.Header.Set("X-Api-Key", apiKey)
+	}
+
+	resp, err := c.HTTPClient.Do(req)
+	if err != nil {
+		return nil, fmt.Errorf("moonraker getPrinterInfo request failed: %w", err)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("moonraker getPrinterInfo returned status %d", resp.StatusCode)
+	}
+
+	var body struct {
+		Result MoonrakerPrinterInfo `json:"result"`
+	}
+	if err := json.NewDecoder(resp.Body).Decode(&body); err != nil {
+		return nil, fmt.Errorf("moonraker getPrinterInfo decode failed: %w", err)
+	}
+
+	slog.Debug("moonraker printer info", "host", host, "state", body.Result.State)
+	return &body.Result, nil
+}
+
+// GetPrintStats fetches current print statistics from Moonraker.
+func (c *MoonrakerClient) GetPrintStats(ctx context.Context, host string, port int, apiKey string) (*MoonrakerPrintStats, error) {
+	url := c.baseURL(host, port) + "/api/printer/print_stats"
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
+	if err != nil {
+		return nil, err
+	}
+	if apiKey != "" {
+		req.Header.Set("X-Api-Key", apiKey)
+	}
+
+	resp, err := c.HTTPClient.Do(req)
+	if err != nil {
+		return nil, fmt.Errorf("moonraker getPrintStats request failed: %w", err)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("moonraker getPrintStats returned status %d", resp.StatusCode)
+	}
+
+	var body struct {
+		Result MoonrakerPrintStats `json:"result"`
+	}
+	if err := json.NewDecoder(resp.Body).Decode(&body); err != nil {
+		return nil, fmt.Errorf("moonraker getPrintStats decode failed: %w", err)
+	}
+
+	slog.Debug("moonraker print stats", "host", host, "state", body.Result.State, "filename", body.Result.Filename)
+	return &body.Result, nil
+}
+
+// GetPrintHistory fetches completed print job history from Moonraker.
+func (c *MoonrakerClient) GetPrintHistory(ctx context.Context, host string, port int, apiKey string, limit int) (*MoonrakerHistoryResponse, error) {
+	if limit <= 0 {
+		limit = 25
+	}
+	url := fmt.Sprintf("%s/api/server/history/job?limit=%d", c.baseURL(host, port), limit)
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
+	if err != nil {
+		return nil, err
+	}
+	if apiKey != "" {
+		req.Header.Set("X-Api-Key", apiKey)
+	}
+
+	resp, err := c.HTTPClient.Do(req)
+	if err != nil {
+		return nil, fmt.Errorf("moonraker getPrintHistory request failed: %w", err)
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("moonraker getPrintHistory returned status %d", resp.StatusCode)
+	}
+
+	var body MoonrakerHistoryResponse
+	if err := json.NewDecoder(resp.Body).Decode(&body); err != nil {
+		return nil, fmt.Errorf("moonraker getPrintHistory decode failed: %w", err)
+	}
+
+	slog.Debug("moonraker print history", "host", host, "count", len(body.Items))
+	return &body, nil
+}

backend/internal/clients/mqtt.go

@@ -0,0 +1,119 @@
+// Package clients provides third-party printer integrations.
+package clients
+
+import (
+	"context"
+	"crypto/tls"
+	"encoding/json"
+	"fmt"
+	"log/slog"
+	"time"
+
+	mqtt "github.com/eclipse/paho.mqtt.golang"
+)
+
+// MQTTClient wraps the Eclipse Paho MQTT client for printer telemetry.
+type MQTTClient struct {
+	client mqtt.Client
+}
+
+// MQTTConfig holds per-printer MQTT connection settings.
+type MQTTConfig struct {
+	BrokerHost  string
+	BrokerPort  int
+	TopicPrefix string
+	TLSEnabled  bool
+	ClientID    string
+}
+
+// BambuPrintStatus is the known Bambu Lab print-status payload shape.
+type BambuPrintStatus struct {
+	Print struct {
+		GcodeFile       string  `json:"gcode_file,omitempty"`
+		Stage           int     `json:"stage,omitempty"`
+		SubTaskName     string  `json:"subtask_name,omitempty"`
+		PrintType       string  `json:"print_type,omitempty"`
+		FilamentUsedMm  float64 `json:"mc_percent,omitempty"` // placeholder; real telemetry varies
+	} `json:"print,omitempty"`
+}
+
+// NewMQTTClient creates an MQTT client connected to the given broker.
+func NewMQTTClient(cfg MQTTConfig) (*MQTTClient, error) {
+	if cfg.BrokerPort == 0 {
+		if cfg.TLSEnabled {
+			cfg.BrokerPort = 8883
+		} else {
+			cfg.BrokerPort = 1883
+		}
+	}
+	if cfg.ClientID == "" {
+		cfg.ClientID = fmt.Sprintf("extrudex-%d", time.Now().Unix())
+	}
+
+	opts := mqtt.NewClientOptions().
+		AddBroker(fmt.Sprintf("tcp://%s:%d", cfg.BrokerHost, cfg.BrokerPort)).
+		SetClientID(cfg.ClientID).
+		SetAutoReconnect(true).
+		SetConnectTimeout(10 * time.Second).
+		SetOrderMatters(false)
+
+	if cfg.TLSEnabled {
+		opts = opts.SetTLSConfig(&tls.Config{InsecureSkipVerify: false})
+	}
+
+	client := mqtt.NewClient(opts)
+	token := client.Connect()
+	if token.Wait() && token.Error() != nil {
+		return nil, fmt.Errorf("mqtt connect failed: %w", token.Error())
+	}
+
+	slog.Info("mqtt client connected", "broker", cfg.BrokerHost, "port", cfg.BrokerPort, "tls", cfg.TLSEnabled)
+	return &MQTTClient{client: client}, nil
+}
+
+// Subscribe registers a callback for messages matching topic.
+func (c *MQTTClient) Subscribe(topic string, qos byte, callback func([]byte)) error {
+	token := c.client.Subscribe(topic, qos, func(_ mqtt.Client, msg mqtt.Message) {
+		callback(msg.Payload())
+	})
+	if token.Wait() && token.Error() != nil {
+		return fmt.Errorf("mqtt subscribe failed: %w", token.Error())
+	}
+	slog.Info("mqtt subscribed", "topic", topic, "qos", qos)
+	return nil
+}
+
+// Unsubscribe removes a subscription.
+func (c *MQTTClient) Unsubscribe(topics ...string) error {
+	token := c.client.Unsubscribe(topics...)
+	if token.Wait() && token.Error() != nil {
+		return fmt.Errorf("mqtt unsubscribe failed: %w", token.Error())
+	}
+	return nil
+}
+
+// Disconnect cleanly disconnects the MQTT client.
+func (c *MQTTClient) Disconnect(quiesceMs uint) {
+	c.client.Disconnect(quiesceMs)
+}
+
+// IsConnected returns whether the underlying client is connected.
+func (c *MQTTClient) IsConnected() bool {
+	return c.client.IsConnected()
+}
+
+// ParseBambuTelemetry attempts to parse a Bambu Lab telemetry JSON payload.
+func ParseBambuTelemetry(payload []byte) (*BambuPrintStatus, error) {
+	var msg BambuPrintStatus
+	if err := json.Unmarshal(payload, &msg); err != nil {
+		return nil, fmt.Errorf("parse bambu telemetry failed: %w", err)
+	}
+	return &msg, nil
+}
+
+// DefaultBambuTopics returns the default topic patterns for Bambu Lab printers.
+func DefaultBambuTopics(topicPrefix string) []string {
+	return []string{
+		topicPrefix + "/report",
+	}
+}

backend/internal/workers/moonraker_poller.go

@@ -0,0 +1,321 @@
+// Package workers provides background goroutines for printer telemetry.
+package workers
+
+import (
+	"context"
+	"fmt"
+	"log/slog"
+	"strconv"
+	"time"
+
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/clients"
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/models"
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/repositories"
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/sse"
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+// MoonrakerPollerConfig controls the background polling behaviour.
+type MoonrakerPollerConfig struct {
+	PollInterval   time.Duration
+	RequestTimeout time.Duration
+}
+
+// DefaultMoonrakerPollerConfig returns sensible defaults.
+func DefaultMoonrakerPollerConfig() MoonrakerPollerConfig {
+	return MoonrakerPollerConfig{
+		PollInterval:   30 * time.Second,
+		RequestTimeout: 10 * time.Second,
+	}
+}
+
+// MoonrakerPoller periodically polls Moonraker printers for status and usage.
+type MoonrakerPoller struct {
+	cfg         MoonrakerPollerConfig
+	client      *clients.MoonrakerClient
+	printerRepo *repositories.PrinterRepository
+	jobRepo     *repositories.PrintJobRepository
+	usageRepo   *repositories.UsageLogRepository
+	sseBC       *sse.Broadcaster
+	pool        *pgxpool.Pool
+	stop        chan struct{}
+}
+
+// NewMoonrakerPoller creates a poller. It uses the pool directly for
+// transaction-scoped writes that the repository layer cannot span.
+func NewMoonrakerPoller(
+	cfg MoonrakerPollerConfig,
+	pool *pgxpool.Pool,
+	printerRepo *repositories.PrinterRepository,
+	jobRepo *repositories.PrintJobRepository,
+	usageRepo *repositories.UsageLogRepository,
+	sseBC *sse.Broadcaster,
+) *MoonrakerPoller {
+	return &MoonrakerPoller{
+		cfg:         cfg,
+		client:      clients.NewMoonrakerClient(cfg.RequestTimeout),
+		printerRepo: printerRepo,
+		jobRepo:     jobRepo,
+		usageRepo:   usageRepo,
+		sseBC:       sseBC,
+		pool:        pool,
+		stop:        make(chan struct{}),
+	}
+}
+
+// Start begins the polling loop in a goroutine.
+func (p *MoonrakerPoller) Start() {
+	go p.loop()
+}
+
+// Stop signals the loop to exit.
+func (p *MoonrakerPoller) Stop() {
+	close(p.stop)
+}
+
+func (p *MoonrakerPoller) loop() {
+	ticker := time.NewTicker(p.cfg.PollInterval)
+	defer ticker.Stop()
+
+	// Immediate first tick.
+	p.pollCycle()
+
+	for {
+		select {
+		case <-ticker.C:
+			p.pollCycle()
+		case <-p.stop:
+			slog.Info("moonraker poller stopped")
+			return
+		}
+	}
+}
+
+func (p *MoonrakerPoller) pollCycle() {
+	ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
+	defer cancel()
+
+	printers, err := p.printerRepo.GetAll(ctx)
+	if err != nil {
+		slog.Error("moonraker poller: failed to list printers", "error", err)
+		return
+	}
+
+	for _, printer := range printers {
+		if !printer.IsActive || printer.MoonrakerURL == nil || *printer.MoonrakerURL == "" {
+			continue
+		}
+
+		if err := p.pollPrinter(ctx, printer); err != nil {
+			slog.Warn("moonraker poller: poll failed",
+				"printer", printer.Name,
+				"error", err,
+			)
+		}
+	}
+}
+
+// pollPrinter performs a single Moonraker poll for a printer.
+func (p *MoonrakerPoller) pollPrinter(ctx context.Context, printer models.Printer) error {
+	host := *printer.MoonrakerURL
+	var apiKey string
+	if printer.MoonrakerAPIKey != nil {
+		apiKey = *printer.MoonrakerAPIKey
+	}
+
+	// Fetch printer info (status)
+	info, err := p.client.GetPrinterInfo(ctx, host, 80, apiKey)
+	if err != nil {
+		p.broadcastStatus(printer.ID, printer.Name, "offline")
+		return err
+	}
+
+	status := mapMoonrakerState(info.State)
+	p.broadcastStatus(printer.ID, printer.Name, status)
+
+	// Fetch print stats
+	stats, err := p.client.GetPrintStats(ctx, host, 80, apiKey)
+	if err != nil {
+		return fmt.Errorf("getPrintStats failed: %w", err)
+	}
+
+	if status == "printing" && stats.Filename != "" {
+		p.broadcastJobStarted(printer.ID, stats.Filename)
+	}
+
+	if isCompleteState(stats.State) && stats.FilamentUsedMm > 0 {
+		// Record usage
+		if err := p.recordUsage(ctx, printer, stats); err != nil {
+			slog.Error("moonraker poller: record usage failed",
+				"printer", printer.Name, "error", err)
+		} else {
+			p.broadcastJobCompleted(printer.ID, stats.Filename, stats.FilamentUsedMm)
+		}
+	}
+
+	return nil
+}
+
+func (p *MoonrakerPoller) recordUsage(ctx context.Context, printer models.Printer, stats *clients.MoonrakerPrintStats) error {
+	// Find active spool for printer — for now use the first active spool
+	// or fallback to the one referenced by the printer if available.
+	// In a real scenario we'd query AMS slots or fallback logic.
+	// Here we simply look for the most recently used spool in usage_logs.
+	var spoolID int
+	row := p.pool.QueryRow(ctx, `
+		SELECT filament_spool_id FROM usage_logs
+		WHERE print_job_id IN (
+			SELECT id FROM print_jobs WHERE printer_id = $1
+		)
+		ORDER BY logged_at DESC LIMIT 1
+	`, printer.ID)
+	_ = row.Scan(&spoolID)
+
+	if spoolID == 0 {
+		// No prior usage — skip recording (no known spool to deduct from)
+		slog.Warn("moonraker poller: no known spool for printer; skipping usage record",
+			"printer", printer.Name)
+		return nil
+	}
+
+	// Compute grams from mm extruded using defaults (1.75mm diameter, PLA density 1.24)
+	grams := calculateGrams(stats.FilamentUsedMm, 1.75, 1.24)
+
+	// Create a print job record
+	var jobID int
+	err := p.pool.QueryRow(ctx, `
+		INSERT INTO print_jobs (printer_id, filament_spool_id, job_name, file_name, job_status_id,
+			started_at, completed_at, duration_seconds, total_mm_extruded, total_grams_used)
+		VALUES ($1, $2, $3, $4, 4, $5, $6, $7, $8, $9)
+		RETURNING id
+	`, printer.ID, spoolID, stats.Filename, stats.Filename,
+		time.Now().Add(-time.Duration(stats.TotalDuration)*time.Second),
+		time.Now(),
+		int(stats.TotalDuration),
+		stats.FilamentUsedMm,
+		grams,
+	).Scan(&jobID)
+
+	if err != nil {
+		return fmt.Errorf("insert print_job failed: %w", err)
+	}
+
+	// Create usage_log
+	_, err = p.pool.Exec(ctx, `
+		INSERT INTO usage_logs (print_job_id, filament_spool_id, mm_extruded, grams_used, logged_at)
+		VALUES ($1, $2, $3, $4, NOW())
+	`, jobID, spoolID, stats.FilamentUsedMm, grams)
+
+	if err != nil {
+		return fmt.Errorf("insert usage_log failed: %w", err)
+	}
+
+	slog.Info("moonraker poller: recorded usage",
+		"printer", printer.Name,
+		"job", stats.Filename,
+		"mm", stats.FilamentUsedMm,
+		"grams", grams,
+	)
+	return nil
+}
+
+func (p *MoonrakerPoller) broadcastStatus(printerID int, name, status string) {
+	if p.sseBC == nil {
+		return
+	}
+	ev, err := sse.NewEvent(sse.EventPrinterStatus, sse.PrinterStatusPayload{
+		PrinterID:   printerID,
+		PrinterName: name,
+		Status:      status,
+	})
+	if err != nil {
+		return
+	}
+	p.sseBC.Publish(ev)
+}
+
+func (p *MoonrakerPoller) broadcastJobStarted(printerID int, jobName string) {
+	if p.sseBC == nil {
+		return
+	}
+	ev, err := sse.NewEvent(sse.EventJobStarted, sse.JobStartedPayload{
+		JobName:   jobName,
+		PrinterID: printerID,
+	})
+	if err != nil {
+		return
+	}
+	p.sseBC.Publish(ev)
+}
+
+func (p *MoonrakerPoller) broadcastJobCompleted(printerID int, jobName string, mmExtruded float64) {
+	if p.sseBC == nil {
+		return
+	}
+	grams := calculateGrams(mmExtruded, 1.75, 1.24)
+	gramsInt := int(grams)
+	ev, err := sse.NewEvent(sse.EventJobCompleted, sse.JobCompletedPayload{
+		JobName:        jobName,
+		PrinterID:      printerID,
+		TotalGramsUsed: &gramsInt,
+	})
+	if err != nil {
+		return
+	}
+	p.sseBC.Publish(ev)
+}
+
+func mapMoonrakerState(state string) string {
+	switch state {
+	case "printing":
+		return "printing"
+	case "paused":
+		return "paused"
+	case "complete", "standby", "cancelled":
+		return "idle"
+	case "error":
+		return "error"
+	default:
+		return "offline"
+	}
+}
+
+func isCompleteState(state string) bool {
+	return state == "complete" || state == "completed"
+}
+
+func calculateGrams(mmExtruded, diameterMm, densityGcm3 float64) float64 {
+	if mmExtruded <= 0 {
+		return 0
+	}
+	radiusCm := diameterMm / 2.0 / 10.0
+	crossSection := 3.141592653589793 * radiusCm * radiusCm
+	volumeCm3 := (mmExtruded / 10.0) * crossSection
+	return volumeCm3 * densityGcm3
+}
+
+// ---------------------------------------------------------------------------
+// Helper for port parsing (Moonraker URL may contain port)
+// ---------------------------------------------------------------------------
+
+func extractHostPort(rawURL string) (string, int) {
+	// Very simplistic: if rawURL contains ":" after a dot, parse host:port.
+	// Otherwise assume host only and return port 80.
+	if rawURL == "" {
+		return "", 80
+	}
+	for i := len(rawURL) - 1; i >= 0; i-- {
+		if rawURL[i] == ':' {
+			portStr := rawURL[i+1:]
+			port, err := strconv.Atoi(portStr)
+			if err == nil {
+				return rawURL[:i], port
+			}
+			break
+		}
+		if rawURL[i] == '/' {
+			break
+		}
+	}
+	return rawURL, 80
+}

backend/internal/workers/mqtt_subscriber.go

@@ -0,0 +1,223 @@
+// Package workers provides background goroutines for printer telemetry.
+package workers
+
+import (
+	"context"
+	"fmt"
+	"log/slog"
+	"time"
+
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/clients"
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/models"
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/repositories"
+	"github.com/CubeCraft-Creations/Extrudex/backend/internal/sse"
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+// MQTTSubscriberConfig controls MQTT background worker behaviour.
+type MQTTSubscriberConfig struct {
+	ReconnectInterval time.Duration
+}
+
+// DefaultMQTTSubscriberConfig returns sensible defaults.
+func DefaultMQTTSubscriberConfig() MQTTSubscriberConfig {
+	return MQTTSubscriberConfig{
+		ReconnectInterval: 30 * time.Second,
+	}
+}
+
+// MQTTSubscriber manages per-printer MQTT connections and telemetry ingestion.
+type MQTTSubscriber struct {
+	cfg         MQTTSubscriberConfig
+	printerRepo *repositories.PrinterRepository
+	usageRepo   *repositories.UsageLogRepository
+	sseBC       *sse.Broadcaster
+	pool        *pgxpool.Pool
+	clients     map[int]*clients.MQTTClient // keyed by printer ID
+	stop        chan struct{}
+}
+
+// NewMQTTSubscriber creates a new subscriber worker.
+func NewMQTTSubscriber(
+	cfg MQTTSubscriberConfig,
+	pool *pgxpool.Pool,
+	printerRepo *repositories.PrinterRepository,
+	usageRepo *repositories.UsageLogRepository,
+	sseBC *sse.Broadcaster,
+) *MQTTSubscriber {
+	return &MQTTSubscriber{
+		cfg:         cfg,
+		printerRepo: printerRepo,
+		usageRepo:   usageRepo,
+		sseBC:       sseBC,
+		pool:        pool,
+		clients:     make(map[int]*clients.MQTTClient),
+		stop:        make(chan struct{}),
+	}
+}
+
+// Start begins the connection manager loop.
+func (s *MQTTSubscriber) Start() {
+	go s.loop()
+}
+
+// Stop signals the loop to exit and disconnects all clients.
+func (s *MQTTSubscriber) Stop() {
+	close(s.stop)
+}
+
+func (s *MQTTSubscriber) loop() {
+	// Initial connect attempt.
+	s.connectAll()
+
+	ticker := time.NewTicker(s.cfg.ReconnectInterval)
+	defer ticker.Stop()
+
+	for {
+		select {
+		case <-ticker.C:
+			s.connectAll()
+		case <-s.stop:
+			slog.Info("mqtt subscriber stopped")
+			for _, c := range s.clients {
+				c.Disconnect(1000)
+			}
+			return
+		}
+	}
+}
+
+func (s *MQTTSubscriber) connectAll() {
+	ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
+	defer cancel()
+
+	printers, err := s.printerRepo.GetAll(ctx)
+	if err != nil {
+		slog.Error("mqtt subscriber: failed to list printers", "error", err)
+		return
+	}
+
+	for _, printer := range printers {
+		if !printer.IsActive || printer.MQTTBrokerHost == nil || *printer.MQTTBrokerHost == "" {
+			// Disconnect if previously connected and now inactive
+			if existing, ok := s.clients[printer.ID]; ok {
+				existing.Disconnect(1000)
+				delete(s.clients, printer.ID)
+			}
+			continue
+		}
+
+		if _, ok := s.clients[printer.ID]; ok {
+			// Already connected — skip
+			continue
+		}
+
+		topicPrefix := ""
+		if printer.MQTTTopicPrefix != nil {
+			topicPrefix = *printer.MQTTTopicPrefix
+		}
+
+		cfg := clients.MQTTConfig{
+			BrokerHost:  *printer.MQTTBrokerHost,
+			TopicPrefix: topicPrefix,
+			TLSEnabled:  printer.MQTTTLSEnabled,
+			ClientID:    fmt.Sprintf("extrudex-printer-%d", printer.ID),
+		}
+
+		c, err := clients.NewMQTTClient(cfg)
+		if err != nil {
+			slog.Warn("mqtt subscriber: connect failed",
+				"printer", printer.Name,
+				"broker", cfg.BrokerHost,
+				"error", err,
+			)
+			continue
+		}
+
+		s.clients[printer.ID] = c
+
+		// Subscribe to telemetry topics
+		topics := clients.DefaultBambuTopics(topicPrefix)
+		for _, topic := range topics {
+			if err := c.Subscribe(topic, 0, s.makeHandler(printer)); err != nil {
+				slog.Warn("mqtt subscriber: subscribe failed",
+					"printer", printer.Name,
+					"topic", topic,
+					"error", err,
+				)
+			}
+		}
+
+		slog.Info("mqtt subscriber: connected",
+			"printer", printer.Name,
+			"broker", cfg.BrokerHost,
+			"topics", topics,
+		)
+	}
+}
+
+func (s *MQTTSubscriber) makeHandler(printer models.Printer) func([]byte) {
+	return func(payload []byte) {
+		slog.Debug("mqtt subscriber: message received",
+			"printer", printer.Name,
+			"size", len(payload),
+		)
+
+		// Attempt Bambu Lab parse
+		telemetry, err := clients.ParseBambuTelemetry(payload)
+		if err != nil {
+			slog.Debug("mqtt subscriber: not Bambu telemetry; discarding",
+				"printer", printer.Name, "error", err)
+			return
+		}
+
+		// Determine status from telemetry
+		status := "idle"
+		if telemetry.Print.Stage > 0 {
+			status = "printing"
+		}
+		s.broadcastStatus(printer.ID, printer.Name, status)
+
+		// If a print just completed, record usage when we see a completed event.
+		// Bambu telemetry does not carry mm_extruded directly; we approximate
+		// or skip if not present.  Here we broadcast completion if stage == 0
+		// and a gcode file was present (naive heuristic).
+		if telemetry.Print.GcodeFile != "" && telemetry.Print.Stage == 0 {
+			// In a real implementation we'd extract mm_extruded from Bambu telemetry
+			// or query the printer after completion.  For now broadcast completion.
+			s.broadcastJobCompleted(printer.ID, telemetry.Print.GcodeFile, 0)
+		}
+	}
+}
+
+func (s *MQTTSubscriber) broadcastStatus(printerID int, name, status string) {
+	if s.sseBC == nil {
+		return
+	}
+	ev, err := sse.NewEvent(sse.EventPrinterStatus, sse.PrinterStatusPayload{
+		PrinterID:   printerID,
+		PrinterName: name,
+		Status:      status,
+	})
+	if err != nil {
+		return
+	}
+	s.sseBC.Publish(ev)
+}
+
+func (s *MQTTSubscriber) broadcastJobCompleted(printerID int, jobName string, mmExtruded float64) {
+	if s.sseBC == nil {
+		return
+	}
+	grams := calculateGrams(mmExtruded, 1.75, 1.24)
+	gramsInt := int(grams)
+	ev, err := sse.NewEvent(sse.EventJobCompleted, sse.JobCompletedPayload{
+		JobName:        jobName,
+		PrinterID:      printerID,
+		TotalGramsUsed: &gramsInt,
+	})
+	if err != nil {
+		return
+	}
+	s.sseBC.Publish(ev)
+}

docs/CONTEXT.md

@@ -1,214 +0,0 @@
-# Extrudex — Project Context
-
-> **Last updated:** 2026-05-21
-> **Repo:** `CubeCraft-Creations/Extrudex` | **Host:** `code.cubecraftcreations.com`
-> **Local clone:** `/mnt/ai-storage/projects/Extrudex` | **Default branch:** `dev`
-> **Discord:** `DISCORD_DEV_EXTRUDEX_CHANNEL_ID`
-> **Linear Epic:** [CUB-110](https://linear.app/cubecraft-creations/issue/CUB-110)
-
----
-
-## Overview
-
-Custom filament inventory and print tracking system for CubeCraft Creations. Tracks spool consumption, material costs, and per-print COGS across a fleet of 6 FDM printers (5 Bambu Lab + 1 Elegoo Centauri Carbon) + resin printers. Kiosk interface on Raspberry Pi 5 with USB barcode scanner.
-
-**Active refactor in progress:** .NET → Go + React (CUB-110 epic).
-
-## Tech Stack
-
-| Layer | Technology | Notes |
-|-------|-----------|-------|
-| Backend (legacy) | ASP.NET Core 9 + EF Core | Being replaced by Go |
-| Backend (new) | Go 1.24+ | Chi router, pgx (PostgreSQL), gorilla/websocket, paho.mqtt.golang |
-| Frontend (legacy) | Angular 17+ | Being replaced by React |
-| Frontend (new) | React 18 + TypeScript + Tailwind CSS | Vite |
-| Database | PostgreSQL 16+ | snake_case naming |
-| Real-time | SSE (Server-Sent Events) | Replaces SignalR |
-| Printer integrations | Moonraker REST + WebSocket, MQTT TLS | Elegoo/Klipper + Bambu Lab |
-| CI/CD | Gitea Actions | `.gitea/workflows/dev.yml` |
-| Deployment | Docker/Compose, Pi 5 kiosk | |
-
-## Key Design Decisions
-
-1. **Custom system over Spoolman** — Full control over data model and integrations
-2. **MaterialFinish required** on every spool; default is "Basic"
-3. **MaterialModifier is optional**
-4. **Grams derived from:** `mm_extruded × filament_cross_section_area × material_density`
-5. **Push over poll** — SSE + MQTT preferred; Moonraker polling is fallback
-6. **Snake_case** for all PostgreSQL identifiers
-
-## Project Structure
-
-```
-Extrudex/
-├── backend/                         # Original .NET backend (being replaced)
-│   ├── API/Controllers/             # Filaments, Spools, PrintJobs, Printers, Materials, QR, UsageLogs, Cost
-│   ├── API/DTOs/                    # DTOs per domain
-│   ├── API/Validators/              # FluentValidation rules
-│   ├── API/Hubs/                    # SignalR PrinterHub
-│   ├── API/Jobs/                    # Background sync jobs
-│   ├── Domain/Entities/             # EF Core entities (Printer, Spool, PrintJob, MaterialBase, etc.)
-│   ├── Domain/Enums/                # ConnectionType, DataSource, JobStatus, PrinterStatus, QrResourceType
-│   ├── Domain/Interfaces/           # Service interfaces
-│   ├── Infrastructure/Data/         # EF DbContext, Configurations, Migrations, SeedData
-│   ├── Infrastructure/Services/     # MoonrakerClient, CostPerPrint, UsageLog, FilamentUsage, QR
-│   └── Program.cs                  # ASP.NET entry point
-├── cmd/server/main.go              # Go entrypoint (new), worker discovery, graceful shutdown
-├── internal/                       # Go backend (new)
-│   ├── config/config.go            # Env vars
-│   ├── db/db.go                    # PostgreSQL connection pool (pgx)
-│   ├── models/models.go            # Go domain structs
-│   ├── router/router.go            # Chi HTTP routes
-│   ├── sse/broadcaster.go          # SSE broadcaster
-│   ├── sse/events.go               # SSE event types
-│   ├── sse/handler.go              # SSE HTTP handler
-│   ├── handlers/                   # API handlers (filament, health, material, print_job, printer, usage_log)
-│   ├── repositories/               # DB access layer
-│   └── services/                   # Business logic + validation
-├── migrations/                     # Go-migrate SQL migrations
-│   ├── 000001_initial_schema.up.sql
-│   ├── 000001_initial_schema.down.sql
-│   ├── 000002_seed_data.up.sql
-│   └── 000002_seed_data.down.sql
-├── frontend/                       # React frontend (new)
-│   ├── src/
-│   │   ├── App.tsx
-│   │   ├── main.tsx
-│   │   ├── components/             # ColorSwatch, LoadingSpinner, RecentPrints, SummaryCard
-│   │   ├── pages/
-│   │   │   ├── Dashboard.tsx       # Main dashboard with summary cards + recent prints
-│   │   │   └── InventoryPage.tsx   # Filament inventory list (table + filters)
-│   │   ├── services/
-│   │   │   ├── api.ts              # Axios client
-│   │   │   └── filamentService.ts
-│   │   ├── stores/                 # State stores (WIP)
-│   │   ├── types/
-│   │   │   ├── filament.ts
-│   │   │   └── index.ts
-│   │   └── hooks/
-│   ├── Dockerfile + nginx.conf
-│   └── vite.config.ts, tailwind.config.js
-├── design/                         # UX/design specs + mockup images
-│   ├── homepage-spec.md
-│   ├── 01-filament-inventory-list.md
-│   ├── 02-spool-detail-view.md
-│   ├── 03-smart-intake-workflow.md
-│   ├── smart-intake-identify-spec.md
-│   └── *.jpg / *.png               # Mockup images (kiosk + mobile)
-├── docker-compose.dev.yml
-└── deploy.sh
-```
-
-## Database Schema (PostgreSQL — .NET EF Core Migrations)
-
-Core entities managed by EF Core with full configurations:
-- **Printers** — id, name, type (BambuLab/Moonraker), connection_type, status, ip_address, mac_address, ams_count
-- **AmsUnit / AmsSlot** — Bambu Lab AMS tray tracking
-- **Spools** — filament inventory with material, color, weight, location, QR support
-- **MaterialBase / MaterialFinish / MaterialModifier** — material taxonomy
-- **PrintJobs** — job tracking with status, cost, filament consumption
-- **UsageLogs** — per-printer filament consumption records
-- **FilamentUsage** — aggregated per-spool consumption tracking
-- **FilamentUsageSyncJob** — background Moonraker polling
-- **MoonrakerPrinterSyncJob** — background printer status sync
-
-## API Endpoints (.NET)
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| GET | /api/filaments | List filaments (paginated, filterable) |
-| POST | /api/filaments | Create filament |
-| GET | /api/filaments/{id} | Get filament detail |
-| PUT | /api/filaments/{id} | Update filament |
-| DELETE | /api/filaments/{id} | Delete filament |
-| GET | /api/spools | List spools |
-| POST | /api/spools | Create spool |
-| GET | /api/spools/{id} | Get spool detail |
-| PUT | /api/spools/{id} | Update spool |
-| DELETE | /api/spools/{id} | Delete spool |
-| GET | /api/print-jobs | List print jobs |
-| POST | /api/print-jobs | Create print job |
-| GET | /api/print-jobs/{id} | Get print job detail |
-| GET | /api/printers | List printers |
-| POST | /api/printers | Register printer |
-| GET | /api/printers/{id} | Get printer detail |
-| GET | /api/printers/{id}/costs | Per-print cost summary |
-| GET | /api/printers/{id}/usage | Filament usage history |
-| GET | /api/materials/bases | List material bases |
-| POST | /api/materials/bases | Create material base |
-| GET | /api/materials/finishes | List material finishes |
-| POST | /api/materials/finishes | Create material finish |
-| GET | /api/materials/modifiers | List material modifiers |
-| POST | /api/materials/modifiers | Create modifier |
-| GET | /api/materials/lookups | Unified material lookup |
-| GET | /api/qr/resolve/{code} | QR code resolve |
-| GET | /api/usage-logs | List usage logs |
-| POST | /api/usage-logs | Create usage log |
-
-## CUB-110 Epic Progress (Go + React Rewrite)
-
-| Sub-task | Title | Status | Agent |
-|----------|-------|--------|-------|
-| CUB-111 | Design PostgreSQL schema | Done | Hex |
-| CUB-112 | Scaffold Go backend | Done | Dex |
-| CUB-113 | Core CRUD API endpoints | Done | Dex |
-| CUB-116 | Scaffold React frontend | In Review | Rex |
-| CUB-117 | Moonraker + MQTT integrations | In Progress | Dex |
-| CUB-118 | (deprecated → CUB-135 + CUB-136) | — | — |
-| CUB-130 | Add/Edit Filament form | In Review | Rex |
-| CUB-131 | Filament Detail page | In Review | Rex |
-| CUB-132 | Filament Inventory list | Done | Rex |
-| CUB-133 | Dashboard summary cards | In Review | Rex |
-| CUB-134 | Printers list page | Todo | Rex |
-| CUB-135 | Subscribe to SSE in React | In Review | Rex |
-| CUB-136 | Add SSE endpoint in Go | In Review | Dex |
-| CUB-128 | Settings page | Todo | — |
-| CUB-129 | Print Jobs list page | Todo | — |
-| CUB-114 | Pi 5 kiosk deployment | Todo | — |
-
-## Active Branches
-
-| Branch | Agent | Issue | Status |
-|--------|-------|-------|--------|
-| `agent/dex/CUB-117-moonraker-mqtt-go` | Dex | CUB-117 | Local commit ready |
-| `agent/dex/CUB-136-sse-endpoint` | Dex | CUB-136 | PR open |
-| `agent/rex/CUB-130-filament-form` | Rex | CUB-130 | PR open |
-| `agent/rex/CUB-131-filament-detail` | Rex | CUB-131 | PR open |
-| `agent/rex/CUB-133-dashboard-cards` | Rex | CUB-133 | PR open |
-| `agent/rex/CUB-135-sse-subscribe` | Rex | CUB-135 | PR open |
-
-## Known Limitations
-
-- Go rewrite is in progress — backend `internal/` is new Go code, but legacy .NET code still serves endpoints
-- Kiosk deployment not finalized (CUB-114)
-- Smart intake workflow is designed but not implemented
-- MQTT Bambu Lab integration is partially complete (CUB-117)
-
-## Default Agent Assignments
-
-| Area | Agent | Notes |
-|------|-------|-------|
-| Backend (Go API, Moonraker, MQTT) | Dex | gitea-dex MCP |
-| Database (PostgreSQL schema, migrations) | Hex | gitea-hex MCP |
-| Frontend (React, Tailwind) | Rex | gitea-rex MCP |
-| Design (wireframes, UX) | Sketch | |
-
-## Getting Started
-
-```bash
-cd /mnt/ai-storage/projects/Extrudex
-git checkout dev
-git pull origin dev
-
-# Legacy .NET backend
-cd backend && dotnet run
-
-# New Go backend
-go run cmd/server/main.go
-
-# React frontend
-cd frontend && npm install && npm run dev
-
-# Docker
-docker compose -f docker-compose.dev.yml up --build
-```

frontend/src/App.tsx

@@ -1,8 +1,6 @@
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
-import { BrowserRouter, Routes, Route, NavLink } from 'react-router-dom'
+import { BrowserRouter, Routes, Route } from 'react-router-dom'
-import { Package, Settings } from 'lucide-react'
 import InventoryPage from './pages/InventoryPage'
-import SettingsPage from './pages/SettingsPage'
 
 const queryClient = new QueryClient()
 
@@ -11,43 +9,13 @@ export default function App() {
     <QueryClientProvider client={queryClient}>
       <BrowserRouter>
         <div className="min-h-screen bg-slate-900 text-slate-50">
-          <header className="bg-slate-800 border-b border-slate-700 px-4 py-3 flex items-center gap-4 sticky top-0 z-20">
+          <header className="bg-slate-800 border-b border-slate-700 px-4 py-3 flex items-center gap-3 sticky top-0 z-20">
-            <div className="flex items-center gap-3 mr-4">
             <div className="w-8 h-8 rounded bg-emerald-500 flex items-center justify-center text-slate-900 font-bold text-lg">E</div>
             <h1 className="text-lg font-semibold">Extrudex</h1>
-            </div>
-            <nav className="flex items-center gap-1">
-              <NavLink
-                to="/"
-                end
-                className={({ isActive }) =>
-                  `inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-sm font-medium transition-colors ${
-                    isActive
-                      ? 'bg-emerald-600/20 text-emerald-400'
-                      : 'text-slate-400 hover:text-slate-200 hover:bg-slate-700'
-                  }`
-                }
-              >
-                <Package size={15} /> Inventory
-              </NavLink>
-              <NavLink
-                to="/settings"
-                className={({ isActive }) =>
-                  `inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-sm font-medium transition-colors ${
-                    isActive
-                      ? 'bg-emerald-600/20 text-emerald-400'
-                      : 'text-slate-400 hover:text-slate-200 hover:bg-slate-700'
-                  }`
-                }
-              >
-                <Settings size={15} /> Settings
-              </NavLink>
-            </nav>
           </header>
           <main className="p-4">
             <Routes>
               <Route path="/" element={<InventoryPage />} />
-              <Route path="/settings" element={<SettingsPage />} />
             </Routes>
           </main>
         </div>

frontend/src/components/LoadingSpinner.tsx

@@ -1,8 +0,0 @@
-export default function LoadingSpinner() {
-  return (
-    <div className="flex flex-col items-center gap-3">
-      <div className="w-10 h-10 border-4 border-emerald-500/30 border-t-emerald-400 rounded-full animate-spin" />
-      <p className="text-slate-400 text-sm">Loading dashboard…</p>
-    </div>
-  )
-}

frontend/src/components/RecentPrints.tsx

@@ -1,76 +0,0 @@
-import type { PrintJob } from '../types'
-import { Clock, FileText } from 'lucide-react'
-
-interface RecentPrintsProps {
-  jobs: PrintJob[]
-}
-
-export default function RecentPrints({ jobs }: RecentPrintsProps) {
-  if (jobs.length === 0) {
-    return (
-      <div className="rounded-xl border border-slate-700 bg-slate-800 p-6 text-center text-slate-400">
-        <FileText size={32} className="mx-auto mb-3 text-slate-500" />
-        <p>No recent print jobs</p>
-      </div>
-    )
-  }
-
-  const statusColor = (status: string) => {
-    switch (status.toLowerCase()) {
-      case 'completed': return 'text-emerald-400 bg-emerald-500/10'
-      case 'in_progress': return 'text-sky-400 bg-sky-500/10'
-      case 'failed': return 'text-red-400 bg-red-500/10'
-      default: return 'text-slate-400 bg-slate-500/10'
-    }
-  }
-
-  return (
-    <div className="rounded-xl border border-slate-700 bg-slate-800 overflow-hidden">
-      <div className="overflow-x-auto">
-        <table className="w-full text-left">
-          <thead>
-            <tr className="border-b border-slate-700">
-              <th className="px-4 py-3 text-sm font-medium text-slate-400">Name</th>
-              <th className="px-4 py-3 text-sm font-medium text-slate-400">Status</th>
-              <th className="px-4 py-3 text-sm font-medium text-slate-400">Duration</th>
-              <th className="px-4 py-3 text-sm font-medium text-slate-400">Filament</th>
-              <th className="px-4 py-3 text-sm font-medium text-slate-400">Cost</th>
-            </tr>
-          </thead>
-          <tbody>
-            {jobs.map((job) => (
-              <tr key={job.id} className="border-b border-slate-700/50 last:border-0 hover:bg-slate-700/30 transition-colors">
-                <td className="px-4 py-3 text-sm text-slate-100 font-medium">{job.name}</td>
-                <td className="px-4 py-3">
-                  <span className={`inline-flex items-center gap-1 px-2 py-1 rounded-full text-xs font-medium ${statusColor(job.status)}`}>
-                    {job.status}
-                  </span>
-                </td>
-                <td className="px-4 py-3 text-sm text-slate-300">
-                  <div className="flex items-center gap-1">
-                    <Clock size={14} />
-                    {formatDuration(job.duration_seconds)}
-                  </div>
-                </td>
-                <td className="px-4 py-3 text-sm text-slate-300">
-                  {job.filament_used_grams?.toFixed(1) ?? '-'} g
-                </td>
-                <td className="px-4 py-3 text-sm text-slate-300">
-                  ${job.cost_usd?.toFixed(2) ?? '-'}
-                </td>
-              </tr>
-            ))}
-          </tbody>
-        </table>
-      </div>
-    </div>
-  )
-}
-
-function formatDuration(seconds: number): string {
-  if (!seconds) return '-'
-  const hrs = Math.floor(seconds / 3600)
-  const mins = Math.floor((seconds % 3600) / 60)
-  if (hrs > 0) return `${hrs}h ${mins}m`
-  return `${mins}m`
-}

frontend/src/components/SummaryCard.tsx

@@ -1,31 +0,0 @@
-import type { LucideIcon } from 'lucide-react'
-
-interface SummaryCardProps {
-  title: string
-  value: string | number
-  icon: LucideIcon
-  color: 'emerald' | 'amber' | 'sky' | 'violet'
-}
-
-const colorMap = {
-  emerald: { bg: 'bg-emerald-500/10', border: 'border-emerald-500/20', text: 'text-emerald-400', icon: 'text-emerald-400' },
-  amber:   { bg: 'bg-amber-500/10',  border: 'border-amber-500/20',  text: 'text-amber-400',  icon: 'text-amber-400' },
-  sky:     { bg: 'bg-sky-500/10',    border: 'border-sky-500/20',    text: 'text-sky-400',    icon: 'text-sky-400' },
-  violet:  { bg: 'bg-violet-500/10', border: 'border-violet-500/20', text: 'text-violet-400', icon: 'text-violet-400' },
-}
-
-export default function SummaryCard({ title, value, icon: Icon, color }: SummaryCardProps) {
-  const c = colorMap[color]
-
-  return (
-    <div className={`rounded-xl border ${c.border} ${c.bg} p-5 flex items-start justify-between`}>
-      <div>
-        <p className="text-sm font-medium text-slate-400 mb-1">{title}</p>
-        <p className={`text-3xl font-bold ${c.text}`}>{value}</p>
-      </div>
-      <div className={`p-2 rounded-lg ${c.bg}`}>
-        <Icon size={24} className={c.icon} />
-      </div>
-    </div>
-  )
-}

frontend/src/main.tsx

@@ -1,25 +1,10 @@
 import { StrictMode } from 'react'
 import { createRoot } from 'react-dom/client'
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
-import { BrowserRouter } from 'react-router-dom'
 import './index.css'
 import App from './App'
 
-const queryClient = new QueryClient({
-  defaultOptions: {
-    queries: {
-      staleTime: 30_000,
-      refetchOnWindowFocus: false,
-    },
-  },
-})
-
 createRoot(document.getElementById('root')!).render(
   <StrictMode>
-    <QueryClientProvider client={queryClient}>
-      <BrowserRouter>
     <App />
-      </BrowserRouter>
-    </QueryClientProvider>
   </StrictMode>,
 )

frontend/src/pages/Dashboard.tsx

@@ -1,139 +0,0 @@
-import { useQuery } from '@tanstack/react-query'
-import { getFilaments, getPrintJobs } from '../services/api'
-import SummaryCard from '../components/SummaryCard'
-import RecentPrints from '../components/RecentPrints'
-import LoadingSpinner from '../components/LoadingSpinner'
-import { Package, AlertTriangle, Printer, DollarSign, Plus, List } from 'lucide-react'
-
-export default function Dashboard() {
-  const {
-    data: filamentData,
-    isLoading: filamentLoading,
-    error: filamentError,
-  } = useQuery({
-    queryKey: ['filaments', 'count'],
-    queryFn: () => getFilaments({ limit: 1 }),
-  })
-
-  const {
-    data: lowStockData,
-    isLoading: lowStockLoading,
-    error: lowStockError,
-  } = useQuery({
-    queryKey: ['filaments', 'lowStock'],
-    queryFn: () => getFilaments({ low_stock: true, limit: 1 }),
-  })
-
-  const {
-    data: recentPrints,
-    isLoading: printsLoading,
-    error: printsError,
-  } = useQuery({
-    queryKey: ['printJobs', 'recent'],
-    queryFn: () => getPrintJobs({ limit: 5 }),
-  })
-
-  const {
-    data: allPrints,
-    isLoading: costLoading,
-    error: costError,
-  } = useQuery({
-    queryKey: ['printJobs', 'all'],
-    queryFn: () => getPrintJobs({ limit: 1000 }),
-  })
-
-  const totalSpools = filamentData?.total ?? 0
-  const lowStockCount = lowStockData?.total ?? 0
-  const recentPrintJobs = recentPrints?.data ?? []
-
-  // Calculate cost this month from all print jobs
-  const now = new Date()
-  const currentMonth = now.getMonth()
-  const currentYear = now.getFullYear()
-  const monthlyCost =
-    allPrints?.data
-      .filter((job) => {
-        const d = new Date(job.started_at)
-        return d.getMonth() === currentMonth && d.getFullYear() === currentYear
-      })
-      .reduce((sum, job) => sum + (job.cost_usd ?? 0), 0) ?? 0
-
-  const isLoading = filamentLoading || lowStockLoading || printsLoading || costLoading
-  const error = filamentError || lowStockError || printsError || costError
-
-  if (isLoading) {
-    return (
-      <div className="min-h-screen flex items-center justify-center bg-slate-900">
-        <LoadingSpinner />
-      </div>
-    )
-  }
-
-  if (error) {
-    return (
-      <div className="min-h-screen flex items-center justify-center bg-slate-900">
-        <div className="p-6 rounded-lg bg-red-900/30 border border-red-500 text-red-200 max-w-md">
-          <h2 className="text-xl font-bold mb-2">Error</h2>
-          <p className="text-sm">{(error as Error).message || 'Failed to load dashboard data.'}</p>
-        </div>
-      </div>
-    )
-  }
-
-  return (
-    <div className="min-h-screen bg-slate-900 p-4 md:p-8">
-      <div className="max-w-6xl mx-auto">
-        <header className="mb-8">
-          <h1 className="text-3xl font-bold text-emerald-400 mb-2">Dashboard</h1>
-          <p className="text-slate-400">Overview of your Extrudex inventory and prints</p>
-        </header>
-
-        {/* Summary Cards Grid */}
-        <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4 mb-8">
-          <SummaryCard
-            title="Total Spools"
-            value={totalSpools}
-            icon={Package}
-            color="emerald"
-          />
-          <SummaryCard
-            title="Low Stock"
-            value={lowStockCount}
-            icon={AlertTriangle}
-            color={lowStockCount > 0 ? 'amber' : 'emerald'}
-          />
-          <SummaryCard
-            title="Recent Prints"
-            value={recentPrintJobs.length}
-            icon={Printer}
-            color="sky"
-          />
-          <SummaryCard
-            title="Cost This Month"
-            value={`$${monthlyCost.toFixed(2)}`}
-            icon={DollarSign}
-            color="violet"
-          />
-        </div>
-
-        {/* Quick Actions */}
-        <div className="flex flex-wrap gap-3 mb-8">
-          <button className="flex items-center gap-2 px-4 py-2 rounded-lg bg-emerald-600 hover:bg-emerald-500 text-white font-medium transition-colors active:scale-95 touch-manipulation">
-            <Plus size={18} />
-            Add Spool
-          </button>
-          <button className="flex items-center gap-2 px-4 py-2 rounded-lg bg-slate-700 hover:bg-slate-600 text-slate-100 font-medium transition-colors active:scale-95 touch-manipulation">
-            <List size={18} />
-            View Inventory
-          </button>
-        </div>
-
-        {/* Recent Prints Section */}
-        <section>
-          <h2 className="text-xl font-semibold text-slate-100 mb-4">Recent Prints</h2>
-          <RecentPrints jobs={recentPrintJobs} />
-        </section>
-      </div>
-    </div>
-  )
-}

frontend/src/pages/SettingsPage.tsx

@@ -1,290 +0,0 @@
-import { useState } from 'react'
-import { Save, Wifi, WifiOff, Sun, Moon, AlertCircle, CheckCircle2 } from 'lucide-react'
-
-// TODO: Replace with API calls to GET/PUT /api/settings once Dex implements the endpoint
-const DEFAULT_SETTINGS = {
-  lowStockThresholdGrams: 100,
-  filamentCrossSectionMm2: 2.405, // π × (0.875mm)² — standard 1.75mm filament
-  currency: 'USD',
-  theme: 'dark' as 'dark' | 'light' | 'system',
-}
-
-const CURRENCIES = ['USD', 'EUR', 'GBP', 'CAD', 'AUD', 'JPY']
-
-type ConnectionStatus = 'idle' | 'testing' | 'ok' | 'error'
-
-interface PrinterConfig {
-  name: string
-  type: 'bambu' | 'moonraker'
-  host: string
-}
-
-// TODO: Load from GET /api/printers once Dex implements the endpoint
-const MOCK_PRINTERS: PrinterConfig[] = [
-  { name: 'Bambu X1C #1', type: 'bambu', host: '192.168.1.100' },
-  { name: 'Bambu X1C #2', type: 'bambu', host: '192.168.1.101' },
-  { name: 'Voron 2.4 (Klipper)', type: 'moonraker', host: '192.168.1.200' },
-]
-
-function SettingRow({ label, hint, children }: { label: string; hint?: string; children: React.ReactNode }) {
-  return (
-    <div className="flex flex-col sm:flex-row sm:items-center gap-2 sm:gap-4 py-4 border-b border-slate-700 last:border-0">
-      <div className="sm:w-64 shrink-0">
-        <div className="text-sm font-medium text-slate-200">{label}</div>
-        {hint && <div className="text-xs text-slate-500 mt-0.5">{hint}</div>}
-      </div>
-      <div className="flex-1">{children}</div>
-    </div>
-  )
-}
-
-function SectionHeader({ title, description }: { title: string; description?: string }) {
-  return (
-    <div className="mb-2">
-      <h3 className="text-base font-semibold text-slate-100">{title}</h3>
-      {description && <p className="text-sm text-slate-400 mt-0.5">{description}</p>}
-    </div>
-  )
-}
-
-export default function SettingsPage() {
-  const [lowStockThreshold, setLowStockThreshold] = useState(DEFAULT_SETTINGS.lowStockThresholdGrams)
-  const [crossSection, setCrossSection] = useState(DEFAULT_SETTINGS.filamentCrossSectionMm2)
-  const [currency, setCurrency] = useState(DEFAULT_SETTINGS.currency)
-  const [theme, setTheme] = useState(DEFAULT_SETTINGS.theme)
-  const [saved, setSaved] = useState(false)
-  const [saveError, setSaveError] = useState(false)
-  const [printerStatus, setPrinterStatus] = useState<Record<string, ConnectionStatus>>({})
-
-  const [thresholdError, setThresholdError] = useState('')
-  const [crossSectionError, setCrossSectionError] = useState('')
-
-  const validate = () => {
-    let valid = true
-    if (!lowStockThreshold || lowStockThreshold < 0 || lowStockThreshold > 10000) {
-      setThresholdError('Must be between 0 and 10,000 g')
-      valid = false
-    } else {
-      setThresholdError('')
-    }
-    if (!crossSection || crossSection <= 0 || crossSection > 100) {
-      setCrossSectionError('Must be a positive number (typical: 2.405 for 1.75mm)')
-      valid = false
-    } else {
-      setCrossSectionError('')
-    }
-    return valid
-  }
-
-  const handleSave = async () => {
-    if (!validate()) return
-    try {
-      // TODO: PUT /api/settings with { low_stock_threshold_grams, filament_cross_section_mm2, currency, theme }
-      setSaved(true)
-      setSaveError(false)
-      setTimeout(() => setSaved(false), 3000)
-    } catch {
-      setSaveError(true)
-      setSaved(false)
-    }
-  }
-
-  const testPrinterConnection = async (printer: PrinterConfig) => {
-    setPrinterStatus(s => ({ ...s, [printer.host]: 'testing' }))
-    // TODO: POST /api/printers/test with { host, type } — Dex to implement
-    await new Promise(r => setTimeout(r, 1500))
-    // Mock: hosts ending in .100 or .200 pass, others fail
-    const ok = printer.host.endsWith('.100') || printer.host.endsWith('.200')
-    setPrinterStatus(s => ({ ...s, [printer.host]: ok ? 'ok' : 'error' }))
-  }
-
-  return (
-    <div className="space-y-6 max-w-2xl">
-      {/* Header */}
-      <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3">
-        <div>
-          <h2 className="text-xl font-bold text-slate-100">Settings</h2>
-          <p className="text-sm text-slate-400">App configuration for Extrudex</p>
-        </div>
-        <div className="flex items-center gap-3">
-          {saved && (
-            <span className="inline-flex items-center gap-1.5 text-sm text-emerald-400">
-              <CheckCircle2 size={16} /> Saved
-            </span>
-          )}
-          {saveError && (
-            <span className="inline-flex items-center gap-1.5 text-sm text-red-400">
-              <AlertCircle size={16} /> Save failed
-            </span>
-          )}
-          <button
-            onClick={handleSave}
-            className="inline-flex items-center gap-2 rounded-lg bg-emerald-600 px-4 py-2 text-sm font-semibold text-white hover:bg-emerald-500 active:bg-emerald-700 transition-colors"
-          >
-            <Save size={16} /> Save Settings
-          </button>
-        </div>
-      </div>
-
-      {/* Inventory Settings */}
-      <div className="rounded-lg border border-slate-700 bg-slate-800/50 px-4 pt-4 pb-2">
-        <SectionHeader
-          title="Inventory"
-          description="Controls how spools are tracked and displayed"
-        />
-        <SettingRow
-          label="Low stock threshold"
-          hint="Spools below this weight are flagged as low stock"
-        >
-          <div>
-            <div className="flex items-center gap-2">
-              <input
-                type="number"
-                min={0}
-                max={10000}
-                step={10}
-                value={lowStockThreshold}
-                onChange={e => setLowStockThreshold(Number(e.target.value))}
-                className={`w-32 rounded-lg bg-slate-800 border ${thresholdError ? 'border-red-500' : 'border-slate-700'} px-3 py-2 text-sm text-slate-100 focus:outline-none focus:ring-2 focus:ring-emerald-500`}
-              />
-              <span className="text-sm text-slate-400">grams</span>
-            </div>
-            {thresholdError && <p className="mt-1 text-xs text-red-400">{thresholdError}</p>}
-          </div>
-        </SettingRow>
-
-        <SettingRow
-          label="Filament cross-section area"
-          hint="Used to convert mm extruded → grams (π × r²)"
-        >
-          <div>
-            <div className="flex items-center gap-2">
-              <input
-                type="number"
-                min={0.01}
-                max={100}
-                step={0.001}
-                value={crossSection}
-                onChange={e => setCrossSection(Number(e.target.value))}
-                className={`w-36 rounded-lg bg-slate-800 border ${crossSectionError ? 'border-red-500' : 'border-slate-700'} px-3 py-2 text-sm text-slate-100 focus:outline-none focus:ring-2 focus:ring-emerald-500`}
-              />
-              <span className="text-sm text-slate-400">mm²</span>
-            </div>
-            {crossSectionError && <p className="mt-1 text-xs text-red-400">{crossSectionError}</p>}
-            <p className="mt-1 text-xs text-slate-500">1.75mm filament = 2.405 mm² · 2.85mm filament = 6.379 mm²</p>
-          </div>
-        </SettingRow>
-
-        <SettingRow label="Currency" hint="Used for cost display throughout the app">
-          <select
-            value={currency}
-            onChange={e => setCurrency(e.target.value)}
-            className="rounded-lg bg-slate-800 border border-slate-700 px-3 py-2 text-sm text-slate-100 focus:outline-none focus:ring-2 focus:ring-emerald-500"
-          >
-            {CURRENCIES.map(c => (
-              <option key={c} value={c}>{c}</option>
-            ))}
-          </select>
-        </SettingRow>
-      </div>
-
-      {/* Appearance */}
-      <div className="rounded-lg border border-slate-700 bg-slate-800/50 px-4 pt-4 pb-2">
-        <SectionHeader title="Appearance" />
-        <SettingRow label="Theme" hint="Override system default color scheme">
-          <div className="flex items-center gap-2">
-            {(['system', 'dark', 'light'] as const).map(t => (
-              <button
-                key={t}
-                onClick={() => setTheme(t)}
-                className={`inline-flex items-center gap-1.5 rounded-lg px-3 py-2 text-sm font-medium border transition-colors ${
-                  theme === t
-                    ? 'bg-emerald-600 border-emerald-500 text-white'
-                    : 'bg-slate-800 border-slate-700 text-slate-300 hover:bg-slate-700'
-                }`}
-              >
-                {t === 'dark' && <Moon size={14} />}
-                {t === 'light' && <Sun size={14} />}
-                {t === 'system' && <span className="text-xs">Auto</span>}
-                {t !== 'system' && <span className="capitalize">{t}</span>}
-                {t === 'system' && <span>System</span>}
-              </button>
-            ))}
-          </div>
-        </SettingRow>
-      </div>
-
-      {/* Printer Connections */}
-      <div className="rounded-lg border border-slate-700 bg-slate-800/50 px-4 pt-4 pb-2">
-        <SectionHeader
-          title="Printer Connections"
-          description="Test connectivity to configured printers"
-        />
-        {/* TODO: Load printer list from GET /api/printers */}
-        {MOCK_PRINTERS.map(printer => {
-          const status = printerStatus[printer.host] ?? 'idle'
-          return (
-            <SettingRow
-              key={printer.host}
-              label={printer.name}
-              hint={`${printer.type === 'bambu' ? 'Bambu MQTT' : 'Moonraker'} · ${printer.host}`}
-            >
-              <div className="flex items-center gap-3">
-                <StatusBadge status={status} />
-                <button
-                  onClick={() => testPrinterConnection(printer)}
-                  disabled={status === 'testing'}
-                  className="inline-flex items-center gap-1.5 rounded-lg bg-slate-700 border border-slate-600 px-3 py-1.5 text-xs font-medium text-slate-200 hover:bg-slate-600 disabled:opacity-50 disabled:cursor-not-allowed transition-colors"
-                >
-                  {status === 'testing' ? (
-                    <>
-                      <span className="animate-spin inline-block w-3 h-3 border border-slate-400 border-t-transparent rounded-full" />
-                      Testing…
-                    </>
-                  ) : (
-                    <>
-                      <Wifi size={12} /> Test Connection
-                    </>
-                  )}
-                </button>
-              </div>
-            </SettingRow>
-          )
-        })}
-      </div>
-
-      {/* Save footer (mobile convenience) */}
-      <div className="flex justify-end pb-4">
-        <button
-          onClick={handleSave}
-          className="inline-flex items-center gap-2 rounded-lg bg-emerald-600 px-5 py-2.5 text-sm font-semibold text-white hover:bg-emerald-500 active:bg-emerald-700 transition-colors"
-        >
-          <Save size={16} /> Save Settings
-        </button>
-      </div>
-    </div>
-  )
-}
-
-function StatusBadge({ status }: { status: ConnectionStatus }) {
-  if (status === 'idle') return null
-  if (status === 'testing') {
-    return (
-      <span className="inline-flex items-center gap-1 rounded-full bg-slate-700 border border-slate-600 px-2 py-0.5 text-xs text-slate-300">
-        Testing…
-      </span>
-    )
-  }
-  if (status === 'ok') {
-    return (
-      <span className="inline-flex items-center gap-1 rounded-full bg-emerald-900/30 border border-emerald-700 px-2 py-0.5 text-xs text-emerald-300">
-        <CheckCircle2 size={11} /> Connected
-      </span>
-    )
-  }
-  return (
-    <span className="inline-flex items-center gap-1 rounded-full bg-red-900/30 border border-red-700 px-2 py-0.5 text-xs text-red-300">
-      <WifiOff size={11} /> Unreachable
-    </span>
-  )
-}

frontend/src/services/api.ts

@@ -1,19 +0,0 @@
-import axios from 'axios'
-import type { ListResponse, FilamentSpool, PrintJob } from '../types'
-
-const api = axios.create({
-  baseURL: '/api',
-  headers: { 'Content-Type': 'application/json' },
-})
-
-export async function getFilaments(params?: { low_stock?: boolean; limit?: number; offset?: number }) {
-  const res = await api.get<ListResponse<FilamentSpool>>('/filaments', { params })
-  return res.data
-}
-
-export async function getPrintJobs(params?: { limit?: number; offset?: number }) {
-  const res = await api.get<ListResponse<PrintJob>>('/print-jobs', { params })
-  return res.data
-}
-
-export default api

frontend/src/types/index.ts

@@ -1,42 +0,0 @@
-export interface FilamentSpool {
-  id: number;
-  name: string;
-  material_base_id: number;
-  material_finish_id: number;
-  material_modifier_id: number;
-  color_hex: string;
-  brand: string;
-  diameter_mm: number;
-  initial_grams: number;
-  remaining_grams: number;
-  spool_weight_grams: number;
-  cost_usd: number;
-  low_stock_threshold_grams: number;
-  notes: string;
-  barcode: string;
-  created_at: string;
-  updated_at: string;
-  deleted_at: string | null;
-}
-
-export interface PrintJob {
-  id: number;
-  name: string;
-  printer_id: number;
-  filament_id: number;
-  status: string;
-  duration_seconds: number;
-  filament_used_grams: number;
-  cost_usd: number;
-  started_at: string;
-  completed_at: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface ListResponse<T> {
-  data: T[];
-  total: number;
-  limit: number;
-  offset: number;
-}

frontend/tsconfig.json

@@ -15,7 +15,6 @@
     "noUnusedLocals": true,
     "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true,
-    "ignoreDeprecations": "5.0",
     "baseUrl": ".",
     "paths": {
       "@/*": ["src/*"]