Модуль складського обліку

model LegalEntity {
  id                Int      @id @default(autoincrement())
  tenantId          Int?
  name              String            // "ФОП Петренко О.М."
  shortName         String?           // "Петренко"
  type              String            // fop | tov | pp
  taxCode           String?           // ЄДРПОУ або ІПН
  address           String?
  bankName          String?
  iban              String?
  phone             String?
  email             String?
  taxSystem         String?           // "3 група, без ПДВ"
  allowedCategories Json?             // ["Обладнання", "Послуги ТО"]
  stampUrl          String?           // URL печатки
  signatureUrl      String?           // URL підпису
  isDefault         Boolean  @default(false)
  isActive          Boolean  @default(true)
  createdAt         DateTime @default(now())
  invoices          Invoice[]
}

model Invoice {
  id              Int      @id @default(autoincrement())
  tenantId        Int?
  number          String?            // "РФ-001"
  type            String             // invoice | nakladna | act | writeoff_act
  legalEntityId   Int
  clientName      String             // назва клієнта/організації
  clientCode      String?            // ЄДРПОУ клієнта
  clientAddress   String?
  ticketId        Int?               // зв'язок з заявкою
  expenseDocId    Int?               // зв'язок з видатковою
  date            DateTime @default(now())
  dueDate         DateTime?          // термін оплати
  currency        String   @default("UAH")
  totalAmount     Float    @default(0)
  status          String   @default("draft") // draft | sent | paid | cancelled
  notes           String?
  pdfUrl          String?            // згенерований PDF
  createdAt       DateTime @default(now())
  legalEntity     LegalEntity @relation(fields: [legalEntityId], references: [id])
  lines           InvoiceLine[]
}

model InvoiceLine {
  id          Int     @id @default(autoincrement())
  invoiceId   Int
  description String           // назва товару/послуги
  unit        String  @default("шт")
  quantity    Float
  price       Float
  amount      Float
  invoice     Invoice @relation(fields: [invoiceId], references: [id], onDelete: Cascade)
}

Категорії (приклад для IT):
├── Картриджі
│   ├── HP
│   └── Kyocera
├── Запчастини
│   ├── HDD/SSD
│   └── RAM
├── Мережеве обладнання
├── Кабелі та аксесуари
└── Витратники

Категорії (приклад для Solar):
├── Інвертори
├── Батареї
├── Панелі
├── Кабелі та конектори
└── Кріплення

model ProductCategory {
  id        Int      @id @default(autoincrement())
  tenantId  Int?
  name      String
  parentId  Int?                // вкладені категорії
  sortOrder Int      @default(0)
  parent    ProductCategory? @relation("CategoryTree", fields: [parentId], references: [id])
  children  ProductCategory[] @relation("CategoryTree")
  products  Product[]
}

model Supplier {
  id            Int       @id @default(autoincrement())
  tenantId      Int?
  name          String                    // "Тайстра", "ERC"
  code          String?                   // внутрішній код
  contactName   String?                   // контактна особа
  phone         String?
  email         String?
  address       String?
  notes         String?
  paymentTerms  String?                   // "передоплата", "30 днів", "по факту"
  currency      String    @default("UAH") // основна валюта
  isActive      Boolean   @default(true)
  createdAt     DateTime  @default(now())
  supplies      SupplyDocument[]
}

model Warehouse {
  id         Int      @id @default(autoincrement())
  tenantId   Int?
  name       String                // "Головний склад", "Мобільний", "Склад Петренко"
  type       String   @default("main")  // main | mobile | technician
  address    String?
  userId     Int?                  // якщо type=technician — прив'язка до юзера
  isActive   Boolean  @default(true)
  createdAt  DateTime @default(now())
  user       User?    @relation(fields: [userId], references: [id])
  stocks     WarehouseStock[]
  incomeDocs SupplyDocument[]     @relation("SupplyToWarehouse")
}

