@ozdao/martyrs 0.2.602 → 0.2.604

package/src/modules/governance/TASK-TRACKER.MD

@@ -1,15 +1,15 @@
-Я изучу архитектуру вашего проекта Martyrs и доработаю ТЗ с учетом существующей кодовой базы. Сначала найду информацию об organizations, departments и общей архитектуре.## ТЗ: модуль управления проектами OZ DAO (доработка с учетом архитектуры Martyrs)
+## ТЗ: модуль управления инициативами OZ DAO (доработка с учетом архитектуры Martyrs)
 
 ### Назначение
-Модуль обеспечивает управление проектами с интеграцией в экосистему Martyrs: проекты с несколькими репозиториями, задачи (по умолчанию приватные для участников), merge requests, ревью и утверждение, выплаты исполнителям на внутренние кошельки, GitOps-раздел. Использует существующую инфраструктуру авторизации, организаций и ролей.
+Модуль обеспечивает управление инициативами с интеграцией в экосистему Martyrs: инициативы с несколькими репозиториями, задачи (по умолчанию приватные для участников), merge requests, ревью и утверждение, выплаты исполнителям на внутренние кошельки, GitOps-раздел. Использует существующую инфраструктуру авторизации, организаций и ролей.
 
 ### Архитектурная интеграция
 
 **Базовые модели и связи:**
-- Расширение `db.organization` через связь с `db.project` (owner.type: 'Organization')
-- Использование `db.membership` для управления участниками проекта с расширенными ролями
-- Интеграция с `db.department` для привязки проектов к подразделениям
-- Применение существующей системы `invites` для приглашений в проекты
+- Расширение `db.organization` через связь с `db.initiative` (owner.type: 'Organization')
+- Использование `db.membership` для управления участниками инициативы с расширенными ролями
+- Интеграция с `db.department` для привязки инициатив к подразделениям
+- Применение существующей системы `invites` для приглашений в инициативы
 
 **Ключевые файлы для просмотра:**
 - `modules/organizations/models/membership.model.js` - базовая модель членства
@@ -19,17 +19,17 @@
 - `modules/core/controllers/classes/abac/` - система контроля доступа
 
 ### Основной поток
-Создание проекта в организации → назначение department (опционально) → приглашение участников через invites → добавление репозиториев → создание задач → выполнение задач → открытие MR с привязкой к задаче → ревью и утверждение → закрытие задачи и приёмка → выплата через wallet модуль.
+Создание инициативы в организации → назначение department (опционально) → приглашение участников через invites → добавление репозиториев → создание задач → выполнение задач → открытие MR с привязкой к задаче → ревью и утверждение → закрытие задачи и приёмка → выплата через wallet модуль.
 
-### Расширение модели Membership для проектов
+### Расширение модели Membership для инициатив
 
-**Дополнительные поля в membership для контекста проекта:**
+**Дополнительные поля в membership для контекста инициативы:**
 ```
 membership.context = {
-  type: 'Project', // или 'Organization', 'Department'
-  target: ObjectId // ID проекта
+  type: 'Initiative', // или 'Organization', 'Department'
+  target: ObjectId // ID инициативы
 }
-membership.projectRole: String // 'owner', 'management', 'contributor'
+membership.initiativeRole: String // 'owner', 'management', 'contributor'
 membership.permissions: {
   merge: Boolean,
   deploy: Boolean,
@@ -38,33 +38,33 @@ membership.permissions: {
 }
 ```
 
-### Роли проекта (через расширенный membership)
+### Роли инициативы (через расширенный membership)
 
-- **Owner проекта** — создатель проекта или назначенный владелец из организации
-  - Полный контроль через `membership.projectRole === 'owner'`
+- **Owner инициативы** — создатель инициативы или назначенный владелец из организации
+  - Полный контроль через `membership.initiativeRole === 'owner'`
   - Автоматически получает все permissions: true
   - Наследует права от `organizationHelpers.isOrganizationOwner()`
 
-- **Management проекта** — участники с правами управления
-  - `membership.projectRole === 'management'`
+- **Management инициативы** — участники с правами управления
+  - `membership.initiativeRole === 'management'`
   - Настраиваемые permissions через `membership.permissions`
   - По умолчанию: merge, deploy, budget = true; veto = false
 
-- **Contributors проекта** — разработчики и исполнители
-  - `membership.projectRole === 'contributor'`
+- **Contributors инициативы** — разработчики и исполнители
+  - `membership.initiativeRole === 'contributor'`
   - Базовые права: создание задач и MR
   - permissions по умолчанию все false
 
 ### Интеграция с ABAC системой
 
