How does the 30-day tenant portal grace period work after move-out?

When a tenant moves out, their portal users don't lose access immediately. The platform provides a 30-day grace period so tenants can wrap up their affairs.

What the grace period allows

During the 30 days after the move_out_date on the tenant record, portal users can still:

• Log in to the Tenant Portal
• View and download past invoices
• Access consumption history and reports
• Read and acknowledge building documents
• View any outstanding communications

How it works technically

When a tenant portal user tries to log in, the system checks:

• Is the tenant user's is_active = true?
• Does the parent tenant have a move_out_date?
• If yes, is the move_out_date within the last 30 days?

If move_out_date is NULL or within 30 days → login allowed.
If move_out_date is more than 30 days ago → login blocked.

What happens after 30 days

The Occupancy Worker (runs hourly) automatically finds all tenant users whose parent tenant moved out more than 30 days ago and deactivates them:

• is_active is set to false
• status changes to "inactive"
• deactivated_at timestamp is recorded
• The user sees an "access expired" message on next login attempt

Can access be restored?

Yes, but only manually by an account administrator. Go to Tenant Hub → Portal Users → find the deactivated user → click Reactivate. This:

• Sets is_active back to true
• Sets status to "invited"
• Clears deactivated_at
• Sends a new invitation email

Use case for reactivation: If a tenant is re-leasing a unit, or if there's an ongoing billing dispute that requires portal access for document review.

Note: The 30-day period is calculated from the tenant's move_out_date, not from the tenant_locals move_out_date. If a tenant has multiple locals with different move-out dates, the tenant-level move_out_date controls portal access.