@ozdao/martyrs 0.2.547 → 0.2.549

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

@@ -0,0 +1,192 @@
+Я изучу архитектуру вашего проекта Martyrs и доработаю ТЗ с учетом существующей кодовой базы. Сначала найду информацию об organizations, departments и общей архитектуре.## ТЗ: модуль управления проектами OZ DAO (доработка с учетом архитектуры Martyrs)
+
+### Назначение
+Модуль обеспечивает управление проектами с интеграцией в экосистему Martyrs: проекты с несколькими репозиториями, задачи (по умолчанию приватные для участников), merge requests, ревью и утверждение, выплаты исполнителям на внутренние кошельки, GitOps-раздел. Использует существующую инфраструктуру авторизации, организаций и ролей.
+
+### Архитектурная интеграция
+
+**Базовые модели и связи:**
+- Расширение `db.organization` через связь с `db.project` (owner.type: 'Organization')
+- Использование `db.membership` для управления участниками проекта с расширенными ролями
+- Интеграция с `db.department` для привязки проектов к подразделениям
+- Применение существующей системы `invites` для приглашений в проекты
+
+**Ключевые файлы для просмотра:**
+- `modules/organizations/models/membership.model.js` - базовая модель членства
+- `modules/organizations/models/schemas/accesses.schema.js` - схема доступов
+- `modules/organizations/policies/organizations.policies.js` - политики ABAC
+- `modules/organizations/controllers/utils/queryProcessorOrganizations.js` - обработка запросов
+- `modules/globals/controllers/classes/abac/` - система контроля доступа
+
+### Основной поток
+Создание проекта в организации → назначение department (опционально) → приглашение участников через invites → добавление репозиториев → создание задач → выполнение задач → открытие MR с привязкой к задаче → ревью и утверждение → закрытие задачи и приёмка → выплата через wallet модуль.
+
+### Расширение модели Membership для проектов
+
+**Дополнительные поля в membership для контекста проекта:**
+```
+membership.context = {
+  type: 'Project', // или 'Organization', 'Department'
+  target: ObjectId // ID проекта
+}
+membership.projectRole: String // 'owner', 'management', 'contributor'
+membership.permissions: {
+  merge: Boolean,
+  deploy: Boolean,
+  budget: Boolean,
+  veto: Boolean
+}
+```
+
+### Роли проекта (через расширенный membership)
+
+- **Owner проекта** — создатель проекта или назначенный владелец из организации
+  - Полный контроль через `membership.projectRole === 'owner'`
+  - Автоматически получает все permissions: true
+  - Наследует права от `organizationHelpers.isOrganizationOwner()`
+
+- **Management проекта** — участники с правами управления
+  - `membership.projectRole === 'management'`
+  - Настраиваемые permissions через `membership.permissions`
+  - По умолчанию: merge, deploy, budget = true; veto = false
+
+- **Contributors проекта** — разработчики и исполнители
+  - `membership.projectRole === 'contributor'`
+  - Базовые права: создание задач и MR
+  - permissions по умолчанию все false
+
+### Интеграция с ABAC системой
+
+**Регистрация политик проекта:**
+```
+// В modules/projects/policies/projects.policies.js
+abacAccessControl.registerResourcePolicy('project', async context => {
+  // Использование organizationHelpers для проверки прав
+  const orgId = await getProjectOrganization(context.currentResource);
+  const isOrgMember = await context.checkOrganizationMember(context.user, orgId);
+  // Проверка projectRole через membership
+});
+```
+
+**Использование field policies для задач:**
+```
+abac.registerFieldsPolicy('task', {
+  'budget': { 
+    access: async (context) => context.membership?.permissions?.budget,
+    actions: ['update']
+  },
+  'status': {
+    access: async (context) => {
+      if (context.value === 'done') {
+        return context.membership?.permissions?.merge;
+      }
+    }
+  }
+});
+```
+
+### Правила действий (через ABAC middleware)
+
+- **Ветки и push** — проверка через `abac.middleware('repository', 'push')`
+  - Требует projectRole: owner/management
+- **MR создание** — открыто для всех с доступом к задаче
+- **Merge** — требует permissions.merge === true
+- **Выплаты** — требует permissions.budget === true
+- **Deploy/rollback** — требует permissions.deploy === true
+- **Наложение вето** — требует permissions.veto === true
+
+### Голосование (microDAO интеграция)
+
+**Структура голосования:**
+```
+voting: {
+  type: 'task' | 'mr' | 'payout' | 'deploy',
+  target: ObjectId,
+  requires_vote: Boolean,
+  voters: [{ 
+    user: ObjectId,
+    vote: 'approve' | 'reject' | 'veto',
+    timestamp: Date
+  }],
+  threshold: Number, // процент для принятия
+  status: 'pending' | 'approved' | 'rejected' | 'vetoed'
+}
+```
+
+**Интеграция с WebSocket:**
+- События голосования транслируются через `WebSocketManager`
+- Использование существующих каналов: `project:{id}`, `task:{id}`
+- Real-time обновления статусов через `globalswebsocket`
+
+### Задачи (расширение governance/tasks)
+
+**Дополнительные поля для проектных задач:**
+```
+task.project: ObjectId // связь с проектом
+task.repository: String // целевой репозиторий
+task.branch: String // целевая ветка
+task.mergeRequests: [ObjectId] // связанные MR
+task.visibility: {
+  type: String, // 'project', 'public', 'custom'
+  allowList: [ObjectId], // для custom
+  denyList: [ObjectId]
+}
+task.budget: {
+  amount: Number,
+  currency: String,
+  approved: Boolean
+}
+task.passed: Boolean // флаг приёмки
+```
+
+### События и уведомления
+
+**Использование notifications модуля:**
+- Подключение к `modules/notifications/` для email/push уведомлений
+- События проекта регистрируются через Observer pattern
+- Логирование через `globals.logger` с категорией 'project'
+
+**WebSocket события:**
+```javascript
+// Используя WebSocketManager из globals
+wss.broadcast(`project:${projectId}`, {
+  event: 'task.updated',
+  data: taskData,
+  permissions: ['project.member'] // фильтрация по правам
+});
+```
+
+### Инварианты и валидация
+
+- **Owner контроль** — проверка через `organizationHelpers.isOrganizationOwner()` или `membership.projectRole === 'owner'`
+- **Cascade permissions** — права организации наследуются проектом
+- **Atomic operations** — использование транзакций MongoDB для критичных операций
+- **Audit trail** — логирование всех действий через `db.log`
+- **Cache invalidation** — сброс кеша при изменении прав через `Cache` из globals
+
+### Таблица ролей и разрешений
+
+| Действие | Owner | Management | Contributor | Условия |
+|----------|-------|------------|-------------|---------|
+| Создание проекта | ✓ | ✗ | ✗ | Требует прав в организации |
+| Управление участниками | ✓ | ✗ | ✗ | - |
+| Создание задач | ✓ | ✓ | ✓ | - |
+| Создание MR | ✓ | ✓ | ✓ | Доступ к задаче |
+| Merge в main | ✓ | ✓* | ✗ | *При permissions.merge |
+| Назначение бюджета | ✓ | ✓* | ✗ | *При permissions.budget |
+| Инициация выплат | ✓ | ✓* | ✗ | *При permissions.budget |
+| Deploy | ✓ | ✓* | ✗ | *При permissions.deploy |
+| Наложение вето | ✓ | ✓* | ✗ | *При permissions.veto |
+| Снятие вето | ✓ | ✗ | ✗ | Только owner |
+| Удаление проекта | ✓ | ✗ | ✗ | - |
+
+### Интеграция с существующими модулями
+
+- **auth** — использование `auth.state.user` для текущего пользователя
+- **wallet** — интеграция для выплат через внутренние кошельки
+- **notifications** — уведомления о событиях проекта
+- **globals/cache** — кеширование прав доступа
+- **globals/logger** — аудит всех действий
+- **organizations** — наследование структуры и прав
+
+Этот подход максимально использует существующую инфраструктуру Martyrs, минимизируя дублирование кода и обеспечивая консистентность с остальной системой.

