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/Role.java

@@ -0,0 +1,7 @@
+package org.example.alfs;
+
+public enum Role {
+    REPORTER,
+    INVESTIGATOR,
+    ADMIN
+}

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

@@ -0,0 +1,36 @@
+package org.example.alfs.entities;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+/*
+Represent a file uploaded with Ticket.
+Stores metadata about the file and the file reference s3key.
+ */
+@Entity
+@Getter
+@Setter
+@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,49 @@
+package org.example.alfs.entities;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+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")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+public class AuditLog {
+
+    @Id
+    @GeneratedValue
+    private Long id;
+
+    private String action;
+
+    private String fieldName;
+
+    @Column(length = 4000)
+    private String oldValue;
+
+    @Column(length = 4000)
+    private String newValue;
+
+    private LocalDateTime createdAt;
+
+    @PrePersist
+    public void prePersist() {
+        createdAt = LocalDateTime.now();
+    }
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "ticket_id")
+    private Ticket ticket;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "user_id")
+    private User user;
+}

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

@@ -0,0 +1,48 @@
+package org.example.alfs.entities;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+
+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")
+@Getter
+@Setter
+@AllArgsConstructor
+@NoArgsConstructor
+public class Ticket {
+
+    @Id
+    @GeneratedValue
+    private Long id;
+
+    private String title;
+
+    private String description;
+
+    private String status;
+
+    @Column(nullable = false, unique = true, length = 128, updatable = false)
+    private String reporterToken;
+
+    private LocalDateTime createdAt;
+
+    @PrePersist
+    public void prePersist() {
+        createdAt = LocalDateTime.now();
+    }
+
+    @OneToMany(mappedBy = "ticket", cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<Attachment> attachments;
+
+    @ManyToOne
+    private User assignedHandler;
+}

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

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

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

@@ -0,0 +1,31 @@
+package org.example.alfs.entities;
+
+import jakarta.persistence.*;
+import lombok.*;
+import org.example.alfs.Role;
+
+/*
+Represents a system user.
+Users have different roles such as admin or investigator.
+ */
+@Entity
+@Table(name = "users")
+@Getter
+@Setter
+@AllArgsConstructor
+@NoArgsConstructor
+public class User {
+
+    @GeneratedValue
+    @Id
+    private Long id;
+
+    private String username;
+
+    @Column(name = "password_hash", nullable = false, length = 255)
+    private String passwordHash;
+
+    @Enumerated(EnumType.STRING)
+    private Role role;
+
+}

src/main/jte/placeholder.jte

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