Known external blockers¶
Things that cannot be fixed from inside the codebase, the exact condition each one puts the
product in, and who unblocks it. Updated 2026-09-18. Everything buildable around these has been
built; the entries stay here so nobody re-diagnoses them. Internal delivery status (CI, billing
configuration, vendor account funding, security attestations) is tracked in the repository at
docs/operations/internal-blockers.md, not on this page.
| # | Blocker | Effect today | What it needs | Owner |
|---|---|---|---|---|
| 1 | Procore RFI tool not enabled on the pilot project | GET /rest/v1.0/rfis and create RFI return 404 in the sync ledger; observations sync fine. |
Enable the RFI tool on that Procore project (Procore admin). | Procore project admin |
| 2 | Procore create observation 500 seen once on pilot day (2026-09-10) |
one ledger error row; later pushes succeeded. | Nothing unless it recurs; vendor-side transient. | — |
| 3 | ACC connected but never synced | the ACC row shows "never synced"; no hub/project selected; issue/RFI sync inert. | Pick a hub and project in the Integrations tab; the operator must register the ACC webhooks (see ACC / Procore activation §5) — unverifiable from inside the app. | Project admin + operator |
| 4 | Vendor webhook registration (ACC, Procore) | inbound sync is button-driven until webhooks exist. | Register the webhook URLs with each vendor using the secrets in Dokploy. | Operator |
| 5 | No Planon tenant | the Planon adapter is untested against a live Planon; the wizard connects, push/pull runs against whatever base URL is given. | A Planon sandbox URL and API key. | Customer / Planon admin |
| 6 | Accounting adapters other than Odoo | listed as Pending OQ-6.1.x in Workspace settings › Accounting. | Product decision + vendor sandbox per adapter. | Product |
| 7 | DWG converter not installed on the server | DWG/DXF sheet uploads log DWG converter not installed (set DWG_CONVERTER_PATH); PDF/images work. |
Install a converter on the worker image and set DWG_CONVERTER_PATH. |
Operator |
| 8 | PDAL / PotreeConverter / ffmpeg binaries | .e57/.ply/.pts need PDAL_PATH; point-cloud octrees need PotreeConverter; walkthrough video frames need FFMPEG_PATH. Each fails gracefully with a message naming the variable. |
Install the binaries in the worker image; set the paths. | Operator |
| 9 | SMTP | invitations, scheduled reports and acknowledgement emails need SMTP_*; without it the UI offers copyable links and in-app notifications. |
An SMTP relay (SendGrid, SES…). | Operator |
| 10 | Viewer engine limits | no cross-model geometry de-duplication (the fragments engine at 3.4.5 has no API for it); shadow-catcher and clip-capping are intentional viewer limitations. | Upstream engine work; not buildable here. | — |
| 11 | Test project georeference vs survey coordinates | the SA Test IFC's map footprint lands far from its origin because the IFC uses survey coordinates; the Map zooms to fit both. Data, not code. | Set the origin to the model's local origin, or re-export near the site. | Project admin |
How to use this page¶
- Before debugging a symptom in this list, check the owner column and hand it over with the row.
- When an item is unblocked, delete the row and note it in
docs/PHASE-EXECUTION-LOG-2026-09.md. - Anything not on this list is assumed buildable; the September log's rule was "inspect → reproduce → fix → test → push → deploy → verify".