Skip to content

Add Prisma migration for EscrowEvent table (#108) #155

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
codellins wants to merge 7 commits into from
Closed

Add Prisma migration for EscrowEvent table (#108) #155

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
9895cab
fix(prisma): remove duplicate Dispute model blocking validation
codellins May 29, 2026
3ed4c6e
feat(prisma): add EscrowEvent model for state-transition auditing
codellins May 29, 2026
95e458b
feat(prisma): wire Escrow.events relation to EscrowEvent
codellins May 29, 2026
14300cb
chore(migration): scaffold add_escrow_event migration with audit header
codellins May 29, 2026
2c6095c
feat(migration): create EscrowEvent table for state-transition audit log
codellins May 29, 2026
ff9ff83
feat(migration): index EscrowEvent by escrowId and bind Escrow FK
codellins May 29, 2026
5d5bca7
fix(prisma): drop orphaned VendorEscrows relation from VendorProfile
codellins May 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions prisma/migrations/20260530100000_add_escrow_event/migration.sql
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
-- Issue #108: EscrowEvent table for append-only escrow state-transition auditing.
-- Supports reconstructing the full escrow lifecycle from persisted from/to states.

-- CreateTable
CREATE TABLE "EscrowEvent" (
"id" TEXT NOT NULL,
"escrowId" TEXT NOT NULL,
"fromState" TEXT,
"toState" TEXT NOT NULL,
"createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

CONSTRAINT "EscrowEvent_pkey" PRIMARY KEY ("id")
);

-- CreateIndex
CREATE INDEX "EscrowEvent_escrowId_idx" ON "EscrowEvent"("escrowId");

-- AddForeignKey
ALTER TABLE "EscrowEvent" ADD CONSTRAINT "EscrowEvent_escrowId_fkey" FOREIGN KEY ("escrowId") REFERENCES "Escrow"("id") ON DELETE CASCADE ON UPDATE CASCADE;
28 changes: 15 additions & 13 deletions prisma/schema.prisma
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,12 +37,27 @@ model Escrow {
updatedAt DateTime @updatedAt
disputes Dispute[]
notifications Notification[]
events EscrowEvent[]

@@index([vendorAddress])
@@index([buyerAddress])
@@index([vendorAddress, state])
}

/// Append-only audit log of escrow state transitions (#108).
/// One row per state change captures previous and new state for lifecycle reconstruction.
model EscrowEvent {
id String @id @default(cuid())
escrowId String
fromState String?
toState String
createdAt DateTime @default(now())

escrow Escrow @relation(fields: [escrowId], references: [id], onDelete: Cascade)

@@index([escrowId])
}

model Dispute {
id String @id @default(uuid())
escrowId String
Expand All @@ -66,18 +81,6 @@ model Notification {
escrow Escrow @relation(fields: [escrowId], references: [id], onDelete: Cascade)
}

model Dispute {
id String @id @default(cuid())
escrowId String @unique
reason String
status String @default("OPEN")
resolvedAt DateTime?
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt

escrow Escrow @relation(fields: [escrowId], references: [id], onDelete: Cascade)
}

model VendorProfile {
address String @id
businessName String
Expand All @@ -89,7 +92,6 @@ model VendorProfile {

accountDetails VendorAccountDetails?
trackingSettings VendorTrackingSettings?
escrows Escrow[] @relation("VendorEscrows")
}

model VendorAccountDetails {
Expand Down