Client DesignCorp MVP

Цель: запустить внутреннюю платформу client.designcorp.eu для поиска и приоритизации B2B-лидов без внешних оркестраторов.

Product Scope

• Сбор компаний по niche + city + query через официальный Google Places API.
• Технический аудит сайтов через Playwright (HTTPS, mobile, form, CTA, social links).
• Скоринг лидов по версии правил (v1, v2, ...), с историей пересчётов.
• Ручной review и очередь «кому писать сегодня».
• Экспорт списка лидов в CSV.

Pipeline

1. collect — поиск и upsert компаний.
2. enrich — аудит сайта и заполнение signals.
3. score — расчёт приоритета и постановка в queue.
4. review — ручное подтверждение и смена статусов.

Data Model

Базовые таблицы:

• lead_sources
• leads
• lead_scans
• lead_scores
• outreach_queue
• lead_contacts

Ключевые правила:

• Дедупликация по (sourceType, externalPlaceId).
• История сканов и скоринга не перезаписывается.
• Все review-действия должны быть трассируемы.

API (internal)

• POST /api/leads/collect
• POST /api/leads/enrich
• POST /api/leads/score
• GET /api/leads
• POST /api/outreach/{id}/approve
• POST /api/outreach/{id}/skip
• POST /api/outreach/{id}/contacted

Guardrails

• Не использовать n8n в архитектуре MVP.
• Не использовать серый scraping Google Maps.
• Не включать auto-messaging без human review.
• Использовать Field Mask для контроля стоимости Places API.

Implementation Repo

• Репозиторий для разработки: /home/admin/workspace/client-designcorp
• Точка входа документации проекта: /home/admin/workspace/client-designcorp/docs/index.md