platform/plugins/task/src/index.ts

//
// Copyright © 2020, 2021 Anticrm Platform Contributors.
//
// 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 type { Employee } from '@anticrm/contact'
import type { AttachedDoc, Class, Client, Data, Doc, Mixin, Ref, Space, TxOperations } from '@anticrm/core'
import { Arr } from '@anticrm/core'
import type { Asset, Plugin } from '@anticrm/platform'
import { plugin } from '@anticrm/platform'
import type { AnyComponent } from '@anticrm/ui'
import { ViewletDescriptor } from '@anticrm/view'

// S T A T E

/**
 * @public
 */
export interface State extends Doc {
  title: string
  color: string
}

/**
 * @public
 */
export interface DoneState extends Doc {
  title: string
}

/**
 * @public
 */
export interface WonState extends DoneState {}

/**
 * @public
 */
export interface LostState extends DoneState {}

/**
 * @public
 */
export interface Task extends AttachedDoc {
  state: Ref<State>
  doneState: Ref<DoneState> | null
  number: number
  assignee: Ref<Employee> | null
}

/**
 * @public
 */
export interface SpaceWithStates extends Space {
}

/**
 * @public
 */
export interface Project extends SpaceWithStates {}

/**
 * @public
 */
export interface Issue extends Task {
  number: number // Sequence number

  name: string
  description: string

  comments?: number
  attachments?: number
  labels?: string
}

/**
 * @public
 */
export interface KanbanCard extends Class<Doc> {
  card: AnyComponent
}

/**
 * @public
 */
export interface Kanban extends Doc {
  attachedTo: Ref<Space>
  states: Arr<Ref<State>>
  doneStates: Arr<Ref<DoneState>>
  order: Arr<Ref<Doc>>
}

/**
 * @public
 */
export interface Sequence extends Doc {
  attachedTo: Ref<Class<Doc>>
  sequence: number
}

/**
 * @public
 */
export interface StateTemplate extends AttachedDoc, State {}

/**
  * @public
  */
export interface DoneStateTemplate extends AttachedDoc, DoneState {}

/**
  * @public
  */
export interface WonStateTemplate extends DoneStateTemplate, WonState {}

/**
  * @public
  */
export interface LostStateTemplate extends DoneStateTemplate, LostState {}

/**
  * @public
  */
export interface KanbanTemplate extends Doc {
  title: string
  states: Arr<Ref<StateTemplate>>
  doneStates: Arr<Ref<DoneStateTemplate>>
  statesC: number
  doneStatesC: number
}

/**
  * @public
  */
export interface KanbanTemplateSpace extends Space {
  icon: AnyComponent
}

/**
 * @public
 */
export const taskId = 'task' as Plugin

/**
 * @public
 */
const task = plugin(taskId, {
  mixin: {
    KanbanCard: '' as Ref<Mixin<KanbanCard>>
  },
  class: {
    Issue: '' as Ref<Class<Issue>>,
    Project: '' as Ref<Class<Project>>,
    State: '' as Ref<Class<State>>,
    DoneState: '' as Ref<Class<DoneState>>,
    WonState: '' as Ref<Class<WonState>>,
    LostState: '' as Ref<Class<LostState>>,
    SpaceWithStates: '' as Ref<Class<SpaceWithStates>>,
    Task: '' as Ref<Class<Task>>,
    Kanban: '' as Ref<Class<Kanban>>,
    Sequence: '' as Ref<Class<Sequence>>,
    StateTemplate: '' as Ref<Class<StateTemplate>>,
    DoneStateTemplate: '' as Ref<Class<DoneStateTemplate>>,
    WonStateTemplate: '' as Ref<Class<WonStateTemplate>>,
    LostStateTemplate: '' as Ref<Class<LostStateTemplate>>,
    KanbanTemplate: '' as Ref<Class<KanbanTemplate>>,
    KanbanTemplateSpace: '' as Ref<Class<KanbanTemplateSpace>>
  },
  viewlet: {
    Kanban: '' as Ref<ViewletDescriptor>
  },
  icon: {
    Task: '' as Asset,
    Kanban: '' as Asset,
    Status: '' as Asset
  },
  global: {
    // Global task root, if not attached to some other object.
    Task: '' as Ref<Issue>
  },
  space: {
    ProjectTemplates: '' as Ref<KanbanTemplateSpace>,
    Sequence: '' as Ref<Space>
  }
})
export default task

