tickets

4.8 KB

1. // migrate.hl — THE MIGRATION OF TICKET #20 (projects as own data, members, new states). Statics only.
2. // Idempotent: it looks at the SHAPE of the data, so a second run (and every start of the app, project.hl
3. // calls migrateAll) changes nothing. What it does to a store from before:
4. // 1. a project record `{ name, created }` becomes `{ title = name, slug = name, description = '', oldSlugs = '' }`
5. // 2. every ticket points at its project by the project's id (`project`, `path` = '<id>/<number>'), not by name;
6. // `createdBy` = the user of its 'created' event; the state gets its new name (awaiting creator → review,
7. // a "Question…" ticket → pending; confirmed → done, rejected → reopened, in progress → progress, on hold →
8. // pending, anything unknown → open); a ticket in review / pending is ASSIGNED to the creator's user
9. // 3. the state events of the history get the new names too
10. // 4. a project without members gets: the creator (TICKETS_CREATOR_IDENTITY, users.hl) as admin; the users
11. // named Architect and AntColonyScheduler that wrote in it as edit; everybody else who wrote in it as use.
12. // A project with no admin at all gets the creator as admin as soon as the creator is known.
13. // TICKETS_CREATOR_IDENTITY is read ONLY here (the creator-only workflow is gone).
14. import { projectsTable, membersTable, ticketsTable, eventsTable, addMember, projectRecord, projectBySlug, projectRecords, memberRows, adminCount, stateOf, merged, countOf, first, roleOf } from './store.hl'
15. import { ensureCreatorUser, usersTable } from './users.hl'
16. import { now } from 'hl:time'
18. static botNames = ['Architect' 'AntColonyScheduler']
20. static migrateProjects = (log) => {
21. let all = projectsTable.find(null, null)
22. if (countOf(all) == 0) { return 0 }
23. let n = 0
24. for (p of all) {
25. if (p.slug == null) {
26. projectsTable.update(p.id, { id = p.id title = p.name slug = p.name description = '' oldSlugs = '' created = p.created })
27. n = n + 1
28. }
29. }
30. if (n > 0) { log.push(n + ' project(s) turned into records') }
31. return n
32. }
34. static createdByOf = (t) => {
35. let all = eventsTable.find('ticket', t.id)
36. if (countOf(all) == 0) { return '' }
37. for (e of all) { if (e.kind == 'created' && e.user != null) { return e.user } }
38. return ''
39. }
41. static migrateTickets = (log, creator) => {
42. let all = ticketsTable.find(null, null)
43. if (countOf(all) == 0) { return 0 }
44. let n = 0
45. for (t of all) {
46. if (projectRecord(t.project) == null) {
47. let p = projectBySlug(t.project)
48. if (p == null) {
49. let pid = projectsTable.put({ title = t.project slug = t.project description = '' oldSlugs = '' created = now() })
50. p = projectRecord(pid)
51. }
52. let s = stateOf(t.state)
53. if (t.state == 'awaiting creator' && t.subject != null && t.subject.startsWith('Question')) { s = 'pending' }
54. if (s == null) { s = 'open' }
55. let who = ''
56. if ((s == 'review' || s == 'pending') && creator != null) { who = creator.id }
57. ticketsTable.update(t.id, merged(t, { project = p.id path = p.id + '/' + t.number state = s createdBy = createdByOf(t) assignee = who }))
58. n = n + 1
59. }
60. }
61. if (n > 0) { log.push(n + ' ticket(s) linked to their project by id, states renamed') }
62. return n
63. }
65. static migrateEvents = (log) => {
66. let all = eventsTable.find(null, null)
67. if (countOf(all) == 0) { return 0 }
68. let n = 0
69. for (e of all) {
70. if (e.kind == 'state') {
71. let a = stateOf(e.from)
72. let b = stateOf(e.to)
73. let nf = a != null ? a : e.from
74. let nt = b != null ? b : e.to
75. if (nf != e.from || nt != e.to) {
76. eventsTable.update(e.id, merged(e, { from = nf to = nt }))
77. n = n + 1
78. }
79. }
80. }
81. if (n > 0) { log.push(n + ' state event(s) renamed') }
82. return n
83. }
85. static migrateMembers = (log, creator) => {
86. let n = 0
87. for (p of projectRecords()) {
88. if (countOf(membersTable.find('project', p.id)) == 0) {
89. // who wrote in the project: users @id → true
90. let wrote = {}
91. let order = []
92. let tickets = ticketsTable.find('project', p.id)
93. if (countOf(tickets) > 0) {
94. for (t of tickets) {
95. let evs = eventsTable.find('ticket', t.id)
96. if (countOf(evs) > 0) {
97. for (e of evs) {
98. if (e.user != null && e.user != '' && wrote[e.user] != true) {
99. wrote[e.user] = true
100. order.push(e.user)
101. }
102. }
103. }
104. }
105. }
106. for (uid of order) {
107. let u = usersTable.fetch(uid)
108. if (u != null) { addMember(p.id, uid, botNames.includes(u.name) ? 'edit' : 'use') }
109. }
110. n = n + 1
111. }
112. if (creator != null && adminCount(p.id) == 0) {
113. addMember(p.id, creator.id, 'admin')
114. n = n + 1
115. }
116. }
117. if (n > 0) { log.push('members set up in ' + n + ' project(s)') }
118. return n
119. }
121. // answers the lines describing what changed (an empty list = nothing to do)
122. static migrateAll = () => {
123. let log = []
124. let creator = ensureCreatorUser()
125. migrateProjects(log)
126. migrateTickets(log, creator)
127. migrateEvents(log)
128. migrateMembers(log, creator)
129. return log
130. }