feat: add feature

apps/api/prisma/migrations/20261020120000_tab_events/migration.sql

@@ -0,0 +1,33 @@
+-- CreateTable
+CREATE TABLE "TabEvent" (
+    "id" TEXT NOT NULL,
+    "venueId" TEXT NOT NULL,
+    "deviceId" TEXT NOT NULL,
+    "tabId" TEXT NOT NULL,
+    "customerName" TEXT NOT NULL,
+    "type" TEXT NOT NULL,
+    "productName" TEXT,
+    "unitPriceInCents" INTEGER,
+    "quantityDelta" INTEGER,
+    "amountInCents" INTEGER,
+    "paymentMethod" TEXT,
+    "commandId" TEXT,
+    "items" JSONB,
+    "occurredAt" TIMESTAMP(3) NOT NULL,
+    "receivedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "TabEvent_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "TabEvent_venueId_occurredAt_idx" ON "TabEvent"("venueId", "occurredAt");
+
+-- CreateIndex
+CREATE INDEX "TabEvent_venueId_type_occurredAt_idx" ON "TabEvent"("venueId", "type", "occurredAt");
+
+-- AddForeignKey
+ALTER TABLE "TabEvent" ADD CONSTRAINT "TabEvent_venueId_fkey" FOREIGN KEY ("venueId") REFERENCES "Venue"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "TabEvent" ADD CONSTRAINT "TabEvent_deviceId_fkey" FOREIGN KEY ("deviceId") REFERENCES "Device"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+

apps/api/prisma/schema.prisma

@@ -21,6 +21,7 @@ model Venue {
   regCodes       RegistrationCode[]
   plannedTabs    PlannedTab[]
   tabReminders   TabReminder[]
+  tabEvents      TabEvent[]
 }
 
 model Device {
@@ -38,6 +39,7 @@ model Device {
   tabSnapshots   OpenTabSnapshot[]
   tabOwnerships  TabOwnership[]
   remoteCommands RemoteCommand[]
+  tabEvents      TabEvent[]
 
   @@index([venueId, revokedAt])
 }
@@ -183,3 +185,32 @@ model TabReminder {
   @@index([venueId, sentAt])
   @@index([venueId, tabId])
 }
+
+// What happened on a tab, as reported by the terminal: lines added or removed, and settlements.
+// The id is generated by the terminal so a re-sent event is stored only once.
+model TabEvent {
+  id               String   @id
+  venueId          String
+  deviceId         String
+  tabId            String
+  customerName     String
+  // line_added | line_removed | settled
+  type             String
+  productName      String?
+  unitPriceInCents Int?
+  // Signed: positive for line_added, negative for line_removed
+  quantityDelta    Int?
+  // settled only
+  amountInCents    Int?
+  paymentMethod    String?
+  commandId        String?
+  items            Json?
+  occurredAt       DateTime
+  receivedAt       DateTime @default(now())
+
+  venue  Venue  @relation(fields: [venueId], references: [id])
+  device Device @relation(fields: [deviceId], references: [id])
+
+  @@index([venueId, occurredAt])
+  @@index([venueId, type, occurredAt])
+}

apps/api/prisma/setup.js

@@ -31,6 +31,7 @@ async function main() {
 
   await prisma.$transaction(async (tx) => {
     await tx.auditLog.deleteMany();
+    await tx.tabEvent.deleteMany();
     await tx.tabReminder.deleteMany();
     await tx.plannedTab.deleteMany();
     await tx.remoteCommand.deleteMany();