Партнери та організаційні довідники¶

Хто з ким працює: контрагенти (зовнішні), організації (внутрішні), фізособи, підрозділи.

1. Основні сутності¶

Модель	Призначення
`Client`	Зовнішній контрагент (клієнт, постачальник, перевізник)
`ClientResponsiblePerson`	Контактна особа на стороні клієнта
`Organization`	Внутрішня юридична особа (multi-legal структура)
`Person`	Фізична особа (працівник, менеджер, водій)
`Department`	Підрозділ організації
`BusinessDirection`	Напрям діяльності (оптова / роздріб / послуги)
`BusinessRegion`	Географічний регіон обліку

2. Client — контрагент¶

code / name / full_name
edrpou / inn — код ЄДРПОУ / податковий номер
client_type — enum: company, individual_entrepreneur, individual, non_resident
is_vat_payer — чи платник ПДВ
legal_address / actual_address
phone / email / website
bank_requisites — реквізити (може бути кілька через ClientBankAccount)
manager → Person (закріплений менеджер, використовується у Sales Field)
role_tags — [client, supplier, carrier] (один контрагент може мати кілька ролей)
credit_limit / payment_days — умови кредиту

ClientResponsiblePerson¶

last_name, first_name, middle_name
position, phone, email
is_signatory (підписант документів)

3. Organization — власна юрособа¶

Для холдингів з кількома ЮО: - code / name / full_name - edrpou / inn - legal_address - bank_accounts → SettlementAccount - head / accountant → Person (підписанти документів) - is_vat_payer - tax_regime — enum: general, simplified_group_3, etc. - base_currency → Currency (функціональна валюта)

Multi-tenancy працює на рівні Tenant, але всередині одного tenant'а можна мати кілька Organization (групи компаній).

4. Person — фізична особа¶

Уніфікований довідник людей (незалежно від ролі): - Користувач системи (User.person) - Водій (Driver.person у Fleet) - Менеджер клієнта (Client.manager) - Підписант документів (Organization.head)

Поля: - last_name / first_name / middle_name - birth_date - inn / passport - phone / email - photo

5. Department — підрозділ¶

Ієрархічний довідник:

ТОВ "Ромашка"
├── Офіс
│   ├── Адміністрація
│   └── Бухгалтерія
├── Склад
└── Транспортний відділ
    ├── Диспетчери
    └── Водії

Використання: - Розподіл собівартості / витрат - Фільтри у звітах - Аналітика зарплати (HRM & Payroll)

6. BusinessDirection & BusinessRegion¶

Аналітичні виміри (не обов'язкові): - BusinessDirection — напрям (опт / роздріб / послуги / транспорт) - BusinessRegion — регіон (Київ / Львів / Одеса)

Підставляються у документах і агрегуються у звітах (альтернатива 1С-субконто).

🔮 Deferred / Ideas¶

Мотивація: ЄС/UA закон про захист персональних даних Чому відкладено: потрібен аудит-лог доступу до PII Trigger: вихід на EU-ринок

Автоматична дедуплікація Client за EDRPOU¶

Мотивація: менеджери створюють дублі при швидкому введенні Чому відкладено: потрібен UI для злиття дублів Trigger: коли БД клієнтів перевищить 5k

Автоматичне підтягування реквізитів з державного реєстру¶

Мотивація: ввести EDRPOU → автоматично підтягнути name, address, tax status Чому відкладено: платний API, потрібна інтеграція Trigger: запит клієнта + бюджет на API