model Product {
  id             Int       @id @default(autoincrement())
  tenantId       Int?
  sku            String?   @unique         // артикул
  name           String                    // "Картридж HP CF259A"
  category       String?                   // "Картриджі", "Кабелі", "Запчастини"
  unit           String    @default("шт")  // шт, м, кг, л
  barcode        String?                   // штрихкод EAN-13
  minStock       Float     @default(0)     // мінімальний залишок (алерт)
  warrantyMonths Int?                      // гарантія за замовчуванням (міс)
  purchasePrice  Float?                    // остання ціна закупівлі
  sellPrice      Float?                    // ціна продажу
  currency       String    @default("UAH")
  notes          String?
  isActive       Boolean   @default(true)
  createdAt      DateTime  @default(now())
  stocks         WarehouseStock[]
  serialItems    SerialItem[]
  supplyLines    SupplyLine[]
  expenseLines   ExpenseLine[]
}

model WarehouseStock {
  id           Int       @id @default(autoincrement())
  warehouseId  Int
  productId    Int
  quantity     Float     @default(0)       // поточний залишок
  reservedQty  Float     @default(0)       // зарезервовано (в заявках)
  updatedAt    DateTime  @updatedAt
  warehouse    Warehouse @relation(fields: [warehouseId], references: [id])
  product      Product   @relation(fields: [productId], references: [id])

  @@unique([warehouseId, productId])
}

model SerialItem {
  id             Int       @id @default(autoincrement())
  productId      Int
  serialNumber   String    @unique
  warehouseId    Int?                      // де зараз (null = списано/продано)
  status         String    @default("in_stock") // in_stock | reserved | sold | written_off | warranty_return
  purchasePrice  Float?
  currency       String    @default("UAH")
  supplierId     Int?
  supplyDocId    Int?                      // в якому приході прийшов
  warrantyUntil  DateTime?                 // дата закінчення гарантії
  soldAt         DateTime?
  writtenOffAt   DateTime?
  notes          String?
  createdAt      DateTime  @default(now())
  product        Product   @relation(fields: [productId], references: [id])
  supplier       Supplier? @relation(fields: [supplierId], references: [id])
  supplyDoc      SupplyDocument? @relation(fields: [supplyDocId], references: [id])
}

model SupplyDocument {
  id             Int       @id @default(autoincrement())
  tenantId       Int?
  number         String?                   // "ПН-001", автонумерація
  type           String    @default("income") // income | return_to_supplier
  supplierId     Int
  warehouseId    Int                       // на який склад
  date           DateTime  @default(now())
  currency       String    @default("UAH")
  exchangeRate   Float     @default(1)     // курс до UAH
  totalAmount    Float     @default(0)     // сума документа
  status         String    @default("draft") // draft | confirmed | cancelled
  notes          String?
  createdAt      DateTime  @default(now())
  confirmedAt    DateTime?
  confirmedById  Int?
  supplier       Supplier  @relation(fields: [supplierId], references: [id])
  warehouse      Warehouse @relation("SupplyToWarehouse", fields: [warehouseId], references: [id])
  lines          SupplyLine[]
  serialItems    SerialItem[]
}

model SupplyLine {
  id           Int            @id @default(autoincrement())
  documentId   Int
  productId    Int
  quantity     Float
  price        Float                       // ціна за одиницю в валюті документа
  amount       Float                       // quantity * price
  document     SupplyDocument @relation(fields: [documentId], references: [id], onDelete: Cascade)
  product      Product        @relation(fields: [productId], references: [id])
}

model ExpenseDocument {
  id             Int       @id @default(autoincrement())
  tenantId       Int?
  number         String?                   // "ВН-001"
  type           String    @default("expense") // expense | transfer | writeoff | sale
  fromWarehouseId Int                      // з якого складу
  toWarehouseId  Int?                      // на який (для transfer)
  ticketId       Int?                      // прив'язка до заявки
  clientName     String?                   // для sale
  date           DateTime  @default(now())
  currency       String    @default("UAH")
  totalAmount    Float     @default(0)
  status         String    @default("draft") // draft | confirmed | cancelled
  notes          String?
  createdAt      DateTime  @default(now())
  confirmedAt    DateTime?
  confirmedById  Int?
  lines          ExpenseLine[]
}

