Az ingatlan dokumentum-végpontjai és a fő kép
A dokumentumlista, a feltöltés ellenőrzései és tárolási útja, a leválasztás, a meglévő dokumentum hivatkozása a szerep-szabályokkal, valamint a fő kép beállítása.
Az ingatlan iratai a dokumentumtár kapcsolatán (doc_link, object_type = property) át kötődnek; a tárolás a dokumentumtár központi útján történik. Minden dokumentum-művelet a dokumentum cégére tartalmi jogot kér.
Lista
docs (list jog, GET property_id): document/document::getDocsForObject('property', id), csak a user tartalmi jogába eső cég dokumentumai. A Dlbtproperty::DOC_ROLES szerepű irat a helyére, a többi kép a galériába, a többi nem-kép az „Other documents” helyre. A fő kép (cover_doc_id) áll elöl. Minden elemhez megnyitó URL (document/document.preview), képnél bélyegkép-URL-ek (480, 960, 2048 px), edit joggal leválasztó URL.
Feltöltés
docupload(edit; POSTproperty_id,doc_role,file), fájlonként egy kérés, a kliens sorban küldi.- Ellenőrzések: mentetlen ingatlan; ismeretlen szerep (
DOC_ROLES+photo+attachment); üres POST (post_max_size); hibás fájl; nincs tulajdonos és üzemeltető; a dokumentum-gazda cég a hatókörön kívül;photoszerepnél nem kép (jpg, jpeg, png, gif, webp). - Tárolás:
Dlbtdocstore::addDocument()(ASCII-re normalizált fájlnév,company_id= tulajdonos, ennek híján üzemeltető,object_type = property,doc_role); visszaolvasásgetDoc()-kal; siker: „Document uploaded.”.
Dokumentum-szerepek: safety_report, energy_certificate, land_registry, floor_plan, attachment, valamint photo.
Leválasztás és hivatkozás
docunlink(edit): csak létező, az ingatlanhoz kötött, hatókörön belüli cégű dokumentumra;deleteDocLink(), a dokumentum megmarad.- Meglévő dokumentum hivatkozása (
edit, több dokumentumnálbulkedit): keresés adocument/folders.docsearch&ctx=propertyvégponton (legalább 2 karakter), kötés adocument/document.addlink&ctx=propertyvégponton a hely szerepével. Szerep-szabály:photocsak képre kerül (más fájlattachment-ként), és csak üres, általános vagy ingatlan-szerepű dokumentum minősül át. - A Dokumentumok lista fejlécén „Ingatlanhoz rendelés” csoportos gomb: a címkézési jog és az ingatlan
listjoga kell hozzá.
Fő kép
cover (edit; GET property_id, doc_id; doc_id = 0 levétel): csak az ingatlanhoz kötött, hatókörön belüli kép. Migráció (20261031_008) nélkül beszédes hiba; visszaolvasás-eltérésnél „The main image was not saved (read-back mismatch).”. A cover_doc_id = 0 esetén a galéria első képe a borító. A galéria alapból 12 képet mutat; a kép a közös nézegetőben nyílik (PDF-hez pdf.js, ha telepítve van).
Adatszoba
Az adatszoba a fő képet, a galériát és — csak a user megosztott mappáján belül — a dokumentumokat mutatja (getPropertyForView(): aktív, az aktuális áruházhoz rendelt ingatlan).