Property Lifecycle
The property lifecycle system manages properties from initial setup through tenancy transitions. It enforces business rules around property status, tenant management, and scheduled events.
Property Status Flow
┌─────────┐ ┌───────────────┐ ┌──────────────┐ ┌─────────────┐
│ Setup │───▶│ Commissioning │───▶│ Commissioned │───▶│ Pre-Tenancy │
└─────────┘ └───────────────┘ └──────────────┘ └─────────────┘
│
▼
┌───────────────────┐ ┌─────────┐ ┌───────────────────────────────┐
│ ScheduledMoveOut │◀───│ Tenancy │◀───│ ScheduledMoveIn │
└───────────────────┘ └─────────┘ └───────────────────────────────┘
│ ▲
└─────────────────────────────────────────────────────┘
(Cycle repeats)
Key Concepts
Vacant vs Occupied
Properties are classified as either:
- Vacant: Setup, Commissioning, Commissioned, Pre-Tenancy, ScheduledMoveIn, ScheduledMoveOut
- Occupied: Tenancy
This classification affects:
- Who can access the property
- What operations are permitted
- PIN code visibility rules
- Device control permissions
Scheduled Transitions
Move-in and move-out events are scheduled in advance:
- Move-In: Triggered at 6 AM on the scheduled date
- Move-Out: Triggered at 11 PM on the scheduled date
This allows for automated tenant transitions with proper handoff.
Role-Based Access
Different roles have different access at each lifecycle stage:
| Role | Vacant Properties | Occupied Properties |
|---|---|---|
| Admin | Full access | Full access |
| IT Admin | IT setup only | Read-only |
| Property Manager | Management + viewing access | Read-only |
| Installer | Installation tasks | No access |
| Tenant | N/A | Full resident access |
Documentation in This Section
- property-lifecycle.md - Status transitions and business rules
- move-in-move-out.md - Tenant transition automation
- admin-pm-roles.md - Portfolio and property manager operations