Feature Package PK-08 — Construction & Snagging (Handover)
Status: Package Specification
Domain: Construction / Handover / Quality
Maps to: Process 2 (Task Lists & Checklists), Process 8 (Asset Maintenance)
External integration: MinIO (evidence photos), OpenMAINT (contractor work orders)
1. What This Package Does
Gives the project team and snagging inspectors one auditable system for construction quality and handover — tracking defects/snags per unit, assigning contractors, recording evidence, and certifying handover — replacing photo logs on phones, email threads, and unsigned handover forms.
2. Features & Functionality
| Feature | What it does | Who uses it | What stands behind it |
|---|---|---|---|
| Defect / snag reporting | Inspector or resident logs a defect (unit or common area) with photo, severity, location | Inspector, resident, project manager | cns://claim/type/real-estate/defect; photo hash in claim.evidence; MinIO |
| Snag list per unit | All defects for a unit grouped into a snag list; status tracked to closure | Project manager, snagging inspector | Multiple claim:defect edges to one resource:unit |
| Contractor assignment | Defect assigned to responsible contractor (builder, plumber, electrician) | Project manager | truth_edge:assigned_to → truth_node:contractor |
| Evidence pack | Before/after photos, measurements, certificates attached to each defect | Inspector, contractor | MinIO; SHA-256 on claim.evidence |
| Handover gate | Unit cannot be handed over until all snags cleared and signed off | Project manager, legal | Cross-package gate (PK-01 sale handover) |
| Defect closure | Contractor marks complete; inspector verifies; expert sign-off | Contractor, inspector | fn::poce::record_step; SoD (inspector ≠ contractor) |
| Warranty tracking | Defects within defect-liability period tracked; re-opened if recurring | Project manager | Defect claim traits (warranty_period, reopened); SLA |
3. Workflow (Snag to Handover)
- Unit completed → snagging inspection scheduled
- Inspector logs defects with photos → defect claims bound to unit
- Defects assigned to contractors → work orders (OpenMAINT) created
- Contractors fix defects, upload completion photos
- Inspector verifies fixes; signs off (SoD: inspector ≠ contractor)
- All snags cleared → unit →
READY_FOR_HANDOVER - Handover released (PK-01); defect claims archived with warranty tracking
- PoCE receipt for the full snag-to-handover lifecycle
4. Guard Rails
- No handover while any snag task is
OPEN - No auto-close without expert sign-off (inspector ≠ contractor)
- No defect without photo evidence (SHA-256)
- No synthetic contractor IDs
- OpenMAINT owns asset spec; Sovereign owns defect state and sign-off
5. Evidence & Audit
- Defect claims, photo hashes, work-order refs, contractor records, inspector sign-offs, handover gate records, PoCE receipts