Механика системы

1. Назначение и границы

Входит: верификация производителей (B2B ~$200k и ОПТ), каталоги по нишам × регионам, скоринг, master-dedup, pro/public, веб-каталог.

Не входит: 04_рынки_и_спрос/ (аналитика), longlist в 05_ресerch_USA_P1/ до отбора, юр. гарантии по сертификатам (перед PO — factory audit).

Корень базы: база_заводов_китай/

2. Архитектура данных

Ресерч → CSV → quality → master/export → JSON → UI. Из веба в CSV данные не пишутся.

3. Два контура

	B2B $200k+	ОПТ
Каталог	`КАТАЛОГ/200k_заводы/`	`Каталог ОПТ/`
Score	≥7 + tier A/B в вебе	≥6
JSON	`catalog.json`	`catalog_opt.json`
Фильтр	`is_quality_factory()`	`is_quality_opt()`
Лимит	10–12 / нишу, ≥3 tier A	max 70 / поднишу

B2B-веб (`build_200k_web.py`)

tier ∈ A, B · оценка_завод_10 ≥ 7
Нет trader-флагов · в сайт нет MIC/Alibaba/1688/Goldsupplier

4. Модель строки

ЗАВОДЫ.csv в папке ниши — source of truth после deep research.

Ключевые группы полей: идентификация (master_id), контакт, верификация (tier, уровень_проверки), сделка (MOQ, чек), рынки, описание.

_master/ЗАВОДЫ_мастер.csv — один завод = одна строка (~198 unique). Wave1+ добавляет новые домены в одну нишу, список: scripts/_existing_b2b_domains.txt.

5. Quality gates

B2B — `b2b_200k_quality.py`

full — enrich, reject → отклонённые.csv
audit — отчёт без перезаписи
market-upgrade — tiers, master

ОПТ — `opt_quality.py`

score_row() 0–10; ниже 6 — отсев. MAX_PER_CATEGORY = 70.

6. Справочник скриптов

Запуск из корня заводы/:

Скрипт	Когда
`b2b_research_wave1.py`	Новая B2B-волна
`append_b2b_wave1.py`	Merge в ЗАВОДЫ.csv
`b2b_200k_quality.py`	После правок CSV
`export_tier.py`	После market-upgrade
`build_200k_web.py`	Всегда после CSV
`build_katalog_200k_by_niche.py --skip-csv`	Только структура папок
`append_verified_rows.py`	После OPT waves
`build_opt_katalog.py`	Региональные ОПТ CSV

7. Runbook волны

Волна начинается с ресerch в интернете (Google, Baidu, сайты, 爱企查) — человек или агент с сетью. Только после записи в WAVE*_ROWS / verified/*.csv запускайте append и скрипты ниже — они сеть не используют.

B2B

python3 scripts/b2b_research_wave1.py
python3 scripts/append_b2b_wave1.py
python3 scripts/b2b_200k_quality.py market-upgrade
python3 scripts/export_tier.py
python3 scripts/build_200k_web.py
python3 scripts/regen_existing_b2b_domains.py

ОПТ

python3 scripts/append_verified_rows.py
python3 scripts/opt_market_flags.py
python3 scripts/build_opt_katalog.py
python3 scripts/build_200k_web.py

8. Антипаттерны

Нельзя	Почему
`build_katalog_200k_by_niche.py` без `--skip-csv`	Затрёт обогащения в ЗАВОДЫ.csv
Один домен в 4 регионах как «новый»	Раздувает rows без роста master
MIC URL в поле `сайт`	Отсев в вебе
CSV без `build_200k_web.py`	Витрина устареет

9. Слои экспорта

_pro/ — полные контакты для сделок
_public/ — teaser
_verified/ — wave logs

L1/L2/L3 и tier A/B/C — см. СТАНДАРТ_верификации.md в каталоге 200k.

10b. L4 — «Связались с заводом»

Overlay _team/manager_contacts.csv — метка менеджера после личного контакта. Не меняет tier и quality gates.

python3 scripts/mark_manager_contact.py --master dmtg --contour b2b --manager "Имя" --channel call --rebuild
python3 scripts/build_200k_web.py

# UI: index.html?team=1 + team_contact_server.py :8766

См. _team/README.md и СТАНДАРТ_верификации.md § L4.

10. Метрики и аудит

B2B в вебе: catalog.json → meta.factoryCount (~180)
ОПТ: catalog_opt.json (~352)
Master: _master/ЗАВОДЫ_мастер.csv (~198)
Пробелы: _audit/ОТЧЁТ_качества.md

Цель wave2 B2B: 190–210 в вебе за счёт новых master_id.

11. Глоссарий

tier A/B/C	Приоритет RFQ; в веб B2B только A и B
master_id	Slug завода; ключ dedup
verified wave	Пакет ресерча + КАК_ИСКАЛИ + append
quality gate	Порог в Python до JSON
L4 team contact	Менеджер связался; overlay + бейдж «Связались»