@bslau/hmm_prisma_schema 1.1.19 → 1.1.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bslau/hmm_prisma_schema",
-  "version": "1.1.19",
+  "version": "1.1.20",
   "main": "index.js",
   "author": "CIPA Development Team",
   "license": "ISC",
@@ -13,6 +13,7 @@
     "postinstall": "npm run generate",
     "prisma:apply": "npx prisma migrate dev",
     "prisma:create": "npx prisma migrate dev --create-only",
+    "prisma:deploy": "npx prisma migrate deploy",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "types": "./index.d.ts",

package/prisma/migrations/20250324223645_393918_torp_cycle/migration.sql

@@ -0,0 +1,43 @@
+BEGIN TRY
+
+BEGIN TRAN;
+
+-- AlterTable
+ALTER TABLE [dbo].[EventTorpedoMovement] ADD [torpedoCycleId] INT,
+[torpedoStateId] INT NOT NULL CONSTRAINT [EventTorpedoMovement_torpedoStateId_df] DEFAULT 0,
+[torpedoTripId] INT;
+
+-- CreateTable
+CREATE TABLE [dbo].[TorpedoCycle] (
+    [id] INT NOT NULL IDENTITY(1,1),
+    [hotMetalId] INT NOT NULL,
+    [torpedoId] INT NOT NULL,
+    [startTime] DATETIMEOFFSET NOT NULL CONSTRAINT [TorpedoCycle_startTime_df] DEFAULT CURRENT_TIMESTAMP,
+    [endTime] DATETIMEOFFSET,
+    CONSTRAINT [TorpedoCycle_pkey] PRIMARY KEY CLUSTERED ([id])
+);
+
+-- AddForeignKey
+ALTER TABLE [dbo].[EventTorpedoMovement] ADD CONSTRAINT [EventTorpedoMovement_torpedoCycleId_fkey] FOREIGN KEY ([torpedoCycleId]) REFERENCES [dbo].[TorpedoCycle]([id]) ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE [dbo].[EventTorpedoMovement] ADD CONSTRAINT [EventTorpedoMovement_torpedoTripId_fkey] FOREIGN KEY ([torpedoTripId]) REFERENCES [dbo].[TorpedoTrip]([id]) ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE [dbo].[TorpedoCycle] ADD CONSTRAINT [TorpedoCycle_hotMetalId_fkey] FOREIGN KEY ([hotMetalId]) REFERENCES [dbo].[HotMetal]([id]) ON DELETE NO ACTION ON UPDATE NO ACTION;
+
+-- AddForeignKey
+ALTER TABLE [dbo].[TorpedoCycle] ADD CONSTRAINT [TorpedoCycle_torpedoId_fkey] FOREIGN KEY ([torpedoId]) REFERENCES [dbo].[Torpedo]([torpedoId]) 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