model ExpenseLine {
  id           Int             @id @default(autoincrement())
  documentId   Int
  productId    Int
  quantity     Float
  price        Float
  amount       Float
  serialNumber String?                    // якщо серійний облік
  document     ExpenseDocument @relation(fields: [documentId], references: [id], onDelete: Cascade)
  product      Product         @relation(fields: [productId], references: [id])
}

Склад (нова група)
  ├── Товари
  ├── Залишки
  ├── Приходи
  ├── Розходи
  ├── Постачальники
  ├── Гарантії
  └── Звіт руху

7 Додаткові вимоги (v1.1)

7.1 Ціни постачальників

Один товар може закуповуватись у різних постачальників за різними цінами. Потрібно бачити історію і порівнювати.

model SupplierPrice {
  id            Int       @id @default(autoincrement())
  productId     Int
  supplierId    Int
  price         Float
  currency      String    @default("UAH")
  minOrderQty   Float?                    // мін. замовлення
  deliveryDays  Int?                      // термін доставки
  validUntil    DateTime?                 // дійсна до
  updatedAt     DateTime  @updatedAt
  createdAt     DateTime  @default(now())
  product       Product   @relation(fields: [productId], references: [id])
  supplier      Supplier  @relation(fields: [supplierId], references: [id])

  @@unique([productId, supplierId])
  @@index([productId])
}

7.2 Інтеграція ПриватБанк

// Налаштування в SystemSettings або LegalEntity
model BankAccount {
  id              Int      @id @default(autoincrement())
  legalEntityId   Int
  bankName        String             // "ПриватБанк"
  iban            String
  currency        String   @default("UAH")
  apiToken        String?            // encrypted, Приват24 API токен
  merchantId      String?            // merchant ID
  autoSync        Boolean  @default(false)
  lastSyncAt      DateTime?
  balance         Float?
  isActive        Boolean  @default(true)
  legalEntity     LegalEntity @relation(fields: [legalEntityId], references: [id])
  transactions    BankTransaction[]
}

model BankTransaction {
  id              Int      @id @default(autoincrement())
  bankAccountId   Int
  externalId      String?  @unique      // ID з банку
  date            DateTime
  amount          Float
  currency        String
  counterparty    String?               // назва контрагента
  purpose         String?               // призначення платежу
  type            String                // credit | debit
  invoiceId       Int?                  // зіставлений рахунок
  isReconciled    Boolean  @default(false)
  createdAt       DateTime @default(now())
  bankAccount     BankAccount @relation(fields: [bankAccountId], references: [id])
}

7.3 Інтеграція "Вчасно" (електронний документообіг)

// Інтеграція через API Вчасно (vchasno.ua/api)
// Потрібно: API ключ + КЕП (ключ електронного підпису)
//
// Потік:
// 1. Генеруємо PDF документ (pdfmake)
// 2. Підписуємо КЕП (через API Вчасно або Дія.Підпис)
// 3. Відправляємо через API Вчасно контрагенту
// 4. Отримуємо callback зі статусом
// 5. Зберігаємо підписаний документ

