Plan Pipeline

The Plan Pipeline is the admin workspace for getting floor plans into Forager. Upload a PDF, attach it to a location node, and watch it move through every processing stage — from raw upload to a calibrated vector plan ready for asset placement.

​

Intake: uploading a plan

At the top of the page, the Intake a floor plan panel lets you attach a PDF to any location node in your company.

1. Choose a node from the dropdown. Nodes are grouped Needs a plan (no plan yet) and Replace existing plan.
2. Select a floor-plan PDF (25 MB maximum).
3. Click Upload & process.

Processing starts automatically once the upload lands — you do not need to trigger anything separately. Replacing an existing plan resets that node’s pipeline state, so simplification and vectorization re-run from scratch and the previous plan’s calibration is cleared.

​

The pipeline board

The summary cards count how many plans sit in each phase; click a card to filter the table below it. The Failed / stuck card turns red when it has any entries. The table shows each plan’s node name and hierarchy path, current stage, render mode, pixel dimensions, scale, and when it last changed. Type in the search box to find a node by name — including nodes that have no plan yet.

​

Inspecting a plan

Click any row to open the detail panel. It shows the full pipeline state and signed download links to the plan’s artifacts: the original PDF, the simplified plan, the vector GeoJSON, and the mbtiles. Links appear only for artifacts that have been generated.

​

Retrying

Failed and stuck rows show a Retry button both inline in the table and in the detail panel. Retrying re-runs processing from the current PDF. Use it when a job died mid-run or after fixing a source PDF and re-uploading.