tickets

4.0 KB

1. // lib/tickets-helpers.hl — what tickets.hl, events.hl and the pages look up about tickets: the state names, the
2. // small shapes a page shows (a related ticket's ref, the relation view, the list's filter links). Statics only;
3. // the central logic (who may do what, the writes) is lib/tickets.hl.
4. import { ticketHref, ticketApiHref } from './util.hl'
5. import { projectSlugOf, projectRecords } from './projects.hl'
7. // THE STATES, in the order a ticket usually walks them; the state's name is also its URL form.
8. // The OLD names are still accepted (the scheduler and the tools use them): stateOf() maps them.
9. static states = ['open' 'progress' 'pending' 'review' 'reopened' 'done' 'canceled']
10. static stateAliases = { 'in progress' = 'progress' 'awaiting creator' = 'review' 'confirmed' = 'done' 'rejected' = 'reopened' 'on hold' = 'pending' }
11. // the states a person moves a ticket to: the inbox ones
12. static inboxStates = ['pending' 'review']
14. // the state a name stands for (a new name, an old one, or its URL form with '-' / '+'), or null
15. static stateOf = (name) => {
16. if (name == null || hlTypeName(name) != 'String') { return null }
17. let s = name.replaceAll('-', ' ').replaceAll('+', ' ').trim().toLowerCase()
18. if (states.includes(s)) { return s }
19. let a = stateAliases[s]
20. return a != null ? a : null
21. }
22. static slugOf = (state) => { return state == null ? '' : state.replaceAll(' ', '-') }
23. static stateOfSlug = (slug) => { return stateOf(slug) }
25. // ---- relations, as a page shows them (ticket #4) ------------------------------------------------
26. // what a relation shows of a ticket (no relations of its own — no recursion)
27. static refOf = (t) => {
28. let slug = slugOf(t.state)
29. let pslug = projectSlugOf(t)
30. let href = ticketHref(pslug, t.number)
31. let apiHref = ticketApiHref(pslug, t.number)
32. let key = pslug + '#' + t.number
33. return { id = t.id project = pslug number = t.number ref = '#' + t.number key = key subject = t.subject state = t.state stateSlug = slug href = href apiHref = apiHref }
34. }
35. static keyOf = (t) => { return projectSlugOf(t) + '#' + t.number }
37. // what the ticket PAGE shows of a row's relations (SSR members and the `ticketsRelated` push)
38. static noRef = { id = '' project = '' number = 0 ref = '' key = '' subject = '' state = '' stateSlug = '' href = '/' apiHref = '' }
39. static relationViewOf = (row) => {
40. let total = row.children.length
41. let done = 0
42. for (c of row.children) { if (c.state == 'done') { done = done + 1 } }
43. let note = ''
44. if (total > 0) { note = done == total ? 'all children done (' + total + ')' : done + ' of ' + total + ' children done' }
45. let hasParent = row.parent != null
46. let hasChildren = total > 0
47. let hasBlockedBy = row.blockedBy.length > 0
48. let hasBlocks = row.blocks.length > 0
49. return { id = row.id parent = hasParent ? row.parent : noRef hasParent = hasParent children = row.children hasChildren = hasChildren
50. childNote = note childClass = row.allChildrenConfirmed ? 'done' : '' allChildrenConfirmed = row.allChildrenConfirmed
51. blockedBy = row.blockedBy hasBlockedBy = hasBlockedBy blocks = row.blocks hasBlocks = hasBlocks
52. hasRelations = hasParent || hasChildren || hasBlockedBy || hasBlocks }
53. }
55. // ---- the list page's filter links -------------------------------------------------------------
56. // [{ label, href, cls }] — `cls` is 'selected' on the one in effect. The href keeps the OTHER filter.
57. static projectLinks = (project, state) => {
58. let tail = state != null ? '/state/' + slugOf(state) : ''
59. let out = [{ label = 'all projects' href = state != null ? tail : '/' cls = project == null ? 'selected' : '' }]
60. for (p of projectRecords()) {
61. out.push({ label = p.title href = '/project/' + p.slug + tail cls = p.slug == project ? 'selected' : '' })
62. }
63. return out
64. }
66. static stateLinks = (project, state) => {
67. let head = project != null ? '/project/' + project : ''
68. let out = [{ label = 'all states' href = project != null ? head : '/' cls = state == null ? 'selected' : '' }]
69. for (s of states) {
70. out.push({ label = s href = head + '/state/' + slugOf(s) cls = s == state ? 'selected ' + slugOf(s) : slugOf(s) })
71. }
72. return out
73. }