CUB-134: Build printers list page

docs: add comprehensive project context file (CONTEXT.md) for agent reference
Merge pull request 'CUB-133: Build Dashboard page with summary cards' (#42 ) from agent/rex/CUB-133-dashboard-page into dev
2026-05-26 14:15:25 +00:00 · 2026-05-21 13:29:24 -04:00 · 2026-05-15 10:58:22 -04:00 · 2026-05-12 15:51:21 -04:00 · 2026-05-07 20:07:45 -04:00
18 changed files with 861 additions and 849 deletions
@@ -11,10 +11,8 @@ 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() {
@@ -42,11 +40,6 @@ 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()
@@ -54,19 +47,6 @@ 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)

@@ -1,161 +0,0 @@
-// 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
-}
@@ -1,119 +0,0 @@
-// 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",
-	}
-}
@@ -1,321 +0,0 @@
-// 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
-}
@@ -1,223 +0,0 @@
-// 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)
-}
@@ -0,0 +1,214 @@
+# 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
+```
@@ -1,6 +1,8 @@
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
 import { BrowserRouter, Routes, Route } from 'react-router-dom'
+import Dashboard from './pages/Dashboard'
 import InventoryPage from './pages/InventoryPage'
+import PrintersPage from './pages/PrintersPage'

 const queryClient = new QueryClient()

@@ -9,13 +11,22 @@ 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-3 sticky top-0 z-20">
-            <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>
+          <header className="bg-slate-800 border-b border-slate-700 px-4 py-3 flex items-center gap-4 sticky top-0 z-20">
+            <a href="/" className="flex items-center gap-3 no-underline">
+              <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 text-slate-50">Extrudex</h1>
+            </a>
+            <nav className="flex items-center gap-1 ml-2">
+              <a href="/" className="px-3 py-1.5 rounded-md text-sm text-slate-300 hover:text-slate-100 hover:bg-slate-700 transition-colors">Dashboard</a>
+              <a href="/inventory" className="px-3 py-1.5 rounded-md text-sm text-slate-300 hover:text-slate-100 hover:bg-slate-700 transition-colors">Inventory</a>
+              <a href="/printers" className="px-3 py-1.5 rounded-md text-sm text-slate-300 hover:text-slate-100 hover:bg-slate-700 transition-colors">Printers</a>
+            </nav>
          </header>
          <main className="p-4">
            <Routes>
-              <Route path="/" element={<InventoryPage />} />
+              <Route path="/" element={<Dashboard />} />
+              <Route path="/inventory" element={<InventoryPage />} />
+              <Route path="/printers" element={<PrintersPage />} />
            </Routes>
          </main>
        </div>
@@ -0,0 +1,8 @@
+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>
+  )
+}
@@ -0,0 +1,76 @@
+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`
+}
@@ -0,0 +1,31 @@
+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>
+  )
+}
@@ -1,10 +1,25 @@
 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>
-    <App />
+    <QueryClientProvider client={queryClient}>
+      <BrowserRouter>
+        <App />
+      </BrowserRouter>
+    </QueryClientProvider>
  </StrictMode>,
 )