package/src/modules/governance/controllers/routes/initiatives.routes.js

@@ -1,11 +1,106 @@
-import initiativeFactory from '../factories/initiatives.controller.js';
-export default (function (app, db, origins, publicPath) {
-  const controller = initiativeFactory(db);
-  app.get('/api/initiatives', controller.getAllInitiatives);
-  app.get('/api/initiatives/:id', controller.getInitiativeById);
-  app.post('/api/initiatives', controller.createInitiative);
-  app.put('/api/initiatives/:id', controller.updateInitiative);
-  app.delete('/api/initiatives/:id', controller.deleteInitiative);
-  app.post('/api/initiatives/:id/approve', controller.approveInitiative);
-  app.post('/api/initiatives/:id/reject', controller.rejectInitiative);
-});
+import CRUD from '@martyrs/src/modules/globals/controllers/classes/crud/crud.js';
+import ABAC from '@martyrs/src/modules/globals/controllers/classes/abac/abac.js';
+import initiativesVerifierFactory from '../../middlewares/initiatives.verifier.js';
+
+const { getInstance } = ABAC;
+
+export default function (app, db) {
+  const abac = getInstance(db);
+  const verifier = initiativesVerifierFactory(db);
+
+  // Основной CRUD для initiatives
+  const initiativesCRUD = new CRUD({
+    app,
+    db,
+    model: db.initiative,
+    modelName: 'initiative',
+    basePath: '/api/initiatives',
+
+    auth: { read: false },
+
+    verifiers: {
+      create: verifier.createVerifier,
+      read: verifier.readVerifier,
+      update: verifier.updateVerifier,
+      delete: verifier.deleteVerifier
+    },
+
+    abac: abac,
+
+    policies: {
+      read: { enabled: false }
+    },
+
+    cache: {
+      enabled: true,
+      ttl: 300,
+      tags: ['initiatives', 'governance']
+    },
+
+    events: {
+      enabled: true,
+      logReads: false
+    }
+  });
+
+  // Кастомные роуты через addAction
+
+  // Get initiative milestones - /api/initiatives/:id/milestones
+  initiativesCRUD.addAction('milestones', {
+    method: 'get',
+    path: '/:id/milestones',
+    auth: false,
+    abac: { enabled: false },
+    handler: async (req, res) => {
+      try {
+        const milestones = await db.milestone.find({
+          initiative: req.params.id
+        }).populate('owner contributors');
+        res.json(milestones);
+      } catch (error) {
+        console.error(error);
+        res.status(500).json({ error: error.message });
+      }
+    }
+  });
+
+  // Propose task for initiative - /api/initiatives/:id/propose-task
+  initiativesCRUD.addAction('propose-task', {
+    method: 'post',
+    path: '/:id/propose-task',
+    auth: true,
+    handler: async (req, res) => {
+      try {
+        const { title, description, milestone, dueDate } = req.body;
+
+        // Создаём голосование для создания задачи
+        const voting = await db.voting.create({
+          type: 'create_task',
+          targetModel: 'Task',
+          title: `Create task: ${title}`,
+          description: `Proposal to create task: ${description}`,
+          initiative: req.params.id,
+          milestone: milestone,
+          threshold: 51,
+          participants: [],
+          metadata: {
+            taskData: {
+              title,
+              description,
+              milestone,
+              dueDate,
+              initiative: req.params.id
+            }
+          }
+        });
+
+        res.status(201).json(voting);
+      } catch (error) {
+        console.error(error);
+        res.status(500).json({ error: error.message });
+      }
+    }
+  });
+
+  return initiativesCRUD;
+}

