Technická reference: Živé firmy

Datový model

Modul rozšiřuje entitu Lead o následující pole:

• companyName: Varchar, používá custom view pro našeptávač (využívá endpoint Ares/suggest).
• companySicCode: Varchar, trigger pro načtení dat. Custom view zive-firmy:views/lead/fields/company-sic-code.
• employeeInfo: JsonObject, ukládá historii zaměstnanců.
• turnoverInfo: JsonObject, ukládá historii obratu.

Logika načítání

Trigger: Změna hodnoty v poli companySicCode na klientovi.

1. JavaScript view company-sic-code.js detekuje změnu.
2. Odesílá GET request na ZiveFirmy/lookup/{sicCode}.
3. Backend (Api/ZiveFirmy.php) volá externí API https://api3.zivefirmy.cz/firmdata/.
4. Vrací data o obratu a zaměstnancích.
5. JavaScript uloží data do polí employeeInfo a turnoverInfo.

Závislosti

Modul implicitně počítá s existencí endpointu Ares/suggest pro našeptávání názvu firmy, ale pro samotné obohacení dat (zaměstnanci/obrat) stačí vyplnit IČO jakkoli.