// // Copyright © 2023 Hardcore Engineering Inc. // // Licensed under the Eclipse Public License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. You may // obtain a copy of the License at https://www.eclipse.org/legal/epl-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // // See the License for the specific language governing permissions and // limitations under the License. // import contact, { Employee, Person, PersonAccount } from '@hcengineering/contact' import core, { AttachedData, Class, Data, Doc, DocumentUpdate, Ref, SortingOrder, Status, Tx, TxCUD, TxCreateDoc, TxFactory, TxProcessor, TxUpdateDoc, toIdMap } from '@hcengineering/core' import notification, { CommonInboxNotification } from '@hcengineering/notification' import { getResource } from '@hcengineering/platform' import type { TriggerControl } from '@hcengineering/server-core' import { ReceiverInfo, SenderInfo } from '@hcengineering/server-notification' import { getCommonNotificationTxes, getNotificationContent, getNotificationProviderControl, isShouldNotifyTx } from '@hcengineering/server-notification-resources' import serverTime, { OnToDo, ToDoFactory } from '@hcengineering/server-time' import task, { makeRank } from '@hcengineering/task' import { jsonToMarkup, nodeDoc, nodeParagraph, nodeText } from '@hcengineering/text' import time, { ProjectToDo, ToDo, ToDoPriority, TodoAutomationHelper, WorkSlot } from '@hcengineering/time' import tracker, { Issue, IssueStatus, Project, TimeSpendReport } from '@hcengineering/tracker' /** * @public */ export async function OnTask (tx: Tx, control: TriggerControl): Promise { const actualTx = TxProcessor.extractTx(tx) as TxCUD const mixin = control.hierarchy.classHierarchyMixin, ToDoFactory>( actualTx.objectClass, serverTime.mixin.ToDoFactory ) if (mixin !== undefined) { if (actualTx._class !== core.class.TxRemoveDoc) { const factory = await getResource(mixin.factory) return await factory(tx, control) } else { const todos = await control.findAll(time.class.ToDo, { attachedTo: actualTx.objectId }) return todos.map((p) => control.txFactory.createTxRemoveDoc(p._class, p.space, p._id)) } } return [] } export async function OnWorkSlotCreate (tx: Tx, control: TriggerControl): Promise { const actualTx = TxProcessor.extractTx(tx) as TxCUD if (!control.hierarchy.isDerived(actualTx.objectClass, time.class.WorkSlot)) return [] if (!control.hierarchy.isDerived(actualTx._class, core.class.TxCreateDoc)) return [] const workslot = TxProcessor.createDoc2Doc(actualTx as TxCreateDoc) const workslots = await control.findAll(time.class.WorkSlot, { attachedTo: workslot.attachedTo }) if (workslots.length > 1) return [] const todo = (await control.findAll(time.class.ToDo, { _id: workslot.attachedTo }))[0] if (todo === undefined) return [] if (!control.hierarchy.isDerived(todo.attachedToClass, tracker.class.Issue)) return [] const issue = (await control.findAll(tracker.class.Issue, { _id: todo.attachedTo as Ref }))[0] if (issue === undefined) return [] const project = (await control.findAll(task.class.Project, { _id: issue.space }))[0] if (project !== undefined) { const type = (await control.modelDb.findAll(task.class.ProjectType, { _id: project.type }))[0] if (type?.classic) { const taskType = (await control.modelDb.findAll(task.class.TaskType, { _id: issue.kind }))[0] if (taskType !== undefined) { const statuses = await control.modelDb.findAll(core.class.Status, { _id: { $in: taskType.statuses } }) const statusMap = toIdMap(statuses) const typeStatuses = taskType.statuses.map((p) => statusMap.get(p)).filter((p) => p !== undefined) as Status[] const current = statusMap.get(issue.status) if (current === undefined) return [] if (current.category !== task.statusCategory.UnStarted && current.category !== task.statusCategory.ToDo) { return [] } const nextStatus = typeStatuses.find((p) => p.category === task.statusCategory.Active) if (nextStatus !== undefined) { const factory = new TxFactory(control.txFactory.account) const innerTx = factory.createTxUpdateDoc(issue._class, issue.space, issue._id, { status: nextStatus._id }) const outerTx = factory.createTxCollectionCUD( issue.attachedToClass, issue.attachedTo, issue.space, issue.collection, innerTx ) await control.apply([outerTx]) return [] } } } } return [] } export async function OnToDoRemove (tx: Tx, control: TriggerControl): Promise { const actualTx = TxProcessor.extractTx(tx) as TxCUD if (!control.hierarchy.isDerived(actualTx.objectClass, time.class.ToDo)) return [] if (!control.hierarchy.isDerived(actualTx._class, core.class.TxRemoveDoc)) return [] const todo = control.removedMap.get(actualTx.objectId) as ToDo if (todo === undefined) return [] // it was closed, do nothing if (todo.doneOn != null) return [] const todos = await control.findAll(time.class.ToDo, { attachedTo: todo.attachedTo }) if (todos.length > 0) return [] const issue = (await control.findAll(tracker.class.Issue, { _id: todo.attachedTo as Ref }))[0] if (issue === undefined) return [] const project = (await control.findAll(task.class.Project, { _id: issue.space }))[0] if (project !== undefined) { const type = (await control.modelDb.findAll(task.class.ProjectType, { _id: project.type }))[0] if (type !== undefined && type.classic) { const factory = new TxFactory(control.txFactory.account) const taskType = (await control.modelDb.findAll(task.class.TaskType, { _id: issue.kind }))[0] if (taskType !== undefined) { const statuses = await control.modelDb.findAll(core.class.Status, { _id: { $in: taskType.statuses } }) const statusMap = toIdMap(statuses) const typeStatuses = taskType.statuses.map((p) => statusMap.get(p)).filter((p) => p !== undefined) as Status[] const current = statusMap.get(issue.status) if (current === undefined) return [] if (current.category !== task.statusCategory.Active && current.category !== task.statusCategory.ToDo) return [] const nextStatus = typeStatuses.find((p) => p.category === task.statusCategory.UnStarted) if (nextStatus !== undefined) { const innerTx = factory.createTxUpdateDoc(issue._class, issue.space, issue._id, { status: nextStatus._id }) const outerTx = factory.createTxCollectionCUD( issue.attachedToClass, issue.attachedTo, issue.space, issue.collection, innerTx ) await control.apply([outerTx]) return [] } } } } return [] } export async function OnToDoCreate (tx: TxCUD, control: TriggerControl): Promise { const hierarchy = control.hierarchy const createTx = TxProcessor.extractTx(tx) as TxCreateDoc if (!hierarchy.isDerived(createTx.objectClass, time.class.ToDo)) return [] if (!hierarchy.isDerived(createTx._class, core.class.TxCreateDoc)) return [] const mixin = hierarchy.classHierarchyMixin( createTx.objectClass as Ref>, notification.mixin.ClassCollaborators ) if (mixin === undefined) { return [] } const todo = TxProcessor.createDoc2Doc(createTx) const account = control.modelDb.getAccountByPersonId(todo.user) as PersonAccount[] if (account.length === 0) { return [] } const object = (await control.findAll(todo.attachedToClass, { _id: todo.attachedTo }))[0] if (object === undefined) return [] const person = ( await control.findAll(contact.mixin.Employee, { _id: todo.user as Ref, active: true }, { limit: 1 }) )[0] if (person === undefined) return [] const personSpace = (await control.findAll(contact.class.PersonSpace, { person: todo.user }, { limit: 1 }))[0] if (personSpace === undefined) return [] // TODO: Select a proper account const receiverInfo: ReceiverInfo = { _id: account[0]._id, account: account[0], person, space: personSpace._id } const senderAccount = control.modelDb.findAllSync(contact.class.PersonAccount, { _id: tx.modifiedBy as Ref })[0] const senderPerson = senderAccount !== undefined ? (await control.findAll(contact.class.Person, { _id: senderAccount.person }))[0] : undefined const senderInfo: SenderInfo = { _id: tx.modifiedBy, account: senderAccount, person: senderPerson } const notificationControl = await getNotificationProviderControl(control.ctx, control) const notifyResult = await isShouldNotifyTx(control, createTx, tx, todo, account, true, false, notificationControl) const content = await getNotificationContent(tx, account, senderInfo, todo, control) const data: Partial> = { ...content, header: time.string.ToDo, headerIcon: time.icon.Planned, headerObjectId: object._id, headerObjectClass: object._class, messageHtml: jsonToMarkup(nodeDoc(nodeParagraph(nodeText(todo.title)))) } const txes = await getCommonNotificationTxes( control.ctx, control, object, data, receiverInfo, senderInfo, object._id, object._class, object.space, createTx.modifiedOn, notifyResult, notification.class.CommonInboxNotification, tx ) await control.apply(txes) const ids = txes.map((it) => it._id) control.operationContext.derived.targets.notifications = (it) => { if (ids.includes(it._id)) { return [receiverInfo.account.email] } } return [] } /** * @public */ export async function OnToDoUpdate (tx: Tx, control: TriggerControl): Promise { const actualTx = TxProcessor.extractTx(tx) as TxCUD if (!control.hierarchy.isDerived(actualTx.objectClass, time.class.ToDo)) return [] if (!control.hierarchy.isDerived(actualTx._class, core.class.TxUpdateDoc)) return [] const updTx = actualTx as TxUpdateDoc const doneOn = updTx.operations.doneOn const title = updTx.operations.title const description = updTx.operations.description const visibility = updTx.operations.visibility if (doneOn != null) { const events = await control.findAll(time.class.WorkSlot, { attachedTo: updTx.objectId }) const res: Tx[] = [] const resEvents: WorkSlot[] = [] for (const event of events) { if (event.date > doneOn) { const innerTx = control.txFactory.createTxRemoveDoc(event._class, event.space, event._id) const outerTx = control.txFactory.createTxCollectionCUD( event.attachedToClass, event.attachedTo, event.space, event.collection, innerTx ) res.push(outerTx) } else if (event.dueDate > doneOn) { const upd: DocumentUpdate = { dueDate: doneOn } if (title !== undefined) { upd.title = title } if (description !== undefined) { upd.description = description } const innerTx = control.txFactory.createTxUpdateDoc(event._class, event.space, event._id, upd) const outerTx = control.txFactory.createTxCollectionCUD( event.attachedToClass, event.attachedTo, event.space, event.collection, innerTx ) res.push(outerTx) resEvents.push({ ...event, dueDate: doneOn }) } else { resEvents.push(event) } } const todo = (await control.findAll(time.class.ToDo, { _id: updTx.objectId }))[0] if (todo === undefined) return res const funcs = control.hierarchy.classHierarchyMixin, OnToDo>( todo.attachedToClass, serverTime.mixin.OnToDo ) if (funcs !== undefined) { const func = await getResource(funcs.onDone) const todoRes = await func(control, resEvents, todo) await control.apply(todoRes) } return res } if (title !== undefined || description !== undefined || visibility !== undefined) { const events = await control.findAll(time.class.WorkSlot, { attachedTo: updTx.objectId }) const res: Tx[] = [] for (const event of events) { const upd: DocumentUpdate = {} if (title !== undefined) { upd.title = title } if (description !== undefined) { upd.description = description } if (visibility !== undefined) { const newVisibility = visibility === 'public' ? 'public' : 'freeBusy' if (event.visibility !== newVisibility) { upd.visibility = newVisibility } } const innerTx = control.txFactory.createTxUpdateDoc(event._class, event.space, event._id, upd) const outerTx = control.txFactory.createTxCollectionCUD( event.attachedToClass, event.attachedTo, event.space, event.collection, innerTx ) res.push(outerTx) } return res } return [] } /** * @public */ export async function IssueToDoFactory (tx: Tx, control: TriggerControl): Promise { const actualTx = TxProcessor.extractTx(tx) as TxCUD if (!control.hierarchy.isDerived(actualTx.objectClass, tracker.class.Issue)) return [] if (control.hierarchy.isDerived(actualTx._class, core.class.TxCreateDoc)) { const issue = TxProcessor.createDoc2Doc(actualTx as TxCreateDoc) return await createIssueHandler(issue, control) } else if (control.hierarchy.isDerived(actualTx._class, core.class.TxUpdateDoc)) { const updateTx = actualTx as TxUpdateDoc return await updateIssueHandler(updateTx, control) } return [] } /** * @public */ export async function IssueToDoDone (control: TriggerControl, workslots: WorkSlot[], todo: ToDo): Promise { const res: Tx[] = [] let total = 0 for (const workslot of workslots) { total += (workslot.dueDate - workslot.date) / 1000 / 60 } const factory = new TxFactory(control.txFactory.account) const issue = (await control.findAll(todo.attachedToClass, { _id: todo.attachedTo as Ref }))[0] if (issue !== undefined) { const project = (await control.findAll(task.class.Project, { _id: issue.space }))[0] if (project !== undefined) { const type = (await control.modelDb.findAll(task.class.ProjectType, { _id: project.type }))[0] if (type?.classic) { const taskType = (await control.modelDb.findAll(task.class.TaskType, { _id: issue.kind }))[0] if (taskType !== undefined) { const index = taskType.statuses.findIndex((p) => p === issue.status) const helpers = await control.modelDb.findAll(time.class.TodoAutomationHelper, {}) const testers = await Promise.all(helpers.map((it) => getResource(it.onDoneTester))) let allowed = true for (const tester of testers) { if (!(await tester(control, todo))) { allowed = false break } } if (index !== -1 && allowed) { const nextStatus = taskType.statuses[index + 1] if (nextStatus !== undefined) { const currentStatus = taskType.statuses[index] const current = (await control.modelDb.findAll(core.class.Status, { _id: currentStatus }))[0] const next = (await control.modelDb.findAll(core.class.Status, { _id: nextStatus }))[0] if ( current.category !== task.statusCategory.Lost && next.category !== task.statusCategory.Lost && current.category !== task.statusCategory.Won ) { const innerTx = factory.createTxUpdateDoc(issue._class, issue.space, issue._id, { status: nextStatus }) const outerTx = factory.createTxCollectionCUD( issue.attachedToClass, issue.attachedTo, issue.space, issue.collection, innerTx ) res.push(outerTx) } } } } } } if (total > 0) { // round to nearest 15 minutes total = Math.round(total / 15) * 15 const data: AttachedData = { employee: todo.user as Ref, date: new Date().getTime(), value: total / 60, description: '' } const innerTx = factory.createTxCreateDoc( tracker.class.TimeSpendReport, issue.space, data as Data ) const outerTx = factory.createTxCollectionCUD(issue._class, issue._id, issue.space, 'reports', innerTx) res.push(outerTx) } } return res } async function createIssueHandler (issue: Issue, control: TriggerControl): Promise { if (issue.assignee != null) { const project = (await control.findAll(task.class.Project, { _id: issue.space }))[0] if (project === undefined) return [] const type = (await control.modelDb.findAll(task.class.ProjectType, { _id: project.type }))[0] if (!type?.classic) return [] const status = (await control.modelDb.findAll(core.class.Status, { _id: issue.status }))[0] if (status === undefined) return [] if (status.category === task.statusCategory.Active || status.category === task.statusCategory.ToDo) { const tx = await getCreateToDoTx(issue, issue.assignee, control) if (tx !== undefined) { await control.apply([tx]) } } } return [] } async function getIssueToDoData ( issue: Issue, user: Ref, control: TriggerControl ): Promise | undefined> { const acc = control.modelDb.getAccountByPersonId(user) as PersonAccount[] if (acc.length === 0) return const firstTodoItem = ( await control.findAll( time.class.ToDo, { user: { $in: acc.map((it) => it.person) }, doneOn: null }, { limit: 1, sort: { rank: SortingOrder.Ascending } } ) )[0] const rank = makeRank(undefined, firstTodoItem?.rank) const data: AttachedData = { attachedSpace: issue.space, workslots: 0, description: '', priority: ToDoPriority.NoPriority, visibility: 'public', title: issue.title, user, rank } return data } async function getCreateToDoTx (issue: Issue, user: Ref, control: TriggerControl): Promise { const data = await getIssueToDoData(issue, user, control) if (data === undefined) return const innerTx = control.txFactory.createTxCreateDoc( time.class.ProjectToDo, time.space.ToDos, data as Data ) innerTx.space = core.space.Tx const outerTx = control.txFactory.createTxCollectionCUD(issue._class, issue._id, time.space.ToDos, 'todos', innerTx) outerTx.space = core.space.Tx return outerTx } async function changeIssueAssigneeHandler ( control: TriggerControl, newAssignee: Ref, issueId: Ref ): Promise { const issue = (await control.findAll(tracker.class.Issue, { _id: issueId }))[0] if (issue !== undefined) { const status = (await control.modelDb.findAll(core.class.Status, { _id: issue.status }))[0] if (status === undefined) return [] if (status.category === task.statusCategory.Active || status.category === task.statusCategory.ToDo) { const res: Tx[] = [] const todos = await control.findAll(time.class.ToDo, { attachedTo: issue._id }) const now = Date.now() for (const todo of todos) { if (todo.doneOn != null) continue res.push(control.txFactory.createTxUpdateDoc(todo._class, todo.space, todo._id, { doneOn: now })) } const tx = await getCreateToDoTx(issue, newAssignee, control) if (tx !== undefined) { res.push(tx) } return res } } return [] } async function changeIssueStatusHandler ( control: TriggerControl, newStatus: Ref, issueId: Ref ): Promise { const status = (await control.modelDb.findAll(core.class.Status, { _id: newStatus }))[0] if (status === undefined) return [] if (status.category === task.statusCategory.Active || status.category === task.statusCategory.ToDo) { const issue = (await control.findAll(tracker.class.Issue, { _id: issueId }))[0] if (issue?.assignee != null) { const todos = await control.findAll(time.class.ToDo, { attachedTo: issue._id, user: issue.assignee }) if (todos.length === 0) { const tx = await getCreateToDoTx(issue, issue.assignee, control) if (tx !== undefined) { await control.apply([tx]) } } } } return [] } async function changeIssueNumberHandler (control: TriggerControl, issueId: Ref): Promise { const res: Tx[] = [] const issue = (await control.findAll(tracker.class.Issue, { _id: issueId }))[0] if (issue !== undefined) { const todos = await control.findAll(time.class.ToDo, { attachedTo: issue._id }) for (const todo of todos) { const data = await getIssueToDoData(issue, todo.user, control) if (data === undefined) continue const update: DocumentUpdate = {} if (data.title !== todo.title) { update.title = data.title } if (data.description !== todo.description) { update.description = data.description } if (data.attachedSpace !== todo.attachedSpace) { update.attachedSpace = data.attachedSpace } if (Object.keys(update).length > 0) { const innerTx = control.txFactory.createTxUpdateDoc(todo._class, todo.space, todo._id, update) const outerTx = control.txFactory.createTxCollectionCUD( issue._class, issue._id, time.space.ToDos, 'todos', innerTx ) res.push(outerTx) } } } return res } async function updateIssueHandler (tx: TxUpdateDoc, control: TriggerControl): Promise { const res: Tx[] = [] const project = (await control.findAll(task.class.Project, { _id: tx.objectSpace as Ref }))[0] if (project === undefined) return [] const type = (await control.modelDb.findAll(task.class.ProjectType, { _id: project.type }))[0] if (!type?.classic) return [] const newAssignee = tx.operations.assignee if (newAssignee != null) { res.push(...(await changeIssueAssigneeHandler(control, newAssignee, tx.objectId))) } const newStatus = tx.operations.status if (newStatus !== undefined) { res.push(...(await changeIssueStatusHandler(control, newStatus, tx.objectId))) } const number = tx.operations.number if (number !== undefined) { res.push(...(await changeIssueNumberHandler(control, tx.objectId))) } return res } // eslint-disable-next-line @typescript-eslint/explicit-function-return-type export default async () => ({ function: { IssueToDoFactory, IssueToDoDone }, trigger: { OnTask, OnToDoUpdate, OnToDoRemove, OnToDoCreate, OnWorkSlotCreate } })