package/src/modules/governance/controllers/routes/milestones.routes.js

@@ -0,0 +1,111 @@
+import CRUD from '@martyrs/src/modules/globals/controllers/classes/crud/crud.js';
+import ABAC from '@martyrs/src/modules/globals/controllers/classes/abac/abac.js';
+import milestonesVerifierFactory from '../../middlewares/milestones.verifier.js';
+
+const { getInstance } = ABAC;
+
+export default function (app, db) {
+  const abac = getInstance(db);
+  const verifier = milestonesVerifierFactory(db);
+
+  // Основной CRUD для milestones
+  const milestonesCRUD = new CRUD({
+    app,
+    db,
+    model: db.milestone,
+    modelName: 'milestone',
+    basePath: '/api/milestones',
+
+    auth: { read: false },
+
+    verifiers: {
+      create: verifier.createVerifier,
+      read: verifier.readVerifier,
+      update: verifier.updateVerifier,
+      delete: verifier.deleteVerifier
+    },
+
+    abac: abac,
+
+    policies: {
+      read: { enabled: false }
+    },
+
+    cache: {
+      enabled: true,
+      ttl: 300,
+      tags: ['milestones', 'governance']
+    },
+
+    events: {
+      enabled: true,
+      logReads: false
+    }
+  });
+
+  // Кастомные роуты через addAction
+
+  // Get milestone tasks - /api/milestones/:id/tasks
+  milestonesCRUD.addAction('tasks', {
+    method: 'get',
+    path: '/:id/tasks',
+    auth: false,
+    abac: { enabled: false },
+    handler: async (req, res) => {
+      try {
+        const tasks = await db.task.find({
+          milestone: req.params.id
+        }).populate('assignedTo');
+        res.json(tasks);
+      } catch (error) {
+        console.error(error);
+        res.status(500).json({ error: error.message });
+      }
+    }
+  });
+
+  // Propose task for milestone - /api/milestones/:id/propose-task
+  milestonesCRUD.addAction('propose-task', {
+    method: 'post',
+    path: '/:id/propose-task',
+    auth: true,
+    handler: async (req, res) => {
+      try {
+        const milestone = await db.milestone.findById(req.params.id);
+        if (!milestone) {
+          return res.status(404).json({ error: 'Milestone not found' });
+        }
+
+        const { title, description, dueDate } = req.body;
+
+        // Создаём голосование для создания задачи
+        const voting = await db.voting.create({
+          type: 'create_task',
+          targetModel: 'Task',
+          title: `Create task: ${title}`,
+          description: `Proposal to create task in milestone "${milestone.name}": ${description}`,
+          initiative: milestone.initiative,
+          milestone: req.params.id,
+          threshold: 51,
+          participants: [],
+          metadata: {
+            taskData: {
+              title,
+              description,
+              milestone: req.params.id,
+              initiative: milestone.initiative,
+              dueDate
+            }
+          }
+        });
+
+        res.status(201).json(voting);
+      } catch (error) {
+        console.error(error);
+        res.status(500).json({ error: error.message });
+      }
+    }
+  });
+
+  return milestonesCRUD;
+}

