diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..d6b53ce --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,46 @@ +# AGENTS.md — docs.a2v.space + +Hugo static site with custom theme. Russian-language personal documentation/knowledge base. + +## Commands + +- `hugo server` — dev server (live reload) +- `hugo` — build to `public/` +- No package manager, no build scripts, no tests, no linter. + +## Structure + +- `hugo.toml` — site config (TOML). Defines warm color palette params, menu, taxonomies (tags/categories/statuses), JSON output for search. +- `content/` — 7 sections: `diary/`, `kb/`, `plans/`, `guides/`, `creds/`, `leadera/`, `personal-site/`. Front matter is TOML (`+++`). +- `themes/a2v/` — custom theme (23 templates). All layout logic lives here. +- `static/` — CSS and JS at project root, **not** in the theme directory. + - `static/js/search.js` — Fuse.js client-side search against Hugo-generated `index.json` + - `static/js/creds.js` — Web Crypto API (AES-256-GCM + PBKDF2). Decryption on page; encryption via `window.encryptCreds(data, password)` in browser console. + - `static/css/custom.css` — all custom styles (434 lines, CSS variables from hugo.toml params) +- `BRIEF.md` — original spec with seed content and structure reference. + +## Key conventions + +- Archetype sets `draft = true` by default. Undraft with `hugo --buildDrafts` or remove `draft = true` from front matter. +- `relativeURLs = true` in config — all URLs are relative, no baseURL needed for local dev. +- Bootstrap 5.3.2 and Fuse.js 7.0.0 loaded from CDN (no local copies). +- Each section can have its own list/single templates under `themes/a2v/layouts/
/`. +- The sidebar partial (`themes/a2v/layouts/partials/sidebar.html`) is context-aware: shows tags, statuses, or services depending on the current section. +- The `source-path` partial renders the local filesystem path of each content file for easy editing. +- `shortcodes/encrypted-creds.html` is a passthrough wrapper for encrypted credential payloads. + +## Content front matter patterns + +- **diary**: `date`, `title`, `tags` +- **kb / guides**: `title`, `tags`, `draft` +- **plans**: `title`, `date`, `plan_date`, `status` (planned/in_progress/done/cancelled), `done_date`, `context_quote` +- **creds**: `title`, `description`, `service` — body contains base64-encoded encrypted payload +- **leadera / personal-site**: `title`, `tags` + +## Gotchas + +- Static assets must go in `static/` at project root, not `themes/a2v/static/` (the theme static dir is empty). +- The search index is generated by `themes/a2v/layouts/_default/index.json` — if you add a new section, it will be included automatically, but the Russian section label mapping is hardcoded in `search.js`. +- `hugo.toml` has `canonifyURLs = false` — do not set to true or relative URLs break. +- Hugo version installed: v0.159.1+extended (Homebrew). The theme requires ≥ 0.92.0. +- No `head.html` partial exists — the `` block is inline in `baseof.html` with a `{{ block "head" }}` extension point. diff --git a/content/leadera/_index.md b/content/leadera/_index.md new file mode 100644 index 0000000..2dfae7a --- /dev/null +++ b/content/leadera/_index.md @@ -0,0 +1,11 @@ +--- +title: "Leadera" +weight: 1 +--- + +# Leadera + +SaaS-система управления IT-ландшафтом с диаграммами Ганта. + +- **Прод:** [leadera.pro](https://leadera.pro) +- **Дев:** [sand.a2v.space](https://sand.a2v.space) diff --git a/content/guides/leadera-audit.md b/content/leadera/leadera-audit.md similarity index 100% rename from content/guides/leadera-audit.md rename to content/leadera/leadera-audit.md diff --git a/content/leadera/leadera-gantt-excel-export.md b/content/leadera/leadera-gantt-excel-export.md new file mode 100644 index 0000000..3827433 --- /dev/null +++ b/content/leadera/leadera-gantt-excel-export.md @@ -0,0 +1,103 @@ +--- +title: "Leadera — Экспорт диаграммы Ганта в Excel" +date: 2026-04-09 +lastmod: 2026-04-09 +tags: ["leadera", "gantt", "excel", "export"] +weight: 120 +--- + +# Экспорт диаграммы Ганта в Excel + +**Дата:** 09.04.2026 +**Статус:** Требования +**Проект:** Leadera + +--- + +## Общее описание + +Пользователь нажимает кнопку экспорта в интерфейсе диаграммы Ганта. Система запрашивает диапазон дат выгрузки (по умолчанию — текущий видимый диапазон из интерфейса). После указания диапазона скачивается Excel-файл с визуальным представлением диаграммы Ганта. + +--- + +## Вводные данные + +- **Источник:** текущая диаграмма Ганта проекта (один проект = одна диаграмма) +- **Диапазон дат:** пользователь указывает начальную и конечную дату. По умолчанию подставляется видимый в момент запроса диапазон из интерфейса +- **Масштаб таймлайна:** берётся тот, который выбран пользователем в интерфейсе в момент запроса (не сохранённый в системе, а текущий). Варианты: по ячейкам или по дням + +--- + +## Структура Excel-файла + +### Шапка (первые строки) +- Название диаграммы (название проекта) +- Диапазон дат, в рамках которого сделана выгрузка + +### Лист — один + +Вся диаграмма размещается на одном листе. + +### Секции +- Секции отображаются как **визуальная группировка строк** (не отдельные листы) +- Название секции — строка-заголовок над группой задач + +### Задачи +Каждая задача — отдельная строка. Данные задачи: +- **Название** (текстовая колонка слева) +- **Дата начала** (текстовая колонка слева) +- **Дата конца** (текстовая колонка слева) +- **Цвет** — ячейки таймлайна, соответствующие задаче, закрашены в цвет задачи + +### Таймлайн +- Таймлайн представлен колонками дат в верхней части (горизонтальная ось времени) +- Масштаб колонок соответствует выбранному пользователем в момент экспорта (по ячейкам / по дням) +- Задачи отображаются как **merged cells** по соответствующим колонкам дат — визуальная полоса диаграммы Ганта + +### Вехи +- Отображаются **отдельной строкой** (как задача, но с маркировкой вехи) +- Позиционируются на соответствующей дате в таймлайне + +### Зависимости +- **Не отображаются** (стрелочки/связи между задачами не нужны) + +--- + +## Пользовательский сценарий + +1. Пользователь открывает диаграмму Ганта проекта +2. Настраивает масштаб таймлайна (по ячейкам / по дням) +3. Нажимает кнопку «Экспорт в Excel» +4. Система показывает диалог с выбором диапазона дат (предзаполнен текущим видимым диапазоном) +5. Пользователь подтверждает / корректирует диапазон +6. Система генерирует Excel-файл и инициирует скачивание + +--- + +## Технические требования + +### Backend (Go API) +- Новый endpoint для генерации Excel (например, `GET /api/v1/gantt/:projectId/export`) +- Query-параметры: `dateFrom`, `dateTo`, `scale` (cell|day) +- Ответ: binary Excel-файл (`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`) +- Авторизация: обязательна (только участники проекта) +- Библиотека для генерации Excel: `excelize` (Go) + +### Frontend (Angular) +- Кнопка экспорта в тулбаре диаграммы Ганта +- Модальное окно выбора диапазона дат с datepicker'ами +- Предзаполнение диапазона из текущего видимого viewport'а +- Скачивание файла через `Blob` / `saveAs` + +### Фильтрация данных +- Выгружаются все задачи и вехи, которые: + - Начинаются в диапазоне, ИЛИ + - Заканчиваются в диапазоне, ИЛИ + - Начинаются до диапазона и заканчиваются после (перекрывают целиком) +- Секции включаются, если в них есть хотя бы одна попавшая задача + +--- + +## Открытые вопросы + +_(Нет)_ diff --git a/content/leadera/leadera-gantt-filters.md b/content/leadera/leadera-gantt-filters.md new file mode 100644 index 0000000..5ed2423 --- /dev/null +++ b/content/leadera/leadera-gantt-filters.md @@ -0,0 +1,278 @@ +--- +title: "Leadera — Фильтры и реорганизация списка диаграмм Ганта" +date: 2026-04-07 +lastmod: 2026-04-07 +tags: ["leadera", "gantt", "api", "frontend", "requirements"] +weight: 120 +--- + +# Фильтры и реорганизация списка диаграмм Ганта + +**Дата:** 07.04.2026 +**Статус:** Требования +**Проект:** Leadera (dev — sand.a2v.space) + +--- + +## 1. Постановка задачи + +Список диаграмм Ганта должен показывать **все доступные пользователю диаграммы** из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar. + +--- + +## 2. Изменения API + +### 2.1. Новый endpoint списка диаграмм + +**Было:** +``` +GET /api/v1/spaces/{spaceId}/gantt-charts?page=1&per_page=10 +``` + +**Стало:** +``` +GET /api/v1/gantt-charts?page=1&per_page=10 +``` + +Пользователь видит все диаграммы из **всех пространств**, где он является подтверждённым участником (статус `accepted`). + +### 2.2. Параметры фильтрации и поиска + +| Параметр | Тип | Описание | +|----------|-----|----------| +| `page` | int | Номер страницы (default: 1) | +| `per_page` | int | Записей на странице (default: 10) | +| `space_id` | UUID (optional) | Фильтр по конкретному пространству | +| `created_by` | UUID (optional) | Фильтр по создателю диаграммы | +| `search` | string (optional) | Поиск по назвению и описанию (ILIKE, case-insensitive) | +| `sort` | string (optional) | Сортировка: `created_at`, `updated_at`, `title` (default: `updated_at`) | +| `order` | string (optional) | `asc` / `desc` (default: `desc`) | + +**Примеры:** +``` +GET /api/v1/gantt-charts?search=миграция +GET /api/v1/gantt-charts?space_id=0b334ded-...&created_by=a1b2c3d4-... +GET /api/v1/gantt-charts?page=2&per_page=20&sort=title&order=asc +``` + +### 2.3. Изменение структуры ответа + +Добавить поле `space` в каждую диаграмму: + +```json +{ + "data": [ + { + "id": "uuid", + "title": "Миграция backend", + "description": "...", + "created_by": "uuid", + "created_by_name": "Антон Агальцов", + "created_at": "2026-04-01T10:00:00Z", + "updated_at": "2026-04-07T09:00:00Z", + "space": { + "id": "uuid", + "name": "IT Ландшафт", + "color": "#c4623a" + }, + "is_archived": false + } + ], + "pagination": { + "page": 1, + "per_page": 10, + "total": 42, + "total_pages": 5 + } +} +``` + +### 2.4. Endpoint для списка фильтров + +Вспомогательный endpoint для заполнения dropdown-фильтров: + +``` +GET /api/v1/gantt-charts/filters +``` + +**Ответ:** +```json +{ + "spaces": [ + { "id": "uuid", "name": "IT Ландшафт", "color": "#c4623a" }, + { "id": "uuid", "name": "DevOps", "color": "#27ae60" } + ], + "creators": [ + { "id": "uuid", "display_name": "Антон Агальцов" }, + { "id": "uuid", "display_name": "Иван Петров" } + ] +} +``` + +**Логика `creators`:** уникальные создатели всех диаграмм, доступных текущему пользователю. Получается через DISTINCT-запрос по `created_by` с JOIN на users. + +### 2.5. Backend — изменения в Go + +**Файлы для изменения:** + +#### `internal/handlers/gantt_handler.go` + +- Добавить новый handler `ListAllGanttCharts` — без привязки к space +- Зарегистрировать маршрут `GET /gantt-charts` (без `/spaces/:id/`) +- Парсить query-параметры: `space_id`, `created_by`, `search`, `sort`, `order` +- Старый маршрут `GET /spaces/:id/gantt-charts` — оставить для обратной совместимости (или удалить, если не используется) + +#### `internal/service/gantt_service.go` + +- Новый метод `ListAll(ctx, userId, filters)` — запрашивает все spaces пользователя (через `space_member` с `status=accepted`), затем выбирает все gantt_charts из этих spaces с фильтрами + +#### `internal/repository/gantt_repository.go` + +- Новый метод с динамическим SQL: + - Базовый JOIN: `gantt_charts` → `spaces` → `space_members` + - WHERE: `space_members.user_id = $1 AND space_members.status = 'accepted'` + - Опциональные фильтры: `AND space_id = $N`, `AND created_by = $N`, `AND (title ILIKE '%' || $N || '%' OR description ILIKE '%' || $N || '%')` + - Возвращать поле `space` (id, name, color) через JOIN + +#### `internal/dto/gantt/` + +- Новые DTO: `GanttChartListFilters`, `GanttChartWithSpaceResponse`, `GanttFiltersResponse` + +**SQL (пример):** +```sql +SELECT gc.*, s.id as space_id, s.name as space_name, s.color as space_color, + u.display_name as created_by_name +FROM gantt_charts gc +JOIN spaces s ON s.id = gc.space_id +JOIN space_members sm ON sm.space_id = s.id +LEFT JOIN users u ON u.id = gc.created_by +WHERE sm.user_id = $1 + AND sm.status = 'accepted' + AND ($2::uuid IS NULL OR gc.space_id = $2) + AND ($3::uuid IS NULL OR gc.created_by = $3) + AND ($4::text IS NULL OR gc.title ILIKE '%' || $4 || '%' + OR gc.description ILIKE '%' || $4 || '%') +ORDER BY + CASE WHEN $5 = 'title' THEN gc.title END, + CASE WHEN $5 = 'created_at' THEN gc.created_at::text END, + gc.updated_at DESC +LIMIT $6 OFFSET $7; +``` + +--- + +## 3. Изменения Frontend (Angular) + +### 3.1. Toolbar фильтров + +Добавить toolbar над списком диаграмм: + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ [🔍 Поиск... ] [▼ Пространство] │ +│ [▼ Создатель] [▼ Сортировка] [Сбросить фильтры] │ +└──────────────────────────────────────────────────────────────────┘ +``` + +**Компоненты:** +- **Строка поиска** — input с debounce (300ms), поиск по назвению и описанию +- **Dropdown «Пространство»** — список из `/gantt-charts/filters`, с цветовой меткой +- **Dropdown «Создатель»** — список уникальных создателей +- **Dropdown «Сортировка»** — по дате обновления, дате создания, названию +- **Кнопка «Сбросить»** — очищает все фильтры + +**Состояние фильтров в URL** (query params): +``` +/gantt?search=миграция&space_id=xxx&sort=updated_at +``` +Это позволяет делиться ссылкой с уже настроенными фильтрами. + +### 3.2. Карточка диаграммы — бейдж пространства + +На каждой карточке добавить бейдж с названием пространства: + +``` +┌─────────────────────────────────────┐ +│ 🟠 IT Ландшафт │ ← бейдж с цветом пространства +│ Миграция backend │ +│ Перевод PHP→Go, этап 2 │ +│ Создал: Антон А. · 07.04.2026 │ +└─────────────────────────────────────┘ +``` + +### 3.3. Форма создания диаграммы — выбор пространства + +В модальном окне создания: +- Dropdown со списком пространств, где пользователь имеет роль **editor** или выше +- Валидация: если пользователь не editor ни в одном пространстве — показать сообщение «Нет доступных пространств для создания» + +**Запрос доступных пространств:** переиспользовать существующий `GET /api/v1/spaces` с фильтрацией на клиенте по `role ∈ [owner, admin, editor]`, либо добавить параметр `?min_role=editor` на backend. + +### 3.4. Изменение routing + +**Было:** +``` +/gantt → список гантов текущего пространства +``` + +**Стало:** +``` +/gantt → список всех доступных гантов (из всех пространств) +``` + +Убрать зависимость от `SpaceStorageService.getSelectedSpaceId()` в списке гантов. + +### 3.5. Frontend — файлы для изменения + +| Файл | Изменение | +|------|-----------| +| `pages/gantt/services/gantt.service.ts` | Новый метод `listAll(filters)`, `getFilters()` | +| `pages/gantt/gantt.component.ts` | Подключить toolbar, парсинг URL-параметров | +| `pages/gantt/gantt.component.html` | Добавить toolbar, бейджи на карточках | +| `pages/gantt/components/gantt-card/` | Добавить бейдж пространства | +| `pages/gantt/components/create-chart-modal/` | Dropdown выбора пространства | +| `core/models/` | Обновить модели: добавить `space` в GanttChart | + +--- + +## 4. Обратная совместимость + +| Endpoint | Статус | +|----------|--------| +| `GET /api/v1/spaces/{id}/gantt-charts` | Сохранить (для детального view внутри пространства) | +| `GET /api/v1/gantt-charts` | **Новый** — глобальный список | +| `GET /api/v1/gantt-charts/filters` | **Новый** — данные для dropdown'ов | +| `POST /api/v1/spaces/{id}/gantt-charts` | Сохранить (создание в контексте пространства) | +| Все CRUD для sections/tasks | Без изменений | + +--- + +## 5. Критерии приёмки + +- [ ] Endpoint `GET /api/v1/gantt-charts` возвращает все доступные диаграммы +- [ ] Фильтр по `space_id` — показывает только диаграммы конкретного пространства +- [ ] Фильтр по `created_by` — показывает только диаграммы выбранного создателя +- [ ] Поиск `search` — ищет по title и description (case-insensitive) +- [ ] Dropdown фильтров заполняется реальными данными из `/filters` +- [ ] Карточка диаграммы показывает бейдж пространства с цветом +- [ ] Форма создания предлагает только пространства с ролью ≥ editor +- [ ] Состояние фильтров сохраняется в URL (можно поделиться ссылкой) +- [ ] Старые endpoints (`/spaces/{id}/gantt-charts`) продолжают работать +- [ ] Swagger документация обновлена + +--- + +## 6. Порядок реализации + +1. Backend: DTO для новых запросов/ответов +2. Backend: Repository — SQL-запрос с фильтрами + JOIN на spaces +3. Backend: Service — `ListAll`, `GetFilters` +4. Backend: Handler — `ListAllGanttCharts`, `GetGanttFilters`, регистрация маршрутов +5. Backend: Swagger — обновить документацию +6. Frontend: Модели — обновить GanttChart, добавить Space в ответ +7. Frontend: Service — `listAll()`, `getFilters()` +8. Frontend: Toolbar компонент — поиск + dropdown'ы +9. Frontend: Карточка — бейдж пространства +10. Frontend: Модальное окно создания — dropdown пространства +11. Frontend: URL-параметры — синхронизация фильтров с router +12. Тестирование diff --git a/content/leadera/leadera-gantt-public-access.md b/content/leadera/leadera-gantt-public-access.md new file mode 100644 index 0000000..84ff79b --- /dev/null +++ b/content/leadera/leadera-gantt-public-access.md @@ -0,0 +1,125 @@ +--- +title: "Leadera — Публичный доступ к диаграмме Ганта" +date: 2026-04-09 +lastmod: 2026-04-09 +tags: ["leadera", "gantt", "public-access", "sharing"] +weight: 130 +--- + +# Публичный доступ к диаграмме Ганта (Share) + +**Дата:** 09.04.2026 +**Статус:** Требования +**Проект:** Leadera + +--- + +## Общее описание + +Пользователь может создать публичную ссылку на фрагмент диаграммы Ганта, доступную для просмотра без авторизации. Открывший ссылку видит диаграмму в read-only режиме с возможностью масштабирования таймлайна, но без каких-либо элементов управления (создание, редактирование, удаление задач/секций/вех). + +--- + +## Пользовательский сценарий (создатель ссылки) + +1. Пользователь открывает диаграмму Ганта проекта +2. Нажимает кнопку «Экспорт» / «Общий доступ» +3. Указывает диапазон дат, который должен отображаться на диаграмме +4. Система генерирует уникальную ссылку (UUID) и показывает её пользователю +5. Пользователь копирует ссылку и передаёт заинтересованным лицам + +### Управление ссылками +- Вызывается через меню экспорта → модальное окно «Общий доступ» +- В модальном окне отображается список созданных ссылок с указанием диапазона дат +- Каждую ссылку можно **удалить** (полное удаление из БД, не soft delete) +- Ссылки **нельзя редактировать** — только создавать и удалять +- Ограничений на количество активных ссылок нет +- Статистика просмотров (сколько раз открывали) — **не нужна** + +--- + +## Пользовательский сценарий (зритель по ссылке) + +1. Зритель переходит по ссылке (без авторизации) +2. Открывается отдельная страница с диаграммой Ганта +3. Зритель видит: + - Задачи и вехи, попадающие в заданный диапазон + - Секции (заголовки группировок) + - Таймлайн с цветовой раскраской задач +4. Зритель может: + - Масштабировать таймлайн + - Переключать отображение «по ячейкам» / «по дням» +5. Зритель **не может**: + - Создавать, редактировать, удалять задачи / секции / вехи + - Видеть любые контролы управления (кнопки создания, контекстные меню, drag-and-drop и т.д.) + - Авторизоваться через эту страницу + +--- + +## Данные и фильтрация + +### Что попадает в представление +Задачи и вехи, у которых хотя бы одно из условий верно: +- Дата начала попадает в диапазон ссылки +- Дата конца попадает в диапазон ссылки +- Задача начинается до диапазона и заканчивается после (полностью перекрывает) + +Секции включаются, если в них есть хотя бы одна попавшая задача. + +### API возвращает +- Только задачи и вехи, попадающие в диапазон (не всю диаграмму) +- Информацию о секциях, содержащих попавшие задачи +- Минимальный набор полей, необходимый для отрисовки (без внутренних ID пользователей и т.п.) + +--- + +## Технические требования + +### Ссылки +- Формат: UUID v4 (каждый раз новый) +- Срок действия: бессрочно (пока не удалена) +- Удаление: **жёсткое** (hard delete из БД) + +### Backend (Go API) + +#### Таблица БД: `gantt_public_links` +- `id` (UUID, PK) +- `project_id` (FK → projects) +- `date_from` (date) +- `date_to` (date) +- `created_by` (FK → users) +- `created_at` (timestamp) + +#### Endpoints +- `POST /api/v1/gantt/:projectId/public-links` — создать ссылку (авторизован, участник проекта) + - Body: `{ dateFrom, dateTo }` + - Response: `{ url: "https://leadera.pro/share/" }` +- `GET /api/v1/gantt/:projectId/public-links` — список ссылок проекта (авторизован, участник) +- `DELETE /api/v1/gantt/public-links/:uuid` — удалить ссылку (авторизован, создатель) +- `GET /api/v1/public/gantt/:uuid` — получить данные диаграммы по ссылке (без авторизации) + - Response: задачи, вехи, секции в рамках диапазона + +#### Rate limiting +- На публичный endpoint `GET /api/v1/public/gantt/:uuid` — rate limiting для защиты от перебора +- Рекомендация: 60 запросов в минуту на IP + +### Frontend (Angular) + +#### Модальное окно «Общий доступ» +- Вызывается из меню экспорта +- Содержит: + - Форму создания ссылки (диапазон дат + кнопка «Создать») + - Список существующих ссылок (диапазон + URL + кнопка «Копировать» + кнопка «Удалить») + +#### Публичная страница `/share/:uuid` +- Отдельный route, **не требует авторизации** +- Отображает диаграмму Ганта в read-only режиме +- Доступны только: масштабирование таймлайна, переключение ячейки/дни +- Все контролы управления скрыты (удалены из шаблона, не просто disabled) +- Минимальный layout — без навигации проекта, без сайдбара + +--- + +## Открытые вопросы + +_(Нет)_ diff --git a/content/leadera/leadera-milestones.md b/content/leadera/leadera-milestones.md new file mode 100644 index 0000000..dfb12be --- /dev/null +++ b/content/leadera/leadera-milestones.md @@ -0,0 +1,329 @@ +--- +title: "Leadera: Вехи (Milestones) на диаграмме Ганта" +date: 2026-04-08 +tags: ["leadera", "gantt", "angular", "go", "api", "ux"] +--- + +## Бизнес-требования + +### BR-1: Сущность «Веха» (Milestone) + +Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате. + +**Поля вехи:** + +| Поле | Тип | Описание | +|------|-----|----------| +| id | UUID | Идентификатор | +| gantt_chart_id | UUID | Принадлежность к диаграмме (не к секции!) | +| title | string | Название вехи (обязательное, 1–255 символов) | +| date | date | Дата вехи (без времени, обязательная) | +| color | string | Цвет маркера (HEX, по умолчанию `#dc3545` — красный) | +| created_by | UUID | Кто создал (не отображается в UI, хранится для аудита) | +| updated_by | UUID | Кто обновил (не отображается в UI) | +| created_at | timestamp | Дата создания | +| updated_at | timestamp | Дата обновления | +| deleted_at | timestamp | Soft delete | + +**Права доступа:** Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам). + +**Особенности:** +- Вех может быть несколько в проекте +- Несколько вех могут иметь одну и ту же дату +- Вехи сортируются строго по дате (по возрастанию) +- Вехи не привязаны к секциям — они отображаются **сквозь все секции** + +--- + +### BR-2: Управление вехами (модальное окно) + +**Вызов:** Кнопка «Вехи» рядом с кнопкой «Создать секцию» на странице диаграммы. + +**Модальное окно содержит:** +- Заголовок: «Вехи проекта» +- Список всех вех текущей диаграммы (сортировка по дате по возрастанию) +- Каждая веха в списке показывает: цвет (индикатор), название, дату, кнопки «Редактировать» и «Удалить» +- Кнопка «Добавить веху» + +**Форма добавления/редактирования вехи:** +- Название — текстовый ввод (обязательное, 1–255 символов) +- Дата — datepicker (обязательное) +- Цвет — выбор цвета (по аналогии с палитрой цветов в задачах) +- По умолчанию цвет = красный (`#dc3545`) + +**Удаление:** с подтверждением (confirm dialog). + +--- + +### BR-3: Отображение вех на таймлайне + +**Визуальное представление:** +- **Маркер-флажок** (flag marker) на шкале таймлайна +- От маркера вниз идёт **пунктирная вертикальная линия** через все секции (на всю высоту диаграммы) +- Цвет линии и маркера = цвет вехи + +**Позиционирование:** +- Веха ставится ровно на свою дату на шкале времени +- Если дата вехи выходит за рамки текущего диапазона задач — таймлайн **расширяется** (аналогично задачам) +- При изменении масштаба (days/weeks/months/quarters) позиция вехи пересчитывается + +**Tooltip при наведении:** +- При наведении на маркер/линию — показывается tooltip с названием вехи +- Если на одну дату приходится несколько вех — в tooltip показываются **все** вехи этой даты с их названиями (каждая с индикацией своего цвета) + +--- + +## Технические требования + +### База данных + +#### Новая таблица: gantt_milestones + +```sql +CREATE TABLE gantt_milestones ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + gantt_chart_id UUID NOT NULL REFERENCES gantt_charts(id) ON DELETE CASCADE, + title VARCHAR(255) NOT NULL, + date DATE NOT NULL, + color VARCHAR(20) NOT NULL DEFAULT '#dc3545', + created_by UUID NOT NULL REFERENCES users(id), + updated_by UUID NOT NULL REFERENCES users(id), + created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), + updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), + deleted_at TIMESTAMP WITH TIME ZONE +); + +CREATE INDEX idx_gantt_milestones_chart ON gantt_milestones(gantt_chart_id); +CREATE INDEX idx_gantt_milestones_date ON gantt_milestones(date); +``` + +--- + +### Backend (Go API) + +#### Этап 1: Миграция + Домен + +**Промт для агента:** + +> Добавь в проект новую таблицу `gantt_milestones`. +> +> 1. Создай миграцию в `cmd/migrate/`: +> - Новая таблица `gantt_milestones` с полями: id (UUID PK), gantt_chart_id (UUID FK → gantt_charts, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), date (DATE NOT NULL), color (VARCHAR 20 NOT NULL DEFAULT '#dc3545'), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. Индексы по gantt_chart_id и date. +> +> 2. Создай доменную модель `GanttMilestone` в `internal/domain/gantt.go`: +> ```go +> type GanttMilestone struct { +> ID UUID `json:"id"` +> GanttChartID UUID `json:"gantt_chart_id"` +> Title string `json:"title"` +> Date time.Time `json:"date"` +> Color string `json:"color"` +> CreatedBy UUID `json:"created_by"` +> UpdatedBy UUID `json:"updated_by"` +> CreatedAt time.Time `json:"created_at"` +> UpdatedAt time.Time `json:"updated_at"` +> DeletedAt *time.Time `json:"deleted_at,omitempty"` +> } +> ``` + +#### Этап 2: CRUD для GanttMilestones + +**Промт для агента:** + +> Реализуй полный CRUD для сущности `GanttMilestone` по аналогии с существующими handlers/services/repositories в проекте. +> +> **Роуты:** +> - `GET /api/gantt-charts/:chartId/milestones` — список вех диаграммы +> - `POST /api/gantt-charts/:chartId/milestones` — создать веху +> - `PUT /api/gantt-charts/:chartId/milestones/:milestoneId` — обновить веху +> - `DELETE /api/gantt-charts/:chartId/milestones/:milestoneId` — удалить веху (soft delete) +> +> **Repository:** `internal/repository/gantt_milestone_repository.go` +> - `GetByChartID(ctx, chartID) ([]domain.GanttMilestone, error)` — все неудалённые вехи диаграммы, отсортированные по date ASC +> - `GetByID(ctx, id) (*domain.GanttMilestone, error)` +> - `Create(ctx, milestone) error` +> - `Update(ctx, milestone) error` +> - `Delete(ctx, id) error` — soft delete (set deleted_at) +> - Все запросы — raw SQL через pgx, как в остальных репозиториях проекта +> +> **Service:** `internal/service/gantt_milestone_service.go` +> - Валидация: title (1–255 символов), date (обязательное), color (валидный HEX, default '#dc3545') +> - Проверка прав доступа: пользователь должен иметь права выше «только чтение» в пространстве (space) диаграммы +> - Проверка что chartId существует и не архивирован +> +> **Handler:** `internal/handler/gantt_milestone_handler.go` +> - Swagger-аннотации для всех эндпоинтов +> - Валидация входных данных +> - Ошибки в формате проекта +> +> **DTO:** `internal/dto/gantt/milestones_dto.go` +> ```go +> type CreateGanttMilestoneRequest struct { +> Title string `json:"title" binding:"required,min=1,max=255"` +> Date string `json:"date" binding:"required"` +> Color *string `json:"color" binding:"omitempty,max=20"` +> } +> +> type UpdateGanttMilestoneRequest struct { +> Title *string `json:"title" binding:"omitempty,min=1,max=255"` +> Date *string `json:"date" binding:"omitempty"` +> Color *string `json:"color" binding:"omitempty,max=20"` +> } +> +> type GanttMilestoneResponse struct { +> ID domain.UUID `json:"id"` +> GanttChartID domain.UUID `json:"gantt_chart_id"` +> Title string `json:"title"` +> Date string `json:"date"` +> Color string `json:"color"` +> CreatedByUser *CreatedByUpdatedUser `json:"created_by_user"` +> UpdatedByUser *CreatedByUpdatedUser `json:"updated_by_user"` +> CreatedAt time.Time `json:"created_at"` +> UpdatedAt time.Time `json:"updated_at"` +> } +> +> type GanttMilestonesListResponse struct { +> Milestones []GanttMilestoneResponse `json:"milestones"` +> } +> ``` +> +> **Регистрация роутов:** Добавь группу milestone-роутов в роутер рядом с существующими роутами секций/задач. Проверка прав через существующий middleware. + +#### Этап 3: Включение вех в ответ диаграммы + +**Промт для агента:** + +> При запросе данных диаграммы Ганта (полная загрузка) включай связанные вехи в ответ. +> +> 1. Добавь эндпоинт или расширь существующий `GET /api/gantt-charts/:chartId` — включить поле `milestones` с массивом `GanttMilestoneResponse` +> 2. Вехи с `deleted_at IS NOT NULL` не возвращаются +> 3. Вехи сортируются по `date` ASC +> 4. Вехи загружаются вместе с данными диаграммы (tasks, sections) — один запрос при открытии Ганта + +--- + +### Frontend (Angular) + +#### Этап FE-1: Модели + Сервис + +**Промт для агента:** + +> Добавь в проект поддержку вех (milestones) на диаграмме Ганта. +> +> 1. В `pages/gantt/models/` (или соответствующем файле моделей) добавь: +> +> ```typescript +> export interface GanttMilestone { +> id: string; +> gantt_chart_id: string; +> title: string; +> date: string; +> color: string; +> created_by_user?: { id: string; full_name: string }; +> updated_by_user?: { id: string; full_name: string }; +> created_at: string; +> updated_at: string; +> } +> +> export interface GanttMilestoneCreateRequest { +> title: string; +> date: string; +> color?: string; +> } +> +> export interface GanttMilestoneUpdateRequest { +> title?: string; +> date?: string; +> color?: string; +> } +> ``` +> +> 2. Добавь `milestones: GanttMilestone[]` в интерфейс/модель полной загрузки данных диаграммы +> +> 3. Создай сервис `pages/gantt/services/gantt-milestone.service.ts`: +> - Inject HttpClient +> - Методы: +> - `getMilestones(chartId: string): Observable` +> - `createMilestone(chartId: string, data: GanttMilestoneCreateRequest): Observable` +> - `updateMilestone(chartId: string, milestoneId: string, data: GanttMilestoneUpdateRequest): Observable` +> - `deleteMilestone(chartId: string, milestoneId: string): Observable` +> - Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService) + +#### Этап FE-2: Модальное окно управления вехами + +**Промт для агента:** + +> Создай компонент модального окна для управления вехами диаграммы Ганта. +> +> 1. Создай компонент `pages/gantt/components/milestones-modal/` +> +> 2. **Кнопка вызова:** Добавь кнопку «Вехи» рядом с кнопкой «Создать секцию» в toolbar диаграммы. По клику — открытие модального окна через ng-bootstrap NgbModal. +> +> 3. **Модальное окно** (ng-bootstrap modal): +> - Заголовок: «Вехи проекта» +> - Список вех (сортировка по date ASC): +> - Каждый элемент: цветной кружок (color), название, дата (форматированная), кнопки ✏️ (редактировать) и 🗑️ (удалить с confirm) +> - Кнопка «Добавить веху» внизу списка +> - Если вех нет — сообщение «Вех пока нет. Добавьте первую!» +> +> 4. **Форма добавления/редактирования** (inline в модальном окне): +> - Название — текстовый ввод (обязательное) +> - Дата — ng-bootstrap datepicker (обязательное) +> - Цвет — палитра цветов (использовать тот же компонент/подход, что и для задач) +> - По умолчанию цвет = `#dc3545` (красный) +> - Кнопки «Сохранить» и «Отмена» +> +> 5. При сохранении — вызов соответствующего метода сервиса (create/update) +> 6. При удалении — confirm dialog → вызов deleteMilestone +> 7. После любого изменения — обновить список вех и обновить данные на канвасе (через сервис/GanttStore) +> +> 8. Инжектировать GanttMilestoneService и NgbModal + +#### Этап FE-3: Отображение вех на таймлайне (Konva canvas) + +**Промт для агента:** + +> Отобрази вехи (milestones) на canvas-диаграмме Ганта. +> +> Проект использует Konva.js для рендеринга. +> +> 1. При загрузке данных диаграммы — извлечь массив `milestones` +> +> 2. Для каждой вехи нарисовать на canvas: +> - **Маркер-флажок** (flag marker) на позиции даты вехи на шкале времени +> - Стиль: маленький треугольник или флаг на верхней границе таймлайна +> - Цвет = milestone.color +> - **Пунктирная вертикальная линия** от маркера вниз через все секции (на всю высоту области секций) +> - Стиль: Konva.Line, dash: [5, 5], strokeWidth: 1.5, color = milestone.color, opacity: 0.7 +> +> 3. **Позиционирование:** +> - Рассчитать X-позицию по дате вехи с использованием текущей шкалы времени (как для задач) +> - Если дата вехи выходит за текущий диапазон — расширить диапазон (влияет на общую ширину таймлайна) +> - При изменении масштаба (days/weeks/months/quarters) — пересчитать позиции всех вех +> - При скролле — вехи скроллятся вместе с задачами +> +> 4. **Tooltip при наведении:** +> - При наведении на маркер или пунктирную линию — показать Konva.Tooltip или HTML tooltip: +> - Если веха одна на эту дату — показать название +> - Если несколько вех на одну дату — показать список: цветной кружок + название для каждой +> +> 5. **Z-index:** +> - Линии вех рисуются **поверх** фона секций, но **под** задачами +> - Маркеры-флажки — поверх всего (самый высокий z-index) +> +> 6. **Реактивность:** +> - При добавлении/удалении/редактировании вехи — перерисовать только вехи (без полного ре рендера задач) +> - Подписаться на изменения массива milestones через сервис/store + +--- + +## Порядок реализации + +| # | Этап | Сторона | Зависимости | +|---|------|---------|-------------| +| 1 | Миграция + Домен | Backend | — | +| 2 | CRUD вех | Backend | Этап 1 | +| 3 | Включение вех в ответ диаграммы | Backend | Этап 2 | +| 4 | Модели + Сервис | Frontend | — (параллельно с backend) | +| 5 | Модальное окно управления вехами | Frontend | Этапы 4 + backend 2 | +| 6 | Отображение вех на таймлайне | Frontend | Этапы 4 + backend 3 | diff --git a/content/leadera/leadera-section-constraints.md b/content/leadera/leadera-section-constraints.md new file mode 100644 index 0000000..4f00cfc --- /dev/null +++ b/content/leadera/leadera-section-constraints.md @@ -0,0 +1,407 @@ +--- +title: "Leadera: Ограничения секций в диаграмме Ганта" +date: 2026-04-06 +tags: ["leadera", "gantt", "angular", "go", "api", "ux"] +--- + +## Бизнес-требования + +### BR-1: Лимит одновременных задач (Concurrency Limit) + +У каждой секции появляется параметр **max_concurrent_tasks** (целое число ≥ 0, по умолчанию 0). + +**Поведение:** + +- Если `max_concurrent_tasks = 3` — в любой данный день в этой секции не может быть больше 3 активных задач одновременно +- Если `max_concurrent_tasks = 0` — ограничение отключено, лимита нет +- Пересечение считается по дате: задача занимает дни с `start_date` по `end_date` включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день +- Ограничение работает **только в рамках одной секции**. Задачи из разных секций не влияют друг на друга + +**Срабатывание при:** + +1. Создании задачи — если добавление нарушает лимит → Alert +2. Перетаскивании задачи (drag) — если новая позиция нарушает лимит → Alert +3. Растягивании задачи (resize) — если новый размер нарушает лимит → Alert +4. Редактировании задачи (форма) — если изменённые даты нарушают лимит → Alert + +**Важно:** Действие **НЕ отменяется**. Задача создаётся/перемещается в любом случае, но пользователь видит предупреждение. + +**Текст Alert:** «В секции "[название секции]" на [дата/диапазон] превышен лимит одновременных задач (максимум: N)» + +--- + +### BR-2: Блоки секций (Section Blocks) + +У каждой секции появляется набор **блоков** — особый вид записей, отображаемых на таймлайне как заштрихованные области. + +**Сущность GanttSectionBlock:** + +| Поле | Тип | Описание | +|------|-----|----------| +| id | UUID | Идентификатор | +| section_id | UUID | Принадлежность к секции | +| title | string | Название (например: «Отпуск», «Командировка») | +| start_date | date | Начало интервала (минимум 1 день) | +| end_date | date | Конец интервала | +| block_concurrency | boolean | Запрещать ли пересечение обычных задач с данным блоком | + +**Валидация:** + +- `end_date` не может быть раньше `start_date` +- Все поля обязательны +- Блок может быть в прошлом + +**Визуальное отображение на Ганте:** + +- Заштрихованная область на **всю высоту секции** (включая все строки задач в секции) +- Название блока отображается **поверх штриховки с подложкой** (для читаемости) + +**Поведение block_concurrency:** + +- Если `block_concurrency = true` — при пересечении задачи с данным блоком показывается Alert (аналогично BR-1), но задача **всё равно создаётся/перемещается** +- Если `block_concurrency = false` — блок отображается визуально, но не влияет на задачи + +**Срабатывание при:** + +1. Создании задачи — пересекает блок с `block_concurrency = true` → Alert +2. Перетаскивании задачи (drag) → Alert +3. Растягивании задачи (resize) → Alert +4. Редактировании задачи (форма) → Alert + +**Текст Alert:** «В секции "[название секции]" задача пересекает блок "[название блока]" ([дата] — [дата])» + +--- + +### BR-3: Система Alert-ов + +Все предупреждения (от BR-1 и BR-2) выводятся в **единую область** над диаграммой Ганта. + +**Поведение:** + +- Alert-ы — Bootstrap Alert (warning), **постоянные** +- Пользователь **НЕ может** закрыть Alert вручную +- Alert исчезает **автоматически**, когда текущая дата прошла дату конфликта (конфликт больше не актуален) +- Проверка конфликтов — **только на фронтенде** (на основе загруженных данных: задачи секции, блоки, max_concurrent_tasks) +- Если Alert-ов много — область **сворачиваемая** с счётчиком в бейдже (например: «⚠️ 3 предупреждения») +- По умолчанию — развёрнуто +- Сворачивание/разворачивание — клик по заголовку области + +--- + +### BR-4: Настройки секции + +- Настройки совмещены с **существующим модальным окном редактирования секции** (не отдельное окно) + +**Окно создания секции** — добавляется: +- Поле «Макс. одновременных задач» (числовой ввод, 0 = без лимита, по умолчанию 0) + +**Окно редактирования секции** — добавляется: +- Поле «Макс. одновременных задач» (числовой ввод, 0 = без лимита) +- Список блоков (таблица/список с CRUD: добавить, редактировать, удалить) + - **Сортировка:** по `start_date` по убыванию (будущее сверху) + - Каждый блок — форма: title, start_date, end_date, block_concurrency (чекбокс: «Запретить пересечение задач») + - Валидация: end_date >= start_date, все поля заполнены + +--- + +### BR-5: Наследование + +- При появлении функционала копирования/дублирования диаграммы — настройки секций (лимит + блоки) наследуются + +--- + +## Технические требования + +### База данных + +#### Новая таблица: gantt_section_blocks + +```sql +CREATE TABLE gantt_section_blocks ( + id UUID PRIMARY KEY DEFAULT gen_random_uuid(), + section_id UUID NOT NULL REFERENCES gantt_sections(id) ON DELETE CASCADE, + title VARCHAR(255) NOT NULL, + start_date DATE NOT NULL, + end_date DATE NOT NULL, + block_concurrency BOOLEAN NOT NULL DEFAULT false, + created_by UUID NOT NULL REFERENCES users(id), + updated_by UUID NOT NULL REFERENCES users(id), + created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), + updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), + deleted_at TIMESTAMP WITH TIME ZONE, + CONSTRAINT chk_block_dates CHECK (end_date >= start_date) +); + +CREATE INDEX idx_gantt_section_blocks_section ON gantt_section_blocks(section_id); +CREATE INDEX idx_gantt_section_blocks_dates ON gantt_section_blocks(start_date, end_date); +``` + +#### Изменение таблицы: gantt_sections + +```sql +ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0; +``` + +--- + +### Backend (Go API) + +#### Этап 1: Миграция + Домен + +**Промт для агента:** + +> Добавь в проект новую таблицу `gantt_section_blocks` и колонку `max_concurrent_tasks` в `gantt_sections`. +> +> 1. Создай миграцию в `cmd/migrate/`: +> - Новая таблица `gantt_section_blocks` с полями: id (UUID PK), section_id (UUID FK → gantt_sections, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), start_date (DATE NOT NULL), end_date (DATE NOT NULL), block_concurrency (BOOLEAN DEFAULT false), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. CHECK constraint: end_date >= start_date. Индексы по section_id и (start_date, end_date). +> - ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0. +> 2. Создай доменную модель `GanttSectionBlock` в `internal/domain/gantt.go` со всеми полями таблицы. +> 3. Добавь поле `MaxConcurrentTasks int` в структуру `GanttSection`. +> 4. Обнови маппинг в relevant repository файлах, чтобы новое поле `max_concurrent_tasks` читалось/писалось. + +#### Этап 2: CRUD для GanttSectionBlocks + +**Промт для агента:** + +> Реализуй полный CRUD для сущности `GanttSectionBlock` по аналогии с существующими handlers/services/repositories в проекте. +> +> **Роуты (внутри группы секции):** +> - `GET /api/gantt-charts/:chartId/sections/:sectionId/blocks` — список блоков секции +> - `POST /api/gantt-charts/:chartId/sections/:sectionId/blocks` — создать блок +> - `PUT /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId` — обновить блок +> - `DELETE /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId` — удалить блок (soft delete) +> +> **Repository:** `internal/repository/gantt_section_block_repository.go` +> - `GetBySectionID(ctx, sectionID) ([]domain.GanttSectionBlock, error)` +> - `GetByID(ctx, id) (*domain.GanttSectionBlock, error)` +> - `Create(ctx, block) error` +> - `Update(ctx, block) error` +> - `Delete(ctx, id) error` — soft delete (set deleted_at) +> - Все запросы — raw SQL через pgx, как в остальных репозиториях проекта +> +> **Service:** `internal/service/gantt_section_block_service.go` +> - Бизнес-логика: валидация dates (end >= start), проверка прав доступа к секции +> - Inject repository +> +> **Handler:** `internal/handler/gantt_section_block_handler.go` +> - Swagger-аннотации для всех эндпоинтов +> - Валидация входных данных +> - Ошибки в формате проекта (GanttErrorResponse) +> +> **Модели запросов:** +> - Create: title (required), start_date (required), end_date (required), block_concurrency (bool, default false) +> - Update: title, start_date, end_date, block_concurrency — все опциональны + +#### Этап 3: Обновление настроек секции + +**Промт для агента:** + +> Обнови CRUD секций (gantt_sections) для поддержки нового поля `max_concurrent_tasks`. +> +> 1. Добавь `max_concurrent_tasks` в `GanttSectionCreateRequest` (опциональное, int ≥ 0, default 0) +> 2. Добавь `max_concurrent_tasks` в `GanttSectionUpdateRequest` (опциональное, int ≥ 0) +> 3. Обнови SQL-запросы в repository: INSERT и UPDATE должны включать `max_concurrent_tasks` +> 4. При GET секции (или списке секций) — возвращать `max_concurrent_tasks` в ответе +> 5. Валидация: значение должно быть ≥ 0 + +#### Этап 4: Включение блоков в ответ секций + +**Промт для агента:** + +> При запросе списка секций или одной секции включай связанные блоки в ответ. +> +> 1. Обнови `GET /api/gantt-charts/:chartId/sections/:sectionId` — добавить поле `blocks` с массивом GanttSectionBlock +> 2. Обнови `GET /api/gantt-charts/:chartId/sections` — добавить поле `blocks` для каждой секции +> 3. Блоки с `deleted_at IS NOT NULL` не возвращаются +> 4. Блоки сортируются по start_date по убыванию (будущее сверху) + +--- + +### Frontend (Angular) + +#### Этап FE-1: Модели + Сервис + +**Промт для агента:** + +> Добавь в проект поддержку ограничений секций Ганта. +> +> 1. В `pages/gantt/models/gantt-chart.model.ts` добавь: +> +> ```typescript +> export interface GanttSectionBlock { +> id: string; +> section_id: string; +> title: string; +> start_date: string; +> end_date: string; +> block_concurrency: boolean; +> created_by_user: UserInfo; +> updated_by_user: UserInfo; +> created_at: string; +> updated_at: string; +> } +> +> export interface GanttSectionBlockCreateRequest { +> title: string; +> start_date: string; +> end_date: string; +> block_concurrency?: boolean; +> } +> +> export interface GanttSectionBlockUpdateRequest { +> title?: string; +> start_date?: string; +> end_date?: string; +> block_concurrency?: boolean; +> } +> +> export interface ConflictCheck { +> has_conflicts: boolean; +> conflicts: ConflictItem[]; +> } +> +> export interface ConflictItem { +> type: 'concurrency' | 'block'; +> section_id: string; +> section_title: string; +> block_title?: string; +> start_date?: string; +> end_date?: string; +> message: string; +> dates?: string[]; +> } +> ``` +> +> 2. Добавь `max_concurrent_tasks: number` в интерфейс `GanttSection` +> 3. Добавь `blocks: GanttSectionBlock[]` в интерфейс `GanttSection` +> 4. Добавь `max_concurrent_tasks?: number` в `GanttSectionCreateRequest` и `GanttSectionUpdateRequest` +> +> 5. Создай сервис `pages/gantt/services/gantt-section-block.service.ts`: +> - Inject HttpClient +> - Методы: getBlocks(chartId, sectionId), createBlock(chartId, sectionId, data), updateBlock(chartId, sectionId, blockId, data), deleteBlock(chartId, sectionId, blockId) +> - Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService) + +#### Этап FE-2: Интеграция в модальные окна секции + +**Промт для агента:** + +> Интегрируй настройки ограничений в существующие модальные окна создания и редактирования секции Ганта. +> +> 1. Найди существующие компоненты модальных окон секции (создание/редактирование). +> +> **Окно создания секции** — добавить: +> - Числовой ввод: «Максимум одновременных задач» +> - Подсказка: «0 = без ограничений» +> - Валидация: число ≥ 0 +> - Значение по умолчанию: 0 +> - Отправляется в `GanttSectionCreateRequest` как `max_concurrent_tasks` +> +> **Окно редактирования секции** — добавить: +> - Числовой ввод: «Максимум одновременных задач» (аналогично созданию) +> - Секция «Блоки (запретные интервалы)»: +> - Таблица/список существующих блоков с колонками: Название, Начало, Конец, Блокировка (чекбокс/иконка), Действия (редактировать/удалить) +> - **Сортировка:** по `start_date` по убыванию (будущее сверху) +> - Кнопка «Добавить блок» — inline-форма: +> - title (текстовый ввод, обязательный) +> - start_date (datepicker, обязательный) +> - end_date (datepicker, обязательный) +> - block_concurrency (чекбокс: «Запретить пересечение задач») +> - Валидация: end_date >= start_date, все поля заполнены +> - Редактирование — inline или через ту же форму +> - Удаление — с подтверждением +> +> 2. При открытии окна редактирования — загрузить текущие настройки секции + блоки +> 3. При сохранении — обновить max_concurrent_tasks и сохранить изменения блоков +> 4. Инжектировать GanttChartService и GanttSectionBlockService + +#### Этап FE-3: Визуализация блоков на Ганте + +**Промт для агента:** + +> Отобрази блоки секций (GanttSectionBlock) на canvas-диаграмме Ганта. +> +> Проект использует Konva.js для рендеринга. Основной компонент: `gantt-chart-canvas`. +> +> 1. При загрузке данных диаграммы — извлечь блоки из каждой секции +> 2. В рендерере секций (canvas/timeline-renderer.ts или аналогичный) — для каждого блока: +> - Нарисовать заштрихованную область (diagonal hatch pattern) на **всю высоту секции** (все строки задач в этой секции) +> - Область ограничена по горизонтали: от start_date до end_date (в пикселях по шкале времени) +> - Цвет штриховки: полупрозрачный серый или configurable +> - Поверх штриховки — текст с названием блока (block.title) на подложке (прямоугольник с фоном, чтобы текст читался) +> 3. Блоки рендерятся **до** задач (z-index ниже), чтобы задачи были поверх +> 4. Блоки с `block_concurrency = true` и `false` визуально не отличаются (штриховка одинаковая) +> 5. При скролле/зуме — блоки пересчитываются как обычные элементы таймлайна + +#### Этап FE-4: Система Alert-ов + +**Промт для агента:** + +> Создай компонент для отображения Alert-ов о конфликтах на диаграмме Ганта. +> +> 1. Создай компонент `pages/gantt/components/gantt-conflict-alerts/` +> +> 2. Компонент размещается **над** canvas-диаграммой Ганта +> +> 3. Входные данные: массив `ConflictItem[]` (из модели) +> +> 4. Визуал: +> - Bootstrap Alert (warning) для каждого конфликта +> - Каждый Alert показывает message из ConflictItem +> - **Без кнопки закрытия** — Alert нельзя закрыть вручную +> - Alert исчезает автоматически, когда текущая дата прошла дату конфликта +> - Область **сворачиваемая**: заголовок «⚠️ Предупреждения (N)» — клик сворачивает/разворачивает список +> - По умолчанию — развёрнуто +> - При 0 конфликтов — область скрыта +> +> 5. Состояние хранится в сервисе или в компоненте диаграммы: +> - Добавление нового конфликта → area auto-expands +> - Alert удаляется из массива **автоматически**, когда текущая дата прошла дату конфликта +> - Проверка актуальности конфликтов — при каждой отрисовке / изменении данных +> - Не использовать toast — Alert-ы постоянные + +#### Этап FE-5: Проверка конфликтов при операциях с задачами + +**Промт для агента:** + +> Интегрируй проверку конфликтов во все операции с задачами на диаграмме Ганта. +> +> Проект использует interaction-handler.ts для drag/resize и формы для создания/редактирования. +> +> **Важно:** Проверка конфликтов — **только на фронтенде**, без вызова API. Используются загруженные данные секции (задачи, блоки, max_concurrent_tasks). +> +> 1. Вынеси логику проверки конфликтов `checkConflicts()` в отдельный метод в gantt-canvas.service.ts: +> - Принимает: section (GanttSection — содержит max_concurrent_tasks и blocks), tasks (GanttTask[] — задачи секции), task_id (nullable — исключить текущую задачу), start_date, end_date +> - Логика: +> a. Если section.max_concurrent_tasks > 0: посчитать кол-во задач (исключая task_id), пересекающихся с [start_date, end_date] на каждый день. Если в любой день count > max_concurrent_tasks — добавить конфликт concurrency +> b. Для каждого блока секции с block_concurrency = true, пересекающегося с [start_date, end_date] — добавить конфликт block +> - Возвращает ConflictCheck +> +> 2. После **каждой** успешной операции с задачей (создание, обновление, drag, resize): +> - Вызвать checkConflicts с параметрами задачи +> - Если has_conflicts = true — передать конфликты в GanttConflictAlertsComponent +> - Alert-ы показываются, действие **НЕ отменяется** +> +> 3. Точки интеграции: +> - **Создание задачи** (форма): после успешного POST → checkConflicts → show alerts +> - **Редактирование задачи** (форма): после успешного PUT → checkConflicts → show alerts +> - **Drag задачи** (interaction-handler.ts): после успешного обновления позиции → checkConflicts → show alerts +> - **Resize задачи** (interaction-handler.ts): после успешного обновления размера → checkConflicts → show alerts +> +> 4. При переключении диаграммы или секции — очищать Alert-ы +> 5. Alert-ы автоматически удаляются, когда текущая дата прошла дату конфликта — область скрывается, когда конфликтов не осталось + +--- + +## Порядок реализации + +| # | Этап | Сторона | Зависимости | +|---|------|---------|-------------| +| 1 | Миграция + Домен | Backend | — | +| 2 | CRUD блоков | Backend | Этап 1 | +| 3 | Обновление настроек секции | Backend | Этап 1 | +| 4 | Включение блоков в ответ секций | Backend | Этап 2 | +| 5 | Модели + Сервис | Frontend | — (можно параллельно с backend) | +| 6 | Интеграция в модальные окна | Frontend | Этапы 5 + backend 2,3 | +| 7 | Визуализация блоков на Ганте | Frontend | Этапы 5 + backend 4 | +| 8 | Система Alert-ов | Frontend | Этап 5 | +| 9 | Проверка конфликтов при операциях | Frontend | Этапы 5,7,8 | diff --git a/content/leadera/leadera-websocket-gantt.md b/content/leadera/leadera-websocket-gantt.md new file mode 100644 index 0000000..deefb81 --- /dev/null +++ b/content/leadera/leadera-websocket-gantt.md @@ -0,0 +1,746 @@ +--- +title: "Leadera — WebSocket для диаграмм Ганта" +date: 2026-04-07 +lastmod: 2026-04-07 +tags: ["leadera", "websocket", "realtime", "gantt", "architecture"] +weight: 110 +--- + +# WebSocket для диаграмм Ганта — realtime-совместное редактирование + +**Дата:** 07.04.2026 +**Статус:** Планирование +**Проект:** Leadera (dev — sand.a2v.space) + +--- + +## 1. Постановка задачи + +Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления. + +--- + +## 2. Архитектура + +``` +Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL + │ │ + │ HTTP (мутации) │ Broadcast + └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты +``` + +**Ключевой принцип:** мутации данных идут через HTTP (REST), WebSocket используется **только для доставки уведомлений**. Сервер — источник истины, клиент не может обойти проверки через WS. + +### Комнаты + +Каждый открытый Гант — это «комната» с идентификатором `chartId`. При подключении клиент подписывается на комнату. Hub рассылает события всем подписчикам комнаты. + +--- + +## 3. Backend (Go) + +### 3.1. Зависимости + +```bash +go get github.com/gorilla/websocket +``` + +### 3.2. Новые файлы — `internal/ws/` + +#### `message.go` — типы сообщений + +```go +package ws + +import "time" + +// EventType — тип события +type EventType string + +const ( + // Данные + EventSectionCreated EventType = "section_created" + EventSectionUpdated EventType = "section_updated" + EventSectionDeleted EventType = "section_deleted" + EventSectionsReordered EventType = "sections_reordered" + EventTaskCreated EventType = "task_created" + EventTaskUpdated EventType = "task_updated" + EventTaskDeleted EventType = "task_deleted" + + // Присутствие + EventUserJoined EventType = "user_joined" + EventUserLeft EventType = "user_left" + + // Безопасность / доступ + EventAccessRevoked EventType = "access_revoked" + EventChartArchived EventType = "chart_archived" + EventRoleChanged EventType = "role_changed" + EventTokenExpired EventType = "token_expired" +) + +// Event — WS-событие, отправляемое клиентам +type Event struct { + Type EventType `json:"type"` + ChartID string `json:"chartId"` + UserID string `json:"userId,omitempty"` + Payload interface{} `json:"payload,omitempty"` + Timestamp time.Time `json:"timestamp"` +} + +// IncomingMessage — сообщение от клиента (для ping/pong) +type IncomingMessage struct { + Type string `json:"type"` +} +``` + +#### `hub.go` — центральный брокер + +```go +package ws + +import ( + "sync" +) + +// Hub управляет комнатами и рассылкой событий +type Hub struct { + mu sync.RWMutex + rooms map[string]map[*Client]bool // chartId → клиенты +} + +func NewHub() *Hub { + return &Hub{ + rooms: make(map[string]map[*Client]bool), + } +} + +// Subscribe добавляет клиента в комнату +func (h *Hub) Subscribe(chartID string, client *Client) { + h.mu.Lock() + defer h.mu.Unlock() + + if h.rooms[chartID] == nil { + h.rooms[chartID] = make(map[*Client]bool) + } + h.rooms[chartID][client] = true + + // Уведомить остальных: user_joined + h.broadcastExcept(chartID, client, Event{ + Type: EventUserJoined, + ChartID: chartID, + UserID: client.UserID, + Payload: map[string]string{"username": client.Username}, + Timestamp: time.Now(), + }) +} + +// Unsubscribe удаляет клиента из комнаты +func (h *Hub) Unsubscribe(chartID string, client *Client) { + h.mu.Lock() + defer h.mu.Unlock() + + if clients, ok := h.rooms[chartID]; ok { + delete(clients, client) + if len(clients) == 0 { + delete(h.rooms, chartID) + } + } + + // Уведомить остальных: user_left + h.broadcastExcept(chartID, client, Event{ + Type: EventUserLeft, + ChartID: chartID, + UserID: client.UserID, + Timestamp: time.Now(), + }) +} + +// Broadcast рассылает событие всем клиентам в комнате +func (h *Hub) Broadcast(chartID string, event Event) { + h.mu.RLock() + defer h.mu.RUnlock() + + if clients, ok := h.rooms[chartID]; ok { + for client := range clients { + client.Send(event) + } + } +} + +// SendToUser отправляет событие конкретному пользователю во всех его комнатах +func (h *Hub) SendToUser(userID string, event Event) { + h.mu.RLock() + defer h.mu.RUnlock() + + for _, clients := range h.rooms { + for client := range clients { + if client.UserID == userID { + client.Send(event) + } + } + } +} + +// broadcastExcept рассылает всем, кроме отправителя +func (h *Hub) broadcastExcept(chartID string, sender *Client, event Event) { + if clients, ok := h.rooms[chartID]; ok { + for client := range clients { + if client != sender { + client.Send(event) + } + } + } +} +``` + +#### `client.go` — обёртка WS-соединения + +```go +package ws + +import ( + "encoding/json" + "sync" + "time" + + "github.com/gorilla/websocket" +) + +const ( + writeWait = 10 * time.Second + pongWait = 60 * time.Second + pingPeriod = (pongWait * 9) / 10 + maxMessageSize = 1024 +) + +type Client struct { + Hub *Hub + Conn *websocket.Conn + UserID string + Username string + ChartID string + SendCh chan Event + mu sync.Mutex +} + +func NewClient(hub *Hub, conn *websocket.Conn, userID, username, chartID string) *Client { + return &Client{ + Hub: hub, + Conn: conn, + UserID: userID, + Username: username, + ChartID: chartID, + SendCh: make(chan Event, 64), + } +} + +// ReadPump читает входящие сообщения (ping/pong) +func (c *Client) ReadPump() { + defer func() { + c.Hub.Unsubscribe(c.ChartID, c) + c.Conn.Close() + }() + + c.Conn.SetReadLimit(maxMessageSize) + c.Conn.SetReadDeadline(time.Now().Add(pongWait)) + c.Conn.SetPongHandler(func(string) error { + c.Conn.SetReadDeadline(time.Now().Add(pongWait)) + return nil + }) + + for { + _, message, err := c.Conn.ReadMessage() + if err != nil { + break + } + // Клиент может слать только ping, данные игнорируем + _ = message + } +} + +// WritePump отправляет события клиенту +func (c *Client) WritePump() { + ticker := time.NewTicker(pingPeriod) + defer func() { + ticker.Stop() + c.Conn.Close() + }() + + for { + select { + case event, ok := <-c.SendCh: + c.Conn.SetWriteDeadline(time.Now().Add(writeWait)) + if !ok { + c.Conn.WriteMessage(websocket.CloseMessage, []byte{}) + return + } + data, _ := json.Marshal(event) + c.mu.Lock() + c.Conn.WriteMessage(websocket.TextMessage, data) + c.mu.Unlock() + + case <-ticker.C: + c.Conn.SetWriteDeadline(time.Now().Add(writeWait)) + if err := c.Conn.WriteMessage(websocket.PingMessage, nil); err != nil { + return + } + } + } +} + +// Send ставит событие в очередь отправки +func (c *Client) Send(event Event) { + select { + case c.SendCh <- event: + default: + // Очередь полна — отключаем медленного клиента + close(c.SendCh) + } +} +``` + +### 3.3. WS endpoint — `internal/handlers/ws_handler.go` + +```go +package handlers + +import ( + "net/http" + "time" + + "app-leadera-api/internal/middleware" + "app-leadera-api/internal/ws" + + "github.com/gin-gonic/gin" + "github.com/google/uuid" + "github.com/gorilla/websocket" +) + +var upgrader = websocket.Upgrader{ + ReadBufferSize: 1024, + WriteBufferSize: 1024, + CheckOrigin: func(r *http.Request) bool { return true }, // nginx проксирует +} + +type WSHandler struct { + hub *ws.Hub + ganttMW *middleware.GanttMiddleware +} + +func NewWSHandler(hub *ws.Hub, ganttMW *middleware.GanttMiddleware) *WSHandler { + return &WSHandler{hub: hub, ganttMW: ganttMW} +} + +func (h *WSHandler) HandleGanttWS(c *gin.Context) { + // 1. Получить пользователя из контекста (auth middleware уже отработал) + userID, exists := c.Get("userID") + if !exists { + c.AbortWithStatusJSON(401, gin.H{"error": "unauthorized"}) + return + } + + // 2. Проверить доступ к chartId (gantt middleware) + chartID := c.Param("chartId") + if _, err := uuid.Parse(chartID); err != nil { + c.AbortWithStatusJSON(400, gin.H{"error": "invalid chart id"}) + return + } + // TODO: проверить через ganttMW что userID имеет доступ к этому chart + + // 3. Upgrade до WebSocket + conn, err := upgrader.Upgrade(c.Writer, c.Request, nil) + if err != nil { + return + } + + // 4. Создать клиент и подписать на комнату + client := ws.NewClient( + h.hub, conn, + userID.(string), + c.GetString("username"), + chartID, + ) + h.hub.Subscribe(chartID, client) + + // 5. Запустить pump'ы + go client.WritePump() + go client.ReadPump() +} +``` + +### 3.4. Регистрация маршрута + +В `cmd/server/main.go` или где регистрируются routes: + +```go +// После создания hub +wsHub := ws.NewHub() + +// WS endpoint +wsHandler := handlers.NewWSHandler(wsHub, ganttMW) +api.GET("/ws/gantt/:chartId", authMW.RequireAuth(), wsHandler.HandleGanttWS) + +// Передать hub в ganttHandler для broadcast'ов +ganttHandler := handlers.NewGanttHandler(ganttService, sectionService, taskService, blockService, wsHub) +``` + +### 3.5. Интеграция broadcast в handlers + +В каждый write-handler — одна строка после успешной операции: + +```go +// Пример: после успешного UpdateTask +h.hub.Broadcast(chartID, ws.Event{ + Type: ws.EventTaskUpdated, + ChartID: chartID, + UserID: userID, + Payload: updatedTask, + Timestamp: time.Now(), +}) +``` + +Точки интеграции в `gantt_handler.go`: +- `CreateGanttChart` → не нужен (пользователь только что создал, он один) +- `UpdateGanttChart` / `ArchiveGanttChart` → `chart_archived` +- `CreateSection` → `section_created` +- `UpdateSection` → `section_updated` +- `DeleteSection` → `section_deleted` +- `ReorderSections` → `sections_reordered` +- `CreateTask` → `task_created` +- `UpdateTask` → `task_updated` +- `DeleteTask` → `task_deleted` + +### 3.6. Интеграция событий безопасности + +В соответствующих service-методах: + +```go +// При исключении из space (SpaceService.RemoveMember) +wsHub.SendToUser(removedUserID, ws.Event{ + Type: ws.EventAccessRevoked, + Payload: map[string]string{"spaceId": spaceID}, +}) + +// При архивации ганта +wsHub.Broadcast(chartID, ws.Event{ + Type: ws.EventChartArchived, + ChartID: chartID, +}) + +// При изменении роли +wsHub.SendToUser(userID, ws.Event{ + Type: ws.EventRoleChanged, + Payload: map[string]string{"role": newRole}, +}) +``` + +--- + +## 4. Frontend (Angular) + +### 4.1. WebSocket сервис — `gantt-ws.service.ts` + +```typescript +// src/app/pages/gantt/services/gantt-ws.service.ts + +import { Injectable, inject, OnDestroy } from '@angular/core'; +import { Subject, Observable } from 'rxjs'; +import { environment } from '../../../environments/environment'; +import { SpaceStorageService } from '../../../core/services/space-storage.service'; +import { AuthService } from '../../../core/auth/services/auth.service'; + +export interface WSEvent { + type: string; + chartId?: string; + userId?: string; + payload?: any; + timestamp?: string; +} + +@Injectable({ providedIn: 'root' }) +export class GanttWSService implements OnDestroy { + private spaceStorage = inject(SpaceStorageService); + private auth = inject(AuthService); + + private socket: WebSocket | null = null; + private eventSubject = new Subject(); + private reconnectTimer: any; + private chartId: string | null = null; + + /** Observable для подписки на события */ + get events$(): Observable { + return this.eventSubject.asObservable(); + } + + /** Подключиться к комнате ганта */ + connect(chartId: string): void { + this.disconnect(); + this.chartId = chartId; + + const token = this.auth.getAccessToken(); + const wsUrl = this.buildWSUrl(chartId, token); + + this.socket = new WebSocket(wsUrl); + + this.socket.onopen = () => { + console.log(`[WS] Connected to gantt ${chartId}`); + }; + + this.socket.onmessage = (msg) => { + try { + const event: WSEvent = JSON.parse(msg.data); + this.eventSubject.next(event); + } catch (e) { + console.error('[WS] Parse error', e); + } + }; + + this.socket.onclose = (event) => { + console.log(`[WS] Closed: ${event.code}`); + if (event.code !== 1000) { + this.scheduleReconnect(); + } + }; + + this.socket.onerror = () => { + this.socket?.close(); + }; + } + + /** Отключиться */ + disconnect(): void { + clearTimeout(this.reconnectTimer); + if (this.socket) { + this.socket.close(1000, 'manual'); + this.socket = null; + } + this.chartId = null; + } + + ngOnDestroy(): void { + this.disconnect(); + } + + private buildWSUrl(chartId: string, token: string): string { + const base = environment.wsUrl || + location.protocol.replace('http', 'ws') + '//' + location.host; + return `${base}/api/v1/ws/gantt/${chartId}?token=${token}`; + } + + private scheduleReconnect(): void { + if (!this.chartId) return; + this.reconnectTimer = setTimeout(() => { + console.log('[WS] Reconnecting...'); + if (this.chartId) this.connect(this.chartId); + }, 3000); + } +} +``` + +### 4.2. Интеграция в gantt-chart-canvas компонент + +```typescript +// В gantt-chart-canvas.component.ts + +export class GanttChartCanvasComponent implements OnInit, OnDestroy { + private ws = inject(GanttWSService); + private onlineUsers: Set = new Set(); + private wsSubscription: Subscription | null = null; + + ngOnInit(): void { + // Подключиться к WS при загрузке ганта + this.ws.connect(this.chartId); + this.wsSubscription = this.ws.events$.subscribe(event => { + this.handleWSEvent(event); + }); + } + + ngOnDestroy(): void { + this.wsSubscription?.unsubscribe(); + this.ws.disconnect(); + } + + private handleWSEvent(event: WSEvent): void { + // Если это событие от текущего пользователя — пропускаем + // (мы уже обновили UI оптимистично или после HTTP-ответа) + if (event.userId === this.currentUserId) return; + + switch (event.type) { + case 'section_created': + this.addSectionLocal(event.payload); + this.redrawCanvas(); + break; + + case 'section_updated': + this.updateSectionLocal(event.payload); + this.redrawCanvas(); + break; + + case 'section_deleted': + this.removeSectionLocal(event.payload.id); + this.redrawCanvas(); + break; + + case 'sections_reordered': + this.reorderSectionsLocal(event.payload.ordered_ids); + this.redrawCanvas(); + break; + + case 'task_created': + this.addTaskLocal(event.payload); + this.redrawCanvas(); + break; + + case 'task_updated': + this.updateTaskLocal(event.payload); + this.redrawCanvas(); + break; + + case 'task_deleted': + this.removeTaskLocal(event.payload.id); + this.redrawCanvas(); + break; + + case 'user_joined': + this.onlineUsers.add(event.userId!); + this.showOnlineIndicator(); + break; + + case 'user_left': + this.onlineUsers.delete(event.userId!); + this.showOnlineIndicator(); + break; + + // === Безопасность === + case 'access_revoked': + this.router.navigate(['/gantt'], { + state: { alert: 'Доступ к пространству был отозван' } + }); + break; + + case 'chart_archived': + this.router.navigate(['/gantt'], { + state: { alert: 'Диаграмма была заархивирована' } + }); + break; + + case 'role_changed': + this.currentRole = event.payload.role; + this.updateEditableState(); + break; + + case 'token_expired': + this.router.navigate(['/auth/login']); + break; + } + } + + private redrawCanvas(): void { + // Перерисовать Konva canvas с обновлёнными данными + } +} +``` + +### 4.3. Индикатор онлайн-пользователей + +Добавить в шаблон canvas-компонента: + +```html + +
+ + {{ onlineUsers.size }} онлайн +
+``` + +--- + +## 5. Безопасность + +### 5.1. Авторизация при подключении + +| Этап | Проверка | +|------|----------| +| WS Handshake | JWT в query-параметре `?token=...` | +| Подписка на комнату | Проверка membership в space | +| Каждое broadcast-событие | Hub знает userId каждого клиента | + +### 5.2. Сценарии отзыва доступа + +| Событие | Триггер | Действие на клиенте | +|---------|---------|---------------------| +| `access_revoked` | Исключение из space | Редирект на список гантов | +| `chart_archived` | Архивация ганта | Редирект на список гантов | +| `role_changed` | Смена роли (editor→viewer) | Отключить редактирование | +| `token_expired` | Токен протух | Редирект на логин | + +### 5.3. Защита от злоупотреблений + +| Угроза | Мера | +|--------|------| +| Спам WS-сообщений | Rate limit: 30 msg/min на клиента, `ReadLimit` в gorilla/websocket | +| Подключение без прав | Проверка space membership при handshake | +| Истёкший токен | Ping/pong + периодическая проверка JWT (раз в 5 мин) | +| XSS через WS | Payload — JSON, sanitize имён на frontend | +| Мутации через WS | WS **только для чтения** (уведомления). Мутации — через HTTP API с полной валидацией | + +### 5.4. Nginx конфигурация + +В конфиг `sand.a2v.space` добавить: + +```nginx +# WebSocket проксирование +location /api/v1/ws/ { + proxy_pass http://127.0.0.1:8080; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade"; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_read_timeout 86400s; # 24h для long-lived WS + proxy_send_timeout 86400s; +} +``` + +--- + +## 6. Оценка трудозатрат + +| Компонент | Строки кода | Время | +|-----------|-------------|-------| +| `internal/ws/` (hub, client, message) | ~200 | 2-3 часа | +| `ws_handler.go` (endpoint) | ~60 | 30 мин | +| Интеграция broadcast в handlers | ~20 (по строке на endpoint) | 30 мин | +| События безопасности в services | ~30 | 30 мин | +| `gantt-ws.service.ts` (Angular) | ~80 | 1 час | +| Интеграция в canvas-компонент | ~80 | 1-2 часа | +| Индикатор онлайн | ~30 | 30 мин | +| Nginx конфигурация | ~10 | 10 мин | +| Тестирование | — | 2-3 часа | +| **Итого** | **~510 строк** | **~1-2 дня** | + +--- + +## 7. Порядок реализации + +1. **Backend: `internal/ws/`** — hub, client, message types +2. **Backend: WS endpoint** — handler + route +3. **Backend: Broadcast в handlers** — интеграция в существующие CRUD-эндпоинты +4. **Backend: События безопасности** — access_revoked, chart_archived, role_changed +5. **Nginx: WS location** — проксирование WebSocket +6. **Frontend: WS service** — подключение, реконнект, парсинг событий +7. **Frontend: Интеграция в canvas** — обработка событий, обновление Konva +8. **Frontend: Индикатор онлайн** — визуальная обратная связь +9. **Тестирование** — многопользовательский сценарий, отзыв прав, обрывы связи + +--- + +## 8. Дальнейшие улучшения (после MVP) + +- **Cursor других пользователей** — показывать позицию курсора на таймлайне +- **Блокировка элемента** — «кто-то редактирует эту задачу» (optimistic locking через WS) +- **Чат в ганте** — комментарии к задачам прямо на канвасе +- **History/undo** — откат изменений с визуальной историей +- **Уведомления** — push-уведомления при @mention в комментариях к задачам diff --git a/hugo.toml b/hugo.toml index dce1d6d..e3daea0 100644 --- a/hugo.toml +++ b/hugo.toml @@ -30,18 +30,22 @@ canonifyURLs = false name = "Планы" url = "/plans/" weight = 3 + [[menu.main]] + name = "Leadera" + url = "/leadera/" + weight = 4 [[menu.main]] name = "Инструкции" url = "/guides/" - weight = 4 + weight = 5 [[menu.main]] name = "Креды" url = "/creds/" - weight = 5 + weight = 6 [[menu.main]] name = "Личный сайт" url = "/personal-site/" - weight = 6 + weight = 7 [outputs] home = ["HTML", "JSON"] diff --git a/public/categories/index.html b/public/categories/index.html index 5171dd6..71e6338 100644 --- a/public/categories/index.html +++ b/public/categories/index.html @@ -38,6 +38,10 @@ Планы +
  • + Leadera +
    • +
  • Инструкции
    • @@ -94,6 +98,8 @@
  • Планы
    • +
  • Leadera
    • +
  • Инструкции
  • Креды
    • diff --git a/public/creds/docs-a2v-space-auth/index.html b/public/creds/docs-a2v-space-auth/index.html index 29f29ce..b5ec406 100644 --- a/public/creds/docs-a2v-space-auth/index.html +++ b/public/creds/docs-a2v-space-auth/index.html @@ -38,6 +38,10 @@ Планы +
  • + Leadera +
    • +
  • Инструкции
    • @@ -135,6 +139,15 @@

    docs.a2v.space Basic Auth

    +
    + + 📁 ~/Projects/docs-a2v/content/creds/docs-a2v-space-auth.md + + +
    +

    Учетные данные для доступа к docs.a2v.space

    diff --git a/public/creds/eversolo-companion-postgres/index.html b/public/creds/eversolo-companion-postgres/index.html index 8200609..83bf566 100644 --- a/public/creds/eversolo-companion-postgres/index.html +++ b/public/creds/eversolo-companion-postgres/index.html @@ -38,6 +38,10 @@ Планы +
  • + Leadera +
    • +
  • Инструкции
    • @@ -135,6 +139,15 @@

    Eversolo Companion PostgreSQL

    +
    + + 📁 ~/Projects/docs-a2v/content/creds/eversolo-companion-postgres.md + + +
    +

    Учетные данные для базы данных Eversolo Companion

    diff --git a/public/creds/index.html b/public/creds/index.html index d3ced27..94981cf 100644 --- a/public/creds/index.html +++ b/public/creds/index.html @@ -38,6 +38,10 @@ Планы +
  • + Leadera +
    • +
  • Инструкции
    • @@ -142,97 +146,23 @@
    -

    docs.a2v.space Basic Auth

    +

    VPS reg.ru

    -

    Учетные данные для доступа к docs.a2v.space

    +

    VPS хостинг (реверс-прокси)

    +

    Сервис: VPS

    + -
    - QmFzaWMgQXV0aGVudGljYXRpb24gVXNlcm5hbWU6IGFnYWx0c292YXYgUGFzc3dvcmQ6IE1hZ2FtZXQ3ODchINCa0L7QvdGE0LjQs9GD0YDQsNGG0LjRjyBOZ2lueCBzZXJ2ZXIgeyBsaXN0ZW4gODA5MTsgc2VydmVyX25hbWUgZG9jcy5hMnYuc3BhY2U7IGF1dGhfYmFzaWMgJiMzNDtSZXN0cmljdGVkIEFjY2VzcyYjMzQ7OyBhdXRoX2Jhc2ljX3VzZXJfZmlsZSAvZXRjL25naW54Ly5odHBhc3N3ZDsgfSDQlNC+0YHRgtGD0L8gVVJMOiBodHRwczovL2RvY3MuYTJ2LnNwYWNlICjRh9C10YDQtdC3IHJldmVyc2UgcHJveHkpIExvY2FsOiBodHRwOi8vbG9jYWxob3N0OjgwOTEgKNC00LvRjyDRgNCw0LfRgNCw0LHQvtGC0LrQuCkgQXV0aDog0LLRgdC10LPQtNCwINGC0YDQtdCx0YPQtdGC0YHRjyDQnNCw0YHRgtC10YAt0L/QsNGA0L7Qu9GMINC00LvRjyDRiNC40YTRgNC+0LLQsNC90LjRjyDQktCw0LbQvdC+OiDQn9Cw0YDQvtC70Ywg0LTQu9GPINGA0LDRgdGI0LjRhNGA0L7QstC60Lgg0YTQsNC50LvQvtCyINCyINGA0LDQt9C00LXQu9C1IGNyZWRzLwpNYXN0ZXIgUGFzc3dvcmQ6IFBvcG9sb2thMTYhINCo0LjRhNGA0L7QstCw0L3QuNC1INCQ0LvQs9C+0YDQuNGC0Lw6IEFFUy0yNTYtR0NNINCl0YDQsNC90LjQu9C40YnQtTogY2xpZW50LXNpZGUgZW5jcnlwdGlvbiDQpNCw0LnQu9GLINGI0LjRhNGA0YPRjtGC0YHRjyDQv9GA0Lgg0YHQvtGF0YDQsNC90LXQvdC40Lgg0KDQsNGB0YjQuNGE0YDQvtCy0YvQstCw0Y7RgtGB0Y8g0L/RgNC4INGH0YLQtdC90LjQuCA= +
    + CklwWVhMTXRnQ0ZsR1E1NTBEWkNManEzN1Zzbk5xTDA4Um4wM2lSUzdrUTdvekJaTnNpWnlTRnpEQXZZaDR4SUh5dFJEeTBTejBLR1VYZWtyMFMrY05pSnNtdFo4a2owUGQwSmhldmh4VE1aRjJraEZ2cy9MRldvVEw1WndBSjM0eS9xZkx3MmdhV1g5MFZaRHUwd08rS2VBUWVYaHJXbW9sLzJ6VWxmV1gxQWloeVlxRDJ2UnoraDJGY2pEOHViWU9YRzM1UHlYN09sVjFIUFhnRHY1WC9iRk5yeHpQYzg2N1VPd0I0YUd4WTlhCgoK
    - -
    -
    - -
    -
    -
    -

    Eversolo Companion PostgreSQL

    - -

    Учетные данные для базы данных Eversolo Companion

    - - - -
    - RG9ja2VyIENvbXBvc2Ug0LrRgNC10LTRiyAofi9Qcm9qZWN0cy9ldmVyc29sby1jb21wYW5pb24vZG9ja2VyLWNvbXBvc2UueW1sKSBzZXJ2aWNlczogcG9zdGdyZXM6IGVudmlyb25tZW50OiBQT1NUR1JFU19VU0VSOiBwb3N0Z3JlcyBQT1NUR1JFU19QQVNTV09SRDogcGFzc3dvcmQgUE9TVEdSRVNfREI6IGV2ZXJzb2xvINCb0L7QutCw0LvRjNC90YvQtSDQutGA0LXQtNGLICguZW52INGE0LDQudC7KSBQT1NUR1JFU19VU0VSPXBvc3RncmVzIFBPU1RHUkVTX1BBU1NXT1JEPXBhc3N3b3JkIFBPU1RHUkVTX0RCPWV2ZXJzb2xvINCl0L7RgdGC0LjQvdCzIEhvc3Q6IGxvY2FsaG9zdCBQb3J0OiA1NDMzIERhdGFiYXNlOiBldmVyc29sbyDQkdC10LfQvtC/0LDRgdC90L7RgdGC0Ywg0JjRgdC/0L7Qu9GM0LfRg9C50YLQtSDRgNCw0LfQvdGL0LUg0L/QsNGA0L7Qu9C4INC00LvRjyBwcm9kdWN0aW9uINCS0LrQu9GO0YfQuNGC0LUgU1NMINC00LvRjyDRg9C00LDQu9C10L3QvdC+0LPQviDQv9C+0LTQutC70Y7Rh9C10L3QuNGPINCg0LXQs9GD0LvRj9GA0L3QviDQtNC10LvQsNC50YLQtSDQsdGN0LrQsNC/0Ysg -
    - - - - -
    -
    -
    - -
    -
    -
    -

    Mac Studio — leadera-api БД (docker-compose)

    - -

    PostgreSQL (docker-compose) для Leadera

    - - -

    Сервис: PostgreSQL

    - - -
    - Ck5ZVks0UEVHd21PSG1BbkdrOElBVWMrbHlGSnRuRUF2WDZaZGRCcm8vSUxSV0hPWEJHWXl3Z2dsRnZRWjE4QkxETGI1RHVBOEdQQUlkQi9Md1RIUlhZTzBLc210bFpRVldHRWVlWGxYQW9FWHBhNXRoZW9PUWhlYmtXNkxtaUt5TkdBVlcyejlySzNuejZObnp0WWRuNDlMdkdNanJIdVI0SXdDTGJsL3BZYTk2Q1BOUm54R0RGbGR1Rmk4bE1Tc3BNMHJCRmkvYlpoTkdoenkzNlZpQ2wrYUtyNVA5Y2xlMFp2TThFOGF2LzZjNUpqZ0R0ODhRRkkzVllkVGFUQ0UwK3VIc1hsbkpON1FnZy9LSDdrRAoKCg== -
    - - - - -
    -
    -
    - -
    -
    -
    -

    Mac Studio — leadera-api БД (локальная)

    - -

    PostgreSQL (Docker) для Leadera

    - - -

    Сервис: PostgreSQL

    - - -
    - CnA3SXc3WTN6Ymoxa0xCY2JPWEdvTzI3b0R3Rjg1QWh4Qlc3c2FUNTM4aHhpMG9nSnB5RmVNNDlHRHVMSHp4dXlrbnZkTkMvcngzdGI0QUZuR2tDZUhTcnJDbWorVks4Wnh0N3VqZXVqVkpTUnVPZWVVbHNxa0hkbG1haVhsMktRa25ySXNxVkNpM1RubjBWNXFjRnh2bysxS3RjK3N1ckY2YkJwV3JUSHpXVjVtTHRXVmZENkM2a3Z2UC9VRmxkRkJENnYrRlFzNzl5Zm9PZS9qL2JVcnRwdDZ2NVZuZGJiQm1oVUFRY3kxQlYycnBYeE8zNzNkVGNMUTZjb1JXa3QvUkZvCgoK -
    - - - -
    @@ -268,23 +198,97 @@
    -

    VPS reg.ru

    +

    Mac Studio — leadera-api БД (локальная)

    -

    VPS хостинг (реверс-прокси)

    +

    PostgreSQL (Docker) для Leadera

    -

    Сервис: VPS

    +

    Сервис: PostgreSQL

    -
    - CklwWVhMTXRnQ0ZsR1E1NTBEWkNManEzN1Zzbk5xTDA4Um4wM2lSUzdrUTdvekJaTnNpWnlTRnpEQXZZaDR4SUh5dFJEeTBTejBLR1VYZWtyMFMrY05pSnNtdFo4a2owUGQwSmhldmh4VE1aRjJraEZ2cy9MRldvVEw1WndBSjM0eS9xZkx3MmdhV1g5MFZaRHUwd08rS2VBUWVYaHJXbW9sLzJ6VWxmV1gxQWloeVlxRDJ2UnoraDJGY2pEOHViWU9YRzM1UHlYN09sVjFIUFhnRHY1WC9iRk5yeHpQYzg2N1VPd0I0YUd4WTlhCgoK +
    + CnA3SXc3WTN6Ymoxa0xCY2JPWEdvTzI3b0R3Rjg1QWh4Qlc3c2FUNTM4aHhpMG9nSnB5RmVNNDlHRHVMSHp4dXlrbnZkTkMvcngzdGI0QUZuR2tDZUhTcnJDbWorVks4Wnh0N3VqZXVqVkpTUnVPZWVVbHNxa0hkbG1haVhsMktRa25ySXNxVkNpM1RubjBWNXFjRnh2bysxS3RjK3N1ckY2YkJwV3JUSHpXVjVtTHRXVmZENkM2a3Z2UC9VRmxkRkJENnYrRlFzNzl5Zm9PZS9qL2JVcnRwdDZ2NVZuZGJiQm1oVUFRY3kxQlYycnBYeE8zNzNkVGNMUTZjb1JXa3QvUkZvCgoK
    - +
    +
    + +
    +
    +
    +

    Mac Studio — leadera-api БД (docker-compose)

    + +

    PostgreSQL (docker-compose) для Leadera

    + + +

    Сервис: PostgreSQL

    + + +
    + Ck5ZVks0UEVHd21PSG1BbkdrOElBVWMrbHlGSnRuRUF2WDZaZGRCcm8vSUxSV0hPWEJHWXl3Z2dsRnZRWjE4QkxETGI1RHVBOEdQQUlkQi9Md1RIUlhZTzBLc210bFpRVldHRWVlWGxYQW9FWHBhNXRoZW9PUWhlYmtXNkxtaUt5TkdBVlcyejlySzNuejZObnp0WWRuNDlMdkdNanJIdVI0SXdDTGJsL3BZYTk2Q1BOUm54R0RGbGR1Rmk4bE1Tc3BNMHJCRmkvYlpoTkdoenkzNlZpQ2wrYUtyNVA5Y2xlMFp2TThFOGF2LzZjNUpqZ0R0ODhRRkkzVllkVGFUQ0UwK3VIc1hsbkpON1FnZy9LSDdrRAoKCg== +
    + + + + +
    +
    +
    + +
    +
    +
    +

    Eversolo Companion PostgreSQL

    + +

    Учетные данные для базы данных Eversolo Companion

    + + + +
    + RG9ja2VyIENvbXBvc2Ug0LrRgNC10LTRiyAofi9Qcm9qZWN0cy9ldmVyc29sby1jb21wYW5pb24vZG9ja2VyLWNvbXBvc2UueW1sKSBzZXJ2aWNlczogcG9zdGdyZXM6IGVudmlyb25tZW50OiBQT1NUR1JFU19VU0VSOiBwb3N0Z3JlcyBQT1NUR1JFU19QQVNTV09SRDogcGFzc3dvcmQgUE9TVEdSRVNfREI6IGV2ZXJzb2xvINCb0L7QutCw0LvRjNC90YvQtSDQutGA0LXQtNGLICguZW52INGE0LDQudC7KSBQT1NUR1JFU19VU0VSPXBvc3RncmVzIFBPU1RHUkVTX1BBU1NXT1JEPXBhc3N3b3JkIFBPU1RHUkVTX0RCPWV2ZXJzb2xvINCl0L7RgdGC0LjQvdCzIEhvc3Q6IGxvY2FsaG9zdCBQb3J0OiA1NDMzIERhdGFiYXNlOiBldmVyc29sbyDQkdC10LfQvtC/0LDRgdC90L7RgdGC0Ywg0JjRgdC/0L7Qu9GM0LfRg9C50YLQtSDRgNCw0LfQvdGL0LUg0L/QsNGA0L7Qu9C4INC00LvRjyBwcm9kdWN0aW9uINCS0LrQu9GO0YfQuNGC0LUgU1NMINC00LvRjyDRg9C00LDQu9C10L3QvdC+0LPQviDQv9C+0LTQutC70Y7Rh9C10L3QuNGPINCg0LXQs9GD0LvRj9GA0L3QviDQtNC10LvQsNC50YLQtSDQsdGN0LrQsNC/0Ysg +
    + + + + +
    +
    +
    + +
    +
    +
    +

    docs.a2v.space Basic Auth

    + +

    Учетные данные для доступа к docs.a2v.space

    + + + +
    + QmFzaWMgQXV0aGVudGljYXRpb24gVXNlcm5hbWU6IGFnYWx0c292YXYgUGFzc3dvcmQ6IE1hZ2FtZXQ3ODchINCa0L7QvdGE0LjQs9GD0YDQsNGG0LjRjyBOZ2lueCBzZXJ2ZXIgeyBsaXN0ZW4gODA5MTsgc2VydmVyX25hbWUgZG9jcy5hMnYuc3BhY2U7IGF1dGhfYmFzaWMgJiMzNDtSZXN0cmljdGVkIEFjY2VzcyYjMzQ7OyBhdXRoX2Jhc2ljX3VzZXJfZmlsZSAvZXRjL25naW54Ly5odHBhc3N3ZDsgfSDQlNC+0YHRgtGD0L8gVVJMOiBodHRwczovL2RvY3MuYTJ2LnNwYWNlICjRh9C10YDQtdC3IHJldmVyc2UgcHJveHkpIExvY2FsOiBodHRwOi8vbG9jYWxob3N0OjgwOTEgKNC00LvRjyDRgNCw0LfRgNCw0LHQvtGC0LrQuCkgQXV0aDog0LLRgdC10LPQtNCwINGC0YDQtdCx0YPQtdGC0YHRjyDQnNCw0YHRgtC10YAt0L/QsNGA0L7Qu9GMINC00LvRjyDRiNC40YTRgNC+0LLQsNC90LjRjyDQktCw0LbQvdC+OiDQn9Cw0YDQvtC70Ywg0LTQu9GPINGA0LDRgdGI0LjRhNGA0L7QstC60Lgg0YTQsNC50LvQvtCyINCyINGA0LDQt9C00LXQu9C1IGNyZWRzLwpNYXN0ZXIgUGFzc3dvcmQ6IFBvcG9sb2thMTYhINCo0LjRhNGA0L7QstCw0L3QuNC1INCQ0LvQs9C+0YDQuNGC0Lw6IEFFUy0yNTYtR0NNINCl0YDQsNC90LjQu9C40YnQtTogY2xpZW50LXNpZGUgZW5jcnlwdGlvbiDQpNCw0LnQu9GLINGI0LjRhNGA0YPRjtGC0YHRjyDQv9GA0Lgg0YHQvtGF0YDQsNC90LXQvdC40Lgg0KDQsNGB0YjQuNGE0YDQvtCy0YvQstCw0Y7RgtGB0Y8g0L/RgNC4INGH0YLQtdC90LjQuCA= +
    + + + +
    diff --git a/public/creds/leadera-db-docker/index.html b/public/creds/leadera-db-docker/index.html index 6db90df..f6c3df7 100644 --- a/public/creds/leadera-db-docker/index.html +++ b/public/creds/leadera-db-docker/index.html @@ -38,6 +38,10 @@ Планы +
  • + Leadera +
    • +
  • Инструкции
    • @@ -135,6 +139,15 @@

    Mac Studio — leadera-api БД (docker-compose)

    +
    + + 📁 ~/Projects/docs-a2v/content/creds/leadera-db-docker.md + + +
    +

    PostgreSQL (docker-compose) для Leadera

    diff --git a/public/creds/leadera-db-local/index.html b/public/creds/leadera-db-local/index.html index 29d97c9..e6ab620 100644 --- a/public/creds/leadera-db-local/index.html +++ b/public/creds/leadera-db-local/index.html @@ -38,6 +38,10 @@ Планы +
  • + Leadera +
    • +
  • Инструкции
    • @@ -135,6 +139,15 @@

    Mac Studio — leadera-api БД (локальная)

    +
    + + 📁 ~/Projects/docs-a2v/content/creds/leadera-db-local.md + + +
    +

    PostgreSQL (Docker) для Leadera

    diff --git a/public/creds/vpn-vps/index.html b/public/creds/vpn-vps/index.html index 69eb748..14de86b 100644 --- a/public/creds/vpn-vps/index.html +++ b/public/creds/vpn-vps/index.html @@ -38,6 +38,10 @@ Планы +
  • + Leadera +
    • +
  • Инструкции
    • @@ -135,6 +139,15 @@

    VPN VPS

    +
    + + 📁 ~/Projects/docs-a2v/content/creds/vpn-vps.md + + +
    +

    VPN сервер (Amnezia)

    diff --git a/public/creds/vps-reg-ru/index.html b/public/creds/vps-reg-ru/index.html index 53183de..600c6a4 100644 --- a/public/creds/vps-reg-ru/index.html +++ b/public/creds/vps-reg-ru/index.html @@ -38,6 +38,10 @@ Планы +
  • + Leadera +
    • +
  • Инструкции
    • @@ -135,6 +139,15 @@

    VPS reg.ru

    +
    + + 📁 ~/Projects/docs-a2v/content/creds/vps-reg-ru.md + + +
    +

    VPS хостинг (реверс-прокси)

    diff --git a/public/css/custom.css b/public/css/custom.css index 6f13908..632b8b7 100644 --- a/public/css/custom.css +++ b/public/css/custom.css @@ -270,6 +270,27 @@ body { font-family: monospace; } +/* Source path */ +.source-path { + background-color: var(--warm-bg); + border: 1px solid #e0d8cc; + border-radius: 4px; + padding: 0.4rem 0.75rem; + display: inline-block; +} +.source-path code { + font-size: 0.82em; + color: var(--warm-gray); +} +.source-path .btn-outline-secondary { + font-size: 0.75rem; + border-color: #d0c8bc; +} +.source-path .btn-outline-secondary:hover { + background-color: var(--warm-primary); + border-color: var(--warm-primary); +} + /* Article styles */ .article-content { background-color: var(--warm-white); diff --git a/public/diary/2026-03-29/index.html b/public/diary/2026-03-29/index.html index 89b370e..b24d19f 100644 --- a/public/diary/2026-03-29/index.html +++ b/public/diary/2026-03-29/index.html @@ -38,6 +38,10 @@ Планы +
  • + Leadera +
    • +
  • Инструкции
    • @@ -205,6 +209,15 @@

    29 марта 2026

    29.03.2026

    +
    + + 📁 ~/Projects/docs-a2v/content/diary/2026-03-29.md + + +
    +

    Timeline

      diff --git a/public/diary/2026-03-30/index.html b/public/diary/2026-03-30/index.html index 5745446..781158e 100644 --- a/public/diary/2026-03-30/index.html +++ b/public/diary/2026-03-30/index.html @@ -38,6 +38,10 @@ Планы +
    • + Leadera +
      • +
    • Инструкции
      • @@ -205,6 +209,15 @@

      30 марта 2026

      30.03.2026

      +
      + + 📁 ~/Projects/docs-a2v/content/diary/2026-03-30.md + + +
      +

      Timeline

        diff --git a/public/diary/2026-03-31/index.html b/public/diary/2026-03-31/index.html index 301aae5..354bdbd 100644 --- a/public/diary/2026-03-31/index.html +++ b/public/diary/2026-03-31/index.html @@ -38,6 +38,10 @@ Планы +
      • + Leadera +
        • +
      • Инструкции
        • @@ -205,6 +209,15 @@

        31 марта 2026

        31.03.2026

        +
        + + 📁 ~/Projects/docs-a2v/content/diary/2026-03-31.md + + +
        +

        Timeline

          diff --git a/public/diary/index.html b/public/diary/index.html index 059e695..149b240 100644 --- a/public/diary/index.html +++ b/public/diary/index.html @@ -38,6 +38,10 @@ Планы +
        • + Leadera +
          • +
        • Инструкции
          • diff --git a/public/guides/claw-a2v-space/index.html b/public/guides/claw-a2v-space/index.html index 9bd5075..3d29280 100644 --- a/public/guides/claw-a2v-space/index.html +++ b/public/guides/claw-a2v-space/index.html @@ -38,6 +38,10 @@ Планы +
        • + Leadera +
          • +
        • Инструкции
          • @@ -110,16 +114,6 @@ - - - - - - - - - - @@ -166,14 +160,6 @@
          Теги
            -
          • audit
            • - -
          • leadera
            • - -
          • security
            • - -
          • architecture
            • -
          • ssh
          • tunnel
            • @@ -209,6 +195,15 @@

            Подключение claw.a2v.space (OpenClaw)

            +
            + + 📁 ~/Projects/docs-a2v/content/guides/claw-a2v-space.md + + +
            +
            diff --git a/public/guides/code-a2v-space/index.html b/public/guides/code-a2v-space/index.html index 0a30455..cd671e2 100644 --- a/public/guides/code-a2v-space/index.html +++ b/public/guides/code-a2v-space/index.html @@ -38,6 +38,10 @@ Планы +
          • + Leadera +
            • +
          • Инструкции
            • @@ -110,16 +114,6 @@ - - - - - - - - - - @@ -166,14 +160,6 @@
            Теги
              -
            • audit
              • - -
            • leadera
              • - -
            • security
              • - -
            • architecture
              • -
            • ssh
            • tunnel
              • @@ -209,6 +195,15 @@

              Подключение code.a2v.space (OpenCode)

              +
              + + 📁 ~/Projects/docs-a2v/content/guides/code-a2v-space.md + + +
              +
              diff --git a/public/guides/index.html b/public/guides/index.html index b509620..fd5fca9 100644 --- a/public/guides/index.html +++ b/public/guides/index.html @@ -38,6 +38,10 @@ Планы +
            • + Leadera +
              • +
            • Инструкции
              • @@ -110,16 +114,6 @@ - - - - - - - - - - @@ -166,14 +160,6 @@
              Теги
                -
              • audit
                • - -
              • leadera
                • - -
              • security
                • - -
              • architecture
                • -
              • ssh
              • tunnel
                • @@ -215,225 +201,82 @@
                -

                Аудит Leadera — полный отчёт

                -

                Аудит проекта Leadera

                -

                Дата: 30.03.2026
                -Версия: pre-production, миграции 1–5

                -
                -

                1. Обзор проекта

                -

                Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.

                -

                Стек

                +

                Подключение sand.a2v.space (Leadera Project)

                +

                Архитектура

                +
                Mac Studio
+    ├─ Frontend (Angular) :4200 (pm2: leadera-fe)
+    ├─ Backend (Go) :8080 (pm2: leadera-api)
+    └─ PostgreSQL 16 в Docker (Colima, container: app-leadera-db)
+        → autossh SSH-туннель (-R 8082:localhost:4200 -R 8083:localhost:8080)
+    → VPS 95.163.232.9
+    → nginx HTTPS
+    → https://sand.a2v.space
+

                Параметры

                - + + + - - + + + + - - - - - - + + + +
                КомпонентТехнологииЛокальный портТуннель портpm2 имя
                BackendGo 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256)Frontend (Angular)42008082leadera-fe
                FrontendAngular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals
                ИнфраструктураDocker (Colima), pm2, nginx reverse proxy, VPS reg.ruBackend (Go)80808083leadera-api
                -

                Доменная модель

                -
                User ──┬── Space (через space_members с role)
-        │
-        └── GanttChart (принадлежит Space)
-              ├── GanttSection
-              └── GanttTask
-

                Роли: admin, editor, viewer — назначаются на уровне Space через таблицу space_members.

                - -
                - - audit - - leadera - - security - - architecture - -
                - -
                -
                -
                - -
                -
                -
                -

                SSH туннели для VPS reverse proxy

                -

                Настройка SSH туннелей

                -

                VPS reg.ru (95.163.232.9)

                -
                # На Mac Studio: создать туннель для каждого сервиса
-ssh -N -R 8080:localhost:8080 root@95.163.232.9    # leadera-api
-ssh -N -R 8081:localhost:4096 root@95.163.232.9    # opencode
-ssh -N -R 8082:localhost:4200 root@95.163.232.9    # leadera-fe
-ssh -N -R 8083:localhost:8080 root@95.163.232.9    # docs-a2v
-

                Настройка launchd plist

                -

                Файл: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist

                -
                <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-    <key>Label</key>
-    <string>com.openclaw.sshtunnel</string>
-    <key>ProgramArguments</key>
-    <array>
-        <string>ssh</string>
-        <string>-N</string>
-        <string>-R</string>
-        <string>8080:localhost:8080</string>
-        <string>root@95.163.232.9</string>
-    </array>
-    <key>RunAtLoad</key>
-    <true/>
-    <key>KeepAlive</key>
-    <true/>
-</dict>
-</plist>
-

                Автозапуск

                -
                # Загрузить plist
-launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist
-
-# Проверить статус
-launchctl list | grep sshtunnel
-
-# Удалить (при необходимости)
-launchctl unload ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist
-

                Доступ к сервисам

                -

                Через reverse proxy на VPS:

                - -
                - - ssh - - tunnel - - vps - - reverse-proxy - -
                - -
                -
                -
                - -
                -
                -
                -

                Настройка VPS как реверс-прокси

                -

                Общая схема

                -
                Mac Studio (локальная сеть)
-    → autossh (SSH-туннели)
-    → VPS 95.163.232.9 (Debian)
-    → nginx (HTTPS reverse proxy)
-    → интернет
-

                Что нужно на VPS

                -

                1. Установленные пакеты

                -
                apt update
-apt install nginx certbot python3-certbot-nginx
-

                2. SSH-доступ

                -
                  -
                • Авторизация только по ключам
                  • -
                • Публичный ключ с Mac Studio добавлен в /root/.ssh/authorized_keys
                  • -
                -

                3. nginx

                -

                Для каждого домена создать server block:

                -
                  -
                • HTTP → редирект на HTTPS
                  • -
                • HTTPS с SSL-сертификатом Let’s Encrypt
                  • -
                • proxy_pass на localhost-порт туннеля
                  • -
                -

                Пример структуры:

                - -
                - - vps - - nginx - - ssh - - reverse-proxy - - devops - -
                - -
                -
                -
                - -
                -
                -
                -

                Подключение claw.a2v.space (OpenClaw)

                -

                Архитектура

                -
                Mac Studio (192.168.0.37:18789)
-    → autossh SSH-туннель
-    → VPS 95.163.232.9:8080
-    → nginx HTTPS
-    → https://claw.a2v.space
-

                Шаги настройки

                -

                1. DNS

                -

                A-запись claw.a2v.space → 95.163.232.9

                -

                NS-серверы: ns1.hosting.reg.ru, ns2.hosting.reg.ru

                -

                2. Mac Studio — OpenClaw

                -
                  -
                • Порт: 18789
                  • -
                • Конфиг: ~/.openclaw/openclaw.json
                  • -
                -

                3. SSH-туннель (launchd)

                -

                Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist

                -

                Ключевой флаг: -R 8080:localhost:18789

                -

                4. VPS — nginx конфиг

                +

                SSL сертификат: /etc/letsencrypt/live/sand.a2v.space/

                +

                nginx конфиг

                server {
     listen 80;
-    server_name claw.a2v.space;
+    server_name sand.a2v.space;
     return 301 https://$server_name$request_uri;
 }
 
 server {
     listen 443 ssl;
-    server_name claw.a2v.space;
+    server_name sand.a2v.space;
 
-    ssl_certificate /etc/letsencrypt/live/claw.a2v.space/fullchain.pem;
-    ssl_certificate_key /etc/letsencrypt/live/claw.a2v.space/privkey.pem;
+    ssl_certificate /etc/letsencrypt/live/sand.a2v.space/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/sand.a2v.space/privkey.pem;
+
+    location /api {
+        proxy_pass http://127.0.0.1:8083;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
 
     location / {
-        proxy_pass http://127.0.0.1:8080;
+        proxy_pass http://127.0.0.1:8082;
         proxy_set_header Host $host;
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto $scheme;
     }
 }
-

                5. SSL-сертификат

                -
                certbot certonly --nginx -d claw.a2v.space
-

                6. OpenClaw config

                -
                {
-  "allowedOrigins": ["https://claw.a2v.space"],
-  "trustedProxies": ["127.0.0.1"]
-}
-

                +

                База данных

                +

                PostgreSQL 16 в Docker через Colima:

                - openclaw + angular - ssh + go + + docker nginx @@ -534,82 +377,61 @@
                -

                Подключение sand.a2v.space (Leadera Project)

                +

                Подключение claw.a2v.space (OpenClaw)

                Архитектура

                -
                Mac Studio
-    ├─ Frontend (Angular) :4200 (pm2: leadera-fe)
-    ├─ Backend (Go) :8080 (pm2: leadera-api)
-    └─ PostgreSQL 16 в Docker (Colima, container: app-leadera-db)
-        → autossh SSH-туннель (-R 8082:localhost:4200 -R 8083:localhost:8080)
-    → VPS 95.163.232.9
+
                Mac Studio (192.168.0.37:18789)
+    → autossh SSH-туннель
+    → VPS 95.163.232.9:8080
     → nginx HTTPS
-    → https://sand.a2v.space
-
                Параметры
                
-
-  
-      
-          
-          
-          
-          
-      
-  
-  
-      
-          
-          
-          
-          
-      
-      
-          
-          
-          
-          
-      
-  
-
                КомпонентЛокальный портТуннель портpm2 имя
                Frontend (Angular)42008082leadera-fe
                Backend (Go)80808083leadera-api
                
-
                SSL сертификат: /etc/letsencrypt/live/sand.a2v.space/
                
-
                nginx конфиг
                
+    → https://claw.a2v.space
+

                Шаги настройки

                +

                1. DNS

                +

                A-запись claw.a2v.space → 95.163.232.9

                +

                NS-серверы: ns1.hosting.reg.ru, ns2.hosting.reg.ru

                +

                2. Mac Studio — OpenClaw

                +
                  +
                • Порт: 18789
                  • +
                • Конфиг: ~/.openclaw/openclaw.json
                  • +
                +

                3. SSH-туннель (launchd)

                +

                Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist

                +

                Ключевой флаг: -R 8080:localhost:18789

                +

                4. VPS — nginx конфиг

                server {
     listen 80;
-    server_name sand.a2v.space;
+    server_name claw.a2v.space;
     return 301 https://$server_name$request_uri;
 }
 
 server {
     listen 443 ssl;
-    server_name sand.a2v.space;
+    server_name claw.a2v.space;
 
-    ssl_certificate /etc/letsencrypt/live/sand.a2v.space/fullchain.pem;
-    ssl_certificate_key /etc/letsencrypt/live/sand.a2v.space/privkey.pem;
-
-    location /api {
-        proxy_pass http://127.0.0.1:8083;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
+    ssl_certificate /etc/letsencrypt/live/claw.a2v.space/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/claw.a2v.space/privkey.pem;
 
     location / {
-        proxy_pass http://127.0.0.1:8082;
+        proxy_pass http://127.0.0.1:8080;
         proxy_set_header Host $host;
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto $scheme;
     }
 }
-

                База данных

                -

                PostgreSQL 16 в Docker через Colima:

                +

                5. SSL-сертификат

                +
                certbot certonly --nginx -d claw.a2v.space
+

                6. OpenClaw config

                +
                {
+  "allowedOrigins": ["https://claw.a2v.space"],
+  "trustedProxies": ["127.0.0.1"]
+}
+

                - angular + openclaw - go - - docker + ssh nginx @@ -623,6 +445,113 @@
                +
                +
                +
                +

                Настройка VPS как реверс-прокси

                +

                Общая схема

                +
                Mac Studio (локальная сеть)
+    → autossh (SSH-туннели)
+    → VPS 95.163.232.9 (Debian)
+    → nginx (HTTPS reverse proxy)
+    → интернет
+

                Что нужно на VPS

                +

                1. Установленные пакеты

                +
                apt update
+apt install nginx certbot python3-certbot-nginx
+

                2. SSH-доступ

                +
                  +
                • Авторизация только по ключам
                  • +
                • Публичный ключ с Mac Studio добавлен в /root/.ssh/authorized_keys
                  • +
                +

                3. nginx

                +

                Для каждого домена создать server block:

                +
                  +
                • HTTP → редирект на HTTPS
                  • +
                • HTTPS с SSL-сертификатом Let’s Encrypt
                  • +
                • proxy_pass на localhost-порт туннеля
                  • +
                +

                Пример структуры:

                + +
                + + vps + + nginx + + ssh + + reverse-proxy + + devops + +
                + +
                +
                +
                + +
                +
                +
                +

                SSH туннели для VPS reverse proxy

                +

                Настройка SSH туннелей

                +

                VPS reg.ru (95.163.232.9)

                +
                # На Mac Studio: создать туннель для каждого сервиса
+ssh -N -R 8080:localhost:8080 root@95.163.232.9    # leadera-api
+ssh -N -R 8081:localhost:4096 root@95.163.232.9    # opencode
+ssh -N -R 8082:localhost:4200 root@95.163.232.9    # leadera-fe
+ssh -N -R 8083:localhost:8080 root@95.163.232.9    # docs-a2v
+

                Настройка launchd plist

                +

                Файл: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist

                +
                <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.openclaw.sshtunnel</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>ssh</string>
+        <string>-N</string>
+        <string>-R</string>
+        <string>8080:localhost:8080</string>
+        <string>root@95.163.232.9</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+</dict>
+</plist>
+

                Автозапуск

                +
                # Загрузить plist
+launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist
+
+# Проверить статус
+launchctl list | grep sshtunnel
+
+# Удалить (при необходимости)
+launchctl unload ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist
+

                Доступ к сервисам

                +

                Через reverse proxy на VPS:

                + +
                + + ssh + + tunnel + + vps + + reverse-proxy + +
                + +
                +
                +
                +
                diff --git a/public/guides/index.json b/public/guides/index.json index f05dbfd..56c9280 100644 --- a/public/guides/index.json +++ b/public/guides/index.json @@ -1 +1 @@ -[{"content":"Аудит проекта Leadera Дата: 30.03.2026\nВерсия: pre-production, миграции 1–5\n1. Обзор проекта Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.\nСтек Компонент Технологии Backend Go 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256) Frontend Angular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals Инфраструктура Docker (Colima), pm2, nginx reverse proxy, VPS reg.ru Доменная модель User ──┬── Space (через space_members с role) │ └── GanttChart (принадлежит Space) ├── GanttSection └── GanttTask Роли: admin, editor, viewer — назначаются на уровне Space через таблицу space_members.\nЧто реализовано (endpoints) Auth (5): register, login, refresh, change-password, logout\nSpaces (9): CRUD + members CRUD\nGantt Charts (9): CRUD + archive + members (добавлен, но удалён в миграции 5)\nGantt Sections (5): CRUD + reorder\nGantt Tasks (4): CRUD\nИтого: ~32 endpoint\n2. Архитектура и качество кода 2.1. Backend — структура cmd/server/main.go — точка входа internal/ domain/ — модели (User, Space, GanttChart, etc.) dto/ — request/response DTO (auth, space, gantt) handlers/ — HTTP handlers (auth, space, gantt) middleware/ — auth, cors, space, gantt, role, logging, recovery repository/ — слой доступа к данным service/ — бизнес-логика config/ — конфигурация (.env) utils/ — jwt, password, response, validation migrations/ — SQL миграции (1-5) Оценка: ✅ Чистая layered архитектура. Разделение ответственности чёткое.\n2.2. Frontend — структура src/app/ core/auth/ — auth service, interceptor core/models/ — app.model, space.model core/services/ — space.service, space-storage.service pages/auth/ — sign-in, sign-up, reset-pw, etc. pages/gantt/ — компоненты, модалки, сервисы, модели pages/dashboards/ — spaces list, dashboard layouts/ — navbar, topbar, main-layout Оценка: ✅ Стандартная Angular-структура. Signals для state management.\n2.3. Проблемы кода # Проблема Критичность Описание C1 \\r в service-файлах Medium gantt_service.go, gantt_section_service.go содержат CRLF C2 main.go:238 — мёртвый код getUserHandler Low Неиспользуемая функция C3 Swagger не сгенерирован Medium Аннотации есть, но api/ директории нет C4 RegisterProtectedRoutes не вызывается в main.go Critical GET/PUT/DELETE /spaces/:id не зарегистрированы 3. Права доступа — главный вопрос 3.1. Текущая реализация Права назначаются исключительно через Space:\nТаблица space_members — связка user ↔ space с role (admin/editor/viewer) SpaceMiddleware.RequireSpace() — проверяет членство и записывает ContextSpaceRole в context RoleMiddleware.RequireMinRole() — проверяет иерархию ролей (admin \u0026gt; editor \u0026gt; viewer) Диаграммы Ганта НЕ имеют собственной системы ролей. Таблица gantt_chart_members была создана (миграция 4) и тут же удалена (миграция 5). Все проверки доступа к диаграммам идут через space membership.\n3.2. Как это работает Запрос → AuthMiddleware (JWT → userID) → SpaceMiddleware.RequireSpace() (проверяет space_members → ContextSpaceRole) → GanttMiddleware.RequireGanttChart() (проверяет chart.space_id == spaceID) → RoleMiddleware.RequireMinRole(\u0026#34;editor\u0026#34;) (проверяет ContextSpaceRole) Это правильно. Любой член Space с ролью editor+ может создавать/редактировать диаграммы. Viewers — только читать.\n3.3. 🔴 Критическая проблема: Frontend не соответствует Backend Frontend MembersModalComponent пытается управлять участниками диаграммы:\nganttService.addMember(chartId, dto) → /api/v1/spaces/{spaceId}/gantt-charts/{chartId}/members ganttService.updateMemberRole(chartId, userId, dto) → .../members/{userId} ganttService.removeMember(chartId, userId) → .../members/{userId} Backend GanttHandler.RegisterRoutes() НЕ регистрирует маршруты для members диаграмм. После удаления gantt_chart_members (миграция 5) эти endpoints не существуют.\nРезультат: модальное окно «Участники диаграммы» на фронтенде не работает — все вызовы вернут 404.\n3.4. 🔴 Проблема: Role fallback В role_middleware.go:28-31:\nrole := c.GetString(ContextSpaceRole) if role == \u0026#34;\u0026#34; { role = c.GetString(ContextRole) // fallback на глобальную роль User } Если ContextSpaceRole не установлен, используется глобальная роль пользователя (из JWT). Это значит:\nПользователь с role=admin в таблице users получит admin-доступ к любому space, даже если он не член этого space Но SpaceMiddleware проверяет членство раньше, так что в цепочке RequireSpace() → RequireMinRole() это не эксплуатируется Однако если RequireMinRole() используется без RequireSpace() — это дыра Рекомендация: Удалить fallback на ContextRole. Если ContextSpaceRole пуст — отказывать.\n3.5. Рекомендации по правам доступа Удалить модалку участников диаграммы на фронтенде — она мертва Или добавить раздел «Участники Space» с возможностью управления ролями через /spaces/:space_id/members (эти endpoints работают) Удалить fallback на ContextRole в role_middleware.go Добавить проверку: editor не может повысить кого-то до admin (сейчас может — AddMember разрешает editor+ назначать любую роль) 4. Безопасность 4.1. Критические # Проблема Файл Описание S1 JWT Secret = test .env JWT_SECRET=test_secret_key_change_in_production — это прод-конфиг! S2 CORS: * .env CORS_ALLOWED_ORIGINS=* — любой домен может обращаться к API S3 Пароль БД в .env .env DB_PASSWORD=popoloka16 — creds в открытом виде S4 Refresh tokens: SHA256 utils/password.go SHA256 вместо bcrypt для refresh token hash — быстро брутфорсится 4.2. Высокие # Проблема Описание S5 Нет rate limiting Brute-force на /auth/login без ограничений S6 Нет CSRF protection API принимает POST/PUT/DELETE без CSRF-токена S7 Нет CSP заголовков X-Frame-Options, Content-Security-Policy не настроены S8 JWT в localStorage XSS может украсть access + refresh tokens 4.3. Средние # Проблема Описание S9 Нет password policy Минимальные требования к паролю не enforced S10 Нет audit log Действия с spaces/charts не логируются для аудита S11 Нет блокировки аккаунта Неограниченные попытки входа 5. Инфраструктура 5.1. Текущее состояние Компонент Статус Примечание Go API (pm2: leadera-api) ⚠️ Порт 8080, хост 0.0.0.0 Angular FE (pm2: leadera-fe) ⚠️ Порт 4200, хост 0.0.0.0 PostgreSQL (Docker) ✅ Порт 5432, контейнер app-leadera-db VPS reverse proxy ⚠️ sand.a2v.space → 8082/8083, но 502 если сервисы не запущены SSL ✅ Let\u0026rsquo;s Encrypt на VPS 5.2. Проблемы # Проблема Описание I1 Docker для БД, нативно для API Несогласованность — API и FE не в Docker I2 Нет health-check в pm2 API может упасть без перезапуска I3 Нет CI/CD Ручной деплой через make run + pm2 I4 Нет nginx на Mac Studio FE и API торчат наружу напрямую 6. Функциональная оценка 6.1. Что работает Функция Backend Frontend Статус Регистрация/логин ✅ ✅ Работает JWT auth + refresh ✅ ✅ Работает Spaces CRUD ⚠️ ✅ RegisterProtectedRoutes не вызван (C4) Space members ✅ ✅ Работает Gantt charts CRUD ✅ ✅ Работает Gantt sections ✅ ✅ Работает Gantt tasks ✅ ⚠️ Нет UI для задач внутри диаграммы Архивация диаграмм ✅ ✅ Работает Members диаграммы ❌ ✅ (мёртвый UI) Backend endpoints не существуют 6.2. Что НЕ работает или отсутствует Функция Статус Визуализация Ганта (таймлайн) ❌ Нет компонента отрисовки Drag \u0026amp; Drop задач ❌ Real-time collaboration ❌ Уведомления ❌ Поиск ❌ Экспорт (PDF/Excel) ❌ Email verification ❌ Password reset Backend есть, UI есть — не проверено 6.3. Оценка готовности Система на стадии каркаса. Backend API функционален для CRUD операций, но:\nВизуализация Ганта — основная фича — не реализована (нет canvas/SVG рендеринга) Управление участниками только на уровне Space Нет CI/CD, тестов, мониторинга 7. Приоритизированный план исправлений Неделя 1 — Критическое (безопасность) Приоритет Задача Трудоёмкость P0 Заменить JWT secret на криптостойкий 1 час P0 Настроить CORS (только sand.a2v.space) 1 час P0 bcrypt для refresh tokens вместо SHA256 2 часа P0 Удалить fallback на ContextRole в role_middleware 30 мин P0 Исправить RegisterProtectedRoutes — зарегистрировать маршруты 1 час P1 Rate limiting на auth endpoints 4 часа P1 Editor не может назначать admin роль 2 часа Неделя 2 — Архитектура прав Приоритет Задача Трудоёмкость P1 Удалить/переписать MembersModalComponent → Space members 4 часа P1 Добавить страницу управления участниками Space 8 часов P2 HttpOnly cookies для JWT (вместо localStorage) 8 часов P2 CSRF protection 4 часа Неделя 3 — Функциональность Приоритет Задача Трудоёмкость P2 Визуализация Ганта (canvas/d3) 40+ часов P2 Drag \u0026amp; Drop для задач 16 часов P3 Тесты (unit + integration) 24 часа P3 CI/CD pipeline 8 часов 8. Резюме Ключевые выводы Права доступа — архитектурно верно: роль назначается через Space, не через диаграмму. Но фронтенд ещё не обновлён после удаления gantt_chart_members. Безопасность — критические уязвимости в конфигурации (JWT secret, CORS, bcrypt). Требуют немедленного исправления до любого публичного деплоя. Функциональность — CRUD работает, но основная ценность (визуализация Ганта) не реализована. Код — чистый, хорошая архитектура, но есть мёртвый код и незарегистрированные маршруты. Общая оценка: 🔴 Pre-alpha Проект готов к внутренней демонстрации CRUD, но не готов к продакшену. Первоочередное — безопасность и исправление мёртвых endpoints.\n","section":"guides","tags":["audit","leadera","security","architecture"],"title":"Аудит Leadera — полный отчёт","url":"/guides/leadera-audit/"},{"content":"Настройка SSH туннелей VPS reg.ru (95.163.232.9) # На Mac Studio: создать туннель для каждого сервиса ssh -N -R 8080:localhost:8080 root@95.163.232.9 # leadera-api ssh -N -R 8081:localhost:4096 root@95.163.232.9 # opencode ssh -N -R 8082:localhost:4200 root@95.163.232.9 # leadera-fe ssh -N -R 8083:localhost:8080 root@95.163.232.9 # docs-a2v Настройка launchd plist Файл: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\n\u0026lt;?xml version=\u0026#34;1.0\u0026#34; encoding=\u0026#34;UTF-8\u0026#34;?\u0026gt; \u0026lt;!DOCTYPE plist PUBLIC \u0026#34;-//Apple//DTD PLIST 1.0//EN\u0026#34; \u0026#34;http://www.apple.com/DTDs/PropertyList-1.0.dtd\u0026#34;\u0026gt; \u0026lt;plist version=\u0026#34;1.0\u0026#34;\u0026gt; \u0026lt;dict\u0026gt; \u0026lt;key\u0026gt;Label\u0026lt;/key\u0026gt; \u0026lt;string\u0026gt;com.openclaw.sshtunnel\u0026lt;/string\u0026gt; \u0026lt;key\u0026gt;ProgramArguments\u0026lt;/key\u0026gt; \u0026lt;array\u0026gt; \u0026lt;string\u0026gt;ssh\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-N\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8080:localhost:8080\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;root@95.163.232.9\u0026lt;/string\u0026gt; \u0026lt;/array\u0026gt; \u0026lt;key\u0026gt;RunAtLoad\u0026lt;/key\u0026gt; \u0026lt;true/\u0026gt; \u0026lt;key\u0026gt;KeepAlive\u0026lt;/key\u0026gt; \u0026lt;true/\u0026gt; \u0026lt;/dict\u0026gt; \u0026lt;/plist\u0026gt; Автозапуск # Загрузить plist launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist # Проверить статус launchctl list | grep sshtunnel # Удалить (при необходимости) launchctl unload ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist Доступ к сервисам Через reverse proxy на VPS:\ncode.a2v.space: порт 8080 → Mac Studio:4096 claw.a2v.space: порт 8081 → Mac Studio:8080 (leadera-api) sand.a2v.space: порт 8082 → Mac Studio:4200 (leadera-fe) docs.a2v.space: порт 8083 → Mac Studio:8080 (docs-a2v) SSL Все сервисы используют Let\u0026rsquo;s Encrypt сертификаты:\nПуть: /etc/letsencrypt/live/{claw,code,sand}.a2v.space/ Автопродление через certbot ","section":"guides","tags":["ssh","tunnel","vps","reverse-proxy"],"title":"SSH туннели для VPS reverse proxy","url":"/guides/ssh-tunnels-vps/"},{"content":"Общая схема Mac Studio (локальная сеть) → autossh (SSH-туннели) → VPS 95.163.232.9 (Debian) → nginx (HTTPS reverse proxy) → интернет Что нужно на VPS 1. Установленные пакеты apt update apt install nginx certbot python3-certbot-nginx 2. SSH-доступ Авторизация только по ключам Публичный ключ с Mac Studio добавлен в /root/.ssh/authorized_keys 3. nginx Для каждого домена создать server block:\nHTTP → редирект на HTTPS HTTPS с SSL-сертификатом Let\u0026rsquo;s Encrypt proxy_pass на localhost-порт туннеля Пример структуры:\n/etc/nginx/sites-available/ claw.a2v.space.conf code.a2v.space.conf sand.a2v.space.conf 4. SSL-сертификаты certbot certonly --nginx -d \u0026lt;domain\u0026gt; certbot renew --dry-run # проверить автообновление Что нужно на Mac Studio autossh через launchd Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\nОдин plist с несколькими -R флагами:\n\u0026lt;key\u0026gt;ProgramArguments\u0026lt;/key\u0026gt; \u0026lt;array\u0026gt; \u0026lt;string\u0026gt;/usr/local/bin/autossh\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-M\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;0\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8080:localhost:18789\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8081:localhost:4096\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8082:localhost:4200\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8083:localhost:8080\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;root@95.163.232.9\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-N\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-i\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;/Users/\u0026lt;user\u0026gt;/.ssh/id_rsa\u0026lt;/string\u0026gt; \u0026lt;/array\u0026gt; Управление launchd launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist launchctl start com.openclaw.sshtunnel launchctl stop com.openclaw.sshtunnel Проверка # На VPS ss -tlnp | grep -E \u0026#39;808[0-3]\u0026#39; # Снаружи curl -I https://claw.a2v.space curl -I https://code.a2v.space curl -I https://sand.a2v.space ","section":"guides","tags":["vps","nginx","ssh","reverse-proxy","devops"],"title":"Настройка VPS как реверс-прокси","url":"/guides/vps-reverse-proxy/"},{"content":"Архитектура Mac Studio (192.168.0.37:18789) → autossh SSH-туннель → VPS 95.163.232.9:8080 → nginx HTTPS → https://claw.a2v.space Шаги настройки 1. DNS A-запись claw.a2v.space → 95.163.232.9\nNS-серверы: ns1.hosting.reg.ru, ns2.hosting.reg.ru\n2. Mac Studio — OpenClaw Порт: 18789 Конфиг: ~/.openclaw/openclaw.json 3. SSH-туннель (launchd) Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\nКлючевой флаг: -R 8080:localhost:18789\n4. VPS — nginx конфиг server { listen 80; server_name claw.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name claw.a2v.space; ssl_certificate /etc/letsencrypt/live/claw.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/claw.a2v.space/privkey.pem; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } 5. SSL-сертификат certbot certonly --nginx -d claw.a2v.space 6. OpenClaw config { \u0026#34;allowedOrigins\u0026#34;: [\u0026#34;https://claw.a2v.space\u0026#34;], \u0026#34;trustedProxies\u0026#34;: [\u0026#34;127.0.0.1\u0026#34;] } ","section":"guides","tags":["openclaw","ssh","nginx","vps","reverse-proxy"],"title":"Подключение claw.a2v.space (OpenClaw)","url":"/guides/claw-a2v-space/"},{"content":"Архитектура Mac Studio (localhost:4096) → autossh SSH-туннель (-R 8081:localhost:4096) → VPS 95.163.232.9:8081 → nginx HTTPS → https://code.a2v.space Параметры Параметр Значение Локальный порт 4096 Туннель порт 8081 pm2 процесс opencode SSL сертификат /etc/letsencrypt/live/code.a2v.space/ nginx конфиг server { listen 80; server_name code.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name code.a2v.space; ssl_certificate /etc/letsencrypt/live/code.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/code.a2v.space/privkey.pem; location / { proxy_pass http://127.0.0.1:8081; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \u0026#34;upgrade\u0026#34;; } } SSL-сертификат certbot certonly --nginx -d code.a2v.space ","section":"guides","tags":["opencode","ssh","nginx","vps","reverse-proxy"],"title":"Подключение code.a2v.space (OpenCode)","url":"/guides/code-a2v-space/"},{"content":"Архитектура Mac Studio ├─ Frontend (Angular) :4200 (pm2: leadera-fe) ├─ Backend (Go) :8080 (pm2: leadera-api) └─ PostgreSQL 16 в Docker (Colima, container: app-leadera-db) → autossh SSH-туннель (-R 8082:localhost:4200 -R 8083:localhost:8080) → VPS 95.163.232.9 → nginx HTTPS → https://sand.a2v.space Параметры Компонент Локальный порт Туннель порт pm2 имя Frontend (Angular) 4200 8082 leadera-fe Backend (Go) 8080 8083 leadera-api SSL сертификат: /etc/letsencrypt/live/sand.a2v.space/\nnginx конфиг server { listen 80; server_name sand.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name sand.a2v.space; ssl_certificate /etc/letsencrypt/live/sand.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/sand.a2v.space/privkey.pem; location /api { proxy_pass http://127.0.0.1:8083; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } location / { proxy_pass http://127.0.0.1:8082; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } База данных PostgreSQL 16 в Docker через Colima:\nContainer: app-leadera-db Port: 5432 SSL-сертификат certbot certonly --nginx -d sand.a2v.space ","section":"guides","tags":["angular","go","docker","nginx","vps","reverse-proxy"],"title":"Подключение sand.a2v.space (Leadera Project)","url":"/guides/sand-a2v-space/"}] \ No newline at end of file +[{"content":"Настройка SSH туннелей VPS reg.ru (95.163.232.9) # На Mac Studio: создать туннель для каждого сервиса ssh -N -R 8080:localhost:8080 root@95.163.232.9 # leadera-api ssh -N -R 8081:localhost:4096 root@95.163.232.9 # opencode ssh -N -R 8082:localhost:4200 root@95.163.232.9 # leadera-fe ssh -N -R 8083:localhost:8080 root@95.163.232.9 # docs-a2v Настройка launchd plist Файл: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\n\u0026lt;?xml version=\u0026#34;1.0\u0026#34; encoding=\u0026#34;UTF-8\u0026#34;?\u0026gt; \u0026lt;!DOCTYPE plist PUBLIC \u0026#34;-//Apple//DTD PLIST 1.0//EN\u0026#34; \u0026#34;http://www.apple.com/DTDs/PropertyList-1.0.dtd\u0026#34;\u0026gt; \u0026lt;plist version=\u0026#34;1.0\u0026#34;\u0026gt; \u0026lt;dict\u0026gt; \u0026lt;key\u0026gt;Label\u0026lt;/key\u0026gt; \u0026lt;string\u0026gt;com.openclaw.sshtunnel\u0026lt;/string\u0026gt; \u0026lt;key\u0026gt;ProgramArguments\u0026lt;/key\u0026gt; \u0026lt;array\u0026gt; \u0026lt;string\u0026gt;ssh\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-N\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8080:localhost:8080\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;root@95.163.232.9\u0026lt;/string\u0026gt; \u0026lt;/array\u0026gt; \u0026lt;key\u0026gt;RunAtLoad\u0026lt;/key\u0026gt; \u0026lt;true/\u0026gt; \u0026lt;key\u0026gt;KeepAlive\u0026lt;/key\u0026gt; \u0026lt;true/\u0026gt; \u0026lt;/dict\u0026gt; \u0026lt;/plist\u0026gt; Автозапуск # Загрузить plist launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist # Проверить статус launchctl list | grep sshtunnel # Удалить (при необходимости) launchctl unload ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist Доступ к сервисам Через reverse proxy на VPS:\ncode.a2v.space: порт 8080 → Mac Studio:4096 claw.a2v.space: порт 8081 → Mac Studio:8080 (leadera-api) sand.a2v.space: порт 8082 → Mac Studio:4200 (leadera-fe) docs.a2v.space: порт 8083 → Mac Studio:8080 (docs-a2v) SSL Все сервисы используют Let\u0026rsquo;s Encrypt сертификаты:\nПуть: /etc/letsencrypt/live/{claw,code,sand}.a2v.space/ Автопродление через certbot ","section":"guides","tags":["ssh","tunnel","vps","reverse-proxy"],"title":"SSH туннели для VPS reverse proxy","url":"/guides/ssh-tunnels-vps/"},{"content":"Общая схема Mac Studio (локальная сеть) → autossh (SSH-туннели) → VPS 95.163.232.9 (Debian) → nginx (HTTPS reverse proxy) → интернет Что нужно на VPS 1. Установленные пакеты apt update apt install nginx certbot python3-certbot-nginx 2. SSH-доступ Авторизация только по ключам Публичный ключ с Mac Studio добавлен в /root/.ssh/authorized_keys 3. nginx Для каждого домена создать server block:\nHTTP → редирект на HTTPS HTTPS с SSL-сертификатом Let\u0026rsquo;s Encrypt proxy_pass на localhost-порт туннеля Пример структуры:\n/etc/nginx/sites-available/ claw.a2v.space.conf code.a2v.space.conf sand.a2v.space.conf 4. SSL-сертификаты certbot certonly --nginx -d \u0026lt;domain\u0026gt; certbot renew --dry-run # проверить автообновление Что нужно на Mac Studio autossh через launchd Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\nОдин plist с несколькими -R флагами:\n\u0026lt;key\u0026gt;ProgramArguments\u0026lt;/key\u0026gt; \u0026lt;array\u0026gt; \u0026lt;string\u0026gt;/usr/local/bin/autossh\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-M\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;0\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8080:localhost:18789\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8081:localhost:4096\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8082:localhost:4200\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8083:localhost:8080\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;root@95.163.232.9\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-N\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-i\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;/Users/\u0026lt;user\u0026gt;/.ssh/id_rsa\u0026lt;/string\u0026gt; \u0026lt;/array\u0026gt; Управление launchd launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist launchctl start com.openclaw.sshtunnel launchctl stop com.openclaw.sshtunnel Проверка # На VPS ss -tlnp | grep -E \u0026#39;808[0-3]\u0026#39; # Снаружи curl -I https://claw.a2v.space curl -I https://code.a2v.space curl -I https://sand.a2v.space ","section":"guides","tags":["vps","nginx","ssh","reverse-proxy","devops"],"title":"Настройка VPS как реверс-прокси","url":"/guides/vps-reverse-proxy/"},{"content":"Архитектура Mac Studio (192.168.0.37:18789) → autossh SSH-туннель → VPS 95.163.232.9:8080 → nginx HTTPS → https://claw.a2v.space Шаги настройки 1. DNS A-запись claw.a2v.space → 95.163.232.9\nNS-серверы: ns1.hosting.reg.ru, ns2.hosting.reg.ru\n2. Mac Studio — OpenClaw Порт: 18789 Конфиг: ~/.openclaw/openclaw.json 3. SSH-туннель (launchd) Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\nКлючевой флаг: -R 8080:localhost:18789\n4. VPS — nginx конфиг server { listen 80; server_name claw.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name claw.a2v.space; ssl_certificate /etc/letsencrypt/live/claw.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/claw.a2v.space/privkey.pem; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } 5. SSL-сертификат certbot certonly --nginx -d claw.a2v.space 6. OpenClaw config { \u0026#34;allowedOrigins\u0026#34;: [\u0026#34;https://claw.a2v.space\u0026#34;], \u0026#34;trustedProxies\u0026#34;: [\u0026#34;127.0.0.1\u0026#34;] } ","section":"guides","tags":["openclaw","ssh","nginx","vps","reverse-proxy"],"title":"Подключение claw.a2v.space (OpenClaw)","url":"/guides/claw-a2v-space/"},{"content":"Архитектура Mac Studio (localhost:4096) → autossh SSH-туннель (-R 8081:localhost:4096) → VPS 95.163.232.9:8081 → nginx HTTPS → https://code.a2v.space Параметры Параметр Значение Локальный порт 4096 Туннель порт 8081 pm2 процесс opencode SSL сертификат /etc/letsencrypt/live/code.a2v.space/ nginx конфиг server { listen 80; server_name code.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name code.a2v.space; ssl_certificate /etc/letsencrypt/live/code.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/code.a2v.space/privkey.pem; location / { proxy_pass http://127.0.0.1:8081; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \u0026#34;upgrade\u0026#34;; } } SSL-сертификат certbot certonly --nginx -d code.a2v.space ","section":"guides","tags":["opencode","ssh","nginx","vps","reverse-proxy"],"title":"Подключение code.a2v.space (OpenCode)","url":"/guides/code-a2v-space/"},{"content":"Архитектура Mac Studio ├─ Frontend (Angular) :4200 (pm2: leadera-fe) ├─ Backend (Go) :8080 (pm2: leadera-api) └─ PostgreSQL 16 в Docker (Colima, container: app-leadera-db) → autossh SSH-туннель (-R 8082:localhost:4200 -R 8083:localhost:8080) → VPS 95.163.232.9 → nginx HTTPS → https://sand.a2v.space Параметры Компонент Локальный порт Туннель порт pm2 имя Frontend (Angular) 4200 8082 leadera-fe Backend (Go) 8080 8083 leadera-api SSL сертификат: /etc/letsencrypt/live/sand.a2v.space/\nnginx конфиг server { listen 80; server_name sand.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name sand.a2v.space; ssl_certificate /etc/letsencrypt/live/sand.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/sand.a2v.space/privkey.pem; location /api { proxy_pass http://127.0.0.1:8083; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } location / { proxy_pass http://127.0.0.1:8082; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } База данных PostgreSQL 16 в Docker через Colima:\nContainer: app-leadera-db Port: 5432 SSL-сертификат certbot certonly --nginx -d sand.a2v.space ","section":"guides","tags":["angular","go","docker","nginx","vps","reverse-proxy"],"title":"Подключение sand.a2v.space (Leadera Project)","url":"/guides/sand-a2v-space/"}] \ No newline at end of file diff --git a/public/guides/leadera-audit/index.html b/public/guides/leadera-audit/index.html index 191d44d..0df893c 100644 --- a/public/guides/leadera-audit/index.html +++ b/public/guides/leadera-audit/index.html @@ -110,6 +110,58 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -174,6 +226,24 @@
              • architecture
                • +
              • websocket
                • + +
              • realtime
                • + +
              • gantt
                • + +
              • api
                • + +
              • frontend
                • + +
              • requirements
                • + +
              • angular
                • + +
              • go
                • + +
              • ux
                • +
              • ssh
              • tunnel
                • @@ -190,10 +260,6 @@
              • opencode
                • -
              • angular
                • - -
              • go
                • -
              • docker
              @@ -209,6 +275,15 @@

              Аудит Leadera — полный отчёт

              +
              + + 📁 ~/Projects/docs-a2v/content/guides/leadera-audit.md + + +
              +
              diff --git a/public/guides/leadera-gantt-filters/index.html b/public/guides/leadera-gantt-filters/index.html new file mode 100644 index 0000000..05a0534 --- /dev/null +++ b/public/guides/leadera-gantt-filters/index.html @@ -0,0 +1,621 @@ + + + + + + Leadera — Фильтры и реорганизация списка диаграмм Ганта — docs.a2v.space + + + + + + + + + + +
              + + + + +
              + + +
              +
              + + + + +
              + +
              +

              Leadera — Фильтры и реорганизация списка диаграмм Ганта

              +
              + + 📁 ~/Projects/docs-a2v/content/guides/leadera-gantt-filters.md + + +
              + + + +
              + + leadera + + gantt + + api + + frontend + + requirements + +
              + + +

              Фильтры и реорганизация списка диаграмм Ганта

              +

              Дата: 07.04.2026 +Статус: Требования +Проект: Leadera (dev — sand.a2v.space)

              +
              +

              1. Постановка задачи

              +

              Список диаграмм Ганта должен показывать все доступные пользователю диаграммы из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.

              +
              +

              2. Изменения API

              +

              2.1. Новый endpoint списка диаграмм

              +

              Было:

              +
              GET /api/v1/spaces/{spaceId}/gantt-charts?page=1&per_page=10
+

              Стало:

              +
              GET /api/v1/gantt-charts?page=1&per_page=10
+

              Пользователь видит все диаграммы из всех пространств, где он является подтверждённым участником (статус accepted).

              +

              2.2. Параметры фильтрации и поиска

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              ПараметрТипОписание
              pageintНомер страницы (default: 1)
              per_pageintЗаписей на странице (default: 10)
              space_idUUID (optional)Фильтр по конкретному пространству
              created_byUUID (optional)Фильтр по создателю диаграммы
              searchstring (optional)Поиск по назвению и описанию (ILIKE, case-insensitive)
              sortstring (optional)Сортировка: created_at, updated_at, title (default: updated_at)
              orderstring (optional)asc / desc (default: desc)
              +

              Примеры:

              +
              GET /api/v1/gantt-charts?search=миграция
+GET /api/v1/gantt-charts?space_id=0b334ded-...&created_by=a1b2c3d4-...
+GET /api/v1/gantt-charts?page=2&per_page=20&sort=title&order=asc
+

              2.3. Изменение структуры ответа

              +

              Добавить поле space в каждую диаграмму:

              +
              {
+  "data": [
+    {
+      "id": "uuid",
+      "title": "Миграция backend",
+      "description": "...",
+      "created_by": "uuid",
+      "created_by_name": "Антон Агальцов",
+      "created_at": "2026-04-01T10:00:00Z",
+      "updated_at": "2026-04-07T09:00:00Z",
+      "space": {
+        "id": "uuid",
+        "name": "IT Ландшафт",
+        "color": "#c4623a"
+      },
+      "is_archived": false
+    }
+  ],
+  "pagination": {
+    "page": 1,
+    "per_page": 10,
+    "total": 42,
+    "total_pages": 5
+  }
+}
+

              2.4. Endpoint для списка фильтров

              +

              Вспомогательный endpoint для заполнения dropdown-фильтров:

              +
              GET /api/v1/gantt-charts/filters
+

              Ответ:

              +
              {
+  "spaces": [
+    { "id": "uuid", "name": "IT Ландшафт", "color": "#c4623a" },
+    { "id": "uuid", "name": "DevOps", "color": "#27ae60" }
+  ],
+  "creators": [
+    { "id": "uuid", "display_name": "Антон Агальцов" },
+    { "id": "uuid", "display_name": "Иван Петров" }
+  ]
+}
+

              Логика creators: уникальные создатели всех диаграмм, доступных текущему пользователю. Получается через DISTINCT-запрос по created_by с JOIN на users.

              +

              2.5. Backend — изменения в Go

              +

              Файлы для изменения:

              +

              internal/handlers/gantt_handler.go

              +
                +
              • Добавить новый handler ListAllGanttCharts — без привязки к space
                • +
              • Зарегистрировать маршрут GET /gantt-charts (без /spaces/:id/)
                • +
              • Парсить query-параметры: space_id, created_by, search, sort, order
                • +
              • Старый маршрут GET /spaces/:id/gantt-charts — оставить для обратной совместимости (или удалить, если не используется)
                • +
              +

              internal/service/gantt_service.go

              +
                +
              • Новый метод ListAll(ctx, userId, filters) — запрашивает все spaces пользователя (через space_member с status=accepted), затем выбирает все gantt_charts из этих spaces с фильтрами
                • +
              +

              internal/repository/gantt_repository.go

              +
                +
              • Новый метод с динамическим SQL: +
                  +
                • Базовый JOIN: gantt_charts → spaces → space_members
                  • +
                • WHERE: space_members.user_id = $1 AND space_members.status = 'accepted'
                  • +
                • Опциональные фильтры: AND space_id = $N, AND created_by = $N, AND (title ILIKE '%' || $N || '%' OR description ILIKE '%' || $N || '%')
                  • +
                • Возвращать поле space (id, name, color) через JOIN
                  • +
                +
                • +
              +

              internal/dto/gantt/

              +
                +
              • Новые DTO: GanttChartListFilters, GanttChartWithSpaceResponse, GanttFiltersResponse
                • +
              +

              SQL (пример):

              +
              SELECT gc.*, s.id as space_id, s.name as space_name, s.color as space_color,
+       u.display_name as created_by_name
+FROM gantt_charts gc
+JOIN spaces s ON s.id = gc.space_id
+JOIN space_members sm ON sm.space_id = s.id
+LEFT JOIN users u ON u.id = gc.created_by
+WHERE sm.user_id = $1
+  AND sm.status = 'accepted'
+  AND ($2::uuid IS NULL OR gc.space_id = $2)
+  AND ($3::uuid IS NULL OR gc.created_by = $3)
+  AND ($4::text IS NULL OR gc.title ILIKE '%' || $4 || '%'
+       OR gc.description ILIKE '%' || $4 || '%')
+ORDER BY
+  CASE WHEN $5 = 'title' THEN gc.title END,
+  CASE WHEN $5 = 'created_at' THEN gc.created_at::text END,
+  gc.updated_at DESC
+LIMIT $6 OFFSET $7;
+
              +

              3. Изменения Frontend (Angular)

              +

              3.1. Toolbar фильтров

              +

              Добавить toolbar над списком диаграмм:

              +
              ┌──────────────────────────────────────────────────────────────────┐
+│ [🔍 Поиск...                              ] [▼ Пространство]    │
+│ [▼ Создатель]  [▼ Сортировка]  [Сбросить фильтры]               │
+└──────────────────────────────────────────────────────────────────┘
+

              Компоненты:

              +
                +
              • Строка поиска — input с debounce (300ms), поиск по назвению и описанию
                • +
              • Dropdown «Пространство» — список из /gantt-charts/filters, с цветовой меткой
                • +
              • Dropdown «Создатель» — список уникальных создателей
                • +
              • Dropdown «Сортировка» — по дате обновления, дате создания, названию
                • +
              • Кнопка «Сбросить» — очищает все фильтры
                • +
              +

              Состояние фильтров в URL (query params):

              +
              /gantt?search=миграция&space_id=xxx&sort=updated_at
+

              Это позволяет делиться ссылкой с уже настроенными фильтрами.

              +

              3.2. Карточка диаграммы — бейдж пространства

              +

              На каждой карточке добавить бейдж с названием пространства:

              +
              ┌─────────────────────────────────────┐
+│  🟠 IT Ландшафт                     │  ← бейдж с цветом пространства
+│  Миграция backend                   │
+│  Перевод PHP→Go, этап 2             │
+│  Создал: Антон А. · 07.04.2026     │
+└─────────────────────────────────────┘
+

              3.3. Форма создания диаграммы — выбор пространства

              +

              В модальном окне создания:

              +
                +
              • Dropdown со списком пространств, где пользователь имеет роль editor или выше
                • +
              • Валидация: если пользователь не editor ни в одном пространстве — показать сообщение «Нет доступных пространств для создания»
                • +
              +

              Запрос доступных пространств: переиспользовать существующий GET /api/v1/spaces с фильтрацией на клиенте по role ∈ [owner, admin, editor], либо добавить параметр ?min_role=editor на backend.

              +

              3.4. Изменение routing

              +

              Было:

              +
              /gantt → список гантов текущего пространства
+

              Стало:

              +
              /gantt → список всех доступных гантов (из всех пространств)
+

              Убрать зависимость от SpaceStorageService.getSelectedSpaceId() в списке гантов.

              +

              3.5. Frontend — файлы для изменения

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              ФайлИзменение
              pages/gantt/services/gantt.service.tsНовый метод listAll(filters), getFilters()
              pages/gantt/gantt.component.tsПодключить toolbar, парсинг URL-параметров
              pages/gantt/gantt.component.htmlДобавить toolbar, бейджи на карточках
              pages/gantt/components/gantt-card/Добавить бейдж пространства
              pages/gantt/components/create-chart-modal/Dropdown выбора пространства
              core/models/Обновить модели: добавить space в GanttChart
              +
              +

              4. Обратная совместимость

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              EndpointСтатус
              GET /api/v1/spaces/{id}/gantt-chartsСохранить (для детального view внутри пространства)
              GET /api/v1/gantt-chartsНовый — глобальный список
              GET /api/v1/gantt-charts/filtersНовый — данные для dropdown’ов
              POST /api/v1/spaces/{id}/gantt-chartsСохранить (создание в контексте пространства)
              Все CRUD для sections/tasksБез изменений
              +
              +

              5. Критерии приёмки

              +
                +
              • Endpoint GET /api/v1/gantt-charts возвращает все доступные диаграммы
                • +
              • Фильтр по space_id — показывает только диаграммы конкретного пространства
                • +
              • Фильтр по created_by — показывает только диаграммы выбранного создателя
                • +
              • Поиск search — ищет по title и description (case-insensitive)
                • +
              • Dropdown фильтров заполняется реальными данными из /filters
                • +
              • Карточка диаграммы показывает бейдж пространства с цветом
                • +
              • Форма создания предлагает только пространства с ролью ≥ editor
                • +
              • Состояние фильтров сохраняется в URL (можно поделиться ссылкой)
                • +
              • Старые endpoints (/spaces/{id}/gantt-charts) продолжают работать
                • +
              • Swagger документация обновлена
                • +
              +
              +

              6. Порядок реализации

              +
                +
              1. Backend: DTO для новых запросов/ответов
                2. +
              2. Backend: Repository — SQL-запрос с фильтрами + JOIN на spaces
                3. +
              3. Backend: Service — ListAll, GetFilters
                4. +
              4. Backend: Handler — ListAllGanttCharts, GetGanttFilters, регистрация маршрутов
                5. +
              5. Backend: Swagger — обновить документацию
                6. +
              6. Frontend: Модели — обновить GanttChart, добавить Space в ответ
                7. +
              7. Frontend: Service — listAll(), getFilters()
                8. +
              8. Frontend: Toolbar компонент — поиск + dropdown’ы
                9. +
              9. Frontend: Карточка — бейдж пространства
                10. +
              10. Frontend: Модальное окно создания — dropdown пространства
                11. +
              11. Frontend: URL-параметры — синхронизация фильтров с router
                12. +
              12. Тестирование
                13. +
              + +
              + +
              +
              +
              + +
              +
              +

              © 2026 docs.a2v.space

              +
              +
              + + + + + + + + + + + + + + + diff --git a/public/guides/leadera-milestones/index.html b/public/guides/leadera-milestones/index.html new file mode 100644 index 0000000..813f99d --- /dev/null +++ b/public/guides/leadera-milestones/index.html @@ -0,0 +1,776 @@ + + + + + + Leadera: Вехи (Milestones) на диаграмме Ганта — docs.a2v.space + + + + + + + + + + +
              + + + + +
              + + +
              +
              + + + + +
              + +
              +

              Leadera: Вехи (Milestones) на диаграмме Ганта

              +
              + + 📁 ~/Projects/docs-a2v/content/guides/leadera-milestones.md + + +
              + + + +
              + + leadera + + gantt + + angular + + go + + api + + ux + +
              + + +

              Бизнес-требования

              +

              BR-1: Сущность «Веха» (Milestone)

              +

              Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.

              +

              Поля вехи:

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              ПолеТипОписание
              idUUIDИдентификатор
              gantt_chart_idUUIDПринадлежность к диаграмме (не к секции!)
              titlestringНазвание вехи (обязательное, 1–255 символов)
              datedateДата вехи (без времени, обязательная)
              colorstringЦвет маркера (HEX, по умолчанию #dc3545 — красный)
              created_byUUIDКто создал (не отображается в UI, хранится для аудита)
              updated_byUUIDКто обновил (не отображается в UI)
              created_attimestampДата создания
              updated_attimestampДата обновления
              deleted_attimestampSoft delete
              +

              Права доступа: Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).

              +

              Особенности:

              +
                +
              • Вех может быть несколько в проекте
                • +
              • Несколько вех могут иметь одну и ту же дату
                • +
              • Вехи сортируются строго по дате (по возрастанию)
                • +
              • Вехи не привязаны к секциям — они отображаются сквозь все секции
                • +
              +
              +

              BR-2: Управление вехами (модальное окно)

              +

              Вызов: Кнопка «Вехи» рядом с кнопкой «Создать секцию» на странице диаграммы.

              +

              Модальное окно содержит:

              +
                +
              • Заголовок: «Вехи проекта»
                • +
              • Список всех вех текущей диаграммы (сортировка по дате по возрастанию)
                • +
              • Каждая веха в списке показывает: цвет (индикатор), название, дату, кнопки «Редактировать» и «Удалить»
                • +
              • Кнопка «Добавить веху»
                • +
              +

              Форма добавления/редактирования вехи:

              +
                +
              • Название — текстовый ввод (обязательное, 1–255 символов)
                • +
              • Дата — datepicker (обязательное)
                • +
              • Цвет — выбор цвета (по аналогии с палитрой цветов в задачах)
                • +
              • По умолчанию цвет = красный (#dc3545)
                • +
              +

              Удаление: с подтверждением (confirm dialog).

              +
              +

              BR-3: Отображение вех на таймлайне

              +

              Визуальное представление:

              +
                +
              • Маркер-флажок (flag marker) на шкале таймлайна
                • +
              • От маркера вниз идёт пунктирная вертикальная линия через все секции (на всю высоту диаграммы)
                • +
              • Цвет линии и маркера = цвет вехи
                • +
              +

              Позиционирование:

              +
                +
              • Веха ставится ровно на свою дату на шкале времени
                • +
              • Если дата вехи выходит за рамки текущего диапазона задач — таймлайн расширяется (аналогично задачам)
                • +
              • При изменении масштаба (days/weeks/months/quarters) позиция вехи пересчитывается
                • +
              +

              Tooltip при наведении:

              +
                +
              • При наведении на маркер/линию — показывается tooltip с названием вехи
                • +
              • Если на одну дату приходится несколько вех — в tooltip показываются все вехи этой даты с их названиями (каждая с индикацией своего цвета)
                • +
              +
              +

              Технические требования

              +

              База данных

              +

              Новая таблица: gantt_milestones

              +
              CREATE TABLE gantt_milestones (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    gantt_chart_id UUID NOT NULL REFERENCES gantt_charts(id) ON DELETE CASCADE,
+    title VARCHAR(255) NOT NULL,
+    date DATE NOT NULL,
+    color VARCHAR(20) NOT NULL DEFAULT '#dc3545',
+    created_by UUID NOT NULL REFERENCES users(id),
+    updated_by UUID NOT NULL REFERENCES users(id),
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    deleted_at TIMESTAMP WITH TIME ZONE
+);
+
+CREATE INDEX idx_gantt_milestones_chart ON gantt_milestones(gantt_chart_id);
+CREATE INDEX idx_gantt_milestones_date ON gantt_milestones(date);
+
              +

              Backend (Go API)

              +

              Этап 1: Миграция + Домен

              +

              Промт для агента:

              +
              +

              Добавь в проект новую таблицу gantt_milestones.

              +
                +
              1. +

                Создай миграцию в cmd/migrate/:

                +
                  +
                • Новая таблица gantt_milestones с полями: id (UUID PK), gantt_chart_id (UUID FK → gantt_charts, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), date (DATE NOT NULL), color (VARCHAR 20 NOT NULL DEFAULT ‘#dc3545’), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. Индексы по gantt_chart_id и date.
                  • +
                +
                2. +
              2. +

                Создай доменную модель GanttMilestone в internal/domain/gantt.go:

                +
                3. +
              +
              type GanttMilestone struct {
+    ID           UUID       `json:"id"`
+    GanttChartID UUID       `json:"gantt_chart_id"`
+    Title        string     `json:"title"`
+    Date         time.Time  `json:"date"`
+    Color        string     `json:"color"`
+    CreatedBy    UUID       `json:"created_by"`
+    UpdatedBy    UUID       `json:"updated_by"`
+    CreatedAt    time.Time  `json:"created_at"`
+    UpdatedAt    time.Time  `json:"updated_at"`
+    DeletedAt    *time.Time `json:"deleted_at,omitempty"`
+}
+
              +

              Этап 2: CRUD для GanttMilestones

              +

              Промт для агента:

              +
              +

              Реализуй полный CRUD для сущности GanttMilestone по аналогии с существующими handlers/services/repositories в проекте.

              +

              Роуты:

              +
                +
              • GET /api/gantt-charts/:chartId/milestones — список вех диаграммы
                • +
              • POST /api/gantt-charts/:chartId/milestones — создать веху
                • +
              • PUT /api/gantt-charts/:chartId/milestones/:milestoneId — обновить веху
                • +
              • DELETE /api/gantt-charts/:chartId/milestones/:milestoneId — удалить веху (soft delete)
                • +
              +

              Repository: internal/repository/gantt_milestone_repository.go

              +
                +
              • GetByChartID(ctx, chartID) ([]domain.GanttMilestone, error) — все неудалённые вехи диаграммы, отсортированные по date ASC
                • +
              • GetByID(ctx, id) (*domain.GanttMilestone, error)
                • +
              • Create(ctx, milestone) error
                • +
              • Update(ctx, milestone) error
                • +
              • Delete(ctx, id) error — soft delete (set deleted_at)
                • +
              • Все запросы — raw SQL через pgx, как в остальных репозиториях проекта
                • +
              +

              Service: internal/service/gantt_milestone_service.go

              +
                +
              • Валидация: title (1–255 символов), date (обязательное), color (валидный HEX, default ‘#dc3545’)
                • +
              • Проверка прав доступа: пользователь должен иметь права выше «только чтение» в пространстве (space) диаграммы
                • +
              • Проверка что chartId существует и не архивирован
                • +
              +

              Handler: internal/handler/gantt_milestone_handler.go

              +
                +
              • Swagger-аннотации для всех эндпоинтов
                • +
              • Валидация входных данных
                • +
              • Ошибки в формате проекта
                • +
              +

              DTO: internal/dto/gantt/milestones_dto.go

              +
              type CreateGanttMilestoneRequest struct {
+    Title string  `json:"title" binding:"required,min=1,max=255"`
+    Date   string  `json:"date" binding:"required"`
+    Color  *string `json:"color" binding:"omitempty,max=20"`
+}
+
+type UpdateGanttMilestoneRequest struct {
+    Title *string `json:"title" binding:"omitempty,min=1,max=255"`
+    Date   *string `json:"date" binding:"omitempty"`
+    Color  *string `json:"color" binding:"omitempty,max=20"`
+}
+
+type GanttMilestoneResponse struct {
+    ID            domain.UUID           `json:"id"`
+    GanttChartID  domain.UUID           `json:"gantt_chart_id"`
+    Title         string                `json:"title"`
+    Date          string                `json:"date"`
+    Color         string                `json:"color"`
+    CreatedByUser *CreatedByUpdatedUser `json:"created_by_user"`
+    UpdatedByUser *CreatedByUpdatedUser `json:"updated_by_user"`
+    CreatedAt     time.Time             `json:"created_at"`
+    UpdatedAt     time.Time             `json:"updated_at"`
+}
+
+type GanttMilestonesListResponse struct {
+    Milestones []GanttMilestoneResponse `json:"milestones"`
+}
+

              Регистрация роутов: Добавь группу milestone-роутов в роутер рядом с существующими роутами секций/задач. Проверка прав через существующий middleware.

              +
              +

              Этап 3: Включение вех в ответ диаграммы

              +

              Промт для агента:

              +
              +

              При запросе данных диаграммы Ганта (полная загрузка) включай связанные вехи в ответ.

              +
                +
              1. Добавь эндпоинт или расширь существующий GET /api/gantt-charts/:chartId — включить поле milestones с массивом GanttMilestoneResponse
                2. +
              2. Вехи с deleted_at IS NOT NULL не возвращаются
                3. +
              3. Вехи сортируются по date ASC
                4. +
              4. Вехи загружаются вместе с данными диаграммы (tasks, sections) — один запрос при открытии Ганта
                5. +
              +
              +
              +

              Frontend (Angular)

              +

              Этап FE-1: Модели + Сервис

              +

              Промт для агента:

              +
              +

              Добавь в проект поддержку вех (milestones) на диаграмме Ганта.

              +
                +
              1. В pages/gantt/models/ (или соответствующем файле моделей) добавь:
                2. +
              +
              export interface GanttMilestone {
+  id: string;
+  gantt_chart_id: string;
+  title: string;
+  date: string;
+  color: string;
+  created_by_user?: { id: string; full_name: string };
+  updated_by_user?: { id: string; full_name: string };
+  created_at: string;
+  updated_at: string;
+}
+
+export interface GanttMilestoneCreateRequest {
+  title: string;
+  date: string;
+  color?: string;
+}
+
+export interface GanttMilestoneUpdateRequest {
+  title?: string;
+  date?: string;
+  color?: string;
+}
+
                +
              1. +

                Добавь milestones: GanttMilestone[] в интерфейс/модель полной загрузки данных диаграммы

                +
                2. +
              2. +

                Создай сервис pages/gantt/services/gantt-milestone.service.ts:

                +
                3. +
              +
                +
              • Inject HttpClient
                • +
              • Методы: +
                  +
                • getMilestones(chartId: string): Observable<GanttMilestone[]>
                  • +
                • createMilestone(chartId: string, data: GanttMilestoneCreateRequest): Observable<GanttMilestone>
                  • +
                • updateMilestone(chartId: string, milestoneId: string, data: GanttMilestoneUpdateRequest): Observable<GanttMilestone>
                  • +
                • deleteMilestone(chartId: string, milestoneId: string): Observable<void>
                  • +
                +
                • +
              • Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService)
                • +
              +
              +

              Этап FE-2: Модальное окно управления вехами

              +

              Промт для агента:

              +
              +

              Создай компонент модального окна для управления вехами диаграммы Ганта.

              +
                +
              1. +

                Создай компонент pages/gantt/components/milestones-modal/

                +
                2. +
              2. +

                Кнопка вызова: Добавь кнопку «Вехи» рядом с кнопкой «Создать секцию» в toolbar диаграммы. По клику — открытие модального окна через ng-bootstrap NgbModal.

                +
                3. +
              3. +

                Модальное окно (ng-bootstrap modal):

                +
                  +
                • Заголовок: «Вехи проекта»
                  • +
                • Список вех (сортировка по date ASC): +
                    +
                  • Каждый элемент: цветной кружок (color), название, дата (форматированная), кнопки ✏️ (редактировать) и 🗑️ (удалить с confirm)
                    • +
                  +
                  • +
                • Кнопка «Добавить веху» внизу списка
                  • +
                • Если вех нет — сообщение «Вех пока нет. Добавьте первую!»
                  • +
                +
                4. +
              4. +

                Форма добавления/редактирования (inline в модальном окне):

                +
                  +
                • Название — текстовый ввод (обязательное)
                  • +
                • Дата — ng-bootstrap datepicker (обязательное)
                  • +
                • Цвет — палитра цветов (использовать тот же компонент/подход, что и для задач)
                  • +
                • По умолчанию цвет = #dc3545 (красный)
                  • +
                • Кнопки «Сохранить» и «Отмена»
                  • +
                +
                5. +
              5. +

                При сохранении — вызов соответствующего метода сервиса (create/update)

                +
                6. +
              6. +

                При удалении — confirm dialog → вызов deleteMilestone

                +
                7. +
              7. +

                После любого изменения — обновить список вех и обновить данные на канвасе (через сервис/GanttStore)

                +
                8. +
              8. +

                Инжектировать GanttMilestoneService и NgbModal

                +
                9. +
              +
              +

              Этап FE-3: Отображение вех на таймлайне (Konva canvas)

              +

              Промт для агента:

              +
              +

              Отобрази вехи (milestones) на canvas-диаграмме Ганта.

              +

              Проект использует Konva.js для рендеринга.

              +
                +
              1. +

                При загрузке данных диаграммы — извлечь массив milestones

                +
                2. +
              2. +

                Для каждой вехи нарисовать на canvas:

                +
                  +
                • Маркер-флажок (flag marker) на позиции даты вехи на шкале времени +
                    +
                  • Стиль: маленький треугольник или флаг на верхней границе таймлайна
                    • +
                  • Цвет = milestone.color
                    • +
                  +
                  • +
                • Пунктирная вертикальная линия от маркера вниз через все секции (на всю высоту области секций) +
                    +
                  • Стиль: Konva.Line, dash: [5, 5], strokeWidth: 1.5, color = milestone.color, opacity: 0.7
                    • +
                  +
                  • +
                +
                3. +
              3. +

                Позиционирование:

                +
                  +
                • Рассчитать X-позицию по дате вехи с использованием текущей шкалы времени (как для задач)
                  • +
                • Если дата вехи выходит за текущий диапазон — расширить диапазон (влияет на общую ширину таймлайна)
                  • +
                • При изменении масштаба (days/weeks/months/quarters) — пересчитать позиции всех вех
                  • +
                • При скролле — вехи скроллятся вместе с задачами
                  • +
                +
                4. +
              4. +

                Tooltip при наведении:

                +
                  +
                • При наведении на маркер или пунктирную линию — показать Konva.Tooltip или HTML tooltip: +
                    +
                  • Если веха одна на эту дату — показать название
                    • +
                  • Если несколько вех на одну дату — показать список: цветной кружок + название для каждой
                    • +
                  +
                  • +
                +
                5. +
              5. +

                Z-index:

                +
                  +
                • Линии вех рисуются поверх фона секций, но под задачами
                  • +
                • Маркеры-флажки — поверх всего (самый высокий z-index)
                  • +
                +
                6. +
              6. +

                Реактивность:

                +
                  +
                • При добавлении/удалении/редактировании вехи — перерисовать только вехи (без полного ре рендера задач)
                  • +
                • Подписаться на изменения массива milestones через сервис/store
                  • +
                +
                7. +
              +
              +
              +

              Порядок реализации

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              #ЭтапСторонаЗависимости
              1Миграция + ДоменBackend—
              2CRUD вехBackendЭтап 1
              3Включение вех в ответ диаграммыBackendЭтап 2
              4Модели + СервисFrontend— (параллельно с backend)
              5Модальное окно управления вехамиFrontendЭтапы 4 + backend 2
              6Отображение вех на таймлайнеFrontendЭтапы 4 + backend 3
              + +
              + +
              +
              +
              + +
              +
              +

              © 2026 docs.a2v.space

              +
              +
              + + + + + + + + + + + + + + + diff --git a/public/guides/leadera-section-constraints/index.html b/public/guides/leadera-section-constraints/index.html new file mode 100644 index 0000000..5b86458 --- /dev/null +++ b/public/guides/leadera-section-constraints/index.html @@ -0,0 +1,839 @@ + + + + + + Leadera: Ограничения секций в диаграмме Ганта — docs.a2v.space + + + + + + + + + + +
              + + + + +
              + + +
              +
              + + + + +
              + +
              +

              Leadera: Ограничения секций в диаграмме Ганта

              +
              + + 📁 ~/Projects/docs-a2v/content/guides/leadera-section-constraints.md + + +
              + + + +
              + + leadera + + gantt + + angular + + go + + api + + ux + +
              + + +

              Бизнес-требования

              +

              BR-1: Лимит одновременных задач (Concurrency Limit)

              +

              У каждой секции появляется параметр max_concurrent_tasks (целое число ≥ 0, по умолчанию 0).

              +

              Поведение:

              +
                +
              • Если max_concurrent_tasks = 3 — в любой данный день в этой секции не может быть больше 3 активных задач одновременно
                • +
              • Если max_concurrent_tasks = 0 — ограничение отключено, лимита нет
                • +
              • Пересечение считается по дате: задача занимает дни с start_date по end_date включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день
                • +
              • Ограничение работает только в рамках одной секции. Задачи из разных секций не влияют друг на друга
                • +
              +

              Срабатывание при:

              +
                +
              1. Создании задачи — если добавление нарушает лимит → Alert
                2. +
              2. Перетаскивании задачи (drag) — если новая позиция нарушает лимит → Alert
                3. +
              3. Растягивании задачи (resize) — если новый размер нарушает лимит → Alert
                4. +
              4. Редактировании задачи (форма) — если изменённые даты нарушают лимит → Alert
                5. +
              +

              Важно: Действие НЕ отменяется. Задача создаётся/перемещается в любом случае, но пользователь видит предупреждение.

              +

              Текст Alert: «В секции “[название секции]” на [дата/диапазон] превышен лимит одновременных задач (максимум: N)»

              +
              +

              BR-2: Блоки секций (Section Blocks)

              +

              У каждой секции появляется набор блоков — особый вид записей, отображаемых на таймлайне как заштрихованные области.

              +

              Сущность GanttSectionBlock:

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              ПолеТипОписание
              idUUIDИдентификатор
              section_idUUIDПринадлежность к секции
              titlestringНазвание (например: «Отпуск», «Командировка»)
              start_datedateНачало интервала (минимум 1 день)
              end_datedateКонец интервала
              block_concurrencybooleanЗапрещать ли пересечение обычных задач с данным блоком
              +

              Валидация:

              +
                +
              • end_date не может быть раньше start_date
                • +
              • Все поля обязательны
                • +
              • Блок может быть в прошлом
                • +
              +

              Визуальное отображение на Ганте:

              +
                +
              • Заштрихованная область на всю высоту секции (включая все строки задач в секции)
                • +
              • Название блока отображается поверх штриховки с подложкой (для читаемости)
                • +
              +

              Поведение block_concurrency:

              +
                +
              • Если block_concurrency = true — при пересечении задачи с данным блоком показывается Alert (аналогично BR-1), но задача всё равно создаётся/перемещается
                • +
              • Если block_concurrency = false — блок отображается визуально, но не влияет на задачи
                • +
              +

              Срабатывание при:

              +
                +
              1. Создании задачи — пересекает блок с block_concurrency = true → Alert
                2. +
              2. Перетаскивании задачи (drag) → Alert
                3. +
              3. Растягивании задачи (resize) → Alert
                4. +
              4. Редактировании задачи (форма) → Alert
                5. +
              +

              Текст Alert: «В секции “[название секции]” задача пересекает блок “[название блока]” ([дата] — [дата])»

              +
              +

              BR-3: Система Alert-ов

              +

              Все предупреждения (от BR-1 и BR-2) выводятся в единую область над диаграммой Ганта.

              +

              Поведение:

              +
                +
              • Alert-ы — Bootstrap Alert (warning), постоянные
                • +
              • Пользователь НЕ может закрыть Alert вручную
                • +
              • Alert исчезает автоматически, когда текущая дата прошла дату конфликта (конфликт больше не актуален)
                • +
              • Проверка конфликтов — только на фронтенде (на основе загруженных данных: задачи секции, блоки, max_concurrent_tasks)
                • +
              • Если Alert-ов много — область сворачиваемая с счётчиком в бейдже (например: «⚠️ 3 предупреждения»)
                • +
              • По умолчанию — развёрнуто
                • +
              • Сворачивание/разворачивание — клик по заголовку области
                • +
              +
              +

              BR-4: Настройки секции

              +
                +
              • Настройки совмещены с существующим модальным окном редактирования секции (не отдельное окно)
                • +
              +

              Окно создания секции — добавляется:

              +
                +
              • Поле «Макс. одновременных задач» (числовой ввод, 0 = без лимита, по умолчанию 0)
                • +
              +

              Окно редактирования секции — добавляется:

              +
                +
              • Поле «Макс. одновременных задач» (числовой ввод, 0 = без лимита)
                • +
              • Список блоков (таблица/список с CRUD: добавить, редактировать, удалить) +
                  +
                • Сортировка: по start_date по убыванию (будущее сверху)
                  • +
                • Каждый блок — форма: title, start_date, end_date, block_concurrency (чекбокс: «Запретить пересечение задач»)
                  • +
                • Валидация: end_date >= start_date, все поля заполнены
                  • +
                +
                • +
              +
              +

              BR-5: Наследование

              +
                +
              • При появлении функционала копирования/дублирования диаграммы — настройки секций (лимит + блоки) наследуются
                • +
              +
              +

              Технические требования

              +

              База данных

              +

              Новая таблица: gantt_section_blocks

              +
              CREATE TABLE gantt_section_blocks (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    section_id UUID NOT NULL REFERENCES gantt_sections(id) ON DELETE CASCADE,
+    title VARCHAR(255) NOT NULL,
+    start_date DATE NOT NULL,
+    end_date DATE NOT NULL,
+    block_concurrency BOOLEAN NOT NULL DEFAULT false,
+    created_by UUID NOT NULL REFERENCES users(id),
+    updated_by UUID NOT NULL REFERENCES users(id),
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    deleted_at TIMESTAMP WITH TIME ZONE,
+    CONSTRAINT chk_block_dates CHECK (end_date >= start_date)
+);
+
+CREATE INDEX idx_gantt_section_blocks_section ON gantt_section_blocks(section_id);
+CREATE INDEX idx_gantt_section_blocks_dates ON gantt_section_blocks(start_date, end_date);
+

              Изменение таблицы: gantt_sections

              +
              ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0;
+
              +

              Backend (Go API)

              +

              Этап 1: Миграция + Домен

              +

              Промт для агента:

              +
              +

              Добавь в проект новую таблицу gantt_section_blocks и колонку max_concurrent_tasks в gantt_sections.

              +
                +
              1. Создай миграцию в cmd/migrate/: +
                  +
                • Новая таблица gantt_section_blocks с полями: id (UUID PK), section_id (UUID FK → gantt_sections, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), start_date (DATE NOT NULL), end_date (DATE NOT NULL), block_concurrency (BOOLEAN DEFAULT false), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. CHECK constraint: end_date >= start_date. Индексы по section_id и (start_date, end_date).
                  • +
                • ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0.
                  • +
                +
                2. +
              2. Создай доменную модель GanttSectionBlock в internal/domain/gantt.go со всеми полями таблицы.
                3. +
              3. Добавь поле MaxConcurrentTasks int в структуру GanttSection.
                4. +
              4. Обнови маппинг в relevant repository файлах, чтобы новое поле max_concurrent_tasks читалось/писалось.
                5. +
              +
              +

              Этап 2: CRUD для GanttSectionBlocks

              +

              Промт для агента:

              +
              +

              Реализуй полный CRUD для сущности GanttSectionBlock по аналогии с существующими handlers/services/repositories в проекте.

              +

              Роуты (внутри группы секции):

              +
                +
              • GET /api/gantt-charts/:chartId/sections/:sectionId/blocks — список блоков секции
                • +
              • POST /api/gantt-charts/:chartId/sections/:sectionId/blocks — создать блок
                • +
              • PUT /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId — обновить блок
                • +
              • DELETE /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId — удалить блок (soft delete)
                • +
              +

              Repository: internal/repository/gantt_section_block_repository.go

              +
                +
              • GetBySectionID(ctx, sectionID) ([]domain.GanttSectionBlock, error)
                • +
              • GetByID(ctx, id) (*domain.GanttSectionBlock, error)
                • +
              • Create(ctx, block) error
                • +
              • Update(ctx, block) error
                • +
              • Delete(ctx, id) error — soft delete (set deleted_at)
                • +
              • Все запросы — raw SQL через pgx, как в остальных репозиториях проекта
                • +
              +

              Service: internal/service/gantt_section_block_service.go

              +
                +
              • Бизнес-логика: валидация dates (end >= start), проверка прав доступа к секции
                • +
              • Inject repository
                • +
              +

              Handler: internal/handler/gantt_section_block_handler.go

              +
                +
              • Swagger-аннотации для всех эндпоинтов
                • +
              • Валидация входных данных
                • +
              • Ошибки в формате проекта (GanttErrorResponse)
                • +
              +

              Модели запросов:

              +
                +
              • Create: title (required), start_date (required), end_date (required), block_concurrency (bool, default false)
                • +
              • Update: title, start_date, end_date, block_concurrency — все опциональны
                • +
              +
              +

              Этап 3: Обновление настроек секции

              +

              Промт для агента:

              +
              +

              Обнови CRUD секций (gantt_sections) для поддержки нового поля max_concurrent_tasks.

              +
                +
              1. Добавь max_concurrent_tasks в GanttSectionCreateRequest (опциональное, int ≥ 0, default 0)
                2. +
              2. Добавь max_concurrent_tasks в GanttSectionUpdateRequest (опциональное, int ≥ 0)
                3. +
              3. Обнови SQL-запросы в repository: INSERT и UPDATE должны включать max_concurrent_tasks
                4. +
              4. При GET секции (или списке секций) — возвращать max_concurrent_tasks в ответе
                5. +
              5. Валидация: значение должно быть ≥ 0
                6. +
              +
              +

              Этап 4: Включение блоков в ответ секций

              +

              Промт для агента:

              +
              +

              При запросе списка секций или одной секции включай связанные блоки в ответ.

              +
                +
              1. Обнови GET /api/gantt-charts/:chartId/sections/:sectionId — добавить поле blocks с массивом GanttSectionBlock
                2. +
              2. Обнови GET /api/gantt-charts/:chartId/sections — добавить поле blocks для каждой секции
                3. +
              3. Блоки с deleted_at IS NOT NULL не возвращаются
                4. +
              4. Блоки сортируются по start_date по убыванию (будущее сверху)
                5. +
              +
              +
              +

              Frontend (Angular)

              +

              Этап FE-1: Модели + Сервис

              +

              Промт для агента:

              +
              +

              Добавь в проект поддержку ограничений секций Ганта.

              +
                +
              1. В pages/gantt/models/gantt-chart.model.ts добавь:
                2. +
              +
              export interface GanttSectionBlock {
+  id: string;
+  section_id: string;
+  title: string;
+  start_date: string;
+  end_date: string;
+  block_concurrency: boolean;
+  created_by_user: UserInfo;
+  updated_by_user: UserInfo;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface GanttSectionBlockCreateRequest {
+  title: string;
+  start_date: string;
+  end_date: string;
+  block_concurrency?: boolean;
+}
+
+export interface GanttSectionBlockUpdateRequest {
+  title?: string;
+  start_date?: string;
+  end_date?: string;
+  block_concurrency?: boolean;
+}
+
+export interface ConflictCheck {
+  has_conflicts: boolean;
+  conflicts: ConflictItem[];
+}
+
+export interface ConflictItem {
+  type: 'concurrency' | 'block';
+  section_id: string;
+  section_title: string;
+  block_title?: string;
+  start_date?: string;
+  end_date?: string;
+  message: string;
+  dates?: string[];
+}
+
                +
              1. +

                Добавь max_concurrent_tasks: number в интерфейс GanttSection

                +
                2. +
              2. +

                Добавь blocks: GanttSectionBlock[] в интерфейс GanttSection

                +
                3. +
              3. +

                Добавь max_concurrent_tasks?: number в GanttSectionCreateRequest и GanttSectionUpdateRequest

                +
                4. +
              4. +

                Создай сервис pages/gantt/services/gantt-section-block.service.ts:

                +
                5. +
              +
                +
              • Inject HttpClient
                • +
              • Методы: getBlocks(chartId, sectionId), createBlock(chartId, sectionId, data), updateBlock(chartId, sectionId, blockId, data), deleteBlock(chartId, sectionId, blockId)
                • +
              • Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService)
                • +
              +
              +

              Этап FE-2: Интеграция в модальные окна секции

              +

              Промт для агента:

              +
              +

              Интегрируй настройки ограничений в существующие модальные окна создания и редактирования секции Ганта.

              +
                +
              1. Найди существующие компоненты модальных окон секции (создание/редактирование).
                2. +
              +

              Окно создания секции — добавить:

              +
                +
              • Числовой ввод: «Максимум одновременных задач»
                • +
              • Подсказка: «0 = без ограничений»
                • +
              • Валидация: число ≥ 0
                • +
              • Значение по умолчанию: 0
                • +
              • Отправляется в GanttSectionCreateRequest как max_concurrent_tasks
                • +
              +

              Окно редактирования секции — добавить:

              +
                +
              • Числовой ввод: «Максимум одновременных задач» (аналогично созданию)
                • +
              • Секция «Блоки (запретные интервалы)»: +
                  +
                • Таблица/список существующих блоков с колонками: Название, Начало, Конец, Блокировка (чекбокс/иконка), Действия (редактировать/удалить)
                  • +
                • Сортировка: по start_date по убыванию (будущее сверху)
                  • +
                • Кнопка «Добавить блок» — inline-форма: +
                    +
                  • title (текстовый ввод, обязательный)
                    • +
                  • start_date (datepicker, обязательный)
                    • +
                  • end_date (datepicker, обязательный)
                    • +
                  • block_concurrency (чекбокс: «Запретить пересечение задач»)
                    • +
                  • Валидация: end_date >= start_date, все поля заполнены
                    • +
                  +
                  • +
                • Редактирование — inline или через ту же форму
                  • +
                • Удаление — с подтверждением
                  • +
                +
                • +
              +
                +
              1. При открытии окна редактирования — загрузить текущие настройки секции + блоки
                2. +
              2. При сохранении — обновить max_concurrent_tasks и сохранить изменения блоков
                3. +
              3. Инжектировать GanttChartService и GanttSectionBlockService
                4. +
              +
              +

              Этап FE-3: Визуализация блоков на Ганте

              +

              Промт для агента:

              +
              +

              Отобрази блоки секций (GanttSectionBlock) на canvas-диаграмме Ганта.

              +

              Проект использует Konva.js для рендеринга. Основной компонент: gantt-chart-canvas.

              +
                +
              1. При загрузке данных диаграммы — извлечь блоки из каждой секции
                2. +
              2. В рендерере секций (canvas/timeline-renderer.ts или аналогичный) — для каждого блока: +
                  +
                • Нарисовать заштрихованную область (diagonal hatch pattern) на всю высоту секции (все строки задач в этой секции)
                  • +
                • Область ограничена по горизонтали: от start_date до end_date (в пикселях по шкале времени)
                  • +
                • Цвет штриховки: полупрозрачный серый или configurable
                  • +
                • Поверх штриховки — текст с названием блока (block.title) на подложке (прямоугольник с фоном, чтобы текст читался)
                  • +
                +
                3. +
              3. Блоки рендерятся до задач (z-index ниже), чтобы задачи были поверх
                4. +
              4. Блоки с block_concurrency = true и false визуально не отличаются (штриховка одинаковая)
                5. +
              5. При скролле/зуме — блоки пересчитываются как обычные элементы таймлайна
                6. +
              +
              +

              Этап FE-4: Система Alert-ов

              +

              Промт для агента:

              +
              +

              Создай компонент для отображения Alert-ов о конфликтах на диаграмме Ганта.

              +
                +
              1. +

                Создай компонент pages/gantt/components/gantt-conflict-alerts/

                +
                2. +
              2. +

                Компонент размещается над canvas-диаграммой Ганта

                +
                3. +
              3. +

                Входные данные: массив ConflictItem[] (из модели)

                +
                4. +
              4. +

                Визуал:

                +
                  +
                • Bootstrap Alert (warning) для каждого конфликта
                  • +
                • Каждый Alert показывает message из ConflictItem
                  • +
                • Без кнопки закрытия — Alert нельзя закрыть вручную
                  • +
                • Alert исчезает автоматически, когда текущая дата прошла дату конфликта
                  • +
                • Область сворачиваемая: заголовок «⚠️ Предупреждения (N)» — клик сворачивает/разворачивает список
                  • +
                • По умолчанию — развёрнуто
                  • +
                • При 0 конфликтов — область скрыта
                  • +
                +
                5. +
              5. +

                Состояние хранится в сервисе или в компоненте диаграммы:

                +
                  +
                • Добавление нового конфликта → area auto-expands
                  • +
                • Alert удаляется из массива автоматически, когда текущая дата прошла дату конфликта
                  • +
                • Проверка актуальности конфликтов — при каждой отрисовке / изменении данных
                  • +
                • Не использовать toast — Alert-ы постоянные
                  • +
                +
                6. +
              +
              +

              Этап FE-5: Проверка конфликтов при операциях с задачами

              +

              Промт для агента:

              +
              +

              Интегрируй проверку конфликтов во все операции с задачами на диаграмме Ганта.

              +

              Проект использует interaction-handler.ts для drag/resize и формы для создания/редактирования.

              +

              Важно: Проверка конфликтов — только на фронтенде, без вызова API. Используются загруженные данные секции (задачи, блоки, max_concurrent_tasks).

              +
                +
              1. +

                Вынеси логику проверки конфликтов checkConflicts() в отдельный метод в gantt-canvas.service.ts:

                +
                  +
                • Принимает: section (GanttSection — содержит max_concurrent_tasks и blocks), tasks (GanttTask[] — задачи секции), task_id (nullable — исключить текущую задачу), start_date, end_date
                  • +
                • Логика: +a. Если section.max_concurrent_tasks > 0: посчитать кол-во задач (исключая task_id), пересекающихся с [start_date, end_date] на каждый день. Если в любой день count > max_concurrent_tasks — добавить конфликт concurrency +b. Для каждого блока секции с block_concurrency = true, пересекающегося с [start_date, end_date] — добавить конфликт block
                  • +
                • Возвращает ConflictCheck
                  • +
                +
                2. +
              2. +

                После каждой успешной операции с задачей (создание, обновление, drag, resize):

                +
                  +
                • Вызвать checkConflicts с параметрами задачи
                  • +
                • Если has_conflicts = true — передать конфликты в GanttConflictAlertsComponent
                  • +
                • Alert-ы показываются, действие НЕ отменяется
                  • +
                +
                3. +
              3. +

                Точки интеграции:

                +
                  +
                • Создание задачи (форма): после успешного POST → checkConflicts → show alerts
                  • +
                • Редактирование задачи (форма): после успешного PUT → checkConflicts → show alerts
                  • +
                • Drag задачи (interaction-handler.ts): после успешного обновления позиции → checkConflicts → show alerts
                  • +
                • Resize задачи (interaction-handler.ts): после успешного обновления размера → checkConflicts → show alerts
                  • +
                +
                4. +
              4. +

                При переключении диаграммы или секции — очищать Alert-ы

                +
                5. +
              5. +

                Alert-ы автоматически удаляются, когда текущая дата прошла дату конфликта — область скрывается, когда конфликтов не осталось

                +
                6. +
              +
              +
              +

              Порядок реализации

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              #ЭтапСторонаЗависимости
              1Миграция + ДоменBackend—
              2CRUD блоковBackendЭтап 1
              3Обновление настроек секцииBackendЭтап 1
              4Включение блоков в ответ секцийBackendЭтап 2
              5Модели + СервисFrontend— (можно параллельно с backend)
              6Интеграция в модальные окнаFrontendЭтапы 5 + backend 2,3
              7Визуализация блоков на ГантеFrontendЭтапы 5 + backend 4
              8Система Alert-овFrontendЭтап 5
              9Проверка конфликтов при операцияхFrontendЭтапы 5,7,8
              + +
              + +
              +
              +
              + +
              +
              +

              © 2026 docs.a2v.space

              +
              +
              + + + + + + + + + + + + + + + diff --git a/public/guides/leadera-websocket-gantt/index.html b/public/guides/leadera-websocket-gantt/index.html new file mode 100644 index 0000000..ae55794 --- /dev/null +++ b/public/guides/leadera-websocket-gantt/index.html @@ -0,0 +1,1100 @@ + + + + + + Leadera — WebSocket для диаграмм Ганта — docs.a2v.space + + + + + + + + + + +
              + + + + +
              + + +
              +
              + + + + +
              + +
              +

              Leadera — WebSocket для диаграмм Ганта

              +
              + + 📁 ~/Projects/docs-a2v/content/guides/leadera-websocket-gantt.md + + +
              + + + +
              + + leadera + + websocket + + realtime + + gantt + + architecture + +
              + + +

              WebSocket для диаграмм Ганта — realtime-совместное редактирование

              +

              Дата: 07.04.2026 +Статус: Планирование +Проект: Leadera (dev — sand.a2v.space)

              +
              +

              1. Постановка задачи

              +

              Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.

              +
              +

              2. Архитектура

              +
              Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL
+       │                                │
+       │  HTTP (мутации)                │  Broadcast
+       └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты
+

              Ключевой принцип: мутации данных идут через HTTP (REST), WebSocket используется только для доставки уведомлений. Сервер — источник истины, клиент не может обойти проверки через WS.

              +

              Комнаты

              +

              Каждый открытый Гант — это «комната» с идентификатором chartId. При подключении клиент подписывается на комнату. Hub рассылает события всем подписчикам комнаты.

              +
              +

              3. Backend (Go)

              +

              3.1. Зависимости

              +
              go get github.com/gorilla/websocket
+

              3.2. Новые файлы — internal/ws/

              +

              message.go — типы сообщений

              +
              package ws
+
+import "time"
+
+// EventType — тип события
+type EventType string
+
+const (
+    // Данные
+    EventSectionCreated     EventType = "section_created"
+    EventSectionUpdated     EventType = "section_updated"
+    EventSectionDeleted     EventType = "section_deleted"
+    EventSectionsReordered  EventType = "sections_reordered"
+    EventTaskCreated        EventType = "task_created"
+    EventTaskUpdated        EventType = "task_updated"
+    EventTaskDeleted        EventType = "task_deleted"
+
+    // Присутствие
+    EventUserJoined         EventType = "user_joined"
+    EventUserLeft           EventType = "user_left"
+
+    // Безопасность / доступ
+    EventAccessRevoked      EventType = "access_revoked"
+    EventChartArchived      EventType = "chart_archived"
+    EventRoleChanged        EventType = "role_changed"
+    EventTokenExpired       EventType = "token_expired"
+)
+
+// Event — WS-событие, отправляемое клиентам
+type Event struct {
+    Type      EventType   `json:"type"`
+    ChartID   string      `json:"chartId"`
+    UserID    string      `json:"userId,omitempty"`
+    Payload   interface{} `json:"payload,omitempty"`
+    Timestamp time.Time   `json:"timestamp"`
+}
+
+// IncomingMessage — сообщение от клиента (для ping/pong)
+type IncomingMessage struct {
+    Type string `json:"type"`
+}
+

              hub.go — центральный брокер

              +
              package ws
+
+import (
+    "sync"
+)
+
+// Hub управляет комнатами и рассылкой событий
+type Hub struct {
+    mu      sync.RWMutex
+    rooms   map[string]map[*Client]bool // chartId → клиенты
+}
+
+func NewHub() *Hub {
+    return &Hub{
+        rooms: make(map[string]map[*Client]bool),
+    }
+}
+
+// Subscribe добавляет клиента в комнату
+func (h *Hub) Subscribe(chartID string, client *Client) {
+    h.mu.Lock()
+    defer h.mu.Unlock()
+
+    if h.rooms[chartID] == nil {
+        h.rooms[chartID] = make(map[*Client]bool)
+    }
+    h.rooms[chartID][client] = true
+
+    // Уведомить остальных: user_joined
+    h.broadcastExcept(chartID, client, Event{
+        Type:      EventUserJoined,
+        ChartID:   chartID,
+        UserID:    client.UserID,
+        Payload:   map[string]string{"username": client.Username},
+        Timestamp: time.Now(),
+    })
+}
+
+// Unsubscribe удаляет клиента из комнаты
+func (h *Hub) Unsubscribe(chartID string, client *Client) {
+    h.mu.Lock()
+    defer h.mu.Unlock()
+
+    if clients, ok := h.rooms[chartID]; ok {
+        delete(clients, client)
+        if len(clients) == 0 {
+            delete(h.rooms, chartID)
+        }
+    }
+
+    // Уведомить остальных: user_left
+    h.broadcastExcept(chartID, client, Event{
+        Type:      EventUserLeft,
+        ChartID:   chartID,
+        UserID:    client.UserID,
+        Timestamp: time.Now(),
+    })
+}
+
+// Broadcast рассылает событие всем клиентам в комнате
+func (h *Hub) Broadcast(chartID string, event Event) {
+    h.mu.RLock()
+    defer h.mu.RUnlock()
+
+    if clients, ok := h.rooms[chartID]; ok {
+        for client := range clients {
+            client.Send(event)
+        }
+    }
+}
+
+// SendToUser отправляет событие конкретному пользователю во всех его комнатах
+func (h *Hub) SendToUser(userID string, event Event) {
+    h.mu.RLock()
+    defer h.mu.RUnlock()
+
+    for _, clients := range h.rooms {
+        for client := range clients {
+            if client.UserID == userID {
+                client.Send(event)
+            }
+        }
+    }
+}
+
+// broadcastExcept рассылает всем, кроме отправителя
+func (h *Hub) broadcastExcept(chartID string, sender *Client, event Event) {
+    if clients, ok := h.rooms[chartID]; ok {
+        for client := range clients {
+            if client != sender {
+                client.Send(event)
+            }
+        }
+    }
+}
+

              client.go — обёртка WS-соединения

              +
              package ws
+
+import (
+    "encoding/json"
+    "sync"
+    "time"
+
+    "github.com/gorilla/websocket"
+)
+
+const (
+    writeWait      = 10 * time.Second
+    pongWait       = 60 * time.Second
+    pingPeriod     = (pongWait * 9) / 10
+    maxMessageSize = 1024
+)
+
+type Client struct {
+    Hub      *Hub
+    Conn     *websocket.Conn
+    UserID   string
+    Username string
+    ChartID  string
+    SendCh   chan Event
+    mu       sync.Mutex
+}
+
+func NewClient(hub *Hub, conn *websocket.Conn, userID, username, chartID string) *Client {
+    return &Client{
+        Hub:      hub,
+        Conn:     conn,
+        UserID:   userID,
+        Username: username,
+        ChartID:  chartID,
+        SendCh:   make(chan Event, 64),
+    }
+}
+
+// ReadPump читает входящие сообщения (ping/pong)
+func (c *Client) ReadPump() {
+    defer func() {
+        c.Hub.Unsubscribe(c.ChartID, c)
+        c.Conn.Close()
+    }()
+
+    c.Conn.SetReadLimit(maxMessageSize)
+    c.Conn.SetReadDeadline(time.Now().Add(pongWait))
+    c.Conn.SetPongHandler(func(string) error {
+        c.Conn.SetReadDeadline(time.Now().Add(pongWait))
+        return nil
+    })
+
+    for {
+        _, message, err := c.Conn.ReadMessage()
+        if err != nil {
+            break
+        }
+        // Клиент может слать только ping, данные игнорируем
+        _ = message
+    }
+}
+
+// WritePump отправляет события клиенту
+func (c *Client) WritePump() {
+    ticker := time.NewTicker(pingPeriod)
+    defer func() {
+        ticker.Stop()
+        c.Conn.Close()
+    }()
+
+    for {
+        select {
+        case event, ok := <-c.SendCh:
+            c.Conn.SetWriteDeadline(time.Now().Add(writeWait))
+            if !ok {
+                c.Conn.WriteMessage(websocket.CloseMessage, []byte{})
+                return
+            }
+            data, _ := json.Marshal(event)
+            c.mu.Lock()
+            c.Conn.WriteMessage(websocket.TextMessage, data)
+            c.mu.Unlock()
+
+        case <-ticker.C:
+            c.Conn.SetWriteDeadline(time.Now().Add(writeWait))
+            if err := c.Conn.WriteMessage(websocket.PingMessage, nil); err != nil {
+                return
+            }
+        }
+    }
+}
+
+// Send ставит событие в очередь отправки
+func (c *Client) Send(event Event) {
+    select {
+    case c.SendCh <- event:
+    default:
+        // Очередь полна — отключаем медленного клиента
+        close(c.SendCh)
+    }
+}
+

              3.3. WS endpoint — internal/handlers/ws_handler.go

              +
              package handlers
+
+import (
+    "net/http"
+    "time"
+
+    "app-leadera-api/internal/middleware"
+    "app-leadera-api/internal/ws"
+
+    "github.com/gin-gonic/gin"
+    "github.com/google/uuid"
+    "github.com/gorilla/websocket"
+)
+
+var upgrader = websocket.Upgrader{
+    ReadBufferSize:  1024,
+    WriteBufferSize: 1024,
+    CheckOrigin:     func(r *http.Request) bool { return true }, // nginx проксирует
+}
+
+type WSHandler struct {
+    hub      *ws.Hub
+    ganttMW  *middleware.GanttMiddleware
+}
+
+func NewWSHandler(hub *ws.Hub, ganttMW *middleware.GanttMiddleware) *WSHandler {
+    return &WSHandler{hub: hub, ganttMW: ganttMW}
+}
+
+func (h *WSHandler) HandleGanttWS(c *gin.Context) {
+    // 1. Получить пользователя из контекста (auth middleware уже отработал)
+    userID, exists := c.Get("userID")
+    if !exists {
+        c.AbortWithStatusJSON(401, gin.H{"error": "unauthorized"})
+        return
+    }
+
+    // 2. Проверить доступ к chartId (gantt middleware)
+    chartID := c.Param("chartId")
+    if _, err := uuid.Parse(chartID); err != nil {
+        c.AbortWithStatusJSON(400, gin.H{"error": "invalid chart id"})
+        return
+    }
+    // TODO: проверить через ganttMW что userID имеет доступ к этому chart
+
+    // 3. Upgrade до WebSocket
+    conn, err := upgrader.Upgrade(c.Writer, c.Request, nil)
+    if err != nil {
+        return
+    }
+
+    // 4. Создать клиент и подписать на комнату
+    client := ws.NewClient(
+        h.hub, conn,
+        userID.(string),
+        c.GetString("username"),
+        chartID,
+    )
+    h.hub.Subscribe(chartID, client)
+
+    // 5. Запустить pump'ы
+    go client.WritePump()
+    go client.ReadPump()
+}
+

              3.4. Регистрация маршрута

              +

              В cmd/server/main.go или где регистрируются routes:

              +
              // После создания hub
+wsHub := ws.NewHub()
+
+// WS endpoint
+wsHandler := handlers.NewWSHandler(wsHub, ganttMW)
+api.GET("/ws/gantt/:chartId", authMW.RequireAuth(), wsHandler.HandleGanttWS)
+
+// Передать hub в ganttHandler для broadcast'ов
+ganttHandler := handlers.NewGanttHandler(ganttService, sectionService, taskService, blockService, wsHub)
+

              3.5. Интеграция broadcast в handlers

              +

              В каждый write-handler — одна строка после успешной операции:

              +
              // Пример: после успешного UpdateTask
+h.hub.Broadcast(chartID, ws.Event{
+    Type:      ws.EventTaskUpdated,
+    ChartID:   chartID,
+    UserID:    userID,
+    Payload:   updatedTask,
+    Timestamp: time.Now(),
+})
+

              Точки интеграции в gantt_handler.go:

              +
                +
              • CreateGanttChart → не нужен (пользователь только что создал, он один)
                • +
              • UpdateGanttChart / ArchiveGanttChart → chart_archived
                • +
              • CreateSection → section_created
                • +
              • UpdateSection → section_updated
                • +
              • DeleteSection → section_deleted
                • +
              • ReorderSections → sections_reordered
                • +
              • CreateTask → task_created
                • +
              • UpdateTask → task_updated
                • +
              • DeleteTask → task_deleted
                • +
              +

              3.6. Интеграция событий безопасности

              +

              В соответствующих service-методах:

              +
              // При исключении из space (SpaceService.RemoveMember)
+wsHub.SendToUser(removedUserID, ws.Event{
+    Type:    ws.EventAccessRevoked,
+    Payload: map[string]string{"spaceId": spaceID},
+})
+
+// При архивации ганта
+wsHub.Broadcast(chartID, ws.Event{
+    Type:    ws.EventChartArchived,
+    ChartID: chartID,
+})
+
+// При изменении роли
+wsHub.SendToUser(userID, ws.Event{
+    Type:    ws.EventRoleChanged,
+    Payload: map[string]string{"role": newRole},
+})
+
              +

              4. Frontend (Angular)

              +

              4.1. WebSocket сервис — gantt-ws.service.ts

              +
              // src/app/pages/gantt/services/gantt-ws.service.ts
+
+import { Injectable, inject, OnDestroy } from '@angular/core';
+import { Subject, Observable } from 'rxjs';
+import { environment } from '../../../environments/environment';
+import { SpaceStorageService } from '../../../core/services/space-storage.service';
+import { AuthService } from '../../../core/auth/services/auth.service';
+
+export interface WSEvent {
+  type: string;
+  chartId?: string;
+  userId?: string;
+  payload?: any;
+  timestamp?: string;
+}
+
+@Injectable({ providedIn: 'root' })
+export class GanttWSService implements OnDestroy {
+  private spaceStorage = inject(SpaceStorageService);
+  private auth = inject(AuthService);
+
+  private socket: WebSocket | null = null;
+  private eventSubject = new Subject<WSEvent>();
+  private reconnectTimer: any;
+  private chartId: string | null = null;
+
+  /** Observable для подписки на события */
+  get events$(): Observable<WSEvent> {
+    return this.eventSubject.asObservable();
+  }
+
+  /** Подключиться к комнате ганта */
+  connect(chartId: string): void {
+    this.disconnect();
+    this.chartId = chartId;
+
+    const token = this.auth.getAccessToken();
+    const wsUrl = this.buildWSUrl(chartId, token);
+
+    this.socket = new WebSocket(wsUrl);
+
+    this.socket.onopen = () => {
+      console.log(`[WS] Connected to gantt ${chartId}`);
+    };
+
+    this.socket.onmessage = (msg) => {
+      try {
+        const event: WSEvent = JSON.parse(msg.data);
+        this.eventSubject.next(event);
+      } catch (e) {
+        console.error('[WS] Parse error', e);
+      }
+    };
+
+    this.socket.onclose = (event) => {
+      console.log(`[WS] Closed: ${event.code}`);
+      if (event.code !== 1000) {
+        this.scheduleReconnect();
+      }
+    };
+
+    this.socket.onerror = () => {
+      this.socket?.close();
+    };
+  }
+
+  /** Отключиться */
+  disconnect(): void {
+    clearTimeout(this.reconnectTimer);
+    if (this.socket) {
+      this.socket.close(1000, 'manual');
+      this.socket = null;
+    }
+    this.chartId = null;
+  }
+
+  ngOnDestroy(): void {
+    this.disconnect();
+  }
+
+  private buildWSUrl(chartId: string, token: string): string {
+    const base = environment.wsUrl || 
+      location.protocol.replace('http', 'ws') + '//' + location.host;
+    return `${base}/api/v1/ws/gantt/${chartId}?token=${token}`;
+  }
+
+  private scheduleReconnect(): void {
+    if (!this.chartId) return;
+    this.reconnectTimer = setTimeout(() => {
+      console.log('[WS] Reconnecting...');
+      if (this.chartId) this.connect(this.chartId);
+    }, 3000);
+  }
+}
+

              4.2. Интеграция в gantt-chart-canvas компонент

              +
              // В gantt-chart-canvas.component.ts
+
+export class GanttChartCanvasComponent implements OnInit, OnDestroy {
+  private ws = inject(GanttWSService);
+  private onlineUsers: Set<string> = new Set();
+  private wsSubscription: Subscription | null = null;
+
+  ngOnInit(): void {
+    // Подключиться к WS при загрузке ганта
+    this.ws.connect(this.chartId);
+    this.wsSubscription = this.ws.events$.subscribe(event => {
+      this.handleWSEvent(event);
+    });
+  }
+
+  ngOnDestroy(): void {
+    this.wsSubscription?.unsubscribe();
+    this.ws.disconnect();
+  }
+
+  private handleWSEvent(event: WSEvent): void {
+    // Если это событие от текущего пользователя — пропускаем
+    // (мы уже обновили UI оптимистично или после HTTP-ответа)
+    if (event.userId === this.currentUserId) return;
+
+    switch (event.type) {
+      case 'section_created':
+        this.addSectionLocal(event.payload);
+        this.redrawCanvas();
+        break;
+
+      case 'section_updated':
+        this.updateSectionLocal(event.payload);
+        this.redrawCanvas();
+        break;
+
+      case 'section_deleted':
+        this.removeSectionLocal(event.payload.id);
+        this.redrawCanvas();
+        break;
+
+      case 'sections_reordered':
+        this.reorderSectionsLocal(event.payload.ordered_ids);
+        this.redrawCanvas();
+        break;
+
+      case 'task_created':
+        this.addTaskLocal(event.payload);
+        this.redrawCanvas();
+        break;
+
+      case 'task_updated':
+        this.updateTaskLocal(event.payload);
+        this.redrawCanvas();
+        break;
+
+      case 'task_deleted':
+        this.removeTaskLocal(event.payload.id);
+        this.redrawCanvas();
+        break;
+
+      case 'user_joined':
+        this.onlineUsers.add(event.userId!);
+        this.showOnlineIndicator();
+        break;
+
+      case 'user_left':
+        this.onlineUsers.delete(event.userId!);
+        this.showOnlineIndicator();
+        break;
+
+      // === Безопасность ===
+      case 'access_revoked':
+        this.router.navigate(['/gantt'], {
+          state: { alert: 'Доступ к пространству был отозван' }
+        });
+        break;
+
+      case 'chart_archived':
+        this.router.navigate(['/gantt'], {
+          state: { alert: 'Диаграмма была заархивирована' }
+        });
+        break;
+
+      case 'role_changed':
+        this.currentRole = event.payload.role;
+        this.updateEditableState();
+        break;
+
+      case 'token_expired':
+        this.router.navigate(['/auth/login']);
+        break;
+    }
+  }
+
+  private redrawCanvas(): void {
+    // Перерисовать Konva canvas с обновлёнными данными
+  }
+}
+

              4.3. Индикатор онлайн-пользователей

              +

              Добавить в шаблон canvas-компонента:

              +
              <!-- Онлайн-индикатор -->
+<div class="online-indicator" *ngIf="onlineUsers.size > 0">
+  <span class="pulse-dot"></span>
+  {{ onlineUsers.size }} онлайн
+</div>
+
              +

              5. Безопасность

              +

              5.1. Авторизация при подключении

              + + + + + + + + + + + + + + + + + + + + + +
              ЭтапПроверка
              WS HandshakeJWT в query-параметре ?token=...
              Подписка на комнатуПроверка membership в space
              Каждое broadcast-событиеHub знает userId каждого клиента
              +

              5.2. Сценарии отзыва доступа

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              СобытиеТриггерДействие на клиенте
              access_revokedИсключение из spaceРедирект на список гантов
              chart_archivedАрхивация гантаРедирект на список гантов
              role_changedСмена роли (editor→viewer)Отключить редактирование
              token_expiredТокен протухРедирект на логин
              +

              5.3. Защита от злоупотреблений

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              УгрозаМера
              Спам WS-сообщенийRate limit: 30 msg/min на клиента, ReadLimit в gorilla/websocket
              Подключение без правПроверка space membership при handshake
              Истёкший токенPing/pong + периодическая проверка JWT (раз в 5 мин)
              XSS через WSPayload — JSON, sanitize имён на frontend
              Мутации через WSWS только для чтения (уведомления). Мутации — через HTTP API с полной валидацией
              +

              5.4. Nginx конфигурация

              +

              В конфиг sand.a2v.space добавить:

              +
              # WebSocket проксирование
+location /api/v1/ws/ {
+    proxy_pass http://127.0.0.1:8080;
+    proxy_http_version 1.1;
+    proxy_set_header Upgrade $http_upgrade;
+    proxy_set_header Connection "upgrade";
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_read_timeout 86400s;  # 24h для long-lived WS
+    proxy_send_timeout 86400s;
+}
+
              +

              6. Оценка трудозатрат

              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              КомпонентСтроки кодаВремя
              internal/ws/ (hub, client, message)~2002-3 часа
              ws_handler.go (endpoint)~6030 мин
              Интеграция broadcast в handlers~20 (по строке на endpoint)30 мин
              События безопасности в services~3030 мин
              gantt-ws.service.ts (Angular)~801 час
              Интеграция в canvas-компонент~801-2 часа
              Индикатор онлайн~3030 мин
              Nginx конфигурация~1010 мин
              Тестирование—2-3 часа
              Итого~510 строк~1-2 дня
              +
              +

              7. Порядок реализации

              +
                +
              1. Backend: internal/ws/ — hub, client, message types
                2. +
              2. Backend: WS endpoint — handler + route
                3. +
              3. Backend: Broadcast в handlers — интеграция в существующие CRUD-эндпоинты
                4. +
              4. Backend: События безопасности — access_revoked, chart_archived, role_changed
                5. +
              5. Nginx: WS location — проксирование WebSocket
                6. +
              6. Frontend: WS service — подключение, реконнект, парсинг событий
                7. +
              7. Frontend: Интеграция в canvas — обработка событий, обновление Konva
                8. +
              8. Frontend: Индикатор онлайн — визуальная обратная связь
                9. +
              9. Тестирование — многопользовательский сценарий, отзыв прав, обрывы связи
                10. +
              +
              +

              8. Дальнейшие улучшения (после MVP)

              +
                +
              • Cursor других пользователей — показывать позицию курсора на таймлайне
                • +
              • Блокировка элемента — «кто-то редактирует эту задачу» (optimistic locking через WS)
                • +
              • Чат в ганте — комментарии к задачам прямо на канвасе
                • +
              • History/undo — откат изменений с визуальной историей
                • +
              • Уведомления — push-уведомления при @mention в комментариях к задачам
                • +
              + +
              + +
              +
              +
              + +
              +
              +

              © 2026 docs.a2v.space

              +
              +
              + + + + + + + + + + + + + + + diff --git a/public/guides/sand-a2v-space/index.html b/public/guides/sand-a2v-space/index.html index 6d53c42..09e889c 100644 --- a/public/guides/sand-a2v-space/index.html +++ b/public/guides/sand-a2v-space/index.html @@ -38,6 +38,10 @@ Планы +
            • + Leadera +
              • +
            • Инструкции
              • @@ -110,16 +114,6 @@ - - - - - - - - - - @@ -166,14 +160,6 @@
              Теги
                -
              • audit
                • - -
              • leadera
                • - -
              • security
                • - -
              • architecture
                • -
              • ssh
              • tunnel
                • @@ -209,6 +195,15 @@

                Подключение sand.a2v.space (Leadera Project)

                +
                + + 📁 ~/Projects/docs-a2v/content/guides/sand-a2v-space.md + + +
                +
                diff --git a/public/guides/ssh-tunnels-vps/index.html b/public/guides/ssh-tunnels-vps/index.html index 6fea952..84bd0e8 100644 --- a/public/guides/ssh-tunnels-vps/index.html +++ b/public/guides/ssh-tunnels-vps/index.html @@ -38,6 +38,10 @@ Планы +
              • + Leadera +
                • +
              • Инструкции
                • @@ -110,16 +114,6 @@ - - - - - - - - - - @@ -166,14 +160,6 @@
                Теги
                  -
                • audit
                  • - -
                • leadera
                  • - -
                • security
                  • - -
                • architecture
                  • -
                • ssh
                • tunnel
                  • @@ -209,6 +195,15 @@

                  SSH туннели для VPS reverse proxy

                  +
                  + + 📁 ~/Projects/docs-a2v/content/guides/ssh-tunnels-vps.md + + +
                  +
                  diff --git a/public/guides/vps-reverse-proxy/index.html b/public/guides/vps-reverse-proxy/index.html index fd973a9..a041b0c 100644 --- a/public/guides/vps-reverse-proxy/index.html +++ b/public/guides/vps-reverse-proxy/index.html @@ -38,6 +38,10 @@ Планы +
                • + Leadera +
                  • +
                • Инструкции
                  • @@ -110,16 +114,6 @@ - - - - - - - - - - @@ -166,14 +160,6 @@
                  Теги
                    -
                  • audit
                    • - -
                  • leadera
                    • - -
                  • security
                    • - -
                  • architecture
                    • -
                  • ssh
                  • tunnel
                    • @@ -209,6 +195,15 @@

                    Настройка VPS как реверс-прокси

                    +
                    + + 📁 ~/Projects/docs-a2v/content/guides/vps-reverse-proxy.md + + +
                    +
                    diff --git a/public/index.html b/public/index.html index 04eb396..e5fe127 100644 --- a/public/index.html +++ b/public/index.html @@ -39,6 +39,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -95,6 +99,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • diff --git a/public/index.json b/public/index.json index bcc4bac..ebd1f00 100644 --- a/public/index.json +++ b/public/index.json @@ -1 +1 @@ -[{"content":"Аудит проекта Leadera Дата: 30.03.2026\nВерсия: pre-production, миграции 1–5\n1. Обзор проекта Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.\nСтек Компонент Технологии Backend Go 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256) Frontend Angular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals Инфраструктура Docker (Colima), pm2, nginx reverse proxy, VPS reg.ru Доменная модель User ──┬── Space (через space_members с role) │ └── GanttChart (принадлежит Space) ├── GanttSection └── GanttTask Роли: admin, editor, viewer — назначаются на уровне Space через таблицу space_members.\nЧто реализовано (endpoints) Auth (5): register, login, refresh, change-password, logout\nSpaces (9): CRUD + members CRUD\nGantt Charts (9): CRUD + archive + members (добавлен, но удалён в миграции 5)\nGantt Sections (5): CRUD + reorder\nGantt Tasks (4): CRUD\nИтого: ~32 endpoint\n2. Архитектура и качество кода 2.1. Backend — структура cmd/server/main.go — точка входа internal/ domain/ — модели (User, Space, GanttChart, etc.) dto/ — request/response DTO (auth, space, gantt) handlers/ — HTTP handlers (auth, space, gantt) middleware/ — auth, cors, space, gantt, role, logging, recovery repository/ — слой доступа к данным service/ — бизнес-логика config/ — конфигурация (.env) utils/ — jwt, password, response, validation migrations/ — SQL миграции (1-5) Оценка: ✅ Чистая layered архитектура. Разделение ответственности чёткое.\n2.2. Frontend — структура src/app/ core/auth/ — auth service, interceptor core/models/ — app.model, space.model core/services/ — space.service, space-storage.service pages/auth/ — sign-in, sign-up, reset-pw, etc. pages/gantt/ — компоненты, модалки, сервисы, модели pages/dashboards/ — spaces list, dashboard layouts/ — navbar, topbar, main-layout Оценка: ✅ Стандартная Angular-структура. Signals для state management.\n2.3. Проблемы кода # Проблема Критичность Описание C1 \\r в service-файлах Medium gantt_service.go, gantt_section_service.go содержат CRLF C2 main.go:238 — мёртвый код getUserHandler Low Неиспользуемая функция C3 Swagger не сгенерирован Medium Аннотации есть, но api/ директории нет C4 RegisterProtectedRoutes не вызывается в main.go Critical GET/PUT/DELETE /spaces/:id не зарегистрированы 3. Права доступа — главный вопрос 3.1. Текущая реализация Права назначаются исключительно через Space:\nТаблица space_members — связка user ↔ space с role (admin/editor/viewer) SpaceMiddleware.RequireSpace() — проверяет членство и записывает ContextSpaceRole в context RoleMiddleware.RequireMinRole() — проверяет иерархию ролей (admin \u0026gt; editor \u0026gt; viewer) Диаграммы Ганта НЕ имеют собственной системы ролей. Таблица gantt_chart_members была создана (миграция 4) и тут же удалена (миграция 5). Все проверки доступа к диаграммам идут через space membership.\n3.2. Как это работает Запрос → AuthMiddleware (JWT → userID) → SpaceMiddleware.RequireSpace() (проверяет space_members → ContextSpaceRole) → GanttMiddleware.RequireGanttChart() (проверяет chart.space_id == spaceID) → RoleMiddleware.RequireMinRole(\u0026#34;editor\u0026#34;) (проверяет ContextSpaceRole) Это правильно. Любой член Space с ролью editor+ может создавать/редактировать диаграммы. Viewers — только читать.\n3.3. 🔴 Критическая проблема: Frontend не соответствует Backend Frontend MembersModalComponent пытается управлять участниками диаграммы:\nganttService.addMember(chartId, dto) → /api/v1/spaces/{spaceId}/gantt-charts/{chartId}/members ganttService.updateMemberRole(chartId, userId, dto) → .../members/{userId} ganttService.removeMember(chartId, userId) → .../members/{userId} Backend GanttHandler.RegisterRoutes() НЕ регистрирует маршруты для members диаграмм. После удаления gantt_chart_members (миграция 5) эти endpoints не существуют.\nРезультат: модальное окно «Участники диаграммы» на фронтенде не работает — все вызовы вернут 404.\n3.4. 🔴 Проблема: Role fallback В role_middleware.go:28-31:\nrole := c.GetString(ContextSpaceRole) if role == \u0026#34;\u0026#34; { role = c.GetString(ContextRole) // fallback на глобальную роль User } Если ContextSpaceRole не установлен, используется глобальная роль пользователя (из JWT). Это значит:\nПользователь с role=admin в таблице users получит admin-доступ к любому space, даже если он не член этого space Но SpaceMiddleware проверяет членство раньше, так что в цепочке RequireSpace() → RequireMinRole() это не эксплуатируется Однако если RequireMinRole() используется без RequireSpace() — это дыра Рекомендация: Удалить fallback на ContextRole. Если ContextSpaceRole пуст — отказывать.\n3.5. Рекомендации по правам доступа Удалить модалку участников диаграммы на фронтенде — она мертва Или добавить раздел «Участники Space» с возможностью управления ролями через /spaces/:space_id/members (эти endpoints работают) Удалить fallback на ContextRole в role_middleware.go Добавить проверку: editor не может повысить кого-то до admin (сейчас может — AddMember разрешает editor+ назначать любую роль) 4. Безопасность 4.1. Критические # Проблема Файл Описание S1 JWT Secret = test .env JWT_SECRET=test_secret_key_change_in_production — это прод-конфиг! S2 CORS: * .env CORS_ALLOWED_ORIGINS=* — любой домен может обращаться к API S3 Пароль БД в .env .env DB_PASSWORD=popoloka16 — creds в открытом виде S4 Refresh tokens: SHA256 utils/password.go SHA256 вместо bcrypt для refresh token hash — быстро брутфорсится 4.2. Высокие # Проблема Описание S5 Нет rate limiting Brute-force на /auth/login без ограничений S6 Нет CSRF protection API принимает POST/PUT/DELETE без CSRF-токена S7 Нет CSP заголовков X-Frame-Options, Content-Security-Policy не настроены S8 JWT в localStorage XSS может украсть access + refresh tokens 4.3. Средние # Проблема Описание S9 Нет password policy Минимальные требования к паролю не enforced S10 Нет audit log Действия с spaces/charts не логируются для аудита S11 Нет блокировки аккаунта Неограниченные попытки входа 5. Инфраструктура 5.1. Текущее состояние Компонент Статус Примечание Go API (pm2: leadera-api) ⚠️ Порт 8080, хост 0.0.0.0 Angular FE (pm2: leadera-fe) ⚠️ Порт 4200, хост 0.0.0.0 PostgreSQL (Docker) ✅ Порт 5432, контейнер app-leadera-db VPS reverse proxy ⚠️ sand.a2v.space → 8082/8083, но 502 если сервисы не запущены SSL ✅ Let\u0026rsquo;s Encrypt на VPS 5.2. Проблемы # Проблема Описание I1 Docker для БД, нативно для API Несогласованность — API и FE не в Docker I2 Нет health-check в pm2 API может упасть без перезапуска I3 Нет CI/CD Ручной деплой через make run + pm2 I4 Нет nginx на Mac Studio FE и API торчат наружу напрямую 6. Функциональная оценка 6.1. Что работает Функция Backend Frontend Статус Регистрация/логин ✅ ✅ Работает JWT auth + refresh ✅ ✅ Работает Spaces CRUD ⚠️ ✅ RegisterProtectedRoutes не вызван (C4) Space members ✅ ✅ Работает Gantt charts CRUD ✅ ✅ Работает Gantt sections ✅ ✅ Работает Gantt tasks ✅ ⚠️ Нет UI для задач внутри диаграммы Архивация диаграмм ✅ ✅ Работает Members диаграммы ❌ ✅ (мёртвый UI) Backend endpoints не существуют 6.2. Что НЕ работает или отсутствует Функция Статус Визуализация Ганта (таймлайн) ❌ Нет компонента отрисовки Drag \u0026amp; Drop задач ❌ Real-time collaboration ❌ Уведомления ❌ Поиск ❌ Экспорт (PDF/Excel) ❌ Email verification ❌ Password reset Backend есть, UI есть — не проверено 6.3. Оценка готовности Система на стадии каркаса. Backend API функционален для CRUD операций, но:\nВизуализация Ганта — основная фича — не реализована (нет canvas/SVG рендеринга) Управление участниками только на уровне Space Нет CI/CD, тестов, мониторинга 7. Приоритизированный план исправлений Неделя 1 — Критическое (безопасность) Приоритет Задача Трудоёмкость P0 Заменить JWT secret на криптостойкий 1 час P0 Настроить CORS (только sand.a2v.space) 1 час P0 bcrypt для refresh tokens вместо SHA256 2 часа P0 Удалить fallback на ContextRole в role_middleware 30 мин P0 Исправить RegisterProtectedRoutes — зарегистрировать маршруты 1 час P1 Rate limiting на auth endpoints 4 часа P1 Editor не может назначать admin роль 2 часа Неделя 2 — Архитектура прав Приоритет Задача Трудоёмкость P1 Удалить/переписать MembersModalComponent → Space members 4 часа P1 Добавить страницу управления участниками Space 8 часов P2 HttpOnly cookies для JWT (вместо localStorage) 8 часов P2 CSRF protection 4 часа Неделя 3 — Функциональность Приоритет Задача Трудоёмкость P2 Визуализация Ганта (canvas/d3) 40+ часов P2 Drag \u0026amp; Drop для задач 16 часов P3 Тесты (unit + integration) 24 часа P3 CI/CD pipeline 8 часов 8. Резюме Ключевые выводы Права доступа — архитектурно верно: роль назначается через Space, не через диаграмму. Но фронтенд ещё не обновлён после удаления gantt_chart_members. Безопасность — критические уязвимости в конфигурации (JWT secret, CORS, bcrypt). Требуют немедленного исправления до любого публичного деплоя. Функциональность — CRUD работает, но основная ценность (визуализация Ганта) не реализована. Код — чистый, хорошая архитектура, но есть мёртвый код и незарегистрированные маршруты. Общая оценка: 🔴 Pre-alpha Проект готов к внутренней демонстрации CRUD, но не готов к продакшену. Первоочередное — безопасность и исправление мёртвых endpoints.\n","section":"guides","tags":["audit","leadera","security","architecture"],"title":"Аудит Leadera — полный отчёт","url":"/guides/leadera-audit/"},{"content":"Timeline Утро — Обсуждали аналоги htop: порекомендовал btm, btop, glances. Создан конфиг ~/.config/bottom/bottom.toml День — Разбирались со скиллами OpenCode: как работают, автоматический подбор по description День — Созданы скиллы для Leadera проектов (Go: build-and-fix, restart-api; Angular: build-and-fix) День — Обсудили миграцию Ганта с DOM на Canvas 2D (Konva.js) — real-time коллаборация, экспорт PDF/PNG, 500+ задач Вечер — Установлен gh CLI, авторизован как agaltsovav Вечер — Созданы GitHub Projects: Leadera Roadmap (21 задача, P0–P3), agaltsovav.ru Roadmap (7 задач) Системные утилиты bottom (btm) — выбранный мониторинг, конфиг в ~/.config/bottom/bottom.toml Альтернативы: btop, glances OpenCode Skills Созданы скиллы:\napp-leadera-api/.opencode/skills/build-and-fix/ — сборка Go проекта + автофикс ошибок (до 10 итераций) app-leadera-api/.opencode/skills/restart-api/ — swagger генерация + pm2 restart app-leadera-fe/.opencode/skills/build-and-fix/ — сборка Angular + автофикс Gantt Canvas миграция Переход с DOM на Canvas 2D через Konva.js Цели: real-time коллаборация, экспорт PDF/PNG, 500+ задач Промт: GANTT_CANVAS_MIGRATION_PROMPT.md в app-leadera-fe GitHub CLI: gh авторизован (agaltsovav) Репо: app-leadera-fe, app-leadera-api, agaltsovav.ru Старые: leadera-fe/leadera-api (на VPS, leadera.ru) modece.ru — заброшен, планируется возвращение GitHub Projects — Roadmaps Leadera Roadmap (project #2) — 21 задача P0: JWT secret, CORS, bcrypt, ContextRole fallback, RegisterProtectedRoutes P1: Rate limiting, editor role check, MembersModal rewrite P2: HttpOnly cookies, CSRF, CSP, password policy, audit log, health-check, CI/CD, Canvas миграция, DnD P3: Code cleanup, тесты, email verification, поиск agaltsovav.ru Roadmap (project #1) — 7 задач Редизайн, мобильная версия, мультиязычность, блог, CI/CD, тёмная тема, форма обратной связи ","section":"diary","tags":["system-utils","opencode","leadera","gantt","canvas","github","roadmap"],"title":"31 марта 2026","url":"/diary/2026-03-31/"},{"content":"Проблема В params.toml:\ncopyRight = \u0026#34;Copyright (c) 2020-2025 Антон Агальцов\u0026#34; Сейчас 2026 год — нужно обновить.\nРекомендация Обновить на 2020-2026. Или сделать динамическим через Hugo template:\nCopyright (c) 2020-{{ now.Year }} Антон Агальцов ","section":"personal-site","tags":["audit","personal-site"],"title":"Copyright без 2026 года","url":"/personal-site/copyright-outdated/"},{"content":"Проблема Последний дайджест — февраль 2025. С тех пор 12+ месяцев без новых выпусков.\nЧто есть 27 файлов дайджестов (январь 2023 — февраль 2025) Автоматизация через digest.js — скрипт для генерации Но скрипт не запускается автоматически Риск Low — контент устаревает, SEO-позиции падают для страниц дайджестов.\nРекомендация Настроить cron/CI для ежемесячной генерации дайджеста Или интегрировать с OpenClaw — авто-сборка дайджеста на основе новых публикаций ","section":"personal-site","tags":["audit","personal-site"],"title":"Digest не обновлялся с февраля 2025","url":"/personal-site/digest-stale/"},{"content":"Проблема Проект использует тему Hyas/Doks v0.5.0 (package.json). Актуальная версия Doks — 1.x с полной переработкой архитектуры.\nЧто не так Doks 0.5 использует устаревший Bootstrap 5.2.0-beta1 Hugo 0.148.2 в зависимостях — новый, но интеграция с темой старая Конфигурация через theme.toml — в новых версиях перешли на другой формат exec-bin для вызова Hugo — устаревший подход, текущие версии Hugo ставятся глобально Риск Medium — работает, но миграция на Doks 1.x потребует значительного рефакторинга layout-ов и конфигурации. Чем дольше откладывать — тем сложнее.\nРекомендация Запланировать миграцию на Doks 1.x или перейти на чистый Hugo + Bootstrap без зависимости от темы-фреймворка.\n","section":"personal-site","tags":["audit","personal-site"],"title":"Hugo Doks 0.5 — сильно устарел","url":"/personal-site/outdated-doks-theme/"},{"content":"Проблема В params.toml указан Twitter: @AntonTotoshkin\nНо владелец сайта — Антон Агальцов. Ники не совпадают.\nДва варианта Это твой старый/другой аккаунт — тогда ок, но стоит указать актуальный Это чужой аккаунт — тогда нужно убрать или исправить Затронутые места twitterSite = \u0026quot;@AntonTotoshkin\u0026quot; schemaAuthorTwitter = \u0026quot;https://twitter.com/AntonTotoshkin\u0026quot; schemaTwitter = \u0026quot;https://twitter.com/AntonTotoshkin\u0026quot; Рекомендация Указать актуальный Twitter/X или убрать, если соцсеть не используется.\n","section":"personal-site","tags":["audit","personal-site"],"title":"Twitter handle не соответствует имени","url":"/personal-site/twitter-handle-mismatch/"},{"content":"Проблема В params.toml: yandexMetrika = false\nАналитика с сайта не собирается. Непонятно, есть ли вообще посетители и какие страницы популярны.\nРекомендация Включить Yandex Metrika или перейти на Plausible / Umami (privacy-friendly) Если сайт не нуждается в аналитике — оставить как есть Альтернатива: Netlify Analytics (уже встроен в хостинг) ","section":"personal-site","tags":["audit","personal-site"],"title":"Yandex Metrika отключена","url":"/personal-site/no-analytics/"},{"content":"Проблема В корне репозитория лежат два файла, которые не должны быть в git:\nШаблоны для сайта.key — Apple Keynote файл (бинарный) logo.psd — Photoshop файл (бинарный) Что не так Увеличивают размер репозитория Git неэффективно хранит бинарные файлы (каждая версия — полностью) .key файлы могут содержать конфиденциальные данные шаблонов Рекомендация Перенести в отдельное хранилище (Google Drive, облако) Удалить из git-истории через git filter-repo Добавить в .gitignore: *.key, *.psd, *.sketch ","section":"personal-site","tags":["audit","personal-site"],"title":"Бинарный файл в репозитории","url":"/personal-site/binary-files-in-repo/"},{"content":"Проблема node_modules/ отсутствует — проект нельзя собрать без npm install.\nРиск Low — стандартная ситуация. Но:\npackage-lock.json привязан к Node 16, а на Mac Studio текущий Node v24 Могут быть конфликты зависимостей (canvas, babel, postcss) Hugo 0.148.2 ставится через hugo-installer в npm — может не совпасть с глобальным Hugo Рекомендация Убедиться что npm install проходит без ошибок на текущем Node Если нет — обновить зависимости или использовать nvm для Node 16 Рассмотреть переход на глобальный Hugo вместо exec-bin ","section":"personal-site","tags":["audit","personal-site"],"title":"Отсутствуют node_modules — нужна установка","url":"/personal-site/no-node-modules/"},{"content":"Устаревший Node.js 16 в Netlify Файл: netlify.toml:5\nNODE_VERSION = \u0026#34;16.16.0\u0026#34; Node.js 16 вышел из поддержки (EOL) в сентябре 2023. Сборка на Netlify может начать падать или работать некорректно.\nРекомендация: Обновить до Node.js 20 LTS:\nNODE_VERSION = \u0026#34;20\u0026#34; ","section":"personal-site","tags":["audit","personal-site","infrastructure"],"title":"Устаревший Node.js 16 в Netlify","url":"/personal-site/netlify-node-version/"},{"content":"Timeline Утро — Установлен Vikunja (таск-трекер) на Mac Studio через Docker/Colima День — Создан проект «Leadera» в Vikunja (ID=2), добавлено 27 задач из аудита Leadera День — Начата реализация Leadera TaskTracker: миграции, модели, DTOs, repositories (бекенд), фронтенд (kanban, task-detail) Вечер — TaskTracker откачён по просьбе Антона — git checkout + git clean. Причина: Claude Code падал (SIGKILL), sub-agents не справлялись, Plane не запустился Вечер — Настроен MT Proxy на VPN VPS (185.234.64.52): порт 8443, секрет 9e40ae… Вечер — Qwen 3.5:9b подключён к OpenClaw через openclaw models set ollama/qwen3.5:9b, доступен для cron/spawn задач Вечер — Антон подключился к claw.a2v.space с мобильного, устройство одобрено Vikunja URL: http://192.168.0.37:8095 Проект Leadera: ID=2 API token: tk_635fb7ac… 27 задач из аудита, приоритеты P0–P3 Leadera TaskTracker ТЗ: leadera-tasktracker-spec.md Реализация через sub-agents (GLM-5.1) Откачено — проекты возвращены к предыдущему коммиту MT Proxy Сервер: 185.234.64.52, порт 8443 Docker контейнер: mtproxy Инфраструктура Qwen 3.5:9b доступен как дешёвая локальная модель для cron/spawn Мобильное подключение к claw.a2v.space подтверждено ","section":"diary","tags":["vikunja","leadera","tasktracker","ollama","qwen","mtproxy","infrastructure"],"title":"30 марта 2026","url":"/diary/2026-03-30/"},{"content":"Timeline 20:03 — Настроили Angular + Go проекты (leadera) через pm2, удалили proxy.conf, подняли PostgreSQL в Docker 20:31 — Изучили API Eversolo T8 — полный список REST-эндпоинтов для управления музыкой 20:49 — Обсудили важность записи контекста в файлы для сохранения памяти между сессиями 21:13 — Начали проект docs.a2v.space — персональная документация на Hugo 21:44 — Завершили настройку Identity (Братан, SOUL.md, USER.md, IDENTITY.md) 22:15 — Документировали инфраструктуру: VPS reverse proxy (claw.a2v.space, code.a2v.space, sand.a2v.space, docs.a2v.space) 22:31 — Настроили docs.a2v.space: Hugo сайт, 83 страницы, Bootstrap 5 тёмная тема, AES-256-GCM шифрование кредов (мастер-пароль: Popoloka16!) 22:47 — Добавили Basic auth: agaltsovav / Magamet787! для доступа к документации 23:02 — Создали cron задачу docs-a2v-daily-sync на ежедневное обновление в 03:00 МСК 23:18 — Полностью задокументировали Eversolo T8 API (воспроизведение, громкость, дисплей, питание, поиск и т.д.) 23:45 — Переписали TOOLS.md как полный справочник по инфраструктуре Eversolo Companion — статус проекта Backend (Go + Gin):\nРепозиторий: ~/Projects/eversolo-companion Состояние: собран, 17+ REST API эндпоинтов, WebSocket, CORS, state poller Frontend (Angular 17):\nСостояние: собран, тёмная тема (Spotify-like), 5 экранов, 5 сервисов Dev server: pm2 (eversolo-fe), порт 8096 Инфраструктура:\nPostgreSQL: Docker, порт 5433, миграции готовы Docker Compose: рабочий (postgres + api + frontend) Проблема: нет доступа к Eversolo из OpenClaw sandbox (192.168.0.156)\nРешение: настройка tools.elevated.allowFrom.webchat или запуск через launchd Следующие шаги: после решения сети — этапы 3-9 (библиотека sync, плейлисты, scrobbler, обложки)\n","section":"diary","tags":["angular","go","docker","eversolo","hugo","docs","identity","infrastructure","companion"],"title":"29 марта 2026","url":"/diary/2026-03-29/"},{"content":"Basic Authentication Username: agaltsovav Password: Magamet787! Конфигурация Nginx server { listen 8091; server_name docs.a2v.space; auth_basic \u0026#34;Restricted Access\u0026#34;; auth_basic_user_file /etc/nginx/.htpasswd; } Доступ URL: https://docs.a2v.space (через reverse proxy) Local: http://localhost:8091 (для разработки) Auth: всегда требуется Мастер-пароль для шифрования Важно: Пароль для расшифровки файлов в разделе creds/\nMaster Password: Popoloka16! Шифрование Алгоритм: AES-256-GCM Хранилище: client-side encryption Файлы шифруются при сохранении Расшифровываются при чтении ","section":"creds","tags":["docs","authentication","nginx"],"title":"docs.a2v.space Basic Auth","url":"/creds/docs-a2v-space-auth/"},{"content":"Docker Compose креды (~/Projects/eversolo-companion/docker-compose.yml) services: postgres: environment: POSTGRES_USER: postgres POSTGRES_PASSWORD: password POSTGRES_DB: eversolo Локальные креды (.env файл) POSTGRES_USER=postgres POSTGRES_PASSWORD=password POSTGRES_DB=eversolo Хостинг Host: localhost Port: 5433 Database: eversolo Безопасность Используйте разные пароли для production Включите SSL для удаленного подключения Регулярно делайте бэкапы ","section":"creds","tags":["eversolo","companion","postgresql","docker"],"title":"Eversolo Companion PostgreSQL","url":"/creds/eversolo-companion-postgres/"},{"content":"Eversolo T8 — музыкальный стример.\nIP: 192.168.0.156 Порт: 9529 Авторизация: нет\nБазовый URL: http://192.168.0.156:9529\nВоспроизведение Действие URL Play/Pause /ZidooMusicControl/v2/playOrPause Следующий трек /ZidooMusicControl/v2/playNext Предыдущий трек /ZidooMusicControl/v2/playLast Перемотка (ms) /ZidooMusicControl/v2/seekTo?time=\u0026lt;ms\u0026gt; Воспроизвести по ID /ZidooMusicControl/v2/playMusic?type=4\u0026amp;id=\u0026lt;id\u0026gt; Состояние /ZidooMusicControl/v2/getState Громкость Действие URL Громкость вверх /ZidooControlCenter/RemoteControl/sendkey?key=Key.VolumeUp Громкость вниз /ZidooControlCenter/RemoteControl/sendkey?key=Key.VolumeDown Точная громкость /ZidooMusicControl/v2/setDevicesVolume?volume=\u0026lt;0-200\u0026gt; Mute /ZidooMusicControl/v2/setMuteVolume?isMute=1 Unmute /ZidooMusicControl/v2/setMuteVolume?isMute=0 Входы/Выходы Действие URL Получить список /ZidooMusicControl/v2/getInputAndOutputList Установить вход /ZidooMusicControl/v2/setInputList?tag=\u0026lt;tag\u0026gt;\u0026amp;index=\u0026lt;n\u0026gt; Установить выход /ZidooMusicControl/v2/setOutInputList?tag=\u0026lt;tag\u0026gt;\u0026amp;index=\u0026lt;n\u0026gt; Теги выхода: RCA, XLRRCA, XLR, HDMI, SPDIF, USB\nДисплей Действие URL Яркость экрана (get) /SystemSettings/displaySettings/getScreenBrightness Яркость экрана (set) /SystemSettings/displaySettings/setScreenBrightness?index=\u0026lt;0-115\u0026gt; Яркость ручки (get) /SystemSettings/displaySettings/getKnobBrightness Яркость ручки (set) /SystemSettings/displaySettings/setKnobBrightness?index=\u0026lt;0-255\u0026gt; VU-режим (get) /SystemSettings/displaySettings/getVUModeList VU-режим (set) /SystemSettings/displaySettings/setVUMode?index=\u0026lt;n\u0026gt; Спектр (get) /SystemSettings/displaySettings/getSpPlayModeList Спектр (set) /SystemSettings/displaySettings/setSpPlayModeList?index=\u0026lt;n\u0026gt; Переключить VU/Спектр `/ZidooMusicControl/v2/changVUDisplay?openType=\u0026lt;0 Питание Действие URL Параметры питания /ZidooMusicControl/v2/getPowerOption Перезагрузка /ZidooMusicControl/v2/setPowerOption?tag=reboot Выключение /ZidooMusicControl/v2/setPowerOption?tag=poweroff Переключить экран /ZidooMusicControl/v2/setPowerOption?tag=screen Включить экран /ZidooControlCenter/RemoteControl/sendkey?key=Key.Screen.ON Выключить экран /ZidooControlCenter/RemoteControl/sendkey?key=Key.Screen.OFF Поиск Поиск URL По трекам /ZidooMusicControl/v2/searchMusicV2?key=\u0026lt;text\u0026gt;\u0026amp;start=0\u0026amp;count=100 По артистам /ZidooMusicControl/v2/searchArtistV2?key=\u0026lt;text\u0026gt;\u0026amp;start=0\u0026amp;count=100 По альбомам /ZidooMusicControl/v2/searchAlbumV2?key=\u0026lt;text\u0026gt;\u0026amp;start=0\u0026amp;count=100 Обложки и устройство Действие URL Обложка по ID /ZidooMusicControl/v2/getImage?id=\u0026lt;song_id\u0026gt;\u0026amp;target=16 Модель устройства /ControlCenter/getModel Источники Zidoo Forum Home Assistant Integration ","section":"kb","tags":["api","eversolo","music","streamer"],"title":"Eversolo T8 API","url":"/kb/eversolo-api/"},{"content":"\nNYVK4PEGwmOHmAnGk8IAUc+lyFJtnEAvX6ZddBro/ILRWHOXBGYywgglFvQZ18BLDLb5DuA8GPAIdB/LwTHRXYO0KsmtlZQVWGEeeXlXAoEXpa5theoOQhebkW6LmiKyNGAVW2z9rK3nz6NnztYdn49LvGMjrHuR4IwCLbl/pYa96CPNRnxGDFlduFi8lMSspM0rBFi/bZhNGhzy36ViCl+aKr5P9cle0ZvM8E8av/6c5JjgDt88QFI3VYdTaTCE0+uHsXlnJN7Qgg/KH7kD\n\n\n","section":"creds","tags":["postgresql","docker-compose","leadera","database"],"title":"Mac Studio — leadera-api БД (docker-compose)","url":"/creds/leadera-db-docker/"},{"content":"\np7Iw7Y3zbj1kLBcbOXGoO27oDwF85AhxBW7saT538hxi0ogJpyFeM49GDuLHzxuyknvdNC/rx3tb4AFnGkCeHSrrCmj+VK8Zxt7ujeujVJSRuOeeUlsqkHdlmaiXl2KQknrIsqVCi3Tnn0V5qcFxvo+1Ktc+surF6bBpWrTHzWV5mLtWVfD6C6kvvP/UFldFBD6v+FQs79yfoOe/j/bUrtpt6v5VndbbBmhUAQcy1BV2rpXxO373dTcLQ6coRWkt/RFo\n\n\n","section":"creds","tags":["postgresql","docker","leadera","database"],"title":"Mac Studio — leadera-api БД (локальная)","url":"/creds/leadera-db-local/"},{"content":"Настройка SSH туннелей VPS reg.ru (95.163.232.9) # На Mac Studio: создать туннель для каждого сервиса ssh -N -R 8080:localhost:8080 root@95.163.232.9 # leadera-api ssh -N -R 8081:localhost:4096 root@95.163.232.9 # opencode ssh -N -R 8082:localhost:4200 root@95.163.232.9 # leadera-fe ssh -N -R 8083:localhost:8080 root@95.163.232.9 # docs-a2v Настройка launchd plist Файл: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\n\u0026lt;?xml version=\u0026#34;1.0\u0026#34; encoding=\u0026#34;UTF-8\u0026#34;?\u0026gt; \u0026lt;!DOCTYPE plist PUBLIC \u0026#34;-//Apple//DTD PLIST 1.0//EN\u0026#34; \u0026#34;http://www.apple.com/DTDs/PropertyList-1.0.dtd\u0026#34;\u0026gt; \u0026lt;plist version=\u0026#34;1.0\u0026#34;\u0026gt; \u0026lt;dict\u0026gt; \u0026lt;key\u0026gt;Label\u0026lt;/key\u0026gt; \u0026lt;string\u0026gt;com.openclaw.sshtunnel\u0026lt;/string\u0026gt; \u0026lt;key\u0026gt;ProgramArguments\u0026lt;/key\u0026gt; \u0026lt;array\u0026gt; \u0026lt;string\u0026gt;ssh\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-N\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8080:localhost:8080\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;root@95.163.232.9\u0026lt;/string\u0026gt; \u0026lt;/array\u0026gt; \u0026lt;key\u0026gt;RunAtLoad\u0026lt;/key\u0026gt; \u0026lt;true/\u0026gt; \u0026lt;key\u0026gt;KeepAlive\u0026lt;/key\u0026gt; \u0026lt;true/\u0026gt; \u0026lt;/dict\u0026gt; \u0026lt;/plist\u0026gt; Автозапуск # Загрузить plist launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist # Проверить статус launchctl list | grep sshtunnel # Удалить (при необходимости) launchctl unload ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist Доступ к сервисам Через reverse proxy на VPS:\ncode.a2v.space: порт 8080 → Mac Studio:4096 claw.a2v.space: порт 8081 → Mac Studio:8080 (leadera-api) sand.a2v.space: порт 8082 → Mac Studio:4200 (leadera-fe) docs.a2v.space: порт 8083 → Mac Studio:8080 (docs-a2v) SSL Все сервисы используют Let\u0026rsquo;s Encrypt сертификаты:\nПуть: /etc/letsencrypt/live/{claw,code,sand}.a2v.space/ Автопродление через certbot ","section":"guides","tags":["ssh","tunnel","vps","reverse-proxy"],"title":"SSH туннели для VPS reverse proxy","url":"/guides/ssh-tunnels-vps/"},{"content":"\nYEI16NAJ78d3lmSa/lca8Zxczt+u6GyMUYHduX47VoFQdj0Ixozd8R6yXoB7eM+AjhCtNGkOxGlOj2s73ABOBjLEIVIhD4Z+xTyzdtah4VpyLoltYOeNYsnbIIFARdF/FBYq5COXohhXs33K5ozznrtDd/awbKMjl/sbQqjXAZ+A3ZSob6/5uU+fFKetXLR6v4ZLAYQ57iiD21ImSLSggwv+rJgK5XyPDKEPD4N5nOsiDrLgoukVBMvgJ54PqfPp2Hni+2tdKOlMnOG2npTuu4SkyALcfFar\n\n\n","section":"creds","tags":["vpn","amnezia","infrastructure"],"title":"VPN VPS","url":"/creds/vpn-vps/"},{"content":"\nIpYXLMtgCFlGQ550DZCLjq37VsnNqL08Rn03iRS7kQ7ozBZNsiZySFzDAvYh4xIHytRDy0Sz0KGUXekr0S+cNiJsmtZ8kj0Pd0JhevhxTMZF2khFvs/LFWoTL5ZwAJ34y/qfLw2gaWX90VZDu0wO+KeAQeXhrWmol/2zUlfWX1AihyYqD2vRz+h2FcjD8ubYOXG35PyX7OlV1HPXgDv5X/bFNrxzPc867UOwB4aGxY9a\n\n\n","section":"creds","tags":["vps","reg.ru","infrastructure"],"title":"VPS reg.ru","url":"/creds/vps-reg-ru/"},{"content":"Описание Завершить разработку Eversolo Companion после решения проблемы с сетевым доступом.\nЧто сделано Backend (Go + Gin): собран, 17+ REST API эндпоинтов, WebSocket, CORS, state poller Frontend (Angular 17): собран, тёмная тема (Spotify-like), 5 экранов, 5 сервисов PostgreSQL: Docker, порт 5433, миграции готовы Docker Compose: рабочий (postgres + api + frontend) Спецификация: полная в ~/Projects/eversolo-companion/SPEC.md Проблема API не может достучаться до Eversolo T8 (192.168.0.156:9529) из-за ограничений OpenClaw sandbox.\nВозможные решения Настроить tools.elevated.allowFrom.webchat для разрешения сетевых соединений Запустить API через launchd plist (как SSH туннели) Использовать отдельный контейнер без ограничений Этапы 3-9 (после решения сети) Библиотека синхронизации — двухсторонний sync с Eversolo Плейлисты — импорт/экспорт, редактирование Scrobbler — Last.fm / ListenBrainz Обложки — кэширование, отображение в UI Плеер — улучшенный интерфейс управления Система уведомлений — события от Eversolo Администрирование — настройка подключений Связанные ресурсы Спецификация проекта API документация Дневник разработки ","section":"plans","tags":["eversolo","companion","angular","go","docker"],"title":"Завершить Eversolo Companion - этапы 3-9","url":"/plans/eversolo-companion-phases-3-9/"},{"content":"Описание Добавить поддержку Ollama в OpenClaw для использования локальных LLM моделей.\nПроблема Модель qwen3.5:9b добавлена в конфиг openclaw.json, но не отображается в openclaw models list.\nСтатус Отложено по решению Антона.\n","section":"plans","tags":["ollama","openclaw","llm"],"title":"Настроить интеграцию Ollama с OpenClaw","url":"/plans/ollama-openclaw/"},{"content":"Общая схема Mac Studio (локальная сеть) → autossh (SSH-туннели) → VPS 95.163.232.9 (Debian) → nginx (HTTPS reverse proxy) → интернет Что нужно на VPS 1. Установленные пакеты apt update apt install nginx certbot python3-certbot-nginx 2. SSH-доступ Авторизация только по ключам Публичный ключ с Mac Studio добавлен в /root/.ssh/authorized_keys 3. nginx Для каждого домена создать server block:\nHTTP → редирект на HTTPS HTTPS с SSL-сертификатом Let\u0026rsquo;s Encrypt proxy_pass на localhost-порт туннеля Пример структуры:\n/etc/nginx/sites-available/ claw.a2v.space.conf code.a2v.space.conf sand.a2v.space.conf 4. SSL-сертификаты certbot certonly --nginx -d \u0026lt;domain\u0026gt; certbot renew --dry-run # проверить автообновление Что нужно на Mac Studio autossh через launchd Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\nОдин plist с несколькими -R флагами:\n\u0026lt;key\u0026gt;ProgramArguments\u0026lt;/key\u0026gt; \u0026lt;array\u0026gt; \u0026lt;string\u0026gt;/usr/local/bin/autossh\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-M\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;0\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8080:localhost:18789\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8081:localhost:4096\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8082:localhost:4200\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8083:localhost:8080\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;root@95.163.232.9\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-N\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-i\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;/Users/\u0026lt;user\u0026gt;/.ssh/id_rsa\u0026lt;/string\u0026gt; \u0026lt;/array\u0026gt; Управление launchd launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist launchctl start com.openclaw.sshtunnel launchctl stop com.openclaw.sshtunnel Проверка # На VPS ss -tlnp | grep -E \u0026#39;808[0-3]\u0026#39; # Снаружи curl -I https://claw.a2v.space curl -I https://code.a2v.space curl -I https://sand.a2v.space ","section":"guides","tags":["vps","nginx","ssh","reverse-proxy","devops"],"title":"Настройка VPS как реверс-прокси","url":"/guides/vps-reverse-proxy/"},{"content":"Архитектура Mac Studio (192.168.0.37:18789) → autossh SSH-туннель → VPS 95.163.232.9:8080 → nginx HTTPS → https://claw.a2v.space Шаги настройки 1. DNS A-запись claw.a2v.space → 95.163.232.9\nNS-серверы: ns1.hosting.reg.ru, ns2.hosting.reg.ru\n2. Mac Studio — OpenClaw Порт: 18789 Конфиг: ~/.openclaw/openclaw.json 3. SSH-туннель (launchd) Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\nКлючевой флаг: -R 8080:localhost:18789\n4. VPS — nginx конфиг server { listen 80; server_name claw.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name claw.a2v.space; ssl_certificate /etc/letsencrypt/live/claw.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/claw.a2v.space/privkey.pem; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } 5. SSL-сертификат certbot certonly --nginx -d claw.a2v.space 6. OpenClaw config { \u0026#34;allowedOrigins\u0026#34;: [\u0026#34;https://claw.a2v.space\u0026#34;], \u0026#34;trustedProxies\u0026#34;: [\u0026#34;127.0.0.1\u0026#34;] } ","section":"guides","tags":["openclaw","ssh","nginx","vps","reverse-proxy"],"title":"Подключение claw.a2v.space (OpenClaw)","url":"/guides/claw-a2v-space/"},{"content":"Архитектура Mac Studio (localhost:4096) → autossh SSH-туннель (-R 8081:localhost:4096) → VPS 95.163.232.9:8081 → nginx HTTPS → https://code.a2v.space Параметры Параметр Значение Локальный порт 4096 Туннель порт 8081 pm2 процесс opencode SSL сертификат /etc/letsencrypt/live/code.a2v.space/ nginx конфиг server { listen 80; server_name code.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name code.a2v.space; ssl_certificate /etc/letsencrypt/live/code.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/code.a2v.space/privkey.pem; location / { proxy_pass http://127.0.0.1:8081; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \u0026#34;upgrade\u0026#34;; } } SSL-сертификат certbot certonly --nginx -d code.a2v.space ","section":"guides","tags":["opencode","ssh","nginx","vps","reverse-proxy"],"title":"Подключение code.a2v.space (OpenCode)","url":"/guides/code-a2v-space/"},{"content":"Архитектура Mac Studio ├─ Frontend (Angular) :4200 (pm2: leadera-fe) ├─ Backend (Go) :8080 (pm2: leadera-api) └─ PostgreSQL 16 в Docker (Colima, container: app-leadera-db) → autossh SSH-туннель (-R 8082:localhost:4200 -R 8083:localhost:8080) → VPS 95.163.232.9 → nginx HTTPS → https://sand.a2v.space Параметры Компонент Локальный порт Туннель порт pm2 имя Frontend (Angular) 4200 8082 leadera-fe Backend (Go) 8080 8083 leadera-api SSL сертификат: /etc/letsencrypt/live/sand.a2v.space/\nnginx конфиг server { listen 80; server_name sand.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name sand.a2v.space; ssl_certificate /etc/letsencrypt/live/sand.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/sand.a2v.space/privkey.pem; location /api { proxy_pass http://127.0.0.1:8083; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } location / { proxy_pass http://127.0.0.1:8082; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } База данных PostgreSQL 16 в Docker через Colima:\nContainer: app-leadera-db Port: 5432 SSL-сертификат certbot certonly --nginx -d sand.a2v.space ","section":"guides","tags":["angular","go","docker","nginx","vps","reverse-proxy"],"title":"Подключение sand.a2v.space (Leadera Project)","url":"/guides/sand-a2v-space/"},{"content":"Описание Добавить инструменты управления Eversolo T8 в OpenClaw.\nЧто сделано Изучен полный API Eversolo T8 (см. Базу знаний) Проблема Sandbox OpenClaw не имеет доступа к локальной сети, где находится Eversolo.\nВозможные решения Настроить проброс портов Запустить OpenClaw без sandbox-ограничений Использовать промежуточный proxy-сервис ","section":"plans","tags":["eversolo","openclaw","api"],"title":"Реализовать управление Eversolo из OpenClaw","url":"/plans/eversolo-control/"}] \ No newline at end of file +[{"content":"Аудит проекта Leadera Дата: 30.03.2026\nВерсия: pre-production, миграции 1–5\n1. Обзор проекта Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.\nСтек Компонент Технологии Backend Go 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256) Frontend Angular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals Инфраструктура Docker (Colima), pm2, nginx reverse proxy, VPS reg.ru Доменная модель User ──┬── Space (через space_members с role) │ └── GanttChart (принадлежит Space) ├── GanttSection └── GanttTask Роли: admin, editor, viewer — назначаются на уровне Space через таблицу space_members.\nЧто реализовано (endpoints) Auth (5): register, login, refresh, change-password, logout\nSpaces (9): CRUD + members CRUD\nGantt Charts (9): CRUD + archive + members (добавлен, но удалён в миграции 5)\nGantt Sections (5): CRUD + reorder\nGantt Tasks (4): CRUD\nИтого: ~32 endpoint\n2. Архитектура и качество кода 2.1. Backend — структура cmd/server/main.go — точка входа internal/ domain/ — модели (User, Space, GanttChart, etc.) dto/ — request/response DTO (auth, space, gantt) handlers/ — HTTP handlers (auth, space, gantt) middleware/ — auth, cors, space, gantt, role, logging, recovery repository/ — слой доступа к данным service/ — бизнес-логика config/ — конфигурация (.env) utils/ — jwt, password, response, validation migrations/ — SQL миграции (1-5) Оценка: ✅ Чистая layered архитектура. Разделение ответственности чёткое.\n2.2. Frontend — структура src/app/ core/auth/ — auth service, interceptor core/models/ — app.model, space.model core/services/ — space.service, space-storage.service pages/auth/ — sign-in, sign-up, reset-pw, etc. pages/gantt/ — компоненты, модалки, сервисы, модели pages/dashboards/ — spaces list, dashboard layouts/ — navbar, topbar, main-layout Оценка: ✅ Стандартная Angular-структура. Signals для state management.\n2.3. Проблемы кода # Проблема Критичность Описание C1 \\r в service-файлах Medium gantt_service.go, gantt_section_service.go содержат CRLF C2 main.go:238 — мёртвый код getUserHandler Low Неиспользуемая функция C3 Swagger не сгенерирован Medium Аннотации есть, но api/ директории нет C4 RegisterProtectedRoutes не вызывается в main.go Critical GET/PUT/DELETE /spaces/:id не зарегистрированы 3. Права доступа — главный вопрос 3.1. Текущая реализация Права назначаются исключительно через Space:\nТаблица space_members — связка user ↔ space с role (admin/editor/viewer) SpaceMiddleware.RequireSpace() — проверяет членство и записывает ContextSpaceRole в context RoleMiddleware.RequireMinRole() — проверяет иерархию ролей (admin \u0026gt; editor \u0026gt; viewer) Диаграммы Ганта НЕ имеют собственной системы ролей. Таблица gantt_chart_members была создана (миграция 4) и тут же удалена (миграция 5). Все проверки доступа к диаграммам идут через space membership.\n3.2. Как это работает Запрос → AuthMiddleware (JWT → userID) → SpaceMiddleware.RequireSpace() (проверяет space_members → ContextSpaceRole) → GanttMiddleware.RequireGanttChart() (проверяет chart.space_id == spaceID) → RoleMiddleware.RequireMinRole(\u0026#34;editor\u0026#34;) (проверяет ContextSpaceRole) Это правильно. Любой член Space с ролью editor+ может создавать/редактировать диаграммы. Viewers — только читать.\n3.3. 🔴 Критическая проблема: Frontend не соответствует Backend Frontend MembersModalComponent пытается управлять участниками диаграммы:\nganttService.addMember(chartId, dto) → /api/v1/spaces/{spaceId}/gantt-charts/{chartId}/members ganttService.updateMemberRole(chartId, userId, dto) → .../members/{userId} ganttService.removeMember(chartId, userId) → .../members/{userId} Backend GanttHandler.RegisterRoutes() НЕ регистрирует маршруты для members диаграмм. После удаления gantt_chart_members (миграция 5) эти endpoints не существуют.\nРезультат: модальное окно «Участники диаграммы» на фронтенде не работает — все вызовы вернут 404.\n3.4. 🔴 Проблема: Role fallback В role_middleware.go:28-31:\nrole := c.GetString(ContextSpaceRole) if role == \u0026#34;\u0026#34; { role = c.GetString(ContextRole) // fallback на глобальную роль User } Если ContextSpaceRole не установлен, используется глобальная роль пользователя (из JWT). Это значит:\nПользователь с role=admin в таблице users получит admin-доступ к любому space, даже если он не член этого space Но SpaceMiddleware проверяет членство раньше, так что в цепочке RequireSpace() → RequireMinRole() это не эксплуатируется Однако если RequireMinRole() используется без RequireSpace() — это дыра Рекомендация: Удалить fallback на ContextRole. Если ContextSpaceRole пуст — отказывать.\n3.5. Рекомендации по правам доступа Удалить модалку участников диаграммы на фронтенде — она мертва Или добавить раздел «Участники Space» с возможностью управления ролями через /spaces/:space_id/members (эти endpoints работают) Удалить fallback на ContextRole в role_middleware.go Добавить проверку: editor не может повысить кого-то до admin (сейчас может — AddMember разрешает editor+ назначать любую роль) 4. Безопасность 4.1. Критические # Проблема Файл Описание S1 JWT Secret = test .env JWT_SECRET=test_secret_key_change_in_production — это прод-конфиг! S2 CORS: * .env CORS_ALLOWED_ORIGINS=* — любой домен может обращаться к API S3 Пароль БД в .env .env DB_PASSWORD=popoloka16 — creds в открытом виде S4 Refresh tokens: SHA256 utils/password.go SHA256 вместо bcrypt для refresh token hash — быстро брутфорсится 4.2. Высокие # Проблема Описание S5 Нет rate limiting Brute-force на /auth/login без ограничений S6 Нет CSRF protection API принимает POST/PUT/DELETE без CSRF-токена S7 Нет CSP заголовков X-Frame-Options, Content-Security-Policy не настроены S8 JWT в localStorage XSS может украсть access + refresh tokens 4.3. Средние # Проблема Описание S9 Нет password policy Минимальные требования к паролю не enforced S10 Нет audit log Действия с spaces/charts не логируются для аудита S11 Нет блокировки аккаунта Неограниченные попытки входа 5. Инфраструктура 5.1. Текущее состояние Компонент Статус Примечание Go API (pm2: leadera-api) ⚠️ Порт 8080, хост 0.0.0.0 Angular FE (pm2: leadera-fe) ⚠️ Порт 4200, хост 0.0.0.0 PostgreSQL (Docker) ✅ Порт 5432, контейнер app-leadera-db VPS reverse proxy ⚠️ sand.a2v.space → 8082/8083, но 502 если сервисы не запущены SSL ✅ Let\u0026rsquo;s Encrypt на VPS 5.2. Проблемы # Проблема Описание I1 Docker для БД, нативно для API Несогласованность — API и FE не в Docker I2 Нет health-check в pm2 API может упасть без перезапуска I3 Нет CI/CD Ручной деплой через make run + pm2 I4 Нет nginx на Mac Studio FE и API торчат наружу напрямую 6. Функциональная оценка 6.1. Что работает Функция Backend Frontend Статус Регистрация/логин ✅ ✅ Работает JWT auth + refresh ✅ ✅ Работает Spaces CRUD ⚠️ ✅ RegisterProtectedRoutes не вызван (C4) Space members ✅ ✅ Работает Gantt charts CRUD ✅ ✅ Работает Gantt sections ✅ ✅ Работает Gantt tasks ✅ ⚠️ Нет UI для задач внутри диаграммы Архивация диаграмм ✅ ✅ Работает Members диаграммы ❌ ✅ (мёртвый UI) Backend endpoints не существуют 6.2. Что НЕ работает или отсутствует Функция Статус Визуализация Ганта (таймлайн) ❌ Нет компонента отрисовки Drag \u0026amp; Drop задач ❌ Real-time collaboration ❌ Уведомления ❌ Поиск ❌ Экспорт (PDF/Excel) ❌ Email verification ❌ Password reset Backend есть, UI есть — не проверено 6.3. Оценка готовности Система на стадии каркаса. Backend API функционален для CRUD операций, но:\nВизуализация Ганта — основная фича — не реализована (нет canvas/SVG рендеринга) Управление участниками только на уровне Space Нет CI/CD, тестов, мониторинга 7. Приоритизированный план исправлений Неделя 1 — Критическое (безопасность) Приоритет Задача Трудоёмкость P0 Заменить JWT secret на криптостойкий 1 час P0 Настроить CORS (только sand.a2v.space) 1 час P0 bcrypt для refresh tokens вместо SHA256 2 часа P0 Удалить fallback на ContextRole в role_middleware 30 мин P0 Исправить RegisterProtectedRoutes — зарегистрировать маршруты 1 час P1 Rate limiting на auth endpoints 4 часа P1 Editor не может назначать admin роль 2 часа Неделя 2 — Архитектура прав Приоритет Задача Трудоёмкость P1 Удалить/переписать MembersModalComponent → Space members 4 часа P1 Добавить страницу управления участниками Space 8 часов P2 HttpOnly cookies для JWT (вместо localStorage) 8 часов P2 CSRF protection 4 часа Неделя 3 — Функциональность Приоритет Задача Трудоёмкость P2 Визуализация Ганта (canvas/d3) 40+ часов P2 Drag \u0026amp; Drop для задач 16 часов P3 Тесты (unit + integration) 24 часа P3 CI/CD pipeline 8 часов 8. Резюме Ключевые выводы Права доступа — архитектурно верно: роль назначается через Space, не через диаграмму. Но фронтенд ещё не обновлён после удаления gantt_chart_members. Безопасность — критические уязвимости в конфигурации (JWT secret, CORS, bcrypt). Требуют немедленного исправления до любого публичного деплоя. Функциональность — CRUD работает, но основная ценность (визуализация Ганта) не реализована. Код — чистый, хорошая архитектура, но есть мёртвый код и незарегистрированные маршруты. Общая оценка: 🔴 Pre-alpha Проект готов к внутренней демонстрации CRUD, но не готов к продакшену. Первоочередное — безопасность и исправление мёртвых endpoints.\n","section":"leadera","tags":["audit","leadera","security","architecture"],"title":"Аудит Leadera — полный отчёт","url":"/leadera/leadera-audit/"},{"content":"WebSocket для диаграмм Ганта — realtime-совместное редактирование Дата: 07.04.2026 Статус: Планирование Проект: Leadera (dev — sand.a2v.space)\n1. Постановка задачи Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.\n2. Архитектура Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL │ │ │ HTTP (мутации) │ Broadcast └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты Ключевой принцип: мутации данных идут через HTTP (REST), WebSocket используется только для доставки уведомлений. Сервер — источник истины, клиент не может обойти проверки через WS.\nКомнаты Каждый открытый Гант — это «комната» с идентификатором chartId. При подключении клиент подписывается на комнату. Hub рассылает события всем подписчикам комнаты.\n3. Backend (Go) 3.1. Зависимости go get github.com/gorilla/websocket 3.2. Новые файлы — internal/ws/ message.go — типы сообщений package ws import \u0026#34;time\u0026#34; // EventType — тип события type EventType string const ( // Данные EventSectionCreated EventType = \u0026#34;section_created\u0026#34; EventSectionUpdated EventType = \u0026#34;section_updated\u0026#34; EventSectionDeleted EventType = \u0026#34;section_deleted\u0026#34; EventSectionsReordered EventType = \u0026#34;sections_reordered\u0026#34; EventTaskCreated EventType = \u0026#34;task_created\u0026#34; EventTaskUpdated EventType = \u0026#34;task_updated\u0026#34; EventTaskDeleted EventType = \u0026#34;task_deleted\u0026#34; // Присутствие EventUserJoined EventType = \u0026#34;user_joined\u0026#34; EventUserLeft EventType = \u0026#34;user_left\u0026#34; // Безопасность / доступ EventAccessRevoked EventType = \u0026#34;access_revoked\u0026#34; EventChartArchived EventType = \u0026#34;chart_archived\u0026#34; EventRoleChanged EventType = \u0026#34;role_changed\u0026#34; EventTokenExpired EventType = \u0026#34;token_expired\u0026#34; ) // Event — WS-событие, отправляемое клиентам type Event struct { Type EventType `json:\u0026#34;type\u0026#34;` ChartID string `json:\u0026#34;chartId\u0026#34;` UserID string `json:\u0026#34;userId,omitempty\u0026#34;` Payload interface{} `json:\u0026#34;payload,omitempty\u0026#34;` Timestamp time.Time `json:\u0026#34;timestamp\u0026#34;` } // IncomingMessage — сообщение от клиента (для ping/pong) type IncomingMessage struct { Type string `json:\u0026#34;type\u0026#34;` } hub.go — центральный брокер package ws import ( \u0026#34;sync\u0026#34; ) // Hub управляет комнатами и рассылкой событий type Hub struct { mu sync.RWMutex rooms map[string]map[*Client]bool // chartId → клиенты } func NewHub() *Hub { return \u0026amp;Hub{ rooms: make(map[string]map[*Client]bool), } } // Subscribe добавляет клиента в комнату func (h *Hub) Subscribe(chartID string, client *Client) { h.mu.Lock() defer h.mu.Unlock() if h.rooms[chartID] == nil { h.rooms[chartID] = make(map[*Client]bool) } h.rooms[chartID][client] = true // Уведомить остальных: user_joined h.broadcastExcept(chartID, client, Event{ Type: EventUserJoined, ChartID: chartID, UserID: client.UserID, Payload: map[string]string{\u0026#34;username\u0026#34;: client.Username}, Timestamp: time.Now(), }) } // Unsubscribe удаляет клиента из комнаты func (h *Hub) Unsubscribe(chartID string, client *Client) { h.mu.Lock() defer h.mu.Unlock() if clients, ok := h.rooms[chartID]; ok { delete(clients, client) if len(clients) == 0 { delete(h.rooms, chartID) } } // Уведомить остальных: user_left h.broadcastExcept(chartID, client, Event{ Type: EventUserLeft, ChartID: chartID, UserID: client.UserID, Timestamp: time.Now(), }) } // Broadcast рассылает событие всем клиентам в комнате func (h *Hub) Broadcast(chartID string, event Event) { h.mu.RLock() defer h.mu.RUnlock() if clients, ok := h.rooms[chartID]; ok { for client := range clients { client.Send(event) } } } // SendToUser отправляет событие конкретному пользователю во всех его комнатах func (h *Hub) SendToUser(userID string, event Event) { h.mu.RLock() defer h.mu.RUnlock() for _, clients := range h.rooms { for client := range clients { if client.UserID == userID { client.Send(event) } } } } // broadcastExcept рассылает всем, кроме отправителя func (h *Hub) broadcastExcept(chartID string, sender *Client, event Event) { if clients, ok := h.rooms[chartID]; ok { for client := range clients { if client != sender { client.Send(event) } } } } client.go — обёртка WS-соединения package ws import ( \u0026#34;encoding/json\u0026#34; \u0026#34;sync\u0026#34; \u0026#34;time\u0026#34; \u0026#34;github.com/gorilla/websocket\u0026#34; ) const ( writeWait = 10 * time.Second pongWait = 60 * time.Second pingPeriod = (pongWait * 9) / 10 maxMessageSize = 1024 ) type Client struct { Hub *Hub Conn *websocket.Conn UserID string Username string ChartID string SendCh chan Event mu sync.Mutex } func NewClient(hub *Hub, conn *websocket.Conn, userID, username, chartID string) *Client { return \u0026amp;Client{ Hub: hub, Conn: conn, UserID: userID, Username: username, ChartID: chartID, SendCh: make(chan Event, 64), } } // ReadPump читает входящие сообщения (ping/pong) func (c *Client) ReadPump() { defer func() { c.Hub.Unsubscribe(c.ChartID, c) c.Conn.Close() }() c.Conn.SetReadLimit(maxMessageSize) c.Conn.SetReadDeadline(time.Now().Add(pongWait)) c.Conn.SetPongHandler(func(string) error { c.Conn.SetReadDeadline(time.Now().Add(pongWait)) return nil }) for { _, message, err := c.Conn.ReadMessage() if err != nil { break } // Клиент может слать только ping, данные игнорируем _ = message } } // WritePump отправляет события клиенту func (c *Client) WritePump() { ticker := time.NewTicker(pingPeriod) defer func() { ticker.Stop() c.Conn.Close() }() for { select { case event, ok := \u0026lt;-c.SendCh: c.Conn.SetWriteDeadline(time.Now().Add(writeWait)) if !ok { c.Conn.WriteMessage(websocket.CloseMessage, []byte{}) return } data, _ := json.Marshal(event) c.mu.Lock() c.Conn.WriteMessage(websocket.TextMessage, data) c.mu.Unlock() case \u0026lt;-ticker.C: c.Conn.SetWriteDeadline(time.Now().Add(writeWait)) if err := c.Conn.WriteMessage(websocket.PingMessage, nil); err != nil { return } } } } // Send ставит событие в очередь отправки func (c *Client) Send(event Event) { select { case c.SendCh \u0026lt;- event: default: // Очередь полна — отключаем медленного клиента close(c.SendCh) } } 3.3. WS endpoint — internal/handlers/ws_handler.go package handlers import ( \u0026#34;net/http\u0026#34; \u0026#34;time\u0026#34; \u0026#34;app-leadera-api/internal/middleware\u0026#34; \u0026#34;app-leadera-api/internal/ws\u0026#34; \u0026#34;github.com/gin-gonic/gin\u0026#34; \u0026#34;github.com/google/uuid\u0026#34; \u0026#34;github.com/gorilla/websocket\u0026#34; ) var upgrader = websocket.Upgrader{ ReadBufferSize: 1024, WriteBufferSize: 1024, CheckOrigin: func(r *http.Request) bool { return true }, // nginx проксирует } type WSHandler struct { hub *ws.Hub ganttMW *middleware.GanttMiddleware } func NewWSHandler(hub *ws.Hub, ganttMW *middleware.GanttMiddleware) *WSHandler { return \u0026amp;WSHandler{hub: hub, ganttMW: ganttMW} } func (h *WSHandler) HandleGanttWS(c *gin.Context) { // 1. Получить пользователя из контекста (auth middleware уже отработал) userID, exists := c.Get(\u0026#34;userID\u0026#34;) if !exists { c.AbortWithStatusJSON(401, gin.H{\u0026#34;error\u0026#34;: \u0026#34;unauthorized\u0026#34;}) return } // 2. Проверить доступ к chartId (gantt middleware) chartID := c.Param(\u0026#34;chartId\u0026#34;) if _, err := uuid.Parse(chartID); err != nil { c.AbortWithStatusJSON(400, gin.H{\u0026#34;error\u0026#34;: \u0026#34;invalid chart id\u0026#34;}) return } // TODO: проверить через ganttMW что userID имеет доступ к этому chart // 3. Upgrade до WebSocket conn, err := upgrader.Upgrade(c.Writer, c.Request, nil) if err != nil { return } // 4. Создать клиент и подписать на комнату client := ws.NewClient( h.hub, conn, userID.(string), c.GetString(\u0026#34;username\u0026#34;), chartID, ) h.hub.Subscribe(chartID, client) // 5. Запустить pump\u0026#39;ы go client.WritePump() go client.ReadPump() } 3.4. Регистрация маршрута В cmd/server/main.go или где регистрируются routes:\n// После создания hub wsHub := ws.NewHub() // WS endpoint wsHandler := handlers.NewWSHandler(wsHub, ganttMW) api.GET(\u0026#34;/ws/gantt/:chartId\u0026#34;, authMW.RequireAuth(), wsHandler.HandleGanttWS) // Передать hub в ganttHandler для broadcast\u0026#39;ов ganttHandler := handlers.NewGanttHandler(ganttService, sectionService, taskService, blockService, wsHub) 3.5. Интеграция broadcast в handlers В каждый write-handler — одна строка после успешной операции:\n// Пример: после успешного UpdateTask h.hub.Broadcast(chartID, ws.Event{ Type: ws.EventTaskUpdated, ChartID: chartID, UserID: userID, Payload: updatedTask, Timestamp: time.Now(), }) Точки интеграции в gantt_handler.go:\nCreateGanttChart → не нужен (пользователь только что создал, он один) UpdateGanttChart / ArchiveGanttChart → chart_archived CreateSection → section_created UpdateSection → section_updated DeleteSection → section_deleted ReorderSections → sections_reordered CreateTask → task_created UpdateTask → task_updated DeleteTask → task_deleted 3.6. Интеграция событий безопасности В соответствующих service-методах:\n// При исключении из space (SpaceService.RemoveMember) wsHub.SendToUser(removedUserID, ws.Event{ Type: ws.EventAccessRevoked, Payload: map[string]string{\u0026#34;spaceId\u0026#34;: spaceID}, }) // При архивации ганта wsHub.Broadcast(chartID, ws.Event{ Type: ws.EventChartArchived, ChartID: chartID, }) // При изменении роли wsHub.SendToUser(userID, ws.Event{ Type: ws.EventRoleChanged, Payload: map[string]string{\u0026#34;role\u0026#34;: newRole}, }) 4. Frontend (Angular) 4.1. WebSocket сервис — gantt-ws.service.ts // src/app/pages/gantt/services/gantt-ws.service.ts import { Injectable, inject, OnDestroy } from \u0026#39;@angular/core\u0026#39;; import { Subject, Observable } from \u0026#39;rxjs\u0026#39;; import { environment } from \u0026#39;../../../environments/environment\u0026#39;; import { SpaceStorageService } from \u0026#39;../../../core/services/space-storage.service\u0026#39;; import { AuthService } from \u0026#39;../../../core/auth/services/auth.service\u0026#39;; export interface WSEvent { type: string; chartId?: string; userId?: string; payload?: any; timestamp?: string; } @Injectable({ providedIn: \u0026#39;root\u0026#39; }) export class GanttWSService implements OnDestroy { private spaceStorage = inject(SpaceStorageService); private auth = inject(AuthService); private socket: WebSocket | null = null; private eventSubject = new Subject\u0026lt;WSEvent\u0026gt;(); private reconnectTimer: any; private chartId: string | null = null; /** Observable для подписки на события */ get events$(): Observable\u0026lt;WSEvent\u0026gt; { return this.eventSubject.asObservable(); } /** Подключиться к комнате ганта */ connect(chartId: string): void { this.disconnect(); this.chartId = chartId; const token = this.auth.getAccessToken(); const wsUrl = this.buildWSUrl(chartId, token); this.socket = new WebSocket(wsUrl); this.socket.onopen = () =\u0026gt; { console.log(`[WS] Connected to gantt ${chartId}`); }; this.socket.onmessage = (msg) =\u0026gt; { try { const event: WSEvent = JSON.parse(msg.data); this.eventSubject.next(event); } catch (e) { console.error(\u0026#39;[WS] Parse error\u0026#39;, e); } }; this.socket.onclose = (event) =\u0026gt; { console.log(`[WS] Closed: ${event.code}`); if (event.code !== 1000) { this.scheduleReconnect(); } }; this.socket.onerror = () =\u0026gt; { this.socket?.close(); }; } /** Отключиться */ disconnect(): void { clearTimeout(this.reconnectTimer); if (this.socket) { this.socket.close(1000, \u0026#39;manual\u0026#39;); this.socket = null; } this.chartId = null; } ngOnDestroy(): void { this.disconnect(); } private buildWSUrl(chartId: string, token: string): string { const base = environment.wsUrl || location.protocol.replace(\u0026#39;http\u0026#39;, \u0026#39;ws\u0026#39;) + \u0026#39;//\u0026#39; + location.host; return `${base}/api/v1/ws/gantt/${chartId}?token=${token}`; } private scheduleReconnect(): void { if (!this.chartId) return; this.reconnectTimer = setTimeout(() =\u0026gt; { console.log(\u0026#39;[WS] Reconnecting...\u0026#39;); if (this.chartId) this.connect(this.chartId); }, 3000); } } 4.2. Интеграция в gantt-chart-canvas компонент // В gantt-chart-canvas.component.ts export class GanttChartCanvasComponent implements OnInit, OnDestroy { private ws = inject(GanttWSService); private onlineUsers: Set\u0026lt;string\u0026gt; = new Set(); private wsSubscription: Subscription | null = null; ngOnInit(): void { // Подключиться к WS при загрузке ганта this.ws.connect(this.chartId); this.wsSubscription = this.ws.events$.subscribe(event =\u0026gt; { this.handleWSEvent(event); }); } ngOnDestroy(): void { this.wsSubscription?.unsubscribe(); this.ws.disconnect(); } private handleWSEvent(event: WSEvent): void { // Если это событие от текущего пользователя — пропускаем // (мы уже обновили UI оптимистично или после HTTP-ответа) if (event.userId === this.currentUserId) return; switch (event.type) { case \u0026#39;section_created\u0026#39;: this.addSectionLocal(event.payload); this.redrawCanvas(); break; case \u0026#39;section_updated\u0026#39;: this.updateSectionLocal(event.payload); this.redrawCanvas(); break; case \u0026#39;section_deleted\u0026#39;: this.removeSectionLocal(event.payload.id); this.redrawCanvas(); break; case \u0026#39;sections_reordered\u0026#39;: this.reorderSectionsLocal(event.payload.ordered_ids); this.redrawCanvas(); break; case \u0026#39;task_created\u0026#39;: this.addTaskLocal(event.payload); this.redrawCanvas(); break; case \u0026#39;task_updated\u0026#39;: this.updateTaskLocal(event.payload); this.redrawCanvas(); break; case \u0026#39;task_deleted\u0026#39;: this.removeTaskLocal(event.payload.id); this.redrawCanvas(); break; case \u0026#39;user_joined\u0026#39;: this.onlineUsers.add(event.userId!); this.showOnlineIndicator(); break; case \u0026#39;user_left\u0026#39;: this.onlineUsers.delete(event.userId!); this.showOnlineIndicator(); break; // === Безопасность === case \u0026#39;access_revoked\u0026#39;: this.router.navigate([\u0026#39;/gantt\u0026#39;], { state: { alert: \u0026#39;Доступ к пространству был отозван\u0026#39; } }); break; case \u0026#39;chart_archived\u0026#39;: this.router.navigate([\u0026#39;/gantt\u0026#39;], { state: { alert: \u0026#39;Диаграмма была заархивирована\u0026#39; } }); break; case \u0026#39;role_changed\u0026#39;: this.currentRole = event.payload.role; this.updateEditableState(); break; case \u0026#39;token_expired\u0026#39;: this.router.navigate([\u0026#39;/auth/login\u0026#39;]); break; } } private redrawCanvas(): void { // Перерисовать Konva canvas с обновлёнными данными } } 4.3. Индикатор онлайн-пользователей Добавить в шаблон canvas-компонента:\n\u0026lt;!-- Онлайн-индикатор --\u0026gt; \u0026lt;div class=\u0026#34;online-indicator\u0026#34; *ngIf=\u0026#34;onlineUsers.size \u0026gt; 0\u0026#34;\u0026gt; \u0026lt;span class=\u0026#34;pulse-dot\u0026#34;\u0026gt;\u0026lt;/span\u0026gt; {{ onlineUsers.size }} онлайн \u0026lt;/div\u0026gt; 5. Безопасность 5.1. Авторизация при подключении Этап Проверка WS Handshake JWT в query-параметре ?token=... Подписка на комнату Проверка membership в space Каждое broadcast-событие Hub знает userId каждого клиента 5.2. Сценарии отзыва доступа Событие Триггер Действие на клиенте access_revoked Исключение из space Редирект на список гантов chart_archived Архивация ганта Редирект на список гантов role_changed Смена роли (editor→viewer) Отключить редактирование token_expired Токен протух Редирект на логин 5.3. Защита от злоупотреблений Угроза Мера Спам WS-сообщений Rate limit: 30 msg/min на клиента, ReadLimit в gorilla/websocket Подключение без прав Проверка space membership при handshake Истёкший токен Ping/pong + периодическая проверка JWT (раз в 5 мин) XSS через WS Payload — JSON, sanitize имён на frontend Мутации через WS WS только для чтения (уведомления). Мутации — через HTTP API с полной валидацией 5.4. Nginx конфигурация В конфиг sand.a2v.space добавить:\n# WebSocket проксирование location /api/v1/ws/ { proxy_pass http://127.0.0.1:8080; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \u0026#34;upgrade\u0026#34;; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_read_timeout 86400s; # 24h для long-lived WS proxy_send_timeout 86400s; } 6. Оценка трудозатрат Компонент Строки кода Время internal/ws/ (hub, client, message) ~200 2-3 часа ws_handler.go (endpoint) ~60 30 мин Интеграция broadcast в handlers ~20 (по строке на endpoint) 30 мин События безопасности в services ~30 30 мин gantt-ws.service.ts (Angular) ~80 1 час Интеграция в canvas-компонент ~80 1-2 часа Индикатор онлайн ~30 30 мин Nginx конфигурация ~10 10 мин Тестирование — 2-3 часа Итого ~510 строк ~1-2 дня 7. Порядок реализации Backend: internal/ws/ — hub, client, message types Backend: WS endpoint — handler + route Backend: Broadcast в handlers — интеграция в существующие CRUD-эндпоинты Backend: События безопасности — access_revoked, chart_archived, role_changed Nginx: WS location — проксирование WebSocket Frontend: WS service — подключение, реконнект, парсинг событий Frontend: Интеграция в canvas — обработка событий, обновление Konva Frontend: Индикатор онлайн — визуальная обратная связь Тестирование — многопользовательский сценарий, отзыв прав, обрывы связи 8. Дальнейшие улучшения (после MVP) Cursor других пользователей — показывать позицию курсора на таймлайне Блокировка элемента — «кто-то редактирует эту задачу» (optimistic locking через WS) Чат в ганте — комментарии к задачам прямо на канвасе History/undo — откат изменений с визуальной историей Уведомления — push-уведомления при @mention в комментариях к задачам ","section":"leadera","tags":["leadera","websocket","realtime","gantt","architecture"],"title":"Leadera — WebSocket для диаграмм Ганта","url":"/leadera/leadera-websocket-gantt/"},{"content":"Экспорт диаграммы Ганта в Excel Дата: 09.04.2026 Статус: Требования Проект: Leadera\nОбщее описание Пользователь нажимает кнопку экспорта в интерфейсе диаграммы Ганта. Система запрашивает диапазон дат выгрузки (по умолчанию — текущий видимый диапазон из интерфейса). После указания диапазона скачивается Excel-файл с визуальным представлением диаграммы Ганта.\nВводные данные Источник: текущая диаграмма Ганта проекта (один проект = одна диаграмма) Диапазон дат: пользователь указывает начальную и конечную дату. По умолчанию подставляется видимый в момент запроса диапазон из интерфейса Масштаб таймлайна: берётся тот, который выбран пользователем в интерфейсе в момент запроса (не сохранённый в системе, а текущий). Варианты: по ячейкам или по дням Структура Excel-файла Шапка (первые строки) Название диаграммы (название проекта) Диапазон дат, в рамках которого сделана выгрузка Лист — один Вся диаграмма размещается на одном листе.\nСекции Секции отображаются как визуальная группировка строк (не отдельные листы) Название секции — строка-заголовок над группой задач Задачи Каждая задача — отдельная строка. Данные задачи:\nНазвание (текстовая колонка слева) Дата начала (текстовая колонка слева) Дата конца (текстовая колонка слева) Цвет — ячейки таймлайна, соответствующие задаче, закрашены в цвет задачи Таймлайн Таймлайн представлен колонками дат в верхней части (горизонтальная ось времени) Масштаб колонок соответствует выбранному пользователем в момент экспорта (по ячейкам / по дням) Задачи отображаются как merged cells по соответствующим колонкам дат — визуальная полоса диаграммы Ганта Вехи Отображаются отдельной строкой (как задача, но с маркировкой вехи) Позиционируются на соответствующей дате в таймлайне Зависимости Не отображаются (стрелочки/связи между задачами не нужны) Пользовательский сценарий Пользователь открывает диаграмму Ганта проекта Настраивает масштаб таймлайна (по ячейкам / по дням) Нажимает кнопку «Экспорт в Excel» Система показывает диалог с выбором диапазона дат (предзаполнен текущим видимым диапазоном) Пользователь подтверждает / корректирует диапазон Система генерирует Excel-файл и инициирует скачивание Технические требования Backend (Go API) Новый endpoint для генерации Excel (например, GET /api/v1/gantt/:projectId/export) Query-параметры: dateFrom, dateTo, scale (cell|day) Ответ: binary Excel-файл (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet) Авторизация: обязательна (только участники проекта) Библиотека для генерации Excel: excelize (Go) Frontend (Angular) Кнопка экспорта в тулбаре диаграммы Ганта Модальное окно выбора диапазона дат с datepicker\u0026rsquo;ами Предзаполнение диапазона из текущего видимого viewport\u0026rsquo;а Скачивание файла через Blob / saveAs Фильтрация данных Выгружаются все задачи и вехи, которые: Начинаются в диапазоне, ИЛИ Заканчиваются в диапазоне, ИЛИ Начинаются до диапазона и заканчиваются после (перекрывают целиком) Секции включаются, если в них есть хотя бы одна попавшая задача Открытые вопросы (Нет)\n","section":"leadera","tags":["leadera","gantt","excel","export"],"title":"Leadera — Экспорт диаграммы Ганта в Excel","url":"/leadera/leadera-gantt-excel-export/"},{"content":"Фильтры и реорганизация списка диаграмм Ганта Дата: 07.04.2026 Статус: Требования Проект: Leadera (dev — sand.a2v.space)\n1. Постановка задачи Список диаграмм Ганта должен показывать все доступные пользователю диаграммы из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.\n2. Изменения API 2.1. Новый endpoint списка диаграмм Было:\nGET /api/v1/spaces/{spaceId}/gantt-charts?page=1\u0026amp;per_page=10 Стало:\nGET /api/v1/gantt-charts?page=1\u0026amp;per_page=10 Пользователь видит все диаграммы из всех пространств, где он является подтверждённым участником (статус accepted).\n2.2. Параметры фильтрации и поиска Параметр Тип Описание page int Номер страницы (default: 1) per_page int Записей на странице (default: 10) space_id UUID (optional) Фильтр по конкретному пространству created_by UUID (optional) Фильтр по создателю диаграммы search string (optional) Поиск по назвению и описанию (ILIKE, case-insensitive) sort string (optional) Сортировка: created_at, updated_at, title (default: updated_at) order string (optional) asc / desc (default: desc) Примеры:\nGET /api/v1/gantt-charts?search=миграция GET /api/v1/gantt-charts?space_id=0b334ded-...\u0026amp;created_by=a1b2c3d4-... GET /api/v1/gantt-charts?page=2\u0026amp;per_page=20\u0026amp;sort=title\u0026amp;order=asc 2.3. Изменение структуры ответа Добавить поле space в каждую диаграмму:\n{ \u0026#34;data\u0026#34;: [ { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;title\u0026#34;: \u0026#34;Миграция backend\u0026#34;, \u0026#34;description\u0026#34;: \u0026#34;...\u0026#34;, \u0026#34;created_by\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;created_by_name\u0026#34;: \u0026#34;Антон Агальцов\u0026#34;, \u0026#34;created_at\u0026#34;: \u0026#34;2026-04-01T10:00:00Z\u0026#34;, \u0026#34;updated_at\u0026#34;: \u0026#34;2026-04-07T09:00:00Z\u0026#34;, \u0026#34;space\u0026#34;: { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;name\u0026#34;: \u0026#34;IT Ландшафт\u0026#34;, \u0026#34;color\u0026#34;: \u0026#34;#c4623a\u0026#34; }, \u0026#34;is_archived\u0026#34;: false } ], \u0026#34;pagination\u0026#34;: { \u0026#34;page\u0026#34;: 1, \u0026#34;per_page\u0026#34;: 10, \u0026#34;total\u0026#34;: 42, \u0026#34;total_pages\u0026#34;: 5 } } 2.4. Endpoint для списка фильтров Вспомогательный endpoint для заполнения dropdown-фильтров:\nGET /api/v1/gantt-charts/filters Ответ:\n{ \u0026#34;spaces\u0026#34;: [ { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;name\u0026#34;: \u0026#34;IT Ландшафт\u0026#34;, \u0026#34;color\u0026#34;: \u0026#34;#c4623a\u0026#34; }, { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;name\u0026#34;: \u0026#34;DevOps\u0026#34;, \u0026#34;color\u0026#34;: \u0026#34;#27ae60\u0026#34; } ], \u0026#34;creators\u0026#34;: [ { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;display_name\u0026#34;: \u0026#34;Антон Агальцов\u0026#34; }, { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;display_name\u0026#34;: \u0026#34;Иван Петров\u0026#34; } ] } Логика creators: уникальные создатели всех диаграмм, доступных текущему пользователю. Получается через DISTINCT-запрос по created_by с JOIN на users.\n2.5. Backend — изменения в Go Файлы для изменения:\ninternal/handlers/gantt_handler.go Добавить новый handler ListAllGanttCharts — без привязки к space Зарегистрировать маршрут GET /gantt-charts (без /spaces/:id/) Парсить query-параметры: space_id, created_by, search, sort, order Старый маршрут GET /spaces/:id/gantt-charts — оставить для обратной совместимости (или удалить, если не используется) internal/service/gantt_service.go Новый метод ListAll(ctx, userId, filters) — запрашивает все spaces пользователя (через space_member с status=accepted), затем выбирает все gantt_charts из этих spaces с фильтрами internal/repository/gantt_repository.go Новый метод с динамическим SQL: Базовый JOIN: gantt_charts → spaces → space_members WHERE: space_members.user_id = $1 AND space_members.status = 'accepted' Опциональные фильтры: AND space_id = $N, AND created_by = $N, AND (title ILIKE '%' || $N || '%' OR description ILIKE '%' || $N || '%') Возвращать поле space (id, name, color) через JOIN internal/dto/gantt/ Новые DTO: GanttChartListFilters, GanttChartWithSpaceResponse, GanttFiltersResponse SQL (пример):\nSELECT gc.*, s.id as space_id, s.name as space_name, s.color as space_color, u.display_name as created_by_name FROM gantt_charts gc JOIN spaces s ON s.id = gc.space_id JOIN space_members sm ON sm.space_id = s.id LEFT JOIN users u ON u.id = gc.created_by WHERE sm.user_id = $1 AND sm.status = \u0026#39;accepted\u0026#39; AND ($2::uuid IS NULL OR gc.space_id = $2) AND ($3::uuid IS NULL OR gc.created_by = $3) AND ($4::text IS NULL OR gc.title ILIKE \u0026#39;%\u0026#39; || $4 || \u0026#39;%\u0026#39; OR gc.description ILIKE \u0026#39;%\u0026#39; || $4 || \u0026#39;%\u0026#39;) ORDER BY CASE WHEN $5 = \u0026#39;title\u0026#39; THEN gc.title END, CASE WHEN $5 = \u0026#39;created_at\u0026#39; THEN gc.created_at::text END, gc.updated_at DESC LIMIT $6 OFFSET $7; 3. Изменения Frontend (Angular) 3.1. Toolbar фильтров Добавить toolbar над списком диаграмм:\n┌──────────────────────────────────────────────────────────────────┐ │ [🔍 Поиск... ] [▼ Пространство] │ │ [▼ Создатель] [▼ Сортировка] [Сбросить фильтры] │ └──────────────────────────────────────────────────────────────────┘ Компоненты:\nСтрока поиска — input с debounce (300ms), поиск по назвению и описанию Dropdown «Пространство» — список из /gantt-charts/filters, с цветовой меткой Dropdown «Создатель» — список уникальных создателей Dropdown «Сортировка» — по дате обновления, дате создания, названию Кнопка «Сбросить» — очищает все фильтры Состояние фильтров в URL (query params):\n/gantt?search=миграция\u0026amp;space_id=xxx\u0026amp;sort=updated_at Это позволяет делиться ссылкой с уже настроенными фильтрами.\n3.2. Карточка диаграммы — бейдж пространства На каждой карточке добавить бейдж с названием пространства:\n┌─────────────────────────────────────┐ │ 🟠 IT Ландшафт │ ← бейдж с цветом пространства │ Миграция backend │ │ Перевод PHP→Go, этап 2 │ │ Создал: Антон А. · 07.04.2026 │ └─────────────────────────────────────┘ 3.3. Форма создания диаграммы — выбор пространства В модальном окне создания:\nDropdown со списком пространств, где пользователь имеет роль editor или выше Валидация: если пользователь не editor ни в одном пространстве — показать сообщение «Нет доступных пространств для создания» Запрос доступных пространств: переиспользовать существующий GET /api/v1/spaces с фильтрацией на клиенте по role ∈ [owner, admin, editor], либо добавить параметр ?min_role=editor на backend.\n3.4. Изменение routing Было:\n/gantt → список гантов текущего пространства Стало:\n/gantt → список всех доступных гантов (из всех пространств) Убрать зависимость от SpaceStorageService.getSelectedSpaceId() в списке гантов.\n3.5. Frontend — файлы для изменения Файл Изменение pages/gantt/services/gantt.service.ts Новый метод listAll(filters), getFilters() pages/gantt/gantt.component.ts Подключить toolbar, парсинг URL-параметров pages/gantt/gantt.component.html Добавить toolbar, бейджи на карточках pages/gantt/components/gantt-card/ Добавить бейдж пространства pages/gantt/components/create-chart-modal/ Dropdown выбора пространства core/models/ Обновить модели: добавить space в GanttChart 4. Обратная совместимость Endpoint Статус GET /api/v1/spaces/{id}/gantt-charts Сохранить (для детального view внутри пространства) GET /api/v1/gantt-charts Новый — глобальный список GET /api/v1/gantt-charts/filters Новый — данные для dropdown\u0026rsquo;ов POST /api/v1/spaces/{id}/gantt-charts Сохранить (создание в контексте пространства) Все CRUD для sections/tasks Без изменений 5. Критерии приёмки Endpoint GET /api/v1/gantt-charts возвращает все доступные диаграммы Фильтр по space_id — показывает только диаграммы конкретного пространства Фильтр по created_by — показывает только диаграммы выбранного создателя Поиск search — ищет по title и description (case-insensitive) Dropdown фильтров заполняется реальными данными из /filters Карточка диаграммы показывает бейдж пространства с цветом Форма создания предлагает только пространства с ролью ≥ editor Состояние фильтров сохраняется в URL (можно поделиться ссылкой) Старые endpoints (/spaces/{id}/gantt-charts) продолжают работать Swagger документация обновлена 6. Порядок реализации Backend: DTO для новых запросов/ответов Backend: Repository — SQL-запрос с фильтрами + JOIN на spaces Backend: Service — ListAll, GetFilters Backend: Handler — ListAllGanttCharts, GetGanttFilters, регистрация маршрутов Backend: Swagger — обновить документацию Frontend: Модели — обновить GanttChart, добавить Space в ответ Frontend: Service — listAll(), getFilters() Frontend: Toolbar компонент — поиск + dropdown\u0026rsquo;ы Frontend: Карточка — бейдж пространства Frontend: Модальное окно создания — dropdown пространства Frontend: URL-параметры — синхронизация фильтров с router Тестирование ","section":"leadera","tags":["leadera","gantt","api","frontend","requirements"],"title":"Leadera — Фильтры и реорганизация списка диаграмм Ганта","url":"/leadera/leadera-gantt-filters/"},{"content":"Публичный доступ к диаграмме Ганта (Share) Дата: 09.04.2026 Статус: Требования Проект: Leadera\nОбщее описание Пользователь может создать публичную ссылку на фрагмент диаграммы Ганта, доступную для просмотра без авторизации. Открывший ссылку видит диаграмму в read-only режиме с возможностью масштабирования таймлайна, но без каких-либо элементов управления (создание, редактирование, удаление задач/секций/вех).\nПользовательский сценарий (создатель ссылки) Пользователь открывает диаграмму Ганта проекта Нажимает кнопку «Экспорт» / «Общий доступ» Указывает диапазон дат, который должен отображаться на диаграмме Система генерирует уникальную ссылку (UUID) и показывает её пользователю Пользователь копирует ссылку и передаёт заинтересованным лицам Управление ссылками Вызывается через меню экспорта → модальное окно «Общий доступ» В модальном окне отображается список созданных ссылок с указанием диапазона дат Каждую ссылку можно удалить (полное удаление из БД, не soft delete) Ссылки нельзя редактировать — только создавать и удалять Ограничений на количество активных ссылок нет Статистика просмотров (сколько раз открывали) — не нужна Пользовательский сценарий (зритель по ссылке) Зритель переходит по ссылке (без авторизации) Открывается отдельная страница с диаграммой Ганта Зритель видит: Задачи и вехи, попадающие в заданный диапазон Секции (заголовки группировок) Таймлайн с цветовой раскраской задач Зритель может: Масштабировать таймлайн Переключать отображение «по ячейкам» / «по дням» Зритель не может: Создавать, редактировать, удалять задачи / секции / вехи Видеть любые контролы управления (кнопки создания, контекстные меню, drag-and-drop и т.д.) Авторизоваться через эту страницу Данные и фильтрация Что попадает в представление Задачи и вехи, у которых хотя бы одно из условий верно:\nДата начала попадает в диапазон ссылки Дата конца попадает в диапазон ссылки Задача начинается до диапазона и заканчивается после (полностью перекрывает) Секции включаются, если в них есть хотя бы одна попавшая задача.\nAPI возвращает Только задачи и вехи, попадающие в диапазон (не всю диаграмму) Информацию о секциях, содержащих попавшие задачи Минимальный набор полей, необходимый для отрисовки (без внутренних ID пользователей и т.п.) Технические требования Ссылки Формат: UUID v4 (каждый раз новый) Срок действия: бессрочно (пока не удалена) Удаление: жёсткое (hard delete из БД) Backend (Go API) Таблица БД: gantt_public_links id (UUID, PK) project_id (FK → projects) date_from (date) date_to (date) created_by (FK → users) created_at (timestamp) Endpoints POST /api/v1/gantt/:projectId/public-links — создать ссылку (авторизован, участник проекта) Body: { dateFrom, dateTo } Response: { url: \u0026quot;https://leadera.pro/share/\u0026lt;uuid\u0026gt;\u0026quot; } GET /api/v1/gantt/:projectId/public-links — список ссылок проекта (авторизован, участник) DELETE /api/v1/gantt/public-links/:uuid — удалить ссылку (авторизован, создатель) GET /api/v1/public/gantt/:uuid — получить данные диаграммы по ссылке (без авторизации) Response: задачи, вехи, секции в рамках диапазона Rate limiting На публичный endpoint GET /api/v1/public/gantt/:uuid — rate limiting для защиты от перебора Рекомендация: 60 запросов в минуту на IP Frontend (Angular) Модальное окно «Общий доступ» Вызывается из меню экспорта Содержит: Форму создания ссылки (диапазон дат + кнопка «Создать») Список существующих ссылок (диапазон + URL + кнопка «Копировать» + кнопка «Удалить») Публичная страница /share/:uuid Отдельный route, не требует авторизации Отображает диаграмму Ганта в read-only режиме Доступны только: масштабирование таймлайна, переключение ячейки/дни Все контролы управления скрыты (удалены из шаблона, не просто disabled) Минимальный layout — без навигации проекта, без сайдбара Открытые вопросы (Нет)\n","section":"leadera","tags":["leadera","gantt","public-access","sharing"],"title":"Leadera — Публичный доступ к диаграмме Ганта","url":"/leadera/leadera-gantt-public-access/"},{"content":"Бизнес-требования BR-1: Сущность «Веха» (Milestone) Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.\nПоля вехи:\nПоле Тип Описание id UUID Идентификатор gantt_chart_id UUID Принадлежность к диаграмме (не к секции!) title string Название вехи (обязательное, 1–255 символов) date date Дата вехи (без времени, обязательная) color string Цвет маркера (HEX, по умолчанию #dc3545 — красный) created_by UUID Кто создал (не отображается в UI, хранится для аудита) updated_by UUID Кто обновил (не отображается в UI) created_at timestamp Дата создания updated_at timestamp Дата обновления deleted_at timestamp Soft delete Права доступа: Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).\nОсобенности:\nВех может быть несколько в проекте Несколько вех могут иметь одну и ту же дату Вехи сортируются строго по дате (по возрастанию) Вехи не привязаны к секциям — они отображаются сквозь все секции BR-2: Управление вехами (модальное окно) Вызов: Кнопка «Вехи» рядом с кнопкой «Создать секцию» на странице диаграммы.\nМодальное окно содержит:\nЗаголовок: «Вехи проекта» Список всех вех текущей диаграммы (сортировка по дате по возрастанию) Каждая веха в списке показывает: цвет (индикатор), название, дату, кнопки «Редактировать» и «Удалить» Кнопка «Добавить веху» Форма добавления/редактирования вехи:\nНазвание — текстовый ввод (обязательное, 1–255 символов) Дата — datepicker (обязательное) Цвет — выбор цвета (по аналогии с палитрой цветов в задачах) По умолчанию цвет = красный (#dc3545) Удаление: с подтверждением (confirm dialog).\nBR-3: Отображение вех на таймлайне Визуальное представление:\nМаркер-флажок (flag marker) на шкале таймлайна От маркера вниз идёт пунктирная вертикальная линия через все секции (на всю высоту диаграммы) Цвет линии и маркера = цвет вехи Позиционирование:\nВеха ставится ровно на свою дату на шкале времени Если дата вехи выходит за рамки текущего диапазона задач — таймлайн расширяется (аналогично задачам) При изменении масштаба (days/weeks/months/quarters) позиция вехи пересчитывается Tooltip при наведении:\nПри наведении на маркер/линию — показывается tooltip с названием вехи Если на одну дату приходится несколько вех — в tooltip показываются все вехи этой даты с их названиями (каждая с индикацией своего цвета) Технические требования База данных Новая таблица: gantt_milestones CREATE TABLE gantt_milestones ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), gantt_chart_id UUID NOT NULL REFERENCES gantt_charts(id) ON DELETE CASCADE, title VARCHAR(255) NOT NULL, date DATE NOT NULL, color VARCHAR(20) NOT NULL DEFAULT \u0026#39;#dc3545\u0026#39;, created_by UUID NOT NULL REFERENCES users(id), updated_by UUID NOT NULL REFERENCES users(id), created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), deleted_at TIMESTAMP WITH TIME ZONE ); CREATE INDEX idx_gantt_milestones_chart ON gantt_milestones(gantt_chart_id); CREATE INDEX idx_gantt_milestones_date ON gantt_milestones(date); Backend (Go API) Этап 1: Миграция + Домен Промт для агента:\nДобавь в проект новую таблицу gantt_milestones.\nСоздай миграцию в cmd/migrate/:\nНовая таблица gantt_milestones с полями: id (UUID PK), gantt_chart_id (UUID FK → gantt_charts, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), date (DATE NOT NULL), color (VARCHAR 20 NOT NULL DEFAULT \u0026lsquo;#dc3545\u0026rsquo;), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. Индексы по gantt_chart_id и date. Создай доменную модель GanttMilestone в internal/domain/gantt.go:\ntype GanttMilestone struct { ID UUID `json:\u0026#34;id\u0026#34;` GanttChartID UUID `json:\u0026#34;gantt_chart_id\u0026#34;` Title string `json:\u0026#34;title\u0026#34;` Date time.Time `json:\u0026#34;date\u0026#34;` Color string `json:\u0026#34;color\u0026#34;` CreatedBy UUID `json:\u0026#34;created_by\u0026#34;` UpdatedBy UUID `json:\u0026#34;updated_by\u0026#34;` CreatedAt time.Time `json:\u0026#34;created_at\u0026#34;` UpdatedAt time.Time `json:\u0026#34;updated_at\u0026#34;` DeletedAt *time.Time `json:\u0026#34;deleted_at,omitempty\u0026#34;` } Этап 2: CRUD для GanttMilestones Промт для агента:\nРеализуй полный CRUD для сущности GanttMilestone по аналогии с существующими handlers/services/repositories в проекте.\nРоуты:\nGET /api/gantt-charts/:chartId/milestones — список вех диаграммы POST /api/gantt-charts/:chartId/milestones — создать веху PUT /api/gantt-charts/:chartId/milestones/:milestoneId — обновить веху DELETE /api/gantt-charts/:chartId/milestones/:milestoneId — удалить веху (soft delete) Repository: internal/repository/gantt_milestone_repository.go\nGetByChartID(ctx, chartID) ([]domain.GanttMilestone, error) — все неудалённые вехи диаграммы, отсортированные по date ASC GetByID(ctx, id) (*domain.GanttMilestone, error) Create(ctx, milestone) error Update(ctx, milestone) error Delete(ctx, id) error — soft delete (set deleted_at) Все запросы — raw SQL через pgx, как в остальных репозиториях проекта Service: internal/service/gantt_milestone_service.go\nВалидация: title (1–255 символов), date (обязательное), color (валидный HEX, default \u0026lsquo;#dc3545\u0026rsquo;) Проверка прав доступа: пользователь должен иметь права выше «только чтение» в пространстве (space) диаграммы Проверка что chartId существует и не архивирован Handler: internal/handler/gantt_milestone_handler.go\nSwagger-аннотации для всех эндпоинтов Валидация входных данных Ошибки в формате проекта DTO: internal/dto/gantt/milestones_dto.go\ntype CreateGanttMilestoneRequest struct { Title string `json:\u0026#34;title\u0026#34; binding:\u0026#34;required,min=1,max=255\u0026#34;` Date string `json:\u0026#34;date\u0026#34; binding:\u0026#34;required\u0026#34;` Color *string `json:\u0026#34;color\u0026#34; binding:\u0026#34;omitempty,max=20\u0026#34;` } type UpdateGanttMilestoneRequest struct { Title *string `json:\u0026#34;title\u0026#34; binding:\u0026#34;omitempty,min=1,max=255\u0026#34;` Date *string `json:\u0026#34;date\u0026#34; binding:\u0026#34;omitempty\u0026#34;` Color *string `json:\u0026#34;color\u0026#34; binding:\u0026#34;omitempty,max=20\u0026#34;` } type GanttMilestoneResponse struct { ID domain.UUID `json:\u0026#34;id\u0026#34;` GanttChartID domain.UUID `json:\u0026#34;gantt_chart_id\u0026#34;` Title string `json:\u0026#34;title\u0026#34;` Date string `json:\u0026#34;date\u0026#34;` Color string `json:\u0026#34;color\u0026#34;` CreatedByUser *CreatedByUpdatedUser `json:\u0026#34;created_by_user\u0026#34;` UpdatedByUser *CreatedByUpdatedUser `json:\u0026#34;updated_by_user\u0026#34;` CreatedAt time.Time `json:\u0026#34;created_at\u0026#34;` UpdatedAt time.Time `json:\u0026#34;updated_at\u0026#34;` } type GanttMilestonesListResponse struct { Milestones []GanttMilestoneResponse `json:\u0026#34;milestones\u0026#34;` } Регистрация роутов: Добавь группу milestone-роутов в роутер рядом с существующими роутами секций/задач. Проверка прав через существующий middleware.\nЭтап 3: Включение вех в ответ диаграммы Промт для агента:\nПри запросе данных диаграммы Ганта (полная загрузка) включай связанные вехи в ответ.\nДобавь эндпоинт или расширь существующий GET /api/gantt-charts/:chartId — включить поле milestones с массивом GanttMilestoneResponse Вехи с deleted_at IS NOT NULL не возвращаются Вехи сортируются по date ASC Вехи загружаются вместе с данными диаграммы (tasks, sections) — один запрос при открытии Ганта Frontend (Angular) Этап FE-1: Модели + Сервис Промт для агента:\nДобавь в проект поддержку вех (milestones) на диаграмме Ганта.\nВ pages/gantt/models/ (или соответствующем файле моделей) добавь: export interface GanttMilestone { id: string; gantt_chart_id: string; title: string; date: string; color: string; created_by_user?: { id: string; full_name: string }; updated_by_user?: { id: string; full_name: string }; created_at: string; updated_at: string; } export interface GanttMilestoneCreateRequest { title: string; date: string; color?: string; } export interface GanttMilestoneUpdateRequest { title?: string; date?: string; color?: string; } Добавь milestones: GanttMilestone[] в интерфейс/модель полной загрузки данных диаграммы\nСоздай сервис pages/gantt/services/gantt-milestone.service.ts:\nInject HttpClient Методы: getMilestones(chartId: string): Observable\u0026lt;GanttMilestone[]\u0026gt; createMilestone(chartId: string, data: GanttMilestoneCreateRequest): Observable\u0026lt;GanttMilestone\u0026gt; updateMilestone(chartId: string, milestoneId: string, data: GanttMilestoneUpdateRequest): Observable\u0026lt;GanttMilestone\u0026gt; deleteMilestone(chartId: string, milestoneId: string): Observable\u0026lt;void\u0026gt; Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService) Этап FE-2: Модальное окно управления вехами Промт для агента:\nСоздай компонент модального окна для управления вехами диаграммы Ганта.\nСоздай компонент pages/gantt/components/milestones-modal/\nКнопка вызова: Добавь кнопку «Вехи» рядом с кнопкой «Создать секцию» в toolbar диаграммы. По клику — открытие модального окна через ng-bootstrap NgbModal.\nМодальное окно (ng-bootstrap modal):\nЗаголовок: «Вехи проекта» Список вех (сортировка по date ASC): Каждый элемент: цветной кружок (color), название, дата (форматированная), кнопки ✏️ (редактировать) и 🗑️ (удалить с confirm) Кнопка «Добавить веху» внизу списка Если вех нет — сообщение «Вех пока нет. Добавьте первую!» Форма добавления/редактирования (inline в модальном окне):\nНазвание — текстовый ввод (обязательное) Дата — ng-bootstrap datepicker (обязательное) Цвет — палитра цветов (использовать тот же компонент/подход, что и для задач) По умолчанию цвет = #dc3545 (красный) Кнопки «Сохранить» и «Отмена» При сохранении — вызов соответствующего метода сервиса (create/update)\nПри удалении — confirm dialog → вызов deleteMilestone\nПосле любого изменения — обновить список вех и обновить данные на канвасе (через сервис/GanttStore)\nИнжектировать GanttMilestoneService и NgbModal\nЭтап FE-3: Отображение вех на таймлайне (Konva canvas) Промт для агента:\nОтобрази вехи (milestones) на canvas-диаграмме Ганта.\nПроект использует Konva.js для рендеринга.\nПри загрузке данных диаграммы — извлечь массив milestones\nДля каждой вехи нарисовать на canvas:\nМаркер-флажок (flag marker) на позиции даты вехи на шкале времени Стиль: маленький треугольник или флаг на верхней границе таймлайна Цвет = milestone.color Пунктирная вертикальная линия от маркера вниз через все секции (на всю высоту области секций) Стиль: Konva.Line, dash: [5, 5], strokeWidth: 1.5, color = milestone.color, opacity: 0.7 Позиционирование:\nРассчитать X-позицию по дате вехи с использованием текущей шкалы времени (как для задач) Если дата вехи выходит за текущий диапазон — расширить диапазон (влияет на общую ширину таймлайна) При изменении масштаба (days/weeks/months/quarters) — пересчитать позиции всех вех При скролле — вехи скроллятся вместе с задачами Tooltip при наведении:\nПри наведении на маркер или пунктирную линию — показать Konva.Tooltip или HTML tooltip: Если веха одна на эту дату — показать название Если несколько вех на одну дату — показать список: цветной кружок + название для каждой Z-index:\nЛинии вех рисуются поверх фона секций, но под задачами Маркеры-флажки — поверх всего (самый высокий z-index) Реактивность:\nПри добавлении/удалении/редактировании вехи — перерисовать только вехи (без полного ре рендера задач) Подписаться на изменения массива milestones через сервис/store Порядок реализации # Этап Сторона Зависимости 1 Миграция + Домен Backend — 2 CRUD вех Backend Этап 1 3 Включение вех в ответ диаграммы Backend Этап 2 4 Модели + Сервис Frontend — (параллельно с backend) 5 Модальное окно управления вехами Frontend Этапы 4 + backend 2 6 Отображение вех на таймлайне Frontend Этапы 4 + backend 3 ","section":"leadera","tags":["leadera","gantt","angular","go","api","ux"],"title":"Leadera: Вехи (Milestones) на диаграмме Ганта","url":"/leadera/leadera-milestones/"},{"content":"Бизнес-требования BR-1: Лимит одновременных задач (Concurrency Limit) У каждой секции появляется параметр max_concurrent_tasks (целое число ≥ 0, по умолчанию 0).\nПоведение:\nЕсли max_concurrent_tasks = 3 — в любой данный день в этой секции не может быть больше 3 активных задач одновременно Если max_concurrent_tasks = 0 — ограничение отключено, лимита нет Пересечение считается по дате: задача занимает дни с start_date по end_date включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день Ограничение работает только в рамках одной секции. Задачи из разных секций не влияют друг на друга Срабатывание при:\nСоздании задачи — если добавление нарушает лимит → Alert Перетаскивании задачи (drag) — если новая позиция нарушает лимит → Alert Растягивании задачи (resize) — если новый размер нарушает лимит → Alert Редактировании задачи (форма) — если изменённые даты нарушают лимит → Alert Важно: Действие НЕ отменяется. Задача создаётся/перемещается в любом случае, но пользователь видит предупреждение.\nТекст Alert: «В секции \u0026ldquo;[название секции]\u0026rdquo; на [дата/диапазон] превышен лимит одновременных задач (максимум: N)»\nBR-2: Блоки секций (Section Blocks) У каждой секции появляется набор блоков — особый вид записей, отображаемых на таймлайне как заштрихованные области.\nСущность GanttSectionBlock:\nПоле Тип Описание id UUID Идентификатор section_id UUID Принадлежность к секции title string Название (например: «Отпуск», «Командировка») start_date date Начало интервала (минимум 1 день) end_date date Конец интервала block_concurrency boolean Запрещать ли пересечение обычных задач с данным блоком Валидация:\nend_date не может быть раньше start_date Все поля обязательны Блок может быть в прошлом Визуальное отображение на Ганте:\nЗаштрихованная область на всю высоту секции (включая все строки задач в секции) Название блока отображается поверх штриховки с подложкой (для читаемости) Поведение block_concurrency:\nЕсли block_concurrency = true — при пересечении задачи с данным блоком показывается Alert (аналогично BR-1), но задача всё равно создаётся/перемещается Если block_concurrency = false — блок отображается визуально, но не влияет на задачи Срабатывание при:\nСоздании задачи — пересекает блок с block_concurrency = true → Alert Перетаскивании задачи (drag) → Alert Растягивании задачи (resize) → Alert Редактировании задачи (форма) → Alert Текст Alert: «В секции \u0026ldquo;[название секции]\u0026rdquo; задача пересекает блок \u0026ldquo;[название блока]\u0026rdquo; ([дата] — [дата])»\nBR-3: Система Alert-ов Все предупреждения (от BR-1 и BR-2) выводятся в единую область над диаграммой Ганта.\nПоведение:\nAlert-ы — Bootstrap Alert (warning), постоянные Пользователь НЕ может закрыть Alert вручную Alert исчезает автоматически, когда текущая дата прошла дату конфликта (конфликт больше не актуален) Проверка конфликтов — только на фронтенде (на основе загруженных данных: задачи секции, блоки, max_concurrent_tasks) Если Alert-ов много — область сворачиваемая с счётчиком в бейдже (например: «⚠️ 3 предупреждения») По умолчанию — развёрнуто Сворачивание/разворачивание — клик по заголовку области BR-4: Настройки секции Настройки совмещены с существующим модальным окном редактирования секции (не отдельное окно) Окно создания секции — добавляется:\nПоле «Макс. одновременных задач» (числовой ввод, 0 = без лимита, по умолчанию 0) Окно редактирования секции — добавляется:\nПоле «Макс. одновременных задач» (числовой ввод, 0 = без лимита) Список блоков (таблица/список с CRUD: добавить, редактировать, удалить) Сортировка: по start_date по убыванию (будущее сверху) Каждый блок — форма: title, start_date, end_date, block_concurrency (чекбокс: «Запретить пересечение задач») Валидация: end_date \u0026gt;= start_date, все поля заполнены BR-5: Наследование При появлении функционала копирования/дублирования диаграммы — настройки секций (лимит + блоки) наследуются Технические требования База данных Новая таблица: gantt_section_blocks CREATE TABLE gantt_section_blocks ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), section_id UUID NOT NULL REFERENCES gantt_sections(id) ON DELETE CASCADE, title VARCHAR(255) NOT NULL, start_date DATE NOT NULL, end_date DATE NOT NULL, block_concurrency BOOLEAN NOT NULL DEFAULT false, created_by UUID NOT NULL REFERENCES users(id), updated_by UUID NOT NULL REFERENCES users(id), created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), deleted_at TIMESTAMP WITH TIME ZONE, CONSTRAINT chk_block_dates CHECK (end_date \u0026gt;= start_date) ); CREATE INDEX idx_gantt_section_blocks_section ON gantt_section_blocks(section_id); CREATE INDEX idx_gantt_section_blocks_dates ON gantt_section_blocks(start_date, end_date); Изменение таблицы: gantt_sections ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0; Backend (Go API) Этап 1: Миграция + Домен Промт для агента:\nДобавь в проект новую таблицу gantt_section_blocks и колонку max_concurrent_tasks в gantt_sections.\nСоздай миграцию в cmd/migrate/: Новая таблица gantt_section_blocks с полями: id (UUID PK), section_id (UUID FK → gantt_sections, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), start_date (DATE NOT NULL), end_date (DATE NOT NULL), block_concurrency (BOOLEAN DEFAULT false), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. CHECK constraint: end_date \u0026gt;= start_date. Индексы по section_id и (start_date, end_date). ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0. Создай доменную модель GanttSectionBlock в internal/domain/gantt.go со всеми полями таблицы. Добавь поле MaxConcurrentTasks int в структуру GanttSection. Обнови маппинг в relevant repository файлах, чтобы новое поле max_concurrent_tasks читалось/писалось. Этап 2: CRUD для GanttSectionBlocks Промт для агента:\nРеализуй полный CRUD для сущности GanttSectionBlock по аналогии с существующими handlers/services/repositories в проекте.\nРоуты (внутри группы секции):\nGET /api/gantt-charts/:chartId/sections/:sectionId/blocks — список блоков секции POST /api/gantt-charts/:chartId/sections/:sectionId/blocks — создать блок PUT /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId — обновить блок DELETE /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId — удалить блок (soft delete) Repository: internal/repository/gantt_section_block_repository.go\nGetBySectionID(ctx, sectionID) ([]domain.GanttSectionBlock, error) GetByID(ctx, id) (*domain.GanttSectionBlock, error) Create(ctx, block) error Update(ctx, block) error Delete(ctx, id) error — soft delete (set deleted_at) Все запросы — raw SQL через pgx, как в остальных репозиториях проекта Service: internal/service/gantt_section_block_service.go\nБизнес-логика: валидация dates (end \u0026gt;= start), проверка прав доступа к секции Inject repository Handler: internal/handler/gantt_section_block_handler.go\nSwagger-аннотации для всех эндпоинтов Валидация входных данных Ошибки в формате проекта (GanttErrorResponse) Модели запросов:\nCreate: title (required), start_date (required), end_date (required), block_concurrency (bool, default false) Update: title, start_date, end_date, block_concurrency — все опциональны Этап 3: Обновление настроек секции Промт для агента:\nОбнови CRUD секций (gantt_sections) для поддержки нового поля max_concurrent_tasks.\nДобавь max_concurrent_tasks в GanttSectionCreateRequest (опциональное, int ≥ 0, default 0) Добавь max_concurrent_tasks в GanttSectionUpdateRequest (опциональное, int ≥ 0) Обнови SQL-запросы в repository: INSERT и UPDATE должны включать max_concurrent_tasks При GET секции (или списке секций) — возвращать max_concurrent_tasks в ответе Валидация: значение должно быть ≥ 0 Этап 4: Включение блоков в ответ секций Промт для агента:\nПри запросе списка секций или одной секции включай связанные блоки в ответ.\nОбнови GET /api/gantt-charts/:chartId/sections/:sectionId — добавить поле blocks с массивом GanttSectionBlock Обнови GET /api/gantt-charts/:chartId/sections — добавить поле blocks для каждой секции Блоки с deleted_at IS NOT NULL не возвращаются Блоки сортируются по start_date по убыванию (будущее сверху) Frontend (Angular) Этап FE-1: Модели + Сервис Промт для агента:\nДобавь в проект поддержку ограничений секций Ганта.\nВ pages/gantt/models/gantt-chart.model.ts добавь: export interface GanttSectionBlock { id: string; section_id: string; title: string; start_date: string; end_date: string; block_concurrency: boolean; created_by_user: UserInfo; updated_by_user: UserInfo; created_at: string; updated_at: string; } export interface GanttSectionBlockCreateRequest { title: string; start_date: string; end_date: string; block_concurrency?: boolean; } export interface GanttSectionBlockUpdateRequest { title?: string; start_date?: string; end_date?: string; block_concurrency?: boolean; } export interface ConflictCheck { has_conflicts: boolean; conflicts: ConflictItem[]; } export interface ConflictItem { type: \u0026#39;concurrency\u0026#39; | \u0026#39;block\u0026#39;; section_id: string; section_title: string; block_title?: string; start_date?: string; end_date?: string; message: string; dates?: string[]; } Добавь max_concurrent_tasks: number в интерфейс GanttSection\nДобавь blocks: GanttSectionBlock[] в интерфейс GanttSection\nДобавь max_concurrent_tasks?: number в GanttSectionCreateRequest и GanttSectionUpdateRequest\nСоздай сервис pages/gantt/services/gantt-section-block.service.ts:\nInject HttpClient Методы: getBlocks(chartId, sectionId), createBlock(chartId, sectionId, data), updateBlock(chartId, sectionId, blockId, data), deleteBlock(chartId, sectionId, blockId) Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService) Этап FE-2: Интеграция в модальные окна секции Промт для агента:\nИнтегрируй настройки ограничений в существующие модальные окна создания и редактирования секции Ганта.\nНайди существующие компоненты модальных окон секции (создание/редактирование). Окно создания секции — добавить:\nЧисловой ввод: «Максимум одновременных задач» Подсказка: «0 = без ограничений» Валидация: число ≥ 0 Значение по умолчанию: 0 Отправляется в GanttSectionCreateRequest как max_concurrent_tasks Окно редактирования секции — добавить:\nЧисловой ввод: «Максимум одновременных задач» (аналогично созданию) Секция «Блоки (запретные интервалы)»: Таблица/список существующих блоков с колонками: Название, Начало, Конец, Блокировка (чекбокс/иконка), Действия (редактировать/удалить) Сортировка: по start_date по убыванию (будущее сверху) Кнопка «Добавить блок» — inline-форма: title (текстовый ввод, обязательный) start_date (datepicker, обязательный) end_date (datepicker, обязательный) block_concurrency (чекбокс: «Запретить пересечение задач») Валидация: end_date \u0026gt;= start_date, все поля заполнены Редактирование — inline или через ту же форму Удаление — с подтверждением При открытии окна редактирования — загрузить текущие настройки секции + блоки При сохранении — обновить max_concurrent_tasks и сохранить изменения блоков Инжектировать GanttChartService и GanttSectionBlockService Этап FE-3: Визуализация блоков на Ганте Промт для агента:\nОтобрази блоки секций (GanttSectionBlock) на canvas-диаграмме Ганта.\nПроект использует Konva.js для рендеринга. Основной компонент: gantt-chart-canvas.\nПри загрузке данных диаграммы — извлечь блоки из каждой секции В рендерере секций (canvas/timeline-renderer.ts или аналогичный) — для каждого блока: Нарисовать заштрихованную область (diagonal hatch pattern) на всю высоту секции (все строки задач в этой секции) Область ограничена по горизонтали: от start_date до end_date (в пикселях по шкале времени) Цвет штриховки: полупрозрачный серый или configurable Поверх штриховки — текст с названием блока (block.title) на подложке (прямоугольник с фоном, чтобы текст читался) Блоки рендерятся до задач (z-index ниже), чтобы задачи были поверх Блоки с block_concurrency = true и false визуально не отличаются (штриховка одинаковая) При скролле/зуме — блоки пересчитываются как обычные элементы таймлайна Этап FE-4: Система Alert-ов Промт для агента:\nСоздай компонент для отображения Alert-ов о конфликтах на диаграмме Ганта.\nСоздай компонент pages/gantt/components/gantt-conflict-alerts/\nКомпонент размещается над canvas-диаграммой Ганта\nВходные данные: массив ConflictItem[] (из модели)\nВизуал:\nBootstrap Alert (warning) для каждого конфликта Каждый Alert показывает message из ConflictItem Без кнопки закрытия — Alert нельзя закрыть вручную Alert исчезает автоматически, когда текущая дата прошла дату конфликта Область сворачиваемая: заголовок «⚠️ Предупреждения (N)» — клик сворачивает/разворачивает список По умолчанию — развёрнуто При 0 конфликтов — область скрыта Состояние хранится в сервисе или в компоненте диаграммы:\nДобавление нового конфликта → area auto-expands Alert удаляется из массива автоматически, когда текущая дата прошла дату конфликта Проверка актуальности конфликтов — при каждой отрисовке / изменении данных Не использовать toast — Alert-ы постоянные Этап FE-5: Проверка конфликтов при операциях с задачами Промт для агента:\nИнтегрируй проверку конфликтов во все операции с задачами на диаграмме Ганта.\nПроект использует interaction-handler.ts для drag/resize и формы для создания/редактирования.\nВажно: Проверка конфликтов — только на фронтенде, без вызова API. Используются загруженные данные секции (задачи, блоки, max_concurrent_tasks).\nВынеси логику проверки конфликтов checkConflicts() в отдельный метод в gantt-canvas.service.ts:\nПринимает: section (GanttSection — содержит max_concurrent_tasks и blocks), tasks (GanttTask[] — задачи секции), task_id (nullable — исключить текущую задачу), start_date, end_date Логика: a. Если section.max_concurrent_tasks \u0026gt; 0: посчитать кол-во задач (исключая task_id), пересекающихся с [start_date, end_date] на каждый день. Если в любой день count \u0026gt; max_concurrent_tasks — добавить конфликт concurrency b. Для каждого блока секции с block_concurrency = true, пересекающегося с [start_date, end_date] — добавить конфликт block Возвращает ConflictCheck После каждой успешной операции с задачей (создание, обновление, drag, resize):\nВызвать checkConflicts с параметрами задачи Если has_conflicts = true — передать конфликты в GanttConflictAlertsComponent Alert-ы показываются, действие НЕ отменяется Точки интеграции:\nСоздание задачи (форма): после успешного POST → checkConflicts → show alerts Редактирование задачи (форма): после успешного PUT → checkConflicts → show alerts Drag задачи (interaction-handler.ts): после успешного обновления позиции → checkConflicts → show alerts Resize задачи (interaction-handler.ts): после успешного обновления размера → checkConflicts → show alerts При переключении диаграммы или секции — очищать Alert-ы\nAlert-ы автоматически удаляются, когда текущая дата прошла дату конфликта — область скрывается, когда конфликтов не осталось\nПорядок реализации # Этап Сторона Зависимости 1 Миграция + Домен Backend — 2 CRUD блоков Backend Этап 1 3 Обновление настроек секции Backend Этап 1 4 Включение блоков в ответ секций Backend Этап 2 5 Модели + Сервис Frontend — (можно параллельно с backend) 6 Интеграция в модальные окна Frontend Этапы 5 + backend 2,3 7 Визуализация блоков на Ганте Frontend Этапы 5 + backend 4 8 Система Alert-ов Frontend Этап 5 9 Проверка конфликтов при операциях Frontend Этапы 5,7,8 ","section":"leadera","tags":["leadera","gantt","angular","go","api","ux"],"title":"Leadera: Ограничения секций в диаграмме Ганта","url":"/leadera/leadera-section-constraints/"},{"content":"Timeline Утро — Обсуждали аналоги htop: порекомендовал btm, btop, glances. Создан конфиг ~/.config/bottom/bottom.toml День — Разбирались со скиллами OpenCode: как работают, автоматический подбор по description День — Созданы скиллы для Leadera проектов (Go: build-and-fix, restart-api; Angular: build-and-fix) День — Обсудили миграцию Ганта с DOM на Canvas 2D (Konva.js) — real-time коллаборация, экспорт PDF/PNG, 500+ задач Вечер — Установлен gh CLI, авторизован как agaltsovav Вечер — Созданы GitHub Projects: Leadera Roadmap (21 задача, P0–P3), agaltsovav.ru Roadmap (7 задач) Системные утилиты bottom (btm) — выбранный мониторинг, конфиг в ~/.config/bottom/bottom.toml Альтернативы: btop, glances OpenCode Skills Созданы скиллы:\napp-leadera-api/.opencode/skills/build-and-fix/ — сборка Go проекта + автофикс ошибок (до 10 итераций) app-leadera-api/.opencode/skills/restart-api/ — swagger генерация + pm2 restart app-leadera-fe/.opencode/skills/build-and-fix/ — сборка Angular + автофикс Gantt Canvas миграция Переход с DOM на Canvas 2D через Konva.js Цели: real-time коллаборация, экспорт PDF/PNG, 500+ задач Промт: GANTT_CANVAS_MIGRATION_PROMPT.md в app-leadera-fe GitHub CLI: gh авторизован (agaltsovav) Репо: app-leadera-fe, app-leadera-api, agaltsovav.ru Старые: leadera-fe/leadera-api (на VPS, leadera.ru) modece.ru — заброшен, планируется возвращение GitHub Projects — Roadmaps Leadera Roadmap (project #2) — 21 задача P0: JWT secret, CORS, bcrypt, ContextRole fallback, RegisterProtectedRoutes P1: Rate limiting, editor role check, MembersModal rewrite P2: HttpOnly cookies, CSRF, CSP, password policy, audit log, health-check, CI/CD, Canvas миграция, DnD P3: Code cleanup, тесты, email verification, поиск agaltsovav.ru Roadmap (project #1) — 7 задач Редизайн, мобильная версия, мультиязычность, блог, CI/CD, тёмная тема, форма обратной связи ","section":"diary","tags":["system-utils","opencode","leadera","gantt","canvas","github","roadmap"],"title":"31 марта 2026","url":"/diary/2026-03-31/"},{"content":"Проблема В params.toml:\ncopyRight = \u0026#34;Copyright (c) 2020-2025 Антон Агальцов\u0026#34; Сейчас 2026 год — нужно обновить.\nРекомендация Обновить на 2020-2026. Или сделать динамическим через Hugo template:\nCopyright (c) 2020-{{ now.Year }} Антон Агальцов ","section":"personal-site","tags":["audit","personal-site"],"title":"Copyright без 2026 года","url":"/personal-site/copyright-outdated/"},{"content":"Проблема Последний дайджест — февраль 2025. С тех пор 12+ месяцев без новых выпусков.\nЧто есть 27 файлов дайджестов (январь 2023 — февраль 2025) Автоматизация через digest.js — скрипт для генерации Но скрипт не запускается автоматически Риск Low — контент устаревает, SEO-позиции падают для страниц дайджестов.\nРекомендация Настроить cron/CI для ежемесячной генерации дайджеста Или интегрировать с OpenClaw — авто-сборка дайджеста на основе новых публикаций ","section":"personal-site","tags":["audit","personal-site"],"title":"Digest не обновлялся с февраля 2025","url":"/personal-site/digest-stale/"},{"content":"Проблема Проект использует тему Hyas/Doks v0.5.0 (package.json). Актуальная версия Doks — 1.x с полной переработкой архитектуры.\nЧто не так Doks 0.5 использует устаревший Bootstrap 5.2.0-beta1 Hugo 0.148.2 в зависимостях — новый, но интеграция с темой старая Конфигурация через theme.toml — в новых версиях перешли на другой формат exec-bin для вызова Hugo — устаревший подход, текущие версии Hugo ставятся глобально Риск Medium — работает, но миграция на Doks 1.x потребует значительного рефакторинга layout-ов и конфигурации. Чем дольше откладывать — тем сложнее.\nРекомендация Запланировать миграцию на Doks 1.x или перейти на чистый Hugo + Bootstrap без зависимости от темы-фреймворка.\n","section":"personal-site","tags":["audit","personal-site"],"title":"Hugo Doks 0.5 — сильно устарел","url":"/personal-site/outdated-doks-theme/"},{"content":"Проблема В params.toml указан Twitter: @AntonTotoshkin\nНо владелец сайта — Антон Агальцов. Ники не совпадают.\nДва варианта Это твой старый/другой аккаунт — тогда ок, но стоит указать актуальный Это чужой аккаунт — тогда нужно убрать или исправить Затронутые места twitterSite = \u0026quot;@AntonTotoshkin\u0026quot; schemaAuthorTwitter = \u0026quot;https://twitter.com/AntonTotoshkin\u0026quot; schemaTwitter = \u0026quot;https://twitter.com/AntonTotoshkin\u0026quot; Рекомендация Указать актуальный Twitter/X или убрать, если соцсеть не используется.\n","section":"personal-site","tags":["audit","personal-site"],"title":"Twitter handle не соответствует имени","url":"/personal-site/twitter-handle-mismatch/"},{"content":"Проблема В params.toml: yandexMetrika = false\nАналитика с сайта не собирается. Непонятно, есть ли вообще посетители и какие страницы популярны.\nРекомендация Включить Yandex Metrika или перейти на Plausible / Umami (privacy-friendly) Если сайт не нуждается в аналитике — оставить как есть Альтернатива: Netlify Analytics (уже встроен в хостинг) ","section":"personal-site","tags":["audit","personal-site"],"title":"Yandex Metrika отключена","url":"/personal-site/no-analytics/"},{"content":"Проблема В корне репозитория лежат два файла, которые не должны быть в git:\nШаблоны для сайта.key — Apple Keynote файл (бинарный) logo.psd — Photoshop файл (бинарный) Что не так Увеличивают размер репозитория Git неэффективно хранит бинарные файлы (каждая версия — полностью) .key файлы могут содержать конфиденциальные данные шаблонов Рекомендация Перенести в отдельное хранилище (Google Drive, облако) Удалить из git-истории через git filter-repo Добавить в .gitignore: *.key, *.psd, *.sketch ","section":"personal-site","tags":["audit","personal-site"],"title":"Бинарный файл в репозитории","url":"/personal-site/binary-files-in-repo/"},{"content":"Проблема node_modules/ отсутствует — проект нельзя собрать без npm install.\nРиск Low — стандартная ситуация. Но:\npackage-lock.json привязан к Node 16, а на Mac Studio текущий Node v24 Могут быть конфликты зависимостей (canvas, babel, postcss) Hugo 0.148.2 ставится через hugo-installer в npm — может не совпасть с глобальным Hugo Рекомендация Убедиться что npm install проходит без ошибок на текущем Node Если нет — обновить зависимости или использовать nvm для Node 16 Рассмотреть переход на глобальный Hugo вместо exec-bin ","section":"personal-site","tags":["audit","personal-site"],"title":"Отсутствуют node_modules — нужна установка","url":"/personal-site/no-node-modules/"},{"content":"Устаревший Node.js 16 в Netlify Файл: netlify.toml:5\nNODE_VERSION = \u0026#34;16.16.0\u0026#34; Node.js 16 вышел из поддержки (EOL) в сентябре 2023. Сборка на Netlify может начать падать или работать некорректно.\nРекомендация: Обновить до Node.js 20 LTS:\nNODE_VERSION = \u0026#34;20\u0026#34; ","section":"personal-site","tags":["audit","personal-site","infrastructure"],"title":"Устаревший Node.js 16 в Netlify","url":"/personal-site/netlify-node-version/"},{"content":"Timeline Утро — Установлен Vikunja (таск-трекер) на Mac Studio через Docker/Colima День — Создан проект «Leadera» в Vikunja (ID=2), добавлено 27 задач из аудита Leadera День — Начата реализация Leadera TaskTracker: миграции, модели, DTOs, repositories (бекенд), фронтенд (kanban, task-detail) Вечер — TaskTracker откачён по просьбе Антона — git checkout + git clean. Причина: Claude Code падал (SIGKILL), sub-agents не справлялись, Plane не запустился Вечер — Настроен MT Proxy на VPN VPS (185.234.64.52): порт 8443, секрет 9e40ae… Вечер — Qwen 3.5:9b подключён к OpenClaw через openclaw models set ollama/qwen3.5:9b, доступен для cron/spawn задач Вечер — Антон подключился к claw.a2v.space с мобильного, устройство одобрено Vikunja URL: http://192.168.0.37:8095 Проект Leadera: ID=2 API token: tk_635fb7ac… 27 задач из аудита, приоритеты P0–P3 Leadera TaskTracker ТЗ: leadera-tasktracker-spec.md Реализация через sub-agents (GLM-5.1) Откачено — проекты возвращены к предыдущему коммиту MT Proxy Сервер: 185.234.64.52, порт 8443 Docker контейнер: mtproxy Инфраструктура Qwen 3.5:9b доступен как дешёвая локальная модель для cron/spawn Мобильное подключение к claw.a2v.space подтверждено ","section":"diary","tags":["vikunja","leadera","tasktracker","ollama","qwen","mtproxy","infrastructure"],"title":"30 марта 2026","url":"/diary/2026-03-30/"},{"content":"Timeline 20:03 — Настроили Angular + Go проекты (leadera) через pm2, удалили proxy.conf, подняли PostgreSQL в Docker 20:31 — Изучили API Eversolo T8 — полный список REST-эндпоинтов для управления музыкой 20:49 — Обсудили важность записи контекста в файлы для сохранения памяти между сессиями 21:13 — Начали проект docs.a2v.space — персональная документация на Hugo 21:44 — Завершили настройку Identity (Братан, SOUL.md, USER.md, IDENTITY.md) 22:15 — Документировали инфраструктуру: VPS reverse proxy (claw.a2v.space, code.a2v.space, sand.a2v.space, docs.a2v.space) 22:31 — Настроили docs.a2v.space: Hugo сайт, 83 страницы, Bootstrap 5 тёмная тема, AES-256-GCM шифрование кредов (мастер-пароль: Popoloka16!) 22:47 — Добавили Basic auth: agaltsovav / Magamet787! для доступа к документации 23:02 — Создали cron задачу docs-a2v-daily-sync на ежедневное обновление в 03:00 МСК 23:18 — Полностью задокументировали Eversolo T8 API (воспроизведение, громкость, дисплей, питание, поиск и т.д.) 23:45 — Переписали TOOLS.md как полный справочник по инфраструктуре Eversolo Companion — статус проекта Backend (Go + Gin):\nРепозиторий: ~/Projects/eversolo-companion Состояние: собран, 17+ REST API эндпоинтов, WebSocket, CORS, state poller Frontend (Angular 17):\nСостояние: собран, тёмная тема (Spotify-like), 5 экранов, 5 сервисов Dev server: pm2 (eversolo-fe), порт 8096 Инфраструктура:\nPostgreSQL: Docker, порт 5433, миграции готовы Docker Compose: рабочий (postgres + api + frontend) Проблема: нет доступа к Eversolo из OpenClaw sandbox (192.168.0.156)\nРешение: настройка tools.elevated.allowFrom.webchat или запуск через launchd Следующие шаги: после решения сети — этапы 3-9 (библиотека sync, плейлисты, scrobbler, обложки)\n","section":"diary","tags":["angular","go","docker","eversolo","hugo","docs","identity","infrastructure","companion"],"title":"29 марта 2026","url":"/diary/2026-03-29/"},{"content":"Basic Authentication Username: agaltsovav Password: Magamet787! Конфигурация Nginx server { listen 8091; server_name docs.a2v.space; auth_basic \u0026#34;Restricted Access\u0026#34;; auth_basic_user_file /etc/nginx/.htpasswd; } Доступ URL: https://docs.a2v.space (через reverse proxy) Local: http://localhost:8091 (для разработки) Auth: всегда требуется Мастер-пароль для шифрования Важно: Пароль для расшифровки файлов в разделе creds/\nMaster Password: Popoloka16! Шифрование Алгоритм: AES-256-GCM Хранилище: client-side encryption Файлы шифруются при сохранении Расшифровываются при чтении ","section":"creds","tags":["docs","authentication","nginx"],"title":"docs.a2v.space Basic Auth","url":"/creds/docs-a2v-space-auth/"},{"content":"Docker Compose креды (~/Projects/eversolo-companion/docker-compose.yml) services: postgres: environment: POSTGRES_USER: postgres POSTGRES_PASSWORD: password POSTGRES_DB: eversolo Локальные креды (.env файл) POSTGRES_USER=postgres POSTGRES_PASSWORD=password POSTGRES_DB=eversolo Хостинг Host: localhost Port: 5433 Database: eversolo Безопасность Используйте разные пароли для production Включите SSL для удаленного подключения Регулярно делайте бэкапы ","section":"creds","tags":["eversolo","companion","postgresql","docker"],"title":"Eversolo Companion PostgreSQL","url":"/creds/eversolo-companion-postgres/"},{"content":"Eversolo T8 — музыкальный стример.\nIP: 192.168.0.156 Порт: 9529 Авторизация: нет\nБазовый URL: http://192.168.0.156:9529\nВоспроизведение Действие URL Play/Pause /ZidooMusicControl/v2/playOrPause Следующий трек /ZidooMusicControl/v2/playNext Предыдущий трек /ZidooMusicControl/v2/playLast Перемотка (ms) /ZidooMusicControl/v2/seekTo?time=\u0026lt;ms\u0026gt; Воспроизвести по ID /ZidooMusicControl/v2/playMusic?type=4\u0026amp;id=\u0026lt;id\u0026gt; Состояние /ZidooMusicControl/v2/getState Громкость Действие URL Громкость вверх /ZidooControlCenter/RemoteControl/sendkey?key=Key.VolumeUp Громкость вниз /ZidooControlCenter/RemoteControl/sendkey?key=Key.VolumeDown Точная громкость /ZidooMusicControl/v2/setDevicesVolume?volume=\u0026lt;0-200\u0026gt; Mute /ZidooMusicControl/v2/setMuteVolume?isMute=1 Unmute /ZidooMusicControl/v2/setMuteVolume?isMute=0 Входы/Выходы Действие URL Получить список /ZidooMusicControl/v2/getInputAndOutputList Установить вход /ZidooMusicControl/v2/setInputList?tag=\u0026lt;tag\u0026gt;\u0026amp;index=\u0026lt;n\u0026gt; Установить выход /ZidooMusicControl/v2/setOutInputList?tag=\u0026lt;tag\u0026gt;\u0026amp;index=\u0026lt;n\u0026gt; Теги выхода: RCA, XLRRCA, XLR, HDMI, SPDIF, USB\nДисплей Действие URL Яркость экрана (get) /SystemSettings/displaySettings/getScreenBrightness Яркость экрана (set) /SystemSettings/displaySettings/setScreenBrightness?index=\u0026lt;0-115\u0026gt; Яркость ручки (get) /SystemSettings/displaySettings/getKnobBrightness Яркость ручки (set) /SystemSettings/displaySettings/setKnobBrightness?index=\u0026lt;0-255\u0026gt; VU-режим (get) /SystemSettings/displaySettings/getVUModeList VU-режим (set) /SystemSettings/displaySettings/setVUMode?index=\u0026lt;n\u0026gt; Спектр (get) /SystemSettings/displaySettings/getSpPlayModeList Спектр (set) /SystemSettings/displaySettings/setSpPlayModeList?index=\u0026lt;n\u0026gt; Переключить VU/Спектр `/ZidooMusicControl/v2/changVUDisplay?openType=\u0026lt;0 Питание Действие URL Параметры питания /ZidooMusicControl/v2/getPowerOption Перезагрузка /ZidooMusicControl/v2/setPowerOption?tag=reboot Выключение /ZidooMusicControl/v2/setPowerOption?tag=poweroff Переключить экран /ZidooMusicControl/v2/setPowerOption?tag=screen Включить экран /ZidooControlCenter/RemoteControl/sendkey?key=Key.Screen.ON Выключить экран /ZidooControlCenter/RemoteControl/sendkey?key=Key.Screen.OFF Поиск Поиск URL По трекам /ZidooMusicControl/v2/searchMusicV2?key=\u0026lt;text\u0026gt;\u0026amp;start=0\u0026amp;count=100 По артистам /ZidooMusicControl/v2/searchArtistV2?key=\u0026lt;text\u0026gt;\u0026amp;start=0\u0026amp;count=100 По альбомам /ZidooMusicControl/v2/searchAlbumV2?key=\u0026lt;text\u0026gt;\u0026amp;start=0\u0026amp;count=100 Обложки и устройство Действие URL Обложка по ID /ZidooMusicControl/v2/getImage?id=\u0026lt;song_id\u0026gt;\u0026amp;target=16 Модель устройства /ControlCenter/getModel Источники Zidoo Forum Home Assistant Integration ","section":"kb","tags":["api","eversolo","music","streamer"],"title":"Eversolo T8 API","url":"/kb/eversolo-api/"},{"content":"\nNYVK4PEGwmOHmAnGk8IAUc+lyFJtnEAvX6ZddBro/ILRWHOXBGYywgglFvQZ18BLDLb5DuA8GPAIdB/LwTHRXYO0KsmtlZQVWGEeeXlXAoEXpa5theoOQhebkW6LmiKyNGAVW2z9rK3nz6NnztYdn49LvGMjrHuR4IwCLbl/pYa96CPNRnxGDFlduFi8lMSspM0rBFi/bZhNGhzy36ViCl+aKr5P9cle0ZvM8E8av/6c5JjgDt88QFI3VYdTaTCE0+uHsXlnJN7Qgg/KH7kD\n\n\n","section":"creds","tags":["postgresql","docker-compose","leadera","database"],"title":"Mac Studio — leadera-api БД (docker-compose)","url":"/creds/leadera-db-docker/"},{"content":"\np7Iw7Y3zbj1kLBcbOXGoO27oDwF85AhxBW7saT538hxi0ogJpyFeM49GDuLHzxuyknvdNC/rx3tb4AFnGkCeHSrrCmj+VK8Zxt7ujeujVJSRuOeeUlsqkHdlmaiXl2KQknrIsqVCi3Tnn0V5qcFxvo+1Ktc+surF6bBpWrTHzWV5mLtWVfD6C6kvvP/UFldFBD6v+FQs79yfoOe/j/bUrtpt6v5VndbbBmhUAQcy1BV2rpXxO373dTcLQ6coRWkt/RFo\n\n\n","section":"creds","tags":["postgresql","docker","leadera","database"],"title":"Mac Studio — leadera-api БД (локальная)","url":"/creds/leadera-db-local/"},{"content":"Настройка SSH туннелей VPS reg.ru (95.163.232.9) # На Mac Studio: создать туннель для каждого сервиса ssh -N -R 8080:localhost:8080 root@95.163.232.9 # leadera-api ssh -N -R 8081:localhost:4096 root@95.163.232.9 # opencode ssh -N -R 8082:localhost:4200 root@95.163.232.9 # leadera-fe ssh -N -R 8083:localhost:8080 root@95.163.232.9 # docs-a2v Настройка launchd plist Файл: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\n\u0026lt;?xml version=\u0026#34;1.0\u0026#34; encoding=\u0026#34;UTF-8\u0026#34;?\u0026gt; \u0026lt;!DOCTYPE plist PUBLIC \u0026#34;-//Apple//DTD PLIST 1.0//EN\u0026#34; \u0026#34;http://www.apple.com/DTDs/PropertyList-1.0.dtd\u0026#34;\u0026gt; \u0026lt;plist version=\u0026#34;1.0\u0026#34;\u0026gt; \u0026lt;dict\u0026gt; \u0026lt;key\u0026gt;Label\u0026lt;/key\u0026gt; \u0026lt;string\u0026gt;com.openclaw.sshtunnel\u0026lt;/string\u0026gt; \u0026lt;key\u0026gt;ProgramArguments\u0026lt;/key\u0026gt; \u0026lt;array\u0026gt; \u0026lt;string\u0026gt;ssh\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-N\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8080:localhost:8080\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;root@95.163.232.9\u0026lt;/string\u0026gt; \u0026lt;/array\u0026gt; \u0026lt;key\u0026gt;RunAtLoad\u0026lt;/key\u0026gt; \u0026lt;true/\u0026gt; \u0026lt;key\u0026gt;KeepAlive\u0026lt;/key\u0026gt; \u0026lt;true/\u0026gt; \u0026lt;/dict\u0026gt; \u0026lt;/plist\u0026gt; Автозапуск # Загрузить plist launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist # Проверить статус launchctl list | grep sshtunnel # Удалить (при необходимости) launchctl unload ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist Доступ к сервисам Через reverse proxy на VPS:\ncode.a2v.space: порт 8080 → Mac Studio:4096 claw.a2v.space: порт 8081 → Mac Studio:8080 (leadera-api) sand.a2v.space: порт 8082 → Mac Studio:4200 (leadera-fe) docs.a2v.space: порт 8083 → Mac Studio:8080 (docs-a2v) SSL Все сервисы используют Let\u0026rsquo;s Encrypt сертификаты:\nПуть: /etc/letsencrypt/live/{claw,code,sand}.a2v.space/ Автопродление через certbot ","section":"guides","tags":["ssh","tunnel","vps","reverse-proxy"],"title":"SSH туннели для VPS reverse proxy","url":"/guides/ssh-tunnels-vps/"},{"content":"\nYEI16NAJ78d3lmSa/lca8Zxczt+u6GyMUYHduX47VoFQdj0Ixozd8R6yXoB7eM+AjhCtNGkOxGlOj2s73ABOBjLEIVIhD4Z+xTyzdtah4VpyLoltYOeNYsnbIIFARdF/FBYq5COXohhXs33K5ozznrtDd/awbKMjl/sbQqjXAZ+A3ZSob6/5uU+fFKetXLR6v4ZLAYQ57iiD21ImSLSggwv+rJgK5XyPDKEPD4N5nOsiDrLgoukVBMvgJ54PqfPp2Hni+2tdKOlMnOG2npTuu4SkyALcfFar\n\n\n","section":"creds","tags":["vpn","amnezia","infrastructure"],"title":"VPN VPS","url":"/creds/vpn-vps/"},{"content":"\nIpYXLMtgCFlGQ550DZCLjq37VsnNqL08Rn03iRS7kQ7ozBZNsiZySFzDAvYh4xIHytRDy0Sz0KGUXekr0S+cNiJsmtZ8kj0Pd0JhevhxTMZF2khFvs/LFWoTL5ZwAJ34y/qfLw2gaWX90VZDu0wO+KeAQeXhrWmol/2zUlfWX1AihyYqD2vRz+h2FcjD8ubYOXG35PyX7OlV1HPXgDv5X/bFNrxzPc867UOwB4aGxY9a\n\n\n","section":"creds","tags":["vps","reg.ru","infrastructure"],"title":"VPS reg.ru","url":"/creds/vps-reg-ru/"},{"content":"Описание Завершить разработку Eversolo Companion после решения проблемы с сетевым доступом.\nЧто сделано Backend (Go + Gin): собран, 17+ REST API эндпоинтов, WebSocket, CORS, state poller Frontend (Angular 17): собран, тёмная тема (Spotify-like), 5 экранов, 5 сервисов PostgreSQL: Docker, порт 5433, миграции готовы Docker Compose: рабочий (postgres + api + frontend) Спецификация: полная в ~/Projects/eversolo-companion/SPEC.md Проблема API не может достучаться до Eversolo T8 (192.168.0.156:9529) из-за ограничений OpenClaw sandbox.\nВозможные решения Настроить tools.elevated.allowFrom.webchat для разрешения сетевых соединений Запустить API через launchd plist (как SSH туннели) Использовать отдельный контейнер без ограничений Этапы 3-9 (после решения сети) Библиотека синхронизации — двухсторонний sync с Eversolo Плейлисты — импорт/экспорт, редактирование Scrobbler — Last.fm / ListenBrainz Обложки — кэширование, отображение в UI Плеер — улучшенный интерфейс управления Система уведомлений — события от Eversolo Администрирование — настройка подключений Связанные ресурсы Спецификация проекта API документация Дневник разработки ","section":"plans","tags":["eversolo","companion","angular","go","docker"],"title":"Завершить Eversolo Companion - этапы 3-9","url":"/plans/eversolo-companion-phases-3-9/"},{"content":"Описание Добавить поддержку Ollama в OpenClaw для использования локальных LLM моделей.\nПроблема Модель qwen3.5:9b добавлена в конфиг openclaw.json, но не отображается в openclaw models list.\nСтатус Отложено по решению Антона.\n","section":"plans","tags":["ollama","openclaw","llm"],"title":"Настроить интеграцию Ollama с OpenClaw","url":"/plans/ollama-openclaw/"},{"content":"Общая схема Mac Studio (локальная сеть) → autossh (SSH-туннели) → VPS 95.163.232.9 (Debian) → nginx (HTTPS reverse proxy) → интернет Что нужно на VPS 1. Установленные пакеты apt update apt install nginx certbot python3-certbot-nginx 2. SSH-доступ Авторизация только по ключам Публичный ключ с Mac Studio добавлен в /root/.ssh/authorized_keys 3. nginx Для каждого домена создать server block:\nHTTP → редирект на HTTPS HTTPS с SSL-сертификатом Let\u0026rsquo;s Encrypt proxy_pass на localhost-порт туннеля Пример структуры:\n/etc/nginx/sites-available/ claw.a2v.space.conf code.a2v.space.conf sand.a2v.space.conf 4. SSL-сертификаты certbot certonly --nginx -d \u0026lt;domain\u0026gt; certbot renew --dry-run # проверить автообновление Что нужно на Mac Studio autossh через launchd Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\nОдин plist с несколькими -R флагами:\n\u0026lt;key\u0026gt;ProgramArguments\u0026lt;/key\u0026gt; \u0026lt;array\u0026gt; \u0026lt;string\u0026gt;/usr/local/bin/autossh\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-M\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;0\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8080:localhost:18789\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8081:localhost:4096\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8082:localhost:4200\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-R\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;8083:localhost:8080\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;root@95.163.232.9\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-N\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;-i\u0026lt;/string\u0026gt; \u0026lt;string\u0026gt;/Users/\u0026lt;user\u0026gt;/.ssh/id_rsa\u0026lt;/string\u0026gt; \u0026lt;/array\u0026gt; Управление launchd launchctl load ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist launchctl start com.openclaw.sshtunnel launchctl stop com.openclaw.sshtunnel Проверка # На VPS ss -tlnp | grep -E \u0026#39;808[0-3]\u0026#39; # Снаружи curl -I https://claw.a2v.space curl -I https://code.a2v.space curl -I https://sand.a2v.space ","section":"guides","tags":["vps","nginx","ssh","reverse-proxy","devops"],"title":"Настройка VPS как реверс-прокси","url":"/guides/vps-reverse-proxy/"},{"content":"Архитектура Mac Studio (192.168.0.37:18789) → autossh SSH-туннель → VPS 95.163.232.9:8080 → nginx HTTPS → https://claw.a2v.space Шаги настройки 1. DNS A-запись claw.a2v.space → 95.163.232.9\nNS-серверы: ns1.hosting.reg.ru, ns2.hosting.reg.ru\n2. Mac Studio — OpenClaw Порт: 18789 Конфиг: ~/.openclaw/openclaw.json 3. SSH-туннель (launchd) Plist: ~/Library/LaunchAgents/com.openclaw.sshtunnel.plist\nКлючевой флаг: -R 8080:localhost:18789\n4. VPS — nginx конфиг server { listen 80; server_name claw.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name claw.a2v.space; ssl_certificate /etc/letsencrypt/live/claw.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/claw.a2v.space/privkey.pem; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } 5. SSL-сертификат certbot certonly --nginx -d claw.a2v.space 6. OpenClaw config { \u0026#34;allowedOrigins\u0026#34;: [\u0026#34;https://claw.a2v.space\u0026#34;], \u0026#34;trustedProxies\u0026#34;: [\u0026#34;127.0.0.1\u0026#34;] } ","section":"guides","tags":["openclaw","ssh","nginx","vps","reverse-proxy"],"title":"Подключение claw.a2v.space (OpenClaw)","url":"/guides/claw-a2v-space/"},{"content":"Архитектура Mac Studio (localhost:4096) → autossh SSH-туннель (-R 8081:localhost:4096) → VPS 95.163.232.9:8081 → nginx HTTPS → https://code.a2v.space Параметры Параметр Значение Локальный порт 4096 Туннель порт 8081 pm2 процесс opencode SSL сертификат /etc/letsencrypt/live/code.a2v.space/ nginx конфиг server { listen 80; server_name code.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name code.a2v.space; ssl_certificate /etc/letsencrypt/live/code.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/code.a2v.space/privkey.pem; location / { proxy_pass http://127.0.0.1:8081; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \u0026#34;upgrade\u0026#34;; } } SSL-сертификат certbot certonly --nginx -d code.a2v.space ","section":"guides","tags":["opencode","ssh","nginx","vps","reverse-proxy"],"title":"Подключение code.a2v.space (OpenCode)","url":"/guides/code-a2v-space/"},{"content":"Архитектура Mac Studio ├─ Frontend (Angular) :4200 (pm2: leadera-fe) ├─ Backend (Go) :8080 (pm2: leadera-api) └─ PostgreSQL 16 в Docker (Colima, container: app-leadera-db) → autossh SSH-туннель (-R 8082:localhost:4200 -R 8083:localhost:8080) → VPS 95.163.232.9 → nginx HTTPS → https://sand.a2v.space Параметры Компонент Локальный порт Туннель порт pm2 имя Frontend (Angular) 4200 8082 leadera-fe Backend (Go) 8080 8083 leadera-api SSL сертификат: /etc/letsencrypt/live/sand.a2v.space/\nnginx конфиг server { listen 80; server_name sand.a2v.space; return 301 https://$server_name$request_uri; } server { listen 443 ssl; server_name sand.a2v.space; ssl_certificate /etc/letsencrypt/live/sand.a2v.space/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/sand.a2v.space/privkey.pem; location /api { proxy_pass http://127.0.0.1:8083; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } location / { proxy_pass http://127.0.0.1:8082; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } База данных PostgreSQL 16 в Docker через Colima:\nContainer: app-leadera-db Port: 5432 SSL-сертификат certbot certonly --nginx -d sand.a2v.space ","section":"guides","tags":["angular","go","docker","nginx","vps","reverse-proxy"],"title":"Подключение sand.a2v.space (Leadera Project)","url":"/guides/sand-a2v-space/"},{"content":"Описание Добавить инструменты управления Eversolo T8 в OpenClaw.\nЧто сделано Изучен полный API Eversolo T8 (см. Базу знаний) Проблема Sandbox OpenClaw не имеет доступа к локальной сети, где находится Eversolo.\nВозможные решения Настроить проброс портов Запустить OpenClaw без sandbox-ограничений Использовать промежуточный proxy-сервис ","section":"plans","tags":["eversolo","openclaw","api"],"title":"Реализовать управление Eversolo из OpenClaw","url":"/plans/eversolo-control/"}] \ No newline at end of file diff --git a/public/kb/eversolo-api/index.html b/public/kb/eversolo-api/index.html index 2662921..bc9599f 100644 --- a/public/kb/eversolo-api/index.html +++ b/public/kb/eversolo-api/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -127,6 +131,15 @@

                    Eversolo T8 API

                    +
                    + + 📁 ~/Projects/docs-a2v/content/kb/eversolo-api.md + + +
                    +
                    diff --git a/public/kb/index.html b/public/kb/index.html index 74bfec8..c3ca3d5 100644 --- a/public/kb/index.html +++ b/public/kb/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • diff --git a/public/leadera/index.html b/public/leadera/index.html new file mode 100644 index 0000000..6cbfd8f --- /dev/null +++ b/public/leadera/index.html @@ -0,0 +1,536 @@ + + + + + + Leadera — docs.a2v.space + + + + + + + + + + +
                    + + + + +
                    + + +
                    +
                    + + + + +
                    + +
                    +

                    Leadera

                    + +

                    Leadera

                    +

                    SaaS-система управления IT-ландшафтом с диаграммами Ганта.

                    + + + +
                    + +
                    +
                    +
                    +

                    Leadera — Публичный доступ к диаграмме Ганта

                    +

                    Публичный доступ к диаграмме Ганта (Share)

                    +

                    Дата: 09.04.2026 +Статус: Требования +Проект: Leadera

                    +
                    +

                    Общее описание

                    +

                    Пользователь может создать публичную ссылку на фрагмент диаграммы Ганта, доступную для просмотра без авторизации. Открывший ссылку видит диаграмму в read-only режиме с возможностью масштабирования таймлайна, но без каких-либо элементов управления (создание, редактирование, удаление задач/секций/вех).

                    +
                    +

                    Пользовательский сценарий (создатель ссылки)

                    +
                      +
                    1. Пользователь открывает диаграмму Ганта проекта
                      2. +
                    2. Нажимает кнопку «Экспорт» / «Общий доступ»
                      3. +
                    3. Указывает диапазон дат, который должен отображаться на диаграмме
                      4. +
                    4. Система генерирует уникальную ссылку (UUID) и показывает её пользователю
                      5. +
                    5. Пользователь копирует ссылку и передаёт заинтересованным лицам
                      6. +
                    +

                    Управление ссылками

                    +
                      +
                    • Вызывается через меню экспорта → модальное окно «Общий доступ»
                      • +
                    • В модальном окне отображается список созданных ссылок с указанием диапазона дат
                      • +
                    • Каждую ссылку можно удалить (полное удаление из БД, не soft delete)
                      • +
                    • Ссылки нельзя редактировать — только создавать и удалять
                      • +
                    • Ограничений на количество активных ссылок нет
                      • +
                    • Статистика просмотров (сколько раз открывали) — не нужна
                      • +
                    +
                    +

                    Пользовательский сценарий (зритель по ссылке)

                    +
                      +
                    1. Зритель переходит по ссылке (без авторизации)
                      2. +
                    2. Открывается отдельная страница с диаграммой Ганта
                      3. +
                    3. Зритель видит: +
                        +
                      • Задачи и вехи, попадающие в заданный диапазон
                        • +
                      • Секции (заголовки группировок)
                        • +
                      • Таймлайн с цветовой раскраской задач
                        • +
                      +
                      4. +
                    4. Зритель может: +
                        +
                      • Масштабировать таймлайн
                        • +
                      • Переключать отображение «по ячейкам» / «по дням»
                        • +
                      +
                      5. +
                    5. Зритель не может: +
                        +
                      • Создавать, редактировать, удалять задачи / секции / вехи
                        • +
                      • Видеть любые контролы управления (кнопки создания, контекстные меню, drag-and-drop и т.д.)
                        • +
                      • Авторизоваться через эту страницу
                        • +
                      +
                      6. +
                    +
                    +

                    Данные и фильтрация

                    +

                    Что попадает в представление

                    +

                    Задачи и вехи, у которых хотя бы одно из условий верно:

                    + +
                    + + leadera + + gantt + + public-access + + sharing + +
                    + +
                    +
                    +
                    + +
                    +
                    +
                    +

                    Leadera — Экспорт диаграммы Ганта в Excel

                    +

                    Экспорт диаграммы Ганта в Excel

                    +

                    Дата: 09.04.2026 +Статус: Требования +Проект: Leadera

                    +
                    +

                    Общее описание

                    +

                    Пользователь нажимает кнопку экспорта в интерфейсе диаграммы Ганта. Система запрашивает диапазон дат выгрузки (по умолчанию — текущий видимый диапазон из интерфейса). После указания диапазона скачивается Excel-файл с визуальным представлением диаграммы Ганта.

                    +
                    +

                    Вводные данные

                    +
                      +
                    • Источник: текущая диаграмма Ганта проекта (один проект = одна диаграмма)
                      • +
                    • Диапазон дат: пользователь указывает начальную и конечную дату. По умолчанию подставляется видимый в момент запроса диапазон из интерфейса
                      • +
                    • Масштаб таймлайна: берётся тот, который выбран пользователем в интерфейсе в момент запроса (не сохранённый в системе, а текущий). Варианты: по ячейкам или по дням
                      • +
                    +
                    +

                    Структура Excel-файла

                    +

                    Шапка (первые строки)

                    +
                      +
                    • Название диаграммы (название проекта)
                      • +
                    • Диапазон дат, в рамках которого сделана выгрузка
                      • +
                    +

                    Лист — один

                    +

                    Вся диаграмма размещается на одном листе.

                    + +
                    + + leadera + + gantt + + excel + + export + +
                    + +
                    +
                    +
                    + +
                    +
                    +
                    +

                    Leadera: Вехи (Milestones) на диаграмме Ганта

                    +

                    Бизнес-требования

                    +

                    BR-1: Сущность «Веха» (Milestone)

                    +

                    Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.

                    +

                    Поля вехи:

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ПолеТипОписание
                    idUUIDИдентификатор
                    gantt_chart_idUUIDПринадлежность к диаграмме (не к секции!)
                    titlestringНазвание вехи (обязательное, 1–255 символов)
                    datedateДата вехи (без времени, обязательная)
                    colorstringЦвет маркера (HEX, по умолчанию #dc3545 — красный)
                    created_byUUIDКто создал (не отображается в UI, хранится для аудита)
                    updated_byUUIDКто обновил (не отображается в UI)
                    created_attimestampДата создания
                    updated_attimestampДата обновления
                    deleted_attimestampSoft delete
                    +

                    Права доступа: Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).

                    + +
                    + + leadera + + gantt + + angular + + go + + api + + ux + +
                    + +
                    +
                    +
                    + +
                    +
                    +
                    +

                    Leadera — Фильтры и реорганизация списка диаграмм Ганта

                    +

                    Фильтры и реорганизация списка диаграмм Ганта

                    +

                    Дата: 07.04.2026 +Статус: Требования +Проект: Leadera (dev — sand.a2v.space)

                    +
                    +

                    1. Постановка задачи

                    +

                    Список диаграмм Ганта должен показывать все доступные пользователю диаграммы из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.

                    +
                    +

                    2. Изменения API

                    +

                    2.1. Новый endpoint списка диаграмм

                    +

                    Было:

                    +
                    GET /api/v1/spaces/{spaceId}/gantt-charts?page=1&per_page=10
+

                    Стало:

                    +
                    GET /api/v1/gantt-charts?page=1&per_page=10
+

                    Пользователь видит все диаграммы из всех пространств, где он является подтверждённым участником (статус accepted).

                    + +
                    + + leadera + + gantt + + api + + frontend + + requirements + +
                    + +
                    +
                    +
                    + +
                    +
                    +
                    +

                    Leadera — WebSocket для диаграмм Ганта

                    +

                    WebSocket для диаграмм Ганта — realtime-совместное редактирование

                    +

                    Дата: 07.04.2026 +Статус: Планирование +Проект: Leadera (dev — sand.a2v.space)

                    +
                    +

                    1. Постановка задачи

                    +

                    Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.

                    +
                    +

                    2. Архитектура

                    +
                    Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL
+       │                                │
+       │  HTTP (мутации)                │  Broadcast
+       └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты
+

                    Ключевой принцип: мутации данных идут через HTTP (REST), WebSocket используется только для доставки уведомлений. Сервер — источник истины, клиент не может обойти проверки через WS.

                    + +
                    + + leadera + + websocket + + realtime + + gantt + + architecture + +
                    + +
                    +
                    +
                    + +
                    +
                    +
                    +

                    Leadera: Ограничения секций в диаграмме Ганта

                    +

                    Бизнес-требования

                    +

                    BR-1: Лимит одновременных задач (Concurrency Limit)

                    +

                    У каждой секции появляется параметр max_concurrent_tasks (целое число ≥ 0, по умолчанию 0).

                    +

                    Поведение:

                    +
                      +
                    • Если max_concurrent_tasks = 3 — в любой данный день в этой секции не может быть больше 3 активных задач одновременно
                      • +
                    • Если max_concurrent_tasks = 0 — ограничение отключено, лимита нет
                      • +
                    • Пересечение считается по дате: задача занимает дни с start_date по end_date включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день
                      • +
                    • Ограничение работает только в рамках одной секции. Задачи из разных секций не влияют друг на друга
                      • +
                    +

                    Срабатывание при:

                    + +
                    + + leadera + + gantt + + angular + + go + + api + + ux + +
                    + +
                    +
                    +
                    + +
                    +
                    +
                    +

                    Аудит Leadera — полный отчёт

                    +

                    Аудит проекта Leadera

                    +

                    Дата: 30.03.2026
                    +Версия: pre-production, миграции 1–5

                    +
                    +

                    1. Обзор проекта

                    +

                    Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.

                    +

                    Стек

                    + + + + + + + + + + + + + + + + + + + + + +
                    КомпонентТехнологии
                    BackendGo 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256)
                    FrontendAngular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals
                    ИнфраструктураDocker (Colima), pm2, nginx reverse proxy, VPS reg.ru
                    +

                    Доменная модель

                    +
                    User ──┬── Space (через space_members с role)
+        │
+        └── GanttChart (принадлежит Space)
+              ├── GanttSection
+              └── GanttTask
+

                    Роли: admin, editor, viewer — назначаются на уровне Space через таблицу space_members.

                    + +
                    + + audit + + leadera + + security + + architecture + +
                    + +
                    +
                    +
                    + +
                    +
                    + +
                    +
                    +
                    + +
                    +
                    +

                    © 2026 docs.a2v.space

                    +
                    +
                    + + + + + + + + + + + + + + + diff --git a/public/leadera/index.json b/public/leadera/index.json new file mode 100644 index 0000000..1e1572a --- /dev/null +++ b/public/leadera/index.json @@ -0,0 +1 @@ +[{"content":"Аудит проекта Leadera Дата: 30.03.2026\nВерсия: pre-production, миграции 1–5\n1. Обзор проекта Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.\nСтек Компонент Технологии Backend Go 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256) Frontend Angular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals Инфраструктура Docker (Colima), pm2, nginx reverse proxy, VPS reg.ru Доменная модель User ──┬── Space (через space_members с role) │ └── GanttChart (принадлежит Space) ├── GanttSection └── GanttTask Роли: admin, editor, viewer — назначаются на уровне Space через таблицу space_members.\nЧто реализовано (endpoints) Auth (5): register, login, refresh, change-password, logout\nSpaces (9): CRUD + members CRUD\nGantt Charts (9): CRUD + archive + members (добавлен, но удалён в миграции 5)\nGantt Sections (5): CRUD + reorder\nGantt Tasks (4): CRUD\nИтого: ~32 endpoint\n2. Архитектура и качество кода 2.1. Backend — структура cmd/server/main.go — точка входа internal/ domain/ — модели (User, Space, GanttChart, etc.) dto/ — request/response DTO (auth, space, gantt) handlers/ — HTTP handlers (auth, space, gantt) middleware/ — auth, cors, space, gantt, role, logging, recovery repository/ — слой доступа к данным service/ — бизнес-логика config/ — конфигурация (.env) utils/ — jwt, password, response, validation migrations/ — SQL миграции (1-5) Оценка: ✅ Чистая layered архитектура. Разделение ответственности чёткое.\n2.2. Frontend — структура src/app/ core/auth/ — auth service, interceptor core/models/ — app.model, space.model core/services/ — space.service, space-storage.service pages/auth/ — sign-in, sign-up, reset-pw, etc. pages/gantt/ — компоненты, модалки, сервисы, модели pages/dashboards/ — spaces list, dashboard layouts/ — navbar, topbar, main-layout Оценка: ✅ Стандартная Angular-структура. Signals для state management.\n2.3. Проблемы кода # Проблема Критичность Описание C1 \\r в service-файлах Medium gantt_service.go, gantt_section_service.go содержат CRLF C2 main.go:238 — мёртвый код getUserHandler Low Неиспользуемая функция C3 Swagger не сгенерирован Medium Аннотации есть, но api/ директории нет C4 RegisterProtectedRoutes не вызывается в main.go Critical GET/PUT/DELETE /spaces/:id не зарегистрированы 3. Права доступа — главный вопрос 3.1. Текущая реализация Права назначаются исключительно через Space:\nТаблица space_members — связка user ↔ space с role (admin/editor/viewer) SpaceMiddleware.RequireSpace() — проверяет членство и записывает ContextSpaceRole в context RoleMiddleware.RequireMinRole() — проверяет иерархию ролей (admin \u0026gt; editor \u0026gt; viewer) Диаграммы Ганта НЕ имеют собственной системы ролей. Таблица gantt_chart_members была создана (миграция 4) и тут же удалена (миграция 5). Все проверки доступа к диаграммам идут через space membership.\n3.2. Как это работает Запрос → AuthMiddleware (JWT → userID) → SpaceMiddleware.RequireSpace() (проверяет space_members → ContextSpaceRole) → GanttMiddleware.RequireGanttChart() (проверяет chart.space_id == spaceID) → RoleMiddleware.RequireMinRole(\u0026#34;editor\u0026#34;) (проверяет ContextSpaceRole) Это правильно. Любой член Space с ролью editor+ может создавать/редактировать диаграммы. Viewers — только читать.\n3.3. 🔴 Критическая проблема: Frontend не соответствует Backend Frontend MembersModalComponent пытается управлять участниками диаграммы:\nganttService.addMember(chartId, dto) → /api/v1/spaces/{spaceId}/gantt-charts/{chartId}/members ganttService.updateMemberRole(chartId, userId, dto) → .../members/{userId} ganttService.removeMember(chartId, userId) → .../members/{userId} Backend GanttHandler.RegisterRoutes() НЕ регистрирует маршруты для members диаграмм. После удаления gantt_chart_members (миграция 5) эти endpoints не существуют.\nРезультат: модальное окно «Участники диаграммы» на фронтенде не работает — все вызовы вернут 404.\n3.4. 🔴 Проблема: Role fallback В role_middleware.go:28-31:\nrole := c.GetString(ContextSpaceRole) if role == \u0026#34;\u0026#34; { role = c.GetString(ContextRole) // fallback на глобальную роль User } Если ContextSpaceRole не установлен, используется глобальная роль пользователя (из JWT). Это значит:\nПользователь с role=admin в таблице users получит admin-доступ к любому space, даже если он не член этого space Но SpaceMiddleware проверяет членство раньше, так что в цепочке RequireSpace() → RequireMinRole() это не эксплуатируется Однако если RequireMinRole() используется без RequireSpace() — это дыра Рекомендация: Удалить fallback на ContextRole. Если ContextSpaceRole пуст — отказывать.\n3.5. Рекомендации по правам доступа Удалить модалку участников диаграммы на фронтенде — она мертва Или добавить раздел «Участники Space» с возможностью управления ролями через /spaces/:space_id/members (эти endpoints работают) Удалить fallback на ContextRole в role_middleware.go Добавить проверку: editor не может повысить кого-то до admin (сейчас может — AddMember разрешает editor+ назначать любую роль) 4. Безопасность 4.1. Критические # Проблема Файл Описание S1 JWT Secret = test .env JWT_SECRET=test_secret_key_change_in_production — это прод-конфиг! S2 CORS: * .env CORS_ALLOWED_ORIGINS=* — любой домен может обращаться к API S3 Пароль БД в .env .env DB_PASSWORD=popoloka16 — creds в открытом виде S4 Refresh tokens: SHA256 utils/password.go SHA256 вместо bcrypt для refresh token hash — быстро брутфорсится 4.2. Высокие # Проблема Описание S5 Нет rate limiting Brute-force на /auth/login без ограничений S6 Нет CSRF protection API принимает POST/PUT/DELETE без CSRF-токена S7 Нет CSP заголовков X-Frame-Options, Content-Security-Policy не настроены S8 JWT в localStorage XSS может украсть access + refresh tokens 4.3. Средние # Проблема Описание S9 Нет password policy Минимальные требования к паролю не enforced S10 Нет audit log Действия с spaces/charts не логируются для аудита S11 Нет блокировки аккаунта Неограниченные попытки входа 5. Инфраструктура 5.1. Текущее состояние Компонент Статус Примечание Go API (pm2: leadera-api) ⚠️ Порт 8080, хост 0.0.0.0 Angular FE (pm2: leadera-fe) ⚠️ Порт 4200, хост 0.0.0.0 PostgreSQL (Docker) ✅ Порт 5432, контейнер app-leadera-db VPS reverse proxy ⚠️ sand.a2v.space → 8082/8083, но 502 если сервисы не запущены SSL ✅ Let\u0026rsquo;s Encrypt на VPS 5.2. Проблемы # Проблема Описание I1 Docker для БД, нативно для API Несогласованность — API и FE не в Docker I2 Нет health-check в pm2 API может упасть без перезапуска I3 Нет CI/CD Ручной деплой через make run + pm2 I4 Нет nginx на Mac Studio FE и API торчат наружу напрямую 6. Функциональная оценка 6.1. Что работает Функция Backend Frontend Статус Регистрация/логин ✅ ✅ Работает JWT auth + refresh ✅ ✅ Работает Spaces CRUD ⚠️ ✅ RegisterProtectedRoutes не вызван (C4) Space members ✅ ✅ Работает Gantt charts CRUD ✅ ✅ Работает Gantt sections ✅ ✅ Работает Gantt tasks ✅ ⚠️ Нет UI для задач внутри диаграммы Архивация диаграмм ✅ ✅ Работает Members диаграммы ❌ ✅ (мёртвый UI) Backend endpoints не существуют 6.2. Что НЕ работает или отсутствует Функция Статус Визуализация Ганта (таймлайн) ❌ Нет компонента отрисовки Drag \u0026amp; Drop задач ❌ Real-time collaboration ❌ Уведомления ❌ Поиск ❌ Экспорт (PDF/Excel) ❌ Email verification ❌ Password reset Backend есть, UI есть — не проверено 6.3. Оценка готовности Система на стадии каркаса. Backend API функционален для CRUD операций, но:\nВизуализация Ганта — основная фича — не реализована (нет canvas/SVG рендеринга) Управление участниками только на уровне Space Нет CI/CD, тестов, мониторинга 7. Приоритизированный план исправлений Неделя 1 — Критическое (безопасность) Приоритет Задача Трудоёмкость P0 Заменить JWT secret на криптостойкий 1 час P0 Настроить CORS (только sand.a2v.space) 1 час P0 bcrypt для refresh tokens вместо SHA256 2 часа P0 Удалить fallback на ContextRole в role_middleware 30 мин P0 Исправить RegisterProtectedRoutes — зарегистрировать маршруты 1 час P1 Rate limiting на auth endpoints 4 часа P1 Editor не может назначать admin роль 2 часа Неделя 2 — Архитектура прав Приоритет Задача Трудоёмкость P1 Удалить/переписать MembersModalComponent → Space members 4 часа P1 Добавить страницу управления участниками Space 8 часов P2 HttpOnly cookies для JWT (вместо localStorage) 8 часов P2 CSRF protection 4 часа Неделя 3 — Функциональность Приоритет Задача Трудоёмкость P2 Визуализация Ганта (canvas/d3) 40+ часов P2 Drag \u0026amp; Drop для задач 16 часов P3 Тесты (unit + integration) 24 часа P3 CI/CD pipeline 8 часов 8. Резюме Ключевые выводы Права доступа — архитектурно верно: роль назначается через Space, не через диаграмму. Но фронтенд ещё не обновлён после удаления gantt_chart_members. Безопасность — критические уязвимости в конфигурации (JWT secret, CORS, bcrypt). Требуют немедленного исправления до любого публичного деплоя. Функциональность — CRUD работает, но основная ценность (визуализация Ганта) не реализована. Код — чистый, хорошая архитектура, но есть мёртвый код и незарегистрированные маршруты. Общая оценка: 🔴 Pre-alpha Проект готов к внутренней демонстрации CRUD, но не готов к продакшену. Первоочередное — безопасность и исправление мёртвых endpoints.\n","section":"leadera","tags":["audit","leadera","security","architecture"],"title":"Аудит Leadera — полный отчёт","url":"/leadera/leadera-audit/"},{"content":"WebSocket для диаграмм Ганта — realtime-совместное редактирование Дата: 07.04.2026 Статус: Планирование Проект: Leadera (dev — sand.a2v.space)\n1. Постановка задачи Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.\n2. Архитектура Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL │ │ │ HTTP (мутации) │ Broadcast └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты Ключевой принцип: мутации данных идут через HTTP (REST), WebSocket используется только для доставки уведомлений. Сервер — источник истины, клиент не может обойти проверки через WS.\nКомнаты Каждый открытый Гант — это «комната» с идентификатором chartId. При подключении клиент подписывается на комнату. Hub рассылает события всем подписчикам комнаты.\n3. Backend (Go) 3.1. Зависимости go get github.com/gorilla/websocket 3.2. Новые файлы — internal/ws/ message.go — типы сообщений package ws import \u0026#34;time\u0026#34; // EventType — тип события type EventType string const ( // Данные EventSectionCreated EventType = \u0026#34;section_created\u0026#34; EventSectionUpdated EventType = \u0026#34;section_updated\u0026#34; EventSectionDeleted EventType = \u0026#34;section_deleted\u0026#34; EventSectionsReordered EventType = \u0026#34;sections_reordered\u0026#34; EventTaskCreated EventType = \u0026#34;task_created\u0026#34; EventTaskUpdated EventType = \u0026#34;task_updated\u0026#34; EventTaskDeleted EventType = \u0026#34;task_deleted\u0026#34; // Присутствие EventUserJoined EventType = \u0026#34;user_joined\u0026#34; EventUserLeft EventType = \u0026#34;user_left\u0026#34; // Безопасность / доступ EventAccessRevoked EventType = \u0026#34;access_revoked\u0026#34; EventChartArchived EventType = \u0026#34;chart_archived\u0026#34; EventRoleChanged EventType = \u0026#34;role_changed\u0026#34; EventTokenExpired EventType = \u0026#34;token_expired\u0026#34; ) // Event — WS-событие, отправляемое клиентам type Event struct { Type EventType `json:\u0026#34;type\u0026#34;` ChartID string `json:\u0026#34;chartId\u0026#34;` UserID string `json:\u0026#34;userId,omitempty\u0026#34;` Payload interface{} `json:\u0026#34;payload,omitempty\u0026#34;` Timestamp time.Time `json:\u0026#34;timestamp\u0026#34;` } // IncomingMessage — сообщение от клиента (для ping/pong) type IncomingMessage struct { Type string `json:\u0026#34;type\u0026#34;` } hub.go — центральный брокер package ws import ( \u0026#34;sync\u0026#34; ) // Hub управляет комнатами и рассылкой событий type Hub struct { mu sync.RWMutex rooms map[string]map[*Client]bool // chartId → клиенты } func NewHub() *Hub { return \u0026amp;Hub{ rooms: make(map[string]map[*Client]bool), } } // Subscribe добавляет клиента в комнату func (h *Hub) Subscribe(chartID string, client *Client) { h.mu.Lock() defer h.mu.Unlock() if h.rooms[chartID] == nil { h.rooms[chartID] = make(map[*Client]bool) } h.rooms[chartID][client] = true // Уведомить остальных: user_joined h.broadcastExcept(chartID, client, Event{ Type: EventUserJoined, ChartID: chartID, UserID: client.UserID, Payload: map[string]string{\u0026#34;username\u0026#34;: client.Username}, Timestamp: time.Now(), }) } // Unsubscribe удаляет клиента из комнаты func (h *Hub) Unsubscribe(chartID string, client *Client) { h.mu.Lock() defer h.mu.Unlock() if clients, ok := h.rooms[chartID]; ok { delete(clients, client) if len(clients) == 0 { delete(h.rooms, chartID) } } // Уведомить остальных: user_left h.broadcastExcept(chartID, client, Event{ Type: EventUserLeft, ChartID: chartID, UserID: client.UserID, Timestamp: time.Now(), }) } // Broadcast рассылает событие всем клиентам в комнате func (h *Hub) Broadcast(chartID string, event Event) { h.mu.RLock() defer h.mu.RUnlock() if clients, ok := h.rooms[chartID]; ok { for client := range clients { client.Send(event) } } } // SendToUser отправляет событие конкретному пользователю во всех его комнатах func (h *Hub) SendToUser(userID string, event Event) { h.mu.RLock() defer h.mu.RUnlock() for _, clients := range h.rooms { for client := range clients { if client.UserID == userID { client.Send(event) } } } } // broadcastExcept рассылает всем, кроме отправителя func (h *Hub) broadcastExcept(chartID string, sender *Client, event Event) { if clients, ok := h.rooms[chartID]; ok { for client := range clients { if client != sender { client.Send(event) } } } } client.go — обёртка WS-соединения package ws import ( \u0026#34;encoding/json\u0026#34; \u0026#34;sync\u0026#34; \u0026#34;time\u0026#34; \u0026#34;github.com/gorilla/websocket\u0026#34; ) const ( writeWait = 10 * time.Second pongWait = 60 * time.Second pingPeriod = (pongWait * 9) / 10 maxMessageSize = 1024 ) type Client struct { Hub *Hub Conn *websocket.Conn UserID string Username string ChartID string SendCh chan Event mu sync.Mutex } func NewClient(hub *Hub, conn *websocket.Conn, userID, username, chartID string) *Client { return \u0026amp;Client{ Hub: hub, Conn: conn, UserID: userID, Username: username, ChartID: chartID, SendCh: make(chan Event, 64), } } // ReadPump читает входящие сообщения (ping/pong) func (c *Client) ReadPump() { defer func() { c.Hub.Unsubscribe(c.ChartID, c) c.Conn.Close() }() c.Conn.SetReadLimit(maxMessageSize) c.Conn.SetReadDeadline(time.Now().Add(pongWait)) c.Conn.SetPongHandler(func(string) error { c.Conn.SetReadDeadline(time.Now().Add(pongWait)) return nil }) for { _, message, err := c.Conn.ReadMessage() if err != nil { break } // Клиент может слать только ping, данные игнорируем _ = message } } // WritePump отправляет события клиенту func (c *Client) WritePump() { ticker := time.NewTicker(pingPeriod) defer func() { ticker.Stop() c.Conn.Close() }() for { select { case event, ok := \u0026lt;-c.SendCh: c.Conn.SetWriteDeadline(time.Now().Add(writeWait)) if !ok { c.Conn.WriteMessage(websocket.CloseMessage, []byte{}) return } data, _ := json.Marshal(event) c.mu.Lock() c.Conn.WriteMessage(websocket.TextMessage, data) c.mu.Unlock() case \u0026lt;-ticker.C: c.Conn.SetWriteDeadline(time.Now().Add(writeWait)) if err := c.Conn.WriteMessage(websocket.PingMessage, nil); err != nil { return } } } } // Send ставит событие в очередь отправки func (c *Client) Send(event Event) { select { case c.SendCh \u0026lt;- event: default: // Очередь полна — отключаем медленного клиента close(c.SendCh) } } 3.3. WS endpoint — internal/handlers/ws_handler.go package handlers import ( \u0026#34;net/http\u0026#34; \u0026#34;time\u0026#34; \u0026#34;app-leadera-api/internal/middleware\u0026#34; \u0026#34;app-leadera-api/internal/ws\u0026#34; \u0026#34;github.com/gin-gonic/gin\u0026#34; \u0026#34;github.com/google/uuid\u0026#34; \u0026#34;github.com/gorilla/websocket\u0026#34; ) var upgrader = websocket.Upgrader{ ReadBufferSize: 1024, WriteBufferSize: 1024, CheckOrigin: func(r *http.Request) bool { return true }, // nginx проксирует } type WSHandler struct { hub *ws.Hub ganttMW *middleware.GanttMiddleware } func NewWSHandler(hub *ws.Hub, ganttMW *middleware.GanttMiddleware) *WSHandler { return \u0026amp;WSHandler{hub: hub, ganttMW: ganttMW} } func (h *WSHandler) HandleGanttWS(c *gin.Context) { // 1. Получить пользователя из контекста (auth middleware уже отработал) userID, exists := c.Get(\u0026#34;userID\u0026#34;) if !exists { c.AbortWithStatusJSON(401, gin.H{\u0026#34;error\u0026#34;: \u0026#34;unauthorized\u0026#34;}) return } // 2. Проверить доступ к chartId (gantt middleware) chartID := c.Param(\u0026#34;chartId\u0026#34;) if _, err := uuid.Parse(chartID); err != nil { c.AbortWithStatusJSON(400, gin.H{\u0026#34;error\u0026#34;: \u0026#34;invalid chart id\u0026#34;}) return } // TODO: проверить через ganttMW что userID имеет доступ к этому chart // 3. Upgrade до WebSocket conn, err := upgrader.Upgrade(c.Writer, c.Request, nil) if err != nil { return } // 4. Создать клиент и подписать на комнату client := ws.NewClient( h.hub, conn, userID.(string), c.GetString(\u0026#34;username\u0026#34;), chartID, ) h.hub.Subscribe(chartID, client) // 5. Запустить pump\u0026#39;ы go client.WritePump() go client.ReadPump() } 3.4. Регистрация маршрута В cmd/server/main.go или где регистрируются routes:\n// После создания hub wsHub := ws.NewHub() // WS endpoint wsHandler := handlers.NewWSHandler(wsHub, ganttMW) api.GET(\u0026#34;/ws/gantt/:chartId\u0026#34;, authMW.RequireAuth(), wsHandler.HandleGanttWS) // Передать hub в ganttHandler для broadcast\u0026#39;ов ganttHandler := handlers.NewGanttHandler(ganttService, sectionService, taskService, blockService, wsHub) 3.5. Интеграция broadcast в handlers В каждый write-handler — одна строка после успешной операции:\n// Пример: после успешного UpdateTask h.hub.Broadcast(chartID, ws.Event{ Type: ws.EventTaskUpdated, ChartID: chartID, UserID: userID, Payload: updatedTask, Timestamp: time.Now(), }) Точки интеграции в gantt_handler.go:\nCreateGanttChart → не нужен (пользователь только что создал, он один) UpdateGanttChart / ArchiveGanttChart → chart_archived CreateSection → section_created UpdateSection → section_updated DeleteSection → section_deleted ReorderSections → sections_reordered CreateTask → task_created UpdateTask → task_updated DeleteTask → task_deleted 3.6. Интеграция событий безопасности В соответствующих service-методах:\n// При исключении из space (SpaceService.RemoveMember) wsHub.SendToUser(removedUserID, ws.Event{ Type: ws.EventAccessRevoked, Payload: map[string]string{\u0026#34;spaceId\u0026#34;: spaceID}, }) // При архивации ганта wsHub.Broadcast(chartID, ws.Event{ Type: ws.EventChartArchived, ChartID: chartID, }) // При изменении роли wsHub.SendToUser(userID, ws.Event{ Type: ws.EventRoleChanged, Payload: map[string]string{\u0026#34;role\u0026#34;: newRole}, }) 4. Frontend (Angular) 4.1. WebSocket сервис — gantt-ws.service.ts // src/app/pages/gantt/services/gantt-ws.service.ts import { Injectable, inject, OnDestroy } from \u0026#39;@angular/core\u0026#39;; import { Subject, Observable } from \u0026#39;rxjs\u0026#39;; import { environment } from \u0026#39;../../../environments/environment\u0026#39;; import { SpaceStorageService } from \u0026#39;../../../core/services/space-storage.service\u0026#39;; import { AuthService } from \u0026#39;../../../core/auth/services/auth.service\u0026#39;; export interface WSEvent { type: string; chartId?: string; userId?: string; payload?: any; timestamp?: string; } @Injectable({ providedIn: \u0026#39;root\u0026#39; }) export class GanttWSService implements OnDestroy { private spaceStorage = inject(SpaceStorageService); private auth = inject(AuthService); private socket: WebSocket | null = null; private eventSubject = new Subject\u0026lt;WSEvent\u0026gt;(); private reconnectTimer: any; private chartId: string | null = null; /** Observable для подписки на события */ get events$(): Observable\u0026lt;WSEvent\u0026gt; { return this.eventSubject.asObservable(); } /** Подключиться к комнате ганта */ connect(chartId: string): void { this.disconnect(); this.chartId = chartId; const token = this.auth.getAccessToken(); const wsUrl = this.buildWSUrl(chartId, token); this.socket = new WebSocket(wsUrl); this.socket.onopen = () =\u0026gt; { console.log(`[WS] Connected to gantt ${chartId}`); }; this.socket.onmessage = (msg) =\u0026gt; { try { const event: WSEvent = JSON.parse(msg.data); this.eventSubject.next(event); } catch (e) { console.error(\u0026#39;[WS] Parse error\u0026#39;, e); } }; this.socket.onclose = (event) =\u0026gt; { console.log(`[WS] Closed: ${event.code}`); if (event.code !== 1000) { this.scheduleReconnect(); } }; this.socket.onerror = () =\u0026gt; { this.socket?.close(); }; } /** Отключиться */ disconnect(): void { clearTimeout(this.reconnectTimer); if (this.socket) { this.socket.close(1000, \u0026#39;manual\u0026#39;); this.socket = null; } this.chartId = null; } ngOnDestroy(): void { this.disconnect(); } private buildWSUrl(chartId: string, token: string): string { const base = environment.wsUrl || location.protocol.replace(\u0026#39;http\u0026#39;, \u0026#39;ws\u0026#39;) + \u0026#39;//\u0026#39; + location.host; return `${base}/api/v1/ws/gantt/${chartId}?token=${token}`; } private scheduleReconnect(): void { if (!this.chartId) return; this.reconnectTimer = setTimeout(() =\u0026gt; { console.log(\u0026#39;[WS] Reconnecting...\u0026#39;); if (this.chartId) this.connect(this.chartId); }, 3000); } } 4.2. Интеграция в gantt-chart-canvas компонент // В gantt-chart-canvas.component.ts export class GanttChartCanvasComponent implements OnInit, OnDestroy { private ws = inject(GanttWSService); private onlineUsers: Set\u0026lt;string\u0026gt; = new Set(); private wsSubscription: Subscription | null = null; ngOnInit(): void { // Подключиться к WS при загрузке ганта this.ws.connect(this.chartId); this.wsSubscription = this.ws.events$.subscribe(event =\u0026gt; { this.handleWSEvent(event); }); } ngOnDestroy(): void { this.wsSubscription?.unsubscribe(); this.ws.disconnect(); } private handleWSEvent(event: WSEvent): void { // Если это событие от текущего пользователя — пропускаем // (мы уже обновили UI оптимистично или после HTTP-ответа) if (event.userId === this.currentUserId) return; switch (event.type) { case \u0026#39;section_created\u0026#39;: this.addSectionLocal(event.payload); this.redrawCanvas(); break; case \u0026#39;section_updated\u0026#39;: this.updateSectionLocal(event.payload); this.redrawCanvas(); break; case \u0026#39;section_deleted\u0026#39;: this.removeSectionLocal(event.payload.id); this.redrawCanvas(); break; case \u0026#39;sections_reordered\u0026#39;: this.reorderSectionsLocal(event.payload.ordered_ids); this.redrawCanvas(); break; case \u0026#39;task_created\u0026#39;: this.addTaskLocal(event.payload); this.redrawCanvas(); break; case \u0026#39;task_updated\u0026#39;: this.updateTaskLocal(event.payload); this.redrawCanvas(); break; case \u0026#39;task_deleted\u0026#39;: this.removeTaskLocal(event.payload.id); this.redrawCanvas(); break; case \u0026#39;user_joined\u0026#39;: this.onlineUsers.add(event.userId!); this.showOnlineIndicator(); break; case \u0026#39;user_left\u0026#39;: this.onlineUsers.delete(event.userId!); this.showOnlineIndicator(); break; // === Безопасность === case \u0026#39;access_revoked\u0026#39;: this.router.navigate([\u0026#39;/gantt\u0026#39;], { state: { alert: \u0026#39;Доступ к пространству был отозван\u0026#39; } }); break; case \u0026#39;chart_archived\u0026#39;: this.router.navigate([\u0026#39;/gantt\u0026#39;], { state: { alert: \u0026#39;Диаграмма была заархивирована\u0026#39; } }); break; case \u0026#39;role_changed\u0026#39;: this.currentRole = event.payload.role; this.updateEditableState(); break; case \u0026#39;token_expired\u0026#39;: this.router.navigate([\u0026#39;/auth/login\u0026#39;]); break; } } private redrawCanvas(): void { // Перерисовать Konva canvas с обновлёнными данными } } 4.3. Индикатор онлайн-пользователей Добавить в шаблон canvas-компонента:\n\u0026lt;!-- Онлайн-индикатор --\u0026gt; \u0026lt;div class=\u0026#34;online-indicator\u0026#34; *ngIf=\u0026#34;onlineUsers.size \u0026gt; 0\u0026#34;\u0026gt; \u0026lt;span class=\u0026#34;pulse-dot\u0026#34;\u0026gt;\u0026lt;/span\u0026gt; {{ onlineUsers.size }} онлайн \u0026lt;/div\u0026gt; 5. Безопасность 5.1. Авторизация при подключении Этап Проверка WS Handshake JWT в query-параметре ?token=... Подписка на комнату Проверка membership в space Каждое broadcast-событие Hub знает userId каждого клиента 5.2. Сценарии отзыва доступа Событие Триггер Действие на клиенте access_revoked Исключение из space Редирект на список гантов chart_archived Архивация ганта Редирект на список гантов role_changed Смена роли (editor→viewer) Отключить редактирование token_expired Токен протух Редирект на логин 5.3. Защита от злоупотреблений Угроза Мера Спам WS-сообщений Rate limit: 30 msg/min на клиента, ReadLimit в gorilla/websocket Подключение без прав Проверка space membership при handshake Истёкший токен Ping/pong + периодическая проверка JWT (раз в 5 мин) XSS через WS Payload — JSON, sanitize имён на frontend Мутации через WS WS только для чтения (уведомления). Мутации — через HTTP API с полной валидацией 5.4. Nginx конфигурация В конфиг sand.a2v.space добавить:\n# WebSocket проксирование location /api/v1/ws/ { proxy_pass http://127.0.0.1:8080; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \u0026#34;upgrade\u0026#34;; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_read_timeout 86400s; # 24h для long-lived WS proxy_send_timeout 86400s; } 6. Оценка трудозатрат Компонент Строки кода Время internal/ws/ (hub, client, message) ~200 2-3 часа ws_handler.go (endpoint) ~60 30 мин Интеграция broadcast в handlers ~20 (по строке на endpoint) 30 мин События безопасности в services ~30 30 мин gantt-ws.service.ts (Angular) ~80 1 час Интеграция в canvas-компонент ~80 1-2 часа Индикатор онлайн ~30 30 мин Nginx конфигурация ~10 10 мин Тестирование — 2-3 часа Итого ~510 строк ~1-2 дня 7. Порядок реализации Backend: internal/ws/ — hub, client, message types Backend: WS endpoint — handler + route Backend: Broadcast в handlers — интеграция в существующие CRUD-эндпоинты Backend: События безопасности — access_revoked, chart_archived, role_changed Nginx: WS location — проксирование WebSocket Frontend: WS service — подключение, реконнект, парсинг событий Frontend: Интеграция в canvas — обработка событий, обновление Konva Frontend: Индикатор онлайн — визуальная обратная связь Тестирование — многопользовательский сценарий, отзыв прав, обрывы связи 8. Дальнейшие улучшения (после MVP) Cursor других пользователей — показывать позицию курсора на таймлайне Блокировка элемента — «кто-то редактирует эту задачу» (optimistic locking через WS) Чат в ганте — комментарии к задачам прямо на канвасе History/undo — откат изменений с визуальной историей Уведомления — push-уведомления при @mention в комментариях к задачам ","section":"leadera","tags":["leadera","websocket","realtime","gantt","architecture"],"title":"Leadera — WebSocket для диаграмм Ганта","url":"/leadera/leadera-websocket-gantt/"},{"content":"Экспорт диаграммы Ганта в Excel Дата: 09.04.2026 Статус: Требования Проект: Leadera\nОбщее описание Пользователь нажимает кнопку экспорта в интерфейсе диаграммы Ганта. Система запрашивает диапазон дат выгрузки (по умолчанию — текущий видимый диапазон из интерфейса). После указания диапазона скачивается Excel-файл с визуальным представлением диаграммы Ганта.\nВводные данные Источник: текущая диаграмма Ганта проекта (один проект = одна диаграмма) Диапазон дат: пользователь указывает начальную и конечную дату. По умолчанию подставляется видимый в момент запроса диапазон из интерфейса Масштаб таймлайна: берётся тот, который выбран пользователем в интерфейсе в момент запроса (не сохранённый в системе, а текущий). Варианты: по ячейкам или по дням Структура Excel-файла Шапка (первые строки) Название диаграммы (название проекта) Диапазон дат, в рамках которого сделана выгрузка Лист — один Вся диаграмма размещается на одном листе.\nСекции Секции отображаются как визуальная группировка строк (не отдельные листы) Название секции — строка-заголовок над группой задач Задачи Каждая задача — отдельная строка. Данные задачи:\nНазвание (текстовая колонка слева) Дата начала (текстовая колонка слева) Дата конца (текстовая колонка слева) Цвет — ячейки таймлайна, соответствующие задаче, закрашены в цвет задачи Таймлайн Таймлайн представлен колонками дат в верхней части (горизонтальная ось времени) Масштаб колонок соответствует выбранному пользователем в момент экспорта (по ячейкам / по дням) Задачи отображаются как merged cells по соответствующим колонкам дат — визуальная полоса диаграммы Ганта Вехи Отображаются отдельной строкой (как задача, но с маркировкой вехи) Позиционируются на соответствующей дате в таймлайне Зависимости Не отображаются (стрелочки/связи между задачами не нужны) Пользовательский сценарий Пользователь открывает диаграмму Ганта проекта Настраивает масштаб таймлайна (по ячейкам / по дням) Нажимает кнопку «Экспорт в Excel» Система показывает диалог с выбором диапазона дат (предзаполнен текущим видимым диапазоном) Пользователь подтверждает / корректирует диапазон Система генерирует Excel-файл и инициирует скачивание Технические требования Backend (Go API) Новый endpoint для генерации Excel (например, GET /api/v1/gantt/:projectId/export) Query-параметры: dateFrom, dateTo, scale (cell|day) Ответ: binary Excel-файл (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet) Авторизация: обязательна (только участники проекта) Библиотека для генерации Excel: excelize (Go) Frontend (Angular) Кнопка экспорта в тулбаре диаграммы Ганта Модальное окно выбора диапазона дат с datepicker\u0026rsquo;ами Предзаполнение диапазона из текущего видимого viewport\u0026rsquo;а Скачивание файла через Blob / saveAs Фильтрация данных Выгружаются все задачи и вехи, которые: Начинаются в диапазоне, ИЛИ Заканчиваются в диапазоне, ИЛИ Начинаются до диапазона и заканчиваются после (перекрывают целиком) Секции включаются, если в них есть хотя бы одна попавшая задача Открытые вопросы (Нет)\n","section":"leadera","tags":["leadera","gantt","excel","export"],"title":"Leadera — Экспорт диаграммы Ганта в Excel","url":"/leadera/leadera-gantt-excel-export/"},{"content":"Фильтры и реорганизация списка диаграмм Ганта Дата: 07.04.2026 Статус: Требования Проект: Leadera (dev — sand.a2v.space)\n1. Постановка задачи Список диаграмм Ганта должен показывать все доступные пользователю диаграммы из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.\n2. Изменения API 2.1. Новый endpoint списка диаграмм Было:\nGET /api/v1/spaces/{spaceId}/gantt-charts?page=1\u0026amp;per_page=10 Стало:\nGET /api/v1/gantt-charts?page=1\u0026amp;per_page=10 Пользователь видит все диаграммы из всех пространств, где он является подтверждённым участником (статус accepted).\n2.2. Параметры фильтрации и поиска Параметр Тип Описание page int Номер страницы (default: 1) per_page int Записей на странице (default: 10) space_id UUID (optional) Фильтр по конкретному пространству created_by UUID (optional) Фильтр по создателю диаграммы search string (optional) Поиск по назвению и описанию (ILIKE, case-insensitive) sort string (optional) Сортировка: created_at, updated_at, title (default: updated_at) order string (optional) asc / desc (default: desc) Примеры:\nGET /api/v1/gantt-charts?search=миграция GET /api/v1/gantt-charts?space_id=0b334ded-...\u0026amp;created_by=a1b2c3d4-... GET /api/v1/gantt-charts?page=2\u0026amp;per_page=20\u0026amp;sort=title\u0026amp;order=asc 2.3. Изменение структуры ответа Добавить поле space в каждую диаграмму:\n{ \u0026#34;data\u0026#34;: [ { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;title\u0026#34;: \u0026#34;Миграция backend\u0026#34;, \u0026#34;description\u0026#34;: \u0026#34;...\u0026#34;, \u0026#34;created_by\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;created_by_name\u0026#34;: \u0026#34;Антон Агальцов\u0026#34;, \u0026#34;created_at\u0026#34;: \u0026#34;2026-04-01T10:00:00Z\u0026#34;, \u0026#34;updated_at\u0026#34;: \u0026#34;2026-04-07T09:00:00Z\u0026#34;, \u0026#34;space\u0026#34;: { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;name\u0026#34;: \u0026#34;IT Ландшафт\u0026#34;, \u0026#34;color\u0026#34;: \u0026#34;#c4623a\u0026#34; }, \u0026#34;is_archived\u0026#34;: false } ], \u0026#34;pagination\u0026#34;: { \u0026#34;page\u0026#34;: 1, \u0026#34;per_page\u0026#34;: 10, \u0026#34;total\u0026#34;: 42, \u0026#34;total_pages\u0026#34;: 5 } } 2.4. Endpoint для списка фильтров Вспомогательный endpoint для заполнения dropdown-фильтров:\nGET /api/v1/gantt-charts/filters Ответ:\n{ \u0026#34;spaces\u0026#34;: [ { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;name\u0026#34;: \u0026#34;IT Ландшафт\u0026#34;, \u0026#34;color\u0026#34;: \u0026#34;#c4623a\u0026#34; }, { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;name\u0026#34;: \u0026#34;DevOps\u0026#34;, \u0026#34;color\u0026#34;: \u0026#34;#27ae60\u0026#34; } ], \u0026#34;creators\u0026#34;: [ { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;display_name\u0026#34;: \u0026#34;Антон Агальцов\u0026#34; }, { \u0026#34;id\u0026#34;: \u0026#34;uuid\u0026#34;, \u0026#34;display_name\u0026#34;: \u0026#34;Иван Петров\u0026#34; } ] } Логика creators: уникальные создатели всех диаграмм, доступных текущему пользователю. Получается через DISTINCT-запрос по created_by с JOIN на users.\n2.5. Backend — изменения в Go Файлы для изменения:\ninternal/handlers/gantt_handler.go Добавить новый handler ListAllGanttCharts — без привязки к space Зарегистрировать маршрут GET /gantt-charts (без /spaces/:id/) Парсить query-параметры: space_id, created_by, search, sort, order Старый маршрут GET /spaces/:id/gantt-charts — оставить для обратной совместимости (или удалить, если не используется) internal/service/gantt_service.go Новый метод ListAll(ctx, userId, filters) — запрашивает все spaces пользователя (через space_member с status=accepted), затем выбирает все gantt_charts из этих spaces с фильтрами internal/repository/gantt_repository.go Новый метод с динамическим SQL: Базовый JOIN: gantt_charts → spaces → space_members WHERE: space_members.user_id = $1 AND space_members.status = 'accepted' Опциональные фильтры: AND space_id = $N, AND created_by = $N, AND (title ILIKE '%' || $N || '%' OR description ILIKE '%' || $N || '%') Возвращать поле space (id, name, color) через JOIN internal/dto/gantt/ Новые DTO: GanttChartListFilters, GanttChartWithSpaceResponse, GanttFiltersResponse SQL (пример):\nSELECT gc.*, s.id as space_id, s.name as space_name, s.color as space_color, u.display_name as created_by_name FROM gantt_charts gc JOIN spaces s ON s.id = gc.space_id JOIN space_members sm ON sm.space_id = s.id LEFT JOIN users u ON u.id = gc.created_by WHERE sm.user_id = $1 AND sm.status = \u0026#39;accepted\u0026#39; AND ($2::uuid IS NULL OR gc.space_id = $2) AND ($3::uuid IS NULL OR gc.created_by = $3) AND ($4::text IS NULL OR gc.title ILIKE \u0026#39;%\u0026#39; || $4 || \u0026#39;%\u0026#39; OR gc.description ILIKE \u0026#39;%\u0026#39; || $4 || \u0026#39;%\u0026#39;) ORDER BY CASE WHEN $5 = \u0026#39;title\u0026#39; THEN gc.title END, CASE WHEN $5 = \u0026#39;created_at\u0026#39; THEN gc.created_at::text END, gc.updated_at DESC LIMIT $6 OFFSET $7; 3. Изменения Frontend (Angular) 3.1. Toolbar фильтров Добавить toolbar над списком диаграмм:\n┌──────────────────────────────────────────────────────────────────┐ │ [🔍 Поиск... ] [▼ Пространство] │ │ [▼ Создатель] [▼ Сортировка] [Сбросить фильтры] │ └──────────────────────────────────────────────────────────────────┘ Компоненты:\nСтрока поиска — input с debounce (300ms), поиск по назвению и описанию Dropdown «Пространство» — список из /gantt-charts/filters, с цветовой меткой Dropdown «Создатель» — список уникальных создателей Dropdown «Сортировка» — по дате обновления, дате создания, названию Кнопка «Сбросить» — очищает все фильтры Состояние фильтров в URL (query params):\n/gantt?search=миграция\u0026amp;space_id=xxx\u0026amp;sort=updated_at Это позволяет делиться ссылкой с уже настроенными фильтрами.\n3.2. Карточка диаграммы — бейдж пространства На каждой карточке добавить бейдж с названием пространства:\n┌─────────────────────────────────────┐ │ 🟠 IT Ландшафт │ ← бейдж с цветом пространства │ Миграция backend │ │ Перевод PHP→Go, этап 2 │ │ Создал: Антон А. · 07.04.2026 │ └─────────────────────────────────────┘ 3.3. Форма создания диаграммы — выбор пространства В модальном окне создания:\nDropdown со списком пространств, где пользователь имеет роль editor или выше Валидация: если пользователь не editor ни в одном пространстве — показать сообщение «Нет доступных пространств для создания» Запрос доступных пространств: переиспользовать существующий GET /api/v1/spaces с фильтрацией на клиенте по role ∈ [owner, admin, editor], либо добавить параметр ?min_role=editor на backend.\n3.4. Изменение routing Было:\n/gantt → список гантов текущего пространства Стало:\n/gantt → список всех доступных гантов (из всех пространств) Убрать зависимость от SpaceStorageService.getSelectedSpaceId() в списке гантов.\n3.5. Frontend — файлы для изменения Файл Изменение pages/gantt/services/gantt.service.ts Новый метод listAll(filters), getFilters() pages/gantt/gantt.component.ts Подключить toolbar, парсинг URL-параметров pages/gantt/gantt.component.html Добавить toolbar, бейджи на карточках pages/gantt/components/gantt-card/ Добавить бейдж пространства pages/gantt/components/create-chart-modal/ Dropdown выбора пространства core/models/ Обновить модели: добавить space в GanttChart 4. Обратная совместимость Endpoint Статус GET /api/v1/spaces/{id}/gantt-charts Сохранить (для детального view внутри пространства) GET /api/v1/gantt-charts Новый — глобальный список GET /api/v1/gantt-charts/filters Новый — данные для dropdown\u0026rsquo;ов POST /api/v1/spaces/{id}/gantt-charts Сохранить (создание в контексте пространства) Все CRUD для sections/tasks Без изменений 5. Критерии приёмки Endpoint GET /api/v1/gantt-charts возвращает все доступные диаграммы Фильтр по space_id — показывает только диаграммы конкретного пространства Фильтр по created_by — показывает только диаграммы выбранного создателя Поиск search — ищет по title и description (case-insensitive) Dropdown фильтров заполняется реальными данными из /filters Карточка диаграммы показывает бейдж пространства с цветом Форма создания предлагает только пространства с ролью ≥ editor Состояние фильтров сохраняется в URL (можно поделиться ссылкой) Старые endpoints (/spaces/{id}/gantt-charts) продолжают работать Swagger документация обновлена 6. Порядок реализации Backend: DTO для новых запросов/ответов Backend: Repository — SQL-запрос с фильтрами + JOIN на spaces Backend: Service — ListAll, GetFilters Backend: Handler — ListAllGanttCharts, GetGanttFilters, регистрация маршрутов Backend: Swagger — обновить документацию Frontend: Модели — обновить GanttChart, добавить Space в ответ Frontend: Service — listAll(), getFilters() Frontend: Toolbar компонент — поиск + dropdown\u0026rsquo;ы Frontend: Карточка — бейдж пространства Frontend: Модальное окно создания — dropdown пространства Frontend: URL-параметры — синхронизация фильтров с router Тестирование ","section":"leadera","tags":["leadera","gantt","api","frontend","requirements"],"title":"Leadera — Фильтры и реорганизация списка диаграмм Ганта","url":"/leadera/leadera-gantt-filters/"},{"content":"Публичный доступ к диаграмме Ганта (Share) Дата: 09.04.2026 Статус: Требования Проект: Leadera\nОбщее описание Пользователь может создать публичную ссылку на фрагмент диаграммы Ганта, доступную для просмотра без авторизации. Открывший ссылку видит диаграмму в read-only режиме с возможностью масштабирования таймлайна, но без каких-либо элементов управления (создание, редактирование, удаление задач/секций/вех).\nПользовательский сценарий (создатель ссылки) Пользователь открывает диаграмму Ганта проекта Нажимает кнопку «Экспорт» / «Общий доступ» Указывает диапазон дат, который должен отображаться на диаграмме Система генерирует уникальную ссылку (UUID) и показывает её пользователю Пользователь копирует ссылку и передаёт заинтересованным лицам Управление ссылками Вызывается через меню экспорта → модальное окно «Общий доступ» В модальном окне отображается список созданных ссылок с указанием диапазона дат Каждую ссылку можно удалить (полное удаление из БД, не soft delete) Ссылки нельзя редактировать — только создавать и удалять Ограничений на количество активных ссылок нет Статистика просмотров (сколько раз открывали) — не нужна Пользовательский сценарий (зритель по ссылке) Зритель переходит по ссылке (без авторизации) Открывается отдельная страница с диаграммой Ганта Зритель видит: Задачи и вехи, попадающие в заданный диапазон Секции (заголовки группировок) Таймлайн с цветовой раскраской задач Зритель может: Масштабировать таймлайн Переключать отображение «по ячейкам» / «по дням» Зритель не может: Создавать, редактировать, удалять задачи / секции / вехи Видеть любые контролы управления (кнопки создания, контекстные меню, drag-and-drop и т.д.) Авторизоваться через эту страницу Данные и фильтрация Что попадает в представление Задачи и вехи, у которых хотя бы одно из условий верно:\nДата начала попадает в диапазон ссылки Дата конца попадает в диапазон ссылки Задача начинается до диапазона и заканчивается после (полностью перекрывает) Секции включаются, если в них есть хотя бы одна попавшая задача.\nAPI возвращает Только задачи и вехи, попадающие в диапазон (не всю диаграмму) Информацию о секциях, содержащих попавшие задачи Минимальный набор полей, необходимый для отрисовки (без внутренних ID пользователей и т.п.) Технические требования Ссылки Формат: UUID v4 (каждый раз новый) Срок действия: бессрочно (пока не удалена) Удаление: жёсткое (hard delete из БД) Backend (Go API) Таблица БД: gantt_public_links id (UUID, PK) project_id (FK → projects) date_from (date) date_to (date) created_by (FK → users) created_at (timestamp) Endpoints POST /api/v1/gantt/:projectId/public-links — создать ссылку (авторизован, участник проекта) Body: { dateFrom, dateTo } Response: { url: \u0026quot;https://leadera.pro/share/\u0026lt;uuid\u0026gt;\u0026quot; } GET /api/v1/gantt/:projectId/public-links — список ссылок проекта (авторизован, участник) DELETE /api/v1/gantt/public-links/:uuid — удалить ссылку (авторизован, создатель) GET /api/v1/public/gantt/:uuid — получить данные диаграммы по ссылке (без авторизации) Response: задачи, вехи, секции в рамках диапазона Rate limiting На публичный endpoint GET /api/v1/public/gantt/:uuid — rate limiting для защиты от перебора Рекомендация: 60 запросов в минуту на IP Frontend (Angular) Модальное окно «Общий доступ» Вызывается из меню экспорта Содержит: Форму создания ссылки (диапазон дат + кнопка «Создать») Список существующих ссылок (диапазон + URL + кнопка «Копировать» + кнопка «Удалить») Публичная страница /share/:uuid Отдельный route, не требует авторизации Отображает диаграмму Ганта в read-only режиме Доступны только: масштабирование таймлайна, переключение ячейки/дни Все контролы управления скрыты (удалены из шаблона, не просто disabled) Минимальный layout — без навигации проекта, без сайдбара Открытые вопросы (Нет)\n","section":"leadera","tags":["leadera","gantt","public-access","sharing"],"title":"Leadera — Публичный доступ к диаграмме Ганта","url":"/leadera/leadera-gantt-public-access/"},{"content":"Бизнес-требования BR-1: Сущность «Веха» (Milestone) Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.\nПоля вехи:\nПоле Тип Описание id UUID Идентификатор gantt_chart_id UUID Принадлежность к диаграмме (не к секции!) title string Название вехи (обязательное, 1–255 символов) date date Дата вехи (без времени, обязательная) color string Цвет маркера (HEX, по умолчанию #dc3545 — красный) created_by UUID Кто создал (не отображается в UI, хранится для аудита) updated_by UUID Кто обновил (не отображается в UI) created_at timestamp Дата создания updated_at timestamp Дата обновления deleted_at timestamp Soft delete Права доступа: Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).\nОсобенности:\nВех может быть несколько в проекте Несколько вех могут иметь одну и ту же дату Вехи сортируются строго по дате (по возрастанию) Вехи не привязаны к секциям — они отображаются сквозь все секции BR-2: Управление вехами (модальное окно) Вызов: Кнопка «Вехи» рядом с кнопкой «Создать секцию» на странице диаграммы.\nМодальное окно содержит:\nЗаголовок: «Вехи проекта» Список всех вех текущей диаграммы (сортировка по дате по возрастанию) Каждая веха в списке показывает: цвет (индикатор), название, дату, кнопки «Редактировать» и «Удалить» Кнопка «Добавить веху» Форма добавления/редактирования вехи:\nНазвание — текстовый ввод (обязательное, 1–255 символов) Дата — datepicker (обязательное) Цвет — выбор цвета (по аналогии с палитрой цветов в задачах) По умолчанию цвет = красный (#dc3545) Удаление: с подтверждением (confirm dialog).\nBR-3: Отображение вех на таймлайне Визуальное представление:\nМаркер-флажок (flag marker) на шкале таймлайна От маркера вниз идёт пунктирная вертикальная линия через все секции (на всю высоту диаграммы) Цвет линии и маркера = цвет вехи Позиционирование:\nВеха ставится ровно на свою дату на шкале времени Если дата вехи выходит за рамки текущего диапазона задач — таймлайн расширяется (аналогично задачам) При изменении масштаба (days/weeks/months/quarters) позиция вехи пересчитывается Tooltip при наведении:\nПри наведении на маркер/линию — показывается tooltip с названием вехи Если на одну дату приходится несколько вех — в tooltip показываются все вехи этой даты с их названиями (каждая с индикацией своего цвета) Технические требования База данных Новая таблица: gantt_milestones CREATE TABLE gantt_milestones ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), gantt_chart_id UUID NOT NULL REFERENCES gantt_charts(id) ON DELETE CASCADE, title VARCHAR(255) NOT NULL, date DATE NOT NULL, color VARCHAR(20) NOT NULL DEFAULT \u0026#39;#dc3545\u0026#39;, created_by UUID NOT NULL REFERENCES users(id), updated_by UUID NOT NULL REFERENCES users(id), created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), deleted_at TIMESTAMP WITH TIME ZONE ); CREATE INDEX idx_gantt_milestones_chart ON gantt_milestones(gantt_chart_id); CREATE INDEX idx_gantt_milestones_date ON gantt_milestones(date); Backend (Go API) Этап 1: Миграция + Домен Промт для агента:\nДобавь в проект новую таблицу gantt_milestones.\nСоздай миграцию в cmd/migrate/:\nНовая таблица gantt_milestones с полями: id (UUID PK), gantt_chart_id (UUID FK → gantt_charts, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), date (DATE NOT NULL), color (VARCHAR 20 NOT NULL DEFAULT \u0026lsquo;#dc3545\u0026rsquo;), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. Индексы по gantt_chart_id и date. Создай доменную модель GanttMilestone в internal/domain/gantt.go:\ntype GanttMilestone struct { ID UUID `json:\u0026#34;id\u0026#34;` GanttChartID UUID `json:\u0026#34;gantt_chart_id\u0026#34;` Title string `json:\u0026#34;title\u0026#34;` Date time.Time `json:\u0026#34;date\u0026#34;` Color string `json:\u0026#34;color\u0026#34;` CreatedBy UUID `json:\u0026#34;created_by\u0026#34;` UpdatedBy UUID `json:\u0026#34;updated_by\u0026#34;` CreatedAt time.Time `json:\u0026#34;created_at\u0026#34;` UpdatedAt time.Time `json:\u0026#34;updated_at\u0026#34;` DeletedAt *time.Time `json:\u0026#34;deleted_at,omitempty\u0026#34;` } Этап 2: CRUD для GanttMilestones Промт для агента:\nРеализуй полный CRUD для сущности GanttMilestone по аналогии с существующими handlers/services/repositories в проекте.\nРоуты:\nGET /api/gantt-charts/:chartId/milestones — список вех диаграммы POST /api/gantt-charts/:chartId/milestones — создать веху PUT /api/gantt-charts/:chartId/milestones/:milestoneId — обновить веху DELETE /api/gantt-charts/:chartId/milestones/:milestoneId — удалить веху (soft delete) Repository: internal/repository/gantt_milestone_repository.go\nGetByChartID(ctx, chartID) ([]domain.GanttMilestone, error) — все неудалённые вехи диаграммы, отсортированные по date ASC GetByID(ctx, id) (*domain.GanttMilestone, error) Create(ctx, milestone) error Update(ctx, milestone) error Delete(ctx, id) error — soft delete (set deleted_at) Все запросы — raw SQL через pgx, как в остальных репозиториях проекта Service: internal/service/gantt_milestone_service.go\nВалидация: title (1–255 символов), date (обязательное), color (валидный HEX, default \u0026lsquo;#dc3545\u0026rsquo;) Проверка прав доступа: пользователь должен иметь права выше «только чтение» в пространстве (space) диаграммы Проверка что chartId существует и не архивирован Handler: internal/handler/gantt_milestone_handler.go\nSwagger-аннотации для всех эндпоинтов Валидация входных данных Ошибки в формате проекта DTO: internal/dto/gantt/milestones_dto.go\ntype CreateGanttMilestoneRequest struct { Title string `json:\u0026#34;title\u0026#34; binding:\u0026#34;required,min=1,max=255\u0026#34;` Date string `json:\u0026#34;date\u0026#34; binding:\u0026#34;required\u0026#34;` Color *string `json:\u0026#34;color\u0026#34; binding:\u0026#34;omitempty,max=20\u0026#34;` } type UpdateGanttMilestoneRequest struct { Title *string `json:\u0026#34;title\u0026#34; binding:\u0026#34;omitempty,min=1,max=255\u0026#34;` Date *string `json:\u0026#34;date\u0026#34; binding:\u0026#34;omitempty\u0026#34;` Color *string `json:\u0026#34;color\u0026#34; binding:\u0026#34;omitempty,max=20\u0026#34;` } type GanttMilestoneResponse struct { ID domain.UUID `json:\u0026#34;id\u0026#34;` GanttChartID domain.UUID `json:\u0026#34;gantt_chart_id\u0026#34;` Title string `json:\u0026#34;title\u0026#34;` Date string `json:\u0026#34;date\u0026#34;` Color string `json:\u0026#34;color\u0026#34;` CreatedByUser *CreatedByUpdatedUser `json:\u0026#34;created_by_user\u0026#34;` UpdatedByUser *CreatedByUpdatedUser `json:\u0026#34;updated_by_user\u0026#34;` CreatedAt time.Time `json:\u0026#34;created_at\u0026#34;` UpdatedAt time.Time `json:\u0026#34;updated_at\u0026#34;` } type GanttMilestonesListResponse struct { Milestones []GanttMilestoneResponse `json:\u0026#34;milestones\u0026#34;` } Регистрация роутов: Добавь группу milestone-роутов в роутер рядом с существующими роутами секций/задач. Проверка прав через существующий middleware.\nЭтап 3: Включение вех в ответ диаграммы Промт для агента:\nПри запросе данных диаграммы Ганта (полная загрузка) включай связанные вехи в ответ.\nДобавь эндпоинт или расширь существующий GET /api/gantt-charts/:chartId — включить поле milestones с массивом GanttMilestoneResponse Вехи с deleted_at IS NOT NULL не возвращаются Вехи сортируются по date ASC Вехи загружаются вместе с данными диаграммы (tasks, sections) — один запрос при открытии Ганта Frontend (Angular) Этап FE-1: Модели + Сервис Промт для агента:\nДобавь в проект поддержку вех (milestones) на диаграмме Ганта.\nВ pages/gantt/models/ (или соответствующем файле моделей) добавь: export interface GanttMilestone { id: string; gantt_chart_id: string; title: string; date: string; color: string; created_by_user?: { id: string; full_name: string }; updated_by_user?: { id: string; full_name: string }; created_at: string; updated_at: string; } export interface GanttMilestoneCreateRequest { title: string; date: string; color?: string; } export interface GanttMilestoneUpdateRequest { title?: string; date?: string; color?: string; } Добавь milestones: GanttMilestone[] в интерфейс/модель полной загрузки данных диаграммы\nСоздай сервис pages/gantt/services/gantt-milestone.service.ts:\nInject HttpClient Методы: getMilestones(chartId: string): Observable\u0026lt;GanttMilestone[]\u0026gt; createMilestone(chartId: string, data: GanttMilestoneCreateRequest): Observable\u0026lt;GanttMilestone\u0026gt; updateMilestone(chartId: string, milestoneId: string, data: GanttMilestoneUpdateRequest): Observable\u0026lt;GanttMilestone\u0026gt; deleteMilestone(chartId: string, milestoneId: string): Observable\u0026lt;void\u0026gt; Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService) Этап FE-2: Модальное окно управления вехами Промт для агента:\nСоздай компонент модального окна для управления вехами диаграммы Ганта.\nСоздай компонент pages/gantt/components/milestones-modal/\nКнопка вызова: Добавь кнопку «Вехи» рядом с кнопкой «Создать секцию» в toolbar диаграммы. По клику — открытие модального окна через ng-bootstrap NgbModal.\nМодальное окно (ng-bootstrap modal):\nЗаголовок: «Вехи проекта» Список вех (сортировка по date ASC): Каждый элемент: цветной кружок (color), название, дата (форматированная), кнопки ✏️ (редактировать) и 🗑️ (удалить с confirm) Кнопка «Добавить веху» внизу списка Если вех нет — сообщение «Вех пока нет. Добавьте первую!» Форма добавления/редактирования (inline в модальном окне):\nНазвание — текстовый ввод (обязательное) Дата — ng-bootstrap datepicker (обязательное) Цвет — палитра цветов (использовать тот же компонент/подход, что и для задач) По умолчанию цвет = #dc3545 (красный) Кнопки «Сохранить» и «Отмена» При сохранении — вызов соответствующего метода сервиса (create/update)\nПри удалении — confirm dialog → вызов deleteMilestone\nПосле любого изменения — обновить список вех и обновить данные на канвасе (через сервис/GanttStore)\nИнжектировать GanttMilestoneService и NgbModal\nЭтап FE-3: Отображение вех на таймлайне (Konva canvas) Промт для агента:\nОтобрази вехи (milestones) на canvas-диаграмме Ганта.\nПроект использует Konva.js для рендеринга.\nПри загрузке данных диаграммы — извлечь массив milestones\nДля каждой вехи нарисовать на canvas:\nМаркер-флажок (flag marker) на позиции даты вехи на шкале времени Стиль: маленький треугольник или флаг на верхней границе таймлайна Цвет = milestone.color Пунктирная вертикальная линия от маркера вниз через все секции (на всю высоту области секций) Стиль: Konva.Line, dash: [5, 5], strokeWidth: 1.5, color = milestone.color, opacity: 0.7 Позиционирование:\nРассчитать X-позицию по дате вехи с использованием текущей шкалы времени (как для задач) Если дата вехи выходит за текущий диапазон — расширить диапазон (влияет на общую ширину таймлайна) При изменении масштаба (days/weeks/months/quarters) — пересчитать позиции всех вех При скролле — вехи скроллятся вместе с задачами Tooltip при наведении:\nПри наведении на маркер или пунктирную линию — показать Konva.Tooltip или HTML tooltip: Если веха одна на эту дату — показать название Если несколько вех на одну дату — показать список: цветной кружок + название для каждой Z-index:\nЛинии вех рисуются поверх фона секций, но под задачами Маркеры-флажки — поверх всего (самый высокий z-index) Реактивность:\nПри добавлении/удалении/редактировании вехи — перерисовать только вехи (без полного ре рендера задач) Подписаться на изменения массива milestones через сервис/store Порядок реализации # Этап Сторона Зависимости 1 Миграция + Домен Backend — 2 CRUD вех Backend Этап 1 3 Включение вех в ответ диаграммы Backend Этап 2 4 Модели + Сервис Frontend — (параллельно с backend) 5 Модальное окно управления вехами Frontend Этапы 4 + backend 2 6 Отображение вех на таймлайне Frontend Этапы 4 + backend 3 ","section":"leadera","tags":["leadera","gantt","angular","go","api","ux"],"title":"Leadera: Вехи (Milestones) на диаграмме Ганта","url":"/leadera/leadera-milestones/"},{"content":"Бизнес-требования BR-1: Лимит одновременных задач (Concurrency Limit) У каждой секции появляется параметр max_concurrent_tasks (целое число ≥ 0, по умолчанию 0).\nПоведение:\nЕсли max_concurrent_tasks = 3 — в любой данный день в этой секции не может быть больше 3 активных задач одновременно Если max_concurrent_tasks = 0 — ограничение отключено, лимита нет Пересечение считается по дате: задача занимает дни с start_date по end_date включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день Ограничение работает только в рамках одной секции. Задачи из разных секций не влияют друг на друга Срабатывание при:\nСоздании задачи — если добавление нарушает лимит → Alert Перетаскивании задачи (drag) — если новая позиция нарушает лимит → Alert Растягивании задачи (resize) — если новый размер нарушает лимит → Alert Редактировании задачи (форма) — если изменённые даты нарушают лимит → Alert Важно: Действие НЕ отменяется. Задача создаётся/перемещается в любом случае, но пользователь видит предупреждение.\nТекст Alert: «В секции \u0026ldquo;[название секции]\u0026rdquo; на [дата/диапазон] превышен лимит одновременных задач (максимум: N)»\nBR-2: Блоки секций (Section Blocks) У каждой секции появляется набор блоков — особый вид записей, отображаемых на таймлайне как заштрихованные области.\nСущность GanttSectionBlock:\nПоле Тип Описание id UUID Идентификатор section_id UUID Принадлежность к секции title string Название (например: «Отпуск», «Командировка») start_date date Начало интервала (минимум 1 день) end_date date Конец интервала block_concurrency boolean Запрещать ли пересечение обычных задач с данным блоком Валидация:\nend_date не может быть раньше start_date Все поля обязательны Блок может быть в прошлом Визуальное отображение на Ганте:\nЗаштрихованная область на всю высоту секции (включая все строки задач в секции) Название блока отображается поверх штриховки с подложкой (для читаемости) Поведение block_concurrency:\nЕсли block_concurrency = true — при пересечении задачи с данным блоком показывается Alert (аналогично BR-1), но задача всё равно создаётся/перемещается Если block_concurrency = false — блок отображается визуально, но не влияет на задачи Срабатывание при:\nСоздании задачи — пересекает блок с block_concurrency = true → Alert Перетаскивании задачи (drag) → Alert Растягивании задачи (resize) → Alert Редактировании задачи (форма) → Alert Текст Alert: «В секции \u0026ldquo;[название секции]\u0026rdquo; задача пересекает блок \u0026ldquo;[название блока]\u0026rdquo; ([дата] — [дата])»\nBR-3: Система Alert-ов Все предупреждения (от BR-1 и BR-2) выводятся в единую область над диаграммой Ганта.\nПоведение:\nAlert-ы — Bootstrap Alert (warning), постоянные Пользователь НЕ может закрыть Alert вручную Alert исчезает автоматически, когда текущая дата прошла дату конфликта (конфликт больше не актуален) Проверка конфликтов — только на фронтенде (на основе загруженных данных: задачи секции, блоки, max_concurrent_tasks) Если Alert-ов много — область сворачиваемая с счётчиком в бейдже (например: «⚠️ 3 предупреждения») По умолчанию — развёрнуто Сворачивание/разворачивание — клик по заголовку области BR-4: Настройки секции Настройки совмещены с существующим модальным окном редактирования секции (не отдельное окно) Окно создания секции — добавляется:\nПоле «Макс. одновременных задач» (числовой ввод, 0 = без лимита, по умолчанию 0) Окно редактирования секции — добавляется:\nПоле «Макс. одновременных задач» (числовой ввод, 0 = без лимита) Список блоков (таблица/список с CRUD: добавить, редактировать, удалить) Сортировка: по start_date по убыванию (будущее сверху) Каждый блок — форма: title, start_date, end_date, block_concurrency (чекбокс: «Запретить пересечение задач») Валидация: end_date \u0026gt;= start_date, все поля заполнены BR-5: Наследование При появлении функционала копирования/дублирования диаграммы — настройки секций (лимит + блоки) наследуются Технические требования База данных Новая таблица: gantt_section_blocks CREATE TABLE gantt_section_blocks ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), section_id UUID NOT NULL REFERENCES gantt_sections(id) ON DELETE CASCADE, title VARCHAR(255) NOT NULL, start_date DATE NOT NULL, end_date DATE NOT NULL, block_concurrency BOOLEAN NOT NULL DEFAULT false, created_by UUID NOT NULL REFERENCES users(id), updated_by UUID NOT NULL REFERENCES users(id), created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(), deleted_at TIMESTAMP WITH TIME ZONE, CONSTRAINT chk_block_dates CHECK (end_date \u0026gt;= start_date) ); CREATE INDEX idx_gantt_section_blocks_section ON gantt_section_blocks(section_id); CREATE INDEX idx_gantt_section_blocks_dates ON gantt_section_blocks(start_date, end_date); Изменение таблицы: gantt_sections ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0; Backend (Go API) Этап 1: Миграция + Домен Промт для агента:\nДобавь в проект новую таблицу gantt_section_blocks и колонку max_concurrent_tasks в gantt_sections.\nСоздай миграцию в cmd/migrate/: Новая таблица gantt_section_blocks с полями: id (UUID PK), section_id (UUID FK → gantt_sections, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), start_date (DATE NOT NULL), end_date (DATE NOT NULL), block_concurrency (BOOLEAN DEFAULT false), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. CHECK constraint: end_date \u0026gt;= start_date. Индексы по section_id и (start_date, end_date). ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0. Создай доменную модель GanttSectionBlock в internal/domain/gantt.go со всеми полями таблицы. Добавь поле MaxConcurrentTasks int в структуру GanttSection. Обнови маппинг в relevant repository файлах, чтобы новое поле max_concurrent_tasks читалось/писалось. Этап 2: CRUD для GanttSectionBlocks Промт для агента:\nРеализуй полный CRUD для сущности GanttSectionBlock по аналогии с существующими handlers/services/repositories в проекте.\nРоуты (внутри группы секции):\nGET /api/gantt-charts/:chartId/sections/:sectionId/blocks — список блоков секции POST /api/gantt-charts/:chartId/sections/:sectionId/blocks — создать блок PUT /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId — обновить блок DELETE /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId — удалить блок (soft delete) Repository: internal/repository/gantt_section_block_repository.go\nGetBySectionID(ctx, sectionID) ([]domain.GanttSectionBlock, error) GetByID(ctx, id) (*domain.GanttSectionBlock, error) Create(ctx, block) error Update(ctx, block) error Delete(ctx, id) error — soft delete (set deleted_at) Все запросы — raw SQL через pgx, как в остальных репозиториях проекта Service: internal/service/gantt_section_block_service.go\nБизнес-логика: валидация dates (end \u0026gt;= start), проверка прав доступа к секции Inject repository Handler: internal/handler/gantt_section_block_handler.go\nSwagger-аннотации для всех эндпоинтов Валидация входных данных Ошибки в формате проекта (GanttErrorResponse) Модели запросов:\nCreate: title (required), start_date (required), end_date (required), block_concurrency (bool, default false) Update: title, start_date, end_date, block_concurrency — все опциональны Этап 3: Обновление настроек секции Промт для агента:\nОбнови CRUD секций (gantt_sections) для поддержки нового поля max_concurrent_tasks.\nДобавь max_concurrent_tasks в GanttSectionCreateRequest (опциональное, int ≥ 0, default 0) Добавь max_concurrent_tasks в GanttSectionUpdateRequest (опциональное, int ≥ 0) Обнови SQL-запросы в repository: INSERT и UPDATE должны включать max_concurrent_tasks При GET секции (или списке секций) — возвращать max_concurrent_tasks в ответе Валидация: значение должно быть ≥ 0 Этап 4: Включение блоков в ответ секций Промт для агента:\nПри запросе списка секций или одной секции включай связанные блоки в ответ.\nОбнови GET /api/gantt-charts/:chartId/sections/:sectionId — добавить поле blocks с массивом GanttSectionBlock Обнови GET /api/gantt-charts/:chartId/sections — добавить поле blocks для каждой секции Блоки с deleted_at IS NOT NULL не возвращаются Блоки сортируются по start_date по убыванию (будущее сверху) Frontend (Angular) Этап FE-1: Модели + Сервис Промт для агента:\nДобавь в проект поддержку ограничений секций Ганта.\nВ pages/gantt/models/gantt-chart.model.ts добавь: export interface GanttSectionBlock { id: string; section_id: string; title: string; start_date: string; end_date: string; block_concurrency: boolean; created_by_user: UserInfo; updated_by_user: UserInfo; created_at: string; updated_at: string; } export interface GanttSectionBlockCreateRequest { title: string; start_date: string; end_date: string; block_concurrency?: boolean; } export interface GanttSectionBlockUpdateRequest { title?: string; start_date?: string; end_date?: string; block_concurrency?: boolean; } export interface ConflictCheck { has_conflicts: boolean; conflicts: ConflictItem[]; } export interface ConflictItem { type: \u0026#39;concurrency\u0026#39; | \u0026#39;block\u0026#39;; section_id: string; section_title: string; block_title?: string; start_date?: string; end_date?: string; message: string; dates?: string[]; } Добавь max_concurrent_tasks: number в интерфейс GanttSection\nДобавь blocks: GanttSectionBlock[] в интерфейс GanttSection\nДобавь max_concurrent_tasks?: number в GanttSectionCreateRequest и GanttSectionUpdateRequest\nСоздай сервис pages/gantt/services/gantt-section-block.service.ts:\nInject HttpClient Методы: getBlocks(chartId, sectionId), createBlock(chartId, sectionId, data), updateBlock(chartId, sectionId, blockId, data), deleteBlock(chartId, sectionId, blockId) Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService) Этап FE-2: Интеграция в модальные окна секции Промт для агента:\nИнтегрируй настройки ограничений в существующие модальные окна создания и редактирования секции Ганта.\nНайди существующие компоненты модальных окон секции (создание/редактирование). Окно создания секции — добавить:\nЧисловой ввод: «Максимум одновременных задач» Подсказка: «0 = без ограничений» Валидация: число ≥ 0 Значение по умолчанию: 0 Отправляется в GanttSectionCreateRequest как max_concurrent_tasks Окно редактирования секции — добавить:\nЧисловой ввод: «Максимум одновременных задач» (аналогично созданию) Секция «Блоки (запретные интервалы)»: Таблица/список существующих блоков с колонками: Название, Начало, Конец, Блокировка (чекбокс/иконка), Действия (редактировать/удалить) Сортировка: по start_date по убыванию (будущее сверху) Кнопка «Добавить блок» — inline-форма: title (текстовый ввод, обязательный) start_date (datepicker, обязательный) end_date (datepicker, обязательный) block_concurrency (чекбокс: «Запретить пересечение задач») Валидация: end_date \u0026gt;= start_date, все поля заполнены Редактирование — inline или через ту же форму Удаление — с подтверждением При открытии окна редактирования — загрузить текущие настройки секции + блоки При сохранении — обновить max_concurrent_tasks и сохранить изменения блоков Инжектировать GanttChartService и GanttSectionBlockService Этап FE-3: Визуализация блоков на Ганте Промт для агента:\nОтобрази блоки секций (GanttSectionBlock) на canvas-диаграмме Ганта.\nПроект использует Konva.js для рендеринга. Основной компонент: gantt-chart-canvas.\nПри загрузке данных диаграммы — извлечь блоки из каждой секции В рендерере секций (canvas/timeline-renderer.ts или аналогичный) — для каждого блока: Нарисовать заштрихованную область (diagonal hatch pattern) на всю высоту секции (все строки задач в этой секции) Область ограничена по горизонтали: от start_date до end_date (в пикселях по шкале времени) Цвет штриховки: полупрозрачный серый или configurable Поверх штриховки — текст с названием блока (block.title) на подложке (прямоугольник с фоном, чтобы текст читался) Блоки рендерятся до задач (z-index ниже), чтобы задачи были поверх Блоки с block_concurrency = true и false визуально не отличаются (штриховка одинаковая) При скролле/зуме — блоки пересчитываются как обычные элементы таймлайна Этап FE-4: Система Alert-ов Промт для агента:\nСоздай компонент для отображения Alert-ов о конфликтах на диаграмме Ганта.\nСоздай компонент pages/gantt/components/gantt-conflict-alerts/\nКомпонент размещается над canvas-диаграммой Ганта\nВходные данные: массив ConflictItem[] (из модели)\nВизуал:\nBootstrap Alert (warning) для каждого конфликта Каждый Alert показывает message из ConflictItem Без кнопки закрытия — Alert нельзя закрыть вручную Alert исчезает автоматически, когда текущая дата прошла дату конфликта Область сворачиваемая: заголовок «⚠️ Предупреждения (N)» — клик сворачивает/разворачивает список По умолчанию — развёрнуто При 0 конфликтов — область скрыта Состояние хранится в сервисе или в компоненте диаграммы:\nДобавление нового конфликта → area auto-expands Alert удаляется из массива автоматически, когда текущая дата прошла дату конфликта Проверка актуальности конфликтов — при каждой отрисовке / изменении данных Не использовать toast — Alert-ы постоянные Этап FE-5: Проверка конфликтов при операциях с задачами Промт для агента:\nИнтегрируй проверку конфликтов во все операции с задачами на диаграмме Ганта.\nПроект использует interaction-handler.ts для drag/resize и формы для создания/редактирования.\nВажно: Проверка конфликтов — только на фронтенде, без вызова API. Используются загруженные данные секции (задачи, блоки, max_concurrent_tasks).\nВынеси логику проверки конфликтов checkConflicts() в отдельный метод в gantt-canvas.service.ts:\nПринимает: section (GanttSection — содержит max_concurrent_tasks и blocks), tasks (GanttTask[] — задачи секции), task_id (nullable — исключить текущую задачу), start_date, end_date Логика: a. Если section.max_concurrent_tasks \u0026gt; 0: посчитать кол-во задач (исключая task_id), пересекающихся с [start_date, end_date] на каждый день. Если в любой день count \u0026gt; max_concurrent_tasks — добавить конфликт concurrency b. Для каждого блока секции с block_concurrency = true, пересекающегося с [start_date, end_date] — добавить конфликт block Возвращает ConflictCheck После каждой успешной операции с задачей (создание, обновление, drag, resize):\nВызвать checkConflicts с параметрами задачи Если has_conflicts = true — передать конфликты в GanttConflictAlertsComponent Alert-ы показываются, действие НЕ отменяется Точки интеграции:\nСоздание задачи (форма): после успешного POST → checkConflicts → show alerts Редактирование задачи (форма): после успешного PUT → checkConflicts → show alerts Drag задачи (interaction-handler.ts): после успешного обновления позиции → checkConflicts → show alerts Resize задачи (interaction-handler.ts): после успешного обновления размера → checkConflicts → show alerts При переключении диаграммы или секции — очищать Alert-ы\nAlert-ы автоматически удаляются, когда текущая дата прошла дату конфликта — область скрывается, когда конфликтов не осталось\nПорядок реализации # Этап Сторона Зависимости 1 Миграция + Домен Backend — 2 CRUD блоков Backend Этап 1 3 Обновление настроек секции Backend Этап 1 4 Включение блоков в ответ секций Backend Этап 2 5 Модели + Сервис Frontend — (можно параллельно с backend) 6 Интеграция в модальные окна Frontend Этапы 5 + backend 2,3 7 Визуализация блоков на Ганте Frontend Этапы 5 + backend 4 8 Система Alert-ов Frontend Этап 5 9 Проверка конфликтов при операциях Frontend Этапы 5,7,8 ","section":"leadera","tags":["leadera","gantt","angular","go","api","ux"],"title":"Leadera: Ограничения секций в диаграмме Ганта","url":"/leadera/leadera-section-constraints/"}] \ No newline at end of file diff --git a/public/leadera/leadera-audit/index.html b/public/leadera/leadera-audit/index.html new file mode 100644 index 0000000..0315cfe --- /dev/null +++ b/public/leadera/leadera-audit/index.html @@ -0,0 +1,732 @@ + + + + + + Аудит Leadera — полный отчёт — docs.a2v.space + + + + + + + + + + +
                    + + + + +
                    + + +
                    +
                    + + + + +
                    + +
                    +

                    Аудит Leadera — полный отчёт

                    +
                    + + 📁 ~/Projects/docs-a2v/content/leadera/leadera-audit.md + + +
                    + + + +
                    + + audit + + leadera + + security + + architecture + +
                    + + +

                    Аудит проекта Leadera

                    +

                    Дата: 30.03.2026
                    +Версия: pre-production, миграции 1–5

                    +
                    +

                    1. Обзор проекта

                    +

                    Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.

                    +

                    Стек

                    + + + + + + + + + + + + + + + + + + + + + +
                    КомпонентТехнологии
                    BackendGo 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256)
                    FrontendAngular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals
                    ИнфраструктураDocker (Colima), pm2, nginx reverse proxy, VPS reg.ru
                    +

                    Доменная модель

                    +
                    User ──┬── Space (через space_members с role)
+        │
+        └── GanttChart (принадлежит Space)
+              ├── GanttSection
+              └── GanttTask
+

                    Роли: admin, editor, viewer — назначаются на уровне Space через таблицу space_members.

                    +

                    Что реализовано (endpoints)

                    +

                    Auth (5): register, login, refresh, change-password, logout
                    +Spaces (9): CRUD + members CRUD
                    +Gantt Charts (9): CRUD + archive + members (добавлен, но удалён в миграции 5)
                    +Gantt Sections (5): CRUD + reorder
                    +Gantt Tasks (4): CRUD

                    +

                    Итого: ~32 endpoint

                    +
                    +

                    2. Архитектура и качество кода

                    +

                    2.1. Backend — структура

                    +
                    cmd/server/main.go        — точка входа
+internal/
+  domain/                  — модели (User, Space, GanttChart, etc.)
+  dto/                     — request/response DTO (auth, space, gantt)
+  handlers/                — HTTP handlers (auth, space, gantt)
+  middleware/              — auth, cors, space, gantt, role, logging, recovery
+  repository/              — слой доступа к данным
+  service/                 — бизнес-логика
+  config/                  — конфигурация (.env)
+  utils/                   — jwt, password, response, validation
+migrations/                — SQL миграции (1-5)
+

                    Оценка: ✅ Чистая layered архитектура. Разделение ответственности чёткое.

                    +

                    2.2. Frontend — структура

                    +
                    src/app/
+  core/auth/               — auth service, interceptor
+  core/models/             — app.model, space.model
+  core/services/           — space.service, space-storage.service
+  pages/auth/              — sign-in, sign-up, reset-pw, etc.
+  pages/gantt/             — компоненты, модалки, сервисы, модели
+  pages/dashboards/        — spaces list, dashboard
+  layouts/                 — navbar, topbar, main-layout
+

                    Оценка: ✅ Стандартная Angular-структура. Signals для state management.

                    +

                    2.3. Проблемы кода

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    #ПроблемаКритичностьОписание
                    C1\r в service-файлахMediumgantt_service.go, gantt_section_service.go содержат CRLF
                    C2main.go:238 — мёртвый код getUserHandlerLowНеиспользуемая функция
                    C3Swagger не сгенерированMediumАннотации есть, но api/ директории нет
                    C4RegisterProtectedRoutes не вызывается в main.goCriticalGET/PUT/DELETE /spaces/:id не зарегистрированы
                    +
                    +

                    3. Права доступа — главный вопрос

                    +

                    3.1. Текущая реализация

                    +

                    Права назначаются исключительно через Space:

                    +
                      +
                    1. Таблица space_members — связка user ↔ space с role (admin/editor/viewer)
                      2. +
                    2. SpaceMiddleware.RequireSpace() — проверяет членство и записывает ContextSpaceRole в context
                      3. +
                    3. RoleMiddleware.RequireMinRole() — проверяет иерархию ролей (admin > editor > viewer)
                      4. +
                    +

                    Диаграммы Ганта НЕ имеют собственной системы ролей. Таблица gantt_chart_members была создана (миграция 4) и тут же удалена (миграция 5). Все проверки доступа к диаграммам идут через space membership.

                    +

                    3.2. Как это работает

                    +
                    Запрос → AuthMiddleware (JWT → userID)
+       → SpaceMiddleware.RequireSpace() (проверяет space_members → ContextSpaceRole)
+       → GanttMiddleware.RequireGanttChart() (проверяет chart.space_id == spaceID)
+       → RoleMiddleware.RequireMinRole("editor") (проверяет ContextSpaceRole)
+

                    Это правильно. Любой член Space с ролью editor+ может создавать/редактировать диаграммы. Viewers — только читать.

                    +

                    3.3. 🔴 Критическая проблема: Frontend не соответствует Backend

                    +

                    Frontend MembersModalComponent пытается управлять участниками диаграммы:

                    +
                      +
                    • ganttService.addMember(chartId, dto) → /api/v1/spaces/{spaceId}/gantt-charts/{chartId}/members
                      • +
                    • ganttService.updateMemberRole(chartId, userId, dto) → .../members/{userId}
                      • +
                    • ganttService.removeMember(chartId, userId) → .../members/{userId}
                      • +
                    +

                    Backend GanttHandler.RegisterRoutes() НЕ регистрирует маршруты для members диаграмм. После удаления gantt_chart_members (миграция 5) эти endpoints не существуют.

                    +

                    Результат: модальное окно «Участники диаграммы» на фронтенде не работает — все вызовы вернут 404.

                    +

                    3.4. 🔴 Проблема: Role fallback

                    +

                    В role_middleware.go:28-31:

                    +
                    role := c.GetString(ContextSpaceRole)
+if role == "" {
+    role = c.GetString(ContextRole) // fallback на глобальную роль User
+}
+

                    Если ContextSpaceRole не установлен, используется глобальная роль пользователя (из JWT). Это значит:

                    +
                      +
                    • Пользователь с role=admin в таблице users получит admin-доступ к любому space, даже если он не член этого space
                      • +
                    • Но SpaceMiddleware проверяет членство раньше, так что в цепочке RequireSpace() → RequireMinRole() это не эксплуатируется
                      • +
                    • Однако если RequireMinRole() используется без RequireSpace() — это дыра
                      • +
                    +

                    Рекомендация: Удалить fallback на ContextRole. Если ContextSpaceRole пуст — отказывать.

                    +

                    3.5. Рекомендации по правам доступа

                    +
                      +
                    1. Удалить модалку участников диаграммы на фронтенде — она мертва
                      2. +
                    2. Или добавить раздел «Участники Space» с возможностью управления ролями через /spaces/:space_id/members (эти endpoints работают)
                      3. +
                    3. Удалить fallback на ContextRole в role_middleware.go
                      4. +
                    4. Добавить проверку: editor не может повысить кого-то до admin (сейчас может — AddMember разрешает editor+ назначать любую роль)
                      5. +
                    +
                    +

                    4. Безопасность

                    +

                    4.1. Критические

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    #ПроблемаФайлОписание
                    S1JWT Secret = test.envJWT_SECRET=test_secret_key_change_in_production — это прод-конфиг!
                    S2CORS: *.envCORS_ALLOWED_ORIGINS=* — любой домен может обращаться к API
                    S3Пароль БД в .env.envDB_PASSWORD=popoloka16 — creds в открытом виде
                    S4Refresh tokens: SHA256utils/password.goSHA256 вместо bcrypt для refresh token hash — быстро брутфорсится
                    +

                    4.2. Высокие

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    #ПроблемаОписание
                    S5Нет rate limitingBrute-force на /auth/login без ограничений
                    S6Нет CSRF protectionAPI принимает POST/PUT/DELETE без CSRF-токена
                    S7Нет CSP заголовковX-Frame-Options, Content-Security-Policy не настроены
                    S8JWT в localStorageXSS может украсть access + refresh tokens
                    +

                    4.3. Средние

                    + + + + + + + + + + + + + + + + + + + + + + + + + +
                    #ПроблемаОписание
                    S9Нет password policyМинимальные требования к паролю не enforced
                    S10Нет audit logДействия с spaces/charts не логируются для аудита
                    S11Нет блокировки аккаунтаНеограниченные попытки входа
                    +
                    +

                    5. Инфраструктура

                    +

                    5.1. Текущее состояние

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    КомпонентСтатусПримечание
                    Go API (pm2: leadera-api)⚠️Порт 8080, хост 0.0.0.0
                    Angular FE (pm2: leadera-fe)⚠️Порт 4200, хост 0.0.0.0
                    PostgreSQL (Docker)✅Порт 5432, контейнер app-leadera-db
                    VPS reverse proxy⚠️sand.a2v.space → 8082/8083, но 502 если сервисы не запущены
                    SSL✅Let’s Encrypt на VPS
                    +

                    5.2. Проблемы

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    #ПроблемаОписание
                    I1Docker для БД, нативно для APIНесогласованность — API и FE не в Docker
                    I2Нет health-check в pm2API может упасть без перезапуска
                    I3Нет CI/CDРучной деплой через make run + pm2
                    I4Нет nginx на Mac StudioFE и API торчат наружу напрямую
                    +
                    +

                    6. Функциональная оценка

                    +

                    6.1. Что работает

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ФункцияBackendFrontendСтатус
                    Регистрация/логин✅✅Работает
                    JWT auth + refresh✅✅Работает
                    Spaces CRUD⚠️✅RegisterProtectedRoutes не вызван (C4)
                    Space members✅✅Работает
                    Gantt charts CRUD✅✅Работает
                    Gantt sections✅✅Работает
                    Gantt tasks✅⚠️Нет UI для задач внутри диаграммы
                    Архивация диаграмм✅✅Работает
                    Members диаграммы❌✅ (мёртвый UI)Backend endpoints не существуют
                    +

                    6.2. Что НЕ работает или отсутствует

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ФункцияСтатус
                    Визуализация Ганта (таймлайн)❌ Нет компонента отрисовки
                    Drag & Drop задач❌
                    Real-time collaboration❌
                    Уведомления❌
                    Поиск❌
                    Экспорт (PDF/Excel)❌
                    Email verification❌
                    Password resetBackend есть, UI есть — не проверено
                    +

                    6.3. Оценка готовности

                    +

                    Система на стадии каркаса. Backend API функционален для CRUD операций, но:

                    +
                      +
                    • Визуализация Ганта — основная фича — не реализована (нет canvas/SVG рендеринга)
                      • +
                    • Управление участниками только на уровне Space
                      • +
                    • Нет CI/CD, тестов, мониторинга
                      • +
                    +
                    +

                    7. Приоритизированный план исправлений

                    +

                    Неделя 1 — Критическое (безопасность)

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ПриоритетЗадачаТрудоёмкость
                    P0Заменить JWT secret на криптостойкий1 час
                    P0Настроить CORS (только sand.a2v.space)1 час
                    P0bcrypt для refresh tokens вместо SHA2562 часа
                    P0Удалить fallback на ContextRole в role_middleware30 мин
                    P0Исправить RegisterProtectedRoutes — зарегистрировать маршруты1 час
                    P1Rate limiting на auth endpoints4 часа
                    P1Editor не может назначать admin роль2 часа
                    +

                    Неделя 2 — Архитектура прав

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ПриоритетЗадачаТрудоёмкость
                    P1Удалить/переписать MembersModalComponent → Space members4 часа
                    P1Добавить страницу управления участниками Space8 часов
                    P2HttpOnly cookies для JWT (вместо localStorage)8 часов
                    P2CSRF protection4 часа
                    +

                    Неделя 3 — Функциональность

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ПриоритетЗадачаТрудоёмкость
                    P2Визуализация Ганта (canvas/d3)40+ часов
                    P2Drag & Drop для задач16 часов
                    P3Тесты (unit + integration)24 часа
                    P3CI/CD pipeline8 часов
                    +
                    +

                    8. Резюме

                    +

                    Ключевые выводы

                    +
                      +
                    1. Права доступа — архитектурно верно: роль назначается через Space, не через диаграмму. Но фронтенд ещё не обновлён после удаления gantt_chart_members.
                      2. +
                    2. Безопасность — критические уязвимости в конфигурации (JWT secret, CORS, bcrypt). Требуют немедленного исправления до любого публичного деплоя.
                      3. +
                    3. Функциональность — CRUD работает, но основная ценность (визуализация Ганта) не реализована.
                      4. +
                    4. Код — чистый, хорошая архитектура, но есть мёртвый код и незарегистрированные маршруты.
                      5. +
                    +

                    Общая оценка: 🔴 Pre-alpha

                    +

                    Проект готов к внутренней демонстрации CRUD, но не готов к продакшену. Первоочередное — безопасность и исправление мёртвых endpoints.

                    + +
                    + +
                    +
                    +
                    + +
                    +
                    +

                    © 2026 docs.a2v.space

                    +
                    +
                    + + + + + + + + + + + + + + + diff --git a/public/leadera/leadera-gantt-excel-export/index.html b/public/leadera/leadera-gantt-excel-export/index.html new file mode 100644 index 0000000..4bfdba7 --- /dev/null +++ b/public/leadera/leadera-gantt-excel-export/index.html @@ -0,0 +1,262 @@ + + + + + + Leadera — Экспорт диаграммы Ганта в Excel — docs.a2v.space + + + + + + + + + + +
                    + + + + +
                    + + +
                    +
                    + + + + +
                    + +
                    +

                    Leadera — Экспорт диаграммы Ганта в Excel

                    +
                    + + 📁 ~/Projects/docs-a2v/content/leadera/leadera-gantt-excel-export.md + + +
                    + + + +
                    + + leadera + + gantt + + excel + + export + +
                    + + +

                    Экспорт диаграммы Ганта в Excel

                    +

                    Дата: 09.04.2026 +Статус: Требования +Проект: Leadera

                    +
                    +

                    Общее описание

                    +

                    Пользователь нажимает кнопку экспорта в интерфейсе диаграммы Ганта. Система запрашивает диапазон дат выгрузки (по умолчанию — текущий видимый диапазон из интерфейса). После указания диапазона скачивается Excel-файл с визуальным представлением диаграммы Ганта.

                    +
                    +

                    Вводные данные

                    +
                      +
                    • Источник: текущая диаграмма Ганта проекта (один проект = одна диаграмма)
                      • +
                    • Диапазон дат: пользователь указывает начальную и конечную дату. По умолчанию подставляется видимый в момент запроса диапазон из интерфейса
                      • +
                    • Масштаб таймлайна: берётся тот, который выбран пользователем в интерфейсе в момент запроса (не сохранённый в системе, а текущий). Варианты: по ячейкам или по дням
                      • +
                    +
                    +

                    Структура Excel-файла

                    +

                    Шапка (первые строки)

                    +
                      +
                    • Название диаграммы (название проекта)
                      • +
                    • Диапазон дат, в рамках которого сделана выгрузка
                      • +
                    +

                    Лист — один

                    +

                    Вся диаграмма размещается на одном листе.

                    +

                    Секции

                    +
                      +
                    • Секции отображаются как визуальная группировка строк (не отдельные листы)
                      • +
                    • Название секции — строка-заголовок над группой задач
                      • +
                    +

                    Задачи

                    +

                    Каждая задача — отдельная строка. Данные задачи:

                    +
                      +
                    • Название (текстовая колонка слева)
                      • +
                    • Дата начала (текстовая колонка слева)
                      • +
                    • Дата конца (текстовая колонка слева)
                      • +
                    • Цвет — ячейки таймлайна, соответствующие задаче, закрашены в цвет задачи
                      • +
                    +

                    Таймлайн

                    +
                      +
                    • Таймлайн представлен колонками дат в верхней части (горизонтальная ось времени)
                      • +
                    • Масштаб колонок соответствует выбранному пользователем в момент экспорта (по ячейкам / по дням)
                      • +
                    • Задачи отображаются как merged cells по соответствующим колонкам дат — визуальная полоса диаграммы Ганта
                      • +
                    +

                    Вехи

                    +
                      +
                    • Отображаются отдельной строкой (как задача, но с маркировкой вехи)
                      • +
                    • Позиционируются на соответствующей дате в таймлайне
                      • +
                    +

                    Зависимости

                    +
                      +
                    • Не отображаются (стрелочки/связи между задачами не нужны)
                      • +
                    +
                    +

                    Пользовательский сценарий

                    +
                      +
                    1. Пользователь открывает диаграмму Ганта проекта
                      2. +
                    2. Настраивает масштаб таймлайна (по ячейкам / по дням)
                      3. +
                    3. Нажимает кнопку «Экспорт в Excel»
                      4. +
                    4. Система показывает диалог с выбором диапазона дат (предзаполнен текущим видимым диапазоном)
                      5. +
                    5. Пользователь подтверждает / корректирует диапазон
                      6. +
                    6. Система генерирует Excel-файл и инициирует скачивание
                      7. +
                    +
                    +

                    Технические требования

                    +

                    Backend (Go API)

                    +
                      +
                    • Новый endpoint для генерации Excel (например, GET /api/v1/gantt/:projectId/export)
                      • +
                    • Query-параметры: dateFrom, dateTo, scale (cell|day)
                      • +
                    • Ответ: binary Excel-файл (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet)
                      • +
                    • Авторизация: обязательна (только участники проекта)
                      • +
                    • Библиотека для генерации Excel: excelize (Go)
                      • +
                    +

                    Frontend (Angular)

                    +
                      +
                    • Кнопка экспорта в тулбаре диаграммы Ганта
                      • +
                    • Модальное окно выбора диапазона дат с datepicker’ами
                      • +
                    • Предзаполнение диапазона из текущего видимого viewport’а
                      • +
                    • Скачивание файла через Blob / saveAs
                      • +
                    +

                    Фильтрация данных

                    +
                      +
                    • Выгружаются все задачи и вехи, которые: +
                        +
                      • Начинаются в диапазоне, ИЛИ
                        • +
                      • Заканчиваются в диапазоне, ИЛИ
                        • +
                      • Начинаются до диапазона и заканчиваются после (перекрывают целиком)
                        • +
                      +
                      • +
                    • Секции включаются, если в них есть хотя бы одна попавшая задача
                      • +
                    +
                    +

                    Открытые вопросы

                    +

                    (Нет)

                    + +
                    + +
                    +
                    +
                    + +
                    +
                    +

                    © 2026 docs.a2v.space

                    +
                    +
                    + + + + + + + + + + + + + + + diff --git a/public/leadera/leadera-gantt-filters/index.html b/public/leadera/leadera-gantt-filters/index.html new file mode 100644 index 0000000..a9c6d8d --- /dev/null +++ b/public/leadera/leadera-gantt-filters/index.html @@ -0,0 +1,463 @@ + + + + + + Leadera — Фильтры и реорганизация списка диаграмм Ганта — docs.a2v.space + + + + + + + + + + +
                    + + + + +
                    + + +
                    +
                    + + + + +
                    + +
                    +

                    Leadera — Фильтры и реорганизация списка диаграмм Ганта

                    +
                    + + 📁 ~/Projects/docs-a2v/content/leadera/leadera-gantt-filters.md + + +
                    + + + +
                    + + leadera + + gantt + + api + + frontend + + requirements + +
                    + + +

                    Фильтры и реорганизация списка диаграмм Ганта

                    +

                    Дата: 07.04.2026 +Статус: Требования +Проект: Leadera (dev — sand.a2v.space)

                    +
                    +

                    1. Постановка задачи

                    +

                    Список диаграмм Ганта должен показывать все доступные пользователю диаграммы из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.

                    +
                    +

                    2. Изменения API

                    +

                    2.1. Новый endpoint списка диаграмм

                    +

                    Было:

                    +
                    GET /api/v1/spaces/{spaceId}/gantt-charts?page=1&per_page=10
+

                    Стало:

                    +
                    GET /api/v1/gantt-charts?page=1&per_page=10
+

                    Пользователь видит все диаграммы из всех пространств, где он является подтверждённым участником (статус accepted).

                    +

                    2.2. Параметры фильтрации и поиска

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ПараметрТипОписание
                    pageintНомер страницы (default: 1)
                    per_pageintЗаписей на странице (default: 10)
                    space_idUUID (optional)Фильтр по конкретному пространству
                    created_byUUID (optional)Фильтр по создателю диаграммы
                    searchstring (optional)Поиск по назвению и описанию (ILIKE, case-insensitive)
                    sortstring (optional)Сортировка: created_at, updated_at, title (default: updated_at)
                    orderstring (optional)asc / desc (default: desc)
                    +

                    Примеры:

                    +
                    GET /api/v1/gantt-charts?search=миграция
+GET /api/v1/gantt-charts?space_id=0b334ded-...&created_by=a1b2c3d4-...
+GET /api/v1/gantt-charts?page=2&per_page=20&sort=title&order=asc
+

                    2.3. Изменение структуры ответа

                    +

                    Добавить поле space в каждую диаграмму:

                    +
                    {
+  "data": [
+    {
+      "id": "uuid",
+      "title": "Миграция backend",
+      "description": "...",
+      "created_by": "uuid",
+      "created_by_name": "Антон Агальцов",
+      "created_at": "2026-04-01T10:00:00Z",
+      "updated_at": "2026-04-07T09:00:00Z",
+      "space": {
+        "id": "uuid",
+        "name": "IT Ландшафт",
+        "color": "#c4623a"
+      },
+      "is_archived": false
+    }
+  ],
+  "pagination": {
+    "page": 1,
+    "per_page": 10,
+    "total": 42,
+    "total_pages": 5
+  }
+}
+

                    2.4. Endpoint для списка фильтров

                    +

                    Вспомогательный endpoint для заполнения dropdown-фильтров:

                    +
                    GET /api/v1/gantt-charts/filters
+

                    Ответ:

                    +
                    {
+  "spaces": [
+    { "id": "uuid", "name": "IT Ландшафт", "color": "#c4623a" },
+    { "id": "uuid", "name": "DevOps", "color": "#27ae60" }
+  ],
+  "creators": [
+    { "id": "uuid", "display_name": "Антон Агальцов" },
+    { "id": "uuid", "display_name": "Иван Петров" }
+  ]
+}
+

                    Логика creators: уникальные создатели всех диаграмм, доступных текущему пользователю. Получается через DISTINCT-запрос по created_by с JOIN на users.

                    +

                    2.5. Backend — изменения в Go

                    +

                    Файлы для изменения:

                    +

                    internal/handlers/gantt_handler.go

                    +
                      +
                    • Добавить новый handler ListAllGanttCharts — без привязки к space
                      • +
                    • Зарегистрировать маршрут GET /gantt-charts (без /spaces/:id/)
                      • +
                    • Парсить query-параметры: space_id, created_by, search, sort, order
                      • +
                    • Старый маршрут GET /spaces/:id/gantt-charts — оставить для обратной совместимости (или удалить, если не используется)
                      • +
                    +

                    internal/service/gantt_service.go

                    +
                      +
                    • Новый метод ListAll(ctx, userId, filters) — запрашивает все spaces пользователя (через space_member с status=accepted), затем выбирает все gantt_charts из этих spaces с фильтрами
                      • +
                    +

                    internal/repository/gantt_repository.go

                    +
                      +
                    • Новый метод с динамическим SQL: +
                        +
                      • Базовый JOIN: gantt_charts → spaces → space_members
                        • +
                      • WHERE: space_members.user_id = $1 AND space_members.status = 'accepted'
                        • +
                      • Опциональные фильтры: AND space_id = $N, AND created_by = $N, AND (title ILIKE '%' || $N || '%' OR description ILIKE '%' || $N || '%')
                        • +
                      • Возвращать поле space (id, name, color) через JOIN
                        • +
                      +
                      • +
                    +

                    internal/dto/gantt/

                    +
                      +
                    • Новые DTO: GanttChartListFilters, GanttChartWithSpaceResponse, GanttFiltersResponse
                      • +
                    +

                    SQL (пример):

                    +
                    SELECT gc.*, s.id as space_id, s.name as space_name, s.color as space_color,
+       u.display_name as created_by_name
+FROM gantt_charts gc
+JOIN spaces s ON s.id = gc.space_id
+JOIN space_members sm ON sm.space_id = s.id
+LEFT JOIN users u ON u.id = gc.created_by
+WHERE sm.user_id = $1
+  AND sm.status = 'accepted'
+  AND ($2::uuid IS NULL OR gc.space_id = $2)
+  AND ($3::uuid IS NULL OR gc.created_by = $3)
+  AND ($4::text IS NULL OR gc.title ILIKE '%' || $4 || '%'
+       OR gc.description ILIKE '%' || $4 || '%')
+ORDER BY
+  CASE WHEN $5 = 'title' THEN gc.title END,
+  CASE WHEN $5 = 'created_at' THEN gc.created_at::text END,
+  gc.updated_at DESC
+LIMIT $6 OFFSET $7;
+
                    +

                    3. Изменения Frontend (Angular)

                    +

                    3.1. Toolbar фильтров

                    +

                    Добавить toolbar над списком диаграмм:

                    +
                    ┌──────────────────────────────────────────────────────────────────┐
+│ [🔍 Поиск...                              ] [▼ Пространство]    │
+│ [▼ Создатель]  [▼ Сортировка]  [Сбросить фильтры]               │
+└──────────────────────────────────────────────────────────────────┘
+

                    Компоненты:

                    +
                      +
                    • Строка поиска — input с debounce (300ms), поиск по назвению и описанию
                      • +
                    • Dropdown «Пространство» — список из /gantt-charts/filters, с цветовой меткой
                      • +
                    • Dropdown «Создатель» — список уникальных создателей
                      • +
                    • Dropdown «Сортировка» — по дате обновления, дате создания, названию
                      • +
                    • Кнопка «Сбросить» — очищает все фильтры
                      • +
                    +

                    Состояние фильтров в URL (query params):

                    +
                    /gantt?search=миграция&space_id=xxx&sort=updated_at
+

                    Это позволяет делиться ссылкой с уже настроенными фильтрами.

                    +

                    3.2. Карточка диаграммы — бейдж пространства

                    +

                    На каждой карточке добавить бейдж с названием пространства:

                    +
                    ┌─────────────────────────────────────┐
+│  🟠 IT Ландшафт                     │  ← бейдж с цветом пространства
+│  Миграция backend                   │
+│  Перевод PHP→Go, этап 2             │
+│  Создал: Антон А. · 07.04.2026     │
+└─────────────────────────────────────┘
+

                    3.3. Форма создания диаграммы — выбор пространства

                    +

                    В модальном окне создания:

                    +
                      +
                    • Dropdown со списком пространств, где пользователь имеет роль editor или выше
                      • +
                    • Валидация: если пользователь не editor ни в одном пространстве — показать сообщение «Нет доступных пространств для создания»
                      • +
                    +

                    Запрос доступных пространств: переиспользовать существующий GET /api/v1/spaces с фильтрацией на клиенте по role ∈ [owner, admin, editor], либо добавить параметр ?min_role=editor на backend.

                    +

                    3.4. Изменение routing

                    +

                    Было:

                    +
                    /gantt → список гантов текущего пространства
+

                    Стало:

                    +
                    /gantt → список всех доступных гантов (из всех пространств)
+

                    Убрать зависимость от SpaceStorageService.getSelectedSpaceId() в списке гантов.

                    +

                    3.5. Frontend — файлы для изменения

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ФайлИзменение
                    pages/gantt/services/gantt.service.tsНовый метод listAll(filters), getFilters()
                    pages/gantt/gantt.component.tsПодключить toolbar, парсинг URL-параметров
                    pages/gantt/gantt.component.htmlДобавить toolbar, бейджи на карточках
                    pages/gantt/components/gantt-card/Добавить бейдж пространства
                    pages/gantt/components/create-chart-modal/Dropdown выбора пространства
                    core/models/Обновить модели: добавить space в GanttChart
                    +
                    +

                    4. Обратная совместимость

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    EndpointСтатус
                    GET /api/v1/spaces/{id}/gantt-chartsСохранить (для детального view внутри пространства)
                    GET /api/v1/gantt-chartsНовый — глобальный список
                    GET /api/v1/gantt-charts/filtersНовый — данные для dropdown’ов
                    POST /api/v1/spaces/{id}/gantt-chartsСохранить (создание в контексте пространства)
                    Все CRUD для sections/tasksБез изменений
                    +
                    +

                    5. Критерии приёмки

                    +
                      +
                    • Endpoint GET /api/v1/gantt-charts возвращает все доступные диаграммы
                      • +
                    • Фильтр по space_id — показывает только диаграммы конкретного пространства
                      • +
                    • Фильтр по created_by — показывает только диаграммы выбранного создателя
                      • +
                    • Поиск search — ищет по title и description (case-insensitive)
                      • +
                    • Dropdown фильтров заполняется реальными данными из /filters
                      • +
                    • Карточка диаграммы показывает бейдж пространства с цветом
                      • +
                    • Форма создания предлагает только пространства с ролью ≥ editor
                      • +
                    • Состояние фильтров сохраняется в URL (можно поделиться ссылкой)
                      • +
                    • Старые endpoints (/spaces/{id}/gantt-charts) продолжают работать
                      • +
                    • Swagger документация обновлена
                      • +
                    +
                    +

                    6. Порядок реализации

                    +
                      +
                    1. Backend: DTO для новых запросов/ответов
                      2. +
                    2. Backend: Repository — SQL-запрос с фильтрами + JOIN на spaces
                      3. +
                    3. Backend: Service — ListAll, GetFilters
                      4. +
                    4. Backend: Handler — ListAllGanttCharts, GetGanttFilters, регистрация маршрутов
                      5. +
                    5. Backend: Swagger — обновить документацию
                      6. +
                    6. Frontend: Модели — обновить GanttChart, добавить Space в ответ
                      7. +
                    7. Frontend: Service — listAll(), getFilters()
                      8. +
                    8. Frontend: Toolbar компонент — поиск + dropdown’ы
                      9. +
                    9. Frontend: Карточка — бейдж пространства
                      10. +
                    10. Frontend: Модальное окно создания — dropdown пространства
                      11. +
                    11. Frontend: URL-параметры — синхронизация фильтров с router
                      12. +
                    12. Тестирование
                      13. +
                    + +
                    + +
                    +
                    +
                    + +
                    +
                    +

                    © 2026 docs.a2v.space

                    +
                    +
                    + + + + + + + + + + + + + + + diff --git a/public/leadera/leadera-gantt-public-access/index.html b/public/leadera/leadera-gantt-public-access/index.html new file mode 100644 index 0000000..d290565 --- /dev/null +++ b/public/leadera/leadera-gantt-public-access/index.html @@ -0,0 +1,298 @@ + + + + + + Leadera — Публичный доступ к диаграмме Ганта — docs.a2v.space + + + + + + + + + + +
                    + + + + +
                    + + +
                    +
                    + + + + +
                    + +
                    +

                    Leadera — Публичный доступ к диаграмме Ганта

                    +
                    + + 📁 ~/Projects/docs-a2v/content/leadera/leadera-gantt-public-access.md + + +
                    + + + +
                    + + leadera + + gantt + + public-access + + sharing + +
                    + + +

                    Публичный доступ к диаграмме Ганта (Share)

                    +

                    Дата: 09.04.2026 +Статус: Требования +Проект: Leadera

                    +
                    +

                    Общее описание

                    +

                    Пользователь может создать публичную ссылку на фрагмент диаграммы Ганта, доступную для просмотра без авторизации. Открывший ссылку видит диаграмму в read-only режиме с возможностью масштабирования таймлайна, но без каких-либо элементов управления (создание, редактирование, удаление задач/секций/вех).

                    +
                    +

                    Пользовательский сценарий (создатель ссылки)

                    +
                      +
                    1. Пользователь открывает диаграмму Ганта проекта
                      2. +
                    2. Нажимает кнопку «Экспорт» / «Общий доступ»
                      3. +
                    3. Указывает диапазон дат, который должен отображаться на диаграмме
                      4. +
                    4. Система генерирует уникальную ссылку (UUID) и показывает её пользователю
                      5. +
                    5. Пользователь копирует ссылку и передаёт заинтересованным лицам
                      6. +
                    +

                    Управление ссылками

                    +
                      +
                    • Вызывается через меню экспорта → модальное окно «Общий доступ»
                      • +
                    • В модальном окне отображается список созданных ссылок с указанием диапазона дат
                      • +
                    • Каждую ссылку можно удалить (полное удаление из БД, не soft delete)
                      • +
                    • Ссылки нельзя редактировать — только создавать и удалять
                      • +
                    • Ограничений на количество активных ссылок нет
                      • +
                    • Статистика просмотров (сколько раз открывали) — не нужна
                      • +
                    +
                    +

                    Пользовательский сценарий (зритель по ссылке)

                    +
                      +
                    1. Зритель переходит по ссылке (без авторизации)
                      2. +
                    2. Открывается отдельная страница с диаграммой Ганта
                      3. +
                    3. Зритель видит: +
                        +
                      • Задачи и вехи, попадающие в заданный диапазон
                        • +
                      • Секции (заголовки группировок)
                        • +
                      • Таймлайн с цветовой раскраской задач
                        • +
                      +
                      4. +
                    4. Зритель может: +
                        +
                      • Масштабировать таймлайн
                        • +
                      • Переключать отображение «по ячейкам» / «по дням»
                        • +
                      +
                      5. +
                    5. Зритель не может: +
                        +
                      • Создавать, редактировать, удалять задачи / секции / вехи
                        • +
                      • Видеть любые контролы управления (кнопки создания, контекстные меню, drag-and-drop и т.д.)
                        • +
                      • Авторизоваться через эту страницу
                        • +
                      +
                      6. +
                    +
                    +

                    Данные и фильтрация

                    +

                    Что попадает в представление

                    +

                    Задачи и вехи, у которых хотя бы одно из условий верно:

                    +
                      +
                    • Дата начала попадает в диапазон ссылки
                      • +
                    • Дата конца попадает в диапазон ссылки
                      • +
                    • Задача начинается до диапазона и заканчивается после (полностью перекрывает)
                      • +
                    +

                    Секции включаются, если в них есть хотя бы одна попавшая задача.

                    +

                    API возвращает

                    +
                      +
                    • Только задачи и вехи, попадающие в диапазон (не всю диаграмму)
                      • +
                    • Информацию о секциях, содержащих попавшие задачи
                      • +
                    • Минимальный набор полей, необходимый для отрисовки (без внутренних ID пользователей и т.п.)
                      • +
                    +
                    +

                    Технические требования

                    +

                    Ссылки

                    +
                      +
                    • Формат: UUID v4 (каждый раз новый)
                      • +
                    • Срок действия: бессрочно (пока не удалена)
                      • +
                    • Удаление: жёсткое (hard delete из БД)
                      • +
                    +

                    Backend (Go API)

                    + +
                      +
                    • id (UUID, PK)
                      • +
                    • project_id (FK → projects)
                      • +
                    • date_from (date)
                      • +
                    • date_to (date)
                      • +
                    • created_by (FK → users)
                      • +
                    • created_at (timestamp)
                      • +
                    +

                    Endpoints

                    +
                      +
                    • POST /api/v1/gantt/:projectId/public-links — создать ссылку (авторизован, участник проекта) +
                        +
                      • Body: { dateFrom, dateTo }
                        • +
                      • Response: { url: "https://leadera.pro/share/<uuid>" }
                        • +
                      +
                      • +
                    • GET /api/v1/gantt/:projectId/public-links — список ссылок проекта (авторизован, участник)
                      • +
                    • DELETE /api/v1/gantt/public-links/:uuid — удалить ссылку (авторизован, создатель)
                      • +
                    • GET /api/v1/public/gantt/:uuid — получить данные диаграммы по ссылке (без авторизации) +
                        +
                      • Response: задачи, вехи, секции в рамках диапазона
                        • +
                      +
                      • +
                    +

                    Rate limiting

                    +
                      +
                    • На публичный endpoint GET /api/v1/public/gantt/:uuid — rate limiting для защиты от перебора
                      • +
                    • Рекомендация: 60 запросов в минуту на IP
                      • +
                    +

                    Frontend (Angular)

                    +

                    Модальное окно «Общий доступ»

                    +
                      +
                    • Вызывается из меню экспорта
                      • +
                    • Содержит: +
                        +
                      • Форму создания ссылки (диапазон дат + кнопка «Создать»)
                        • +
                      • Список существующих ссылок (диапазон + URL + кнопка «Копировать» + кнопка «Удалить»)
                        • +
                      +
                      • +
                    +

                    Публичная страница /share/:uuid

                    +
                      +
                    • Отдельный route, не требует авторизации
                      • +
                    • Отображает диаграмму Ганта в read-only режиме
                      • +
                    • Доступны только: масштабирование таймлайна, переключение ячейки/дни
                      • +
                    • Все контролы управления скрыты (удалены из шаблона, не просто disabled)
                      • +
                    • Минимальный layout — без навигации проекта, без сайдбара
                      • +
                    +
                    +

                    Открытые вопросы

                    +

                    (Нет)

                    + +
                    + +
                    +
                    +
                    + +
                    +
                    +

                    © 2026 docs.a2v.space

                    +
                    +
                    + + + + + + + + + + + + + + + diff --git a/public/leadera/leadera-milestones/index.html b/public/leadera/leadera-milestones/index.html new file mode 100644 index 0000000..2086239 --- /dev/null +++ b/public/leadera/leadera-milestones/index.html @@ -0,0 +1,618 @@ + + + + + + Leadera: Вехи (Milestones) на диаграмме Ганта — docs.a2v.space + + + + + + + + + + +
                    + + + + +
                    + + +
                    +
                    + + + + +
                    + +
                    +

                    Leadera: Вехи (Milestones) на диаграмме Ганта

                    +
                    + + 📁 ~/Projects/docs-a2v/content/leadera/leadera-milestones.md + + +
                    + + + +
                    + + leadera + + gantt + + angular + + go + + api + + ux + +
                    + + +

                    Бизнес-требования

                    +

                    BR-1: Сущность «Веха» (Milestone)

                    +

                    Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.

                    +

                    Поля вехи:

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ПолеТипОписание
                    idUUIDИдентификатор
                    gantt_chart_idUUIDПринадлежность к диаграмме (не к секции!)
                    titlestringНазвание вехи (обязательное, 1–255 символов)
                    datedateДата вехи (без времени, обязательная)
                    colorstringЦвет маркера (HEX, по умолчанию #dc3545 — красный)
                    created_byUUIDКто создал (не отображается в UI, хранится для аудита)
                    updated_byUUIDКто обновил (не отображается в UI)
                    created_attimestampДата создания
                    updated_attimestampДата обновления
                    deleted_attimestampSoft delete
                    +

                    Права доступа: Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).

                    +

                    Особенности:

                    +
                      +
                    • Вех может быть несколько в проекте
                      • +
                    • Несколько вех могут иметь одну и ту же дату
                      • +
                    • Вехи сортируются строго по дате (по возрастанию)
                      • +
                    • Вехи не привязаны к секциям — они отображаются сквозь все секции
                      • +
                    +
                    +

                    BR-2: Управление вехами (модальное окно)

                    +

                    Вызов: Кнопка «Вехи» рядом с кнопкой «Создать секцию» на странице диаграммы.

                    +

                    Модальное окно содержит:

                    +
                      +
                    • Заголовок: «Вехи проекта»
                      • +
                    • Список всех вех текущей диаграммы (сортировка по дате по возрастанию)
                      • +
                    • Каждая веха в списке показывает: цвет (индикатор), название, дату, кнопки «Редактировать» и «Удалить»
                      • +
                    • Кнопка «Добавить веху»
                      • +
                    +

                    Форма добавления/редактирования вехи:

                    +
                      +
                    • Название — текстовый ввод (обязательное, 1–255 символов)
                      • +
                    • Дата — datepicker (обязательное)
                      • +
                    • Цвет — выбор цвета (по аналогии с палитрой цветов в задачах)
                      • +
                    • По умолчанию цвет = красный (#dc3545)
                      • +
                    +

                    Удаление: с подтверждением (confirm dialog).

                    +
                    +

                    BR-3: Отображение вех на таймлайне

                    +

                    Визуальное представление:

                    +
                      +
                    • Маркер-флажок (flag marker) на шкале таймлайна
                      • +
                    • От маркера вниз идёт пунктирная вертикальная линия через все секции (на всю высоту диаграммы)
                      • +
                    • Цвет линии и маркера = цвет вехи
                      • +
                    +

                    Позиционирование:

                    +
                      +
                    • Веха ставится ровно на свою дату на шкале времени
                      • +
                    • Если дата вехи выходит за рамки текущего диапазона задач — таймлайн расширяется (аналогично задачам)
                      • +
                    • При изменении масштаба (days/weeks/months/quarters) позиция вехи пересчитывается
                      • +
                    +

                    Tooltip при наведении:

                    +
                      +
                    • При наведении на маркер/линию — показывается tooltip с названием вехи
                      • +
                    • Если на одну дату приходится несколько вех — в tooltip показываются все вехи этой даты с их названиями (каждая с индикацией своего цвета)
                      • +
                    +
                    +

                    Технические требования

                    +

                    База данных

                    +

                    Новая таблица: gantt_milestones

                    +
                    CREATE TABLE gantt_milestones (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    gantt_chart_id UUID NOT NULL REFERENCES gantt_charts(id) ON DELETE CASCADE,
+    title VARCHAR(255) NOT NULL,
+    date DATE NOT NULL,
+    color VARCHAR(20) NOT NULL DEFAULT '#dc3545',
+    created_by UUID NOT NULL REFERENCES users(id),
+    updated_by UUID NOT NULL REFERENCES users(id),
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    deleted_at TIMESTAMP WITH TIME ZONE
+);
+
+CREATE INDEX idx_gantt_milestones_chart ON gantt_milestones(gantt_chart_id);
+CREATE INDEX idx_gantt_milestones_date ON gantt_milestones(date);
+
                    +

                    Backend (Go API)

                    +

                    Этап 1: Миграция + Домен

                    +

                    Промт для агента:

                    +
                    +

                    Добавь в проект новую таблицу gantt_milestones.

                    +
                      +
                    1. +

                      Создай миграцию в cmd/migrate/:

                      +
                        +
                      • Новая таблица gantt_milestones с полями: id (UUID PK), gantt_chart_id (UUID FK → gantt_charts, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), date (DATE NOT NULL), color (VARCHAR 20 NOT NULL DEFAULT ‘#dc3545’), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. Индексы по gantt_chart_id и date.
                        • +
                      +
                      2. +
                    2. +

                      Создай доменную модель GanttMilestone в internal/domain/gantt.go:

                      +
                      3. +
                    +
                    type GanttMilestone struct {
+    ID           UUID       `json:"id"`
+    GanttChartID UUID       `json:"gantt_chart_id"`
+    Title        string     `json:"title"`
+    Date         time.Time  `json:"date"`
+    Color        string     `json:"color"`
+    CreatedBy    UUID       `json:"created_by"`
+    UpdatedBy    UUID       `json:"updated_by"`
+    CreatedAt    time.Time  `json:"created_at"`
+    UpdatedAt    time.Time  `json:"updated_at"`
+    DeletedAt    *time.Time `json:"deleted_at,omitempty"`
+}
+
                    +

                    Этап 2: CRUD для GanttMilestones

                    +

                    Промт для агента:

                    +
                    +

                    Реализуй полный CRUD для сущности GanttMilestone по аналогии с существующими handlers/services/repositories в проекте.

                    +

                    Роуты:

                    +
                      +
                    • GET /api/gantt-charts/:chartId/milestones — список вех диаграммы
                      • +
                    • POST /api/gantt-charts/:chartId/milestones — создать веху
                      • +
                    • PUT /api/gantt-charts/:chartId/milestones/:milestoneId — обновить веху
                      • +
                    • DELETE /api/gantt-charts/:chartId/milestones/:milestoneId — удалить веху (soft delete)
                      • +
                    +

                    Repository: internal/repository/gantt_milestone_repository.go

                    +
                      +
                    • GetByChartID(ctx, chartID) ([]domain.GanttMilestone, error) — все неудалённые вехи диаграммы, отсортированные по date ASC
                      • +
                    • GetByID(ctx, id) (*domain.GanttMilestone, error)
                      • +
                    • Create(ctx, milestone) error
                      • +
                    • Update(ctx, milestone) error
                      • +
                    • Delete(ctx, id) error — soft delete (set deleted_at)
                      • +
                    • Все запросы — raw SQL через pgx, как в остальных репозиториях проекта
                      • +
                    +

                    Service: internal/service/gantt_milestone_service.go

                    +
                      +
                    • Валидация: title (1–255 символов), date (обязательное), color (валидный HEX, default ‘#dc3545’)
                      • +
                    • Проверка прав доступа: пользователь должен иметь права выше «только чтение» в пространстве (space) диаграммы
                      • +
                    • Проверка что chartId существует и не архивирован
                      • +
                    +

                    Handler: internal/handler/gantt_milestone_handler.go

                    +
                      +
                    • Swagger-аннотации для всех эндпоинтов
                      • +
                    • Валидация входных данных
                      • +
                    • Ошибки в формате проекта
                      • +
                    +

                    DTO: internal/dto/gantt/milestones_dto.go

                    +
                    type CreateGanttMilestoneRequest struct {
+    Title string  `json:"title" binding:"required,min=1,max=255"`
+    Date   string  `json:"date" binding:"required"`
+    Color  *string `json:"color" binding:"omitempty,max=20"`
+}
+
+type UpdateGanttMilestoneRequest struct {
+    Title *string `json:"title" binding:"omitempty,min=1,max=255"`
+    Date   *string `json:"date" binding:"omitempty"`
+    Color  *string `json:"color" binding:"omitempty,max=20"`
+}
+
+type GanttMilestoneResponse struct {
+    ID            domain.UUID           `json:"id"`
+    GanttChartID  domain.UUID           `json:"gantt_chart_id"`
+    Title         string                `json:"title"`
+    Date          string                `json:"date"`
+    Color         string                `json:"color"`
+    CreatedByUser *CreatedByUpdatedUser `json:"created_by_user"`
+    UpdatedByUser *CreatedByUpdatedUser `json:"updated_by_user"`
+    CreatedAt     time.Time             `json:"created_at"`
+    UpdatedAt     time.Time             `json:"updated_at"`
+}
+
+type GanttMilestonesListResponse struct {
+    Milestones []GanttMilestoneResponse `json:"milestones"`
+}
+

                    Регистрация роутов: Добавь группу milestone-роутов в роутер рядом с существующими роутами секций/задач. Проверка прав через существующий middleware.

                    +
                    +

                    Этап 3: Включение вех в ответ диаграммы

                    +

                    Промт для агента:

                    +
                    +

                    При запросе данных диаграммы Ганта (полная загрузка) включай связанные вехи в ответ.

                    +
                      +
                    1. Добавь эндпоинт или расширь существующий GET /api/gantt-charts/:chartId — включить поле milestones с массивом GanttMilestoneResponse
                      2. +
                    2. Вехи с deleted_at IS NOT NULL не возвращаются
                      3. +
                    3. Вехи сортируются по date ASC
                      4. +
                    4. Вехи загружаются вместе с данными диаграммы (tasks, sections) — один запрос при открытии Ганта
                      5. +
                    +
                    +
                    +

                    Frontend (Angular)

                    +

                    Этап FE-1: Модели + Сервис

                    +

                    Промт для агента:

                    +
                    +

                    Добавь в проект поддержку вех (milestones) на диаграмме Ганта.

                    +
                      +
                    1. В pages/gantt/models/ (или соответствующем файле моделей) добавь:
                      2. +
                    +
                    export interface GanttMilestone {
+  id: string;
+  gantt_chart_id: string;
+  title: string;
+  date: string;
+  color: string;
+  created_by_user?: { id: string; full_name: string };
+  updated_by_user?: { id: string; full_name: string };
+  created_at: string;
+  updated_at: string;
+}
+
+export interface GanttMilestoneCreateRequest {
+  title: string;
+  date: string;
+  color?: string;
+}
+
+export interface GanttMilestoneUpdateRequest {
+  title?: string;
+  date?: string;
+  color?: string;
+}
+
                      +
                    1. +

                      Добавь milestones: GanttMilestone[] в интерфейс/модель полной загрузки данных диаграммы

                      +
                      2. +
                    2. +

                      Создай сервис pages/gantt/services/gantt-milestone.service.ts:

                      +
                      3. +
                    +
                      +
                    • Inject HttpClient
                      • +
                    • Методы: +
                        +
                      • getMilestones(chartId: string): Observable<GanttMilestone[]>
                        • +
                      • createMilestone(chartId: string, data: GanttMilestoneCreateRequest): Observable<GanttMilestone>
                        • +
                      • updateMilestone(chartId: string, milestoneId: string, data: GanttMilestoneUpdateRequest): Observable<GanttMilestone>
                        • +
                      • deleteMilestone(chartId: string, milestoneId: string): Observable<void>
                        • +
                      +
                      • +
                    • Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService)
                      • +
                    +
                    +

                    Этап FE-2: Модальное окно управления вехами

                    +

                    Промт для агента:

                    +
                    +

                    Создай компонент модального окна для управления вехами диаграммы Ганта.

                    +
                      +
                    1. +

                      Создай компонент pages/gantt/components/milestones-modal/

                      +
                      2. +
                    2. +

                      Кнопка вызова: Добавь кнопку «Вехи» рядом с кнопкой «Создать секцию» в toolbar диаграммы. По клику — открытие модального окна через ng-bootstrap NgbModal.

                      +
                      3. +
                    3. +

                      Модальное окно (ng-bootstrap modal):

                      +
                        +
                      • Заголовок: «Вехи проекта»
                        • +
                      • Список вех (сортировка по date ASC): +
                          +
                        • Каждый элемент: цветной кружок (color), название, дата (форматированная), кнопки ✏️ (редактировать) и 🗑️ (удалить с confirm)
                          • +
                        +
                        • +
                      • Кнопка «Добавить веху» внизу списка
                        • +
                      • Если вех нет — сообщение «Вех пока нет. Добавьте первую!»
                        • +
                      +
                      4. +
                    4. +

                      Форма добавления/редактирования (inline в модальном окне):

                      +
                        +
                      • Название — текстовый ввод (обязательное)
                        • +
                      • Дата — ng-bootstrap datepicker (обязательное)
                        • +
                      • Цвет — палитра цветов (использовать тот же компонент/подход, что и для задач)
                        • +
                      • По умолчанию цвет = #dc3545 (красный)
                        • +
                      • Кнопки «Сохранить» и «Отмена»
                        • +
                      +
                      5. +
                    5. +

                      При сохранении — вызов соответствующего метода сервиса (create/update)

                      +
                      6. +
                    6. +

                      При удалении — confirm dialog → вызов deleteMilestone

                      +
                      7. +
                    7. +

                      После любого изменения — обновить список вех и обновить данные на канвасе (через сервис/GanttStore)

                      +
                      8. +
                    8. +

                      Инжектировать GanttMilestoneService и NgbModal

                      +
                      9. +
                    +
                    +

                    Этап FE-3: Отображение вех на таймлайне (Konva canvas)

                    +

                    Промт для агента:

                    +
                    +

                    Отобрази вехи (milestones) на canvas-диаграмме Ганта.

                    +

                    Проект использует Konva.js для рендеринга.

                    +
                      +
                    1. +

                      При загрузке данных диаграммы — извлечь массив milestones

                      +
                      2. +
                    2. +

                      Для каждой вехи нарисовать на canvas:

                      +
                        +
                      • Маркер-флажок (flag marker) на позиции даты вехи на шкале времени +
                          +
                        • Стиль: маленький треугольник или флаг на верхней границе таймлайна
                          • +
                        • Цвет = milestone.color
                          • +
                        +
                        • +
                      • Пунктирная вертикальная линия от маркера вниз через все секции (на всю высоту области секций) +
                          +
                        • Стиль: Konva.Line, dash: [5, 5], strokeWidth: 1.5, color = milestone.color, opacity: 0.7
                          • +
                        +
                        • +
                      +
                      3. +
                    3. +

                      Позиционирование:

                      +
                        +
                      • Рассчитать X-позицию по дате вехи с использованием текущей шкалы времени (как для задач)
                        • +
                      • Если дата вехи выходит за текущий диапазон — расширить диапазон (влияет на общую ширину таймлайна)
                        • +
                      • При изменении масштаба (days/weeks/months/quarters) — пересчитать позиции всех вех
                        • +
                      • При скролле — вехи скроллятся вместе с задачами
                        • +
                      +
                      4. +
                    4. +

                      Tooltip при наведении:

                      +
                        +
                      • При наведении на маркер или пунктирную линию — показать Konva.Tooltip или HTML tooltip: +
                          +
                        • Если веха одна на эту дату — показать название
                          • +
                        • Если несколько вех на одну дату — показать список: цветной кружок + название для каждой
                          • +
                        +
                        • +
                      +
                      5. +
                    5. +

                      Z-index:

                      +
                        +
                      • Линии вех рисуются поверх фона секций, но под задачами
                        • +
                      • Маркеры-флажки — поверх всего (самый высокий z-index)
                        • +
                      +
                      6. +
                    6. +

                      Реактивность:

                      +
                        +
                      • При добавлении/удалении/редактировании вехи — перерисовать только вехи (без полного ре рендера задач)
                        • +
                      • Подписаться на изменения массива milestones через сервис/store
                        • +
                      +
                      7. +
                    +
                    +
                    +

                    Порядок реализации

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    #ЭтапСторонаЗависимости
                    1Миграция + ДоменBackend—
                    2CRUD вехBackendЭтап 1
                    3Включение вех в ответ диаграммыBackendЭтап 2
                    4Модели + СервисFrontend— (параллельно с backend)
                    5Модальное окно управления вехамиFrontendЭтапы 4 + backend 2
                    6Отображение вех на таймлайнеFrontendЭтапы 4 + backend 3
                    + +
                    + +
                    +
                    +
                    + +
                    +
                    +

                    © 2026 docs.a2v.space

                    +
                    +
                    + + + + + + + + + + + + + + + diff --git a/public/leadera/leadera-section-constraints/index.html b/public/leadera/leadera-section-constraints/index.html new file mode 100644 index 0000000..7a8613e --- /dev/null +++ b/public/leadera/leadera-section-constraints/index.html @@ -0,0 +1,681 @@ + + + + + + Leadera: Ограничения секций в диаграмме Ганта — docs.a2v.space + + + + + + + + + + +
                    + + + + +
                    + + +
                    +
                    + + + + +
                    + +
                    +

                    Leadera: Ограничения секций в диаграмме Ганта

                    +
                    + + 📁 ~/Projects/docs-a2v/content/leadera/leadera-section-constraints.md + + +
                    + + + +
                    + + leadera + + gantt + + angular + + go + + api + + ux + +
                    + + +

                    Бизнес-требования

                    +

                    BR-1: Лимит одновременных задач (Concurrency Limit)

                    +

                    У каждой секции появляется параметр max_concurrent_tasks (целое число ≥ 0, по умолчанию 0).

                    +

                    Поведение:

                    +
                      +
                    • Если max_concurrent_tasks = 3 — в любой данный день в этой секции не может быть больше 3 активных задач одновременно
                      • +
                    • Если max_concurrent_tasks = 0 — ограничение отключено, лимита нет
                      • +
                    • Пересечение считается по дате: задача занимает дни с start_date по end_date включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день
                      • +
                    • Ограничение работает только в рамках одной секции. Задачи из разных секций не влияют друг на друга
                      • +
                    +

                    Срабатывание при:

                    +
                      +
                    1. Создании задачи — если добавление нарушает лимит → Alert
                      2. +
                    2. Перетаскивании задачи (drag) — если новая позиция нарушает лимит → Alert
                      3. +
                    3. Растягивании задачи (resize) — если новый размер нарушает лимит → Alert
                      4. +
                    4. Редактировании задачи (форма) — если изменённые даты нарушают лимит → Alert
                      5. +
                    +

                    Важно: Действие НЕ отменяется. Задача создаётся/перемещается в любом случае, но пользователь видит предупреждение.

                    +

                    Текст Alert: «В секции “[название секции]” на [дата/диапазон] превышен лимит одновременных задач (максимум: N)»

                    +
                    +

                    BR-2: Блоки секций (Section Blocks)

                    +

                    У каждой секции появляется набор блоков — особый вид записей, отображаемых на таймлайне как заштрихованные области.

                    +

                    Сущность GanttSectionBlock:

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    ПолеТипОписание
                    idUUIDИдентификатор
                    section_idUUIDПринадлежность к секции
                    titlestringНазвание (например: «Отпуск», «Командировка»)
                    start_datedateНачало интервала (минимум 1 день)
                    end_datedateКонец интервала
                    block_concurrencybooleanЗапрещать ли пересечение обычных задач с данным блоком
                    +

                    Валидация:

                    +
                      +
                    • end_date не может быть раньше start_date
                      • +
                    • Все поля обязательны
                      • +
                    • Блок может быть в прошлом
                      • +
                    +

                    Визуальное отображение на Ганте:

                    +
                      +
                    • Заштрихованная область на всю высоту секции (включая все строки задач в секции)
                      • +
                    • Название блока отображается поверх штриховки с подложкой (для читаемости)
                      • +
                    +

                    Поведение block_concurrency:

                    +
                      +
                    • Если block_concurrency = true — при пересечении задачи с данным блоком показывается Alert (аналогично BR-1), но задача всё равно создаётся/перемещается
                      • +
                    • Если block_concurrency = false — блок отображается визуально, но не влияет на задачи
                      • +
                    +

                    Срабатывание при:

                    +
                      +
                    1. Создании задачи — пересекает блок с block_concurrency = true → Alert
                      2. +
                    2. Перетаскивании задачи (drag) → Alert
                      3. +
                    3. Растягивании задачи (resize) → Alert
                      4. +
                    4. Редактировании задачи (форма) → Alert
                      5. +
                    +

                    Текст Alert: «В секции “[название секции]” задача пересекает блок “[название блока]” ([дата] — [дата])»

                    +
                    +

                    BR-3: Система Alert-ов

                    +

                    Все предупреждения (от BR-1 и BR-2) выводятся в единую область над диаграммой Ганта.

                    +

                    Поведение:

                    +
                      +
                    • Alert-ы — Bootstrap Alert (warning), постоянные
                      • +
                    • Пользователь НЕ может закрыть Alert вручную
                      • +
                    • Alert исчезает автоматически, когда текущая дата прошла дату конфликта (конфликт больше не актуален)
                      • +
                    • Проверка конфликтов — только на фронтенде (на основе загруженных данных: задачи секции, блоки, max_concurrent_tasks)
                      • +
                    • Если Alert-ов много — область сворачиваемая с счётчиком в бейдже (например: «⚠️ 3 предупреждения»)
                      • +
                    • По умолчанию — развёрнуто
                      • +
                    • Сворачивание/разворачивание — клик по заголовку области
                      • +
                    +
                    +

                    BR-4: Настройки секции

                    +
                      +
                    • Настройки совмещены с существующим модальным окном редактирования секции (не отдельное окно)
                      • +
                    +

                    Окно создания секции — добавляется:

                    +
                      +
                    • Поле «Макс. одновременных задач» (числовой ввод, 0 = без лимита, по умолчанию 0)
                      • +
                    +

                    Окно редактирования секции — добавляется:

                    +
                      +
                    • Поле «Макс. одновременных задач» (числовой ввод, 0 = без лимита)
                      • +
                    • Список блоков (таблица/список с CRUD: добавить, редактировать, удалить) +
                        +
                      • Сортировка: по start_date по убыванию (будущее сверху)
                        • +
                      • Каждый блок — форма: title, start_date, end_date, block_concurrency (чекбокс: «Запретить пересечение задач»)
                        • +
                      • Валидация: end_date >= start_date, все поля заполнены
                        • +
                      +
                      • +
                    +
                    +

                    BR-5: Наследование

                    +
                      +
                    • При появлении функционала копирования/дублирования диаграммы — настройки секций (лимит + блоки) наследуются
                      • +
                    +
                    +

                    Технические требования

                    +

                    База данных

                    +

                    Новая таблица: gantt_section_blocks

                    +
                    CREATE TABLE gantt_section_blocks (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    section_id UUID NOT NULL REFERENCES gantt_sections(id) ON DELETE CASCADE,
+    title VARCHAR(255) NOT NULL,
+    start_date DATE NOT NULL,
+    end_date DATE NOT NULL,
+    block_concurrency BOOLEAN NOT NULL DEFAULT false,
+    created_by UUID NOT NULL REFERENCES users(id),
+    updated_by UUID NOT NULL REFERENCES users(id),
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+    deleted_at TIMESTAMP WITH TIME ZONE,
+    CONSTRAINT chk_block_dates CHECK (end_date >= start_date)
+);
+
+CREATE INDEX idx_gantt_section_blocks_section ON gantt_section_blocks(section_id);
+CREATE INDEX idx_gantt_section_blocks_dates ON gantt_section_blocks(start_date, end_date);
+

                    Изменение таблицы: gantt_sections

                    +
                    ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0;
+
                    +

                    Backend (Go API)

                    +

                    Этап 1: Миграция + Домен

                    +

                    Промт для агента:

                    +
                    +

                    Добавь в проект новую таблицу gantt_section_blocks и колонку max_concurrent_tasks в gantt_sections.

                    +
                      +
                    1. Создай миграцию в cmd/migrate/: +
                        +
                      • Новая таблица gantt_section_blocks с полями: id (UUID PK), section_id (UUID FK → gantt_sections, ON DELETE CASCADE), title (VARCHAR 255 NOT NULL), start_date (DATE NOT NULL), end_date (DATE NOT NULL), block_concurrency (BOOLEAN DEFAULT false), created_by (UUID FK → users), updated_by (UUID FK → users), created_at, updated_at, deleted_at. CHECK constraint: end_date >= start_date. Индексы по section_id и (start_date, end_date).
                        • +
                      • ALTER TABLE gantt_sections ADD COLUMN max_concurrent_tasks INTEGER NOT NULL DEFAULT 0.
                        • +
                      +
                      2. +
                    2. Создай доменную модель GanttSectionBlock в internal/domain/gantt.go со всеми полями таблицы.
                      3. +
                    3. Добавь поле MaxConcurrentTasks int в структуру GanttSection.
                      4. +
                    4. Обнови маппинг в relevant repository файлах, чтобы новое поле max_concurrent_tasks читалось/писалось.
                      5. +
                    +
                    +

                    Этап 2: CRUD для GanttSectionBlocks

                    +

                    Промт для агента:

                    +
                    +

                    Реализуй полный CRUD для сущности GanttSectionBlock по аналогии с существующими handlers/services/repositories в проекте.

                    +

                    Роуты (внутри группы секции):

                    +
                      +
                    • GET /api/gantt-charts/:chartId/sections/:sectionId/blocks — список блоков секции
                      • +
                    • POST /api/gantt-charts/:chartId/sections/:sectionId/blocks — создать блок
                      • +
                    • PUT /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId — обновить блок
                      • +
                    • DELETE /api/gantt-charts/:chartId/sections/:sectionId/blocks/:blockId — удалить блок (soft delete)
                      • +
                    +

                    Repository: internal/repository/gantt_section_block_repository.go

                    +
                      +
                    • GetBySectionID(ctx, sectionID) ([]domain.GanttSectionBlock, error)
                      • +
                    • GetByID(ctx, id) (*domain.GanttSectionBlock, error)
                      • +
                    • Create(ctx, block) error
                      • +
                    • Update(ctx, block) error
                      • +
                    • Delete(ctx, id) error — soft delete (set deleted_at)
                      • +
                    • Все запросы — raw SQL через pgx, как в остальных репозиториях проекта
                      • +
                    +

                    Service: internal/service/gantt_section_block_service.go

                    +
                      +
                    • Бизнес-логика: валидация dates (end >= start), проверка прав доступа к секции
                      • +
                    • Inject repository
                      • +
                    +

                    Handler: internal/handler/gantt_section_block_handler.go

                    +
                      +
                    • Swagger-аннотации для всех эндпоинтов
                      • +
                    • Валидация входных данных
                      • +
                    • Ошибки в формате проекта (GanttErrorResponse)
                      • +
                    +

                    Модели запросов:

                    +
                      +
                    • Create: title (required), start_date (required), end_date (required), block_concurrency (bool, default false)
                      • +
                    • Update: title, start_date, end_date, block_concurrency — все опциональны
                      • +
                    +
                    +

                    Этап 3: Обновление настроек секции

                    +

                    Промт для агента:

                    +
                    +

                    Обнови CRUD секций (gantt_sections) для поддержки нового поля max_concurrent_tasks.

                    +
                      +
                    1. Добавь max_concurrent_tasks в GanttSectionCreateRequest (опциональное, int ≥ 0, default 0)
                      2. +
                    2. Добавь max_concurrent_tasks в GanttSectionUpdateRequest (опциональное, int ≥ 0)
                      3. +
                    3. Обнови SQL-запросы в repository: INSERT и UPDATE должны включать max_concurrent_tasks
                      4. +
                    4. При GET секции (или списке секций) — возвращать max_concurrent_tasks в ответе
                      5. +
                    5. Валидация: значение должно быть ≥ 0
                      6. +
                    +
                    +

                    Этап 4: Включение блоков в ответ секций

                    +

                    Промт для агента:

                    +
                    +

                    При запросе списка секций или одной секции включай связанные блоки в ответ.

                    +
                      +
                    1. Обнови GET /api/gantt-charts/:chartId/sections/:sectionId — добавить поле blocks с массивом GanttSectionBlock
                      2. +
                    2. Обнови GET /api/gantt-charts/:chartId/sections — добавить поле blocks для каждой секции
                      3. +
                    3. Блоки с deleted_at IS NOT NULL не возвращаются
                      4. +
                    4. Блоки сортируются по start_date по убыванию (будущее сверху)
                      5. +
                    +
                    +
                    +

                    Frontend (Angular)

                    +

                    Этап FE-1: Модели + Сервис

                    +

                    Промт для агента:

                    +
                    +

                    Добавь в проект поддержку ограничений секций Ганта.

                    +
                      +
                    1. В pages/gantt/models/gantt-chart.model.ts добавь:
                      2. +
                    +
                    export interface GanttSectionBlock {
+  id: string;
+  section_id: string;
+  title: string;
+  start_date: string;
+  end_date: string;
+  block_concurrency: boolean;
+  created_by_user: UserInfo;
+  updated_by_user: UserInfo;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface GanttSectionBlockCreateRequest {
+  title: string;
+  start_date: string;
+  end_date: string;
+  block_concurrency?: boolean;
+}
+
+export interface GanttSectionBlockUpdateRequest {
+  title?: string;
+  start_date?: string;
+  end_date?: string;
+  block_concurrency?: boolean;
+}
+
+export interface ConflictCheck {
+  has_conflicts: boolean;
+  conflicts: ConflictItem[];
+}
+
+export interface ConflictItem {
+  type: 'concurrency' | 'block';
+  section_id: string;
+  section_title: string;
+  block_title?: string;
+  start_date?: string;
+  end_date?: string;
+  message: string;
+  dates?: string[];
+}
+
                      +
                    1. +

                      Добавь max_concurrent_tasks: number в интерфейс GanttSection

                      +
                      2. +
                    2. +

                      Добавь blocks: GanttSectionBlock[] в интерфейс GanttSection

                      +
                      3. +
                    3. +

                      Добавь max_concurrent_tasks?: number в GanttSectionCreateRequest и GanttSectionUpdateRequest

                      +
                      4. +
                    4. +

                      Создай сервис pages/gantt/services/gantt-section-block.service.ts:

                      +
                      5. +
                    +
                      +
                    • Inject HttpClient
                      • +
                    • Методы: getBlocks(chartId, sectionId), createBlock(chartId, sectionId, data), updateBlock(chartId, sectionId, blockId, data), deleteBlock(chartId, sectionId, blockId)
                      • +
                    • Все методы возвращают Observable с типизированными ответами (по аналогии с GanttChartService)
                      • +
                    +
                    +

                    Этап FE-2: Интеграция в модальные окна секции

                    +

                    Промт для агента:

                    +
                    +

                    Интегрируй настройки ограничений в существующие модальные окна создания и редактирования секции Ганта.

                    +
                      +
                    1. Найди существующие компоненты модальных окон секции (создание/редактирование).
                      2. +
                    +

                    Окно создания секции — добавить:

                    +
                      +
                    • Числовой ввод: «Максимум одновременных задач»
                      • +
                    • Подсказка: «0 = без ограничений»
                      • +
                    • Валидация: число ≥ 0
                      • +
                    • Значение по умолчанию: 0
                      • +
                    • Отправляется в GanttSectionCreateRequest как max_concurrent_tasks
                      • +
                    +

                    Окно редактирования секции — добавить:

                    +
                      +
                    • Числовой ввод: «Максимум одновременных задач» (аналогично созданию)
                      • +
                    • Секция «Блоки (запретные интервалы)»: +
                        +
                      • Таблица/список существующих блоков с колонками: Название, Начало, Конец, Блокировка (чекбокс/иконка), Действия (редактировать/удалить)
                        • +
                      • Сортировка: по start_date по убыванию (будущее сверху)
                        • +
                      • Кнопка «Добавить блок» — inline-форма: +
                          +
                        • title (текстовый ввод, обязательный)
                          • +
                        • start_date (datepicker, обязательный)
                          • +
                        • end_date (datepicker, обязательный)
                          • +
                        • block_concurrency (чекбокс: «Запретить пересечение задач»)
                          • +
                        • Валидация: end_date >= start_date, все поля заполнены
                          • +
                        +
                        • +
                      • Редактирование — inline или через ту же форму
                        • +
                      • Удаление — с подтверждением
                        • +
                      +
                      • +
                    +
                      +
                    1. При открытии окна редактирования — загрузить текущие настройки секции + блоки
                      2. +
                    2. При сохранении — обновить max_concurrent_tasks и сохранить изменения блоков
                      3. +
                    3. Инжектировать GanttChartService и GanttSectionBlockService
                      4. +
                    +
                    +

                    Этап FE-3: Визуализация блоков на Ганте

                    +

                    Промт для агента:

                    +
                    +

                    Отобрази блоки секций (GanttSectionBlock) на canvas-диаграмме Ганта.

                    +

                    Проект использует Konva.js для рендеринга. Основной компонент: gantt-chart-canvas.

                    +
                      +
                    1. При загрузке данных диаграммы — извлечь блоки из каждой секции
                      2. +
                    2. В рендерере секций (canvas/timeline-renderer.ts или аналогичный) — для каждого блока: +
                        +
                      • Нарисовать заштрихованную область (diagonal hatch pattern) на всю высоту секции (все строки задач в этой секции)
                        • +
                      • Область ограничена по горизонтали: от start_date до end_date (в пикселях по шкале времени)
                        • +
                      • Цвет штриховки: полупрозрачный серый или configurable
                        • +
                      • Поверх штриховки — текст с названием блока (block.title) на подложке (прямоугольник с фоном, чтобы текст читался)
                        • +
                      +
                      3. +
                    3. Блоки рендерятся до задач (z-index ниже), чтобы задачи были поверх
                      4. +
                    4. Блоки с block_concurrency = true и false визуально не отличаются (штриховка одинаковая)
                      5. +
                    5. При скролле/зуме — блоки пересчитываются как обычные элементы таймлайна
                      6. +
                    +
                    +

                    Этап FE-4: Система Alert-ов

                    +

                    Промт для агента:

                    +
                    +

                    Создай компонент для отображения Alert-ов о конфликтах на диаграмме Ганта.

                    +
                      +
                    1. +

                      Создай компонент pages/gantt/components/gantt-conflict-alerts/

                      +
                      2. +
                    2. +

                      Компонент размещается над canvas-диаграммой Ганта

                      +
                      3. +
                    3. +

                      Входные данные: массив ConflictItem[] (из модели)

                      +
                      4. +
                    4. +

                      Визуал:

                      +
                        +
                      • Bootstrap Alert (warning) для каждого конфликта
                        • +
                      • Каждый Alert показывает message из ConflictItem
                        • +
                      • Без кнопки закрытия — Alert нельзя закрыть вручную
                        • +
                      • Alert исчезает автоматически, когда текущая дата прошла дату конфликта
                        • +
                      • Область сворачиваемая: заголовок «⚠️ Предупреждения (N)» — клик сворачивает/разворачивает список
                        • +
                      • По умолчанию — развёрнуто
                        • +
                      • При 0 конфликтов — область скрыта
                        • +
                      +
                      5. +
                    5. +

                      Состояние хранится в сервисе или в компоненте диаграммы:

                      +
                        +
                      • Добавление нового конфликта → area auto-expands
                        • +
                      • Alert удаляется из массива автоматически, когда текущая дата прошла дату конфликта
                        • +
                      • Проверка актуальности конфликтов — при каждой отрисовке / изменении данных
                        • +
                      • Не использовать toast — Alert-ы постоянные
                        • +
                      +
                      6. +
                    +
                    +

                    Этап FE-5: Проверка конфликтов при операциях с задачами

                    +

                    Промт для агента:

                    +
                    +

                    Интегрируй проверку конфликтов во все операции с задачами на диаграмме Ганта.

                    +

                    Проект использует interaction-handler.ts для drag/resize и формы для создания/редактирования.

                    +

                    Важно: Проверка конфликтов — только на фронтенде, без вызова API. Используются загруженные данные секции (задачи, блоки, max_concurrent_tasks).

                    +
                      +
                    1. +

                      Вынеси логику проверки конфликтов checkConflicts() в отдельный метод в gantt-canvas.service.ts:

                      +
                        +
                      • Принимает: section (GanttSection — содержит max_concurrent_tasks и blocks), tasks (GanttTask[] — задачи секции), task_id (nullable — исключить текущую задачу), start_date, end_date
                        • +
                      • Логика: +a. Если section.max_concurrent_tasks > 0: посчитать кол-во задач (исключая task_id), пересекающихся с [start_date, end_date] на каждый день. Если в любой день count > max_concurrent_tasks — добавить конфликт concurrency +b. Для каждого блока секции с block_concurrency = true, пересекающегося с [start_date, end_date] — добавить конфликт block
                        • +
                      • Возвращает ConflictCheck
                        • +
                      +
                      2. +
                    2. +

                      После каждой успешной операции с задачей (создание, обновление, drag, resize):

                      +
                        +
                      • Вызвать checkConflicts с параметрами задачи
                        • +
                      • Если has_conflicts = true — передать конфликты в GanttConflictAlertsComponent
                        • +
                      • Alert-ы показываются, действие НЕ отменяется
                        • +
                      +
                      3. +
                    3. +

                      Точки интеграции:

                      +
                        +
                      • Создание задачи (форма): после успешного POST → checkConflicts → show alerts
                        • +
                      • Редактирование задачи (форма): после успешного PUT → checkConflicts → show alerts
                        • +
                      • Drag задачи (interaction-handler.ts): после успешного обновления позиции → checkConflicts → show alerts
                        • +
                      • Resize задачи (interaction-handler.ts): после успешного обновления размера → checkConflicts → show alerts
                        • +
                      +
                      4. +
                    4. +

                      При переключении диаграммы или секции — очищать Alert-ы

                      +
                      5. +
                    5. +

                      Alert-ы автоматически удаляются, когда текущая дата прошла дату конфликта — область скрывается, когда конфликтов не осталось

                      +
                      6. +
                    +
                    +
                    +

                    Порядок реализации

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    #ЭтапСторонаЗависимости
                    1Миграция + ДоменBackend—
                    2CRUD блоковBackendЭтап 1
                    3Обновление настроек секцииBackendЭтап 1
                    4Включение блоков в ответ секцийBackendЭтап 2
                    5Модели + СервисFrontend— (можно параллельно с backend)
                    6Интеграция в модальные окнаFrontendЭтапы 5 + backend 2,3
                    7Визуализация блоков на ГантеFrontendЭтапы 5 + backend 4
                    8Система Alert-овFrontendЭтап 5
                    9Проверка конфликтов при операцияхFrontendЭтапы 5,7,8
                    + +
                    + +
                    +
                    +
                    + +
                    +
                    +

                    © 2026 docs.a2v.space

                    +
                    +
                    + + + + + + + + + + + + + + + diff --git a/public/leadera/leadera-websocket-gantt/index.html b/public/leadera/leadera-websocket-gantt/index.html new file mode 100644 index 0000000..6e0762b --- /dev/null +++ b/public/leadera/leadera-websocket-gantt/index.html @@ -0,0 +1,942 @@ + + + + + + Leadera — WebSocket для диаграмм Ганта — docs.a2v.space + + + + + + + + + + +
                    + + + + +
                    + + +
                    +
                    + + + + +
                    + +
                    +

                    Leadera — WebSocket для диаграмм Ганта

                    +
                    + + 📁 ~/Projects/docs-a2v/content/leadera/leadera-websocket-gantt.md + + +
                    + + + +
                    + + leadera + + websocket + + realtime + + gantt + + architecture + +
                    + + +

                    WebSocket для диаграмм Ганта — realtime-совместное редактирование

                    +

                    Дата: 07.04.2026 +Статус: Планирование +Проект: Leadera (dev — sand.a2v.space)

                    +
                    +

                    1. Постановка задачи

                    +

                    Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.

                    +
                    +

                    2. Архитектура

                    +
                    Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL
+       │                                │
+       │  HTTP (мутации)                │  Broadcast
+       └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты
+

                    Ключевой принцип: мутации данных идут через HTTP (REST), WebSocket используется только для доставки уведомлений. Сервер — источник истины, клиент не может обойти проверки через WS.

                    +

                    Комнаты

                    +

                    Каждый открытый Гант — это «комната» с идентификатором chartId. При подключении клиент подписывается на комнату. Hub рассылает события всем подписчикам комнаты.

                    +
                    +

                    3. Backend (Go)

                    +

                    3.1. Зависимости

                    +
                    go get github.com/gorilla/websocket
+

                    3.2. Новые файлы — internal/ws/

                    +

                    message.go — типы сообщений

                    +
                    package ws
+
+import "time"
+
+// EventType — тип события
+type EventType string
+
+const (
+    // Данные
+    EventSectionCreated     EventType = "section_created"
+    EventSectionUpdated     EventType = "section_updated"
+    EventSectionDeleted     EventType = "section_deleted"
+    EventSectionsReordered  EventType = "sections_reordered"
+    EventTaskCreated        EventType = "task_created"
+    EventTaskUpdated        EventType = "task_updated"
+    EventTaskDeleted        EventType = "task_deleted"
+
+    // Присутствие
+    EventUserJoined         EventType = "user_joined"
+    EventUserLeft           EventType = "user_left"
+
+    // Безопасность / доступ
+    EventAccessRevoked      EventType = "access_revoked"
+    EventChartArchived      EventType = "chart_archived"
+    EventRoleChanged        EventType = "role_changed"
+    EventTokenExpired       EventType = "token_expired"
+)
+
+// Event — WS-событие, отправляемое клиентам
+type Event struct {
+    Type      EventType   `json:"type"`
+    ChartID   string      `json:"chartId"`
+    UserID    string      `json:"userId,omitempty"`
+    Payload   interface{} `json:"payload,omitempty"`
+    Timestamp time.Time   `json:"timestamp"`
+}
+
+// IncomingMessage — сообщение от клиента (для ping/pong)
+type IncomingMessage struct {
+    Type string `json:"type"`
+}
+

                    hub.go — центральный брокер

                    +
                    package ws
+
+import (
+    "sync"
+)
+
+// Hub управляет комнатами и рассылкой событий
+type Hub struct {
+    mu      sync.RWMutex
+    rooms   map[string]map[*Client]bool // chartId → клиенты
+}
+
+func NewHub() *Hub {
+    return &Hub{
+        rooms: make(map[string]map[*Client]bool),
+    }
+}
+
+// Subscribe добавляет клиента в комнату
+func (h *Hub) Subscribe(chartID string, client *Client) {
+    h.mu.Lock()
+    defer h.mu.Unlock()
+
+    if h.rooms[chartID] == nil {
+        h.rooms[chartID] = make(map[*Client]bool)
+    }
+    h.rooms[chartID][client] = true
+
+    // Уведомить остальных: user_joined
+    h.broadcastExcept(chartID, client, Event{
+        Type:      EventUserJoined,
+        ChartID:   chartID,
+        UserID:    client.UserID,
+        Payload:   map[string]string{"username": client.Username},
+        Timestamp: time.Now(),
+    })
+}
+
+// Unsubscribe удаляет клиента из комнаты
+func (h *Hub) Unsubscribe(chartID string, client *Client) {
+    h.mu.Lock()
+    defer h.mu.Unlock()
+
+    if clients, ok := h.rooms[chartID]; ok {
+        delete(clients, client)
+        if len(clients) == 0 {
+            delete(h.rooms, chartID)
+        }
+    }
+
+    // Уведомить остальных: user_left
+    h.broadcastExcept(chartID, client, Event{
+        Type:      EventUserLeft,
+        ChartID:   chartID,
+        UserID:    client.UserID,
+        Timestamp: time.Now(),
+    })
+}
+
+// Broadcast рассылает событие всем клиентам в комнате
+func (h *Hub) Broadcast(chartID string, event Event) {
+    h.mu.RLock()
+    defer h.mu.RUnlock()
+
+    if clients, ok := h.rooms[chartID]; ok {
+        for client := range clients {
+            client.Send(event)
+        }
+    }
+}
+
+// SendToUser отправляет событие конкретному пользователю во всех его комнатах
+func (h *Hub) SendToUser(userID string, event Event) {
+    h.mu.RLock()
+    defer h.mu.RUnlock()
+
+    for _, clients := range h.rooms {
+        for client := range clients {
+            if client.UserID == userID {
+                client.Send(event)
+            }
+        }
+    }
+}
+
+// broadcastExcept рассылает всем, кроме отправителя
+func (h *Hub) broadcastExcept(chartID string, sender *Client, event Event) {
+    if clients, ok := h.rooms[chartID]; ok {
+        for client := range clients {
+            if client != sender {
+                client.Send(event)
+            }
+        }
+    }
+}
+

                    client.go — обёртка WS-соединения

                    +
                    package ws
+
+import (
+    "encoding/json"
+    "sync"
+    "time"
+
+    "github.com/gorilla/websocket"
+)
+
+const (
+    writeWait      = 10 * time.Second
+    pongWait       = 60 * time.Second
+    pingPeriod     = (pongWait * 9) / 10
+    maxMessageSize = 1024
+)
+
+type Client struct {
+    Hub      *Hub
+    Conn     *websocket.Conn
+    UserID   string
+    Username string
+    ChartID  string
+    SendCh   chan Event
+    mu       sync.Mutex
+}
+
+func NewClient(hub *Hub, conn *websocket.Conn, userID, username, chartID string) *Client {
+    return &Client{
+        Hub:      hub,
+        Conn:     conn,
+        UserID:   userID,
+        Username: username,
+        ChartID:  chartID,
+        SendCh:   make(chan Event, 64),
+    }
+}
+
+// ReadPump читает входящие сообщения (ping/pong)
+func (c *Client) ReadPump() {
+    defer func() {
+        c.Hub.Unsubscribe(c.ChartID, c)
+        c.Conn.Close()
+    }()
+
+    c.Conn.SetReadLimit(maxMessageSize)
+    c.Conn.SetReadDeadline(time.Now().Add(pongWait))
+    c.Conn.SetPongHandler(func(string) error {
+        c.Conn.SetReadDeadline(time.Now().Add(pongWait))
+        return nil
+    })
+
+    for {
+        _, message, err := c.Conn.ReadMessage()
+        if err != nil {
+            break
+        }
+        // Клиент может слать только ping, данные игнорируем
+        _ = message
+    }
+}
+
+// WritePump отправляет события клиенту
+func (c *Client) WritePump() {
+    ticker := time.NewTicker(pingPeriod)
+    defer func() {
+        ticker.Stop()
+        c.Conn.Close()
+    }()
+
+    for {
+        select {
+        case event, ok := <-c.SendCh:
+            c.Conn.SetWriteDeadline(time.Now().Add(writeWait))
+            if !ok {
+                c.Conn.WriteMessage(websocket.CloseMessage, []byte{})
+                return
+            }
+            data, _ := json.Marshal(event)
+            c.mu.Lock()
+            c.Conn.WriteMessage(websocket.TextMessage, data)
+            c.mu.Unlock()
+
+        case <-ticker.C:
+            c.Conn.SetWriteDeadline(time.Now().Add(writeWait))
+            if err := c.Conn.WriteMessage(websocket.PingMessage, nil); err != nil {
+                return
+            }
+        }
+    }
+}
+
+// Send ставит событие в очередь отправки
+func (c *Client) Send(event Event) {
+    select {
+    case c.SendCh <- event:
+    default:
+        // Очередь полна — отключаем медленного клиента
+        close(c.SendCh)
+    }
+}
+

                    3.3. WS endpoint — internal/handlers/ws_handler.go

                    +
                    package handlers
+
+import (
+    "net/http"
+    "time"
+
+    "app-leadera-api/internal/middleware"
+    "app-leadera-api/internal/ws"
+
+    "github.com/gin-gonic/gin"
+    "github.com/google/uuid"
+    "github.com/gorilla/websocket"
+)
+
+var upgrader = websocket.Upgrader{
+    ReadBufferSize:  1024,
+    WriteBufferSize: 1024,
+    CheckOrigin:     func(r *http.Request) bool { return true }, // nginx проксирует
+}
+
+type WSHandler struct {
+    hub      *ws.Hub
+    ganttMW  *middleware.GanttMiddleware
+}
+
+func NewWSHandler(hub *ws.Hub, ganttMW *middleware.GanttMiddleware) *WSHandler {
+    return &WSHandler{hub: hub, ganttMW: ganttMW}
+}
+
+func (h *WSHandler) HandleGanttWS(c *gin.Context) {
+    // 1. Получить пользователя из контекста (auth middleware уже отработал)
+    userID, exists := c.Get("userID")
+    if !exists {
+        c.AbortWithStatusJSON(401, gin.H{"error": "unauthorized"})
+        return
+    }
+
+    // 2. Проверить доступ к chartId (gantt middleware)
+    chartID := c.Param("chartId")
+    if _, err := uuid.Parse(chartID); err != nil {
+        c.AbortWithStatusJSON(400, gin.H{"error": "invalid chart id"})
+        return
+    }
+    // TODO: проверить через ganttMW что userID имеет доступ к этому chart
+
+    // 3. Upgrade до WebSocket
+    conn, err := upgrader.Upgrade(c.Writer, c.Request, nil)
+    if err != nil {
+        return
+    }
+
+    // 4. Создать клиент и подписать на комнату
+    client := ws.NewClient(
+        h.hub, conn,
+        userID.(string),
+        c.GetString("username"),
+        chartID,
+    )
+    h.hub.Subscribe(chartID, client)
+
+    // 5. Запустить pump'ы
+    go client.WritePump()
+    go client.ReadPump()
+}
+

                    3.4. Регистрация маршрута

                    +

                    В cmd/server/main.go или где регистрируются routes:

                    +
                    // После создания hub
+wsHub := ws.NewHub()
+
+// WS endpoint
+wsHandler := handlers.NewWSHandler(wsHub, ganttMW)
+api.GET("/ws/gantt/:chartId", authMW.RequireAuth(), wsHandler.HandleGanttWS)
+
+// Передать hub в ganttHandler для broadcast'ов
+ganttHandler := handlers.NewGanttHandler(ganttService, sectionService, taskService, blockService, wsHub)
+

                    3.5. Интеграция broadcast в handlers

                    +

                    В каждый write-handler — одна строка после успешной операции:

                    +
                    // Пример: после успешного UpdateTask
+h.hub.Broadcast(chartID, ws.Event{
+    Type:      ws.EventTaskUpdated,
+    ChartID:   chartID,
+    UserID:    userID,
+    Payload:   updatedTask,
+    Timestamp: time.Now(),
+})
+

                    Точки интеграции в gantt_handler.go:

                    +
                      +
                    • CreateGanttChart → не нужен (пользователь только что создал, он один)
                      • +
                    • UpdateGanttChart / ArchiveGanttChart → chart_archived
                      • +
                    • CreateSection → section_created
                      • +
                    • UpdateSection → section_updated
                      • +
                    • DeleteSection → section_deleted
                      • +
                    • ReorderSections → sections_reordered
                      • +
                    • CreateTask → task_created
                      • +
                    • UpdateTask → task_updated
                      • +
                    • DeleteTask → task_deleted
                      • +
                    +

                    3.6. Интеграция событий безопасности

                    +

                    В соответствующих service-методах:

                    +
                    // При исключении из space (SpaceService.RemoveMember)
+wsHub.SendToUser(removedUserID, ws.Event{
+    Type:    ws.EventAccessRevoked,
+    Payload: map[string]string{"spaceId": spaceID},
+})
+
+// При архивации ганта
+wsHub.Broadcast(chartID, ws.Event{
+    Type:    ws.EventChartArchived,
+    ChartID: chartID,
+})
+
+// При изменении роли
+wsHub.SendToUser(userID, ws.Event{
+    Type:    ws.EventRoleChanged,
+    Payload: map[string]string{"role": newRole},
+})
+
                    +

                    4. Frontend (Angular)

                    +

                    4.1. WebSocket сервис — gantt-ws.service.ts

                    +
                    // src/app/pages/gantt/services/gantt-ws.service.ts
+
+import { Injectable, inject, OnDestroy } from '@angular/core';
+import { Subject, Observable } from 'rxjs';
+import { environment } from '../../../environments/environment';
+import { SpaceStorageService } from '../../../core/services/space-storage.service';
+import { AuthService } from '../../../core/auth/services/auth.service';
+
+export interface WSEvent {
+  type: string;
+  chartId?: string;
+  userId?: string;
+  payload?: any;
+  timestamp?: string;
+}
+
+@Injectable({ providedIn: 'root' })
+export class GanttWSService implements OnDestroy {
+  private spaceStorage = inject(SpaceStorageService);
+  private auth = inject(AuthService);
+
+  private socket: WebSocket | null = null;
+  private eventSubject = new Subject<WSEvent>();
+  private reconnectTimer: any;
+  private chartId: string | null = null;
+
+  /** Observable для подписки на события */
+  get events$(): Observable<WSEvent> {
+    return this.eventSubject.asObservable();
+  }
+
+  /** Подключиться к комнате ганта */
+  connect(chartId: string): void {
+    this.disconnect();
+    this.chartId = chartId;
+
+    const token = this.auth.getAccessToken();
+    const wsUrl = this.buildWSUrl(chartId, token);
+
+    this.socket = new WebSocket(wsUrl);
+
+    this.socket.onopen = () => {
+      console.log(`[WS] Connected to gantt ${chartId}`);
+    };
+
+    this.socket.onmessage = (msg) => {
+      try {
+        const event: WSEvent = JSON.parse(msg.data);
+        this.eventSubject.next(event);
+      } catch (e) {
+        console.error('[WS] Parse error', e);
+      }
+    };
+
+    this.socket.onclose = (event) => {
+      console.log(`[WS] Closed: ${event.code}`);
+      if (event.code !== 1000) {
+        this.scheduleReconnect();
+      }
+    };
+
+    this.socket.onerror = () => {
+      this.socket?.close();
+    };
+  }
+
+  /** Отключиться */
+  disconnect(): void {
+    clearTimeout(this.reconnectTimer);
+    if (this.socket) {
+      this.socket.close(1000, 'manual');
+      this.socket = null;
+    }
+    this.chartId = null;
+  }
+
+  ngOnDestroy(): void {
+    this.disconnect();
+  }
+
+  private buildWSUrl(chartId: string, token: string): string {
+    const base = environment.wsUrl || 
+      location.protocol.replace('http', 'ws') + '//' + location.host;
+    return `${base}/api/v1/ws/gantt/${chartId}?token=${token}`;
+  }
+
+  private scheduleReconnect(): void {
+    if (!this.chartId) return;
+    this.reconnectTimer = setTimeout(() => {
+      console.log('[WS] Reconnecting...');
+      if (this.chartId) this.connect(this.chartId);
+    }, 3000);
+  }
+}
+

                    4.2. Интеграция в gantt-chart-canvas компонент

                    +
                    // В gantt-chart-canvas.component.ts
+
+export class GanttChartCanvasComponent implements OnInit, OnDestroy {
+  private ws = inject(GanttWSService);
+  private onlineUsers: Set<string> = new Set();
+  private wsSubscription: Subscription | null = null;
+
+  ngOnInit(): void {
+    // Подключиться к WS при загрузке ганта
+    this.ws.connect(this.chartId);
+    this.wsSubscription = this.ws.events$.subscribe(event => {
+      this.handleWSEvent(event);
+    });
+  }
+
+  ngOnDestroy(): void {
+    this.wsSubscription?.unsubscribe();
+    this.ws.disconnect();
+  }
+
+  private handleWSEvent(event: WSEvent): void {
+    // Если это событие от текущего пользователя — пропускаем
+    // (мы уже обновили UI оптимистично или после HTTP-ответа)
+    if (event.userId === this.currentUserId) return;
+
+    switch (event.type) {
+      case 'section_created':
+        this.addSectionLocal(event.payload);
+        this.redrawCanvas();
+        break;
+
+      case 'section_updated':
+        this.updateSectionLocal(event.payload);
+        this.redrawCanvas();
+        break;
+
+      case 'section_deleted':
+        this.removeSectionLocal(event.payload.id);
+        this.redrawCanvas();
+        break;
+
+      case 'sections_reordered':
+        this.reorderSectionsLocal(event.payload.ordered_ids);
+        this.redrawCanvas();
+        break;
+
+      case 'task_created':
+        this.addTaskLocal(event.payload);
+        this.redrawCanvas();
+        break;
+
+      case 'task_updated':
+        this.updateTaskLocal(event.payload);
+        this.redrawCanvas();
+        break;
+
+      case 'task_deleted':
+        this.removeTaskLocal(event.payload.id);
+        this.redrawCanvas();
+        break;
+
+      case 'user_joined':
+        this.onlineUsers.add(event.userId!);
+        this.showOnlineIndicator();
+        break;
+
+      case 'user_left':
+        this.onlineUsers.delete(event.userId!);
+        this.showOnlineIndicator();
+        break;
+
+      // === Безопасность ===
+      case 'access_revoked':
+        this.router.navigate(['/gantt'], {
+          state: { alert: 'Доступ к пространству был отозван' }
+        });
+        break;
+
+      case 'chart_archived':
+        this.router.navigate(['/gantt'], {
+          state: { alert: 'Диаграмма была заархивирована' }
+        });
+        break;
+
+      case 'role_changed':
+        this.currentRole = event.payload.role;
+        this.updateEditableState();
+        break;
+
+      case 'token_expired':
+        this.router.navigate(['/auth/login']);
+        break;
+    }
+  }
+
+  private redrawCanvas(): void {
+    // Перерисовать Konva canvas с обновлёнными данными
+  }
+}
+

                    4.3. Индикатор онлайн-пользователей

                    +

                    Добавить в шаблон canvas-компонента:

                    +
                    <!-- Онлайн-индикатор -->
+<div class="online-indicator" *ngIf="onlineUsers.size > 0">
+  <span class="pulse-dot"></span>
+  {{ onlineUsers.size }} онлайн
+</div>
+
                    +

                    5. Безопасность

                    +

                    5.1. Авторизация при подключении

                    + + + + + + + + + + + + + + + + + + + + + +
                    ЭтапПроверка
                    WS HandshakeJWT в query-параметре ?token=...
                    Подписка на комнатуПроверка membership в space
                    Каждое broadcast-событиеHub знает userId каждого клиента
                    +

                    5.2. Сценарии отзыва доступа

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    СобытиеТриггерДействие на клиенте
                    access_revokedИсключение из spaceРедирект на список гантов
                    chart_archivedАрхивация гантаРедирект на список гантов
                    role_changedСмена роли (editor→viewer)Отключить редактирование
                    token_expiredТокен протухРедирект на логин
                    +

                    5.3. Защита от злоупотреблений

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    УгрозаМера
                    Спам WS-сообщенийRate limit: 30 msg/min на клиента, ReadLimit в gorilla/websocket
                    Подключение без правПроверка space membership при handshake
                    Истёкший токенPing/pong + периодическая проверка JWT (раз в 5 мин)
                    XSS через WSPayload — JSON, sanitize имён на frontend
                    Мутации через WSWS только для чтения (уведомления). Мутации — через HTTP API с полной валидацией
                    +

                    5.4. Nginx конфигурация

                    +

                    В конфиг sand.a2v.space добавить:

                    +
                    # WebSocket проксирование
+location /api/v1/ws/ {
+    proxy_pass http://127.0.0.1:8080;
+    proxy_http_version 1.1;
+    proxy_set_header Upgrade $http_upgrade;
+    proxy_set_header Connection "upgrade";
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_read_timeout 86400s;  # 24h для long-lived WS
+    proxy_send_timeout 86400s;
+}
+
                    +

                    6. Оценка трудозатрат

                    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                    КомпонентСтроки кодаВремя
                    internal/ws/ (hub, client, message)~2002-3 часа
                    ws_handler.go (endpoint)~6030 мин
                    Интеграция broadcast в handlers~20 (по строке на endpoint)30 мин
                    События безопасности в services~3030 мин
                    gantt-ws.service.ts (Angular)~801 час
                    Интеграция в canvas-компонент~801-2 часа
                    Индикатор онлайн~3030 мин
                    Nginx конфигурация~1010 мин
                    Тестирование—2-3 часа
                    Итого~510 строк~1-2 дня
                    +
                    +

                    7. Порядок реализации

                    +
                      +
                    1. Backend: internal/ws/ — hub, client, message types
                      2. +
                    2. Backend: WS endpoint — handler + route
                      3. +
                    3. Backend: Broadcast в handlers — интеграция в существующие CRUD-эндпоинты
                      4. +
                    4. Backend: События безопасности — access_revoked, chart_archived, role_changed
                      5. +
                    5. Nginx: WS location — проксирование WebSocket
                      6. +
                    6. Frontend: WS service — подключение, реконнект, парсинг событий
                      7. +
                    7. Frontend: Интеграция в canvas — обработка событий, обновление Konva
                      8. +
                    8. Frontend: Индикатор онлайн — визуальная обратная связь
                      9. +
                    9. Тестирование — многопользовательский сценарий, отзыв прав, обрывы связи
                      10. +
                    +
                    +

                    8. Дальнейшие улучшения (после MVP)

                    +
                      +
                    • Cursor других пользователей — показывать позицию курсора на таймлайне
                      • +
                    • Блокировка элемента — «кто-то редактирует эту задачу» (optimistic locking через WS)
                      • +
                    • Чат в ганте — комментарии к задачам прямо на канвасе
                      • +
                    • History/undo — откат изменений с визуальной историей
                      • +
                    • Уведомления — push-уведомления при @mention в комментариях к задачам
                      • +
                    + +
                    + +
                    +
                    +
                    + +
                    +
                    +

                    © 2026 docs.a2v.space

                    +
                    +
                    + + + + + + + + + + + + + + + diff --git a/public/personal-site/binary-files-in-repo/index.html b/public/personal-site/binary-files-in-repo/index.html index e557181..c630ebd 100644 --- a/public/personal-site/binary-files-in-repo/index.html +++ b/public/personal-site/binary-files-in-repo/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • @@ -111,6 +117,15 @@

                    Бинарный файл в репозитории

                    +
                    + + 📁 ~/Projects/docs-a2v/content/personal-site/binary-files-in-repo.md + + +
                    +

                    Проблема

                    В корне репозитория лежат два файла, которые не должны быть в git:

                      diff --git a/public/personal-site/copyright-outdated/index.html b/public/personal-site/copyright-outdated/index.html index 20910c6..b89b52c 100644 --- a/public/personal-site/copyright-outdated/index.html +++ b/public/personal-site/copyright-outdated/index.html @@ -38,6 +38,10 @@ Планы +
                    • + Leadera +
                      • +
                    • Инструкции
                      • @@ -94,6 +98,8 @@
                    • Планы
                      • +
                    • Leadera
                      • +
                    • Инструкции
                    • Креды
                      • @@ -111,6 +117,15 @@

                      Copyright без 2026 года

                      +
                      + + 📁 ~/Projects/docs-a2v/content/personal-site/copyright-outdated.md + + +
                      +

                      Проблема

                      В params.toml:

                      copyRight = "Copyright (c) 2020-2025 Антон Агальцов"
diff --git a/public/personal-site/digest-stale/index.html b/public/personal-site/digest-stale/index.html
index e42bc6f..4b58712 100644
--- a/public/personal-site/digest-stale/index.html
+++ b/public/personal-site/digest-stale/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -111,6 +117,15 @@
                 
 
                      
     
                      Digest не обновлялся с февраля 2025
                      
+    
                      
+    
+        📁 ~/Projects/docs-a2v/content/personal-site/digest-stale.md
+        
+    
+
                      
+
     
                      Проблема
                      
 
                      Последний дайджест — февраль 2025. С тех пор 12+ месяцев без новых выпусков.
                      
 
                      Что есть
                      
diff --git a/public/personal-site/index.html b/public/personal-site/index.html
index c2c95a8..c88cbb0 100644
--- a/public/personal-site/index.html
+++ b/public/personal-site/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,21 +121,21 @@
 
     
 
                      
diff --git a/public/personal-site/netlify-node-version/index.html b/public/personal-site/netlify-node-version/index.html
index 0b19704..afe4a80 100644
--- a/public/personal-site/netlify-node-version/index.html
+++ b/public/personal-site/netlify-node-version/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -111,6 +117,15 @@
                 
 
                      
     
                      Устаревший Node.js 16 в Netlify
                      
+    
                      
+    
+        📁 ~/Projects/docs-a2v/content/personal-site/netlify-node-version.md
+        
+    
+
                      
+
     
                      Устаревший Node.js 16 в Netlify
                      
 
                      Файл: netlify.toml:5
                      
 
                      NODE_VERSION = "16.16.0"
diff --git a/public/personal-site/no-analytics/index.html b/public/personal-site/no-analytics/index.html
index 72b600a..85e3888 100644
--- a/public/personal-site/no-analytics/index.html
+++ b/public/personal-site/no-analytics/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -111,6 +117,15 @@
                 
 
                      
     
                      Yandex Metrika отключена
                      
+    
                      
+    
+        📁 ~/Projects/docs-a2v/content/personal-site/no-analytics.md
+        
+    
+
                      
+
     
                      Проблема
                      
 
                      В params.toml: yandexMetrika = false
                      
 
                      Аналитика с сайта не собирается. Непонятно, есть ли вообще посетители и какие страницы популярны.
                      
diff --git a/public/personal-site/no-node-modules/index.html b/public/personal-site/no-node-modules/index.html
index ccae0e3..0520721 100644
--- a/public/personal-site/no-node-modules/index.html
+++ b/public/personal-site/no-node-modules/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -111,6 +117,15 @@
                 
 
                      
     
                      Отсутствуют node_modules — нужна установка
                      
+    
                      
+    
+        📁 ~/Projects/docs-a2v/content/personal-site/no-node-modules.md
+        
+    
+
                      
+
     
                      Проблема
                      
 
                      node_modules/ отсутствует — проект нельзя собрать без npm install.
                      
 
                      Риск
                      
diff --git a/public/personal-site/outdated-doks-theme/index.html b/public/personal-site/outdated-doks-theme/index.html
index 02813a6..b0623b2 100644
--- a/public/personal-site/outdated-doks-theme/index.html
+++ b/public/personal-site/outdated-doks-theme/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -111,6 +117,15 @@
                 
 
                      
     
                      Hugo Doks 0.5 — сильно устарел
                      
+    
                      
+    
+        📁 ~/Projects/docs-a2v/content/personal-site/outdated-doks-theme.md
+        
+    
+
                      
+
     
                      Проблема
                      
 
                      Проект использует тему Hyas/Doks v0.5.0 (package.json). Актуальная версия Doks — 1.x с полной переработкой архитектуры.
                      
 
                      Что не так
                      
diff --git a/public/personal-site/twitter-handle-mismatch/index.html b/public/personal-site/twitter-handle-mismatch/index.html
index 3cbd149..60d1bd4 100644
--- a/public/personal-site/twitter-handle-mismatch/index.html
+++ b/public/personal-site/twitter-handle-mismatch/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -111,6 +117,15 @@
                 
 
                      
     
                      Twitter handle не соответствует имени
                      
+    
                      
+    
+        📁 ~/Projects/docs-a2v/content/personal-site/twitter-handle-mismatch.md
+        
+    
+
                      
+
     
                      Проблема
                      
 
                      В params.toml указан Twitter: @AntonTotoshkin
                      
 
                      Но владелец сайта — Антон Агальцов. Ники не совпадают.
                      
diff --git a/public/plans/eversolo-companion-phases-3-9/index.html b/public/plans/eversolo-companion-phases-3-9/index.html
index a503073..8746c4b 100644
--- a/public/plans/eversolo-companion-phases-3-9/index.html
+++ b/public/plans/eversolo-companion-phases-3-9/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -103,6 +107,17 @@
             
                      
                 
 
                      
+    
                      Завершить Eversolo Companion - этапы 3-9
                      
+    
                      
+    
+        📁 ~/Projects/docs-a2v/content/plans/eversolo-companion-phases-3-9.md
+        
+    
+
                      
+
+
     
                      
         
                      Завершить Eversolo Companion - этапы 3-9
                      
         
diff --git a/public/plans/eversolo-control/index.html b/public/plans/eversolo-control/index.html
index b1f4106..ba43016 100644
--- a/public/plans/eversolo-control/index.html
+++ b/public/plans/eversolo-control/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -103,6 +107,17 @@
             
                      
                 
 
                      
+    
                      Реализовать управление Eversolo из OpenClaw
                      
+    
                      
+    
+        📁 ~/Projects/docs-a2v/content/plans/eversolo-control.md
+        
+    
+
                      
+
+
     
                      
         
                      Реализовать управление Eversolo из OpenClaw
                      
         
diff --git a/public/plans/index.html b/public/plans/index.html
index 32f656b..2e7a0c4 100644
--- a/public/plans/index.html
+++ b/public/plans/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
diff --git a/public/plans/ollama-openclaw/index.html b/public/plans/ollama-openclaw/index.html
index 9df7771..a108ed2 100644
--- a/public/plans/ollama-openclaw/index.html
+++ b/public/plans/ollama-openclaw/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -103,6 +107,17 @@
             
                      
                 
 
                      
+    
                      Настроить интеграцию Ollama с OpenClaw
                      
+    
                      
+    
+        📁 ~/Projects/docs-a2v/content/plans/ollama-openclaw.md
+        
+    
+
                      
+
+
     
                      
         
                      Настроить интеграцию Ollama с OpenClaw
                      
         
diff --git a/public/sitemap.xml b/public/sitemap.xml
index 670444f..592dc8f 100644
--- a/public/sitemap.xml
+++ b/public/sitemap.xml
@@ -2,11 +2,83 @@
 
   
+    /leadera/
+    2026-04-09T00:00:00+00:00
+  
     /personal-site/
     2026-03-31T00:00:00+00:00
   
-    /guides/leadera-audit/
+    /leadera/leadera-audit/
     2026-03-30T00:00:00+00:00
+  
+    /leadera/leadera-websocket-gantt/
+    2026-04-07T00:00:00+00:00
+  
+    /leadera/leadera-gantt-excel-export/
+    2026-04-09T00:00:00+00:00
+  
+    /leadera/leadera-gantt-filters/
+    2026-04-07T00:00:00+00:00
+  
+    /leadera/leadera-gantt-public-access/
+    2026-04-09T00:00:00+00:00
+  
+    /
+    2026-04-09T00:00:00+00:00
+  
+    /tags/excel/
+    2026-04-09T00:00:00+00:00
+  
+    /tags/export/
+    2026-04-09T00:00:00+00:00
+  
+    /tags/gantt/
+    2026-04-09T00:00:00+00:00
+  
+    /tags/leadera/
+    2026-04-09T00:00:00+00:00
+  
+    /tags/public-access/
+    2026-04-09T00:00:00+00:00
+  
+    /tags/sharing/
+    2026-04-09T00:00:00+00:00
+  
+    /tags/
+    2026-04-09T00:00:00+00:00
+  
+    /tags/angular/
+    2026-04-08T00:00:00+00:00
+  
+    /tags/api/
+    2026-04-08T00:00:00+00:00
+  
+    /tags/go/
+    2026-04-08T00:00:00+00:00
+  
+    /leadera/leadera-milestones/
+    2026-04-08T00:00:00+00:00
+  
+    /tags/ux/
+    2026-04-08T00:00:00+00:00
+  
+    /tags/architecture/
+    2026-04-07T00:00:00+00:00
+  
+    /tags/frontend/
+    2026-04-07T00:00:00+00:00
+  
+    /tags/realtime/
+    2026-04-07T00:00:00+00:00
+  
+    /tags/requirements/
+    2026-04-07T00:00:00+00:00
+  
+    /tags/websocket/
+    2026-04-07T00:00:00+00:00
+  
+    /leadera/leadera-section-constraints/
+    2026-04-06T00:00:00+00:00
   
     /diary/2026-03-31/
     2026-03-31T00:00:00+00:00
@@ -25,12 +97,6 @@
   
     /personal-site/digest-stale/
     2026-03-31T00:00:00+00:00
-  
-    /
-    2026-03-31T00:00:00+00:00
-  
-    /tags/gantt/
-    2026-03-31T00:00:00+00:00
   
     /tags/github/
     2026-03-31T00:00:00+00:00
@@ -43,9 +109,6 @@
   
     /tags/infrastructure/
     2026-03-31T00:00:00+00:00
-  
-    /tags/leadera/
-    2026-03-31T00:00:00+00:00
   
     /tags/opencode/
     2026-03-31T00:00:00+00:00
@@ -58,9 +121,6 @@
   
     /tags/system-utils/
     2026-03-31T00:00:00+00:00
-  
-    /tags/
-    2026-03-31T00:00:00+00:00
   
     /personal-site/twitter-handle-mismatch/
     2026-03-31T00:00:00+00:00
@@ -79,12 +139,6 @@
   
     /diary/2026-03-30/
     2026-03-30T00:00:00+00:00
-  
-    /tags/architecture/
-    2026-03-30T00:00:00+00:00
-  
-    /guides/
-    2026-03-30T00:00:00+00:00
   
     /tags/mtproxy/
     2026-03-30T00:00:00+00:00
@@ -109,12 +163,6 @@
   
     /tags/amnezia/
     2026-03-29T00:00:00+00:00
-  
-    /tags/angular/
-    2026-03-29T00:00:00+00:00
-  
-    /tags/api/
-    2026-03-29T00:00:00+00:00
   
     /tags/authentication/
     2026-03-29T00:00:00+00:00
@@ -152,7 +200,7 @@
     /kb/eversolo-api/
     2026-03-29T00:00:00+00:00
   
-    /tags/go/
+    /guides/
     2026-03-29T00:00:00+00:00
   
     /tags/identity/
diff --git a/public/statuses/index.html b/public/statuses/index.html
index 6a325f7..6083e7f 100644
--- a/public/statuses/index.html
+++ b/public/statuses/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
diff --git a/public/tags/amnezia/index.html b/public/tags/amnezia/index.html
index e2e98da..804267c 100644
--- a/public/tags/amnezia/index.html
+++ b/public/tags/amnezia/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
diff --git a/public/tags/angular/index.html b/public/tags/angular/index.html
index 77b64e2..e23f4ff 100644
--- a/public/tags/angular/index.html
+++ b/public/tags/angular/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,11 +121,15 @@
 
     
 
                      
diff --git a/public/tags/angular/index.xml b/public/tags/angular/index.xml
index 1eb2356..42f95a7 100644
--- a/public/tags/angular/index.xml
+++ b/public/tags/angular/index.xml
@@ -6,8 +6,22 @@
     Recent content in Angular on docs.a2v.space
     Hugo
     ru-ru
-    Sun, 29 Mar 2026 00:00:00 +0000
+    Wed, 08 Apr 2026 00:00:00 +0000
     
+    
+      Leadera: Вехи (Milestones) на диаграмме Ганта
+      /leadera/leadera-milestones/
+      Wed, 08 Apr 2026 00:00:00 +0000
+      /leadera/leadera-milestones/
+      <h2 id="бизнес-требования">Бизнес-требования</h2>
<h3 id="br-1-сущность-веха-milestone">BR-1: Сущность «Веха» (Milestone)</h3>
<p>Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.</p>
<p><strong>Поля вехи:</strong></p>
<table>
  <thead>
      <tr>
          <th>Поле</th>
          <th>Тип</th>
          <th>Описание</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>id</td>
          <td>UUID</td>
          <td>Идентификатор</td>
      </tr>
      <tr>
          <td>gantt_chart_id</td>
          <td>UUID</td>
          <td>Принадлежность к диаграмме (не к секции!)</td>
      </tr>
      <tr>
          <td>title</td>
          <td>string</td>
          <td>Название вехи (обязательное, 1–255 символов)</td>
      </tr>
      <tr>
          <td>date</td>
          <td>date</td>
          <td>Дата вехи (без времени, обязательная)</td>
      </tr>
      <tr>
          <td>color</td>
          <td>string</td>
          <td>Цвет маркера (HEX, по умолчанию <code>#dc3545</code> — красный)</td>
      </tr>
      <tr>
          <td>created_by</td>
          <td>UUID</td>
          <td>Кто создал (не отображается в UI, хранится для аудита)</td>
      </tr>
      <tr>
          <td>updated_by</td>
          <td>UUID</td>
          <td>Кто обновил (не отображается в UI)</td>
      </tr>
      <tr>
          <td>created_at</td>
          <td>timestamp</td>
          <td>Дата создания</td>
      </tr>
      <tr>
          <td>updated_at</td>
          <td>timestamp</td>
          <td>Дата обновления</td>
      </tr>
      <tr>
          <td>deleted_at</td>
          <td>timestamp</td>
          <td>Soft delete</td>
      </tr>
  </tbody>
</table>
<p><strong>Права доступа:</strong> Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).</p>
+    
+    
+      Leadera: Ограничения секций в диаграмме Ганта
+      /leadera/leadera-section-constraints/
+      Mon, 06 Apr 2026 00:00:00 +0000
+      /leadera/leadera-section-constraints/
+      <h2 id="бизнес-требования">Бизнес-требования</h2>
<h3 id="br-1-лимит-одновременных-задач-concurrency-limit">BR-1: Лимит одновременных задач (Concurrency Limit)</h3>
<p>У каждой секции появляется параметр <strong>max_concurrent_tasks</strong> (целое число ≥ 0, по умолчанию 0).</p>
<p><strong>Поведение:</strong></p>
<ul>
<li>Если <code>max_concurrent_tasks = 3</code> — в любой данный день в этой секции не может быть больше 3 активных задач одновременно</li>
<li>Если <code>max_concurrent_tasks = 0</code> — ограничение отключено, лимита нет</li>
<li>Пересечение считается по дате: задача занимает дни с <code>start_date</code> по <code>end_date</code> включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день</li>
<li>Ограничение работает <strong>только в рамках одной секции</strong>. Задачи из разных секций не влияют друг на друга</li>
</ul>
<p><strong>Срабатывание при:</strong></p>
+    
     
       29 марта 2026
       /diary/2026-03-29/
diff --git a/public/tags/api/index.html b/public/tags/api/index.html
index 6c5beff..f819b25 100644
--- a/public/tags/api/index.html
+++ b/public/tags/api/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,10 +121,16 @@
 
     
 
                      
 
diff --git a/public/tags/api/index.xml b/public/tags/api/index.xml
index 553e115..fe74916 100644
--- a/public/tags/api/index.xml
+++ b/public/tags/api/index.xml
@@ -6,8 +6,29 @@
     Recent content in Api on docs.a2v.space
     Hugo
     ru-ru
-    Sun, 29 Mar 2026 00:00:00 +0000
+    Wed, 08 Apr 2026 00:00:00 +0000
     
+    
+      Leadera — Фильтры и реорганизация списка диаграмм Ганта
+      /leadera/leadera-gantt-filters/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /leadera/leadera-gantt-filters/
+      <h1 id="фильтры-и-реорганизация-списка-диаграмм-ганта">Фильтры и реорганизация списка диаграмм Ганта</h1>
<p><strong>Дата:</strong> 07.04.2026
<strong>Статус:</strong> Требования
<strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p>
<hr>
<h2 id="1-постановка-задачи">1. Постановка задачи</h2>
<p>Список диаграмм Ганта должен показывать <strong>все доступные пользователю диаграммы</strong> из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.</p>
<hr>
<h2 id="2-изменения-api">2. Изменения API</h2>
<h3 id="21-новый-endpoint-списка-диаграмм">2.1. Новый endpoint списка диаграмм</h3>
<p><strong>Было:</strong></p>
<pre tabindex="0"><code>GET /api/v1/spaces/{spaceId}/gantt-charts?page=1&amp;per_page=10
</code></pre><p><strong>Стало:</strong></p>
<pre tabindex="0"><code>GET /api/v1/gantt-charts?page=1&amp;per_page=10
</code></pre><p>Пользователь видит все диаграммы из <strong>всех пространств</strong>, где он является подтверждённым участником (статус <code>accepted</code>).</p>
+    
+    
+      Leadera: Вехи (Milestones) на диаграмме Ганта
+      /leadera/leadera-milestones/
+      Wed, 08 Apr 2026 00:00:00 +0000
+      /leadera/leadera-milestones/
+      <h2 id="бизнес-требования">Бизнес-требования</h2>
<h3 id="br-1-сущность-веха-milestone">BR-1: Сущность «Веха» (Milestone)</h3>
<p>Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.</p>
<p><strong>Поля вехи:</strong></p>
<table>
  <thead>
      <tr>
          <th>Поле</th>
          <th>Тип</th>
          <th>Описание</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>id</td>
          <td>UUID</td>
          <td>Идентификатор</td>
      </tr>
      <tr>
          <td>gantt_chart_id</td>
          <td>UUID</td>
          <td>Принадлежность к диаграмме (не к секции!)</td>
      </tr>
      <tr>
          <td>title</td>
          <td>string</td>
          <td>Название вехи (обязательное, 1–255 символов)</td>
      </tr>
      <tr>
          <td>date</td>
          <td>date</td>
          <td>Дата вехи (без времени, обязательная)</td>
      </tr>
      <tr>
          <td>color</td>
          <td>string</td>
          <td>Цвет маркера (HEX, по умолчанию <code>#dc3545</code> — красный)</td>
      </tr>
      <tr>
          <td>created_by</td>
          <td>UUID</td>
          <td>Кто создал (не отображается в UI, хранится для аудита)</td>
      </tr>
      <tr>
          <td>updated_by</td>
          <td>UUID</td>
          <td>Кто обновил (не отображается в UI)</td>
      </tr>
      <tr>
          <td>created_at</td>
          <td>timestamp</td>
          <td>Дата создания</td>
      </tr>
      <tr>
          <td>updated_at</td>
          <td>timestamp</td>
          <td>Дата обновления</td>
      </tr>
      <tr>
          <td>deleted_at</td>
          <td>timestamp</td>
          <td>Soft delete</td>
      </tr>
  </tbody>
</table>
<p><strong>Права доступа:</strong> Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).</p>
+    
+    
+      Leadera: Ограничения секций в диаграмме Ганта
+      /leadera/leadera-section-constraints/
+      Mon, 06 Apr 2026 00:00:00 +0000
+      /leadera/leadera-section-constraints/
+      <h2 id="бизнес-требования">Бизнес-требования</h2>
<h3 id="br-1-лимит-одновременных-задач-concurrency-limit">BR-1: Лимит одновременных задач (Concurrency Limit)</h3>
<p>У каждой секции появляется параметр <strong>max_concurrent_tasks</strong> (целое число ≥ 0, по умолчанию 0).</p>
<p><strong>Поведение:</strong></p>
<ul>
<li>Если <code>max_concurrent_tasks = 3</code> — в любой данный день в этой секции не может быть больше 3 активных задач одновременно</li>
<li>Если <code>max_concurrent_tasks = 0</code> — ограничение отключено, лимита нет</li>
<li>Пересечение считается по дате: задача занимает дни с <code>start_date</code> по <code>end_date</code> включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день</li>
<li>Ограничение работает <strong>только в рамках одной секции</strong>. Задачи из разных секций не влияют друг на друга</li>
</ul>
<p><strong>Срабатывание при:</strong></p>
+    
     
       Eversolo T8 API
       /kb/eversolo-api/
diff --git a/public/tags/architecture/index.html b/public/tags/architecture/index.html
index f971379..e89f2c8 100644
--- a/public/tags/architecture/index.html
+++ b/public/tags/architecture/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,7 +121,9 @@
 
     
 
                      
diff --git a/public/tags/architecture/index.xml b/public/tags/architecture/index.xml
index 0d39ee3..c8e03e3 100644
--- a/public/tags/architecture/index.xml
+++ b/public/tags/architecture/index.xml
@@ -6,14 +6,21 @@
     Recent content in Architecture on docs.a2v.space
     Hugo
     ru-ru
-    Mon, 30 Mar 2026 00:00:00 +0000
+    Tue, 07 Apr 2026 00:00:00 +0000
     
     
       Аудит Leadera — полный отчёт
-      /guides/leadera-audit/
+      /leadera/leadera-audit/
       Mon, 30 Mar 2026 00:00:00 +0000
-      /guides/leadera-audit/
+      /leadera/leadera-audit/
       <h1 id="аудит-проекта-leadera">Аудит проекта Leadera</h1>
<p><strong>Дата:</strong> 30.03.2026<br>
<strong>Версия:</strong> pre-production, миграции 1–5</p>
<hr>
<h2 id="1-обзор-проекта">1. Обзор проекта</h2>
<p>Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.</p>
<h3 id="стек">Стек</h3>
<table>
  <thead>
      <tr>
          <th>Компонент</th>
          <th>Технологии</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>Backend</td>
          <td>Go 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256)</td>
      </tr>
      <tr>
          <td>Frontend</td>
          <td>Angular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals</td>
      </tr>
      <tr>
          <td>Инфраструктура</td>
          <td>Docker (Colima), pm2, nginx reverse proxy, VPS reg.ru</td>
      </tr>
  </tbody>
</table>
<h3 id="доменная-модель">Доменная модель</h3>
<pre tabindex="0"><code>User ──┬── Space (через space_members с role)
        │
        └── GanttChart (принадлежит Space)
              ├── GanttSection
              └── GanttTask
</code></pre><p><strong>Роли:</strong> admin, editor, viewer — назначаются <strong>на уровне Space</strong> через таблицу <code>space_members</code>.</p>
     
+    
+      Leadera — WebSocket для диаграмм Ганта
+      /leadera/leadera-websocket-gantt/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /leadera/leadera-websocket-gantt/
+      <h1 id="websocket-для-диаграмм-ганта--realtime-совместное-редактирование">WebSocket для диаграмм Ганта — realtime-совместное редактирование</h1>
<p><strong>Дата:</strong> 07.04.2026
<strong>Статус:</strong> Планирование
<strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p>
<hr>
<h2 id="1-постановка-задачи">1. Постановка задачи</h2>
<p>Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.</p>
<hr>
<h2 id="2-архитектура">2. Архитектура</h2>
<pre tabindex="0"><code>Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL
       │                                │
       │  HTTP (мутации)                │  Broadcast
       └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты
</code></pre><p><strong>Ключевой принцип:</strong> мутации данных идут через HTTP (REST), WebSocket используется <strong>только для доставки уведомлений</strong>. Сервер — источник истины, клиент не может обойти проверки через WS.</p>
+    
   
 
diff --git a/public/tags/audit/index.html b/public/tags/audit/index.html
index 6a1e50b..cd23889 100644
--- a/public/tags/audit/index.html
+++ b/public/tags/audit/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,25 +121,25 @@
 
     
 
                      
diff --git a/public/tags/audit/index.xml b/public/tags/audit/index.xml
index 1660557..1dd9053 100644
--- a/public/tags/audit/index.xml
+++ b/public/tags/audit/index.xml
@@ -17,9 +17,9 @@
     
     
       Аудит Leadera — полный отчёт
-      /guides/leadera-audit/
+      /leadera/leadera-audit/
       Mon, 30 Mar 2026 00:00:00 +0000
-      /guides/leadera-audit/
+      /leadera/leadera-audit/
       <h1 id="аудит-проекта-leadera">Аудит проекта Leadera</h1>
<p><strong>Дата:</strong> 30.03.2026<br>
<strong>Версия:</strong> pre-production, миграции 1–5</p>
<hr>
<h2 id="1-обзор-проекта">1. Обзор проекта</h2>
<p>Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.</p>
<h3 id="стек">Стек</h3>
<table>
  <thead>
      <tr>
          <th>Компонент</th>
          <th>Технологии</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>Backend</td>
          <td>Go 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256)</td>
      </tr>
      <tr>
          <td>Frontend</td>
          <td>Angular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals</td>
      </tr>
      <tr>
          <td>Инфраструктура</td>
          <td>Docker (Colima), pm2, nginx reverse proxy, VPS reg.ru</td>
      </tr>
  </tbody>
</table>
<h3 id="доменная-модель">Доменная модель</h3>
<pre tabindex="0"><code>User ──┬── Space (через space_members с role)
        │
        └── GanttChart (принадлежит Space)
              ├── GanttSection
              └── GanttTask
</code></pre><p><strong>Роли:</strong> admin, editor, viewer — назначаются <strong>на уровне Space</strong> через таблицу <code>space_members</code>.</p>
     
     
diff --git a/public/tags/authentication/index.html b/public/tags/authentication/index.html
index 3c25b51..eabc56c 100644
--- a/public/tags/authentication/index.html
+++ b/public/tags/authentication/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
diff --git a/public/tags/canvas/index.html b/public/tags/canvas/index.html
index f2acdb5..29228bd 100644
--- a/public/tags/canvas/index.html
+++ b/public/tags/canvas/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
diff --git a/public/tags/companion/index.html b/public/tags/companion/index.html
index 8c6410c..596050c 100644
--- a/public/tags/companion/index.html
+++ b/public/tags/companion/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,11 +121,11 @@
 
     
 
                      
diff --git a/public/tags/database/index.html b/public/tags/database/index.html
index 2b9b99f..2bff7da 100644
--- a/public/tags/database/index.html
+++ b/public/tags/database/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,10 +121,10 @@
 
     
 
                      
 
diff --git a/public/tags/devops/index.html b/public/tags/devops/index.html
index e77e5cd..eed04c3 100644
--- a/public/tags/devops/index.html
+++ b/public/tags/devops/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
diff --git a/public/tags/docker-compose/index.html b/public/tags/docker-compose/index.html
index a519af6..5c8eea4 100644
--- a/public/tags/docker-compose/index.html
+++ b/public/tags/docker-compose/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
diff --git a/public/tags/docker/index.html b/public/tags/docker/index.html
index 827a341..c1b5947 100644
--- a/public/tags/docker/index.html
+++ b/public/tags/docker/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,15 +121,15 @@
 
     
 
                      
diff --git a/public/tags/docs/index.html b/public/tags/docs/index.html
index 0726768..c4f44e5 100644
--- a/public/tags/docs/index.html
+++ b/public/tags/docs/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,10 +121,10 @@
 
     
 
                      
 
diff --git a/public/tags/eversolo/index.html b/public/tags/eversolo/index.html
index f349975..4fc4403 100644
--- a/public/tags/eversolo/index.html
+++ b/public/tags/eversolo/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,15 +121,15 @@
 
     
 
                      
diff --git a/public/tags/excel/index.html b/public/tags/excel/index.html
new file mode 100644
index 0000000..05235e8
--- /dev/null
+++ b/public/tags/excel/index.html
@@ -0,0 +1,152 @@
+
+
+
+    
+    
+    Excel — docs.a2v.space
+
+    
+    
+
+    
+    
+
+    
+
+
+    
                      
+    
+
+    
+    
+
                      
+
+
+    
                      
+        
                      
+            
+            
+            
+
+            
                      
+                
+
                      
+    
                      Excel
                      
+    
+
+    
+
                      
+
+            
                      
+        
                      
+    
                      
+
+    
                      
+    
                      
+        
                      © 2026 docs.a2v.space
                      
+    
                      
+
                      
+
+
+    
+    
+
+    
+    
+
+    
+    
+    
+
+    
+
+
diff --git a/public/tags/excel/index.xml b/public/tags/excel/index.xml
new file mode 100644
index 0000000..e741c8a
--- /dev/null
+++ b/public/tags/excel/index.xml
@@ -0,0 +1,19 @@
+
+
+  
+    Excel on docs.a2v.space
+    /tags/excel/
+    Recent content in Excel on docs.a2v.space
+    Hugo
+    ru-ru
+    Thu, 09 Apr 2026 00:00:00 +0000
+    
+    
+      Leadera — Экспорт диаграммы Ганта в Excel
+      /leadera/leadera-gantt-excel-export/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /leadera/leadera-gantt-excel-export/
+      <h1 id="экспорт-диаграммы-ганта-в-excel">Экспорт диаграммы Ганта в Excel</h1>
<p><strong>Дата:</strong> 09.04.2026
<strong>Статус:</strong> Требования
<strong>Проект:</strong> Leadera</p>
<hr>
<h2 id="общее-описание">Общее описание</h2>
<p>Пользователь нажимает кнопку экспорта в интерфейсе диаграммы Ганта. Система запрашивает диапазон дат выгрузки (по умолчанию — текущий видимый диапазон из интерфейса). После указания диапазона скачивается Excel-файл с визуальным представлением диаграммы Ганта.</p>
<hr>
<h2 id="вводные-данные">Вводные данные</h2>
<ul>
<li><strong>Источник:</strong> текущая диаграмма Ганта проекта (один проект = одна диаграмма)</li>
<li><strong>Диапазон дат:</strong> пользователь указывает начальную и конечную дату. По умолчанию подставляется видимый в момент запроса диапазон из интерфейса</li>
<li><strong>Масштаб таймлайна:</strong> берётся тот, который выбран пользователем в интерфейсе в момент запроса (не сохранённый в системе, а текущий). Варианты: по ячейкам или по дням</li>
</ul>
<hr>
<h2 id="структура-excel-файла">Структура Excel-файла</h2>
<h3 id="шапка-первые-строки">Шапка (первые строки)</h3>
<ul>
<li>Название диаграммы (название проекта)</li>
<li>Диапазон дат, в рамках которого сделана выгрузка</li>
</ul>
<h3 id="лист--один">Лист — один</h3>
<p>Вся диаграмма размещается на одном листе.</p>
+    
+  
+
diff --git a/public/tags/export/index.html b/public/tags/export/index.html
new file mode 100644
index 0000000..d41fdf1
--- /dev/null
+++ b/public/tags/export/index.html
@@ -0,0 +1,152 @@
+
+
+
+    
+    
+    Export — docs.a2v.space
+
+    
+    
+
+    
+    
+
+    
+
+
+    
                      
+    
+
+    
+    
+
                      
+
+
+    
                      
+        
                      
+            
+            
+            
+
+            
                      
+                
+
                      
+    
                      Export
                      
+    
+
+    
+
                      
+
+            
                      
+        
                      
+    
                      
+
+    
                      
+    
                      
+        
                      © 2026 docs.a2v.space
                      
+    
                      
+
                      
+
+
+    
+    
+
+    
+    
+
+    
+    
+    
+
+    
+
+
diff --git a/public/tags/export/index.xml b/public/tags/export/index.xml
new file mode 100644
index 0000000..74d3ac3
--- /dev/null
+++ b/public/tags/export/index.xml
@@ -0,0 +1,19 @@
+
+
+  
+    Export on docs.a2v.space
+    /tags/export/
+    Recent content in Export on docs.a2v.space
+    Hugo
+    ru-ru
+    Thu, 09 Apr 2026 00:00:00 +0000
+    
+    
+      Leadera — Экспорт диаграммы Ганта в Excel
+      /leadera/leadera-gantt-excel-export/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /leadera/leadera-gantt-excel-export/
+      <h1 id="экспорт-диаграммы-ганта-в-excel">Экспорт диаграммы Ганта в Excel</h1>
<p><strong>Дата:</strong> 09.04.2026
<strong>Статус:</strong> Требования
<strong>Проект:</strong> Leadera</p>
<hr>
<h2 id="общее-описание">Общее описание</h2>
<p>Пользователь нажимает кнопку экспорта в интерфейсе диаграммы Ганта. Система запрашивает диапазон дат выгрузки (по умолчанию — текущий видимый диапазон из интерфейса). После указания диапазона скачивается Excel-файл с визуальным представлением диаграммы Ганта.</p>
<hr>
<h2 id="вводные-данные">Вводные данные</h2>
<ul>
<li><strong>Источник:</strong> текущая диаграмма Ганта проекта (один проект = одна диаграмма)</li>
<li><strong>Диапазон дат:</strong> пользователь указывает начальную и конечную дату. По умолчанию подставляется видимый в момент запроса диапазон из интерфейса</li>
<li><strong>Масштаб таймлайна:</strong> берётся тот, который выбран пользователем в интерфейсе в момент запроса (не сохранённый в системе, а текущий). Варианты: по ячейкам или по дням</li>
</ul>
<hr>
<h2 id="структура-excel-файла">Структура Excel-файла</h2>
<h3 id="шапка-первые-строки">Шапка (первые строки)</h3>
<ul>
<li>Название диаграммы (название проекта)</li>
<li>Диапазон дат, в рамках которого сделана выгрузка</li>
</ul>
<h3 id="лист--один">Лист — один</h3>
<p>Вся диаграмма размещается на одном листе.</p>
+    
+  
+
diff --git a/public/tags/frontend/index.html b/public/tags/frontend/index.html
new file mode 100644
index 0000000..3e2a38d
--- /dev/null
+++ b/public/tags/frontend/index.html
@@ -0,0 +1,152 @@
+
+
+
+    
+    
+    Frontend — docs.a2v.space
+
+    
+    
+
+    
+    
+
+    
+
+
+    
                      
+    
+
+    
+    
+
                      
+
+
+    
                      
+        
                      
+            
+            
+            
+
+            
                      
+                
+
                      
+    
                      Frontend
                      
+    
+
+    
+
                      
+
+            
                      
+        
                      
+    
                      
+
+    
                      
+    
                      
+        
                      © 2026 docs.a2v.space
                      
+    
                      
+
                      
+
+
+    
+    
+
+    
+    
+
+    
+    
+    
+
+    
+
+
diff --git a/public/tags/frontend/index.xml b/public/tags/frontend/index.xml
new file mode 100644
index 0000000..51f0406
--- /dev/null
+++ b/public/tags/frontend/index.xml
@@ -0,0 +1,19 @@
+
+
+  
+    Frontend on docs.a2v.space
+    /tags/frontend/
+    Recent content in Frontend on docs.a2v.space
+    Hugo
+    ru-ru
+    Tue, 07 Apr 2026 00:00:00 +0000
+    
+    
+      Leadera — Фильтры и реорганизация списка диаграмм Ганта
+      /leadera/leadera-gantt-filters/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /leadera/leadera-gantt-filters/
+      <h1 id="фильтры-и-реорганизация-списка-диаграмм-ганта">Фильтры и реорганизация списка диаграмм Ганта</h1>
<p><strong>Дата:</strong> 07.04.2026
<strong>Статус:</strong> Требования
<strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p>
<hr>
<h2 id="1-постановка-задачи">1. Постановка задачи</h2>
<p>Список диаграмм Ганта должен показывать <strong>все доступные пользователю диаграммы</strong> из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.</p>
<hr>
<h2 id="2-изменения-api">2. Изменения API</h2>
<h3 id="21-новый-endpoint-списка-диаграмм">2.1. Новый endpoint списка диаграмм</h3>
<p><strong>Было:</strong></p>
<pre tabindex="0"><code>GET /api/v1/spaces/{spaceId}/gantt-charts?page=1&amp;per_page=10
</code></pre><p><strong>Стало:</strong></p>
<pre tabindex="0"><code>GET /api/v1/gantt-charts?page=1&amp;per_page=10
</code></pre><p>Пользователь видит все диаграммы из <strong>всех пространств</strong>, где он является подтверждённым участником (статус <code>accepted</code>).</p>
+    
+  
+
diff --git a/public/tags/gantt/index.html b/public/tags/gantt/index.html
index 5240ea4..b4f3586 100644
--- a/public/tags/gantt/index.html
+++ b/public/tags/gantt/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,6 +121,18 @@
 
     
diff --git a/public/tags/gantt/index.xml b/public/tags/gantt/index.xml
index 0e5dc9d..ad4ef58 100644
--- a/public/tags/gantt/index.xml
+++ b/public/tags/gantt/index.xml
@@ -6,8 +6,50 @@
     Recent content in Gantt on docs.a2v.space
     Hugo
     ru-ru
-    Tue, 31 Mar 2026 00:00:00 +0000
+    Thu, 09 Apr 2026 00:00:00 +0000
     
+    
+      Leadera — WebSocket для диаграмм Ганта
+      /leadera/leadera-websocket-gantt/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /leadera/leadera-websocket-gantt/
+      <h1 id="websocket-для-диаграмм-ганта--realtime-совместное-редактирование">WebSocket для диаграмм Ганта — realtime-совместное редактирование</h1>
<p><strong>Дата:</strong> 07.04.2026
<strong>Статус:</strong> Планирование
<strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p>
<hr>
<h2 id="1-постановка-задачи">1. Постановка задачи</h2>
<p>Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.</p>
<hr>
<h2 id="2-архитектура">2. Архитектура</h2>
<pre tabindex="0"><code>Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL
       │                                │
       │  HTTP (мутации)                │  Broadcast
       └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты
</code></pre><p><strong>Ключевой принцип:</strong> мутации данных идут через HTTP (REST), WebSocket используется <strong>только для доставки уведомлений</strong>. Сервер — источник истины, клиент не может обойти проверки через WS.</p>
+    
+    
+      Leadera — Экспорт диаграммы Ганта в Excel
+      /leadera/leadera-gantt-excel-export/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /leadera/leadera-gantt-excel-export/
+      <h1 id="экспорт-диаграммы-ганта-в-excel">Экспорт диаграммы Ганта в Excel</h1>
<p><strong>Дата:</strong> 09.04.2026
<strong>Статус:</strong> Требования
<strong>Проект:</strong> Leadera</p>
<hr>
<h2 id="общее-описание">Общее описание</h2>
<p>Пользователь нажимает кнопку экспорта в интерфейсе диаграммы Ганта. Система запрашивает диапазон дат выгрузки (по умолчанию — текущий видимый диапазон из интерфейса). После указания диапазона скачивается Excel-файл с визуальным представлением диаграммы Ганта.</p>
<hr>
<h2 id="вводные-данные">Вводные данные</h2>
<ul>
<li><strong>Источник:</strong> текущая диаграмма Ганта проекта (один проект = одна диаграмма)</li>
<li><strong>Диапазон дат:</strong> пользователь указывает начальную и конечную дату. По умолчанию подставляется видимый в момент запроса диапазон из интерфейса</li>
<li><strong>Масштаб таймлайна:</strong> берётся тот, который выбран пользователем в интерфейсе в момент запроса (не сохранённый в системе, а текущий). Варианты: по ячейкам или по дням</li>
</ul>
<hr>
<h2 id="структура-excel-файла">Структура Excel-файла</h2>
<h3 id="шапка-первые-строки">Шапка (первые строки)</h3>
<ul>
<li>Название диаграммы (название проекта)</li>
<li>Диапазон дат, в рамках которого сделана выгрузка</li>
</ul>
<h3 id="лист--один">Лист — один</h3>
<p>Вся диаграмма размещается на одном листе.</p>
+    
+    
+      Leadera — Фильтры и реорганизация списка диаграмм Ганта
+      /leadera/leadera-gantt-filters/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /leadera/leadera-gantt-filters/
+      <h1 id="фильтры-и-реорганизация-списка-диаграмм-ганта">Фильтры и реорганизация списка диаграмм Ганта</h1>
<p><strong>Дата:</strong> 07.04.2026
<strong>Статус:</strong> Требования
<strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p>
<hr>
<h2 id="1-постановка-задачи">1. Постановка задачи</h2>
<p>Список диаграмм Ганта должен показывать <strong>все доступные пользователю диаграммы</strong> из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.</p>
<hr>
<h2 id="2-изменения-api">2. Изменения API</h2>
<h3 id="21-новый-endpoint-списка-диаграмм">2.1. Новый endpoint списка диаграмм</h3>
<p><strong>Было:</strong></p>
<pre tabindex="0"><code>GET /api/v1/spaces/{spaceId}/gantt-charts?page=1&amp;per_page=10
</code></pre><p><strong>Стало:</strong></p>
<pre tabindex="0"><code>GET /api/v1/gantt-charts?page=1&amp;per_page=10
</code></pre><p>Пользователь видит все диаграммы из <strong>всех пространств</strong>, где он является подтверждённым участником (статус <code>accepted</code>).</p>
+    
+    
+      Leadera — Публичный доступ к диаграмме Ганта
+      /leadera/leadera-gantt-public-access/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /leadera/leadera-gantt-public-access/
+      <h1 id="публичный-доступ-к-диаграмме-ганта-share">Публичный доступ к диаграмме Ганта (Share)</h1>
<p><strong>Дата:</strong> 09.04.2026
<strong>Статус:</strong> Требования
<strong>Проект:</strong> Leadera</p>
<hr>
<h2 id="общее-описание">Общее описание</h2>
<p>Пользователь может создать публичную ссылку на фрагмент диаграммы Ганта, доступную для просмотра без авторизации. Открывший ссылку видит диаграмму в read-only режиме с возможностью масштабирования таймлайна, но без каких-либо элементов управления (создание, редактирование, удаление задач/секций/вех).</p>
<hr>
<h2 id="пользовательский-сценарий-создатель-ссылки">Пользовательский сценарий (создатель ссылки)</h2>
<ol>
<li>Пользователь открывает диаграмму Ганта проекта</li>
<li>Нажимает кнопку «Экспорт» / «Общий доступ»</li>
<li>Указывает диапазон дат, который должен отображаться на диаграмме</li>
<li>Система генерирует уникальную ссылку (UUID) и показывает её пользователю</li>
<li>Пользователь копирует ссылку и передаёт заинтересованным лицам</li>
</ol>
<h3 id="управление-ссылками">Управление ссылками</h3>
<ul>
<li>Вызывается через меню экспорта → модальное окно «Общий доступ»</li>
<li>В модальном окне отображается список созданных ссылок с указанием диапазона дат</li>
<li>Каждую ссылку можно <strong>удалить</strong> (полное удаление из БД, не soft delete)</li>
<li>Ссылки <strong>нельзя редактировать</strong> — только создавать и удалять</li>
<li>Ограничений на количество активных ссылок нет</li>
<li>Статистика просмотров (сколько раз открывали) — <strong>не нужна</strong></li>
</ul>
<hr>
<h2 id="пользовательский-сценарий-зритель-по-ссылке">Пользовательский сценарий (зритель по ссылке)</h2>
<ol>
<li>Зритель переходит по ссылке (без авторизации)</li>
<li>Открывается отдельная страница с диаграммой Ганта</li>
<li>Зритель видит:
<ul>
<li>Задачи и вехи, попадающие в заданный диапазон</li>
<li>Секции (заголовки группировок)</li>
<li>Таймлайн с цветовой раскраской задач</li>
</ul>
</li>
<li>Зритель может:
<ul>
<li>Масштабировать таймлайн</li>
<li>Переключать отображение «по ячейкам» / «по дням»</li>
</ul>
</li>
<li>Зритель <strong>не может</strong>:
<ul>
<li>Создавать, редактировать, удалять задачи / секции / вехи</li>
<li>Видеть любые контролы управления (кнопки создания, контекстные меню, drag-and-drop и т.д.)</li>
<li>Авторизоваться через эту страницу</li>
</ul>
</li>
</ol>
<hr>
<h2 id="данные-и-фильтрация">Данные и фильтрация</h2>
<h3 id="что-попадает-в-представление">Что попадает в представление</h3>
<p>Задачи и вехи, у которых хотя бы одно из условий верно:</p>
+    
+    
+      Leadera: Вехи (Milestones) на диаграмме Ганта
+      /leadera/leadera-milestones/
+      Wed, 08 Apr 2026 00:00:00 +0000
+      /leadera/leadera-milestones/
+      <h2 id="бизнес-требования">Бизнес-требования</h2>
<h3 id="br-1-сущность-веха-milestone">BR-1: Сущность «Веха» (Milestone)</h3>
<p>Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.</p>
<p><strong>Поля вехи:</strong></p>
<table>
  <thead>
      <tr>
          <th>Поле</th>
          <th>Тип</th>
          <th>Описание</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>id</td>
          <td>UUID</td>
          <td>Идентификатор</td>
      </tr>
      <tr>
          <td>gantt_chart_id</td>
          <td>UUID</td>
          <td>Принадлежность к диаграмме (не к секции!)</td>
      </tr>
      <tr>
          <td>title</td>
          <td>string</td>
          <td>Название вехи (обязательное, 1–255 символов)</td>
      </tr>
      <tr>
          <td>date</td>
          <td>date</td>
          <td>Дата вехи (без времени, обязательная)</td>
      </tr>
      <tr>
          <td>color</td>
          <td>string</td>
          <td>Цвет маркера (HEX, по умолчанию <code>#dc3545</code> — красный)</td>
      </tr>
      <tr>
          <td>created_by</td>
          <td>UUID</td>
          <td>Кто создал (не отображается в UI, хранится для аудита)</td>
      </tr>
      <tr>
          <td>updated_by</td>
          <td>UUID</td>
          <td>Кто обновил (не отображается в UI)</td>
      </tr>
      <tr>
          <td>created_at</td>
          <td>timestamp</td>
          <td>Дата создания</td>
      </tr>
      <tr>
          <td>updated_at</td>
          <td>timestamp</td>
          <td>Дата обновления</td>
      </tr>
      <tr>
          <td>deleted_at</td>
          <td>timestamp</td>
          <td>Soft delete</td>
      </tr>
  </tbody>
</table>
<p><strong>Права доступа:</strong> Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).</p>
+    
+    
+      Leadera: Ограничения секций в диаграмме Ганта
+      /leadera/leadera-section-constraints/
+      Mon, 06 Apr 2026 00:00:00 +0000
+      /leadera/leadera-section-constraints/
+      <h2 id="бизнес-требования">Бизнес-требования</h2>
<h3 id="br-1-лимит-одновременных-задач-concurrency-limit">BR-1: Лимит одновременных задач (Concurrency Limit)</h3>
<p>У каждой секции появляется параметр <strong>max_concurrent_tasks</strong> (целое число ≥ 0, по умолчанию 0).</p>
<p><strong>Поведение:</strong></p>
<ul>
<li>Если <code>max_concurrent_tasks = 3</code> — в любой данный день в этой секции не может быть больше 3 активных задач одновременно</li>
<li>Если <code>max_concurrent_tasks = 0</code> — ограничение отключено, лимита нет</li>
<li>Пересечение считается по дате: задача занимает дни с <code>start_date</code> по <code>end_date</code> включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день</li>
<li>Ограничение работает <strong>только в рамках одной секции</strong>. Задачи из разных секций не влияют друг на друга</li>
</ul>
<p><strong>Срабатывание при:</strong></p>
+    
     
       31 марта 2026
       /diary/2026-03-31/
diff --git a/public/tags/github/index.html b/public/tags/github/index.html
index 7d16dfe..a3c40ad 100644
--- a/public/tags/github/index.html
+++ b/public/tags/github/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
diff --git a/public/tags/go/index.html b/public/tags/go/index.html
index bc0402f..c5439c0 100644
--- a/public/tags/go/index.html
+++ b/public/tags/go/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,11 +121,15 @@
 
     
 
                      
diff --git a/public/tags/go/index.xml b/public/tags/go/index.xml
index 29961bb..3f54f4d 100644
--- a/public/tags/go/index.xml
+++ b/public/tags/go/index.xml
@@ -6,8 +6,22 @@
     Recent content in Go on docs.a2v.space
     Hugo
     ru-ru
-    Sun, 29 Mar 2026 00:00:00 +0000
+    Wed, 08 Apr 2026 00:00:00 +0000
     
+    
+      Leadera: Вехи (Milestones) на диаграмме Ганта
+      /leadera/leadera-milestones/
+      Wed, 08 Apr 2026 00:00:00 +0000
+      /leadera/leadera-milestones/
+      <h2 id="бизнес-требования">Бизнес-требования</h2>
<h3 id="br-1-сущность-веха-milestone">BR-1: Сущность «Веха» (Milestone)</h3>
<p>Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.</p>
<p><strong>Поля вехи:</strong></p>
<table>
  <thead>
      <tr>
          <th>Поле</th>
          <th>Тип</th>
          <th>Описание</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>id</td>
          <td>UUID</td>
          <td>Идентификатор</td>
      </tr>
      <tr>
          <td>gantt_chart_id</td>
          <td>UUID</td>
          <td>Принадлежность к диаграмме (не к секции!)</td>
      </tr>
      <tr>
          <td>title</td>
          <td>string</td>
          <td>Название вехи (обязательное, 1–255 символов)</td>
      </tr>
      <tr>
          <td>date</td>
          <td>date</td>
          <td>Дата вехи (без времени, обязательная)</td>
      </tr>
      <tr>
          <td>color</td>
          <td>string</td>
          <td>Цвет маркера (HEX, по умолчанию <code>#dc3545</code> — красный)</td>
      </tr>
      <tr>
          <td>created_by</td>
          <td>UUID</td>
          <td>Кто создал (не отображается в UI, хранится для аудита)</td>
      </tr>
      <tr>
          <td>updated_by</td>
          <td>UUID</td>
          <td>Кто обновил (не отображается в UI)</td>
      </tr>
      <tr>
          <td>created_at</td>
          <td>timestamp</td>
          <td>Дата создания</td>
      </tr>
      <tr>
          <td>updated_at</td>
          <td>timestamp</td>
          <td>Дата обновления</td>
      </tr>
      <tr>
          <td>deleted_at</td>
          <td>timestamp</td>
          <td>Soft delete</td>
      </tr>
  </tbody>
</table>
<p><strong>Права доступа:</strong> Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).</p>
+    
+    
+      Leadera: Ограничения секций в диаграмме Ганта
+      /leadera/leadera-section-constraints/
+      Mon, 06 Apr 2026 00:00:00 +0000
+      /leadera/leadera-section-constraints/
+      <h2 id="бизнес-требования">Бизнес-требования</h2>
<h3 id="br-1-лимит-одновременных-задач-concurrency-limit">BR-1: Лимит одновременных задач (Concurrency Limit)</h3>
<p>У каждой секции появляется параметр <strong>max_concurrent_tasks</strong> (целое число ≥ 0, по умолчанию 0).</p>
<p><strong>Поведение:</strong></p>
<ul>
<li>Если <code>max_concurrent_tasks = 3</code> — в любой данный день в этой секции не может быть больше 3 активных задач одновременно</li>
<li>Если <code>max_concurrent_tasks = 0</code> — ограничение отключено, лимита нет</li>
<li>Пересечение считается по дате: задача занимает дни с <code>start_date</code> по <code>end_date</code> включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день</li>
<li>Ограничение работает <strong>только в рамках одной секции</strong>. Задачи из разных секций не влияют друг на друга</li>
</ul>
<p><strong>Срабатывание при:</strong></p>
+    
     
       29 марта 2026
       /diary/2026-03-29/
diff --git a/public/tags/hugo/index.html b/public/tags/hugo/index.html
index d1c8694..2e16205 100644
--- a/public/tags/hugo/index.html
+++ b/public/tags/hugo/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
diff --git a/public/tags/identity/index.html b/public/tags/identity/index.html
index 3372ff3..a095236 100644
--- a/public/tags/identity/index.html
+++ b/public/tags/identity/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
diff --git a/public/tags/index.html b/public/tags/index.html
index 255d0d9..f82bb1f 100644
--- a/public/tags/index.html
+++ b/public/tags/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -115,91 +121,109 @@
 
     
 
                      
diff --git a/public/tags/index.xml b/public/tags/index.xml
index bc3f62a..170fc22 100644
--- a/public/tags/index.xml
+++ b/public/tags/index.xml
@@ -6,8 +6,113 @@
     Recent content in Tags on docs.a2v.space
     Hugo
     ru-ru
-    Tue, 31 Mar 2026 00:00:00 +0000
+    Thu, 09 Apr 2026 00:00:00 +0000
     
+    
+      Excel
+      /tags/excel/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /tags/excel/
+      
+    
+    
+      Export
+      /tags/export/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /tags/export/
+      
+    
+    
+      Gantt
+      /tags/gantt/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /tags/gantt/
+      
+    
+    
+      Leadera
+      /tags/leadera/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /tags/leadera/
+      
+    
+    
+      Public-Access
+      /tags/public-access/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /tags/public-access/
+      
+    
+    
+      Sharing
+      /tags/sharing/
+      Thu, 09 Apr 2026 00:00:00 +0000
+      /tags/sharing/
+      
+    
+    
+      Angular
+      /tags/angular/
+      Wed, 08 Apr 2026 00:00:00 +0000
+      /tags/angular/
+      
+    
+    
+      Api
+      /tags/api/
+      Wed, 08 Apr 2026 00:00:00 +0000
+      /tags/api/
+      
+    
+    
+      Go
+      /tags/go/
+      Wed, 08 Apr 2026 00:00:00 +0000
+      /tags/go/
+      
+    
+    
+      Ux
+      /tags/ux/
+      Wed, 08 Apr 2026 00:00:00 +0000
+      /tags/ux/
+      
+    
+    
+      Architecture
+      /tags/architecture/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /tags/architecture/
+      
+    
+    
+      Frontend
+      /tags/frontend/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /tags/frontend/
+      
+    
+    
+      Realtime
+      /tags/realtime/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /tags/realtime/
+      
+    
+    
+      Requirements
+      /tags/requirements/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /tags/requirements/
+      
+    
+    
+      Websocket
+      /tags/websocket/
+      Tue, 07 Apr 2026 00:00:00 +0000
+      /tags/websocket/
+      
+    
     
       Audit
       /tags/audit/
@@ -22,13 +127,6 @@
       /tags/canvas/
       
     
-    
-      Gantt
-      /tags/gantt/
-      Tue, 31 Mar 2026 00:00:00 +0000
-      /tags/gantt/
-      
-    
     
       Github
       /tags/github/
@@ -50,13 +148,6 @@
       /tags/infrastructure/
       
     
-    
-      Leadera
-      /tags/leadera/
-      Tue, 31 Mar 2026 00:00:00 +0000
-      /tags/leadera/
-      
-    
     
       Opencode
       /tags/opencode/
@@ -85,13 +176,6 @@
       /tags/system-utils/
       
     
-    
-      Architecture
-      /tags/architecture/
-      Mon, 30 Mar 2026 00:00:00 +0000
-      /tags/architecture/
-      
-    
     
       Mtproxy
       /tags/mtproxy/
@@ -141,20 +225,6 @@
       /tags/amnezia/
       
     
-    
-      Angular
-      /tags/angular/
-      Sun, 29 Mar 2026 00:00:00 +0000
-      /tags/angular/
-      
-    
-    
-      Api
-      /tags/api/
-      Sun, 29 Mar 2026 00:00:00 +0000
-      /tags/api/
-      
-    
     
       Authentication
       /tags/authentication/
@@ -211,13 +281,6 @@
       /tags/eversolo/
       
     
-    
-      Go
-      /tags/go/
-      Sun, 29 Mar 2026 00:00:00 +0000
-      /tags/go/
-      
-    
     
       Identity
       /tags/identity/
diff --git a/public/tags/infrastructure/index.html b/public/tags/infrastructure/index.html
index 0fd68f7..049273f 100644
--- a/public/tags/infrastructure/index.html
+++ b/public/tags/infrastructure/index.html
@@ -38,6 +38,10 @@
                         Планы
                     
                     
+                    
                    • 
+                        Leadera
+                    
                      • 
+                    
                     
                    • 
                         Инструкции
                     
                      • 
@@ -94,6 +98,8 @@
         
         
                    • Планы
                      • 
         
+        
                    • Leadera
                      • 
+        
         
                    • Инструкции
                      • 
         
         
                    • Креды
                      • 
@@ -119,11 +125,11 @@
     
         
                    • 30 марта 2026
                      • 
     
-        
                    • 29 марта 2026
                      • 
+        
                    • VPS reg.ru
                      • 
     
         
                    • VPN VPS
                      • 
     
-        
                    • VPS reg.ru
                      • 
+        
                    • 29 марта 2026
                      •
                    diff --git a/public/tags/leadera/index.html b/public/tags/leadera/index.html index f19fab6..bf2c7be 100644 --- a/public/tags/leadera/index.html +++ b/public/tags/leadera/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • @@ -115,16 +121,28 @@
                    diff --git a/public/tags/leadera/index.xml b/public/tags/leadera/index.xml index e854545..c7d91b5 100644 --- a/public/tags/leadera/index.xml +++ b/public/tags/leadera/index.xml @@ -6,15 +6,57 @@ Recent content in Leadera on docs.a2v.space Hugo ru-ru - Tue, 31 Mar 2026 00:00:00 +0000 + Thu, 09 Apr 2026 00:00:00 +0000 Аудит Leadera — полный отчёт - /guides/leadera-audit/ + /leadera/leadera-audit/ Mon, 30 Mar 2026 00:00:00 +0000 - /guides/leadera-audit/ + /leadera/leadera-audit/ <h1 id="аудит-проекта-leadera">Аудит проекта Leadera</h1> <p><strong>Дата:</strong> 30.03.2026<br> <strong>Версия:</strong> pre-production, миграции 1–5</p> <hr> <h2 id="1-обзор-проекта">1. Обзор проекта</h2> <p>Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.</p> <h3 id="стек">Стек</h3> <table> <thead> <tr> <th>Компонент</th> <th>Технологии</th> </tr> </thead> <tbody> <tr> <td>Backend</td> <td>Go 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256)</td> </tr> <tr> <td>Frontend</td> <td>Angular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals</td> </tr> <tr> <td>Инфраструктура</td> <td>Docker (Colima), pm2, nginx reverse proxy, VPS reg.ru</td> </tr> </tbody> </table> <h3 id="доменная-модель">Доменная модель</h3> <pre tabindex="0"><code>User ──┬── Space (через space_members с role) │ └── GanttChart (принадлежит Space) ├── GanttSection └── GanttTask </code></pre><p><strong>Роли:</strong> admin, editor, viewer — назначаются <strong>на уровне Space</strong> через таблицу <code>space_members</code>.</p> + + Leadera — WebSocket для диаграмм Ганта + /leadera/leadera-websocket-gantt/ + Tue, 07 Apr 2026 00:00:00 +0000 + /leadera/leadera-websocket-gantt/ + <h1 id="websocket-для-диаграмм-ганта--realtime-совместное-редактирование">WebSocket для диаграмм Ганта — realtime-совместное редактирование</h1> <p><strong>Дата:</strong> 07.04.2026 <strong>Статус:</strong> Планирование <strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p> <hr> <h2 id="1-постановка-задачи">1. Постановка задачи</h2> <p>Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.</p> <hr> <h2 id="2-архитектура">2. Архитектура</h2> <pre tabindex="0"><code>Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL │ │ │ HTTP (мутации) │ Broadcast └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты </code></pre><p><strong>Ключевой принцип:</strong> мутации данных идут через HTTP (REST), WebSocket используется <strong>только для доставки уведомлений</strong>. Сервер — источник истины, клиент не может обойти проверки через WS.</p> + + + Leadera — Экспорт диаграммы Ганта в Excel + /leadera/leadera-gantt-excel-export/ + Thu, 09 Apr 2026 00:00:00 +0000 + /leadera/leadera-gantt-excel-export/ + <h1 id="экспорт-диаграммы-ганта-в-excel">Экспорт диаграммы Ганта в Excel</h1> <p><strong>Дата:</strong> 09.04.2026 <strong>Статус:</strong> Требования <strong>Проект:</strong> Leadera</p> <hr> <h2 id="общее-описание">Общее описание</h2> <p>Пользователь нажимает кнопку экспорта в интерфейсе диаграммы Ганта. Система запрашивает диапазон дат выгрузки (по умолчанию — текущий видимый диапазон из интерфейса). После указания диапазона скачивается Excel-файл с визуальным представлением диаграммы Ганта.</p> <hr> <h2 id="вводные-данные">Вводные данные</h2> <ul> <li><strong>Источник:</strong> текущая диаграмма Ганта проекта (один проект = одна диаграмма)</li> <li><strong>Диапазон дат:</strong> пользователь указывает начальную и конечную дату. По умолчанию подставляется видимый в момент запроса диапазон из интерфейса</li> <li><strong>Масштаб таймлайна:</strong> берётся тот, который выбран пользователем в интерфейсе в момент запроса (не сохранённый в системе, а текущий). Варианты: по ячейкам или по дням</li> </ul> <hr> <h2 id="структура-excel-файла">Структура Excel-файла</h2> <h3 id="шапка-первые-строки">Шапка (первые строки)</h3> <ul> <li>Название диаграммы (название проекта)</li> <li>Диапазон дат, в рамках которого сделана выгрузка</li> </ul> <h3 id="лист--один">Лист — один</h3> <p>Вся диаграмма размещается на одном листе.</p> + + + Leadera — Фильтры и реорганизация списка диаграмм Ганта + /leadera/leadera-gantt-filters/ + Tue, 07 Apr 2026 00:00:00 +0000 + /leadera/leadera-gantt-filters/ + <h1 id="фильтры-и-реорганизация-списка-диаграмм-ганта">Фильтры и реорганизация списка диаграмм Ганта</h1> <p><strong>Дата:</strong> 07.04.2026 <strong>Статус:</strong> Требования <strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p> <hr> <h2 id="1-постановка-задачи">1. Постановка задачи</h2> <p>Список диаграмм Ганта должен показывать <strong>все доступные пользователю диаграммы</strong> из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.</p> <hr> <h2 id="2-изменения-api">2. Изменения API</h2> <h3 id="21-новый-endpoint-списка-диаграмм">2.1. Новый endpoint списка диаграмм</h3> <p><strong>Было:</strong></p> <pre tabindex="0"><code>GET /api/v1/spaces/{spaceId}/gantt-charts?page=1&amp;per_page=10 </code></pre><p><strong>Стало:</strong></p> <pre tabindex="0"><code>GET /api/v1/gantt-charts?page=1&amp;per_page=10 </code></pre><p>Пользователь видит все диаграммы из <strong>всех пространств</strong>, где он является подтверждённым участником (статус <code>accepted</code>).</p> + + + Leadera — Публичный доступ к диаграмме Ганта + /leadera/leadera-gantt-public-access/ + Thu, 09 Apr 2026 00:00:00 +0000 + /leadera/leadera-gantt-public-access/ + <h1 id="публичный-доступ-к-диаграмме-ганта-share">Публичный доступ к диаграмме Ганта (Share)</h1> <p><strong>Дата:</strong> 09.04.2026 <strong>Статус:</strong> Требования <strong>Проект:</strong> Leadera</p> <hr> <h2 id="общее-описание">Общее описание</h2> <p>Пользователь может создать публичную ссылку на фрагмент диаграммы Ганта, доступную для просмотра без авторизации. Открывший ссылку видит диаграмму в read-only режиме с возможностью масштабирования таймлайна, но без каких-либо элементов управления (создание, редактирование, удаление задач/секций/вех).</p> <hr> <h2 id="пользовательский-сценарий-создатель-ссылки">Пользовательский сценарий (создатель ссылки)</h2> <ol> <li>Пользователь открывает диаграмму Ганта проекта</li> <li>Нажимает кнопку «Экспорт» / «Общий доступ»</li> <li>Указывает диапазон дат, который должен отображаться на диаграмме</li> <li>Система генерирует уникальную ссылку (UUID) и показывает её пользователю</li> <li>Пользователь копирует ссылку и передаёт заинтересованным лицам</li> </ol> <h3 id="управление-ссылками">Управление ссылками</h3> <ul> <li>Вызывается через меню экспорта → модальное окно «Общий доступ»</li> <li>В модальном окне отображается список созданных ссылок с указанием диапазона дат</li> <li>Каждую ссылку можно <strong>удалить</strong> (полное удаление из БД, не soft delete)</li> <li>Ссылки <strong>нельзя редактировать</strong> — только создавать и удалять</li> <li>Ограничений на количество активных ссылок нет</li> <li>Статистика просмотров (сколько раз открывали) — <strong>не нужна</strong></li> </ul> <hr> <h2 id="пользовательский-сценарий-зритель-по-ссылке">Пользовательский сценарий (зритель по ссылке)</h2> <ol> <li>Зритель переходит по ссылке (без авторизации)</li> <li>Открывается отдельная страница с диаграммой Ганта</li> <li>Зритель видит: <ul> <li>Задачи и вехи, попадающие в заданный диапазон</li> <li>Секции (заголовки группировок)</li> <li>Таймлайн с цветовой раскраской задач</li> </ul> </li> <li>Зритель может: <ul> <li>Масштабировать таймлайн</li> <li>Переключать отображение «по ячейкам» / «по дням»</li> </ul> </li> <li>Зритель <strong>не может</strong>: <ul> <li>Создавать, редактировать, удалять задачи / секции / вехи</li> <li>Видеть любые контролы управления (кнопки создания, контекстные меню, drag-and-drop и т.д.)</li> <li>Авторизоваться через эту страницу</li> </ul> </li> </ol> <hr> <h2 id="данные-и-фильтрация">Данные и фильтрация</h2> <h3 id="что-попадает-в-представление">Что попадает в представление</h3> <p>Задачи и вехи, у которых хотя бы одно из условий верно:</p> + + + Leadera: Вехи (Milestones) на диаграмме Ганта + /leadera/leadera-milestones/ + Wed, 08 Apr 2026 00:00:00 +0000 + /leadera/leadera-milestones/ + <h2 id="бизнес-требования">Бизнес-требования</h2> <h3 id="br-1-сущность-веха-milestone">BR-1: Сущность «Веха» (Milestone)</h3> <p>Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.</p> <p><strong>Поля вехи:</strong></p> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td>id</td> <td>UUID</td> <td>Идентификатор</td> </tr> <tr> <td>gantt_chart_id</td> <td>UUID</td> <td>Принадлежность к диаграмме (не к секции!)</td> </tr> <tr> <td>title</td> <td>string</td> <td>Название вехи (обязательное, 1–255 символов)</td> </tr> <tr> <td>date</td> <td>date</td> <td>Дата вехи (без времени, обязательная)</td> </tr> <tr> <td>color</td> <td>string</td> <td>Цвет маркера (HEX, по умолчанию <code>#dc3545</code> — красный)</td> </tr> <tr> <td>created_by</td> <td>UUID</td> <td>Кто создал (не отображается в UI, хранится для аудита)</td> </tr> <tr> <td>updated_by</td> <td>UUID</td> <td>Кто обновил (не отображается в UI)</td> </tr> <tr> <td>created_at</td> <td>timestamp</td> <td>Дата создания</td> </tr> <tr> <td>updated_at</td> <td>timestamp</td> <td>Дата обновления</td> </tr> <tr> <td>deleted_at</td> <td>timestamp</td> <td>Soft delete</td> </tr> </tbody> </table> <p><strong>Права доступа:</strong> Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).</p> + + + Leadera: Ограничения секций в диаграмме Ганта + /leadera/leadera-section-constraints/ + Mon, 06 Apr 2026 00:00:00 +0000 + /leadera/leadera-section-constraints/ + <h2 id="бизнес-требования">Бизнес-требования</h2> <h3 id="br-1-лимит-одновременных-задач-concurrency-limit">BR-1: Лимит одновременных задач (Concurrency Limit)</h3> <p>У каждой секции появляется параметр <strong>max_concurrent_tasks</strong> (целое число ≥ 0, по умолчанию 0).</p> <p><strong>Поведение:</strong></p> <ul> <li>Если <code>max_concurrent_tasks = 3</code> — в любой данный день в этой секции не может быть больше 3 активных задач одновременно</li> <li>Если <code>max_concurrent_tasks = 0</code> — ограничение отключено, лимита нет</li> <li>Пересечение считается по дате: задача занимает дни с <code>start_date</code> по <code>end_date</code> включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день</li> <li>Ограничение работает <strong>только в рамках одной секции</strong>. Задачи из разных секций не влияют друг на друга</li> </ul> <p><strong>Срабатывание при:</strong></p> + 31 марта 2026 /diary/2026-03-31/ diff --git a/public/tags/llm/index.html b/public/tags/llm/index.html index 690241b..a3a274b 100644 --- a/public/tags/llm/index.html +++ b/public/tags/llm/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • diff --git a/public/tags/mtproxy/index.html b/public/tags/mtproxy/index.html index d4c4893..bf0d08a 100644 --- a/public/tags/mtproxy/index.html +++ b/public/tags/mtproxy/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • diff --git a/public/tags/music/index.html b/public/tags/music/index.html index 379b57c..a209f8e 100644 --- a/public/tags/music/index.html +++ b/public/tags/music/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • diff --git a/public/tags/nginx/index.html b/public/tags/nginx/index.html index 8b15f6c..d303657 100644 --- a/public/tags/nginx/index.html +++ b/public/tags/nginx/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • @@ -115,15 +121,15 @@
                    diff --git a/public/tags/ollama/index.html b/public/tags/ollama/index.html index f2eb691..9e51f42 100644 --- a/public/tags/ollama/index.html +++ b/public/tags/ollama/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • diff --git a/public/tags/openclaw/index.html b/public/tags/openclaw/index.html index 1d7be9e..3e1866a 100644 --- a/public/tags/openclaw/index.html +++ b/public/tags/openclaw/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • @@ -115,11 +121,11 @@
                    diff --git a/public/tags/opencode/index.html b/public/tags/opencode/index.html index 0331c26..33dae57 100644 --- a/public/tags/opencode/index.html +++ b/public/tags/opencode/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • diff --git a/public/tags/personal-site/index.html b/public/tags/personal-site/index.html index 657f303..5144ff0 100644 --- a/public/tags/personal-site/index.html +++ b/public/tags/personal-site/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • @@ -115,23 +121,23 @@
                    diff --git a/public/tags/postgresql/index.html b/public/tags/postgresql/index.html index d3c3881..b283b03 100644 --- a/public/tags/postgresql/index.html +++ b/public/tags/postgresql/index.html @@ -38,6 +38,10 @@ Планы +
                  • + Leadera +
                    • +
                  • Инструкции
                    • @@ -94,6 +98,8 @@
                  • Планы
                    • +
                  • Leadera
                    • +
                  • Инструкции
                  • Креды
                    • @@ -115,11 +121,11 @@
                  diff --git a/public/tags/public-access/index.html b/public/tags/public-access/index.html new file mode 100644 index 0000000..50a87f5 --- /dev/null +++ b/public/tags/public-access/index.html @@ -0,0 +1,152 @@ + + + + + + Public-Access — docs.a2v.space + + + + + + + + + + +
                  + + + + +
                  + + +
                  +
                  + + + + +
                  + +
                  +

                  Public-Access

                  + + + +
                  + +
                  +
                  +
                  + +
                  +
                  +

                  © 2026 docs.a2v.space

                  +
                  +
                  + + + + + + + + + + + + + + + diff --git a/public/tags/public-access/index.xml b/public/tags/public-access/index.xml new file mode 100644 index 0000000..5529a9f --- /dev/null +++ b/public/tags/public-access/index.xml @@ -0,0 +1,19 @@ + + + + Public-Access on docs.a2v.space + /tags/public-access/ + Recent content in Public-Access on docs.a2v.space + Hugo + ru-ru + Thu, 09 Apr 2026 00:00:00 +0000 + + + Leadera — Публичный доступ к диаграмме Ганта + /leadera/leadera-gantt-public-access/ + Thu, 09 Apr 2026 00:00:00 +0000 + /leadera/leadera-gantt-public-access/ + <h1 id="публичный-доступ-к-диаграмме-ганта-share">Публичный доступ к диаграмме Ганта (Share)</h1> <p><strong>Дата:</strong> 09.04.2026 <strong>Статус:</strong> Требования <strong>Проект:</strong> Leadera</p> <hr> <h2 id="общее-описание">Общее описание</h2> <p>Пользователь может создать публичную ссылку на фрагмент диаграммы Ганта, доступную для просмотра без авторизации. Открывший ссылку видит диаграмму в read-only режиме с возможностью масштабирования таймлайна, но без каких-либо элементов управления (создание, редактирование, удаление задач/секций/вех).</p> <hr> <h2 id="пользовательский-сценарий-создатель-ссылки">Пользовательский сценарий (создатель ссылки)</h2> <ol> <li>Пользователь открывает диаграмму Ганта проекта</li> <li>Нажимает кнопку «Экспорт» / «Общий доступ»</li> <li>Указывает диапазон дат, который должен отображаться на диаграмме</li> <li>Система генерирует уникальную ссылку (UUID) и показывает её пользователю</li> <li>Пользователь копирует ссылку и передаёт заинтересованным лицам</li> </ol> <h3 id="управление-ссылками">Управление ссылками</h3> <ul> <li>Вызывается через меню экспорта → модальное окно «Общий доступ»</li> <li>В модальном окне отображается список созданных ссылок с указанием диапазона дат</li> <li>Каждую ссылку можно <strong>удалить</strong> (полное удаление из БД, не soft delete)</li> <li>Ссылки <strong>нельзя редактировать</strong> — только создавать и удалять</li> <li>Ограничений на количество активных ссылок нет</li> <li>Статистика просмотров (сколько раз открывали) — <strong>не нужна</strong></li> </ul> <hr> <h2 id="пользовательский-сценарий-зритель-по-ссылке">Пользовательский сценарий (зритель по ссылке)</h2> <ol> <li>Зритель переходит по ссылке (без авторизации)</li> <li>Открывается отдельная страница с диаграммой Ганта</li> <li>Зритель видит: <ul> <li>Задачи и вехи, попадающие в заданный диапазон</li> <li>Секции (заголовки группировок)</li> <li>Таймлайн с цветовой раскраской задач</li> </ul> </li> <li>Зритель может: <ul> <li>Масштабировать таймлайн</li> <li>Переключать отображение «по ячейкам» / «по дням»</li> </ul> </li> <li>Зритель <strong>не может</strong>: <ul> <li>Создавать, редактировать, удалять задачи / секции / вехи</li> <li>Видеть любые контролы управления (кнопки создания, контекстные меню, drag-and-drop и т.д.)</li> <li>Авторизоваться через эту страницу</li> </ul> </li> </ol> <hr> <h2 id="данные-и-фильтрация">Данные и фильтрация</h2> <h3 id="что-попадает-в-представление">Что попадает в представление</h3> <p>Задачи и вехи, у которых хотя бы одно из условий верно:</p> + + + diff --git a/public/tags/qwen/index.html b/public/tags/qwen/index.html index 2c3c862..5dccc28 100644 --- a/public/tags/qwen/index.html +++ b/public/tags/qwen/index.html @@ -38,6 +38,10 @@ Планы +
                • + Leadera +
                  • +
                • Инструкции
                  • @@ -94,6 +98,8 @@
                • Планы
                  • +
                • Leadera
                  • +
                • Инструкции
                • Креды
                  • diff --git a/public/tags/realtime/index.html b/public/tags/realtime/index.html new file mode 100644 index 0000000..4dc4cfc --- /dev/null +++ b/public/tags/realtime/index.html @@ -0,0 +1,152 @@ + + + + + + Realtime — docs.a2v.space + + + + + + + + + + +
                  + + + + +
                  + + +
                  +
                  + + + + +
                  + +
                  +

                  Realtime

                  + + + +
                  + +
                  +
                  +
                  + +
                  +
                  +

                  © 2026 docs.a2v.space

                  +
                  +
                  + + + + + + + + + + + + + + + diff --git a/public/tags/realtime/index.xml b/public/tags/realtime/index.xml new file mode 100644 index 0000000..c7acfca --- /dev/null +++ b/public/tags/realtime/index.xml @@ -0,0 +1,19 @@ + + + + Realtime on docs.a2v.space + /tags/realtime/ + Recent content in Realtime on docs.a2v.space + Hugo + ru-ru + Tue, 07 Apr 2026 00:00:00 +0000 + + + Leadera — WebSocket для диаграмм Ганта + /leadera/leadera-websocket-gantt/ + Tue, 07 Apr 2026 00:00:00 +0000 + /leadera/leadera-websocket-gantt/ + <h1 id="websocket-для-диаграмм-ганта--realtime-совместное-редактирование">WebSocket для диаграмм Ганта — realtime-совместное редактирование</h1> <p><strong>Дата:</strong> 07.04.2026 <strong>Статус:</strong> Планирование <strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p> <hr> <h2 id="1-постановка-задачи">1. Постановка задачи</h2> <p>Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.</p> <hr> <h2 id="2-архитектура">2. Архитектура</h2> <pre tabindex="0"><code>Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL │ │ │ HTTP (мутации) │ Broadcast └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты </code></pre><p><strong>Ключевой принцип:</strong> мутации данных идут через HTTP (REST), WebSocket используется <strong>только для доставки уведомлений</strong>. Сервер — источник истины, клиент не может обойти проверки через WS.</p> + + + diff --git a/public/tags/reg.ru/index.html b/public/tags/reg.ru/index.html index 66cceb2..516b1fe 100644 --- a/public/tags/reg.ru/index.html +++ b/public/tags/reg.ru/index.html @@ -38,6 +38,10 @@ Планы +
                • + Leadera +
                  • +
                • Инструкции
                  • @@ -94,6 +98,8 @@
                • Планы
                  • +
                • Leadera
                  • +
                • Инструкции
                • Креды
                  • diff --git a/public/tags/requirements/index.html b/public/tags/requirements/index.html new file mode 100644 index 0000000..e4520d9 --- /dev/null +++ b/public/tags/requirements/index.html @@ -0,0 +1,152 @@ + + + + + + Requirements — docs.a2v.space + + + + + + + + + + +
                  + + + + +
                  + + +
                  +
                  + + + + +
                  + +
                  +

                  Requirements

                  + + + +
                  + +
                  +
                  +
                  + +
                  +
                  +

                  © 2026 docs.a2v.space

                  +
                  +
                  + + + + + + + + + + + + + + + diff --git a/public/tags/requirements/index.xml b/public/tags/requirements/index.xml new file mode 100644 index 0000000..020243c --- /dev/null +++ b/public/tags/requirements/index.xml @@ -0,0 +1,19 @@ + + + + Requirements on docs.a2v.space + /tags/requirements/ + Recent content in Requirements on docs.a2v.space + Hugo + ru-ru + Tue, 07 Apr 2026 00:00:00 +0000 + + + Leadera — Фильтры и реорганизация списка диаграмм Ганта + /leadera/leadera-gantt-filters/ + Tue, 07 Apr 2026 00:00:00 +0000 + /leadera/leadera-gantt-filters/ + <h1 id="фильтры-и-реорганизация-списка-диаграмм-ганта">Фильтры и реорганизация списка диаграмм Ганта</h1> <p><strong>Дата:</strong> 07.04.2026 <strong>Статус:</strong> Требования <strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p> <hr> <h2 id="1-постановка-задачи">1. Постановка задачи</h2> <p>Список диаграмм Ганта должен показывать <strong>все доступные пользователю диаграммы</strong> из всех пространств (spaces), с возможностью фильтрации и поиска. Сейчас список привязан к одному пространству — нужно убрать эту зависимость и добавить удобный toolbar.</p> <hr> <h2 id="2-изменения-api">2. Изменения API</h2> <h3 id="21-новый-endpoint-списка-диаграмм">2.1. Новый endpoint списка диаграмм</h3> <p><strong>Было:</strong></p> <pre tabindex="0"><code>GET /api/v1/spaces/{spaceId}/gantt-charts?page=1&amp;per_page=10 </code></pre><p><strong>Стало:</strong></p> <pre tabindex="0"><code>GET /api/v1/gantt-charts?page=1&amp;per_page=10 </code></pre><p>Пользователь видит все диаграммы из <strong>всех пространств</strong>, где он является подтверждённым участником (статус <code>accepted</code>).</p> + + + diff --git a/public/tags/reverse-proxy/index.html b/public/tags/reverse-proxy/index.html index 2aa956d..0287f52 100644 --- a/public/tags/reverse-proxy/index.html +++ b/public/tags/reverse-proxy/index.html @@ -38,6 +38,10 @@ Планы +
                • + Leadera +
                  • +
                • Инструкции
                  • @@ -94,6 +98,8 @@
                • Планы
                  • +
                • Leadera
                  • +
                • Инструкции
                • Креды
                  • @@ -115,15 +121,15 @@
                  diff --git a/public/tags/roadmap/index.html b/public/tags/roadmap/index.html index cabbc38..20de02b 100644 --- a/public/tags/roadmap/index.html +++ b/public/tags/roadmap/index.html @@ -38,6 +38,10 @@ Планы +
                • + Leadera +
                  • +
                • Инструкции
                  • @@ -94,6 +98,8 @@
                • Планы
                  • +
                • Leadera
                  • +
                • Инструкции
                • Креды
                  • diff --git a/public/tags/security/index.html b/public/tags/security/index.html index c2b89e7..d72a4eb 100644 --- a/public/tags/security/index.html +++ b/public/tags/security/index.html @@ -38,6 +38,10 @@ Планы +
                • + Leadera +
                  • +
                • Инструкции
                  • @@ -94,6 +98,8 @@
                • Планы
                  • +
                • Leadera
                  • +
                • Инструкции
                • Креды
                  • @@ -115,7 +121,7 @@
                diff --git a/public/tags/security/index.xml b/public/tags/security/index.xml index a9b67c6..931d631 100644 --- a/public/tags/security/index.xml +++ b/public/tags/security/index.xml @@ -10,9 +10,9 @@ Аудит Leadera — полный отчёт - /guides/leadera-audit/ + /leadera/leadera-audit/ Mon, 30 Mar 2026 00:00:00 +0000 - /guides/leadera-audit/ + /leadera/leadera-audit/ <h1 id="аудит-проекта-leadera">Аудит проекта Leadera</h1> <p><strong>Дата:</strong> 30.03.2026<br> <strong>Версия:</strong> pre-production, миграции 1–5</p> <hr> <h2 id="1-обзор-проекта">1. Обзор проекта</h2> <p>Leadera — SaaS-система управления IT-ландшафтом с диаграммами Ганта.</p> <h3 id="стек">Стек</h3> <table> <thead> <tr> <th>Компонент</th> <th>Технологии</th> </tr> </thead> <tbody> <tr> <td>Backend</td> <td>Go 1.21+, Gin, PostgreSQL 16, pgx/v5 + sqlx, JWT (HMAC-SHA256)</td> </tr> <tr> <td>Frontend</td> <td>Angular 21.1, Bootstrap 5, NgBootstrap, RxJS, Signals</td> </tr> <tr> <td>Инфраструктура</td> <td>Docker (Colima), pm2, nginx reverse proxy, VPS reg.ru</td> </tr> </tbody> </table> <h3 id="доменная-модель">Доменная модель</h3> <pre tabindex="0"><code>User ──┬── Space (через space_members с role) │ └── GanttChart (принадлежит Space) ├── GanttSection └── GanttTask </code></pre><p><strong>Роли:</strong> admin, editor, viewer — назначаются <strong>на уровне Space</strong> через таблицу <code>space_members</code>.</p> diff --git a/public/tags/sharing/index.html b/public/tags/sharing/index.html new file mode 100644 index 0000000..894051d --- /dev/null +++ b/public/tags/sharing/index.html @@ -0,0 +1,152 @@ + + + + + + Sharing — docs.a2v.space + + + + + + + + + + +
                + + + + +
                + + +
                +
                + + + + +
                + +
                +

                Sharing

                + + + +
                + +
                +
                +
                + +
                +
                +

                © 2026 docs.a2v.space

                +
                +
                + + + + + + + + + + + + + + + diff --git a/public/tags/sharing/index.xml b/public/tags/sharing/index.xml new file mode 100644 index 0000000..f078b82 --- /dev/null +++ b/public/tags/sharing/index.xml @@ -0,0 +1,19 @@ + + + + Sharing on docs.a2v.space + /tags/sharing/ + Recent content in Sharing on docs.a2v.space + Hugo + ru-ru + Thu, 09 Apr 2026 00:00:00 +0000 + + + Leadera — Публичный доступ к диаграмме Ганта + /leadera/leadera-gantt-public-access/ + Thu, 09 Apr 2026 00:00:00 +0000 + /leadera/leadera-gantt-public-access/ + <h1 id="публичный-доступ-к-диаграмме-ганта-share">Публичный доступ к диаграмме Ганта (Share)</h1> <p><strong>Дата:</strong> 09.04.2026 <strong>Статус:</strong> Требования <strong>Проект:</strong> Leadera</p> <hr> <h2 id="общее-описание">Общее описание</h2> <p>Пользователь может создать публичную ссылку на фрагмент диаграммы Ганта, доступную для просмотра без авторизации. Открывший ссылку видит диаграмму в read-only режиме с возможностью масштабирования таймлайна, но без каких-либо элементов управления (создание, редактирование, удаление задач/секций/вех).</p> <hr> <h2 id="пользовательский-сценарий-создатель-ссылки">Пользовательский сценарий (создатель ссылки)</h2> <ol> <li>Пользователь открывает диаграмму Ганта проекта</li> <li>Нажимает кнопку «Экспорт» / «Общий доступ»</li> <li>Указывает диапазон дат, который должен отображаться на диаграмме</li> <li>Система генерирует уникальную ссылку (UUID) и показывает её пользователю</li> <li>Пользователь копирует ссылку и передаёт заинтересованным лицам</li> </ol> <h3 id="управление-ссылками">Управление ссылками</h3> <ul> <li>Вызывается через меню экспорта → модальное окно «Общий доступ»</li> <li>В модальном окне отображается список созданных ссылок с указанием диапазона дат</li> <li>Каждую ссылку можно <strong>удалить</strong> (полное удаление из БД, не soft delete)</li> <li>Ссылки <strong>нельзя редактировать</strong> — только создавать и удалять</li> <li>Ограничений на количество активных ссылок нет</li> <li>Статистика просмотров (сколько раз открывали) — <strong>не нужна</strong></li> </ul> <hr> <h2 id="пользовательский-сценарий-зритель-по-ссылке">Пользовательский сценарий (зритель по ссылке)</h2> <ol> <li>Зритель переходит по ссылке (без авторизации)</li> <li>Открывается отдельная страница с диаграммой Ганта</li> <li>Зритель видит: <ul> <li>Задачи и вехи, попадающие в заданный диапазон</li> <li>Секции (заголовки группировок)</li> <li>Таймлайн с цветовой раскраской задач</li> </ul> </li> <li>Зритель может: <ul> <li>Масштабировать таймлайн</li> <li>Переключать отображение «по ячейкам» / «по дням»</li> </ul> </li> <li>Зритель <strong>не может</strong>: <ul> <li>Создавать, редактировать, удалять задачи / секции / вехи</li> <li>Видеть любые контролы управления (кнопки создания, контекстные меню, drag-and-drop и т.д.)</li> <li>Авторизоваться через эту страницу</li> </ul> </li> </ol> <hr> <h2 id="данные-и-фильтрация">Данные и фильтрация</h2> <h3 id="что-попадает-в-представление">Что попадает в представление</h3> <p>Задачи и вехи, у которых хотя бы одно из условий верно:</p> + + + diff --git a/public/tags/ssh/index.html b/public/tags/ssh/index.html index bbe06a1..769cfac 100644 --- a/public/tags/ssh/index.html +++ b/public/tags/ssh/index.html @@ -38,6 +38,10 @@ Планы +
              • + Leadera +
                • +
              • Инструкции
                • @@ -94,6 +98,8 @@
              • Планы
                • +
              • Leadera
                • +
              • Инструкции
              • Креды
                • @@ -115,13 +121,13 @@
                diff --git a/public/tags/streamer/index.html b/public/tags/streamer/index.html index 7fd3928..0716b89 100644 --- a/public/tags/streamer/index.html +++ b/public/tags/streamer/index.html @@ -38,6 +38,10 @@ Планы +
              • + Leadera +
                • +
              • Инструкции
                • @@ -94,6 +98,8 @@
              • Планы
                • +
              • Leadera
                • +
              • Инструкции
              • Креды
                • diff --git a/public/tags/system-utils/index.html b/public/tags/system-utils/index.html index 2643e22..7e056ef 100644 --- a/public/tags/system-utils/index.html +++ b/public/tags/system-utils/index.html @@ -38,6 +38,10 @@ Планы +
              • + Leadera +
                • +
              • Инструкции
                • @@ -94,6 +98,8 @@
              • Планы
                • +
              • Leadera
                • +
              • Инструкции
              • Креды
                • diff --git a/public/tags/tasktracker/index.html b/public/tags/tasktracker/index.html index 3f6dac6..20f57b6 100644 --- a/public/tags/tasktracker/index.html +++ b/public/tags/tasktracker/index.html @@ -38,6 +38,10 @@ Планы +
              • + Leadera +
                • +
              • Инструкции
                • @@ -94,6 +98,8 @@
              • Планы
                • +
              • Leadera
                • +
              • Инструкции
              • Креды
                • diff --git a/public/tags/tunnel/index.html b/public/tags/tunnel/index.html index 3dbcb07..71bd475 100644 --- a/public/tags/tunnel/index.html +++ b/public/tags/tunnel/index.html @@ -38,6 +38,10 @@ Планы +
              • + Leadera +
                • +
              • Инструкции
                • @@ -94,6 +98,8 @@
              • Планы
                • +
              • Leadera
                • +
              • Инструкции
              • Креды
                • diff --git a/public/tags/ux/index.html b/public/tags/ux/index.html index 101c9cb..e77dc1a 100644 --- a/public/tags/ux/index.html +++ b/public/tags/ux/index.html @@ -38,6 +38,10 @@ Планы +
              • + Leadera +
                • +
              • Инструкции
                • @@ -46,6 +50,10 @@ Креды +
              • + Личный сайт +
                • +
            @@ -109,6 +121,10 @@
            diff --git a/public/tags/ux/index.xml b/public/tags/ux/index.xml index b66259f..4abea44 100644 --- a/public/tags/ux/index.xml +++ b/public/tags/ux/index.xml @@ -2,10 +2,25 @@ Ux on docs.a2v.space - //localhost:8090/tags/ux/ + /tags/ux/ Recent content in Ux on docs.a2v.space Hugo ru-ru - + Wed, 08 Apr 2026 00:00:00 +0000 + + + Leadera: Вехи (Milestones) на диаграмме Ганта + /leadera/leadera-milestones/ + Wed, 08 Apr 2026 00:00:00 +0000 + /leadera/leadera-milestones/ + <h2 id="бизнес-требования">Бизнес-требования</h2> <h3 id="br-1-сущность-веха-milestone">BR-1: Сущность «Веха» (Milestone)</h3> <p>Веха — это маркер на таймлайне диаграммы Ганта, обозначающий важную дату в проекте. В отличие от задач, веха не имеет длительности и привязана к конкретной дате.</p> <p><strong>Поля вехи:</strong></p> <table> <thead> <tr> <th>Поле</th> <th>Тип</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td>id</td> <td>UUID</td> <td>Идентификатор</td> </tr> <tr> <td>gantt_chart_id</td> <td>UUID</td> <td>Принадлежность к диаграмме (не к секции!)</td> </tr> <tr> <td>title</td> <td>string</td> <td>Название вехи (обязательное, 1–255 символов)</td> </tr> <tr> <td>date</td> <td>date</td> <td>Дата вехи (без времени, обязательная)</td> </tr> <tr> <td>color</td> <td>string</td> <td>Цвет маркера (HEX, по умолчанию <code>#dc3545</code> — красный)</td> </tr> <tr> <td>created_by</td> <td>UUID</td> <td>Кто создал (не отображается в UI, хранится для аудита)</td> </tr> <tr> <td>updated_by</td> <td>UUID</td> <td>Кто обновил (не отображается в UI)</td> </tr> <tr> <td>created_at</td> <td>timestamp</td> <td>Дата создания</td> </tr> <tr> <td>updated_at</td> <td>timestamp</td> <td>Дата обновления</td> </tr> <tr> <td>deleted_at</td> <td>timestamp</td> <td>Soft delete</td> </tr> </tbody> </table> <p><strong>Права доступа:</strong> Создание, редактирование и удаление вех доступно участникам с правами выше «только чтение» (аналогично задачам).</p> + + + Leadera: Ограничения секций в диаграмме Ганта + /leadera/leadera-section-constraints/ + Mon, 06 Apr 2026 00:00:00 +0000 + /leadera/leadera-section-constraints/ + <h2 id="бизнес-требования">Бизнес-требования</h2> <h3 id="br-1-лимит-одновременных-задач-concurrency-limit">BR-1: Лимит одновременных задач (Concurrency Limit)</h3> <p>У каждой секции появляется параметр <strong>max_concurrent_tasks</strong> (целое число ≥ 0, по умолчанию 0).</p> <p><strong>Поведение:</strong></p> <ul> <li>Если <code>max_concurrent_tasks = 3</code> — в любой данный день в этой секции не может быть больше 3 активных задач одновременно</li> <li>Если <code>max_concurrent_tasks = 0</code> — ограничение отключено, лимита нет</li> <li>Пересечение считается по дате: задача занимает дни с <code>start_date</code> по <code>end_date</code> включительно. Две задачи «пересекаются», если у них есть хотя бы один общий день</li> <li>Ограничение работает <strong>только в рамках одной секции</strong>. Задачи из разных секций не влияют друг на друга</li> </ul> <p><strong>Срабатывание при:</strong></p> + diff --git a/public/tags/vikunja/index.html b/public/tags/vikunja/index.html index a69e2c8..0283f87 100644 --- a/public/tags/vikunja/index.html +++ b/public/tags/vikunja/index.html @@ -38,6 +38,10 @@ Планы +
          • + Leadera +
            • +
          • Инструкции
            • @@ -94,6 +98,8 @@
          • Планы
            • +
          • Leadera
            • +
          • Инструкции
          • Креды
            • diff --git a/public/tags/vpn/index.html b/public/tags/vpn/index.html index d7b74bd..be308bf 100644 --- a/public/tags/vpn/index.html +++ b/public/tags/vpn/index.html @@ -38,6 +38,10 @@ Планы +
          • + Leadera +
            • +
          • Инструкции
            • @@ -94,6 +98,8 @@
          • Планы
            • +
          • Leadera
            • +
          • Инструкции
          • Креды
            • diff --git a/public/tags/vps/index.html b/public/tags/vps/index.html index e39bb7e..fa4bd08 100644 --- a/public/tags/vps/index.html +++ b/public/tags/vps/index.html @@ -38,6 +38,10 @@ Планы +
          • + Leadera +
            • +
          • Инструкции
            • @@ -94,6 +98,8 @@
          • Планы
            • +
          • Leadera
            • +
          • Инструкции
          • Креды
            • @@ -115,17 +121,17 @@
        diff --git a/public/tags/websocket/index.html b/public/tags/websocket/index.html new file mode 100644 index 0000000..e9c4edf --- /dev/null +++ b/public/tags/websocket/index.html @@ -0,0 +1,152 @@ + + + + + + Websocket — docs.a2v.space + + + + + + + + + + +
        + + + + +
        + + +
        +
        + + + + +
        + +
        +

        Websocket

        + + + +
        + +
        +
        +
        + +
        +
        +

        © 2026 docs.a2v.space

        +
        +
        + + + + + + + + + + + + + + + diff --git a/public/tags/websocket/index.xml b/public/tags/websocket/index.xml new file mode 100644 index 0000000..e602e83 --- /dev/null +++ b/public/tags/websocket/index.xml @@ -0,0 +1,19 @@ + + + + Websocket on docs.a2v.space + /tags/websocket/ + Recent content in Websocket on docs.a2v.space + Hugo + ru-ru + Tue, 07 Apr 2026 00:00:00 +0000 + + + Leadera — WebSocket для диаграмм Ганта + /leadera/leadera-websocket-gantt/ + Tue, 07 Apr 2026 00:00:00 +0000 + /leadera/leadera-websocket-gantt/ + <h1 id="websocket-для-диаграмм-ганта--realtime-совместное-редактирование">WebSocket для диаграмм Ганта — realtime-совместное редактирование</h1> <p><strong>Дата:</strong> 07.04.2026 <strong>Статус:</strong> Планирование <strong>Проект:</strong> Leadera (dev — sand.a2v.space)</p> <hr> <h2 id="1-постановка-задачи">1. Постановка задачи</h2> <p>Диаграммы Ганта должны обновляться в реальном времени при совместной работе: если два или более пользователей редактируют один Гант, изменения каждого мгновенно отображаются у остальных — без перезагрузки страницы и ручного обновления.</p> <hr> <h2 id="2-архитектура">2. Архитектура</h2> <pre tabindex="0"><code>Angular frontend ←── WebSocket ──→ Go backend (Hub) ──→ PostgreSQL │ │ │ HTTP (мутации) │ Broadcast └──→ REST API ──→ Service ──→ DB ──→ Hub ──→ все клиенты комнаты </code></pre><p><strong>Ключевой принцип:</strong> мутации данных идут через HTTP (REST), WebSocket используется <strong>только для доставки уведомлений</strong>. Сервер — источник истины, клиент не может обойти проверки через WS.</p> + + + diff --git a/static/css/custom.css b/static/css/custom.css index 6f13908..632b8b7 100644 --- a/static/css/custom.css +++ b/static/css/custom.css @@ -270,6 +270,27 @@ body { font-family: monospace; } +/* Source path */ +.source-path { + background-color: var(--warm-bg); + border: 1px solid #e0d8cc; + border-radius: 4px; + padding: 0.4rem 0.75rem; + display: inline-block; +} +.source-path code { + font-size: 0.82em; + color: var(--warm-gray); +} +.source-path .btn-outline-secondary { + font-size: 0.75rem; + border-color: #d0c8bc; +} +.source-path .btn-outline-secondary:hover { + background-color: var(--warm-primary); + border-color: var(--warm-primary); +} + /* Article styles */ .article-content { background-color: var(--warm-white); diff --git a/themes/a2v/layouts/_default/list.html b/themes/a2v/layouts/_default/list.html index 3fc892d..22cc39a 100644 --- a/themes/a2v/layouts/_default/list.html +++ b/themes/a2v/layouts/_default/list.html @@ -4,7 +4,7 @@ {{ .Content }}
          - {{ range .Pages }} + {{ range .Pages.ByDate.Reverse }}
        • {{ .Title }}
          • {{ end }}
        diff --git a/themes/a2v/layouts/_default/single.html b/themes/a2v/layouts/_default/single.html index c52d866..06c5add 100644 --- a/themes/a2v/layouts/_default/single.html +++ b/themes/a2v/layouts/_default/single.html @@ -1,6 +1,7 @@ {{ define "main" }}

        {{ .Title }}

        + {{ partial "source-path.html" . }} {{ .Content }}
        {{ end }} diff --git a/themes/a2v/layouts/creds/list.html b/themes/a2v/layouts/creds/list.html index 66019fa..8b9612f 100644 --- a/themes/a2v/layouts/creds/list.html +++ b/themes/a2v/layouts/creds/list.html @@ -4,7 +4,7 @@

        Данные зашифрованы. Нажмите "Расшифровать" и введите мастер-пароль.

        - {{ range where .Site.RegularPages "Section" "creds" }} + {{ range (where .Site.RegularPages "Section" "creds").ByDate.Reverse }}
        diff --git a/themes/a2v/layouts/creds/single.html b/themes/a2v/layouts/creds/single.html index a6a7315..3557a39 100644 --- a/themes/a2v/layouts/creds/single.html +++ b/themes/a2v/layouts/creds/single.html @@ -1,6 +1,7 @@ {{ define "main" }}

        {{ .Title }}

        + {{ partial "source-path.html" . }} {{ if .Params.description }}

        {{ .Params.description }}

        diff --git a/themes/a2v/layouts/diary/single.html b/themes/a2v/layouts/diary/single.html index 5c7499e..1c8a245 100644 --- a/themes/a2v/layouts/diary/single.html +++ b/themes/a2v/layouts/diary/single.html @@ -2,6 +2,7 @@

        {{ .Title }}

        {{ .Date.Format "02.01.2006" }}

        + {{ partial "source-path.html" . }} {{ .Content }} diff --git a/themes/a2v/layouts/guides/list.html b/themes/a2v/layouts/guides/list.html index 9aa3e8e..80bcd5d 100644 --- a/themes/a2v/layouts/guides/list.html +++ b/themes/a2v/layouts/guides/list.html @@ -3,7 +3,7 @@

        Инструкции

        - {{ range where .Site.RegularPages "Section" "guides" }} + {{ range (where .Site.RegularPages "Section" "guides").ByDate.Reverse }}
        diff --git a/themes/a2v/layouts/guides/single.html b/themes/a2v/layouts/guides/single.html index 12a424f..d60921f 100644 --- a/themes/a2v/layouts/guides/single.html +++ b/themes/a2v/layouts/guides/single.html @@ -1,6 +1,7 @@ {{ define "main" }}

        {{ .Title }}

        + {{ partial "source-path.html" . }} {{ if .Params.tags }}
        diff --git a/themes/a2v/layouts/kb/list.html b/themes/a2v/layouts/kb/list.html index 345947c..6e60c28 100644 --- a/themes/a2v/layouts/kb/list.html +++ b/themes/a2v/layouts/kb/list.html @@ -3,7 +3,7 @@

        База знаний

        - {{ range where .Site.RegularPages "Section" "kb" }} + {{ range (where .Site.RegularPages "Section" "kb").ByDate.Reverse }}
        diff --git a/themes/a2v/layouts/kb/single.html b/themes/a2v/layouts/kb/single.html index 12a424f..d60921f 100644 --- a/themes/a2v/layouts/kb/single.html +++ b/themes/a2v/layouts/kb/single.html @@ -1,6 +1,7 @@ {{ define "main" }}

        {{ .Title }}

        + {{ partial "source-path.html" . }} {{ if .Params.tags }}
        diff --git a/themes/a2v/layouts/leadera/list.html b/themes/a2v/layouts/leadera/list.html new file mode 100644 index 0000000..9a4bac2 --- /dev/null +++ b/themes/a2v/layouts/leadera/list.html @@ -0,0 +1,27 @@ +{{ define "main" }} +
        +

        {{ .Title }}

        + + {{ .Content }} + +
        + {{ range .Pages.ByDate.Reverse }} +
        +
        +
        +

        {{ .Title }}

        +

        {{ .Summary }}

        + {{ if .Params.tags }} +
        + {{ range .Params.tags }} + {{ . }} + {{ end }} +
        + {{ end }} +
        +
        +
        + {{ end }} +
        +
        +{{ end }} diff --git a/themes/a2v/layouts/leadera/single.html b/themes/a2v/layouts/leadera/single.html new file mode 100644 index 0000000..d60921f --- /dev/null +++ b/themes/a2v/layouts/leadera/single.html @@ -0,0 +1,16 @@ +{{ define "main" }} +
        +

        {{ .Title }}

        + {{ partial "source-path.html" . }} + + {{ if .Params.tags }} +
        + {{ range .Params.tags }} + {{ . }} + {{ end }} +
        + {{ end }} + + {{ .Content }} +
        +{{ end }} diff --git a/themes/a2v/layouts/partials/source-path.html b/themes/a2v/layouts/partials/source-path.html new file mode 100644 index 0000000..128e9fc --- /dev/null +++ b/themes/a2v/layouts/partials/source-path.html @@ -0,0 +1,8 @@ +
        + + 📁 ~/Projects/docs-a2v/content/{{ .File.Path }} + + +
        diff --git a/themes/a2v/layouts/plans/single.html b/themes/a2v/layouts/plans/single.html index a1df8e9..4f3409a 100644 --- a/themes/a2v/layouts/plans/single.html +++ b/themes/a2v/layouts/plans/single.html @@ -1,5 +1,8 @@ {{ define "main" }}
        +

        {{ .Title }}

        + {{ partial "source-path.html" . }} +

        {{ .Title }}