Модификация "Голосование" для задачи согласования по регламенту

Задача: коллегиальное принятие решений

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

Требования

— Голосование должно быть доступно на любом этапе согласования.
— Участники голосуют по каждому решению: «За», «Против», «Воздержался».
— Нельзя выбрать несколько вариантов.
— Результаты агрегируются в протоколе.
— Голосование — опциональная функция, активируемая при необходимости.

Реализация: ключевые компоненты

— Настройка вида документа "Протокол совещания"

— Создание справочника "Матрицы согласования"

— Доработка задачи согласования

— Асинхронный обработчик результатов

— Роль согласования "Участники голосования"

— Добавление признака "Требуется голосование"

В перекрытый справочник DocumentKind добавляем логическое свойство:

/// <summary>

/// Требуется голосование.

/// </summary>

public virtual bool? NeedVoting { get; set; }

На событии Showing формы — показываем только для вида "Протокол совещания":

public override void Showing(Sungero.Presentation.FormShowingEventArgs e)

{

base.Showing(e);

var isMinutes = _obj.DocumentType?.DocumentTypeGuid == Constants.MeetingMinutesTypeGuid;

_obj.State.Properties.NeedVoting.IsVisible = isMinutes;

}

Коллекция решений в протоколе

В карточку Minutes добавляем коллекцию Decisions, где каждое решение содержит:

— Текст решения
— Матрицу голосующих
— Счётчики голосов
— Результат

public virtual void DecisionsAdded(Sungero.Domain.Shared.CollectionPropertyAddedEventArgs e)

{

var added = e.Added as IMinuteDecision;

added.Number = (_obj.Decisions.Max(d => d.Number) ?? 0) + 1;

added.Result = Resources.NoResults;

}

Кастомный тип этапа "Голосование"

/// <summary>

/// Тип этапа.

/// </summary>

public virtual CustomStageType? CustomStageType { get; set; }

Фильтруем отображение — "Голосование" доступно только для этапов типа "Задание":

public virtual IEnumerable<Enumeration> CustomStageTypeFiltering(IEnumerable<Enumeration> query)

{

if (_obj.StageType != StageType.SimpleAgr || _obj.AllowSendToRework == true)

query = query.Where(q => !Equals(q, CustomStageType.Voting));

return query;

}

Коллекция голосов в задании

В перекрытое задание ApprovalSimpleAssignment добавляем коллекцию Voting, содержащую:
— Decision — текст
— VoteFor, VoteAgainst, VoteAbstain — выбор

Обеспечиваем взаоисключающий выбор:

public virtual void VotingVoteAgainstValueInput(Sungero.Presentation.BooleanValueInputEventArgs e)

{

if (e.NewValue == true)

{

_obj.VoteFor = false;

_obj.VoteAbstain = false;

}

}

public virtual void VotingVoteForValueInput(Sungero.Presentation.BooleanValueInputEventArgs e)

{

if (e.NewValue == true)

{

_obj.VoteAgainst = false;

_obj.VoteAbstain = false;

}

}

Проверка голосования перед завершением задания

На событии BeforeComplete убеждаемся, что по всем решениям проголосовано:

public override void BeforeComplete(Sungero.Workflow.Server.BeforeCompleteEventArgs e)

{

base.BeforeComplete(e);

if (_obj.CustomStageType != CustomStageType.Voting)

return;

var emptyVotes = _obj.Voting.Where(v => !v.VoteFor && !v.VoteAgainst && !v.VoteAbstain);

if (emptyVotes.Any())

{

e.AddError("Проголосуйте по всем решениям.");

return;

}

}

Асинхронный обработчик результатов

После завершения задания — агрегируем голоса в протоколе:

public void AddVotingResults(long assignmentId, long minutesId)

{

var assignment = ApprovalSimpleAssignment.GetAll().Where(a => a.Id == assignmentId).FirstOrDefault();

var minutes = Minutes.GetAll().Where(m => m.Id == minutesId).FirstOrDefault();

if (assignment == null || minutes == null) return;

foreach (var vote in assignment.Voting)

{

var decision = minutes.Decisions.FirstOrDefault(d => d.Id == vote.MinutedDecisionId);

if (decision != null)

{

if (vote.VoteFor) decision.VoteFor = (decision.VoteFor ?? 0) + 1;

if (vote.VoteAgainst) decision.VoteAgainst = (decision.VoteAgainst ?? 0) + 1;

if (vote.VoteAbstain) decision.VoteAbstain = (decision.VoteAbstain ?? 0) + 1;

decision.Result = $"За: {decision.VoteFor}, Против: {decision.VoteAgainst}, Воздержались: {decision.VoteAbstain}";

}

}

minutes.Save();

}

Роль согласования "Участники голосования"

Ограничиваем доступ роли только для протоколов:

public override List<IDocumentKind> Filter(List<IDocumentKind> kinds)

{

var query = base.Filter(kinds);

if (_obj.Type == RoleType.MinutesVoters)

query = query.Where(k => k.DocumentType.DocumentTypeGuid == Constants.MeetingMinutesTypeGuid);

return query.ToList();

}

Итог

Модификация позволяет:

— Голосовать прямо в задаче согласования.
— Сохранять результаты в протоколе.
— Гибко настраивать состав голосующих.
— Интегрировать в любые бизнес-процессы.

Решение реализовано через low-code подход, без изменения стандартных механизмов Directum RX, что упрощает сопровождение и обновление.