package/src/modules/governance/controllers/routes/tasks.routes.js

@@ -1,11 +1,164 @@
-import taskFactory from '../factories/tasks.controller.js';
-export default (function (app, db, origins, publicPath) {
-  const controller = taskFactory(db);
-  app.get('/api/tasks', controller.getAllTasks);
-  app.get('/api/tasks/:id', controller.getTaskById);
-  app.post('/api/tasks', controller.createTask);
-  app.put('/api/tasks/:id', controller.updateTask);
-  app.delete('/api/tasks/:id', controller.deleteTask);
-  app.post('/api/tasks/:id/assign', controller.assignTask);
-  app.post('/api/tasks/:id/complete', controller.completeTask);
-});
+import CRUD from '@martyrs/src/modules/globals/controllers/classes/crud/crud.js';
+import ABAC from '@martyrs/src/modules/globals/controllers/classes/abac/abac.js';
+import tasksVerifierFactory from '../../middlewares/tasks.verifier.js';
+
+const { getInstance } = ABAC;
+
+export default function (app, db) {
+  const abac = getInstance(db);
+  const verifier = tasksVerifierFactory(db);
+
+  // Основной CRUD для tasks
+  const tasksCRUD = new CRUD({
+    app,
+    db,
+    model: db.task,
+    modelName: 'task',
+    basePath: '/api/tasks',
+
+    auth: { read: false },
+
+    verifiers: {
+      create: verifier.createVerifier,
+      read: verifier.readVerifier,
+      update: verifier.updateVerifier,
+      delete: verifier.deleteVerifier
+    },
+
+    abac: abac,
+
+    policies: {
+      read: { enabled: false }
+    },
+
+    cache: {
+      enabled: true,
+      ttl: 300,
+      tags: ['tasks', 'governance']
+    },
+
+    events: {
+      enabled: true,
+      logReads: false
+    }
+  });
+
+  // Кастомные действия через addAction
+
+  // Assign task - /api/tasks/:id/assign
+  tasksCRUD.addAction('assign', {
+    method: 'post',
+    path: '/:id/assign',
+    auth: true,
+    handler: async (req, res) => {
+      try {
+        const task = await db.task.findById(req.params.id);
+        if (!task) {
+          return res.status(404).json({ error: 'Task not found' });
+        }
+
+        const { userId } = req.body;
+        const user = await db.user.findById(userId);
+        if (!user) {
+          return res.status(404).json({ error: 'User not found' });
+        }
+
+        task.assignedTo = userId;
+        task.status = 'in_progress';
+        await task.save();
+
+        res.json({ message: 'Task assigned successfully', task });
+      } catch (error) {
+        console.error(error);
+        res.status(500).json({ error: error.message });
+      }
+    }
+  });
+
+  // Submit for review - /api/tasks/:id/submit-for-review
+  tasksCRUD.addAction('submit-for-review', {
+    method: 'post',
+    path: '/:id/submit-for-review',
+    auth: true,
+    handler: async (req, res) => {
+      try {
+        const task = await db.task.findById(req.params.id)
+          .populate('assignedTo')
+          .populate('milestone');
+
+        if (!task) {
+          return res.status(404).json({ error: 'Task not found' });
+        }
+
+        if (task.status !== 'in_progress') {
+          return res.status(400).json({ error: 'Task must be in progress to submit for review' });
+        }
+
+        // Создаём голосование для приёмки задачи
+        const voting = await db.voting.create({
+          type: 'approve_task',
+          targetModel: 'Task',
+          targetId: task._id,
+          title: `Approve completion of task: ${task.title}`,
+          description: `Review and approve the completion of task "${task.title}"`,
+          initiative: task.initiative,
+          milestone: task.milestone,
+          threshold: 51,
+          participants: [],
+          metadata: {
+            taskId: task._id,
+            completedBy: task.assignedTo
+          }
+        });
+
+        task.status = 'review';
+        task.completionVoting = voting._id;
+        await task.save();
+
+        res.json({ message: 'Task submitted for review', task, voting });
+      } catch (error) {
+        console.error(error);
+        res.status(500).json({ error: error.message });
+      }
+    }
+  });
+
+  // Complete task - /api/tasks/:id/complete
+  tasksCRUD.addAction('complete', {
+    method: 'post',
+    path: '/:id/complete',
+    auth: true,
+    handler: async (req, res) => {
+      try {
+        const task = await db.task.findById(req.params.id);
+
+        if (!task) {
+          return res.status(404).json({ error: 'Task not found' });
+        }
+
+        if (task.status !== 'review') {
+          return res.status(400).json({ error: 'Task must be in review to complete' });
+        }
+
+        // Проверяем результат голосования если есть
+        if (task.completionVoting) {
+          const voting = await db.voting.findById(task.completionVoting);
+          if (voting && voting.result !== 'approved') {
+            return res.status(400).json({ error: 'Task completion not approved by voting' });
+          }
+        }
+
+        task.status = 'completed';
+        task.completedDate = new Date();
+        await task.save();
+
+        res.json({ message: 'Task completed successfully', task });
+      } catch (error) {
+        console.error(error);
+        res.status(500).json({ error: error.message });
+      }
+    }
+  });
+
+  return tasksCRUD;
+}

