Files
bambuddy/backend/app/models/project.py
T
maziggy 693466eafc Add project parts tracking separate from plates
Track individual parts/objects separately from print plates in projects.
Useful for multi-part builds like Voron where 25 plates produce 150 parts.

Backend:
- Add target_parts_count field to Project model
- Calculate parts_progress_percent and remaining_parts in stats
- Auto-detect quantity from 3MF printable objects when archiving
- Sum archive quantities for completed_count (parts)
- Use archive_count for plates progress

Frontend:
- Add "Target Parts" input in project create/edit modal
- Show separate progress bars for plates vs parts
- Stats footer displays both plates and parts count
- Header badge shows parts progress when target set

Scripts:
- Add update_archive_quantities.py to migrate existing archives

Tests:
- Add 5 integration tests for parts tracking
- Add 3 unit tests for 3MF object extraction

Closes #85
2026-01-16 07:33:44 +01:00

74 lines
3.1 KiB
Python

from datetime import datetime
from sqlalchemy import JSON, Boolean, DateTime, Float, ForeignKey, Integer, String, Text, func
from sqlalchemy.orm import Mapped, mapped_column, relationship
from backend.app.core.database import Base
class Project(Base):
"""Project to group related prints (e.g., 'Voron Build' with multiple parts)."""
__tablename__ = "projects"
id: Mapped[int] = mapped_column(primary_key=True)
name: Mapped[str] = mapped_column(String(255))
description: Mapped[str | None] = mapped_column(Text, nullable=True)
color: Mapped[str | None] = mapped_column(String(20), nullable=True) # Hex color for UI
status: Mapped[str] = mapped_column(String(20), default="active") # active, completed, archived
target_count: Mapped[int | None] = mapped_column(
Integer, nullable=True
) # Optional target number of prints (plates)
target_parts_count: Mapped[int | None] = mapped_column(
Integer, nullable=True
) # Optional target number of parts/objects
# Phase 2: Rich text notes (HTML from WYSIWYG editor)
notes: Mapped[str | None] = mapped_column(Text, nullable=True)
# Phase 3: File attachments stored as JSON array
# Format: [{"filename": "x.stl", "original_name": "part.stl", "size": 1234, "uploaded_at": "..."}]
attachments: Mapped[list | None] = mapped_column(JSON, nullable=True)
# Phase 4: Tags (comma-separated)
tags: Mapped[str | None] = mapped_column(Text, nullable=True)
# Phase 5: Due dates and priority
due_date: Mapped[datetime | None] = mapped_column(DateTime, nullable=True)
priority: Mapped[str] = mapped_column(String(20), default="normal") # low, normal, high, urgent
# Phase 6: Budget tracking
budget: Mapped[float | None] = mapped_column(Float, nullable=True)
# Phase 8: Templates
is_template: Mapped[bool] = mapped_column(Boolean, default=False)
template_source_id: Mapped[int | None] = mapped_column(Integer, nullable=True)
# Phase 10: Sub-projects (hierarchical)
parent_id: Mapped[int | None] = mapped_column(ForeignKey("projects.id"), nullable=True)
# Timestamps
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())
# Relationships
archives: Mapped[list["PrintArchive"]] = relationship(back_populates="project")
queue_items: Mapped[list["PrintQueueItem"]] = relationship(back_populates="project")
children: Mapped[list["Project"]] = relationship(
"Project",
back_populates="parent",
foreign_keys="Project.parent_id",
)
parent: Mapped["Project | None"] = relationship(
"Project",
back_populates="children",
remote_side="Project.id",
foreign_keys="Project.parent_id",
)
bom_items: Mapped[list["ProjectBOMItem"]] = relationship(back_populates="project", cascade="all, delete-orphan")
from backend.app.models.archive import PrintArchive # noqa: E402
from backend.app.models.print_queue import PrintQueueItem # noqa: E402
from backend.app.models.project_bom import ProjectBOMItem # noqa: E402