# vulturex0/vulturex-v2 architecture

> Architecture diagram of the GitHub repository vulturex0/vulturex-v2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vulturex0/vulturex-v2
- Repository: https://github.com/vulturex0/vulturex-v2

## Overview

VultureX connects startup founders and investors: founders create profiles and traction data, receive a formula-based score, and present themselves through discovery, competitions, and shareable pitch decks; investors explore startups, save them, and express interest, which founders can accept or decline. The platform also provides rankings, dashboards, profile-view tracking, and public marketing pages. The README documents the major capabilities, while sampled source confirms key scoring, persistence, interest-notification, and landing-page behavior. Several page-to-API links are not shown in sampled source, so those are marked unverified.

Main entry points: [`db/schema.ts`](https://github.com/vulturex0/vulturex-v2/blob/main/db/schema.ts) (PostgreSQL data), [`app/api/startups/route.ts`](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/startups/route.ts) (Startup profiles), [`app/api/interest/route.ts`](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/interest/route.ts) (Interest requests), [`app/api/deck/generate/route.ts`](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/deck/generate/route.ts) (Pitch deck generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and identity"]
  node_marketing["Marketing site<br/>[page.tsx]"]
  node_authpages["Sign in and signup<br/>[page.tsx]"]
  node_auth["Authentication<br/>[auth.config.ts]"]
end

subgraph group_profiles["Profiles and discovery"]
  node_startup_profile["Startup profiles<br/>[route.ts]"]
  node_investor_profile["Investor profiles<br/>[route.ts]"]
  node_scoring["VultureScore engine<br/>[score.engine.ts]"]
  node_explore["Startup discovery<br/>[page.tsx]"]
  node_rankings["Rankings and dashboard<br/>[page.tsx]"]
end

subgraph group_connections["Investor connections"]
  node_interests["Interest requests<br/>[route.ts]"]
  node_bookmarks["Saved startups<br/>[route.ts]"]
  node_email["Email notification<br/>[email.service.ts]"]
end

subgraph group_pitch["Pitch and competitions"]
  node_decks["Pitch deck generation<br/>[route.ts]"]
  node_deck_view["Public deck sharing<br/>[page.tsx]"]
  node_competitions["Sector competitions<br/>[route.ts]"]
end

subgraph group_platform["Platform services"]
  node_views["View tracking<br/>[route.ts]"]
  node_database[("PostgreSQL data<br/>[schema.ts]")]
end

node_founder(("Startup founder"))
node_investor(("Investor"))
node_openai(("OpenAI"))
node_resend(("Resend email"))

node_founder -->|"visits"| node_marketing
node_investor -->|"visits"| node_marketing
node_founder -->|"signs up"| node_authpages
node_investor -->|"signs up"| node_authpages
node_authpages -.->|"authenticates"| node_auth
node_founder -->|"submits profile"| node_startup_profile
node_startup_profile -->|"computes score"| node_scoring
node_startup_profile -->|"writes profile"| node_database
node_scoring -.->|"reads metrics"| node_database
node_investor -.->|"submits profile"| node_investor_profile
node_investor_profile -.->|"stores profile"| node_database
node_investor -->|"browses startups"| node_explore
node_explore -.->|"lists startups"| node_startup_profile
node_investor -->|"views rankings"| node_rankings
node_founder -->|"views dashboard"| node_rankings
node_investor -->|"expresses interest"| node_interests
node_founder -->|"responds to interest"| node_interests
node_interests -->|"reads and writes"| node_database
node_interests -->|"sends notification"| node_email
node_email -->|"delivers email"| node_resend
node_investor -->|"saves startups"| node_bookmarks
node_bookmarks -->|"reads and writes"| node_database
node_founder -->|"generates deck"| node_decks
node_decks -.->|"generates content"| node_openai
node_decks -.->|"stores deck"| node_database
node_founder -->|"shares deck"| node_deck_view
node_investor -->|"views shared deck"| node_deck_view
node_deck_view -->|"loads deck"| node_database
node_founder -->|"enters challenge"| node_competitions
node_competitions -.->|"stores entries"| node_database
node_investor -->|"views profiles"| node_views
node_views -->|"records views"| node_database
node_marketing -->|"loads live stats"| node_database

click node_marketing "https://github.com/vulturex0/vulturex-v2/blob/main/app/(marketing)/page.tsx"
click node_authpages "https://github.com/vulturex0/vulturex-v2/blob/main/app/(auth)/login/page.tsx"
click node_auth "https://github.com/vulturex0/vulturex-v2/blob/main/features/auth/auth.config.ts"
click node_startup_profile "https://github.com/vulturex0/vulturex-v2/blob/main/app/api/startups/route.ts"
click node_investor_profile "https://github.com/vulturex0/vulturex-v2/blob/main/app/api/investors/route.ts"
click node_scoring "https://github.com/vulturex0/vulturex-v2/blob/main/features/scoring/score.engine.ts"
click node_explore "https://github.com/vulturex0/vulturex-v2/blob/main/app/(platform)/explore/page.tsx"
click node_rankings "https://github.com/vulturex0/vulturex-v2/blob/main/app/(platform)/rankings/page.tsx"
click node_interests "https://github.com/vulturex0/vulturex-v2/blob/main/app/api/interest/route.ts"
click node_bookmarks "https://github.com/vulturex0/vulturex-v2/blob/main/app/api/bookmarks/route.ts"
click node_email "https://github.com/vulturex0/vulturex-v2/blob/main/features/notifications/email.service.ts"
click node_decks "https://github.com/vulturex0/vulturex-v2/blob/main/app/api/deck/generate/route.ts"
click node_deck_view "https://github.com/vulturex0/vulturex-v2/blob/main/app/deck/view/%5Btoken%5D/page.tsx"
click node_competitions "https://github.com/vulturex0/vulturex-v2/blob/main/app/api/competitions/route.ts"
click node_views "https://github.com/vulturex0/vulturex-v2/blob/main/app/api/views/route.ts"
click node_database "https://github.com/vulturex0/vulturex-v2/blob/main/db/schema.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_marketing,node_authpages,node_auth toneBlue
class node_startup_profile,node_investor_profile,node_scoring,node_explore,node_rankings toneAmber
class node_interests,node_bookmarks,node_email toneMint
class node_decks,node_deck_view,node_competitions toneRose
class node_views,node_database,node_founder,node_investor,node_openai,node_resend toneIndigo
```

## Components

### Entry and identity

- [Marketing site](https://github.com/vulturex0/vulturex-v2/blob/main/app/(marketing)/page.tsx): `app/(marketing)/page.tsx`
- [Sign in and signup](https://github.com/vulturex0/vulturex-v2/blob/main/app/(auth)/login/page.tsx): `app/(auth)/login/page.tsx`
- [Authentication](https://github.com/vulturex0/vulturex-v2/blob/main/features/auth/auth.config.ts): `features/auth/auth.config.ts`

### Profiles and discovery

- [Startup profiles](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/startups/route.ts): `app/api/startups/route.ts`
- [Investor profiles](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/investors/route.ts): `app/api/investors/route.ts`
- [VultureScore engine](https://github.com/vulturex0/vulturex-v2/blob/main/features/scoring/score.engine.ts): `features/scoring/score.engine.ts`
- [Startup discovery](https://github.com/vulturex0/vulturex-v2/blob/main/app/(platform)/explore/page.tsx): `app/(platform)/explore/page.tsx`
- [Rankings and dashboard](https://github.com/vulturex0/vulturex-v2/blob/main/app/(platform)/rankings/page.tsx): `app/(platform)/rankings/page.tsx`

### Investor connections

- [Interest requests](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/interest/route.ts): `app/api/interest/route.ts`
- [Saved startups](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/bookmarks/route.ts): `app/api/bookmarks/route.ts`
- [Email notification](https://github.com/vulturex0/vulturex-v2/blob/main/features/notifications/email.service.ts): `features/notifications/email.service.ts`

### Pitch and competitions

- [Pitch deck generation](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/deck/generate/route.ts): `app/api/deck/generate/route.ts`
- [Public deck sharing](https://github.com/vulturex0/vulturex-v2/blob/main/app/deck/view/%5Btoken%5D/page.tsx): `app/deck/view/[token]/page.tsx`
- [Sector competitions](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/competitions/route.ts): `app/api/competitions/route.ts`

### Platform services

- [View tracking](https://github.com/vulturex0/vulturex-v2/blob/main/app/api/views/route.ts): `app/api/views/route.ts`
- [PostgreSQL data](https://github.com/vulturex0/vulturex-v2/blob/main/db/schema.ts): `db/schema.ts`

### Other components

- **Startup founder**
- **Investor**
- **OpenAI**
- **Resend email**

## Connections

- Startup founder → Marketing site: visits
- Investor → Marketing site: visits
- Startup founder → Sign in and signup: signs up
- Investor → Sign in and signup: signs up
- Sign in and signup → Authentication: authenticates
- Startup founder → Startup profiles: submits profile
- Startup profiles → VultureScore engine: computes score (evidence: `app/api/startups/route.ts`)
- Startup profiles → PostgreSQL data: writes profile (evidence: `app/api/startups/route.ts`)
- VultureScore engine → PostgreSQL data: reads metrics
- Investor → Investor profiles: submits profile
- Investor profiles → PostgreSQL data: stores profile (evidence: `app/api/investors/route.ts`)
- Investor → Startup discovery: browses startups
- Startup discovery → Startup profiles: lists startups
- Investor → Rankings and dashboard: views rankings
- Startup founder → Rankings and dashboard: views dashboard
- Investor → Interest requests: expresses interest
- Startup founder → Interest requests: responds to interest
- Interest requests → PostgreSQL data: reads and writes (evidence: `app/api/interest/route.ts`)
- Interest requests → Email notification: sends notification (evidence: `app/api/interest/route.ts`)
- Email notification → Resend email: delivers email (evidence: `features/notifications/email.service.ts`)
- Investor → Saved startups: saves startups
- Saved startups → PostgreSQL data: reads and writes (evidence: `app/api/bookmarks/route.ts`)
- Startup founder → Pitch deck generation: generates deck
- Pitch deck generation → OpenAI: generates content
- Pitch deck generation → PostgreSQL data: stores deck (evidence: `app/api/deck/generate/route.ts`)
- Startup founder → Public deck sharing: shares deck
- Investor → Public deck sharing: views shared deck
- Public deck sharing → PostgreSQL data: loads deck (evidence: `app/deck/view/[token]/page.tsx`)
- Startup founder → Sector competitions: enters challenge
- Sector competitions → PostgreSQL data: stores entries (evidence: `app/api/competitions/route.ts`)
- Investor → View tracking: views profiles
- View tracking → PostgreSQL data: records views (evidence: `app/api/views/route.ts`)
- Marketing site → PostgreSQL data: loads live stats (evidence: `app/(marketing)/page.tsx`)
