feat: Add table for saving user-performed change events

Add table for storing events regarding items such as resolutions.

Signed-off-by: Johanna Lamppu <[email protected]>

Author: lamppu

dao/src/main/kotlin/tables/ChangeLogTable.kt

@@ -0,0 +1,74 @@
+/*
+ * Copyright (C) 2025 The ORT Server Authors (See <https://github.com/eclipse-apoapsis/ort-server/blob/main/NOTICE>)
+ *
+ * Licensed under the Apache 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.apache.org/licenses/LICENSE-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.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * License-Filename: LICENSE
+ */
+
+package org.eclipse.apoapsis.ortserver.dao.tables
+
+import org.eclipse.apoapsis.ortserver.dao.repositories.userDisplayName.UserDisplayNameDao
+import org.eclipse.apoapsis.ortserver.model.ChangeEvent
+import org.eclipse.apoapsis.ortserver.model.ChangeEventAction
+import org.eclipse.apoapsis.ortserver.model.ChangeEventEntityType
+import org.eclipse.apoapsis.ortserver.model.UserDisplayName
+
+import org.jetbrains.exposed.sql.SortOrder
+import org.jetbrains.exposed.sql.Table
+import org.jetbrains.exposed.sql.and
+import org.jetbrains.exposed.sql.insert
+import org.jetbrains.exposed.sql.kotlin.datetime.timestamp
+
+/*
+ * A table to store change log entries representing user-performed change events.
+ */
+object ChangeLogTable : Table("change_log") {
+    val entityType = text("entity_type")
+    val entityId = text("entity_id")
+    val userId = text("user_id")
+    val occurredAt = timestamp("occurred_at")
+    val action = text("action")
+
+    fun insert(
+        entityTypeInput: ChangeEventEntityType,
+        entityIdInput: String,
+        userIdInput: String,
+        actionInput: ChangeEventAction
+    ) {
+        insert {
+            it[entityType] = entityTypeInput.name
+            it[entityId] = entityIdInput
+            it[userId] = userIdInput
+            it[action] = actionInput.name
+        }
+    }
+
+    fun getAllByEntityTypeAndId(
+        entityTypeSearch: ChangeEventEntityType,
+        entityIdSearch: String
+    ): List<ChangeEvent> {
+        return select(columns)
+            .where { (entityType eq entityTypeSearch.name) and (entityId eq entityIdSearch) }
+            .orderBy(occurredAt, SortOrder.ASC)
+            .map { row ->
+                ChangeEvent(
+                    user = UserDisplayNameDao.findById(row[userId])?.mapToModel()
+                        ?: UserDisplayName(row[userId], "Unknown"),
+                    occurredAt = row[occurredAt],
+                    action = ChangeEventAction.valueOf(row[action])
+                )
+            }
+    }
+}

dao/src/main/resources/db/migration/V121__addChangeLogTable.sql

@@ -0,0 +1,11 @@
+CREATE TABLE change_log (
+    entity_type text NOT NULL,
+    entity_id text NOT NULL,
+    user_id varchar(40) NOT NULL,
+    occurred_at timestamp DEFAULT NOW() NOT NULL,
+    action text NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_change_log_entity_type ON change_log(entity_type);
+
+CREATE INDEX IF NOT EXISTS idx_change_log_entity_id ON change_log(entity_id);

model/src/commonMain/kotlin/ChangeEvent.kt

@@ -0,0 +1,53 @@
+/*
+ * Copyright (C) 2025 The ORT Server Authors (See <https://github.com/eclipse-apoapsis/ort-server/blob/main/NOTICE>)
+ *
+ * Licensed under the Apache 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.apache.org/licenses/LICENSE-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.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * License-Filename: LICENSE
+ */
+
+package org.eclipse.apoapsis.ortserver.model
+
+import kotlinx.datetime.Instant
+
+/**
+ * A data class representing a change event performed by a user.
+ */
+data class ChangeEvent(
+    /** The user who performed the change. */
+    val user: UserDisplayName,
+
+    /** The time the change occurred. */
+    val occurredAt: Instant,
+
+    /** The action performed. */
+    val action: ChangeEventAction
+)
+
+/**
+ * An enumeration of the entity types that can be affected by a [ChangeEvent].
+ */
+enum class ChangeEventEntityType {
+    VULNERABILITY_RESOLUTION_DEFINITION
+}
+
+/**
+ * An enumeration of the actions that can be performed, resulting in a [ChangeEvent].
+ */
+enum class ChangeEventAction {
+    CREATE,
+    UPDATE,
+    ARCHIVE,
+    RESTORE
+}