tickets

5.0 KB

1. // lib/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. // The one file that writes the tables of other topics (projects, members, tickets, events) directly: a data migration.
15. import { now } from 'hl:time'
16. import { merged, countOf } from './util.hl'
17. import { ensureCreatorUser, userRecord } from './users.hl'
18. import { projectsTable, membersTable, addMember, projectRecord, projectBySlug, projectRecords, adminCount } from './projects.hl'
19. import { stateOf } from './tickets-helpers.hl'
20. import { eventsTable } from './events.hl'
21. import { ticketsTable } from './tickets.hl'
23. static botNames = ['Architect' 'AntColonyScheduler']
25. static migrateProjects = (&log) => {
26. let all = projectsTable.find(null, null)
27. if (countOf(all) == 0) { return 0 }
28. let n = 0
29. for (p of all) {
30. if (p.slug == null) {
31. projectsTable.update(p.id, { id = p.id title = p.name slug = p.name description = '' oldSlugs = '' created = p.created })
32. n = n + 1
33. }
34. }
35. if (n > 0) { log.push(n + ' project(s) turned into records') }
36. return n
37. }
39. static createdByOf = (t) => {
40. let all = eventsTable.find('ticket', t.id)
41. if (countOf(all) == 0) { return '' }
42. for (e of all) { if (e.kind == 'created' && e.user != null) { return e.user } }
43. return ''
44. }
46. static migrateTickets = (&log, creator) => {
47. let all = ticketsTable.find(null, null)
48. if (countOf(all) == 0) { return 0 }
49. let n = 0
50. for (t of all) {
51. if (projectRecord(t.project) == null) {
52. let p = projectBySlug(t.project)
53. if (p == null) {
54. let pid = projectsTable.put({ title = t.project slug = t.project description = '' oldSlugs = '' created = now() })
55. p = projectRecord(pid)
56. }
57. let s = stateOf(t.state)
58. if (t.state == 'awaiting creator' && t.subject != null && t.subject.startsWith('Question')) { s = 'pending' }
59. if (s == null) { s = 'open' }
60. let who = ''
61. if ((s == 'review' || s == 'pending') && creator != null) { who = creator.id }
62. ticketsTable.update(t.id, merged(t, { project = p.id path = p.id + '/' + t.number state = s createdBy = createdByOf(t) assignee = who }))
63. n = n + 1
64. }
65. }
66. if (n > 0) { log.push(n + ' ticket(s) linked to their project by id, states renamed') }
67. return n
68. }
70. static migrateEvents = (&log) => {
71. let all = eventsTable.find(null, null)
72. if (countOf(all) == 0) { return 0 }
73. let n = 0
74. for (e of all) {
75. if (e.kind == 'state') {
76. let a = stateOf(e.from)
77. let b = stateOf(e.to)
78. let nf = a != null ? a : e.from
79. let nt = b != null ? b : e.to
80. if (nf != e.from || nt != e.to) {
81. eventsTable.update(e.id, merged(e, { from = nf to = nt }))
82. n = n + 1
83. }
84. }
85. }
86. if (n > 0) { log.push(n + ' state event(s) renamed') }
87. return n
88. }
90. static migrateMembers = (&log, creator) => {
91. let n = 0
92. for (p of projectRecords()) {
93. if (countOf(membersTable.find('project', p.id)) == 0) {
94. // who wrote in the project: users @id → true
95. let wrote = {}
96. let order = []
97. let tickets = ticketsTable.find('project', p.id)
98. if (countOf(tickets) > 0) {
99. for (t of tickets) {
100. let evs = eventsTable.find('ticket', t.id)
101. if (countOf(evs) > 0) {
102. for (e of evs) {
103. if (e.user != null && e.user != '' && wrote[e.user] != true) {
104. wrote[e.user] = true
105. order.push(e.user)
106. }
107. }
108. }
109. }
110. }
111. for (uid of order) {
112. let u = userRecord(uid)
113. if (u != null) { addMember(p.id, uid, botNames.includes(u.name) ? 'edit' : 'use') }
114. }
115. n = n + 1
116. }
117. if (creator != null && adminCount(p.id) == 0) {
118. addMember(p.id, creator.id, 'admin')
119. n = n + 1
120. }
121. }
122. if (n > 0) { log.push('members set up in ' + n + ' project(s)') }
123. return n
124. }
126. // answers the lines describing what changed (an empty list = nothing to do)
127. static migrateAll = () => {
128. let log = []
129. let creator = ensureCreatorUser()
130. migrateProjects(log)
131. migrateTickets(log, creator)
132. migrateEvents(log)
133. migrateMembers(log, creator)
134. return log
135. }