Dependency-light JSON API for a single demo tenant (demo-tenant). Core domain rules use only Python's standard library; persistence is SQLite. This MVP stores prospect evidence and scores, but never sends outreach.

Run

From this directory:

python3 app/main.py
# listens on http://127.0.0.1:8000
python3 -m unittest discover

Set PROSPECT_API_PORT or pass --port; set PROSPECT_API_DB or pass --db to override the default prospects.db.

Endpoints

GET /api/v1/health/live — liveness.
GET /api/v1/dashboard/summary — tenant-scoped counts and score average.
GET /api/v1/businesses — list businesses; optional ?q= filter.
POST /api/v1/businesses — create a business from JSON (name required; website, email, phone, description optional). Normalization, scoring, deduplication, and suppression are enforced server-side.
GET /api/v1/businesses/{id} — retrieve one tenant-scoped business.
POST /api/v1/suppressions — add {kind: email|domain|phone, value: ...}. Future matching business creation is blocked.
POST /api/v1/imports/preview — preview {rows: [...]} without writing; reports accepted, duplicates, suppressed, normalized rows.

All SQL uses parameters and all responses are JSON. Scores include score_version and score_factors for traceability. There is intentionally no send/outreach endpoint.