LandscapeOS

What's included

LandscapeOS ships as four connected apps inside one project:

Landscape OS Shell

The branded launcher at the project root. Four role-card tiles link directly to Owner HQ, Office Ops, Crew, and Customer Portal. A recent-activity strip shows the last five completed visits and three approved estimates pulled live from the database. A floating Landscape OS button on every sub-app returns users to the shell.

Owner HQ

Executive dashboard for business principals.

• Revenue & service-line mix — MTD revenue vs prior month with trend delta; per-service-line revenue, visit count, and average estimate value in a breakdown table and stacked area chart.
• Estimate pipeline — Kanban-style status board across all seven stages from New Lead to Approved, with service-line badges and total pipeline value.
• Accounts receivable — Outstanding and overdue totals; per-invoice aging with days-overdue count.
• Crew capacity — Per-crew utilization bar showing jobs-today vs daily capacity.
• Risk signals — Overdue invoices, visits with flagged issues, declined estimates, and clients with no recent service.
• AI Weekly Briefing — One-tap AI action fetches live KPI data and returns a four-section executive summary: revenue health, operational status, pipeline health, and specific recommended actions for the week. Credit guidance directs to the Glide dashboard when credits are unavailable.

Office Ops

Back-office workspace for operations managers and estimators.

• Dashboard — Today's dispatch, estimates needing action, overdue invoices strip, and recently completed visits.
• Estimates — Searchable pipeline with service-line filter, seven-stage status strip, and estimate detail with line items, scope copy, and timeline. Two AI actions on estimate detail: Build estimate draft (returns service-line-specific line items, scope copy, and assumptions from walkthrough notes) and Draft customer follow-up (returns a professional subject + body email). Both handle out-of-credits with clear guidance.
• Crew Dispatch — Crew-view and zone-view toggle. Utilization bars per crew member. Access-note warnings. Service-line filter.
• Visits — Status/type/service-line filter, before/after photo indicators, follow-up flags.
• Properties — Responsive card grid with primary-service badges; detail view with History, Photos, Plans, and Invoices tabs.
• Billing — Desktop table + mobile cards below md. Mark Paid and Follow Up actions on overdue invoices.
• Clients — Contact info, property count, last visit date.

Crew

Mobile-first field experience, optimized for 375 px.

• My Route — Crew-member selector (for demo/multi-crew), daily progress ring, in-progress banner, next-stop highlight, expandable stop cards with access notes and site instructions.
• Visit Detail — Service-line-specific checklist adapts its items for each of the five service lines. Crew notes, materials, issues, before/after photo URL capture, follow-up flag, and Start / Pause / Complete status flow.
• AI Write visit summary — Converts crew notes, visit type, and service line into a customer-facing completion summary with follow-up items. Shows clear credit guidance when unavailable.
• AI Classify field issue — Rates severity (low / medium / high / urgent), assigns a category, recommends action, and flags whether to escalate to the office.
• History — Last 10 completed visits for the selected crew member with before/after thumbnails.
• Issues — All open follow-up items for the crew member.

Customer Portal

Client-facing app exposing only appropriate data.

• Home — Client selector (demo: clients 1–5), property cards with hero images, next-visit strip, open estimates and invoices at a glance.
• Property Detail — Upcoming visits (public fields only; no access notes or internal flags), completed visit summaries and after-photos, active service plans, gallery.
• Estimates — Pending estimates with scope copy; one-tap Approve or Request Changes. Explain this estimate AI action returns a plain-English homeowner-friendly explanation.
• Invoices — Public invoice fields: number, date, due date, total, amount paid, status. No internal notes or deposit details.
• Service History — Completion summaries and after-photos across all properties. Internal crew notes, issues, and materials are never shown.
• Service Request — Property selector, service-line selector, description, preferred timing. Submits a new estimate row with status new. Draft service request AI action helps clients articulate their request before submitting.
• Messages — Secure contact thread (demo UI; wires to CRM in production).

Five service lines

Every visit, estimate, invoice, and service plan carries a service_line field. The UI surfaces service-line badges throughout:

| Service line | Label | Crew checklist | Scope context | |---|---|---|---| | landscape_management | Landscape Management | Mow, edge, prune, weed, color | Standard maintenance and enhancement | | water_management | Water Management | Zone test, head inspect, pressure, flush | Irrigation systems and drainage | | pest_management | Pest Management | ID pests, PPE, bait stations, posting | IPM / organic / conventional programs | | arbor_care | Arbor Care | Tree ID, risk, clearance, ISA notes | Pruning, removal, deep-root feeding | | construction | Construction | Phase milestone, grading, hardscape | Full install: demo through closeout |

Shared data model

All apps read and write the same eight tables:

• ls_clients — contact preferences, avatar
• ls_properties — service zones, access/irrigation notes, hero images, primary service lines
• ls_crew_members — role, zones, capacity, avatar
• ls_estimates + ls_estimate_line_items — pipeline from new lead through approval
• ls_service_plans — recurring contracts per property
• ls_visits — scheduled and completed jobs with before/after photos
• ls_invoices — billing with aging, deposits, and payment tracking
• ls_property_photos — gallery per property and visit

AI actions

| App | Action | What it uses | What it returns | |---|---|---|---| | Owner HQ | Generate weekly operations briefing | Live KPIs, revenue by service line, pipeline value | 4-section executive summary + recommended actions | | Office Ops | Build estimate draft | Walkthrough notes, service line, measurements | Service-line-specific line items, scope copy, assumptions | | Office Ops | Draft customer follow-up | Estimate title, client name, days since sent, scope copy | Professional email subject + body | | Crew | Write visit summary | Crew notes, visit type, service line, property/client | Customer-facing summary + follow-up items | | Crew | Classify field issue | Issues noted, service line, visit type, property | Severity, category, recommended action, escalate flag | | Customer Portal | Explain this estimate | Scope copy, service type, total, service line | Plain-English homeowner explanation | | Customer Portal | Draft service request | Property, service line, rough description, timing | Polished service request text |

All AI actions handle out-of-credits by returning a 402 with the message: "[App] is out of AI credits. Buy extra credits or upgrade your plan in the Glide dashboard."