HMLS Autos

Mobile mechanic service platform — AI-powered estimates, Stripe payments, provider scheduling.

Architecture

App	Stack	Deploy
apps/hmls-web	Next.js	Vercel
apps/api	Deno + Hono	Deno Deploy
apps/fixo-web	Next.js	Vercel
apps/agent (fixo)	Deno + Hono	Deno Deploy

Shared: Supabase (Postgres), Drizzle ORM, Stripe, Resend, AG-UI protocol

Order Flow

stateDiagram-v2
    [*] --> estimated : Customer chats → agent creates estimate

    estimated --> customer_approved : Customer approves via portal
    estimated --> customer_declined : Customer declines

    customer_approved --> quoted : Admin creates Stripe quote

    quoted --> accepted : Customer pays via Stripe
    quoted --> declined : Customer declines quote

    accepted --> scheduled : Booking created

    scheduled --> in_progress : Service begins

    in_progress --> completed : Service finished

    estimated --> cancelled : Cancelled
    customer_approved --> cancelled : Cancelled
    quoted --> cancelled : Cancelled
    accepted --> cancelled : Cancelled
    scheduled --> cancelled : Cancelled

    customer_declined --> [*]
    declined --> [*]
    cancelled --> [*]
    completed --> [*]

Loading

Entity Relationships

erDiagram
    CUSTOMERS ||--o{ ESTIMATES : has
    ESTIMATES ||--o| ORDERS : creates
    ORDERS ||--o| QUOTES : "gets priced"
    ORDERS ||--o| BOOKINGS : "gets scheduled"
    PROVIDERS ||--o{ BOOKINGS : assigned
    PROVIDERS ||--o{ PROVIDER_AVAILABILITY : has
    PROVIDERS ||--o{ PROVIDER_SCHEDULE_OVERRIDES : has

    CUSTOMERS {
        int id PK
        string name
        string email
        string phone
    }
    ESTIMATES {
        int id PK
        int customerId FK
        jsonb services
        int totalCents
        string status
    }
    ORDERS {
        int id PK
        int customerId FK
        int estimateId FK
        int quoteId FK
        int bookingId FK
        string status
        jsonb statusHistory
    }
    QUOTES {
        int id PK
        string stripeQuoteId
        int totalCents
        string status
    }
    BOOKINGS {
        int id PK
        int estimateId FK
        int providerId FK
        timestamp scheduledStart
        timestamp scheduledEnd
        string status
    }
    PROVIDERS {
        int id PK
        string name
        string email
        jsonb serviceArea
    }

Loading

Development

# Web app
cd apps/hmls-web && pnpm dev

# API agent
cd apps/api && deno task dev

# Fixo web
cd apps/fixo-web && bun dev

# Fixo agent
cd apps/agent && deno task dev