🔩 Pieces
A Piece is the workshop's manufacturable unit: the combination of a Design with a specific material, colors, and finish. It's what the printer physically produces.
Pieces don't have their own list page
Unlike Designs or Products, there is no standalone Piece gallery. You access them from the detail view of the Design they belong to. The reason is that a Piece is always tied to a Design — it makes no sense without one.
The usual flow is:
- You open a Design from the gallery.
- In the design detail view you see the list of associated Pieces.
- From there you create, edit, or delete Pieces.
Create a Piece
From a Design's detail view, click "+ New piece". The form asks you for:
| Field | Description |
|---|---|
| Material | PLA, PETG, ABS, Resin, etc. |
| Color(s) | One or more colors with a color picker (hex). Multicolor option. |
| Finish | Unprocessed / Processed / Painted. |
| Cost KG | The price per kilo of the material. It's filled in automatically when the color is a material from your inventory; otherwise it uses the workshop's default value. Always editable. |
| Weight | Grams this configuration consumes (affects cost). |
| Print time | Estimated hours (informational). |
| Cost | Calculated automatically (weight × Cost KG + finish) or entered manually. |
The Piece name is generated automatically from the Design title. The material and color are shown with icons and color circles on the cards — you don't need to include them in the name.
Cost vs. price
The Piece has a cost — what it costs you to produce it (material + finish). The sale price is defined on the Variant, not on the Piece. This separation is what lets you calculate real margins in the Finances module.
Where does the "Cost KG" come from? The material cost is calculated as weight × Cost KG. That price per kilo is filled in as follows:
- If you give the piece a material from your inventory (a filament or resin in stock that has a cost), the Cost KG is taken from that material instantly — you'll see the cost update as soon as you pick it. If you add several materials, the average is used.
- If you don't use an inventory material (or that material doesn't have a cost yet), the workshop's default value is used, which you define in Settings → Parameters → Default costs.
- In any case you can enter the Cost KG manually. It gets fixed on the piece: if you later change the default prices or those in the inventory, pieces already created are not modified on their own — you review and update them whenever you want.
From Piece to Variant
Once the Piece is created, you can include it in one or more Product Variants. A Variant can combine several Pieces (for example, a pack of three different figures).