@@ -29,7 +29,7 @@ model CampaignRebricking {
 ///
 /// From OOS to OOS, used for _Torpedo Ladle_ refractory inspections, based on
 /// number of tonnes carried, typically carried out once or twice a year (on
-/// average). The total tonnes and _Trips_ on the lining are not reset. 
+/// average). The total tonnes and _Trips_ on the lining are not reset.
 model CampaignSurvey {
   id           Int           @id @default(autoincrement())
   torpedo      Torpedo       @relation(fields: [torpedoId], references: [torpedoId], onDelete: NoAction, onUpdate: Cascade)
@@ -93,24 +93,33 @@ model Cast {
 /// **TORPEDO MOVEMENT EVENT**
 ///
 /// Capture the details of a _Torpedo Movement_ triggered by a **HMC Operator**.
+///
+/// Each movement event captures the _Torpedo's_ operational _State_, and is
+/// tracked within the context of the current _Trip_ and _Cycle_ - primarily for
+/// reporting purposes.
 model EventTorpedoMovement {
-  id                    Int          @id @default(autoincrement())
+  id                    Int           @id @default(autoincrement())
   torpedoId             Int
-  torpedo               Torpedo      @relation(fields: [torpedoId], references: [torpedoId])
-  eventTime             DateTime     @db.DateTimeOffset
-  originStation         Station      @relation(name: "originStation-movement", fields: [originStationId], references: [id], onDelete: NoAction, onUpdate: Cascade)
+  torpedo               Torpedo       @relation(fields: [torpedoId], references: [torpedoId])
+  torpedoStateId        Int           @default(0)
+  eventTime             DateTime      @db.DateTimeOffset
+  originStation         Station       @relation(name: "originStation-movement", fields: [originStationId], references: [id], onDelete: NoAction, onUpdate: Cascade)
   originStationId       Int
-  originLocation        Location     @relation(name: "originLocation-movement", fields: [originLocationId], references: [id], onDelete: NoAction, onUpdate: Cascade)
+  originLocation        Location      @relation(name: "originLocation-movement", fields: [originLocationId], references: [id], onDelete: NoAction, onUpdate: Cascade)
   originLocationId      Int
-  destinationStation    Station      @relation(name: "destinationStation-movement", fields: [destinationStationId], references: [id], onDelete: NoAction, onUpdate: NoAction)
+  destinationStation    Station       @relation(name: "destinationStation-movement", fields: [destinationStationId], references: [id], onDelete: NoAction, onUpdate: NoAction)
   destinationStationId  Int
-  destinationLocation   Location     @relation(name: "destinationLocation-movement", fields: [destinationLocationId], references: [id], onDelete: NoAction, onUpdate: NoAction)
+  destinationLocation   Location      @relation(name: "destinationLocation-movement", fields: [destinationLocationId], references: [id], onDelete: NoAction, onUpdate: NoAction)
   destinationLocationId Int
-  event                 EventTracker @relation(fields: [eventId], references: [id])
-  eventId               Int          @unique
+  event                 EventTracker  @relation(fields: [eventId], references: [id])
+  eventId               Int           @unique
   userId                String?
-  createdAt             DateTime     @default(now())
-  updatedAt             DateTime     @updatedAt
+  torpedoCycle          TorpedoCycle? @relation(fields: [torpedoCycleId], references: [id])
+  torpedoCycleId        Int?
+  torpedoTrip           TorpedoTrip?  @relation(fields: [torpedoTripId], references: [id])
+  torpedoTripId         Int?
+  createdAt             DateTime      @default(now())
+  updatedAt             DateTime      @updatedAt
 }
 
 /// **EVENT TRACKER**
@@ -141,7 +150,7 @@ model HMHComment {
 ///
 /// A (child) sub-lot, or batch, of molten iron produced by a **Blast Furnace**.
 ///
-/// Containes properties that describe when the _Hot Metal_ was produced and its
+/// Contains properties that describe when the _Hot Metal_ was produced and its
 /// measured physical values.
 model HotMetal {
   id                        Int                 @id @default(autoincrement())
@@ -151,6 +160,7 @@ model HotMetal {
   torpedo                   Torpedo             @relation(fields: [torpedoId], references: [torpedoId], onDelete: NoAction, onUpdate: Cascade)
   torpedoId                 Int
   labResult                 HotMetalLabResult[]
+  torpedoCycle              TorpedoCycle[]
   torpedoTrip               TorpedoTrip[]
   dateTimeStartFill         DateTime?           @db.DateTimeOffset
   dateTimeEndFill           DateTime?           @db.DateTimeOffset
@@ -209,7 +219,7 @@ model HotMetal {
 
 /// **LAB RESULT**
 ///
-/// _Hot Meta_l testing data from the **LIMS** laboratory integration.
+/// _Hot Metal_ testing data from the **LIMS** laboratory integration.
 ///
 /// Describes the time, type, and chemical analysis properties for a batch of
 /// _Hot Metal_. Samples are typically taken when filling at the **Blast Furnace**,
@@ -241,8 +251,8 @@ model HotMetalLabResult {
 ///
 /// An operational location where _Torpedoes_ may be placed during use.
 ///
-/// Within the context of HMM, a Location defines the physical place where a
-/// Torpedo is located, which is more precise than its Station.
+/// Within the context of **HMM**, a _Location_ defines the physical place where a
+/// _Torpedo_ is located, which is more precise than its _Station_.
 model Location {
   id                               Int                    @id @default(autoincrement())
   name                             String
@@ -309,6 +319,7 @@ model Torpedo {
   eventsTorpedoMovement    EventTorpedoMovement[]
   campaignsRebricking      CampaignRebricking[]
   campaignsSurvey          CampaignSurvey[]
+  torpedoCycle             TorpedoCycle[]
   torpedoTrips             TorpedoTrip[]
   torpedoState             TorpedoState?          @relation(fields: [torpedoStateId], references: [id])
   torpedoStateId           Int?
@@ -329,6 +340,24 @@ model TorpedoComment {
   updatedAt DateTime? @updatedAt
 }
 
+/// **TORPEDO CYCLE**
+///
+/// Used to capture each period between consecutive _Torpedo_ filling events.
+///
+/// Defined by: 
+/// - Start: **Blast Furnace** finish filling _Torpedo Ladle_
+/// - End: Next **Blast Furnace** finish filling _Torpedo Ladle_
+model TorpedoCycle {
+  id                    Int                    @id @default(autoincrement())
+  hotMetal              HotMetal               @relation(fields: [hotMetalId], references: [id], onDelete: NoAction, onUpdate: NoAction)
+  hotMetalId            Int
+  torpedo               Torpedo                @relation(fields: [torpedoId], references: [torpedoId], onDelete: NoAction, onUpdate: NoAction)
+  torpedoId             Int
+  eventsTorpedoMovement EventTorpedoMovement[]
+  startTime             DateTime               @default(now()) @db.DateTimeOffset
+  endTime               DateTime?              @db.DateTimeOffset
+}
+
 /// **TORPEDO LOCATION**
 ///
 /// Defines the current operational _Location_ for each _Torpedo_.
@@ -365,18 +394,19 @@ model TorpedoState {
 /// The period between finishing a fill, and consuming that _Hot Metal_.
 ///
 /// Defined by:
-/// - Start: **Blast Furnace** finish filling ladle
+/// - Start: **Blast Furnace** finish filling _Torpedo Ladle_
 /// - End: _Torpedo Ladle_ fully emptied at **BOS Weighbridge** or **21 Dump**
 model TorpedoTrip {
-  id                   Int                @id @default(autoincrement())
-  campaignRebricking   CampaignRebricking @relation(fields: [campaignRebrickingId], references: [id], onDelete: NoAction, onUpdate: NoAction)
-  campaignRebrickingId Int
-  campaignSurvey       CampaignSurvey     @relation(fields: [campaignSurveyId], references: [id], onDelete: NoAction, onUpdate: NoAction)
-  campaignSurveyId     Int
-  hotMetal             HotMetal           @relation(fields: [hotMetalId], references: [id], onDelete: NoAction, onUpdate: NoAction)
-  hotMetalId           Int
-  torpedo              Torpedo            @relation(fields: [torpedoId], references: [torpedoId], onDelete: NoAction, onUpdate: NoAction)
-  torpedoId            Int
-  startTime            DateTime           @default(now()) @db.DateTimeOffset
-  endTime              DateTime?          @db.DateTimeOffset
+  id                    Int                    @id @default(autoincrement())
+  campaignRebricking    CampaignRebricking     @relation(fields: [campaignRebrickingId], references: [id], onDelete: NoAction, onUpdate: NoAction)
+  campaignRebrickingId  Int
+  campaignSurvey        CampaignSurvey         @relation(fields: [campaignSurveyId], references: [id], onDelete: NoAction, onUpdate: NoAction)
+  campaignSurveyId      Int
+  hotMetal              HotMetal               @relation(fields: [hotMetalId], references: [id], onDelete: NoAction, onUpdate: NoAction)
+  hotMetalId            Int
+  torpedo               Torpedo                @relation(fields: [torpedoId], references: [torpedoId], onDelete: NoAction, onUpdate: NoAction)
+  torpedoId             Int
+  eventsTorpedoMovement EventTorpedoMovement[]
+  startTime             DateTime               @default(now()) @db.DateTimeOffset
+  endTime               DateTime?              @db.DateTimeOffset
 }