Feature/entities

.gitignore

@@ -34,3 +34,25 @@ build/
 
 ### jte ###
 /jte-classes/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Logs
+logs/
+*.log
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# temp
+tmp/
+temp/
+
+# secrets
+secrets/
+*.key
+*.pem

README.md

@@ -0,0 +1,14 @@
+# The ALFS Whistleblower Ticket System
+
+### A secure case management system built with Spring Boot for handling whistleblower reports.
+The system allows anonymous reporting, secure file uploads, role-based access control, and full audit logging.
+
+#### Logs should look like this:
+```text
+action = HANDLER_ASSIGNED
+fieldName = assignedHandler
+oldValue = null
+newValue = userId:5
+createdAt = 2026-03-27
+```
+

pom.xml

@@ -87,6 +87,10 @@
             <artifactId>spring-boot-starter-webmvc-test</artifactId>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jpa</artifactId>
+        </dependency>
     </dependencies>
 
     <build>

src/main/java/org/example/alfs/entities/Attachment.java

@@ -0,0 +1,37 @@
+package org.example.alfs.entities;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+/*
+Represent a file uploaded with Ticket.
+Stores metadata about the file and the file reference s3key.
+ */
+@Entity
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class Attachment {
+
+    @Id
+    @GeneratedValue
+    private Long id;
+
+    private String fileName;
+
+    private String s3Key;
+
+    private LocalDateTime uploadedAt;
+
+    @PrePersist
+    public void prePersist() {
+        uploadedAt = LocalDateTime.now();
+    }
+
+    @ManyToOne
+    private Ticket ticket;
+}

src/main/java/org/example/alfs/entities/AuditLog.java

@@ -0,0 +1,45 @@
+package org.example.alfs.entities;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+/*
+Represents audit log for Ticket.
+Logs all events such as status change, assignment and comments.
+Should be written automatically.
+ */
+@Entity
+@Table(name="audit_log")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class AuditLog {
+
+    @Id
+    @GeneratedValue
+    private Long id;
+
+    private String action;
+
+    private String fieldName;
+
+    private String oldValue;
+
+    private String newValue;
+
+    private LocalDateTime createdAt;
+    @PrePersist
+    public void prePersist() {
+        createdAt = LocalDateTime.now();
+    }
+
+    @ManyToOne
+    private Ticket ticket;
+
+    @ManyToOne
+    private SystemUser user;
+}

src/main/java/org/example/alfs/entities/SystemUser.java

@@ -0,0 +1,28 @@
+package org.example.alfs.entities;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/*
+Represents a system user.
+Users have different roles such as admin or investigator.
+ */
+@Entity
+@Table(name="system_user")
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class SystemUser {
+
+    @GeneratedValue
+    @Id
+    private Long id;
+
+    private String username;
+    private String password;
+
+    private String role;
+
+}

src/main/java/org/example/alfs/entities/Ticket.java

@@ -0,0 +1,47 @@
+package org.example.alfs.entities;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/*
+Representing a whistleblower report.
+The ticket can be followed by the anonymous reporter by using the reporterToken.
+ */
+
+@Entity
+@Table(name="ticket")
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class Ticket {
+
+    @Id
+    @GeneratedValue
+    private Long id;
+
+    private String title;
+
+    private String description;
+
+    private String status;
+
+    private String reporterToken;
+
+    private LocalDateTime createdAt;
+    @PrePersist
+    public void prePersist() {
+        createdAt = LocalDateTime.now();
+    }
+
+    @OneToMany(mappedBy = "ticket")
+    private List<Attachment> attachment;
+
+    @ManyToOne
+    private SystemUser assignedHandler;
+}

src/main/java/org/example/alfs/entities/TicketComment.java

@@ -0,0 +1,35 @@
+package org.example.alfs.entities;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+
+import java.time.LocalDateTime;
+
+/*
+Represents comment on a ticket.
+The comments are written by a SystemUser.
+ */
+@Entity
+@Table(name="ticket_comment")
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class TicketComment {
+
+    @Id
+    @GeneratedValue
+    private Long id;
+
+    private String message;
+
+    private LocalDateTime createdAt;
+
+    @ManyToOne
+    private Ticket ticket;
+
+    @ManyToOne
+    private SystemUser author;
+}

src/main/jte/placeholder.jte

@@ -0,0 +1 @@
+<%-- This is a placeholder jte file for CI test --%>