How alanperry1/vc works
Orbit is a venture-sourcing workspace. Its main workflow collects public company and founder signals, normalizes them into Postgres, scores and enriches records, then exposes them for discovery, review, relationship tracking, and deal-pipeline management. The graph includes the documented product areas and the main internal storage, scoring, and embedding layers. Some routes and UI internals were not sampled; those links are shown only where the README or cited excerpts establish them.
Main entry points: ingest/route.ts Ingest orchestration · ingest/route.ts Scheduled ingestion · store.ts Normalized record writes · api.ts Shared API types and fetch
Components 26
Signal collection
- Ingest orchestration
app/api/ingest/route.ts - GitHub ingest
lib/ingest-github.ts - Hacker News ingest
lib/ingest-hn.ts - Product Hunt ingest
lib/ingest-producthunt.ts - Reddit ingest
lib/ingest-reddit.ts - YC company ingest
lib/ingest-yc.ts - YC founder enrichment
lib/ingest-yc-founders.ts - Scheduled ingestion
app/api/cron/ingest/route.ts
Scoring and enrichment
- Company scoring and memos
lib/claude.ts - Founder scoring
lib/founders.ts - Embeddings and similarity
lib/embeddings.ts
Persistence
- Database schema
lib/schema.ts - Normalized record writes
lib/store.ts - Postgres access
lib/db.ts
Sourcing workspace
- Product API routes
app/api - Shared API types and fetch
lib/api.ts - Dashboard and signals
app/page.tsx - Company discovery
app/discover/page.tsx - Company cards
components/CompanyCard.tsx - Company review drawer
components/CompanyDrawer.tsx - Founder browsing
app/founders/page.tsx - Founder detail drawer
components/FounderDrawer.tsx - Relationship network
app/network/page.tsx - Deal pipeline
app/pipeline/page.tsx
Other components
- Investment team
- Public data sources
Connections 48
- Public data sources → GitHub ingest: provides repositories
- Public data sources → Hacker News ingest: provides stories
- Public data sources → Product Hunt ingest: provides product feed
- Public data sources → Reddit ingest: provides posts
- Public data sources → YC company ingest: provides company data
- Public data sources → YC founder enrichment: provides founder pages
- Ingest orchestration → GitHub ingest: dispatches
app/api/ingest/route.ts - Ingest orchestration → Hacker News ingest: dispatches
app/api/ingest/route.ts - Ingest orchestration → Product Hunt ingest: dispatches
app/api/ingest/route.ts - Ingest orchestration → Reddit ingest: dispatches
app/api/ingest/route.ts - Ingest orchestration → YC company ingest: dispatches
app/api/ingest/route.ts - Ingest orchestration → YC founder enrichment: dispatches
app/api/ingest/route.ts - Scheduled ingestion → GitHub ingest: dispatches
app/api/cron/ingest/route.ts - Scheduled ingestion → Hacker News ingest: dispatches
app/api/cron/ingest/route.ts - Scheduled ingestion → Product Hunt ingest: dispatches
app/api/cron/ingest/route.ts - Scheduled ingestion → Reddit ingest: dispatches
app/api/cron/ingest/route.ts - Scheduled ingestion → YC company ingest: dispatches
app/api/cron/ingest/route.ts - Scheduled ingestion → YC founder enrichment: dispatches
app/api/cron/ingest/route.ts - GitHub ingest → Normalized record writes: upserts records
lib/ingest-github.ts - Hacker News ingest → Normalized record writes: writes records
lib/ingest-hn.ts - Product Hunt ingest → Normalized record writes: writes records
lib/ingest-producthunt.ts - Reddit ingest → Normalized record writes: writes records
lib/ingest-reddit.ts - YC company ingest → Normalized record writes: upserts records
lib/ingest-yc.ts - YC founder enrichment → Normalized record writes: links founders
lib/ingest-yc-founders.ts - Normalized record writes → Postgres access: queries Postgres
lib/store.ts - Company scoring and memos → Postgres access: reads and scores
- Founder scoring → Company scoring and memos: uses Claude scoring
lib/founders.ts - Ingest orchestration → Company scoring and memos: scores companies
app/api/ingest/route.ts - Ingest orchestration → Founder scoring: scores founders
app/api/ingest/route.ts - Ingest orchestration → Embeddings and similarity: backfills vectors
app/api/ingest/route.ts - Scheduled ingestion → Company scoring and memos: scores companies
app/api/cron/ingest/route.ts - Scheduled ingestion → Founder scoring: scores founders
app/api/cron/ingest/route.ts - Scheduled ingestion → Embeddings and similarity: backfills vectors
app/api/cron/ingest/route.ts - Embeddings and similarity → Postgres access: reads and writes vectors
lib/embeddings.ts - Product API routes → Postgres access: serves stored records
app/api/companies/route.ts - Investment team → Dashboard and signals: reviews overview
- Investment team → Company discovery: searches companies
- Investment team → Founder browsing: reviews founders
- Investment team → Relationship network: tracks relationships
- Investment team → Deal pipeline: manages deals
- Dashboard and signals → Shared API types and fetch: uses fetch helpers
app/page.tsx - Company discovery → Shared API types and fetch: uses fetch helpers
app/discover/page.tsx - Founder browsing → Shared API types and fetch: uses fetch helpers
app/founders/page.tsx - Relationship network → Shared API types and fetch: uses fetch helpers
app/network/page.tsx - Deal pipeline → Shared API types and fetch: uses fetch helpers
app/pipeline/page.tsx - Shared API types and fetch → Product API routes: calls API
- Company discovery → Company cards: renders
app/discover/page.tsx - Company discovery → Company review drawer: opens review
app/discover/page.tsx