Docs: sync booking-requests + Bookings IA + image_url after Back#59/Front#30. Fixes EventHub/EventHubSpec#12

2026-07-27 15:21:12 +03:00
parent cc469d5698
commit 7c21fa2aef
8 changed files with 157 additions and 9 deletions
@@ -0,0 +1,33 @@
+---
+description: EventHub — локальные сборки/тесты только через WSL (Windows toolchain сломан)
+alwaysApply: true
+---
+
+# EventHub: рабочее окружение агента
+
+На этой машине **не использовать** нативный Windows для:
+
+| Стек | Нельзя (Windows) | Нужно |
+|------|------------------|--------|
+| Front / FrontAdmin | `npm`, `npx`, Playwright | **WSL** `npm` |
+| Back (Erlang) | Windows `erl` / `rebar3` | **WSL** + `scripts/wsl-dev-env.sh` |
+
+## Front (EventHubFront)
+
+```bash
+wsl -e bash -lc 'cd /mnt/c/Users/alexc/IdeaProjects/eventHub/EventHubFront && npm run lint && npm run build && npm run test:e2e'
+```
+
+## FrontAdmin
+
+```bash
+wsl -e bash -lc 'cd /mnt/c/Users/alexc/IdeaProjects/eventHub/EventHubFrontAdmin && npm run lint && npm run build'
+```
+
+## Back
+
+```bash
+wsl -e bash -lc 'cd /mnt/c/Users/alexc/IdeaProjects/eventHub/EventHubBack && source scripts/wsl-dev-env.sh && rebar3 eunit'
+```
+
+Подробности: `EventHubFront/.cursor/rules/npm-wsl.mdc`, `EventHubBack/.cursor/rules/otp-rebar-wsl.mdc`.
@@ -0,0 +1,29 @@
+---
+description: Один агент — один репозиторий; не смешивать Front и Back
+alwaysApply: true
+---
+
+# EventHub: отдельные агенты по репозиториям
+
+## Правило
+При работе с **несколькими репозиториями** EventHub запускай **отдельного агента на каждый репо**. Не смешивай Front и Back (и Spec/FrontAdmin) в одном агенте.
+
+| Репо | Зона |
+|------|------|
+| `EventHubFront` | клиентский SPA |
+| `EventHubBack` | Erlang API |
+| `EventHubSpec` | спеки, UI-PARITY, контракты |
+| `EventHubFrontAdmin` | admin SPA |
+
+## Запрещено
+- Один агент правит и Front, и Back в одной сессии
+- Коммиты/`Refs`/`Fixes` не в тот репо (Front-код → issue Back, и наоборот)
+- Закрывать/комментировать issue чужого репо «заодно»
+
+## Как делать
+1. Спека/issue → агент **Spec** (или короткий foreground), если только доки.
+2. API → отдельный агент **Back** (`Back#N`, eunit, push Back).
+3. UI → отдельный агент **Front** (`Front#N`, lint/IFT, push Front).
+4. Родитель-координатор только маршрутизирует; не пишет код сразу в два репо.
+
+Кросс-репо фича (например Bookings inbox): **сначала Back**, потом **Front** (или параллельно двумя агентами), Spec — третьим или после стабилизации API.
@@ -0,0 +1,13 @@
+---
+description: Shell — только WSL/bash; PowerShell-экранирование запрещено для сложного
+alwaysApply: true
+---
+
+# Shell: WSL, не PowerShell
+
+Агенты **не должны** гонять сложные one-liner’ы в PowerShell (ломается экранирование).
+
+Канон: файл `.sh` + `wsl -e bash /mnt/c/.../script.sh`, либо  
+`wsl -e bash -lc 'простая команда без вложенных двойных кавычек'`.
+
+Полный текст: `EventHubBack/.cursor/rules/shell-wsl-not-powershell.mdc`.