StructumAI Plans: Drawing & Field Collaboration Platform

Plans is StructumAI's construction-drawing workspace, built to stand shoulder-to-shoulder with commercial tools like PlanGrid, Autodesk Build, and Fieldwire: upload blueprint sets, mark them up in the field, track punch-list and RFI-style tasks against exact drawing locations, compare drawing revisions, and roll all of it into reports, inside a secure, multi-tenant product that plugs into a larger platform without ever breaking its shared login.

Avrixo designed and built the module end to end: architecture, backend, frontend, database, and deployment, in roughly three months. The result is a production system with 26 database tables, a full role-based permission engine, real-time multi-user collaboration, scheduled report automation, and a hardened authentication contract now shared across the platform's other independently-deployed modules.

Multi-file PDF upload triggers automatic sheet extraction: every page of a plan set becomes an individually addressable, searchable sheet with a server-rendered thumbnail (pdfjs-dist + sharp / @napi-rs/canvas), full-text searchable via Postgres tsvector/GIN indexes. On top of that sits an 11-tool markup suite: pin, rectangle, circle, cloud, arrow, freehand, highlight, line, X-mark, text, and a custom 'worm' linked pin for cross-sheet call-outs, with per-annotation styling, undo/redo, and stamp placement that instantly generates a linked, pre-configured task.

A per-sheet scale-calibration tool derives a real-world scale factor from a reference line, driving a true-distance measure tool. Tasks are drawing-linked, first-class entities surfaced through a Task Center with rich filtering, saved views, and CSI MasterFormat 2018 stamp templates. Sheets carry full revision history with a side-by-side Compare view, plus a carry-forward workflow: review each open markup from the prior revision and mark it carried, skipped, or flagged with a confidence rating, every decision logged, solving the classic 'did we lose our punch list when the drawing was reissued?' problem.

Every annotation and task carries a publish / unpublish / archive state independent of its workflow status, so field staff can draft privately before a project admin publishes to the wider team. Pusher powers real-time collaboration: live cursors, a presence bar, and instant sync of annotations, tasks, and comments across users on the same sheet, while three report types (Task, Photo, Sheet) export to branded PDF, CSV, and XLSX, backed by a cron-driven Scheduled Reports engine running three production jobs with per-run status tracking.

Platform integration is the hardest constraint solved: the platform sets a shared JWT cookie on its root domain after login, and the module, deployed as a /plans sub-path of the same host specifically to avoid cross-origin cookie issues, verifies that same token server-side with the same secret, trusting { userId, tenantId, email } and scoping every query by tenant. No second login, no separate user table, no cross-origin dance. Avrixo authored the internal Module ↔ Platform Integration Guide used to onboard the platform's other modules onto this same pattern.