deploy DOM search v8 update

README.md

@@ -5,18 +5,27 @@ the bundled [gosom/google-maps-scraper](https://github.com/gosom/google-maps-scr
 worker, waits for its asynchronous job to finish, filters places already in
 the local catalogue, and presents the remaining places for human review.
 
-The interface is split into Dashboard, Discover, Prospects, Runs, Logs, and Settings
+The interface is split into Dashboard, Discover, Prospects, Runs, Logs, Teach AI,
+Promotions, and Settings
 views. It includes website health and email evidence, explainable scoring,
 domain ideas, suppression, CSV export, scheduled runs, rescans, and human review. It never sends outreach
 automatically. The Prospects explorer has an **All high potential** tab and
 category tabs populated from each discovery run, with every tab sorted from
-highest to lowest opportunity score.
+highest to lowest opportunity score. It also provides search, potential-score,
+website-health, public-email, and review-status filters; review status itself
+is changed inside the prospect drawer so list rows stay focused on evidence.
 
 Optional AI can analyse a prospect and draft a subject/email from supplied
 evidence and your offer; you edit and approve the draft yourself. Drafts now
 also return the reasoning, stored evidence IDs used, facts that still need
 confirmation, and a follow-up review note so a polished email is not mistaken
 for verified information.
+The **Teach AI** view stores the sender company's website, services, packages,
+prices, and writing guidance. Its bounded public-page reader captures a
+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.
 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
@@ -197,6 +206,13 @@ variables above and accepts your exact offer/instructions (for example, the
 Gold Plus R119/month plan and a free rebuild). Suppressions are enforced before
 new records are saved and can be managed through `/api/suppressions`.
 
+The Teach AI page saves a `company_profile` object through `POST /api/settings`.
+Its **Read website now** action calls `POST /api/company-profile/learn` and
+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.
+
 ## Tests
 
 ```bash