package/src/modules/governance/controllers/routes/votes.routes.js

@@ -1,9 +1,50 @@
-import voteFactory from '../factories/votes.controller.js';
-export default (function (app, db, origins, publicPath) {
-  const controller = voteFactory(db);
-  app.post('/api/votings/:votingId/vote', controller.castVote);
-  app.get('/api/votings/:votingId/votes', controller.getVotesForVoting);
-  app.get('/api/users/:userId/votes', controller.getUserVotes);
-  app.put('/api/votes/:id', controller.updateVote);
-  app.delete('/api/votes/:id', controller.deleteVote);
-});
+import CRUD from '@martyrs/src/modules/globals/controllers/classes/crud/crud.js';
+import ABAC from '@martyrs/src/modules/globals/controllers/classes/abac/abac.js';
+import votesVerifierFactory from '../../middlewares/votes.verifier.js';
+
+const { getInstance } = ABAC;
+
+export default function (app, db) {
+  const abac = getInstance(db);
+  const verifier = votesVerifierFactory(db);
+
+  // Основной CRUD для votes
+  const votesCRUD = new CRUD({
+    app,
+    db,
+    model: db.vote,
+    modelName: 'vote',
+    basePath: '/api/votes',
+
+    auth: {
+      read: false,
+      create: true  // Votes are typically created via /api/votings/:id/vote
+    },
+
+    verifiers: {
+      create: verifier.createVerifier,
+      read: verifier.readVerifier,
+      update: verifier.updateVerifier,
+      delete: verifier.deleteVerifier
+    },
+
+    abac: abac,
+
+    policies: {
+      read: { enabled: false }
+    },
+
+    cache: {
+      enabled: true,
+      ttl: 60,
+      tags: ['votes', 'governance']
+    },
+
+    events: {
+      enabled: true,
+      logReads: false
+    }
+  });
+
+  return votesCRUD;
+}