Feat/interfaces

build.gradle.kts

@@ -69,6 +69,8 @@ repositories {
 dependencies {
     testImplementation(platform("org.junit:junit-bom:5.10.0"))
     testImplementation("org.junit.jupiter:junit-jupiter")
+    testImplementation("org.mockito:mockito-junit-jupiter:5.11.0")
+    testImplementation("org.mockito:mockito-core:5.11.0")
     testRuntimeOnly("org.junit.platform:junit-platform-launcher")
     implementation("org.jetbrains:annotations:24.0.0")
 }

src/main/java/ar/edu/unc/david/routersimulator/model/nodes/NetworkNode.java

@@ -0,0 +1,17 @@
+package ar.edu.unc.david.routersimulator.model.nodes;
+
+import ar.edu.unc.david.routersimulator.model.IpAddress;
+import ar.edu.unc.david.routersimulator.model.stats.Stats;
+
+/**
+ * A node in the simulated network — either a {@link Router} or a {@link Terminal}.
+ *
+ * <p>Every node has an IP, can receive packets, advances per tick, and reports a common {@link
+ * Stats} snapshot. Node-specific stats are available by casting to {@link TerminalStats} or {@link
+ * RouterStats}.
+ */
+public interface NetworkNode extends PacketReceiver, Tickable {
+  IpAddress ip();
+
+  Stats collectStats();
+}

src/main/java/ar/edu/unc/david/routersimulator/model/nodes/PacketReceiver.java

@@ -0,0 +1,8 @@
+package ar.edu.unc.david.routersimulator.model.nodes;
+
+import ar.edu.unc.david.routersimulator.model.Packet;
+
+/** Any entity that accepts incoming {@link Packet}s into an input buffer. */
+public interface PacketReceiver {
+  boolean receivePacket(Packet packet);
+}

src/main/java/ar/edu/unc/david/routersimulator/model/nodes/Tickable.java

@@ -0,0 +1,9 @@
+package ar.edu.unc.david.routersimulator.model.nodes;
+
+/**
+ * Represents an entity that can be processed or updated in discrete time intervals or "ticks".
+ * Implementing classes define specific behavior to be executed during each tick.
+ */
+public interface Tickable {
+  void tick(long currentTick);
+}

src/main/java/ar/edu/unc/david/routersimulator/model/stats/Stats.java

@@ -0,0 +1,13 @@
+package ar.edu.unc.david.routersimulator.model.stats;
+
+import ar.edu.unc.david.routersimulator.model.IpAddress;
+
+/**
+ * A common interface for stats snapshots from both {@link Router}s and {@link Terminal}s, to be
+ * used in the UI and elsewhere when only the common fields are relevant.
+ */
+public interface Stats {
+  IpAddress ip();
+
+  long packetsReceived();
+}