deploy ProspectOS workspace v2 final

README.md

@@ -26,6 +26,16 @@ reviewable homepage text snapshot that is included in AI assessments and email
 drafts. The **Promotions** view stores dated, active/inactive offers; an active
 promotion can be selected in the email draft dialog and is passed to the AI
 with its exact description and terms.
+From a prospect's detail drawer, **Generate modern mockup** creates a
+shareable, mobile-first website concept using the prospect's public details
+and (when available) a fresh snapshot of its current homepage. The preview is
+a standalone HTML document ready to place in a PHP/HTML hosting folder; it
+does not require PHP, JavaScript, forms, tracking, external fonts, or remote
+assets to render. If AI is configured it can produce a tailored design; when
+AI is unavailable the deterministic fallback still produces a polished
+preview. Each tokenised link is read-only, marked as a concept, sent with
+`noindex`, and can be included once in a human-reviewed email draft. It is not
+a production site and should be checked and edited before sending.
 The **Logs** view separates API calls, user actions, AI requests, searches,
 Browser Use/tool steps, and errors. AI request payloads and responses are
 truncated and credentials such as API keys, authorization headers, tokens, and
@@ -79,6 +89,7 @@ error rather than remaining stuck forever.
 | Variable | Default | Purpose |
 |---|---:|---|
 | `HOST_PORT` | `8000` | Host port for ProspectOS |
+| `PUBLIC_BASE_URL` | empty | Public origin used for client-facing mockup share links; set it behind a reverse proxy if forwarded host headers are unavailable |
 | `GMAPS_HOST_PORT` | `8081` | Host port for the Maps worker admin UI |
 | `GMAPS_API_MODE` | `standard` | `standard` for the bundled worker; `saas` only for the optional SaaS API |
 | `GMAPS_API_KEY` | empty | Not required in standard mode; only used in SaaS mode |
@@ -212,6 +223,11 @@ stores a bounded, reviewable public homepage snapshot. Promotions are managed
 with `GET/POST /api/promotions`, `PATCH /api/promotions/{id}`, and
 `DELETE /api/promotions/{id}`. An active promotion selected in the draft dialog
 is sent as `promotion_id` and retained on that prospect's draft.
+Mockups are created with `POST /api/prospects/{id}/mockup`, listed with
+`GET /api/prospects/{id}/mockups`, and opened by their public
+`/mockups/{token}` share URL. Set `PUBLIC_BASE_URL` when the reverse proxy does
+not forward the public host; otherwise the link is built from the request's
+forwarded host or `Host` header.
 
 ## Tests