@bslau/hmm_prisma_schema 1.1.23 → 1.3.0

package/README.md

@@ -1,31 +1,44 @@
-# Introduction 
-TODO: Give a short introduction of your project. Let this section explain the objectives or the motivation behind this project. 
+# Editing Prisma Schema
 
-# Getting Started
-TODO: Guide users through getting your code up and running on their own system. In this section you can talk about:
-1.	Installation process
-2.	Software dependencies
-3.	Latest releases
-4.	API references
+The general workflow will follow these steps:
 
-# Build and Test
-TODO: Describe and show how to build your code and run the tests. 
+- Create and checkout a new working branch.
+- Edit `schema.prisma` as needed.
+- Run automated formatting: `npx prisma format`
+- Prepare database changes (as needed):
+  - create (preview) migration: `npm prisma:create` or;
+  - create and apply migration: `npm prisma:apply`
+- Update *minor* version number in `package.json`
+  `"version": "[MAJOR].[MINOR].[PATCH]"`
+- Create and test new seeding function(s) if required - being cautious to avoid creating **duplicate** records on repeated runs.
+- Raise PR for merging back into main branch.
 
-# Edit prisma schema
-TODO: Explain how other users and developers can edit prisma schema. 
->create a branch
+The changes should be ready for review, merging, and publishing now.
 
->edit schema.prisma
+# Deploying Prisma Schema
 
->npx prisma format
+Completing the PR (merging into main) will automatically trigger the build and release pipelines that will publish the new version of the package to the remote npm repository.
 
->npx prisma migrate dev --name new schema
+The latest version can then be installed in the application implementing the schema:
 
->update version in package.json
+`npm install @bslau/hmm_prisma_schema`
 
->raise PR for merging to main branch
+*NOTE* that doing this on the BlueScope network will typically **fail**. Installing this package involves generating a fresh Prisma client file - this is the part that seems to stall/fail because it's ignorant of the system proxy settings. The workaround is to use a hotspot internet connection without any proxy settings instead.
 
-If you want to learn more about creating good readme files then refer the following [guidelines](https://docs.microsoft.com/en-us/azure/devops/repos/git/create-a-readme?view=azure-devops). You can also seek inspiration from the below readme files:
-- [ASP.NET Core](https://github.com/aspnet/Home)
-- [Visual Studio Code](https://github.com/Microsoft/vscode)
-- [Chakra Core](https://github.com/Microsoft/ChakraCore)
+# Manual Deployment for Test Environment
+
+Current implementations of this package **don't** automate migration and seeding steps after release to the Test environment. This will result in schema mismatch between the Prisma package and the Test database when updates are released. 
+
+The workaround is to manually execute these steps after release. This example describes the process for the *GraphQL Apollo* server, but would also work for the *Event Processing* service (albeit in a different directory):
+
+- RDP into the host server: `ITAVWEB91`
+
+- Open a bash terminal and navigate to the installed package:
+
+  `cd /c/inetpub/wwwroot/hmm/graphql_server/node_modules/@bslau/hmm_prisma_schema`
+
+- Apply any pending migrations: `npm run prisma:deploy`
+
+- Run the seed function to create data: `npm run prisma:seed`
+
+At this point, assuming no errors in deploying or seeding, the Test database schema should be synchronised with Prisma now.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bslau/hmm_prisma_schema",
-  "version": "1.1.23",
+  "version": "1.3.0",
   "main": "index.js",
   "author": "CIPA Development Team",
   "license": "ISC",
@@ -14,6 +14,7 @@
     "prisma:apply": "npx prisma migrate dev",
     "prisma:create": "npx prisma migrate dev --create-only",
     "prisma:deploy": "npx prisma migrate deploy",
+    "prisma:seed": "npx prisma db seed",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "types": "./index.d.ts",

package/prisma/schema.prisma

@@ -283,6 +283,36 @@ model Location {
   torpedoLocations                 TorpedoLocation[]
 }
 
+/// **OPERATIONAL STATE**
+///
+/// A reference object that contains data about the Operational State of HMM.
+///
+/// As certain Fleet/Operational Calculations are performed, the results will be
+/// stored in the database, so that those values can be read/displayed without
+/// having to always re-run the calculations.
+model OperationalState {
+  id                      Int      @id @default(autoincrement())
+  hotMetalPotTonnes       Float    @default(0)
+  hotMetalTorpedoTonnes   Float    @default(0)
+  hotMetalTotalTonnes     Float    @default(0)
+  torpedoesActiveTally    Int      @default(0)
+  torpedoesAvailableTally Int      @default(0)
+  torpedoesCarryingTally  Int      @default(0)
+  torpedoesStandbyTally   Int      @default(0)
+  updatedAt               DateTime @updatedAt
+}
+
+/// **POT**
+///
+/// Physical equipment at the BOS for the transfer of Hot Metal from Torpedoes.
+///
+/// Normal operations will "empty" a Torpedo's Hot Metal into a specific Pot.
+model Pot {
+  id       Int        @id @default(autoincrement())
+  name     String     @unique
+  HotMetal HotMetal[]
+}
+
 /// **STATION**
 ///
 /// A logical location where different _Torpedo_ operations may occur.
@@ -325,8 +355,8 @@ model Torpedo {
   sixPitRestrictionEndTime DateTime?              @db.DateTimeOffset
   status                   Int                    @default(2)
   // sixPitStart DateTime?
-  capacityAverage Float?
-  capacityNominal Float @default(200)
+  capacityAverage          Float?
+  capacityNominal          Float                  @default(200)
   // comments String?
   // emptyWeight Float?
   // gasStart DateTime?
@@ -429,12 +459,3 @@ model TorpedoTrip {
   startTime             DateTime               @default(now()) @db.DateTimeOffset
   endTime               DateTime?              @db.DateTimeOffset
 }
-
-/// **POT**
-///
-/// Pot Number is a property in Hot Metal Model.
-model Pot {
-  id       Int        @id @default(autoincrement())
-  name     String     @unique
-  HotMetal HotMetal[]
-}