1. Compliance Standards & Safety Regulations
Field operations conducted using FiberBore Studio must comply with civil engineering, safety, and damage prevention regulations:
- OSHA 29 CFR 1926 Subpart P: Safety and health standards for excavation, trenching, and protective systems.
- APWA Uniform Color Code: Standardized color markings for temporary identification of buried utilities.
- CGA Best Practices (v20.0): Common Ground Alliance guidance for damage prevention, cross-bore mitigation, and tolerance zones.
- ANSI/SCTE 77 (2023): Specification for underground enclosure integrity and structural load ratings (Tier 8, 15, 22).
- State 811 / Blue Stakes Statutes: Mandatory 48-to-72 hour locate ticket submission windows and tolerance zone restrictions.
2. Directional Drilling & System Acronyms
| Acronym | Formal Term | Operational Meaning in FiberBore |
|---|---|---|
| HDD | Horizontal Directional Drilling | Steerable trenchless bore method using drill rig, walkover sonde locator, and pullback reamer. |
| HH | Handhole Enclosure | Below-grade polymer concrete box with flush lid (24x36, 17x30, 14x19, 36x48). |
| PED | Pedestal Enclosure | Above-ground vertical fiberglass stake post for rural or high water table installations. |
| FP | Flowerpot Can | Direct-buried cylindrical lawn enclosure flush with turf for residential drop transitions. |
| SUE | Subsurface Utility Engineering | Quality levels of underground utility identification (potholing, electromagnetic locates). |
| WAL | Write-Ahead Logging | High-speed SQLite concurrency mode permitting non-blocking reads and concurrent writes. |
3. Edge Hub Architecture & Security Topology
FiberBore Studio operates on an edge-computing model with zero cloud subscription costs:
- Hardware: Raspberry Pi Zero 2 W (quad-core ARM64 @ 1.0 GHz, 512MB RAM, <1.8W power draw).
- Encrypted Mesh: Tailscale Funnel creates authenticated WireGuard TLS tunnels directly to the public HTTPS domain
https://fiberbore.tail798550.ts.net. - Web & Proxy Stack: Nginx reverse proxy handles static file delivery, gzip compression, WebSocket upgrades on
/ws, and on-demand database streaming on/download-db. - Embedded Database: SQLite 3 with WAL journal mode and 20-second busy timeout at
/var/www/data/fiberbore.db.
4. Field Access & Mobile PWA Deployment
Field crews access the live map at https://fiberbore.tail798550.ts.net without App Store downloads:
Open link in Safari โ Tap Share [โ] โ Select "Add to Home Screen" โ Confirm "FiberBore". Launches in dedicated edge-to-edge standalone mode without Safari bars.
Open link in Chrome โ Tap three dots (โฎ) โ Select "Install App" or "Add to Home screen". Adds high-res icon to drawer and home screen.
5. Operator Identity & Attribution Engine
Every bore line, handhole box, and blue stake markup is stamped with the author's identity:
- Tap the profile pill in the top header:
๐ค Field Operator. - Configure: Name (e.g. Julio), Drill Crew (Drill Canyon, Missile Canyon, Don Tony, Los Primos, CAA, Supervisor, Inspector), and Avatar Color.
- Every saved feature receives an immutable author card visible when inspected with the Select (
V) tool.
6. Directional Drilling (HDD) SOPs & Rod Math
The platform separates drilling operations into two distinct visual states:
- Planned Bore (Highlighter Mode -
B): 12px translucent vector stroke (65% opacity). Proposed engineering corridor. Underlying CAD street names, ROW lines, and parcels remain 100% visible beneath the stroke. - Actual Bore (Solid Drill Mode -
A): 5px bold solid vector stroke representing verified drilled and pulled conduit. Recalculates team production footage instantly. - Scale Calibration (
C): Click two points with a known distance (e.g. 100 ft bar scale), enter feet, and tap apply. All footage calculations update mathematically:Footage = ฮฃ โ((xโ - xโ)ยฒ + (yโ - yโ)ยฒ) ร ScaleFactor - Drill Rod Conversion: 10-ft rods (Vermeer D20x22 / Ditch Witch JT20) =
Footage / 10; 15-ft rods (Vermeer D40x55 / Ditch Witch JT40) =Footage / 15. - Minimum Depth of Cover: 36" in parkway/sidewalk, 48" under roadways, 72" under railroad tracks.
7. Telecom Box & Enclosure Inventory Catalog
FiberBore Studio strictly tracks Box Counts across standard telecom industry specifications:
| Box Code | Dimensions (WรLรD) | Standard Field Application |
|---|---|---|
| HH 24ร36 | 24" ร 36" ร 24" | Main Distribution Box: Primary lateral tie-in & customer drop terminal aggregation. |
| HH 17ร30 | 17" ร 30" ร 18" | Service Handhole: Intermediate cable pulling point along long roadway bores. |
| HH 14ร19 | 14" ร 19" ร 12" | Drop Handhole: Small-footprint residential lot boundary transition box. |
| HH 36ร48 | 36" ร 48" ร 36" | Heavy-Duty Vault / Handhole: High-capacity feeder trunk line crossings & slack loops. |
| PED | Vertical Post | Above-Ground Pedestal: Vertical stake post for flood plains or uncurbed rural ROWs. |
| FP | 10"โ12" Can | Flowerpot: Direct-buried round plastic cylinder flush with lawn turf. |
8. 811 Locate Tickets & Subsurface Damage Prevention (SUE)
- Tolerance Zone Rule: Mechanical excavation and directional drilling are strictly prohibited within 18" to 24" of locate markings without physical exposure via non-destructive vacuum excavation (potholing).
- APWA Colors: ๐ก Yellow = Gas, ๐ด Red = Electric, ๐ต Blue = Water, ๐ Orange = Comms, ๐ข Green = Sewer, ๐ฃ Purple = Reclaimed Water.
- 811 Ticket Statuses:
โข First Notice (Blue Dashed): Ticket logged; locators dispatched. Do not drill.
โข Second Notice (Yellow Dashed): Follow-up escalation; locator tardy.
โข Third Notice (Red Dashed): Emergency escalation; utility failed to respond.
โข Complete / Cleared (Solid Green): All utilities marked and cleared. Clear to drill. - Vacuum Pothole Test Pits: Record test pits with Custom Overlay (
O) โ Pothole marker, stamping measured utility depth (e.g.2" Gas @ 48" depth).
9. High-Resolution Drone Aerial Surveys & Property Defense
Pre-existing driveway cracks, damaged sidewalk flags, and dry lawn turf trigger costly homeowner damage claims. FiberBore's drone inspection feature provides pre-construction proof:
- Tap any blue helicopter pin (
๐) to open the Drone Lightbox. - Pan and pinch-zoom high-resolution orthomosaics to inspect curbs, driveways, and landscaping prior to rig entry.
- Review date/time-stamped inspector pre-construction notes to defend against illegitimate claims.
10. Daily Tailgate Production & Management Reporting
Under Reports > Daily Crew Production & Footage Summary...:
- Filters: All-Time To-Date, Today, or Specific Date Selector.
- 4 Executive KPIs: Total Bored Footage (Actual vs Planned & %), Footage Remaining, Total Box Counts Installed, Active Drill Crews.
- Drill Crew Table: Footage drilled per rig, visual progress bar, and operator badges.
- Morning Tailgate Print Sheet (
Ctrl + P): Formats an 8.5" ร 11" high-contrast black-and-white engineering sheet complete with legal signature blocks for Drill Crew Foreman and Project Inspector. - CSV Export: Downloads comma-separated production records for direct import into Excel, Procore, and accounting systems.
11. Multi-Sheet PDF Stitching & CAD Alignment
Process multi-page engineering blueprint sets under File > Stitch PDF Plan Sheets...:
- Upload adjacent PDF pages along surveyed matchlines.
- Use interactive controls for Translation (X, Y), Rotation (ฮธ), Scale Matching, and Alpha Opacity Blending.
- Generates a seamless continuous background canvas across the entire job.
12. Project Management & Company Profiles
- Project Library: Switch between jobs, duplicate projects with "Save As Copy", or export standalone
.fiberborebundles. - Company Profiles Studio: Configure Subcontractor and General Contractor license numbers, 24/7 emergency dispatch contacts, and company logo stamps.
- Custom Overlays Studio: Add specialized utility layers (Gas HP/LP, 3-Phase Electric, Water Mains, Vacuum Potholes) with custom APWA colors and line styles.
13. Offline-First Architecture & Sync Protocol
- Zero Cloud Lockout: Markups and maps are stored in local browser
IndexedDBandlocalStorage. - Local Mode (โช): If cellular signal drops in deep trenches or rural easements, operators continue drawing bores and stamping boxes without interruption.
- Auto-Reconnection: Exponential backoff reconnection syncs all local deltas to the edge SQLite database the moment signal is recovered, without data clobbering.
14. Database Administration, Backups & Disaster Recovery
- Database Engine: SQLite 3 with WAL mode at
/var/www/data/fiberbore.db. - Automated Nightly Hot-Snapshots: Runs every midnight via
/etc/cron.d/fiberbore-backupusing non-blockingsqlite3 .backupAPI with 14-day rolling retention. - 1-Click Database Download: Supervisors can download
fiberbore_backup_YYYY-MM-DD.dbanytime via File > Download Pi Database (.db).... - Restoring from Backup: Stop service (
sudo systemctl stop fiberbore-sync), copy backup snapshot overfiberbore.db, and restart service.
15. Field Troubleshooting Matrix (Top Diagnostic Scenarios)
โช Local Mode despite cellular signal.Fix: Refresh browser with
Cmd + Shift + R. On Pi, check status: sudo systemctl status fiberbore-sync.
Fix: Scale was calibrated with wrong units. Select Tools > Calibrate Scale (
C), click 100 ft dimension, and re-apply.
Fix: Switch filter to All-Time To-Date to inspect whether bore lines were recorded under yesterday's date.
Fix: Ensure truck Wi-Fi hotspot is on first, then power-cycle Pi. Normal boot time is ~45 seconds.
16. Appendices & Hotkey Map
Space : Pan CanvasV : Select / InspectB : Planned BoreA : Actual BoreH : Box / HandholeL : Blue Stakes (811)O : Custom OverlayN : Sticky NoteC : Calibrate ScaleEnter : Finish DrawingEsc : Cancel DrawingCtrl+P : Print Tailgate Sheet