Production workflow (Rev F)
The process of record for running a customer order through the shop. This file is the one source: the tracker's Process page (/process/) draws these diagrams from it, and every node there opens the screen that does the step. Change the process here, in the same PR as the code.
Checked against the code on 2026-11-10. The text companion, step by step, is docs/running-an-order.md.
| Style | Meaning |
|---|---|
| Navy fill | Built and running |
| Light blue fill | Built but partly working, degraded or unvalidated (the table says why) |
| White, dashed border | Not built |
| Charcoal bold border | A person does this step |
| ⚠ | Single point of failure: one PC or one person |
1. Running a customer order
flowchart TB
CO["Sales confirms the CO<br/>MRPeasy"]
BOOK["Book product and standalone MOs<br/>CO goes to Waiting for production"]
SCH["Schedule<br/>lane due dates chain back from delivery"]
subgraph PLAN["Planning lane · one card per order"]
P1A["1a Order matches the quote<br/>Sales"]
P1B["1b Order configured correctly<br/>Production / Engineering"]
P2["2 MOs booked and scheduled<br/>Planner"]
P3["3 Prep ran<br/>automatic"]
P4["4 Engineering complete<br/>Engineering"]
PL["Confirm: add to laser nesting"]
PR["Release to floor<br/>priority Hot · Normal · Cold"]
end
HOLD["Until released<br/>work is faint and routed to nobody"]
subgraph PREP["Automatic prep"]
DW["⚠ Data worker · robot_plant<br/>orders sync · BOM walk · picking sheets"]
LX["⚠ Laser export worker · robot_plant<br/>one CSV for the ticked orders"]
NS["⚠ Striker nester · laser PC<br/>nest · NC · copy to USB stick"]
NP["Nest publisher<br/>sheets on the Laser page"]
end
subgraph ENG["Engineering, alongside"]
EL["Engineering lane<br/>numbered issues per order"]
CAD["CAD-to-MRP and Inventor<br/>Auto Draw · DXF · Picking CAD · product group"]
DPUB["⚠ Fab drawing publisher · robot_plant<br/>every 15 min"]
end
FLOOR["Floor lanes<br/>Picking to Packaging · diagram 2"]
CHK["Checklist lane<br/>checklist · serial · photos · named sign-off"]
SER["Serials page<br/>serial and as-built photos"]
PACK["Packaging<br/>Ready to Ship"]
SHIP["Ship and close out the CO"]
CO --> BOOK & SCH
SCH --> PLAN
BOOK --> DW --> P3
CAD --> EL --> P4
CAD --> DPUB
P1A & P1B & P2 & P4 & PL --> PR
PR -.-> HOLD
PL --> LX --> NS --> NP --> FLOOR
PR --> FLOOR --> CHK --> PACK --> SHIP
CHK --- SER
click SCH "/#schedule" "Schedule tab"
click BOOK "/#schedule" "Schedule order panel"
click P1A "/work-queue.php#planning" "Planning lane"
click P1B "/work-queue.php#planning" "Planning lane"
click P2 "/work-queue.php#planning" "Planning lane"
click P3 "/work-queue.php#planning" "Planning lane"
click P4 "/work-queue.php#planning" "Planning lane"
click PL "/work-queue.php#planning" "Planning lane"
click PR "/work-queue.php#planning" "Planning lane"
click HOLD "/work-queue.php#planning" "Planning lane"
click DW "/api/work_queue.php?view=prep" "Worker check-ins (JSON)"
click LX "/laser/" "Laser nests"
click NS "/api/laser.php?nest_runs=1" "Nester runs (JSON)"
click NP "/laser/" "Laser nests"
click EL "/work-queue.php#engineering" "Engineering lane"
click CAD "/cad-to-mrp/" "CAD to MRP hub"
click FLOOR "/work-queue.php" "Work Queue"
click CHK "/work-queue.php#checklist" "Checklist lane"
click SER "/serials/" "Serials"
click PACK "/work-queue.php#pack" "Packaging lane"
classDef built fill:#2C3E5C,stroke:#2C3E5C,color:#FFFFFF
classDef degraded fill:#D5E2EC,stroke:#2C3E5C,color:#2B2B2B
classDef notbuilt fill:#FFFFFF,stroke:#2C3E5C,color:#2B2B2B,stroke-dasharray: 5 3
classDef manual fill:#F5F5F0,stroke:#2B2B2B,color:#2B2B2B,stroke-width:2px
classDef degradedmanual fill:#D5E2EC,stroke:#2B2B2B,color:#2B2B2B,stroke-width:2px
class SCH,P3,HOLD,DW,LX,NP,EL,DPUB built
class NS degraded
class SHIP notbuilt
class CO,BOOK,P1A,P1B,P2,P4,PL,PR,CAD,FLOOR,SER,PACK manual
class CHK degradedmanual
style PLAN fill:#FFFFFF,stroke:#D5E2EC
style PREP fill:#FFFFFF,stroke:#D5E2EC
style ENG fill:#FFFFFF,stroke:#D5E2EC
| Step | System | Mode | Where |
|---|---|---|---|
| Confirm the CO | MRPeasy | Manual (Sales) | MRPeasy. Confirmed puts it on the Schedule and in Planning |
| Book MOs | MRPeasy, or the Schedule's order panel (add, move, cancel MOs; writes to MRPeasy) | Manual | /#schedule. Prep and engineering items only run once the CO is Waiting for production or In production |
| Schedule | Production Tracker | Automatic | /#schedule. Lane due dates chain back from the delivery date using each machine's process times |
| Planning 1a, 1b, 2, 4 | Planning lane, planning/?co= | Manual, by the people named in the approvals table | /work-queue.php#planning. 1a needs a delivery date. Ask Sales / Ask Engineering only record a note |
| Planning 3, Prep ran | Planning lane | Automatic | Shows whether every MO's BOM is walked |
| Confirm: add to laser nesting | Planning page or the Schedule's Laser box (same action) | Manual | Puts the order in the continuous laser nest |
| Release to floor | Planning lane | Manual (release approvers) | Refused until 1a, 1b, 2, 4 are signed, a delivery date exists and Laser is ticked (or a reason given). Priority can change after release |
| Data worker ⚠ | robot_plant scheduled task, picking-sheet-system | Automatic, every 2 min | Orders sync every 15 min, owner resolve, BOM walk, one picking sheet per run. Runs whether or not the order is released. Check-ins: /api/work_queue.php?view=prep |
| Laser export worker ⚠ | robot_plant scheduled task | Automatic, every 2 min | Rewrites the one Striker CSV for the ticked COs (up to 20) minus parts already nested; only when demand changes |
| Striker nester ⚠ | Laser PC (SP-LASER-COMPUT), workers/striker_nester | Automatic, every 5 min | Light blue: built and proven, but the last completed run was 2026-10-15 and the last attempt (2026-10-21) expired (/api/laser.php?nest_runs=1, read 2026-11-10). Not listed in stilt-platform JOBS.md. Fallback is the manual Striker flow (docs/laser-nest-staging.md) |
| Nest publisher | Laser export worker on robot_plant | Automatic, every 2 min | New NC becomes sheets on /laser/, parts tied to their MOs |
| Engineering lane | Work Queue | Manual (Engineering) | /work-queue.php#engineering. Numbered issues per machine configuration, oldest first; History tab |
| CAD-to-MRP | Inventor add-in (cad-to-mrp repo) | Manual (Engineering) | Auto Draw, Export DXF, Publish Picking CAD, set product group. Cleared work reports back automatically |
| Fab drawing publisher ⚠ | robot_plant scheduled task | Automatic, every 15 min | Posts changed drawings to the stage cards. No screen of its own |
| Floor lanes | Work Queue | Manual (operators), routed | /work-queue.php. Diagram 2 |
| Checklist lane | Work Queue, checklist/?mo= | Manual, named sign-off | Light blue: templates exist only for B-Series (Minor-B, B-Line, Super-B) and Rice Hull Blower. Other machines get a "no checklist yet" card that blocks nothing. Live since 2026-11-10 |
| Serials | /serials/ | Manual | Serial and as-built photos, opened from the checklist page |
| Packaging | Work Queue, packaging/?co= | Manual (operator) | One task per order; ticks Ready to Ship. The card warns "Blocked: finish Checklist" until signed (display only) |
| Ship and close out | None | Not built | Shipping, invoicing and closing the CO in MRPeasy are done by hand in MRPeasy. See docs/customer-order-closeout.md |
2. One MO through the floor
flowchart LR
REL["Order released<br/>from Planning"]
subgraph GATHER["Gather · side by side"]
PICK["Picking<br/>pick each row with its photo"]
LAS["Laser<br/>cut sheets · tick each part pulled"]
LIN["Linear Cut<br/>cut and tick each item"]
end
KIT["Kit Staged<br/>automatic: cut and picking done"]
subgraph FORM["Form · side by side"]
BEND["Bend<br/>press brake parts"]
FAB["Fabrication<br/>weld parts"]
end
PAINT["Paint<br/>one task per order · tick painted"]
subgraph BUILD["Build"]
ASM["Assembly<br/>assembly cards and 3D guide"]
ELEC["Electrical<br/>print labels · schematics"]
end
CHK["Checklist<br/>per machine MO · serial · sign-off"]
PACK["Packaging<br/>one task per order"]
SHIP["Ship and close out"]
REL --> GATHER --> KIT --> FORM
FORM --> PAINT
FORM --> BUILD
PAINT -.->|"card note only"| BUILD
BUILD --> CHK
CHK -.->|"warns until signed"| PACK
BUILD --> PACK --> SHIP
click REL "/work-queue.php#planning" "Planning lane"
click PICK "/work-queue.php#pick" "Picking lane"
click LAS "/work-queue.php#cut-laser" "Laser lane"
click LIN "/work-queue.php#cut-linear" "Linear Cut lane"
click KIT "/#production" "Production tab (stage strip)"
click BEND "/work-queue.php#bend" "Bend lane"
click FAB "/work-queue.php#fab" "Fabrication lane"
click PAINT "/work-queue.php#paint" "Paint lane"
click ASM "/work-queue.php#assemble" "Assembly lane"
click ELEC "/work-queue.php#electrical" "Electrical lane"
click CHK "/work-queue.php#checklist" "Checklist lane"
click PACK "/work-queue.php#pack" "Packaging lane"
classDef built fill:#2C3E5C,stroke:#2C3E5C,color:#FFFFFF
classDef degraded fill:#D5E2EC,stroke:#2C3E5C,color:#2B2B2B
classDef notbuilt fill:#FFFFFF,stroke:#2C3E5C,color:#2B2B2B,stroke-dasharray: 5 3
classDef manual fill:#F5F5F0,stroke:#2B2B2B,color:#2B2B2B,stroke-width:2px
classDef degradedmanual fill:#D5E2EC,stroke:#2B2B2B,color:#2B2B2B,stroke-width:2px
class REL,KIT built
class SHIP notbuilt
class PICK,LAS,LIN,BEND,FAB,PAINT,ASM,ELEC,PACK manual
class CHK degradedmanual
style GATHER fill:#FFFFFF,stroke:#D5E2EC
style FORM fill:#FFFFFF,stroke:#D5E2EC
style BUILD fill:#FFFFFF,stroke:#D5E2EC
| Step | System | Mode | Where |
|---|---|---|---|
| Released | Planning lane | Manual | Unreleased work shows faint, below released work, and is never routed. Hot sorts first, cold last |
| Picking | Paperless Picking, picking/?mo= | Manual | /work-queue.php#pick. Complete when submitted, no reviewer |
| Laser | laser/?co= | Manual | /work-queue.php#cut-laser. One card per order; tick each part pulled |
| Linear Cut | fab/?co=&stage=cut | Manual | /work-queue.php#cut-linear. Runs beside Laser; cut does not wait on picking |
| Kit Staged | Stage engine | Automatic | No lane. Completes when every laser part is pulled, every linear cut item ticked and picking is done. An MO with no cut work is tick-only (Production tab) |
| Bend | fab/?mo=&stage=bend | Manual | /work-queue.php#bend. LASER / BRAKE parts; beside Fabrication |
| Fabrication | fab/?mo=&stage=fab | Manual | /work-queue.php#fab. STILT.PRO FAB parts (weld) |
| Paint | paint/?co= | Manual tick | /work-queue.php#paint. Nothing records spraying, so it is always a tick. Waits on Bend and Fab |
| Assembly | fab/?mo=&stage=assemble | Manual | /work-queue.php#assemble. Waits on Bend and Fab, not on Paint (the card only notes open paint) |
| Electrical | electrical/?mo= | Manual | /work-queue.php#electrical. MOs whose MRPeasy routing is all Electrical Assembly and have no painted parts. Complete only when every label file is ticked printed |
| Checklist | checklist/?mo= | Manual, named sign-off | /work-queue.php#checklist. One per base machine MO; needs every required item and a serial. Light blue: two machine families only (see table 1) |
| Packaging | packaging/?co= | Manual | /work-queue.php#pack. Waits on Assembly; warns until the checklist is signed |
| Ship and close out | None | Not built | Done in MRPeasy by hand |
Every card has Review task (opens without claiming), Start work when available (explicit claim), and, for stage work, Print Job (that stage's drawings). Stage cards with build-sheet checklist items link to just those items.
Pages 3, 4 and 4B of Rev E
CAD intake and Striker nesting are not redrawn here. They belong to CAD-to-MRP and the laser runbook:
- CAD intake: cad-to-mrp and
docs/cross-repo-production-pipeline.md. - Striker nesting to NC (automatic) and the manual fallback:
docs/laser-nest-staging.md,docs/continuous-nesting-plan.md,workers/striker_nester/README.md.
Revision history
| Rev | Date | Where | Change |
|---|---|---|---|
| E | 2026-10-06 | draw.io, 3D CAD DATA - Documents\Drawings\Production System Flowchart- STILT.PRO RevE.drawio | Continuous laser nest, Striker nester, eight floor lanes with sign-in and routing. Archived: do not edit; this file replaces it |
| F | 2026-11-10 | This file and /process/ | Planning lane (sign-offs, release, Hot/Normal/Cold), Engineering lane replaces the CAD to MRP hub to-do, Electrical lane, Checklist lane before Packaging, ship and close-out shown as not built |