Skip to content

Assets, Handovers, Calendar, And Audit

Last audited: 2026-06-26.

Current Screens

Assets/documents:

  • /property/[propertyId]/leases/[leaseId]/documents
  • asset surfaces embedded in property, lease, payment receipt, and handover flows

Handovers:

  • /property/[propertyId]/leases/[leaseId]/handovers
  • /property/[propertyId]/leases/[leaseId]/handovers/create
  • /property/[propertyId]/leases/[leaseId]/handovers/[protocolId]
  • /property/[propertyId]/leases/[leaseId]/handovers/[protocolId]/edit
  • /property/[propertyId]/leases/[leaseId]/handovers/[protocolId]/items/create
  • /property/[propertyId]/leases/[leaseId]/handovers/[protocolId]/items/[itemId]
  • /handover/[protocolId]

Calendar:

  • /calendar
  • /calendar/create
  • /calendar/[eventId]
  • /calendar/[eventId]/edit

Audit:

  • /audit-logs
  • /property/[propertyId]/audit-logs

Current Behavior

Asset flows support upload through /storage/uploads/file, attaching uploaded files to parent entities, listing by parent, detail lookup, download, delete, copy, and reorder. Lease document screens use asset hooks; receipts also reuse assets for uploaded files.

Handover flows cover protocol list/detail/create/edit/delete, item create/edit/delete, confirm/decline, and previous move-out protocol lookup for comparison. The property-details closeout widget uses handover state to block move-out until move-in is resolved, can duplicate a move-out protocol from the confirmed move-in protocol, and exposes owner-only creation while tenants review/confirm or decline pending protocols. Settlement actions open final-settlement details directly; the former standalone overview only redirects old links. Integration QA on 2026-06-26 verified owner-created move-in with one item, tenant confirmation, duplicated move-out, tenant confirmation, and subsequent settlement completion.

Calendar flows cover event list/filtering, event detail, create, update, and delete.

Audit flows cover full activity, current user's activity, contextual filtering, and property-message audit lookup through chat-message history.

Current Backend Touchpoints

  • POST /v1/storage/uploads/file
  • GET /v1/storage/assets/{assetId}/download
  • GET /v1/assets/{assetId}
  • DELETE /v1/assets/{assetId}
  • GET /v1/assets/{parentType}/{parentId}
  • POST /v1/assets/{parentType}/{parentId}
  • PATCH /v1/assets/{parentType}/{parentId}/order
  • POST /v1/leases/{leaseId}/handover-protocols
  • GET /v1/leases/{leaseId}/handover-protocols
  • GET /v1/handover-protocols/{protocolId}
  • PUT /v1/handover-protocols/{protocolId}
  • PATCH /v1/handover-protocols/{protocolId}/confirm
  • PATCH /v1/handover-protocols/{protocolId}/decline
  • DELETE /v1/handover-protocols/{protocolId}
  • POST /v1/handover-protocols/{protocolId}/items
  • PUT /v1/handover-items/{itemId}
  • DELETE /v1/handover-items/{itemId}
  • GET /v1/calendar-events
  • POST /v1/calendar-events
  • GET /v1/calendar-events/{eventId}
  • PUT /v1/calendar-events/{eventId}
  • DELETE /v1/calendar-events/{eventId}
  • GET /v1/audit-logs
  • GET /v1/audit-logs/my-activity

What To Check

  • Asset parent type and parent id when uploads succeed but files do not appear.
  • S3/storage errors when download links fail.
  • Handover protocol status when confirmation/decline actions are unavailable.
  • Closeout board milestone state when move-out or settlement actions are disabled; move-out requires resolved move-in unless a settlement already exists, and settlement confirmation waits for pending protocols to resolve.
  • Calendar filters when events are missing from the list.
  • Audit log entity filters when history appears incomplete.