-**Регистрация политик проекта:**
+**Регистрация политик инициативы:**
 ```
-// В modules/projects/policies/projects.policies.js
-abacAccessControl.registerResourcePolicy('project', async context => {
+// В modules/governance/policies/initiatives.policies.js
+abacAccessControl.registerResourcePolicy('initiative', async context => {
   // Использование organizationHelpers для проверки прав
-  const orgId = await getProjectOrganization(context.currentResource);
+  const orgId = await getInitiativeOrganization(context.currentResource);
   const isOrgMember = await context.checkOrganizationMember(context.user, orgId);
-  // Проверка projectRole через membership
+  // Проверка initiativeRole через membership
 });
 ```
 
@@ -88,7 +88,7 @@ abac.registerFieldsPolicy('task', {
 ### Правила действий (через ABAC middleware)
 
 - **Ветки и push** — проверка через `abac.middleware('repository', 'push')`
-  - Требует projectRole: owner/management
+  - Требует initiativeRole: owner/management
 - **MR создание** — открыто для всех с доступом к задаче
 - **Merge** — требует permissions.merge === true
 - **Выплаты** — требует permissions.budget === true
@@ -115,19 +115,19 @@ voting: {
 
 **Интеграция с WebSocket:**
 - События голосования транслируются через `WebSocketManager`
-- Использование существующих каналов: `project:{id}`, `task:{id}`
+- Использование существующих каналов: `initiative:{id}`, `task:{id}`
 - Real-time обновления статусов через `globalswebsocket`
 
 ### Задачи (расширение governance/tasks)
 
-**Дополнительные поля для проектных задач:**
+**Дополнительные поля для задач:**
 ```
-task.project: ObjectId // связь с проектом
+task.initiative: ObjectId // связь с инициативой
 task.repository: String // целевой репозиторий
 task.branch: String // целевая ветка
 task.mergeRequests: [ObjectId] // связанные MR
 task.visibility: {
-  type: String, // 'project', 'public', 'custom'
+  type: String, // 'initiative', 'public', 'custom'
   allowList: [ObjectId], // для custom
   denyList: [ObjectId]
 }
@@ -143,23 +143,23 @@ task.passed: Boolean // флаг приёмки
 
 **Использование notifications модуля:**
 - Подключение к `modules/notifications/` для email/push уведомлений
-- События проекта регистрируются через Observer pattern
-- Логирование через `core.logger` с категорией 'project'
+- События инициативы регистрируются через Observer pattern
+- Логирование через `core.logger` с категорией 'initiative'
 
 **WebSocket события:**
 ```javascript
 // Используя WebSocketManager из globals
-wss.broadcast(`project:${projectId}`, {
+wss.broadcast(`initiative:${initiativeId}`, {
   event: 'task.updated',
   data: taskData,
-  permissions: ['project.member'] // фильтрация по правам
+  permissions: ['initiative.member'] // фильтрация по правам
 });
 ```
 
 ### Инварианты и валидация
 
-- **Owner контроль** — проверка через `organizationHelpers.isOrganizationOwner()` или `membership.projectRole === 'owner'`
-- **Cascade permissions** — права организации наследуются проектом
+- **Owner контроль** — проверка через `organizationHelpers.isOrganizationOwner()` или `membership.initiativeRole === 'owner'`
+- **Cascade permissions** — права организации наследуются инициативой
 - **Atomic operations** — использование транзакций MongoDB для критичных операций
 - **Audit trail** — логирование всех действий через `db.log`
 - **Cache invalidation** — сброс кеша при изменении прав через `Cache` из globals
@@ -168,7 +168,7 @@ wss.broadcast(`project:${projectId}`, {
 
 | Действие | Owner | Management | Contributor | Условия |
 |----------|-------|------------|-------------|---------|
-| Создание проекта | ✓ | ✗ | ✗ | Требует прав в организации |
+| Создание инициативы | ✓ | ✗ | ✗ | Требует прав в организации |
 | Управление участниками | ✓ | ✗ | ✗ | - |
 | Создание задач | ✓ | ✓ | ✓ | - |
 | Создание MR | ✓ | ✓ | ✓ | Доступ к задаче |
@@ -178,15 +178,510 @@ wss.broadcast(`project:${projectId}`, {
 | Deploy | ✓ | ✓* | ✗ | *При permissions.deploy |
 | Наложение вето | ✓ | ✓* | ✗ | *При permissions.veto |
 | Снятие вето | ✓ | ✗ | ✗ | Только owner |
-| Удаление проекта | ✓ | ✗ | ✗ | - |
+| Удаление инициативы | ✓ | ✗ | ✗ | - |
 
 ### Интеграция с существующими модулями
 
 - **auth** — использование `auth.state.user` для текущего пользователя
 - **wallet** — интеграция для выплат через внутренние кошельки
-- **notifications** — уведомления о событиях проекта
+- **notifications** — уведомления о событиях инициативы
 - **globals/cache** — кеширование прав доступа
 - **globals/logger** — аудит всех действий
 - **organizations** — наследование структуры и прав
 
-Этот подход максимально использует существующую инфраструктуру Martyrs, минимизируя дублирование кода и обеспечивая консистентность с остальной системой.
+Этот подход максимально использует существующую инфраструктуру Martyrs, минимизируя дублирование кода и обеспечивая консистентность с остальной системой.
+
+---
+
+### Статус реализации
+
+#### Initiatives — миграция с mock на БД (выполнено)
+
+**Проблема:** Страница инициативы (`/governance/initiatives/:id`) использовала хардкоженные данные из `data/mockData.js`. Форма создания содержала только 3 поля (name, description, status). Verifier не пропускал расширенные поля — они отбрасывались при create/update.
+
+**Что сделано:**
+
+1. **Verifier** (`middlewares/initiatives.verifier.js`) — добавлены optional поля в createVerifier и updateVerifier: `fullDescription`, `valueProposition`, `targetAudience`, `successCriteria`, `repositories`, `links`, `environments`, `releases`, `metrics`, `sprints`
+
+2. **Store** (`views/store/initiatives.js`) — исправлена обработка ответа `getInitiativeById` (API возвращает массив, теперь берётся `[0]`). Расширен default state `current` всеми полями.
+
+3. **Форма создания** (`views/components/sections/FormInitiativeDetails.vue`) — полная перестройка. Секции: Basic Info, Detailed Description (с динамическим списком successCriteria), Repositories (динамический список name+path), Links (5 категорий с динамическими URL), Environments (name, url, status, version), Releases (version, date, notes, status), Metrics (6 числовых/select полей).
+
+4. **Страница создания** (`views/components/pages/InitiativeCreate.vue`) — добавлены стилизация, кнопка назад, инициализация всех полей, redirect после создания на `/governance/initiatives/:id`.
+
+5. **Страница инициативы** (`views/components/pages/Initiative.vue`) — удалён импорт `mockData`. `initiative` читается напрямую из `initiativesState.current`. Milestones загружаются через `GET /api/initiatives/:id/milestones`. Votings загружаются через `GET /api/votings/read` с клиентской фильтрацией по initiative ID. Router-link переведены на path-based навигацию.
+
+6. **Тестовые данные** — создана инициатива в БД (`_id: 698759840f5b375a233230cd`) со всеми полями из mockData.
+
+**Известные ограничения:**
+- `GET /api/votings/read?initiative=<id>` — параметр `initiative` проходит verifier, но `queryProcessor.getBasicOptions()` его не обрабатывает. Фильтрация выполняется на клиенте.
+- `data/mockData.js` — не удалён, может использоваться другими компонентами.
+- Модель `initiative.model.js` — `strict: false`, схема не расширялась (все поля сохраняются без валидации на уровне Mongoose).
+
+---
+
+## ТЗ: Milestones, Tasks, Votings — миграция с mock на БД
+
+### Проблема
+
+8 страниц governance используют хардкоженные данные из `data/mockData.js`. Формы создания содержат 3-4 поля. Store-ы содержат баги (массив вместо объекта в `current`). Store для milestones отсутствует. Имена файлов store-ов перепутаны.
+
+**Страницы с mock-зависимостью:**
+
+| Страница | Файл | Какие mock-массивы использует |
+|----------|------|-------------------------------|
+| Milestone detail | `Milestone.vue` | mockMilestones, mockTasks |
+| Task detail | `Task.vue` | mockTasks, mockInitiatives, mockMilestones, mockVotings |
+| Tasks list | `Tasks.vue` | mockTasks |
+| Voting detail | `Voting.vue` | mockVotings, mockTasks, mockInitiatives, mockMilestones |
+| Votings list | `Votings.vue` | mockVotings |
+| Roadmap | `Roadmap.vue` | mockInitiatives, mockMilestones |
+| Initiative milestones | `InitiativeMilestones.vue` | mockInitiatives, mockMilestones |
+| Task create | `TaskCreate.vue` | — (но использует `name` вместо `title`, статус `todo` вместо `not_started`) |
+| Voting create | `VotingCreate.vue` | — (но сломан импорт: `votesActions` из `../../store/votings`) |
+
+### Маппинг полей mock → БД
+
+**Milestones:**
+| Mock поле | БД поле | Примечание |
+|-----------|---------|------------|
+| `id` | `_id` | String → ObjectId |
+| `initiativeId` | `initiative` | String → ObjectId ref |
+| `owner` | `owner` | `{id, name, avatar}` → ObjectId ref, нужен populate |
+| `contributors` | `contributors` | `[{id, name, avatar}]` → `[ObjectId]` ref, нужен populate |
+| `taskCount` | — | Нет в модели, вычисляется через count tasks с `milestone: _id` |
+
+**Tasks:**
+| Mock поле | БД поле | Примечание |
+|-----------|---------|------------|
+| `id` | `_id` | String → ObjectId |
+| `initiativeId` | `initiative` | String → ObjectId ref |
+| `milestoneId` | `milestone` | String → ObjectId ref |
+| `assignee` | `assignedTo` | `{id, name, avatar}` → ObjectId ref, нужен populate |
+| `votingId` | — | Нет прямого поля, связь через Voting.targetId |
+| `startVotingId` | `proposedByVoting` | String → ObjectId ref |
+| `approvalVotingId` | `completionVoting` | String → ObjectId ref |
+| `project` | `initiative` | В Task.vue секция показывает initiative.title |
+| `repository` | — | Нет в модели task, данные из initiative.repositories |
+| `branch` | — | Нет в модели task |
+| `mergeRequests` | — | Нет в модели task |
+| `visibility` | — | Нет в модели task |
+| `budget` | — | Нет в модели task |
+| `passed` | — | Нет в модели task |
+| `permissions` | — | Нет в модели task |
+
+**Votings:**
+| Mock поле | БД поле | Примечание |
+|-----------|---------|------------|
+| `id` | `_id` | String → ObjectId |
+| `status` | `result` | Mock `status` = approved/rejected/pending → DB `result` = approved/rejected/pending. DB также имеет `status` = pending/active/closed (статус процесса, не итог) |
+| `linkedEntityType` | `targetModel` | `'initiative'/'task'` → `'Initiative'/'Task'/'Milestone'` (с большой буквы) |
+| `linkedEntityId` | `targetId` | String → ObjectId |
+| `threshold` | `threshold` | Mock: 0.6 (доля) → DB: 51 (проценты). Нужна конвертация `* 100` |
+| `totalVotes` | — | Нет в модели, вычисляется из `votes.length` |
+| `yesVotes` | — | Нет, вычисляется из votes |
+| `noVotes` | — | Нет, вычисляется из votes |
+| `abstainVotes` | — | Нет, вычисляется из votes |
+| `votes` (inline) | `votes` | Mock: inline `[{userId, vote, comment}]` → DB: `[ObjectId]` refs на Vote модель |
+
+### Баги и проблемы в текущем коде
+
+1. **Перепутаны имена store файлов:**
+   - `views/store/votes.js` — экспортирует `votingsActions`, `votingsState` (это VOTINGS store)
+   - `views/store/votings.js` — экспортирует `votesActions`, `votesState` (это VOTES store)
+
+2. **VotingCreate.vue сломан:** `import { votesActions } from '../../store/votings'` — импортирует `votesActions` (для голосов), но вызывает `votesActions.createVoting()` (метод которого нет в votesActions). Нужно: `import { votingsActions } from '../../store/votes'`
+
+3. **TaskCreate.vue использует `name` вместо `title`:** БД модель и verifier используют `title`, а форма отправляет `name`. Статус `todo` не валиден (нужен `not_started`).
+
+4. **Баг массива в getById:** `tasksState.current = response.data` и `votingsState.current = response.data` — API возвращает массив, нужно `Array.isArray(response.data) ? response.data[0] : response.data`.
+
+5. **Нет store для milestones** — файл `views/store/milestones.js` не существует.
+
+6. **queryProcessor не поддерживает фильтрацию** по `initiative`, `milestone`, `assignedTo` — только `_id, url, status, type, organization, owner, customer, creator, product, listing`. Фильтрация на клиенте.
+
+---
+
+### Шаг 1: Создать store для milestones
+
+**Файл:** `views/store/milestones.js` (новый)
+
+Паттерн аналогичен `tasks.js` и `votes.js`. Reactive state + actions + watch history.
+
+```javascript
+// State
+milestonesState = reactive({
+  all: [],
+  current: {
+    name: '', description: '', status: 'not_started',
+    startDate: null, dueDate: null, completedDate: null,
+    progress: 0, owner: null, contributors: [],
+    initiative: null, priority: 'medium', tags: [],
+    dependencies: [], metadata: null,
+    createdAt: null, updatedAt: null,
+  },
+})
+
+// Actions
+milestonesActions = {
+  getAllMilestones()       // GET /api/milestones/read
+  getMilestoneById(id)     // GET /api/milestones/read?_id=id → Array.isArray fix
+  createMilestone(data)    // POST /api/milestones/create
+  updateMilestone(data)    // PUT /api/milestones/update
+  deleteMilestone(id)      // POST /api/milestones/delete
+}
+```
+
+Export: `{ milestonesActions, milestonesState }`
+
+---
+
+### Шаг 2: Исправить stores tasks и votings
+
+**Файл:** `views/store/tasks.js`
+
+1. Исправить `getTaskById` — обработка массива:
+```javascript
+tasksState.current = Array.isArray(response.data) ? response.data[0] : response.data;
+```
+
+2. Расширить default state `current`:
+```javascript
+current: {
+  title: '', description: '', status: 'not_started',
+  assignedTo: null, dueDate: null,
+  milestone: null, initiative: null,
+  priority: 'medium', tags: [],
+  proposedByVoting: null, completionVoting: null,
+  completedDate: null,
+  createdAt: null, updatedAt: null,
+}
+```
+
+**Файл:** `views/store/votes.js` (это votings store!)
+
+1. Исправить `getVotingById` — обработка массива:
+```javascript
+votingsState.current = Array.isArray(response.data) ? response.data[0] : response.data;
+```
+
+2. Расширить default state `current`:
+```javascript
+current: {
+  title: '', description: '', type: 'general',
+  targetModel: null, targetId: null,
+  threshold: 51, participants: [],
+  result: 'pending', initiative: null, milestone: null,
+  metadata: null, startDate: null, endDate: null,
+  status: 'pending', votes: [],
+  createdAt: null, updatedAt: null,
+}
+```
+
+---
+
+### Шаг 3: Создать FormMilestoneDetails.vue
+
+**Файл:** `views/components/sections/FormMilestoneDetails.vue` (новый)
+
+Компонент формы для создания/редактирования milestone. `v-model` паттерн как у `FormInitiativeDetails.vue`.
+
+**Поля:**
+- name (required, text)
+- description (textarea)
+- status (select: not_started, in_progress, completed, blocked, cancelled)
+- startDate (date input)
+- dueDate (date input)
+- progress (number, 0-100)
+- owner (text/ObjectId — на первом этапе просто text input)
+- priority (select: low, medium, high, urgent)
+- tags (динамический список строк)
+- initiative (text/ObjectId — на первом этапе text input)
+
+---
+
+### Шаг 4: Перестроить FormTaskDetails.vue
+
+**Файл:** `views/components/sections/FormTaskDetails.vue`
+
+Текущее состояние: 4 bare HTML поля (name, description, status со значениями todo/inProgress/done, assignedTo).
+
+**Нужно:**
+- title (required, text) — не `name`!
+- description (textarea)
+- status (select: proposed, voting, not_started, in_progress, review, completed, blocked, cancelled)
+- assignedTo (text/ObjectId)
+- dueDate (date input)
+- milestone (text/ObjectId)
+- initiative (text/ObjectId)
+- priority (select: low, medium, high, urgent)
+- tags (динамический список строк)
+
+---
+
+### Шаг 5: Перестроить FormVotingDetails.vue
+
+**Файл:** `views/components/sections/FormVotingDetails.vue`
+
+Текущее состояние: 4 bare HTML поля (title, description, startDate, endDate).
+
+**Нужно:**
+- title (required, text)
+- description (textarea)
+- type (required, select: create_task, approve_task, create_initiative, update_milestone, general)
+- targetModel (select: Task, Initiative, Milestone, — пустое)
+- targetId (text/ObjectId)
+- threshold (number, 1-100, default 51)
+- initiative (text/ObjectId)
+- milestone (text/ObjectId)
+- startDate (date input)
+- endDate (date input)
+- status (select: pending, active, closed)
+
+---
+
+### Шаг 6: Перестроить TaskCreate.vue
+
+**Файл:** `views/components/pages/TaskCreate.vue`
+
+Текущее: bare div, 4 поля, `name` вместо `title`, статус `todo`, нет redirect.
+
+**Нужно:**
+- Стилизация как в `InitiativeCreate.vue` (pd-medium, кнопка назад, bg-main кнопка)
+- Полный `newTask` ref со всеми полями:
+```javascript
+newTask = ref({
+  title: '', description: '', status: 'not_started',
+  assignedTo: '', dueDate: null,
+  milestone: '', initiative: '',
+  priority: 'medium', tags: [],
+})
+```
+- Redirect после создания: `router.push('/governance/tasks/' + response._id)`
+- Кнопка назад на `/governance/tasks`
+- Импорт `tasksActions` из `../../store/tasks`
+
+---
+
+### Шаг 7: Перестроить VotingCreate.vue
+
+**Файл:** `views/components/pages/VotingCreate.vue`
+
+Текущее: сломан импорт (`votesActions` из `../../store/votings`), 4 поля, нет redirect.
+
+**Нужно:**
+- Исправить импорт: `import { votingsActions } from '../../store/votes'`
+- Стилизация как в `InitiativeCreate.vue`
+- Полный `newVoting` ref:
+```javascript
+newVoting = ref({
+  title: '', description: '', type: 'general',
+  targetModel: '', targetId: '',
+  threshold: 51, initiative: '', milestone: '',
+  startDate: null, endDate: null, status: 'pending',
+})
+```
+- Redirect после создания: `router.push('/governance/votings/' + response._id)`
+- Кнопка назад на `/governance/votings`
+- Вызов: `votingsActions.createVoting(newVoting.value)`
+
+---
+
+### Шаг 8: Создать MilestoneCreate.vue
+
+**Файл:** `views/components/pages/MilestoneCreate.vue` (новый)
+
+Страница не существует, нужно создать. Паттерн аналогичен `InitiativeCreate.vue`.
+
+- Кнопка назад на `/governance/milestones` (или `/governance/roadmap`)
+- Полный `newMilestone` ref:
+```javascript
+newMilestone = ref({
+  name: '', description: '', status: 'not_started',
+  startDate: null, dueDate: null, progress: 0,
+  owner: '', initiative: '',
+  priority: 'medium', tags: [],
+})
+```
+- Redirect после создания: `router.push('/governance/milestones/' + response._id)`
+- Импорт `milestonesActions` из `../../store/milestones`
+
+**Добавить роут** в `governance.client.js` и `global.config.js` если нужно.
+
+---
+
+### Шаг 9: Milestone.vue — убрать mock
+
+**Файл:** `views/components/pages/Milestone.vue`
+
+Текущее: `mockMilestones.find(m => m.id === route.params.id)` и `mockTasks.filter(t => t.milestoneId === route.params.id)`.
+
+**Нужно:**
+1. Удалить `import { mockMilestones, mockTasks } from '../../../data/mockData'`
+2. Импортировать `{ milestonesActions, milestonesState }` из store
+3. Импортировать `$axios` для запроса tasks
+4. `milestone` = `computed(() => milestonesState.current)`
+5. В `onMounted`:
+   - `milestonesActions.getMilestoneById(route.params.id)`
+   - `const res = await $axios.get('/api/tasks/read')` → фильтрация на клиенте: `.filter(t => t.milestone === route.params.id)`
+6. Обработать отсутствие `taskCount` — вычислять из реального массива tasks
+
+---
+
+### Шаг 10: Task.vue — убрать mock
+
+**Файл:** `views/components/pages/Task.vue`
+
+Текущее: использует mockTasks, mockInitiatives, mockMilestones, mockVotings для отображения задачи, связанной инициативы, milestone, голосований.
+
+**Нужно:**
+1. Удалить все mock импорты
+2. Импортировать stores:
+   - `{ tasksActions, tasksState }` из `../../store/tasks`
+   - `{ initiativesActions, initiativesState }` из `../../store/initiatives`
+   - `{ milestonesActions, milestonesState }` из `../../store/milestones`
+   - `{ votingsActions, votingsState }` из `../../store/votes`
+3. `task` = `computed(() => tasksState.current)`
+4. В `onMounted`:
+   - `await tasksActions.getTaskById(route.params.id)`
+   - Загрузить связанную initiative: `initiativesActions.getInitiativeById(task.value.initiative)` (если initiative не null)
+   - Загрузить связанный milestone: `milestonesActions.getMilestoneById(task.value.milestone)` (если milestone не null)
+   - Загрузить связанные votings: `votingsActions.getAllVotings()` → `computed` фильтрация по `targetId === task._id`
+5. Секция "Repository Information" показывает `initiativesState.current.title`. Секции repository/branch/mergeRequests/budget/permissions — обернуть в v-if (полей пока нет в модели task)
+
+---
+
+### Шаг 11: Tasks.vue — убрать mock
+
+**Файл:** `views/components/pages/Tasks.vue`
+
+Текущее: `ref(mockTasks)`, группировка по статусам.
+
+**Нужно:**
+1. Удалить `import { mockTasks }`
+2. Импортировать `{ tasksActions, tasksState }`
+3. В `onMounted`: `tasksActions.getAllTasks()`
+4. `tasks` = `computed(() => tasksState.all)`
+5. Группировка по статусам остаётся, но использовать реальные статусы из модели
+
+---
+
+### Шаг 12: Voting.vue — убрать mock
+
+**Файл:** `views/components/pages/Voting.vue`
+
+Текущее: mockVotings + резолвинг linkedEntity через mockTasks/mockInitiatives/mockMilestones.
+
+**Нужно:**
+1. Удалить все mock импорты
+2. Импортировать `{ votingsActions, votingsState }` из `../../store/votes`
+3. `voting` = `computed(() => votingsState.current)`
+4. В `onMounted`:
+   - `votingsActions.getVotingById(route.params.id)`
+   - Загрузить linked entity через `targetModel`/`targetId`:
+     ```javascript
+     if (voting.targetModel && voting.targetId) {
+       const endpoint = voting.targetModel.toLowerCase() + 's'; // 'tasks', 'initiatives', 'milestones'
+       const res = await $axios.get(`/api/${endpoint}/read`, { params: { _id: voting.targetId } });
+       linkedEntity.value = Array.isArray(res.data) ? res.data[0] : res.data;
+     }
+     ```
+   - Загрузить votes: `votesActions.getVotesForVoting(route.params.id)` (или `$axios.get('/api/votes/read', { params: { voting: id } })`)
+5. Маппинг полей: mock `status` = DB `result`, mock `linkedEntityType` = DB `targetModel`, mock `threshold` = DB threshold (уже в %)
+6. Подсчёт yesVotes/noVotes/abstainVotes — вычислять из массива votes
+
+---
+
+### Шаг 13: Votings.vue — убрать mock
+
+**Файл:** `views/components/pages/Votings.vue`
+
+Текущее: `ref(mockVotings)`, фильтрация по type/status.
+
+**Нужно:**
+1. Удалить mock импорт
+2. Импортировать `{ votingsActions, votingsState }` из `../../store/votes`
+3. В `onMounted`: `votingsActions.getAllVotings()`
+4. `votings` = `computed(() => votingsState.all)`
+5. Фильтрация: mock `status` → DB `result` для фильтра по итогу, DB `status` для фильтра по процессу
+
+---
+
+### Шаг 14: Roadmap.vue и InitiativeMilestones.vue — убрать mock
+
+**Файл:** `views/components/pages/Roadmap.vue`
+
+Текущее: mockInitiatives + mockMilestones, табы milestones/releases.
+
+**Нужно:**
+1. Удалить mock импорты
+2. Импортировать stores: initiatives, milestones
+3. В `onMounted`: загрузить все initiatives и milestones
+4. Использовать реальные данные из store state
+
+**Файл:** `views/components/pages/InitiativeMilestones.vue`
+
+Аналогично Roadmap.vue — убрать mock, использовать stores.
+
+---
+
+### Шаг 15: Создать тестовые данные в БД
+
+Через API создать записи с данными из mockData.js (аналогично инициативе `698759840f5b375a233230cd`).
+
+**Порядок создания (из-за зависимостей ObjectId):**
+1. Milestones (5 шт) — ссылаются на initiative `698759840f5b375a233230cd`
+2. Tasks (10 шт) — ссылаются на milestones и initiative
+3. Votings (6 шт) — ссылаются на tasks/initiatives через targetModel/targetId
+
+**Конвертация при создании:**
+- Milestone: `initiativeId: '1'` → `initiative: '698759840f5b375a233230cd'`, `owner: {id:'1',...}` → `owner: <реальный userId>`
+- Task: `milestoneId` → `milestone: <ObjectId созданного milestone>`, `assignee` → `assignedTo: <userId>`, `name` поле не нужно (используется `title`)
+- Voting: `linkedEntityType: 'task'` → `targetModel: 'Task'`, `linkedEntityId: '5'` → `targetId: <ObjectId task>`, `threshold: 0.6` → `threshold: 60`, `status: 'approved'` → `result: 'approved'`
+
+---
+
+### Файлы для модификации (сводка)
+
+| # | Файл | Действие | Статус |
+|---|------|----------|--------|
+| 1 | `views/store/milestones.js` | **Создать** — новый store | ✅ Готово |
+| 2 | `views/store/tasks.js` | Исправить getById массив, расширить default state | ✅ Готово |
+| 3 | `views/store/votes.js` | Исправить getById массив, расширить default state | ✅ Готово |
+| 4 | `views/components/sections/FormMilestoneDetails.vue` | **Создать** — форма milestone | ✅ Готово |
+| 5 | `views/components/sections/FormTaskDetails.vue` | Перестроить — все поля из модели | ✅ Готово |
+| 6 | `views/components/sections/FormVotingDetails.vue` | Перестроить — все поля из модели | ✅ Готово |
+| 7 | `views/components/pages/TaskCreate.vue` | Перестроить — стилизация, правильные поля, redirect | ✅ Готово |
+| 8 | `views/components/pages/VotingCreate.vue` | Перестроить — fix импорт, стилизация, все поля, redirect | ✅ Готово |
+| 9 | `views/components/pages/MilestoneCreate.vue` | **Создать** — страница создания milestone | ✅ Готово |
+| 10 | `views/components/pages/Milestone.vue` | Убрать mock, использовать store + API | ✅ Готово |
+| 11 | `views/components/pages/Task.vue` | Убрать mock, использовать store + API | ✅ Готово |
+| 12 | `views/components/pages/Tasks.vue` | Убрать mock, использовать store | ✅ Готово |
+| 13 | `views/components/pages/Voting.vue` | Убрать mock, использовать store + API | ✅ Готово |
+| 14 | `views/components/pages/Votings.vue` | Убрать mock, использовать store | ✅ Готово |
+| 15 | `views/components/pages/Roadmap.vue` | Убрать mock, использовать stores | ✅ Готово |
+| 16 | `views/components/pages/InitiativeMilestones.vue` | Убрать mock, использовать stores | ✅ Готово |
+
+**Дополнительно исправлено (вне основного scope):**
+- `views/store/votings.js` — убраны `|| .id` fallback-и
+- `views/components/blocks/CardVotingItem.vue` — `_id` вместо `_id || id`, path-based router-link
+- `views/components/blocks/CardMilestoneItem.vue` — `_id` вместо `_id || id`, path-based router-link
+- `views/components/blocks/CardTaskItem.vue` — `_id` вместо `_id || id`, path-based router-link
+- `views/components/blocks/CardInitiativeItem.vue` — `_id` вместо `_id || id`, path-based router-link
+- `views/router/governance.router.js` — добавлен роут `milestones/create`
+
+**Не модифицируем:**
+- Модели (`milestone.model.js`, `task.model.js`, `voting.model.js`) — схемы достаточны для текущих данных
+- Verifier-ы — уже содержат все нужные поля
+- `data/mockData.js` — удалить после миграции всех страниц (отдельным шагом)
+
+### Известные ограничения
+
+- **queryProcessor** не поддерживает фильтрацию по `initiative`, `milestone`, `assignedTo` — все фильтрации на клиенте через `.filter()` после загрузки полного списка
+- **owner/assignee** — бэкенд должен агрегировать (populate). Фронтенд ожидает объекты `{name, avatar}`. Если бэк не популейтит — будут отображаться ObjectId строки
+- **votes** в mock voting = inline массив `[{userId, vote, comment}]`, в БД = `[ObjectId]` refs на Vote модель. В Voting.vue подсчёт голосов через отдельный запрос `GET /api/votes/read?voting=<id>`
+- **Маппинг mock → DB полей в Voting.vue:** mock `status` (approved/rejected/pending) = DB `result`, mock `linkedEntityType` = DB `targetModel`, mock `linkedEntityId` = DB `targetId`. `isActive` проверяет `status === 'active'` (процесс голосования активен)
+- Mock `task.project` соответствует `task.initiative` (ObjectId ref). В Task.vue секция показывает initiative.title
+- Поля `repository`, `branch`, `mergeRequests`, `visibility`, `budget`, `passed`, `permissions` — нет в модели task. В UI обёрнуты в v-if
+- Все router-link переведены на path-based навигацию (вместо name-based) из-за ленивой загрузки модулей
+- Везде используется `_id` без fallback на `id`