A szerződés-form és -lista működése
A szerződés-form kártyái, a típusok és szerep-párok, a szerveroldali mentési szabályok, a szerződésszám, a deviza, a státusz, a lista és a végpontok.
A szerződés-form (contract/contract.form) egyetlen AJAX-mentéssel (contract/contract.save) írja a szerződés fejét, leírását, feleit, személyeit, felmondási okait és közvetítési sorait; a form helyben marad, az új azonosító visszaíródik.
A form kártyái
| Kártya | Tartalom |
|---|---|
| Ügyfél cég (bal, 40 %) | client-választó (csak tartalmi joggal elérhető), adószám, cím, bankszámla (8-8-8), a client személyei |
| Szerződő felek (jobb, 60 %) | fő partner és további felek azonos kártya-makróval; személyek szerepkörrel |
| Szerződés fejléce | státusz, főtípus, altípus, irány, szerződésszám (élő előnézet: peeknumber), date_signed, deviza, sablon + nyelv, megjegyzés |
| Időtartam, megújítás, felmondás | kezdet, vég, duration_type (fixed, open, project, until_task), megújítás, automatikus megszűnés, rendes felmondás, felmondási idő és határidő, teljesítésigazolás, lejárati tájékoztató napjai és pontja |
| Azonnali hatályú felmondási okok | okok a törzsből, saját pontszámmal és egyedi szöveggel |
| A szerződés szövege | nyelvi fülek: cím, leírás, teljes szöveg (HTML-szerkesztő), „Betöltés a sablonból” |
| Árazás és elszámolás | árforma, elszámolási mód (single, multiple, recurring), időszak, fizetés módja és határideje, árfolyam-módszer, számlázási gyakoriság, automatikus számlázás |
| Kapcsolt számlák | a szerződés számlái, keresés és hozzákötés |
| Bérelt ingatlan és költségtovábbhárítás | bérleti szerződésnél az ingatlan, továbbszámlázás (vázlat vagy élő), felár % |
| Ingatlanközvetítés | közvetítendő ingatlanok |
| Szerződés-műveletek, Digitális aláírás | AJAX-kártyák (contract/contractaction.block, contract/esign.block) |
| Mellékletek | a szerződéshez kötött dokumentumtár-iratok, feltöltés, leválasztás |
| Költségvetési tételek, Fázisok | tételek (termék, szolgáltatás, ingatlan; egységár, mennyiség, áfa, opcionális) és ütemek |
Típusok és szerepek
Főtípusok: mandate, works, employment, lease, sale. Altípusok: mandate alatt real_estate_brokerage, accounting, site_supervision, controlling; lease alatt vehicle_lease, property_lease, equipment_lease; sale alatt property_sale, business_share_sale. Szerep-párok (eladó oldal és vevő oldal): megbízott és megbízó, vállalkozó és megrendelő, bérbeadó és bérlő, munkavállaló és munkáltató, eladó és vevő. A contract_parties.role értékkészlete: customer, supplier, principal, agent, orderer, employer, contractor, employee, lessor, lessee, contributor.
Mentési szabályok
- Jog:
canSave(contract/contract, id); a client a user tartalmi hatókörében legyen. - Kötelező a client és a tárgy; a magyar cím kötelező, és bármely idegen nyelvű szöveg esetén a magyar szöveg is.
date_signed: érvényes dátum, nem jövőbeli; digitális elfogadásnál a rendszer tölti ki, ha üres.- Közvetítendő ingatlan: jutalék 0–100 %, hosszú bérlet hónapja 0–120, a sor vége nem lehet a kezdete előtt; ingatlan nélküli sor hibát ad a sor számával.
- A szerződéses érték és a nem opcionális tételek (egységár × tervezett mennyiség) összege ±0,01 pontossággal egyezzen, ha a fej értéke értelmezhető.
- Szerepkör-korlát felenként; hiányzó elvárt szerep és aláírási jog nélküli aláíró: figyelmeztetés.
- Azonnali felmondási ok: újonnan csak aktív, a fő- és altípusra vonatkozó ok; pontszám legfeljebb 32 karakter.
- Meghatalmazás hiánya, ha a megbízó nem az ingatlan tulajdonosa: figyelmeztetés.
- Siker csak visszaolvasott rekordra; utána személyek, okok, közvetítési sorok, adatszoba-szinkron (
grantaccessjoggal), opcionálisan PDF-generálás (generatejoggal).
Szerződésszám: client + előtag + év szerinti legnagyobb sorszám + 1, négy jegyre töltve; meglévő számot nem ír át.
Deviza és státusz
A deviza a pénznem-törzsből jön (currency_code, currency_value). Pénzösszeg a dokumentumban: forintnál egész, devizánál két tizedes. Az fxrecalc a szerződés szerint számolja újra a számlák árfolyamát (előnézet és végrehajtás; lezárt időszak számláit kihagyja). Státusz: 0 inaktív, 1 aktív, 9 törölt (kuka, csak a végleges törlés jogosultja és a super admin látja). A felmondás a megszűnés napján inaktivál.
Háttérfeladatok
A contract_passthrough_scan feladat kb. 2 percenként figyeli a bérleti költség-továbbszámlázást, és a contract_passthrough feladatot sorolja be, amely továbbszámlázó piszkozat-számlát készít.
Végpontok és jogok
| Végpont | Jog |
|---|---|
contract/contract, .list | list |
.form | edit |
.save | add vagy edit + scope |
.peeknumber | edit + scope |
.enable, .disable | edit |
.delete | delete + scope; előtte a szerződés adatszoba-jogai visszavételre kerülnek |
.invoices, .invoicesearch, .invoicelink | list vagy edit + scope |
.fxrecalc | fxrecalc + scope |
.docs, .docupload, .docunlink | list vagy edit + scope |
.templatepreview, .generate | generate |
A statusdelete, certify, export és invoice kulcs a katalógusban szerepel, de a controller nem ellenőrzi.