Dokument-Endpunkte einer Immobilie und das Hauptbild
Die Dokumentliste, Upload-Prüfungen und Ablageweg, das Lösen, die Verknüpfung vorhandener Dokumente mit Rollenregeln und das Festlegen des Hauptbilds.
Dokumente einer Immobilie sind über die Beziehung der Dokumentenzentrale verknüpft (doc_link, object_type = property); die Ablage läuft über den zentralen Weg der Dokumentenzentrale. Jede Dokumentaktion verlangt den Inhaltsbereich für die Firma des Dokuments.
Liste
docs (Recht list, GET property_id): document/document::getDocsForObject('property', id), nur Dokumente von Firmen im Inhaltsbereich des Benutzers. Ein Dokument mit Rolle aus Dlbtproperty::DOC_ROLES kommt an seinen Platz, andere Bilder in die Galerie, andere Nicht-Bilder zu „Other documents“. Das Hauptbild (cover_doc_id) steht vorn. Jedes Element hat eine Öffnen-URL (document/document.preview), Bilder Vorschau-URLs (480, 960, 2048 px), mit edit eine Lösen-URL.
Upload
docupload(edit; POSTproperty_id,doc_role,file), eine Anfrage je Datei, vom Client nacheinander gesendet.- Prüfungen: ungespeicherte Immobilie; unbekannte Rolle (
DOC_ROLES+photo+attachment); leerer POST (post_max_size); fehlerhafte Datei; weder Eigentümer noch Betreiber; Eigentümerfirma des Dokuments außerhalb des Bereichs; beiphotokein Bild (jpg, jpeg, png, gif, webp). - Ablage:
Dlbtdocstore::addDocument()(Dateiname auf ASCII normalisiert,company_id= Eigentümer, sonst Betreiber,object_type = property,doc_role); Zurücklesen mitgetDoc(); Erfolg: „Document uploaded.“.
Dokumentrollen: safety_report, energy_certificate, land_registry, floor_plan, attachment sowie photo.
Lösen und Verknüpfen
docunlink(edit): nur für ein vorhandenes, mit der Immobilie verknüpftes Dokument mit Firma im Bereich;deleteDocLink(), das Dokument bleibt.- Verknüpfen eines vorhandenen Dokuments (
edit, bei mehrerenbulkedit): Suche überdocument/folders.docsearch&ctx=property(mindestens 2 Zeichen), Verknüpfung überdocument/document.addlink&ctx=propertymit der Rolle des Platzes. Rollenregel:photonur für Bilder (andere Dateien alsattachment), und nur ein Dokument mit leerer, allgemeiner oder Immobilienrolle wird umgestuft. - Im Kopf der Dokumentliste gibt es die Massenschaltfläche „Der Immobilie zuordnen“: sie erfordert das Etikettierungsrecht und das Recht
listder Immobilie.
Hauptbild
cover (edit; GET property_id, doc_id; doc_id = 0 entfernt): nur ein mit der Immobilie verknüpftes Bild im Bereich. Ohne Migration 20261031_008 ein aussagekräftiger Fehler; bei Rücklese-Abweichung „The main image was not saved (read-back mismatch).“. Bei cover_doc_id = 0 ist das erste Galeriebild das Titelbild. Die Galerie zeigt standardmäßig 12 Bilder; ein Bild öffnet sich im gemeinsamen Viewer (pdf.js für PDF, falls installiert).
Datenraum
Der Datenraum zeigt Hauptbild, Galerie und — nur im freigegebenen Ordner des Benutzers — die Dokumente (getPropertyForView(): aktive, dem aktuellen Shop zugeordnete Immobilie).