@bslau/hmm_prisma_schema 1.13.0 → 1.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bslau/hmm_prisma_schema",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "main": "index.js",
   "author": "CIPA Development Team",
   "license": "ISC",

package/prisma/migrations/20251003002335_412575_event_torpedo_state_tracker/migration.sql

@@ -0,0 +1,38 @@
+BEGIN TRY
+
+BEGIN TRAN;
+
+-- CreateTable
+CREATE TABLE [dbo].[EventTorpedoState] (
+    [id] INT NOT NULL IDENTITY(1,1),
+    [eventId] INT NOT NULL,
+    [torpedoId] INT NOT NULL,
+    [torpedoStateId] INT NOT NULL,
+    [changedAt] DATETIME2,
+    [createdAt] DATETIME2 NOT NULL CONSTRAINT [EventTorpedoState_createdAt_df] DEFAULT CURRENT_TIMESTAMP,
+    [updatedAt] DATETIME2 NOT NULL,
+    CONSTRAINT [EventTorpedoState_pkey] PRIMARY KEY CLUSTERED ([id]),
+    CONSTRAINT [EventTorpedoState_eventId_key] UNIQUE NONCLUSTERED ([eventId])
+);
+
+-- AddForeignKey
+ALTER TABLE [dbo].[EventTorpedoState] ADD CONSTRAINT [EventTorpedoState_eventId_fkey] FOREIGN KEY ([eventId]) REFERENCES [dbo].[EventTracker]([id]) ON DELETE NO ACTION ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE [dbo].[EventTorpedoState] ADD CONSTRAINT [EventTorpedoState_torpedoId_fkey] FOREIGN KEY ([torpedoId]) REFERENCES [dbo].[Torpedo]([torpedoId]) ON DELETE NO ACTION ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE [dbo].[EventTorpedoState] ADD CONSTRAINT [EventTorpedoState_torpedoStateId_fkey] FOREIGN KEY ([torpedoStateId]) REFERENCES [dbo].[TorpedoState]([id]) ON DELETE NO ACTION ON UPDATE NO ACTION;
+
+COMMIT TRAN;
+
+END TRY
+BEGIN CATCH
+
+IF @@TRANCOUNT > 0
+BEGIN
+    ROLLBACK TRAN;
+END;
+THROW
+
+END CATCH

package/prisma/schema.prisma

@@ -138,10 +138,9 @@ model EventTorpedoMaintenance {
   updatedAt       DateTime     @updatedAt
 }
 
-/// **EVENT Torpedo On Gas**
+/// **EVENT TORPEDO ON GAS**
 ///
 /// Capture when a torpedo is on gas and off gas.
-
 model EventTorpedoOnGas {
   id         Int          @id @default(autoincrement())
   event      EventTracker @relation(fields: [eventId], references: [id])
@@ -154,6 +153,30 @@ model EventTorpedoOnGas {
   updatedAt  DateTime     @updatedAt
 }
 
+/// **TORPEDO STATE-CHANGE EVENT**
+///
+/// Capture the details of a _Torpedo State_ change event.
+///
+/// It is necessary to keep a history of when each Torpedo's State is modified.
+/// Whether that be by system or user triggered events. There are reporting
+/// metrics for Torpedoes that depend on understanding the intervals that the
+/// Torpedo exists in different Torpedo States.
+///
+/// The "changedAt" property should be set at the time when the _next_ State
+/// change happens.
+model EventTorpedoState {
+  id             Int           @id @default(autoincrement())
+  event          EventTracker  @relation(fields: [eventId], references: [id])
+  eventId        Int           @unique
+  torpedo        Torpedo       @relation(fields: [torpedoId], references: [torpedoId])
+  torpedoId      Int
+  torpedoState   TorpedoState? @relation(fields: [torpedoStateId], references: [id], onDelete: NoAction, onUpdate: NoAction)
+  torpedoStateId Int
+  changedAt      DateTime?
+  createdAt      DateTime      @default(now())
+  updatedAt      DateTime      @updatedAt
+}
+
 /// **EVENT TRACKER**
 ///
 /// Represents a generic system _Event_, which maps to its model instance.
@@ -166,6 +189,7 @@ model EventTracker {
   torpedoMovement    EventTorpedoMovement?
   torpedoCapacity    EventTorpedoCapacity?
   torpedoMaintenance EventTorpedoMaintenance?
+  torpedoState       EventTorpedoState?
   eventTorpedoOnGas  EventTorpedoOnGas?
 }
 
@@ -401,6 +425,7 @@ model Torpedo {
   eventTorpedoCapacity     EventTorpedoCapacity[]
   eventTorpedoMaintenance  EventTorpedoMaintenance[]
   eventsTorpedoOnGas       EventTorpedoOnGas[]
+  eventsTorpedoState       EventTorpedoState[]
   torpedoCampaign          TorpedoCampaign[]
   torpedoCycle             TorpedoCycle[]
   torpedoTrips             TorpedoTrip[]
@@ -496,6 +521,7 @@ model TorpedoState {
   description           String
   torpedoes             Torpedo[]
   eventsTorpedoMovement EventTorpedoMovement[]
+  eventsTorpedoState    EventTorpedoState[]
 }
 
 /// **TORPEDO TIMER**