Documents

The Documents tab is where every drawing, specification, schedule, RFI, submittal, and report enters Struxen. Once a document is uploaded the INGRESS pipeline classifies it, extracts text, generates embeddings, and makes it queryable by STRUX and VANTAGE.

Uploading documents

Drag and drop

The fastest path: open Documents in any project and drag files from your desktop onto the drop zone. You can drop:

• A single file
• Multiple files (they upload in parallel)
• A folder — Struxen walks the tree and preserves the folder name as a tag

Upload button

Click Upload to open a system file picker. Hold Shift or Ctrl/Cmd to select multiple files. Same file types as drag-and-drop are supported.

Supported file types

Category	Formats
Drawings	PDF (vector and raster), DWG, DXF
Specifications	PDF, DOCX, DOC
Schedules	XLSX, XLS, MPP, PDF
RFIs / Submittals	PDF, DOCX
Images	PNG, JPG, JPEG, TIFF
Reports	PDF, DOCX, XLSX

Maximum single-file size is 500 MB. For larger sheet sets, split into volumes (e.g. "A-series", "S-series") before uploading.

INGRESS classification

Every uploaded document passes through INGRESS, the classification and indexing pipeline. INGRESS:

1. Detects format — vector PDF vs scanned, drawing vs document.
2. Extracts text — direct extraction for born-digital PDFs, OCR for scans.
3. Classifies type — drawing sheet, specification section, RFI, submittal, schedule, etc.
4. Tags discipline — architectural, structural, mechanical, electrical, plumbing, civil, low-voltage, etc.
5. Generates embeddings — used by STRUX and VANTAGE for semantic retrieval.
6. Indexes for search — full-text and vector search both go live.

Classification typically completes in 30–90 seconds per document. The status pill on each row progresses Pending → Processing → Ready. If a document fails classification (rare, usually corrupted PDFs), the pill shows Failed with a tooltip describing the reason. Re-upload a clean copy to retry.

Versions

Struxen treats documents as version sets. When you upload a file with the same name as an existing document in the same folder, Struxen prompts:

• Replace — uploads as a new version (v002, v003, …). Previous versions remain accessible via the version dropdown on the row.
• Keep both — uploads as a separate document with a numeric suffix.

Findings, citations, and STRUX answers always pin to the version they were generated against. If a drawing changes, re-running VANTAGE on the new version produces a fresh finding set.

Folders and organization

Use folders to mirror your existing project structure (e.g. "00 General", "01 Architectural", "02 Structural"). Folders are purely organizational — INGRESS classification and STRUX retrieval work the same regardless of folder placement.

To move documents: select rows and click Move, then pick the destination folder.

Bulk actions

Select multiple rows (checkbox column) to:

• Move to another folder
• Tag with a discipline or custom label
• Delete (Owner/Admin only)
• Re-run INGRESS classification (if the type was misdetected)

Troubleshooting

Document stuck on "Processing" for more than 5 minutes. Refresh the page. If still stuck, click the row, then Re-run INGRESS in the detail panel. If it fails again, email support@struxen.io with the document name and project ID.

Scanned PDF returning poor STRUX results. OCR quality depends on scan resolution. Re-scan at 300 DPI minimum, or upload the original born-digital PDF if available.

Cannot delete a document. Only org Owners and Admins can delete. Members can move documents but not remove them, to prevent accidental loss of project history.