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/fileGET /v1/storage/assets/{assetId}/downloadGET /v1/assets/{assetId}DELETE /v1/assets/{assetId}GET /v1/assets/{parentType}/{parentId}POST /v1/assets/{parentType}/{parentId}PATCH /v1/assets/{parentType}/{parentId}/orderPOST /v1/leases/{leaseId}/handover-protocolsGET /v1/leases/{leaseId}/handover-protocolsGET /v1/handover-protocols/{protocolId}PUT /v1/handover-protocols/{protocolId}PATCH /v1/handover-protocols/{protocolId}/confirmPATCH /v1/handover-protocols/{protocolId}/declineDELETE /v1/handover-protocols/{protocolId}POST /v1/handover-protocols/{protocolId}/itemsPUT /v1/handover-items/{itemId}DELETE /v1/handover-items/{itemId}GET /v1/calendar-eventsPOST /v1/calendar-eventsGET /v1/calendar-events/{eventId}PUT /v1/calendar-events/{eventId}DELETE /v1/calendar-events/{eventId}GET /v1/audit-logsGET /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.