Operations Charts
Process architecture, system integration, and product catalog. These charts reflect the Mostly (v1) 8-stage pipeline. Entirely v2 uses a simplified 5-stage pipeline.
01 Project Lifecycle
Simplified 8-status linear lifecycle from intake through close-out. on_hold and cancelled are flags (can be applied at any stage), not separate statuses. Triage is a side-path flag for 45-day aging projects.
See status-triggers for the full transition map with value IDs and triggers.
Key Gates
- Portal Intake — schedulers submit via client portal, system parses permits, extracts SOW. Submissions enter admin approval queue before Supabase record creation.
- PSoW / ABSoW Gate — field tech confirms Permitted Scope of Work on arrival. If scope matches, it becomes ABSoW. If not, changes recorded and revised list becomes As-Built Scope of Work.
- 30-Day RFI Warning — system auto-generates RFI at 30 days on hold requesting status update.
- 45-Day Triage — projects exceeding 45 days transfer to JES Triage account. See triage-guide.
Record Counts
- 7,006 projects total
- 404 Ready for Cert
- 214 Certified
- 42 Closed
- 88 Field Complete
- ~6,000 Archived (PMS)
- 2,286 Xero invoices ($2.7M)
02 Certification Pipeline
Swim-lane view showing handoffs between actors. The pipeline runs entirely on the VPS — no cloud functions, no Zapier.
Pipeline Components
- VPS Pipeline — HTML rendered via Jinja2, PDF converted by WeasyPrint, stored locally
- 10-Point auto-validation — SOW completeness, photo requirements, drive log presence, RFI resolution, address verification, permit status, production days
- Certifier Routing — MD Anne Arundel/Montgomery → Diehl AIA; MD other → Valerio PE; VA → Valerio PE; CT → Valerio PE
- pipeline-shepherd — daily 7:45 AM scan of all active projects
- confidence-routing — Jacob sends direct (high confidence) or queues for OwnerReviewQueue (guardrails)
03 System Architecture
Internet -> Caddy (80/443) -> reverse proxy + auto-TLS
|
+-- unlikely.pro -> marketing site
+-- entirely.it.com -> Entirely v2 portal
+-- unlikely.works -> Mostly v1 portal
+-- kulu.la -> Kulu (OpenClaw)
|
v
unlikely-api (port 8000) -- FastAPI
|
+-- unlikely-worker (ARQ background jobs)
+-- unlikely-scheduler (cron tasks, ET timezone)
+-- unlikely-redis (Redis 7, port 6379)
Key Services
- cert-generator-v3 — WeasyPrint + Jinja2 PDF generation
- friday-ai — Anthropic Claude integration (Opus for owner/admin)
- Rob — WhatsApp bot via OpenClaw
- Kulu — Operations AI agent via OpenClaw
- pipeline-shepherd — automated project scanner
- auto-validation — 10-point field complete checker
- confidence-routing — cert/invoice routing engine
04 Document Generation
The cert-generator-v3 system produces certification packages:
- Templates at
/opt/unlikely-api/templates/ - Base layout —
base.html - Components —
macros/components.html(Jinja2 macros) - Per-division modules — UND, ANC, BRC, SUP, FND, WTR, ENC, RTW + addons
- Jurisdiction forms — auto-appended based on project location
- Guide pages — educational content per division
05 Division & Product Matrix
9 product divisions with 50+ items:
| Code | Division | Examples |
|---|---|---|
| UND | Underpinning | Push piers, helical piles, slab piers |
| ANC | Anchors | Wall anchors, plate anchors |
| BRC | Bracing | I-beam, carbon fiber |
| SUP | Support | Adjustable posts, smart jacks |
| FND | Foundation | Concrete, rebar |
| WTR | Water Management | Sump pumps, drains, discharge |
| ENC | Encapsulation | Crawlspace liners, dehumidifiers |
| RTW | Retaining Walls | Tiebacks, drainage |
| ADM | Administrative | Trip charges, engineering fees |
See field-tech-guide for photo and measurement requirements per product.
06 Stakeholder & Integration Map
External Integrations
| Service | Purpose |
|---|---|
| Supabase | Sole source of truth (cloud PostgreSQL) |
| SmartSuite | Safety-net sync (soak period through April 6, 2026) |
| Google Gmail | Email delivery (operations@unlikely.pro) |
| Google Calendar | Bi-directional schedule sync |
| Google Maps | Address autocomplete, route planning |
| Stripe | Invoice payment tracking |
| Revolut | Banking reconciliation |
| Anthropic | friday-ai and AI features |