feat: global material override on OutputType for x-ray/clay render modes

- Add `material_override` nullable column on OutputType (DB migration)
- When set, ALL product parts get rendered with this single material
- Override applies after alias resolution in render_order_line task
- Admin UI: dropdown in OutputType table to select a library material
- Display: amber badge showing active override material name

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

backend/alembic/versions/cfcc7ad1e7d5_add_material_override_to_output_types.py

@@ -0,0 +1,30 @@
+"""add material_override to output_types
+
+Revision ID: cfcc7ad1e7d5
+Revises: 4c15abf3cf40
+Create Date: 2026-03-14 12:12:03.706587
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'cfcc7ad1e7d5'
+down_revision: Union[str, None] = '4c15abf3cf40'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column('output_types', sa.Column('material_override', sa.String(length=200), nullable=True))
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column('output_types', 'material_override')
+    # ### end Alembic commands ###

backend/app/domains/pipeline/tasks/render_order_line.py

@@ -198,6 +198,12 @@ def render_order_line_task(self, order_line_id: str):
                 from app.services.material_service import resolve_material_map
                 material_map = resolve_material_map(material_map)
 
+            # Apply global material override from OutputType (e.g. x-ray mode)
+            if line.output_type and line.output_type.material_override:
+                override_mat = line.output_type.material_override
+                material_map = {k: override_mat for k in material_map}
+                emit(order_line_id, f"Material override active: all parts → {override_mat}")
+
             if template:
                 emit(order_line_id, f"Using render template: {template.name} (collection={template.target_collection}, material_replace={template.material_replace_enabled}, lighting_only={template.lighting_only})")
                 logger.info(f"Render template resolved: '{template.name}' path={template.blend_file_path}, lighting_only={template.lighting_only}")

backend/app/domains/rendering/models.py

@@ -44,6 +44,8 @@ class OutputType(Base):
         DateTime, default=datetime.utcnow, onupdate=datetime.utcnow, nullable=False
     )
 
+    material_override: Mapped[str | None] = mapped_column(String(200), nullable=True, default=None)
+
     workflow_definition_id: Mapped[uuid.UUID | None] = mapped_column(
         UUID(as_uuid=True), ForeignKey("workflow_definitions.id", ondelete="SET NULL"), nullable=True
     )

backend/app/domains/rendering/schemas.py

@@ -17,6 +17,7 @@ class OutputTypeCreate(BaseModel):
     transparent_bg: bool = False
     pricing_tier_id: int | None = None
     cycles_device: str | None = None
+    material_override: str | None = None
 
 
 class OutputTypePatch(BaseModel):
@@ -34,6 +35,7 @@ class OutputTypePatch(BaseModel):
     pricing_tier_id: int | None = None
     cycles_device: str | None = None
     workflow_definition_id: uuid.UUID | None = None
+    material_override: str | None = None
 
 
 class OutputTypeOut(BaseModel):
@@ -54,6 +56,7 @@ class OutputTypeOut(BaseModel):
     price_per_item: float | None = None
     workflow_definition_id: uuid.UUID | None = None
     workflow_name: str | None = None
+    material_override: str | None = None
     is_active: bool
     created_at: datetime
     updated_at: datetime