Process Architecture & System Integration — March 2026
01Project Lifecycle
End-to-end flow of a certification project from initial request through final delivery and invoicing. Each stage represents a discrete pipeline status in Supabase with clear entry/exit criteria.
Client Portal
Intake via Entirely portal Action Center. AI auto-enriches submissions with geocoding, jurisdiction lookup, certifier routing, forms detection, and timeline estimation. Project record created in Supabase.
Gate Logic
Filled nodes are gates requiring human decision. SOW Confirmed locks scope. Ready for Cert requires all photos, logs, and RFIs resolved.
Scheduling
Scheduling managed in Entirely Day View. Scheduler assigns date, time, and field tech. Daily schedule delivered to field team via WhatsApp at 6:00 AM ET.
Invoicing
Invoiced is now a distinct status. Stripe invoices generated from SOW line pricing via VPS API. Payment tracked via webhook.
02Certification Pipeline
Swim-lane view of the certification process showing handoffs between actors. The pipeline runs entirely on the VPS — no external services except Gmail for delivery and Supabase for state.
VPS Pipeline
Entire pipeline runs on a dedicated private server. No cloud functions, no external integrations for processing. WeasyPrint + Jinja2 generates PDFs server-side. Confidence routing determines send path.
Routing
Account determines recipients. Each branch account has distinct routing rules mapping to specific recipient lists.
Certifier Selection
MD Anne Arundel + Montgomery → Diehl (Architect). All other MD + VA + CT → Valerio (PE). Anne Arundel CCs county office.
File Storage
Per-project directories
organized by category:
Certs · Photos · Drive Logs
Permits · Other
03System Architecture
Integration map showing all services, their connections, and data flow direction. The VPS is the operational center — Supabase is the sole source of truth, Stripe handles billing, Gmail handles delivery, and the Entirely portal manages all workflow.
VPS Consolidation
All operational services on a single Hostinger KVM4 (16GB RAM). 4 Docker containers, Caddy reverse proxy with auto-TLS.
Data Sovereignty
Supabase (sole SoT) + local file storage (56 GB) + Hostinger daily snapshots. Redis for job queue. All data writes go through supabase_write_service.
57 API Routes
Cert gen (22), calendar (11), file ops (5), cert delivery (2), plus Supabase sync, PMS archive, email, and system health.
04Document Generation
How a Scope of Work drives modular document assembly. SOW lines activate division modules, which compose into a multi-document certification package. Conditional logic determines which companion documents are generated.
Modular Assembly
Each division is a self-contained template block. The SOW activates divisions; inactive ones are omitted entirely. No empty sections.
Add-On Convergence
ADD-SLAB can be triggered by both UND-SLAB and WTR-BSMT simultaneously. Quantities combine but sources are tracked separately in the report.
Architecture decision (Feb 2026): generate HTML, serve via Caddy, convert to PDF only for email delivery. Browser viewing is the primary consumption path.
05Division & Product Matrix
Complete inventory of inspection products organized by division. Each division carries an identity color used throughout the document system — in module tags, photo badges, and companion document indicators.
06Stakeholder & Integration Map
Who touches what, when, and through which systems. Shows the collaboration network between internal operations, field technicians, professional certifiers, contractor clients, and jurisdictions.
Lean Team
Two-person operational team: Dustin (operations, cert review, delivery) and Darius (field inspection, data collection). Certifiers are contract professionals. Claude Code automates builds and ops.
Account Routing
Each of the 5 branch accounts has distinct email recipients. Routing is deterministic via account record IDs — no fragile text matching.
Certifier Routing
State + jurisdiction determines certifier. MD Anne Arundel and Montgomery → Diehl (Architect). All other → Valerio (PE). Three state licenses.
Client Relationship
Unlikely performs third-party inspections for foundation repair contractors. The contractor is the client; the homeowner is the property owner on the cert. Unlikely never deals with homeowners directly.