Перейти до змісту

Essentials — базовий модуль DOP

Коротко: Essentials — горизонтальний базовий модуль DOP, який містить довідники, документи та регістри, необхідні для будь-якого бізнесу. Усі інші модулі (Fleet, CRM, ContainerHub, Logistic тощо) побудовані поверх Essentials.

1. Підсистеми Essentials

Структура відповідає типам об'єктів у DOP App (ItemType): Master Data → Transaction Data → Report → Process.

Концепція

Документ Опис
inventory-finance Резонанс: рух ТМЦ ↔ фінанси (ядро Essentials)

Master Data (довідники)

Партнери та договори | Документ | Опис | |----------|------| | partners | Client, Organization, Person, Department, BusinessDirection, BusinessRegion | | contracts | Contract + ContractSpecification |

Номенклатура та ціни | Документ | Опис | |----------|------| | nomenclature | Item, ItemComponent, Unit, ExpenseItem | | prices | PriceType, цінові шкали, знижки | | batches | Batch, BatchStatus, ValuationMethod (FIFO/WAC/Serial) |

Фінанси | Документ | Опис | |----------|------| | finance-accounts | Cashbox, Bank, SettlementAccount, TaxRate | | currency | Currency, ExchangeRate, ExchangeRateSource (dual-currency) |

Облікова конфігурація | Документ | Опис | |----------|------| | accounting-setup | ChartOfAccounts + BusinessOperation — мапінг подій → проводок | | document-operations | DocumentOperation — універсальний бухгалтерський документ | | vat | Ставки, режим, ПН-документи |

Documents (транзакції)

Закупки | Документ | Опис | |----------|------| | goods-receipt | Приймання товарів, створення Batch | | purchase-invoice | Рахунок постачальника + 3-way matching + AdditionalExpense |

Продаж | Документ | Опис | |----------|------| | sales-invoice | Invoice + GoodsShipment + eTTN |

Склад | Документ | Опис | |----------|------| | writeoffs | GoodsWriteoff — списання, нестача, брак |

Казначейство | Документ | Опис | |----------|------| | payments | IncomingPayment, OutgoingPayment, Payment Calendar | | cash-transfer | CashTransfer — переказ між власними рахунками (cashbox/settlement) | | bank-reconciliation | BankStatement — імпорт виписок (mt940/iso20022/Privat/Mono), Kanban, auto-match ✅ shipped 2026-05-10 |

Processes (бізнес-процеси)

Документ Опис
quality-control Контроль якості на прийманні (підмодуль essentials_quality)
month-closing Закриття місяця — послідовний ідемпотентний wizard (амортизація, FX-переоцінка, lock-date)

Reports (звіти)

Документ Опис
cashflow-reports P&L, Balance Sheet, Cash Flow, Payment Calendar

2. Структура за функціональними групами

Master Data (довідники)

Дані, які рідко змінюються і використовуються у документах:

  • Номенклатура: Item, ItemComponent, Unit, ExpenseItem, PriceType
  • Партнери: Client, ClientResponsiblePerson, Organization, Person, Department, BusinessDirection, BusinessRegion
  • Договори: Contract, ContractSpecification
  • Фінансова інфраструктура: Cashbox, Bank, SettlementAccount, TaxRate, BankMatchingRule
  • Валюти: Currency, ExchangeRate, ExchangeRateSource
  • Бухгалтерія: ChartOfAccounts, BusinessOperation
  • Склад: Warehouse, Batch, BatchStatus, ValuationMethod, ItemWarehouseStock

Transactions (документи)

  • Закупки: PurchaseOrder, GoodsReceipt, PurchaseInvoice, AdditionalExpense
  • Продаж: Invoice, GoodsShipment
  • Платежі: IncomingPayment, OutgoingPayment, PlannedPayment, CashTransfer, BankStatement+BankStatementLine
  • Списання: GoodsWriteoff
  • Універсальні: DocumentOperation

Registers (регістри)

  • Journals: CashJournal, InventoryJournal, IncomeExpenseJournal, PlannedPaymentJournal
  • Ledgers: CashLedger, InventoryLedger, ClientLedger, SupplierLedger
  • Audit: Posting, StockTransaction

3. Архітектурна роль

Essentials — горизонтальний модуль, бо:

  • Його довідники (товари, контрагенти, валюти) потрібні у будь-якій галузі.
  • Його документи (накладні, платежі) — універсальна основа документообігу.
  • Його регістри — база для будь-якого звіту (касовий потік, залишки, P&L).

Вертикальні модулі (Fleet, ContainerHub, Logistic — Multimodal Freight & Forwarding) використовують Essentials як фундамент і додають галузеву специфіку.

4. Бізнес-цикли

Цикл закупок (Purchase-to-Pay)

Contract → PurchaseOrder → GoodsReceipt → PurchaseInvoice → OutgoingPayment
Деталі: goods-receipt, purchase-invoice, payments.

Цикл продажу (Order-to-Cash)

CRM Lead → Quotation → Invoice → IncomingPayment → GoodsShipment → eTTN
Деталі: sales-invoice, payments, eTTN.

Складський цикл

GoodsReceipt → Batch (FIFO/WAC) → InventoryLedger → GoodsShipment / GoodsWriteoff
Деталі: batches, inventory-finance, writeoffs.

Бухгалтерський цикл

Document.post() → BusinessOperation → Posting → Journals → Reports
Деталі: accounting-setup, document-operations, cashflow-reports.

5. Код

  • Backend: backend/essentials/ (~42 моделі)
  • Frontend config: frontend/erp/src/config/essentials.ts (1714 рядків)
  • Frontend components: frontend/erp/src/components/Essentials/

6. Розширення Essentials

Розширення Тип Статус Документ
Quality Control підмодуль (essentials_quality) ✅ quality-control
Purchase Invoices (advanced) підмодуль ✅ purchase-invoice
Bank Exchange інтеграція ⚠️ частково bank-exchange
M.E.Doc інтеграція ✅ medoc
eTTN інтеграція ✅ ettn

Пов'язане