Feature Package PK-02 — Unit & Title Management
Status: Package Specification
Domain: Units / Registry / Legal
Maps to: Unit lifecycle (title transfer, ownership change, resale)
External integration: Land registry mirror, ERPNext
1. What This Package Does
Gives the registrar and property management office one auditable system for unit ownership — recording title transfers, ownership shares, voting rights, and the unit's relationship to the building and common areas — replacing paper title files and uncoordinated spreadsheets.
2. Features & Functionality
| Feature | What it does | Who uses it | What stands behind it |
|---|---|---|---|
| Unit registry | Each unit is a resource with number, block, floor, type, size, status | Registrar, property manager | cns://resource/unit; resource_edge unit→building |
| Ownership record | Owner linked to unit via truth_edge with ownership share and voting rights | Registrar, legal | truth_node:owner → truth_edge:owns → resource:unit |
| Title transfer | On resale, ownership edge is updated; previous owner archived, new owner bound | Legal, registrar | fn::poce::record_step (transfer evidence); integration_entity land registry mirror |
| Joint ownership | Multiple owners per unit with defined shares; voting rights weighted by share | Legal, HOA | Multiple truth_edge:owns edges to one unit |
| Occupancy status | Unit status (unsold, sold, occupied, leased, vacant) tracked and visible | Property manager, sales | resource status field; truth_edge occupant→unit |
| Title history | Complete append-only audit trail of ownership changes | Auditor, legal | PoCE receipt per transfer; claim.evidence array |
3. Workflow (Title Transfer on Resale)
- Seller and buyer agree resale → sale agreement claim (PK-01)
- Registrar verifies seller's current ownership edge
- Title transfer executed → new
truth_edge:owns(buyer→unit); old edge marked historical - Voting rights recalculated (share × unit entitlement)
- Land registry mirror updated; PoCE receipt issued
- HOA notified of new owner (voting eligibility, service-charge liability)
4. Guard Rails
- No title transfer without PoCE-recorded signatures
- No ownership edge without a valid sale/transfer claim
- Land registry remains the legal system of title; Sovereign mirrors and audits
- No synthetic owner or unit IDs
5. Evidence & Audit
- Unit registry record, ownership edges (current + historical), sale agreement, PoCE receipts, land registry mirror