@@ -0,0 +1,139 @@
+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>
+  )
+}
@@ -0,0 +1,262 @@
+import { useQuery } from '@tanstack/react-query'
+import { Printer, Wifi, WifiOff, HelpCircle, Plus, Globe, Radio } from 'lucide-react'
+import { fetchPrinters } from '../services/printerService'
+import LoadingSpinner from '../components/LoadingSpinner'
+import type { Printer as PrinterType, ConnectionStatus } from '../types/printer'
+
+function getConnectionStatus(printer: PrinterType): ConnectionStatus {
+  if (!printer.is_active) return 'offline'
+  if (printer.moonraker_url || printer.mqtt_broker_host) return 'online'
+  return 'unknown'
+}
+
+const statusConfig: Record<ConnectionStatus, { icon: typeof Wifi; label: string; className: string }> = {
+  online: {
+    icon: Wifi,
+    label: 'Online',
+    className: 'bg-emerald-900/30 border-emerald-700 text-emerald-300',
+  },
+  offline: {
+    icon: WifiOff,
+    label: 'Offline',
+    className: 'bg-red-900/30 border-red-700 text-red-300',
+  },
+  unknown: {
+    icon: HelpCircle,
+    label: 'Unknown',
+    className: 'bg-slate-700/50 border-slate-600 text-slate-400',
+  },
+}
+
+export default function PrintersPage() {
+  const { data: printers, isLoading, error, refetch } = useQuery({
+    queryKey: ['printers'],
+    queryFn: fetchPrinters,
+  })
+
+  const count = printers?.length ?? 0
+
+  return (
+    <div className="space-y-4">
+      {/* 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">Printers</h2>
+          <p className="text-sm text-slate-400">{count} printer(s) in fleet</p>
+        </div>
+        <button 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">
+          <Plus size={16} /> Add Printer
+        </button>
+      </div>
+
+      {/* Loading */}
+      {isLoading && (
+        <div className="flex items-center justify-center py-16">
+          <LoadingSpinner />
+        </div>
+      )}
+
+      {/* Error */}
+      {error && (
+        <div className="rounded-lg border border-red-700 bg-red-900/20 p-6 text-center">
+          <p className="text-red-400 mb-2">Failed to load printers.</p>
+          <button
+            onClick={() => refetch()}
+            className="text-sm text-red-300 underline hover:text-red-200"
+          >
+            Retry
+          </button>
+        </div>
+      )}
+
+      {/* Empty */}
+      {!isLoading && !error && printers?.length === 0 && (
+        <div className="rounded-lg border border-slate-700 bg-slate-800 p-12 text-center">
+          <Printer size={40} className="mx-auto mb-3 text-slate-500" />
+          <p className="text-slate-400">No printers found.</p>
+          <p className="text-sm text-slate-500 mt-1">
+            Add a printer to start monitoring your fleet.
+          </p>
+        </div>
+      )}
+
+      {/* Desktop Table */}
+      {!isLoading && !error && (printers?.length ?? 0) > 0 && (
+        <>
+          <div className="hidden lg:block overflow-x-auto rounded-lg border border-slate-700">
+            <table className="w-full text-sm">
+              <thead className="bg-slate-800 text-slate-300">
+                <tr>
+                  <th className="px-4 py-3 text-left font-semibold">Name</th>
+                  <th className="px-4 py-3 text-left font-semibold">Type</th>
+                  <th className="px-4 py-3 text-left font-semibold">Manufacturer</th>
+                  <th className="px-4 py-3 text-left font-semibold">Model</th>
+                  <th className="px-4 py-3 text-center font-semibold">Status</th>
+                  <th className="px-4 py-3 text-left font-semibold">Moonraker</th>
+                  <th className="px-4 py-3 text-left font-semibold">MQTT</th>
+                </tr>
+              </thead>
+              <tbody className="divide-y divide-slate-700">
+                {printers!.map((printer) => {
+                  const status = getConnectionStatus(printer)
+                  const StatusIcon = statusConfig[status].icon
+                  return (
+                    <tr
+                      key={printer.id}
+                      className="bg-slate-800/50 hover:bg-slate-700/50 transition-colors"
+                    >
+                      <td className="px-4 py-3 font-medium text-slate-100">
+                        {printer.name}
+                      </td>
+                      <td className="px-4 py-3 text-slate-300">
+                        {printer.printer_type?.name ?? '—'}
+                      </td>
+                      <td className="px-4 py-3 text-slate-300">
+                        {printer.manufacturer || '—'}
+                      </td>
+                      <td className="px-4 py-3 text-slate-300">
+                        {printer.model || '—'}
+                      </td>
+                      <td className="px-4 py-3 text-center">
+                        <span
+                          className={`inline-flex items-center gap-1.5 rounded-full border px-2.5 py-0.5 text-xs font-medium ${statusConfig[status].className}`}
+                        >
+                          <StatusIcon size={12} />
+                          {statusConfig[status].label}
+                        </span>
+                      </td>
+                      <td className="px-4 py-3">
+                        {printer.moonraker_url ? (
+                          <a
+                            href={printer.moonraker_url}
+                            target="_blank"
+                            rel="noopener noreferrer"
+                            className="inline-flex items-center gap-1.5 text-sky-400 hover:text-sky-300 text-xs truncate max-w-[180px]"
+                            title={printer.moonraker_url}
+                          >
+                            <Globe size={12} className="shrink-0" />
+                            {printer.moonraker_url}
+                          </a>
+                        ) : (
+                          <span className="text-slate-500 text-xs">—</span>
+                        )}
+                      </td>
+                      <td className="px-4 py-3">
+                        {printer.mqtt_broker_host ? (
+                          <div className="space-y-0.5">
+                            <div className="inline-flex items-center gap-1.5 text-xs text-slate-300">
+                              <Radio size={12} className="shrink-0 text-amber-400" />
+                              <span className="truncate max-w-[140px]" title={printer.mqtt_broker_host}>
+                                {printer.mqtt_broker_host}
+                              </span>
+                            </div>
+                            {printer.mqtt_topic_prefix && (
+                              <div className="text-xs text-slate-500 ml-[20px] truncate max-w-[140px]" title={printer.mqtt_topic_prefix}>
+                                topic: {printer.mqtt_topic_prefix}
+                              </div>
+                            )}
+                            <div className="text-xs text-slate-500 ml-[20px]">
+                              TLS: {printer.mqtt_tls_enabled ? 'on' : 'off'}
+                            </div>
+                          </div>
+                        ) : (
+                          <span className="text-slate-500 text-xs">—</span>
+                        )}
+                      </td>
+                    </tr>
+                  )
+                })}
+              </tbody>
+            </table>
+          </div>
+
+          {/* Mobile / Tablet Cards */}
+          <div className="lg:hidden space-y-3">
+            {printers!.map((printer) => {
+              const status = getConnectionStatus(printer)
+              const StatusIcon = statusConfig[status].icon
+              return (
+                <div
+                  key={printer.id}
+                  className="rounded-lg border border-slate-700 bg-slate-800 p-4 space-y-3"
+                >
+                  {/* Top row: name + status */}
+                  <div className="flex items-start justify-between gap-3">
+                    <div className="min-w-0">
+                      <div className="font-semibold text-slate-100 truncate">
+                        {printer.name}
+                      </div>
+                      <div className="text-xs text-slate-400 mt-0.5">
+                        {[
+                          printer.printer_type?.name,
+                          printer.manufacturer,
+                          printer.model,
+                        ]
+                          .filter(Boolean)
+                          .join(' · ') || 'No details'}
+                      </div>
+                    </div>
+                    <span
+                      className={`inline-flex items-center gap-1.5 rounded-full border px-2.5 py-0.5 text-xs font-medium shrink-0 ${statusConfig[status].className}`}
+                    >
+                      <StatusIcon size={12} />
+                      {statusConfig[status].label}
+                    </span>
+                  </div>
+
+                  {/* Connection details */}
+                  <div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
+                    {/* Moonraker */}
+                    <div className="rounded-md bg-slate-900/50 p-3 min-w-0">
+                      <div className="flex items-center gap-1.5 text-xs text-slate-400 mb-1">
+                        <Globe size={12} />
+                        Moonraker
+                      </div>
+                      {printer.moonraker_url ? (
+                        <a
+                          href={printer.moonraker_url}
+                          target="_blank"
+                          rel="noopener noreferrer"
+                          className="text-xs text-sky-400 hover:text-sky-300 break-all"
+                        >
+                          {printer.moonraker_url}
+                        </a>
+                      ) : (
+                        <span className="text-xs text-slate-500">Not configured</span>
+                      )}
+                    </div>
+
+                    {/* MQTT */}
+                    <div className="rounded-md bg-slate-900/50 p-3 min-w-0">
+                      <div className="flex items-center gap-1.5 text-xs text-slate-400 mb-1">
+                        <Radio size={12} />
+                        MQTT
+                      </div>
+                      {printer.mqtt_broker_host ? (
+                        <div className="space-y-0.5 text-xs text-slate-300">
+                          <div className="truncate" title={printer.mqtt_broker_host}>
+                            {printer.mqtt_broker_host}
+                          </div>
+                          {printer.mqtt_topic_prefix && (
+                            <div className="text-slate-500 truncate" title={printer.mqtt_topic_prefix}>
+                              topic: {printer.mqtt_topic_prefix}
+                            </div>
+                          )}
+                          <div className="text-slate-500">
+                            TLS: {printer.mqtt_tls_enabled ? 'on' : 'off'}
+                          </div>
+                        </div>
+                      ) : (
+                        <span className="text-xs text-slate-500">Not configured</span>
+                      )}
+                    </div>
+                  </div>
+                </div>
+              )
+            })}
+          </div>
+        </>
+      )}
+    </div>
+  )
+}
@@ -0,0 +1,19 @@
+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
@@ -0,0 +1,9 @@
+import axios from 'axios'
+import type { Printer, PrinterResponse } from '../types/printer'
+
+const API_BASE = '/api'
+
+export async function fetchPrinters(): Promise<Printer[]> {
+  const res = await axios.get<PrinterResponse>(`${API_BASE}/printers`)
+  return res.data.data
+}
@@ -0,0 +1,42 @@
+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;
+}
@@ -0,0 +1,29 @@
+export interface PrinterType {
+  id: number
+  name: string
+  created_at: string
+  updated_at: string
+}
+
+export interface Printer {
+  id: number
+  name: string
+  printer_type_id: number
+  printer_type?: PrinterType
+  manufacturer?: string
+  model?: string
+  moonraker_url?: string
+  moonraker_api_key?: string
+  mqtt_broker_host?: string
+  mqtt_topic_prefix?: string
+  mqtt_tls_enabled: boolean
+  is_active: boolean
+  created_at: string
+  updated_at: string
+}
+
+export type ConnectionStatus = 'online' | 'offline' | 'unknown'
+
+export interface PrinterResponse {
+  data: Printer[]
+}
@@ -15,6 +15,7 @@
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noFallthroughCasesInSwitch": true,
+    "ignoreDeprecations": "5.0",
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
Author	SHA1	Message	Date
Dex	368d070174	CUB-134: Build printers list page Dev Build / build-test (pull_request) Failing after 11m16s Details	2026-05-26 14:15:25 +00:00
Otto	d8c0991dc6	docs: add comprehensive project context file (CONTEXT.md) for agent reference Dev Build / build-test (push) Failing after 1s Details	2026-05-21 13:29:24 -04:00
overseer	10c9340e74	Merge pull request 'CUB-133: Build Dashboard page with summary cards' (#42 ) from agent/rex/CUB-133-dashboard-page into dev Dev Build / build-test (push) Successful in 1m34s Details Reviewed-on: #42	2026-05-15 10:58:22 -04:00
Hex	ffff4213b6	Merge branch 'dev' into agent/rex/CUB-133-dashboard-page - resolve App.tsx conflict Dev Build / build-test (pull_request) Successful in 1m23s Details	2026-05-12 15:51:21 -04:00
Hex	32798fbf14	CUB-133: Build Dashboard page with summary cards Dev Build / build-test (pull_request) Successful in 2m10s Details	2026-05-07 20:07:45 -04:00