Feature Package PK-10 — Resale & Secondary Market
Status: Package Specification
Domain: Resale / Secondary Market / Legal
Maps to: Playbook (resale agreement lifecycle)
External integration: ERPNext, land registry mirror, PK-01/PK-02
1. What This Package Does
Gives owners and resale agents one auditable system for reselling units — listing, buyer matching, sale agreement, title transfer, and service-charge clearance — replacing informal resale arrangements, unrecorded agreements, and unclear outstanding-charge status.
2. Features & Functionality
| Feature | What it does | Who uses it | What stands behind it |
|---|---|---|---|
| Resale listing | Owner lists unit for resale with asking price; listing visible to resale agents | Owner, resale agent | cns://claim/type/real-estate/sale with resale_listed trait |
| Service-charge clearance | Before resale, outstanding service charges must be settled; clearance certificate issued | HOA treasurer, legal | PK-07 charge claims; clearance = fn::poce::record_step |
| Resale agreement | Buyer and seller sign resale agreement; price, payment schedule, handover date | Resale agent, legal, buyer, seller | cns://claim/type/real-estate/sale with resale_confirmed trait |
| Title transfer | Ownership edge updated (seller→buyer); land registry mirror updated | Legal, registrar | PK-02 title transfer; integration_entity land registry |
| HOA notification | New owner added to HOA; voting rights and service-charge liability activated | HOA secretary | Ownership edge (PK-02); governance rights (PK-03) |
| Buyer identity | Buyer verified; optional BBS+ selective disclosure | Resale agent, legal | cns://truth/node/person; Keycloak DID |
3. Workflow (Resale Lifecycle)
- Owner lists unit → resale listing claim created
- Buyer found → resale agreement drafted (price, schedule, handover)
- Service-charge clearance check → outstanding charges must be settled (PK-07 gate)
- Both parties sign →
fn::poce::record_step(signatures) - Payments recorded → ERPNext invoice mirror
- Title transferred → ownership edge updated; land registry mirror
- HOA notified → new owner voting rights and service-charge liability active
- Handover → unit status updated; PoCE receipt issued
4. Guard Rails
- No resale without service-charge clearance (no selling with arrears)
- No title transfer without buyer identity verification and signatures
- No HOA rights activated until title transfer recorded
- Land registry owns title law; Sovereign owns operational state
- If ERPNext or land registry mirror is unavailable → fail closed
5. Evidence & Audit
- Resale listing, sale agreement, clearance certificate, payment records, title transfer, land registry mirror, HOA notification, PoCE receipts