docs: ЭТАЛОН проекта — единый снимок текущего состояния и ключевых фактов

2026-05-18 12:59:35 +03:00
parent 515acb654c
commit 1e4278ffb2
2 changed files with 87 additions and 0 deletions
@@ -1428,3 +1428,11 @@ evals
 парсится
 ревьюить
 инвокацией
+
+# ЭТАЛОН проекта (2026-05-18) — Russian IT vocabulary
+волатильный
+волатильную
+волатильно
+волатильны
+незакоммиченное
+бандл
@@ -0,0 +1,79 @@
+# ЭТАЛОН проекта Лидерра
+
+Единый снимок **истинного состояния проекта** — чтобы не путаться между сессиями.
+
+**Правило использования:**
+
+- В начале работы — свериться с этим файлом.
+- Волатильную часть (§1–§4: git, что запущено, временное) перед рискованными действиями
+  **перепроверять реальной командой**, не доверять снимку вслепую.
+- Обновляется по команде заказчика **«обнови эталон»**.
+
+**Снимок снят:** 18.05.2026 (сессия webhook-теста + дизайна запасного канала).
+
+---
+
+## 1. Git — состояние (волатильно)
+
+- Git-корень репозитория — папка `Документация/` (**не** `app/`).
+- Remote: `CoralMinister/lidpotok` (приватный).
+- Текущая локальная ветка: **`feat/parallel-sessions-coordination`**.
+- Локальный HEAD: `781a59c`.
+- `origin/main` HEAD: `515acb6`.
+- Локальная ветка: **0 впереди / 9 позади** `origin/main`.
+- Push-паттерн проекта: `git push origin <ветка>:main`.
+- Незакоммиченное сейчас: правки `app/bootstrap/app.php` (trustProxies — временно),
+  `app/playwright/refresh-session.js`, `.gitignore`, `app/dev-indices.json`;
+  untracked webhook/демо-артефакты (см. §4).
+
+> ⚠️ Снимок git в начале сессии бывает **устаревшим**. Истина — `git branch --show-current` + `git log -1`.
+
+## 2. Dev-окружение (native Windows, без Docker)
+
+| Компонент | Состояние |
+|---|---|
+| PostgreSQL 16 | служба `postgresql-x64-16` Running; БД `liderra`; dev-юзер `postgres` (superuser → RLS обходится) |
+| Redis | Memurai (служба `Memurai`) Running, порт 6379 |
+| PHP | 8.3, `C:\tools\php83\php.exe` |
+| Портал | `php artisan serve` на `127.0.0.1:8000` |
+| Очередь | `php artisan queue:work` (один воркер) |
+| Фронтенд | режим **PROD-сборка** (`app/public/hot` отсутствует → отдаётся `app/public/build/`) |
+
+> ⚠️ После любых правок фронтенда (`app/resources/js/`) — **`npm --prefix app run build`**,
+> иначе портал отдаёт старый бандл (баг 18.05.2026). PID процессов меняются —
+> проверять `Get-CimInstance Win32_Process -Filter "Name='php.exe'"`.
+
+## 3. Что запущено временно (webhook-тест)
+
+- ngrok-туннель: `https://overtly-ascension-multiple.ngrok-free.dev` → `:8000` (`ngrok http 8000`).
+- Webhook поставщика crm.bp-gr.ru настроен на этот URL, статус «Активный».
+- Зомби-процесс `php artisan tinker _demo_reroute.php` — безвреден, можно завершить.
+
+## 4. Временное / демо — НЕ постоянное, под финальную очистку
+
+- Webhook-тест: `.env` `SUPPLIER_LOGIN`/`SUPPLIER_PASSWORD`, `app/bootstrap/app.php` trustProxies,
+  `system_settings.supplier_webhook_secret`, `tools/cloudflared.exe`, DNS-правки (`tools/.dns-backup.json`).
+- Демо-данные: tenant 3 (`_demo_tenantA`) + tenant 4 — 37 демо-проектов, 89 сделок, баланс 1000 лидов.
+- Демо-скрипты: `app/storage/_demo_reroute.php`, `_demo_day_setup.php`, `_demo_user.php`.
+- Процедура очистки: Task 9 плана `docs/superpowers/plans/2026-05-18-webhook-real-supplier-integration.md`.
+
+## 5. Ключевые факты (стабильно)
+
+- Структура: git-корень `Документация/` · Laravel-приложение `app/` · фронтенд `app/resources/js/`
+  · сборка фронтенда → `app/public/build/` · схема БД `db/schema.sql` (v8.23).
+- Стек: Laravel 13 + PHP 8.3 · Vue 3 + Vuetify 3 (не Tailwind/Inertia) · PostgreSQL 16 · Redis.
+- Демо-доступ к порталу: `demo@liderra.local` / `Demo12345!` (tenant 3).
+- Поставщик лидов: `crm.bp-gr.ru` (учётка в `.env` `SUPPLIER_*`).
+- Оперативная карта проекта: `CLAUDE.md` (правится только плагином `claude-md-management`).
+- Память Claude: индекс `MEMORY.md` — подгружается каждую сессию.
+
+## 6. Текущие рабочие нити (детали — в памяти Claude)
+
+- Webhook-канал доказан вживую; запасной CSV-канал (путь 2) — дизайн ждёт «ок»; находка B1+sms.
+  Память: `supplier-channels-live-test-2026-05-18`.
+- Редизайн страницы «Сделки» (вариант A, воронка 14→5) — сделан, в `origin/main`.
+  Память: `deals-page-redesign-2026-05-17`.
+
+---
+
+*Обновлять командой «обнови эталон». §1–§4 волатильны — перед действиями перепроверять реальными командами.*