feat: add manual bank card ledger

Store exact RUB balances, atomic transfers, linked refunds and versioned edits independently of T-Bank. Add migration, HTTP and durability verification.
2026-09-12 18:34:18 +03:00
parent 8ec172f48e
commit e6f58ef0ee
36 changed files with 2436 additions and 99 deletions
@@ -0,0 +1,69 @@
+-- CreateTable
+CREATE TABLE "BankCard" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "bankName" TEXT,
+    "lastFour" TEXT,
+    "openingBalanceKopecks" BIGINT NOT NULL,
+    "openingDate" TEXT NOT NULL,
+    "version" INTEGER NOT NULL DEFAULT 1,
+    "archivedAt" DATETIME,
+    "createFingerprint" TEXT NOT NULL,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "BankCard_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE RESTRICT ON UPDATE CASCADE
+);
+
+-- CreateTable
+CREATE TABLE "ExpenseCategory" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "nameKey" TEXT NOT NULL,
+    "seedKey" TEXT,
+    "version" INTEGER NOT NULL DEFAULT 1,
+    CONSTRAINT "ExpenseCategory_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE RESTRICT ON UPDATE CASCADE
+);
+
+-- CreateTable
+CREATE TABLE "BankCardOperation" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "userId" TEXT NOT NULL,
+    "kind" TEXT NOT NULL,
+    "cardId" TEXT NOT NULL,
+    "targetCardId" TEXT,
+    "categoryId" TEXT,
+    "originalExpenseId" TEXT,
+    "amountKopecks" BIGINT NOT NULL,
+    "date" TEXT NOT NULL,
+    "description" TEXT,
+    "version" INTEGER NOT NULL DEFAULT 1,
+    "deletedAt" DATETIME,
+    "createFingerprint" TEXT NOT NULL,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "BankCardOperation_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
+    CONSTRAINT "BankCardOperation_cardId_fkey" FOREIGN KEY ("cardId") REFERENCES "BankCard" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
+    CONSTRAINT "BankCardOperation_targetCardId_fkey" FOREIGN KEY ("targetCardId") REFERENCES "BankCard" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
+    CONSTRAINT "BankCardOperation_categoryId_fkey" FOREIGN KEY ("categoryId") REFERENCES "ExpenseCategory" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
+    CONSTRAINT "BankCardOperation_originalExpenseId_fkey" FOREIGN KEY ("originalExpenseId") REFERENCES "BankCardOperation" ("id") ON DELETE RESTRICT ON UPDATE NO ACTION
+);
+
+-- CreateIndex
+CREATE INDEX "BankCard_userId_idx" ON "BankCard"("userId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ExpenseCategory_userId_nameKey_key" ON "ExpenseCategory"("userId", "nameKey");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ExpenseCategory_userId_seedKey_key" ON "ExpenseCategory"("userId", "seedKey");
+
+-- CreateIndex
+CREATE INDEX "BankCardOperation_userId_cardId_date_idx" ON "BankCardOperation"("userId", "cardId", "date");
+
+-- CreateIndex
+CREATE INDEX "BankCardOperation_userId_targetCardId_date_idx" ON "BankCardOperation"("userId", "targetCardId", "date");
+
+-- CreateIndex
+CREATE INDEX "BankCardOperation_originalExpenseId_idx" ON "BankCardOperation"("originalExpenseId");
@@ -12,6 +12,9 @@ model User {
  id              String           @id
  email           String           @unique
  passwordHash    String
+  bankCards       BankCard[]
+  expenseCategories ExpenseCategory[]
+  bankCardOperations BankCardOperation[]
  sessions        Session[]
  tbankConnection TbankConnection?
  createdAt       DateTime         @default(now())
@@ -37,3 +40,60 @@ model Session {

  @@index([userId])
 }
+
+model BankCard {
+  id String @id
+  userId String
+  name String
+  bankName String?
+  lastFour String?
+  openingBalanceKopecks BigInt
+  openingDate String
+  version Int @default(1)
+  archivedAt DateTime?
+  createFingerprint String
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  user User @relation(fields: [userId], references: [id], onDelete: Restrict)
+  operations BankCardOperation[] @relation("SourceCard")
+  incomingOperations BankCardOperation[] @relation("TargetCard")
+  @@index([userId])
+}
+model ExpenseCategory {
+  id String @id
+  userId String
+  name String
+  nameKey String
+  seedKey String?
+  version Int @default(1)
+  user User @relation(fields: [userId], references: [id], onDelete: Restrict)
+  operations BankCardOperation[]
+  @@unique([userId, nameKey])
+  @@unique([userId, seedKey])
+}
+model BankCardOperation {
+  id String @id
+  userId String
+  kind String
+  cardId String
+  targetCardId String?
+  categoryId String?
+  originalExpenseId String?
+  amountKopecks BigInt
+  date String
+  description String?
+  version Int @default(1)
+  deletedAt DateTime?
+  createFingerprint String
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  user User @relation(fields: [userId], references: [id], onDelete: Restrict)
+  card BankCard @relation("SourceCard", fields: [cardId], references: [id], onDelete: Restrict)
+  targetCard BankCard? @relation("TargetCard", fields: [targetCardId], references: [id], onDelete: Restrict)
+  category ExpenseCategory? @relation(fields: [categoryId], references: [id], onDelete: Restrict)
+  originalExpense BankCardOperation? @relation("RefundExpense", fields: [originalExpenseId], references: [id], onDelete: Restrict, onUpdate: NoAction)
+  refunds BankCardOperation[] @relation("RefundExpense")
+  @@index([userId, cardId, date])
+  @@index([userId, targetCardId, date])
+  @@index([originalExpenseId])
+}