mirror of
https://github.com/maziggy/bambuddy.git
synced 2026-10-01 03:31:25 +02:00
Two new optional fields on Spool: free-text `category` (max 50) and `low_stock_threshold_pct` (1-99). Powers the "differentiate critical spools from prototype spools and alert at different thresholds" use case from #729 without taking on the full multi-tag taxonomy + auto- apply rules + per-tag alert system the ticket originally proposed. Form gains: - Category input with datalist autocomplete sourced from categories already in use, so casing/spelling stays consistent. - Per-spool low-stock threshold input. Empty = global default; the global value renders as the placeholder. Inventory page: - New category filter chip (hidden until at least one spool carries a category — keeps the chip row uncluttered). - Stat-card "Low Stock" count and the "Low Stock" filter both honour the per-spool override. Plus: rename "Delete Tag" button to "Clear RFID Tag" (the original ticket reporter mistook it for a taxonomy-tag delete; the button actually clears the RFID UID/UUID off the spool record). Toast key renamed from `tagDeleted` to `rfidCleared`. i18n: full translations across all 8 locales. Tests: 9 new backend schema tests (defaults, partial-update, range rejection, max-length); 2 new frontend tests (per-spool threshold pulls extra spools into low-stock count, filter chip hidden when no categories exist).
65 lines
4.0 KiB
Python
65 lines
4.0 KiB
Python
from datetime import datetime
|
|
|
|
from sqlalchemy import Boolean, DateTime, Float, Integer, String, func
|
|
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
|
|
|
from backend.app.core.database import Base
|
|
|
|
|
|
class Spool(Base):
|
|
"""Spool inventory item for tracking filament spools and their properties."""
|
|
|
|
__tablename__ = "spool"
|
|
|
|
id: Mapped[int] = mapped_column(primary_key=True)
|
|
material: Mapped[str] = mapped_column(String(50)) # PLA, PETG, ABS, etc.
|
|
subtype: Mapped[str | None] = mapped_column(String(50)) # Basic, Matte, Silk, etc.
|
|
color_name: Mapped[str | None] = mapped_column(String(100)) # "Jade White"
|
|
rgba: Mapped[str | None] = mapped_column(String(8)) # RRGGBBAA hex
|
|
brand: Mapped[str | None] = mapped_column(String(100)) # "Polymaker"
|
|
label_weight: Mapped[int] = mapped_column(Integer, default=1000) # Advertised net weight (g)
|
|
core_weight: Mapped[int] = mapped_column(Integer, default=250) # Empty spool weight (g)
|
|
core_weight_catalog_id: Mapped[int | None] = mapped_column(
|
|
Integer
|
|
) # Reference to spool_catalog entry for core weight
|
|
weight_used: Mapped[float] = mapped_column(Float, default=0) # Consumed grams
|
|
weight_locked: Mapped[bool] = mapped_column(Boolean, default=False) # Lock weight from AMS auto-sync
|
|
last_scale_weight: Mapped[int | None] = mapped_column(Integer) # Last gross weight from scale (g)
|
|
last_weighed_at: Mapped[datetime | None] = mapped_column(DateTime) # When last weighed
|
|
slicer_filament: Mapped[str | None] = mapped_column(String(50)) # Preset ID (e.g. "GFL99")
|
|
slicer_filament_name: Mapped[str | None] = mapped_column(String(100)) # Preset name for slicer
|
|
nozzle_temp_min: Mapped[int | None] = mapped_column() # Override min temp
|
|
nozzle_temp_max: Mapped[int | None] = mapped_column() # Override max temp
|
|
note: Mapped[str | None] = mapped_column(String(500))
|
|
added_full: Mapped[bool | None] = mapped_column() # Whether spool was added as full (unused)
|
|
|
|
# User-defined category (e.g. "Production", "Prototype", "Client A") for
|
|
# filtering and per-group low-stock thresholds (#729). Free text — the
|
|
# form autocompletes from categories already present on other spools.
|
|
category: Mapped[str | None] = mapped_column(String(50))
|
|
# Per-spool override of the global inventory low-stock threshold (%).
|
|
# NULL falls back to the `low_stock_threshold` setting. Lets users mark
|
|
# production spools with a higher threshold (alert earlier) and prototype
|
|
# spools with a lower one without changing the global default.
|
|
low_stock_threshold_pct: Mapped[int | None] = mapped_column(Integer)
|
|
|
|
# Cost tracking
|
|
cost_per_kg: Mapped[float | None] = mapped_column(Float) # Cost per kilogram
|
|
|
|
last_used: Mapped[datetime | None] = mapped_column(DateTime) # Last time this spool was used in a print
|
|
encode_time: Mapped[datetime | None] = mapped_column(DateTime) # When spool was encoded/written to tag
|
|
tag_uid: Mapped[str | None] = mapped_column(String(16)) # RFID tag UID (16 hex chars)
|
|
tray_uuid: Mapped[str | None] = mapped_column(String(32)) # Bambu Lab spool UUID (32 hex chars)
|
|
data_origin: Mapped[str | None] = mapped_column(String(20)) # How data was populated: manual, rfid_auto, nfc_link
|
|
tag_type: Mapped[str | None] = mapped_column(String(20)) # Tag vendor: bambulab, generic, etc.
|
|
archived_at: Mapped[datetime | None] = mapped_column(DateTime) # NULL = active
|
|
created_at: Mapped[datetime] = mapped_column(DateTime, server_default=func.now())
|
|
updated_at: Mapped[datetime] = mapped_column(DateTime, server_default=func.now(), onupdate=func.now())
|
|
|
|
k_profiles: Mapped[list["SpoolKProfile"]] = relationship(back_populates="spool", cascade="all, delete-orphan")
|
|
assignments: Mapped[list["SpoolAssignment"]] = relationship(back_populates="spool", cascade="all, delete-orphan")
|
|
|
|
|
|
from backend.app.models.spool_assignment import SpoolAssignment # noqa: E402
|
|
from backend.app.models.spool_k_profile import SpoolKProfile # noqa: E402
|