# SEO Farm

Локальный SEO-редакторский контур для работы с существующими сайтами: scan проекта, baseline audit, Wordstat, keyword map, rewrite workspace, media SEO, final validation и ручной Apply через changeset.

## Статус

Архитектурная документация остаётся источником направления, но код приложения уже инициализирован.

Готов текущий MVP-срез:

- базовый React/Vite UI;
- Node.js backend;
- Postgres как source of truth;
- MinIO/S3-compatible storage для артефактов;
- создание, переименование, копирование и удаление проектов;
- импорт папки сайта через browser folder picker / drag-and-drop;
- scan project + `project-index.json`;
- stable pages/media records и repeated scan;
- baseline audit;
- выбор страниц для дальнейшей работы деревом по путям;
- severity-фильтры и отдельный media issue list;
- отображение ошибок только по выбранным страницам;
- Page Workspace MVP: preview страницы, ошибки выбранной страницы, логические секции, section editor, save/reset без изменения исходного проекта.

Текущий рабочий этап: довести `Page Workspace / Draft Model` до кликабельного редакторского сценария.

## Основные документы

- `SEO_FARM_BRIEF.md` — общее ТЗ, цели продукта и MVP scope.
- `SEO_FARM_ARCHITECTURE.md` — архитектура, storage, backend/frontend слои.
- `USER_FLOW.md` — пользовательский сценарий.
- `IMPLEMENTATION_GUARDRAILS.md` — pipeline, границы инструментов и риски.
- `UI_UX_SPEC.md` — UI/UX экраны, состояния и safety-паттерны.
- `TASK_MANAGER.md` — поэтапный план реализации.
- `CHECK_OVERSEO_SPEC.md` — спецификация локальной проверки переспама.

## Зафиксированные архитектурные решения

- `Postgres` — основной источник истины.
- `MinIO/S3` — хранилище raw artifacts, snapshots, reports, backups и exports.
- `browser_folder` — текущий рабочий adapter для импорта папки в MinIO и будущего hosted-сценария.
- `local_folder` — dev/local adapter для ручного абсолютного пути.
- `scan_version + reconcile` — модель повторного скана без потери утверждённых решений.
- `Apply` проходит через changeset, dry-run, backup и rollback.
