The pool dossier — homeowner-owned, management-company viewed

The Pool module is a dual-context module that fixes a structural problem in residential pool maintenance: the pool service company keeps a service log, but the homeowner can't see it; the homeowner has chemical test results from the local pool store, but the service company doesn't see those either. Different systems, same pool.

The Pool dossier is one canonical record on the homeowner's Personal context (at /me/pool) that the service company gets a permissioned view into (at /pool in their org context). Adding a new service entry, recording a chemistry test, logging an equipment change — same action on either side, same record.

What lives on the dossier:

- **Pool basics** — gallons, surface type (plaster / fiberglass / vinyl), shape, salt or chlorine, filter type (cartridge / sand / DE), heater make/model, pump and skimmer details.
- **Equipment** — every piece of in-pool hardware (pump, filter, salt cell, automation, heater, robotic cleaner) with model number, install date, warranty expiry, maintenance schedule.
- **Chemistry log** — every test result (chlorine, pH, alkalinity, calcium hardness, cyanuric acid, salt for SWG pools). Trend chart shows you're on track or drifting. The platform computes the corrected-chemistry actions (e.g. "add 6 oz acid to bring pH from 7.8 to 7.4").
- **Service log** — every visit by a service company, every shock treatment, every filter clean, every chlorinator refill.
- **Photos** — proof of work, condition documentation, before/after for equipment changes.
- **Notes** — open text. The HOA fence repair, the kid's accidental over-chlorination, the time the pump motor went out.

For homeowners:

- Open /me/pool. Add a chemistry test result. Trend chart updates. Recommendations engine tells you what to do next.
- Click "Connect a service company" → invite your local pool service. They get a permissioned view.
- Move? The dossier moves with you. Cancel the service at the old house, connect the service at the new one.

For pool service companies:

- Open /pool in your org context. See every customer's pool. Click a pool → service it.
- Add a test result, log work performed, attach photos, charge for the service. The homeowner sees the entry in real time.

Why the data lives on the homeowner side:

The customer relationship belongs to the homeowner, not the service company. When the homeowner changes service company (it happens — service companies change owners, raise prices, lose technicians), the new service company picks up the dossier — they don't have to re-survey the equipment, re-baseline chemistry, or learn the pool's quirks from scratch. The homeowner can hand it off and keep going.

This is the same pattern as Property records following the property at closing (see [project_closings_module]) and athlete records following the athlete across teams (see [project_sports_module]). [[feedback_data_helps_user_not_counterparty]]

Pricing:

For homeowners, the Pool module on Personal context is free. For pool service companies, the per-pool listing is part of their Field Service module subscription — service entries flow into work orders, invoices, route optimization just like any other field-service work.