/**
 * @public
 */
export async function createProjectKanban (
  projectId: Ref<Project>,
  factory: <T extends Doc>(_class: Ref<Class<T>>, space: Ref<Space>, data: Data<T>, id: Ref<T>) => Promise<void>
): Promise<void> {
  const states = [
    { color: '#7C6FCD', name: 'Open' },
    { color: '#6F7BC5', name: 'In Progress' },
    { color: '#77C07B', name: 'Under review' },
    { color: '#A5D179', name: 'Done' },
    { color: '#F28469', name: 'Invalid' }
  ]
  const ids: Array<Ref<State>> = []
  for (const st of states) {
    const sid = (projectId + '.state.' + st.name.toLowerCase().replace(' ', '_')) as Ref<State>
    await factory(
      task.class.State,
      projectId,
      {
        title: st.name,
        color: st.color
      },
      sid
    )
    ids.push(sid)
  }

  const rawDoneStates = [
    { class: task.class.WonState, title: 'Won' },
    { class: task.class.LostState, title: 'Lost' }
  ]
  const doneStates: Array<Ref<DoneState>> = []
  for (const st of rawDoneStates) {
    const sid = (projectId + '.done-state.' + st.title.toLowerCase().replace(' ', '_')) as Ref<DoneState>
    await factory(
      st.class,
      projectId,
      {
        title: st.title
      },
      sid
    )
    doneStates.push(sid)
  }

  await factory(
    task.class.Kanban,
    projectId,
    {
      attachedTo: projectId,
      states: ids,
      doneStates,
      order: []
    },
    (projectId + '.kanban') as Ref<Kanban>
  )
}

/**
 * @public
 */
export async function createKanban (client: Client & TxOperations, attachedTo: Ref<Space>, templateId?: Ref<KanbanTemplate>): Promise<Ref<Kanban>> {
  if (templateId === undefined) {
    return await client.createDoc(task.class.Kanban, attachedTo, {
      attachedTo,
      states: [],
      doneStates: await Promise.all([
        client.createDoc(task.class.WonState, attachedTo, {
          title: 'Won'
        }),
        client.createDoc(task.class.LostState, attachedTo, {
          title: 'Lost'
        })
      ]),
      order: []
    })
  }

  const template = await client.findOne(task.class.KanbanTemplate, { _id: templateId })

  if (template === undefined) {
    throw Error(`Failed to find target kanban template: ${templateId}`)
  }

  const tmplStates = await client.findAll(task.class.StateTemplate, { attachedTo: template._id })
  const states = await Promise.all(
    template.states
      .map((id) => tmplStates.find((x) => x._id === id))
      .filter((tstate): tstate is StateTemplate => tstate !== undefined)
      .map(async (state) => await client.createDoc(task.class.State, attachedTo, { color: state.color, title: state.title }))
  )

  const doneClassMap = new Map<Ref<Class<DoneStateTemplate>>, Ref<Class<DoneState>>>([
    [task.class.WonStateTemplate, task.class.WonState],
    [task.class.LostStateTemplate, task.class.LostState]
  ])
  const tmplDoneStates = await client.findAll(task.class.DoneStateTemplate, { attachedTo: template._id })
  const doneStates = (await Promise.all(
    template.doneStates
      .map((id) => tmplDoneStates.find((x) => x._id === id))
      .filter((tstate): tstate is DoneStateTemplate => tstate !== undefined)
      .map(async (state) => {
        const cl = doneClassMap.get(state._class)

        if (cl === undefined) {
          return
        }

        return await client.createDoc(cl, attachedTo, { title: state.title })
      })
  )).filter((x): x is Ref<DoneState> => x !== undefined)

  return await client.createDoc(task.class.Kanban, attachedTo, {
    attachedTo,
    states,
    doneStates,
    order: []
  })
}