7.4 Каси (прив'язка до організації)

Кілька кас (готівкових та безготівкових) з прив'язкою до юридичних осіб:

model CashRegister {
  id              Int      @id @default(autoincrement())
  tenantId        Int?
  name            String              // "Каса ФОП Петренко", "Безготівковий ТОВ"
  type            String              // cash | bank | card
  legalEntityId   Int
  currency        String   @default("UAH")
  balance         Float    @default(0)
  isActive        Boolean  @default(true)
  createdAt       DateTime @default(now())
  legalEntity     LegalEntity @relation(fields: [legalEntityId], references: [id])
  operations      CashOperation[]
}

model CashOperation {
  id              Int      @id @default(autoincrement())
  cashRegisterId  Int
  type            String              // income | expense | transfer
  amount          Float
  description     String
  counterparty    String?             // від кого / кому
  documentType    String?             // invoice | supply | salary | tax | other
  documentId      Int?                // ID рахунку або накладної
  date            DateTime @default(now())
  userId          Int?                // хто провів
  cashRegister    CashRegister @relation(fields: [cashRegisterId], references: [id])
}

7.5 Курсові різниці

• Курс на дату документа — кожний документ фіксує курс на свою дату
• Курс на дату оплати — при оплаті фіксується фактичний курс
• Курсова різниця — автоматичний розрахунок: (курс оплати - курс документа) * сума в валюті
• Переоцінка — при закритті місяця: всі незакриті валютні зобов'язання переоцінюються по курсу НБУ на кінець місяця
• Журнал курсів — історія всіх курсів з API НБУ + ручні корекції

model ExchangeRate {
  id        Int      @id @default(autoincrement())
  date      DateTime                   // дата курсу
  currency  String                     // USD, EUR
  rate      Float                      // курс до UAH
  source    String   @default("nbu")   // nbu | manual
  createdAt DateTime @default(now())

  @@unique([date, currency])
}

// В кожному документі:
// SupplyDocument.exchangeRate = курс на дату приходу
// При оплаті: paymentRate = курс на дату оплати
// Різниця = (paymentRate - exchangeRate) * amountInCurrency

7.6 Закриття місяця

Щомісячна процедура фіксації фінансових показників:

model MonthClosing {
  id          Int      @id @default(autoincrement())
  tenantId    Int?
  period      String              // "2026-04"
  status      String   @default("open") // open | closing | closed
  closedAt    DateTime?
  closedById  Int?
  totalIncome    Float?           // виручка
  totalExpense   Float?           // собівартість
  totalProfit    Float?           // прибуток
  exchangeDiff   Float?           // курсові різниці
  report      Json?               // повний звіт (snapshot)
  createdAt   DateTime @default(now())

  @@unique([tenantId, period])
}

7.7 Замовлення клієнту

Клієнт замовляє товар/послугу → формується замовлення → резервується на складі → рахунок → оплата → видаткова.

model CustomerOrder {
  id              Int      @id @default(autoincrement())
  tenantId        Int?
  number          String?
  clientName      String
  clientPhone     String?
  organizationId  Int?               // організація-клієнт
  legalEntityId   Int?               // від якого ФОП/ТОВ
  status          String   @default("new") // new | confirmed | reserved | invoiced | paid | shipped | completed | cancelled
  currency        String   @default("UAH")
  totalAmount     Float    @default(0)
  notes           String?
  ticketId        Int?               // зв'язок з заявкою
  invoiceId       Int?               // згенерований рахунок
  expenseDocId    Int?               // видаткова накладна
  createdAt       DateTime @default(now())
  completedAt     DateTime?
  lines           CustomerOrderLine[]
}

model CustomerOrderLine {
  id          Int    @id @default(autoincrement())
  orderId     Int
  productId   Int?
  description String
  unit        String @default("шт")
  quantity    Float
  price       Float
  amount      Float
  order       CustomerOrder @relation(fields: [orderId], references: [id], onDelete: Cascade)
}

7.8 Замовлення постачальнику

Формується на основі дефіциту (залишок < мінімум) або вручну. Прив'язується до постачальника з найкращою ціною.

model PurchaseOrder {
  id              Int      @id @default(autoincrement())
  tenantId        Int?
  number          String?
  supplierId      Int
  warehouseId     Int                // на який склад
  status          String   @default("draft") // draft | sent | confirmed | received | cancelled
  currency        String   @default("UAH")
  exchangeRate    Float    @default(1)
  totalAmount     Float    @default(0)
  expectedDate    DateTime?          // очікувана дата доставки
  notes           String?
  supplyDocId     Int?               // створена прихідна
  createdAt       DateTime @default(now())
  supplier        Supplier @relation(fields: [supplierId], references: [id])
  lines           PurchaseOrderLine[]
}

model PurchaseOrderLine {
  id          Int    @id @default(autoincrement())
  orderId     Int
  productId   Int
  quantity    Float
  price       Float
  amount      Float
  order       PurchaseOrder @relation(fields: [orderId], references: [id], onDelete: Cascade)
}

7.9 Партійний облік

• Кожна позиція приходу = нова партія (ProductBatch)
• При розході — FIFO автоматично вибирає партії з найстарішим залишком
• Собівартість — точна, по конкретній партії (не середньозважена)
• Термін придатності — для партій з обмеженим строком (FEFO — First Expired First Out)
• Відстеження — звідки прийшов → де зараз → кому пішов

model ProductBatch {
  id              Int       @id @default(autoincrement())
  productId       Int
  warehouseId     Int
  supplyDocId     Int?                // прихідна накладна
  supplierId      Int?
  batchNumber     String?             // номер партії (від постачальника)
  quantity        Float               // початкова кількість
  remainingQty    Float               // поточний залишок партії
  purchasePrice   Float               // ціна закупівлі
  currency        String   @default("UAH")
  exchangeRate    Float    @default(1)
  priceUah        Float               // ціна в UAH (purchasePrice * exchangeRate)
  expiresAt       DateTime?           // термін придатності
  receivedAt      DateTime @default(now())
  product         Product  @relation(fields: [productId], references: [id])

  @@index([productId, warehouseId])
  @@index([productId, remainingQty])  // для FIFO
}

8 Ідеї з OneBox + AI (v1.2)

Додаткові ідеї на основі аналізу OneB та OneBox OS:

8.1 Розширена картка товару

8.2 AI для документів (як OneB Invoice Price AI)

8.3 Workflow замовлень (як OneBox)

• Кошторис — попередній розрахунок вартості робіт + матеріалів. Клієнт затверджує → автоматично рахунок.
• Статуси документів — Чернетка → Надіслано → Переглянуто → Підписано → Оплачено. Кольорові бейджі.
• Шаблони документів — редактор з полями: {клієнт}, {сума}, {дата}. Логотип, печатка, підпис.
• Масові дії — вибрати кілька документів → надіслати, змінити статус, експорт.
• Зв'язок з заявкою — заявка → кошторис → рахунок → видаткова. Повний ланцюжок.

8.4 Прайс-листи та знижки

model PriceLevel {
  id        Int      @id @default(autoincrement())
  tenantId  Int?
  name      String              // "Роздріб", "Опт", "VIP"
  markup    Float    @default(0) // націнка % від закупівельної
  isDefault Boolean  @default(false)
  createdAt DateTime @default(now())
}

model CustomerPriceLevel {
  id              Int    @id @default(autoincrement())
  organizationId  Int?             // організація-клієнт
  priceLevelId    Int
  discount        Float  @default(0) // додаткова знижка %
}

model PriceHistory {
  id          Int      @id @default(autoincrement())
  productId   Int
  supplierId  Int?
  price       Float
  currency    String   @default("UAH")
  source      String   @default("manual") // manual | import | ai
  recordedAt  DateTime @default(now())
}

8.5 Кошторис (Estimate)

model Estimate {
  id              Int      @id @default(autoincrement())
  tenantId        Int?
  number          String?
  clientName      String
  organizationId  Int?
  ticketId        Int?              // зв'язок з заявкою
  legalEntityId   Int?              // від якого ФОП/ТОВ
  status          String   @default("draft") // draft | sent | approved | rejected
  currency        String   @default("UAH")
  totalAmount     Float    @default(0)
  validUntil      DateTime?         // дійсний до
  notes           String?
  pdfUrl          String?
  invoiceId       Int?              // згенерований рахунок
  createdAt       DateTime @default(now())
  lines           EstimateLine[]
}

model EstimateLine {
  id          Int    @id @default(autoincrement())
  estimateId  Int
  type        String @default("product") // product | service | work
  description String
  productId   Int?
  unit        String @default("шт")
  quantity    Float
  price       Float
  amount      Float
  estimate    Estimate @relation(fields: [estimateId], references: [id], onDelete: Cascade)
}

8.6 Етикетки та друк

• Генерація етикеток — QR/штрихкод + назва + ціна + артикул на етикетці
• Друк цінників — масовий друк для полиці (A4 з декількома цінниками)
• Друк документів — накладна, рахунок, акт — PDF з шаблону pdfmake
• Термопринтер — етикетки 58мм/80мм для принтерів Zebra/TSC

8.7 Мобільний склад

• Сканер штрихкоду — камера телефону → пошук товару → залишки → прихід/розхід
• Інвентаризація — скануй → вводи факт → автоматичний розрахунок різниці
• Прихід з фото — сфотографуй накладну → AI розпізнає → створи прихід
• Переміщення — скануй → вибери склад → готово