# Super Search for Business

> **Product codename:** IntelSight (pending brand confirmation)
> **Status:** Specification & Architecture — pre-MVP
> **Started:** July 25, 2026

Multi-tenant competitive intelligence and OSINT search platform sold as SaaS. Companies subscribe for continuous visibility into competitors, customer sentiment, market trends, and public records intelligence.

---

## Architecture

See [`docs/super-search-business-architecture.html`](docs/super-search-business-architecture.html) for the full visual diagram.

### Stack

| Layer | Technology | Status |
|-------|-----------|--------|
| Search Engine | Super Search v2 (FastMCP, 7 providers) | ✅ Built |
| OSINT Enrichment | osint-person MCP server | ✅ Built |
| API Gateway | Caddy reverse proxy | ✅ Running |
| Portal Frontend | React + TypeScript | 🔨 To build |
| REST API | FastAPI wrapping MCP tools | 🔨 To build |
| Multi-tenant DB | PostgreSQL | 🔨 To build |
| Auth | OAuth/SSO (pattern from Ops Portal) | 🔨 Adapt |
| Billing | Stripe subscriptions | 🔨 Integrate |
| Reports | Markdown → PDF (pandoc/weasyprint) | 🔨 To build |
| Scheduler | Hermes cron → report generation | 🔨 Configure |

### Providers (Super Search v2)

SearXNG → Exa → OpenCorporates → CourtListener → DuckDuckGo → Wikipedia → Firecrawl

All with circuit breakers, health checks, and fallback chains. Additional: Browserless Chrome for screenshots.

---

## Deployment

**Target:** app1 (152.53.36.131, Hetzner) or dedicated netcup VPS — TBD.

**Domains (planned):**
- `intelsight.io` (or chosen brand) — marketing site + customer portal
- `api.intelsight.io` — REST API
- Listed under Products on `itpropartner.com`

**Backup:** Follows standard ITPP backup cadence (daily + 15-min database sync to S3).

---

## Recovery

Standard ITPP recovery procedure:
1. Restore PostgreSQL from latest S3 backup
2. Redeploy FastAPI + React containers
3. Re-establish Caddy routes and LE certificates
4. Verify Stripe webhook endpoint

Full DR plan to be drafted post-MVP.

---

## Pricing

| Tier | Price | Key Features |
|------|-------|-------------|
| Starter | $199/mo | 50 searches, basic reports, 1 user |
| Pro | $499/mo | Unlimited searches, weekly reports, OSINT dossiers, white-label |
| Enterprise | $1,499+/mo | API access, custom dashboards, dedicated analyst |

14-day free trial on all plans.

---

## Key URLs (planned)

| Purpose | URL |
|---------|-----|
| Marketing + Portal | intelsight.io |
| API | api.intelsight.io |
| ITPP product listing | itpropartner.com/products/intelsight |

---

## Related Repos

- `itpp-infrastructure` — server architecture, DNS records
- Super Search MCP server (`/opt/super-search/` on app1)
- osint-person MCP server

---

## Open Decisions

- [ ] Product name (IntelSight, ScopeIntel, BrandSleuth, RivalEye, BizScope)
- [ ] Hosting: app1 shared or dedicated VPS
- [ ] Data retention policy (GDPR/CCPA)
- [ ] Rate limit definition for Starter tier
- [ ] LLM choice for report generation (deepseek-v4-pro vs Claude)