`README.md`

69 lines
# stayclaim

Address-first property-history platform. Pivoted from the original
"Airbnb listing claim" concept after the deep research in
[docs/deep-research-report.md](docs/deep-research-report.md).

## The pivot in one line

We are **not** building a current-occupancy / stalking database.
We are building a **place-first, time-aware property history product**
with privacy guardrails — then selling the claim-and-customize
upgrade on top of those public records.

## Product model

| Tier     | Who sees it       | What they get                                                 |
|----------|-------------------|---------------------------------------------------------------|
| Free     | anyone            | Auto-generated page: place record, parcel history, archival   |
|          |                   | media, permit events, verified historical associations.       |
| Basic    | claimed owner     | $9.99/mo — photos, contact info, custom copy, hosting,        |
|          |                   | email-verified edits, rental projections.                     |
| Pro      | claimed owner     | TBD — custom domain, booking integration, API access.         |

## Privacy guardrails (hard rules from the research)

- No current celebrity home addresses
- No inference-based current occupancy claims
- All human/business associations are stored as **claims** with
  `date_range` + `source_tier`, never as eternal truths
- Source classes: A govt · B archive · C verified secondary · D social/lead

## Why we don't use a standard rent multiplier

See [docs/rent-multiplier-1978-1984.md](docs/rent-multiplier-1978-1984.md).

The rental projection for every address is derived from the observed
1978-1984 LA County price + rent trajectory — the fastest
rate-of-change event in post-war LA housing. No canned CPI, no flat 3%.
Every number carries its source tier on display.

## Stack

- Next.js 14 + TypeScript + Tailwind
- PostgreSQL + **PostGIS** (parcel geometry from day one)
- OpenSearch/Elasticsearch for address + alt-spelling search (later)
- Object storage for scanned maps / archival photos (later)
- Stripe for the $9.99 tier (pending RAK)

## Pilot geography

Beverly Hills. Matches the research report's recommendation — small,
well-documented, strong archival support, public permits updated nightly.

## Ports

- Dev: http://localhost:9820
- DB:  `stayclaim` on local Postgres

## Status (2026-04-24)

- [x] DB schema drafted (free listing tier, claim flow, upgrade table)
- [x] 4 seed listings for UI dev
- [ ] Place/parcel/structure/event/occupancy split per research report
- [ ] PostGIS + parcel ingestion from LA County Assessor
- [ ] Beverly Hills permit data pipeline
- [ ] 1978-1984 multiplier data ingest + curve fit
- [ ] Claim email-verification flow
- [ ] Stripe — waiting on RAK