Feature Package PK-05 — Leasing & Rental
Status: Package Specification
Domain: Rentals / Tenancy
Maps to: Playbook (lease lifecycle)
External integration: ERPNext (rent invoices), payments
1. What This Package Does
Gives landlords and the leasing team one auditable system for tenancy — from lease signing through rent collection, deposit management, renewal, and move-out — replacing paper leases, manual rent tracking, and uncoordinated finance.
2. Features & Functionality
| Feature | What it does | Who uses it | What stands behind it |
|---|---|---|---|
| Lease agreement | Lease created with unit, tenant, rent, deposit, term, renewal terms; signatures recorded | Leasing manager, landlord, tenant | cns://claim/type/real-estate/lease; PoCE session |
| Tenant onboarding | Tenant identity verified (Keycloak); optional BBS+ selective disclosure | Leasing manager, tenant | cns://truth/node/person; Keycloak DID |
| Rent collection | Rent invoices generated per period; payment tracked; arrears flagged | Finance, landlord | ERPNext invoice mirror; payment reference on claim |
| Deposit management | Security deposit recorded at lease start; refund tracked at move-out | Finance, landlord | Deposit claim linked to lease; fn::poce::record_step |
| Lease renewal | Renewal proposed before expiry; new terms agreed; old lease archived | Leasing manager, tenant | Lease claim transition; PoCE record |
| Move-out inspection | Unit inspected at move-out; damages linked to deposit deductions | Inspector, landlord | Snagging/defect claim (PK-08); photo evidence |
| Tenant status | Tenant linked to unit via truth_edge; occupancy visible to HOA and property manager | Property manager, HOA | truth_edge:leases → resource:unit |
3. Workflow (Lease Lifecycle)
- Tenant selected → lease agreement drafted (unit, rent, deposit, term)
- Tenant signs →
fn::poce::record_step(signature); deposit paid - Lease active → tenant→unit
truth_edgebound; access rights granted (PK-09) - Monthly rent invoices → ERPNext; payments matched; arrears flagged
- Renewal proposed 60 days before expiry → new terms → sign → old lease archived
- Move-out: inspection, defect claims, deposit refund, tenant→unit edge released
- PoCE receipt issued for the full lease lifecycle
4. Guard Rails
- No lease without tenant identity verification
- No access rights without active lease
- Rent collection follows ERPNext fiscal rules; Sovereign owns lease state
- Deposit refund requires move-out inspection sign-off
- If payments are unavailable → fail closed; no fake payment records
5. Evidence & Audit
- Lease claim, tenant identity, deposit records, rent invoices, renewal records, move-out inspection, PoCE receipts