# tdavidson/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/tdavidson/portfolio
- Repository: https://github.com/tdavidson/portfolio

## Overview

Portfolio is a self-hosted venture-capital operating platform. The main workflow runs from inbound deal screening through diligence and memo creation, then investment and portfolio monitoring, fund accounting, and LP reporting. The graph preserves the documented AI analyst, CRM, compliance, and configurable integrations as parallel capabilities. Some backend stages are represented by their exact enclosing directories because only their routes or documentation were supplied; unsampled relationships are not asserted.

Main entry points: [`app/(app)/accounting/[[...rest]]/page.tsx`](https://github.com/tdavidson/portfolio/blob/main/app/(app)/accounting/%5B%5B...rest%5D%5D/page.tsx) (Fund accounting), [`lib/supabase/server.ts`](https://github.com/tdavidson/portfolio/blob/main/lib/supabase/server.ts) (Supabase data), [`app/api/inbound-email/route.ts`](https://github.com/tdavidson/portfolio/blob/main/app/api/inbound-email/route.ts) (Inbound intake), [`app/(app)/dashboard/page-view.tsx`](https://github.com/tdavidson/portfolio/blob/main/app/(app)/dashboard/page-view.tsx) (Portfolio dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deal["Deal workflow"]
  node_inbound["Inbound intake<br/>[route.ts]"]
  node_dealflow["Deal pipeline"]
  node_diligence["Diligence workspace"]
  node_ingest["Document ingestion<br/>[ingest.ts]"]
  node_memo["Memo drafting"]
end

subgraph group_portfolio["Portfolio intelligence"]
  node_dashboard["Portfolio dashboard<br/>[page-view.tsx]"]
  node_companies["Company records<br/>[page-view.tsx]"]
  node_updates["Update processing<br/>[processEmail.ts]"]
  node_review["Extraction review"]
  node_analyst["AI analyst<br/>[orchestrator.ts]"]
  node_crm["CRM interactions"]
end

subgraph group_funds["Fund operations"]
  node_accounting["Fund accounting<br/>[page.tsx]"]
  node_construction["Fund construction"]
  node_ledger[("Double-entry ledger<br/>[route.ts]")]
  node_capital["Capital accounts<br/>[capital-account.ts]"]
  node_statements["Statements and tax<br/>[route.ts]"]
end

subgraph group_investors["LP experience"]
  node_lp_reporting["LP reporting"]
  node_portal["LP portal<br/>[page.tsx]"]
end

subgraph group_platform["Platform services"]
  node_database[("Supabase data<br/>[server.ts]")]
  node_settings["Firm settings<br/>[route.ts]"]
  node_compliance["Compliance tracking"]
  node_auth["Fund access<br/>[effective.ts]"]
end

node_team(("Investment team"))
node_drive["Google Drive"]

node_team -->|"submits opportunities"| node_inbound
node_inbound -->|"screens deals"| node_dealflow
node_dealflow -->|"advances deal"| node_diligence
node_diligence -->|"analyzes data room"| node_ingest
node_ingest -->|"informs drafting"| node_memo
node_team -->|"monitors portfolio"| node_dashboard
node_dashboard -->|"opens company"| node_companies
node_inbound -->|"runs email pipeline"| node_updates
node_updates -->|"queues uncertain results"| node_review
node_review -->|"updates reporting data"| node_dashboard
node_team -->|"asks fund questions"| node_analyst
node_team -->|"logs interactions"| node_crm
node_team -->|"operates funds"| node_accounting
node_accounting -.->|"posts journal entries"| node_ledger
node_accounting -.->|"models fund economics"| node_construction
node_accounting -->|"tracks partner capital"| node_capital
node_accounting -->|"generates reports"| node_statements
node_team -->|"prepares investor reports"| node_lp_reporting
node_lp_reporting -->|"delivers documents"| node_portal
node_portal -->|"records engagement"| node_team
node_companies -.->|"loads records"| node_database
node_accounting -.->|"stores books"| node_database
node_settings -->|"configures storage"| node_drive
node_settings -.->|"persists settings"| node_database
node_team -->|"tracks obligations"| node_compliance
node_auth -->|"validates sessions"| node_database

click node_inbound "https://github.com/tdavidson/portfolio/blob/main/app/api/inbound-email/route.ts"
click node_dealflow "https://github.com/tdavidson/portfolio/tree/main/app/(app)/deals"
click node_diligence "https://github.com/tdavidson/portfolio/tree/main/app/(app)/diligence"
click node_ingest "https://github.com/tdavidson/portfolio/blob/main/lib/memo-agent/stages/ingest.ts"
click node_memo "https://github.com/tdavidson/portfolio/tree/main/lib/memo-agent"
click node_dashboard "https://github.com/tdavidson/portfolio/blob/main/app/(app)/dashboard/page-view.tsx"
click node_companies "https://github.com/tdavidson/portfolio/blob/main/app/(app)/companies/%5Bid%5D/page-view.tsx"
click node_updates "https://github.com/tdavidson/portfolio/blob/main/lib/pipeline/processEmail.ts"
click node_review "https://github.com/tdavidson/portfolio/blob/main/components/email-review-modal.tsx"
click node_analyst "https://github.com/tdavidson/portfolio/blob/main/lib/ai/analyst/orchestrator.ts"
click node_crm "https://github.com/tdavidson/portfolio/tree/main/app/(app)/interactions"
click node_accounting "https://github.com/tdavidson/portfolio/blob/main/app/(app)/accounting/%5B%5B...rest%5D%5D/page.tsx"
click node_construction "https://github.com/tdavidson/portfolio/blob/main/lib/accounting/construction-service.ts"
click node_ledger "https://github.com/tdavidson/portfolio/blob/main/app/api/accounting/journal/route.ts"
click node_capital "https://github.com/tdavidson/portfolio/blob/main/lib/accounting/capital-account.ts"
click node_statements "https://github.com/tdavidson/portfolio/blob/main/app/api/accounting/statements/route.ts"
click node_lp_reporting "https://github.com/tdavidson/portfolio/tree/main/app/(app)/lps"
click node_portal "https://github.com/tdavidson/portfolio/blob/main/app/portal/overview/page.tsx"
click node_database "https://github.com/tdavidson/portfolio/blob/main/lib/supabase/server.ts"
click node_settings "https://github.com/tdavidson/portfolio/blob/main/app/api/settings/route.ts"
click node_compliance "https://github.com/tdavidson/portfolio/tree/main/app/(app)/compliance"
click node_auth "https://github.com/tdavidson/portfolio/blob/main/lib/access/effective.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_inbound,node_dealflow,node_diligence,node_ingest,node_memo toneBlue
class node_dashboard,node_companies,node_updates,node_review,node_analyst,node_crm toneAmber
class node_accounting,node_construction,node_ledger,node_capital,node_statements toneMint
class node_lp_reporting,node_portal toneRose
class node_database,node_settings,node_compliance,node_auth,node_team,node_drive toneIndigo
```

## Components

### Deal workflow

- [Inbound intake](https://github.com/tdavidson/portfolio/blob/main/app/api/inbound-email/route.ts): `app/api/inbound-email/route.ts`
- [Deal pipeline](https://github.com/tdavidson/portfolio/tree/main/app/(app)/deals): `app/(app)/deals`
- [Diligence workspace](https://github.com/tdavidson/portfolio/tree/main/app/(app)/diligence): `app/(app)/diligence`
- [Document ingestion](https://github.com/tdavidson/portfolio/blob/main/lib/memo-agent/stages/ingest.ts): `lib/memo-agent/stages/ingest.ts`
- [Memo drafting](https://github.com/tdavidson/portfolio/tree/main/lib/memo-agent): `lib/memo-agent`

### Portfolio intelligence

- [Portfolio dashboard](https://github.com/tdavidson/portfolio/blob/main/app/(app)/dashboard/page-view.tsx): `app/(app)/dashboard/page-view.tsx`
- [Company records](https://github.com/tdavidson/portfolio/blob/main/app/(app)/companies/%5Bid%5D/page-view.tsx): `app/(app)/companies/[id]/page-view.tsx`
- [Update processing](https://github.com/tdavidson/portfolio/blob/main/lib/pipeline/processEmail.ts): `lib/pipeline/processEmail.ts`
- [Extraction review](https://github.com/tdavidson/portfolio/blob/main/components/email-review-modal.tsx): `components/email-review-modal.tsx`
- [AI analyst](https://github.com/tdavidson/portfolio/blob/main/lib/ai/analyst/orchestrator.ts): `lib/ai/analyst/orchestrator.ts`
- [CRM interactions](https://github.com/tdavidson/portfolio/tree/main/app/(app)/interactions): `app/(app)/interactions`

### Fund operations

- [Fund accounting](https://github.com/tdavidson/portfolio/blob/main/app/(app)/accounting/%5B%5B...rest%5D%5D/page.tsx): `app/(app)/accounting/[[...rest]]/page.tsx`
- [Fund construction](https://github.com/tdavidson/portfolio/blob/main/lib/accounting/construction-service.ts): `lib/accounting/construction-service.ts`
- [Double-entry ledger](https://github.com/tdavidson/portfolio/blob/main/app/api/accounting/journal/route.ts): `app/api/accounting/journal/route.ts`
- [Capital accounts](https://github.com/tdavidson/portfolio/blob/main/lib/accounting/capital-account.ts): `lib/accounting/capital-account.ts`
- [Statements and tax](https://github.com/tdavidson/portfolio/blob/main/app/api/accounting/statements/route.ts): `app/api/accounting/statements/route.ts`

### LP experience

- [LP reporting](https://github.com/tdavidson/portfolio/tree/main/app/(app)/lps): `app/(app)/lps`
- [LP portal](https://github.com/tdavidson/portfolio/blob/main/app/portal/overview/page.tsx): `app/portal/overview/page.tsx`

### Platform services

- [Supabase data](https://github.com/tdavidson/portfolio/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`
- [Firm settings](https://github.com/tdavidson/portfolio/blob/main/app/api/settings/route.ts): `app/api/settings/route.ts`
- [Compliance tracking](https://github.com/tdavidson/portfolio/tree/main/app/(app)/compliance): `app/(app)/compliance`
- [Fund access](https://github.com/tdavidson/portfolio/blob/main/lib/access/effective.ts): `lib/access/effective.ts`

### Other components

- **Investment team**
- **Google Drive**

## Connections

- Investment team → Inbound intake: submits opportunities (evidence: `README.md`)
- Inbound intake → Deal pipeline: screens deals (evidence: `README.md`)
- Deal pipeline → Diligence workspace: advances deal (evidence: `README.md`)
- Diligence workspace → Document ingestion: analyzes data room (evidence: `README.md`)
- Document ingestion → Memo drafting: informs drafting (evidence: `README.md`)
- Investment team → Portfolio dashboard: monitors portfolio (evidence: `README.md`)
- Portfolio dashboard → Company records: opens company (evidence: `app/(app)/dashboard/page-view.tsx`)
- Inbound intake → Update processing: runs email pipeline (evidence: `app/api/inbound-email/route.ts`)
- Update processing → Extraction review: queues uncertain results (evidence: `README.md`)
- Extraction review → Portfolio dashboard: updates reporting data (evidence: `README.md`)
- Investment team → AI analyst: asks fund questions (evidence: `README.md`)
- Investment team → CRM interactions: logs interactions (evidence: `README.md`)
- Investment team → Fund accounting: operates funds (evidence: `README.md`)
- Fund accounting → Double-entry ledger: posts journal entries
- Fund accounting → Fund construction: models fund economics
- Fund accounting → Capital accounts: tracks partner capital (evidence: `README.md`)
- Fund accounting → Statements and tax: generates reports (evidence: `README.md`)
- Investment team → LP reporting: prepares investor reports (evidence: `README.md`)
- LP reporting → LP portal: delivers documents (evidence: `README.md`)
- LP portal → Investment team: records engagement (evidence: `README.md`)
- Company records → Supabase data: loads records
- Fund accounting → Supabase data: stores books
- Firm settings → Google Drive: configures storage
- Firm settings → Supabase data: persists settings (evidence: `app/api/settings/route.ts`)
- Investment team → Compliance tracking: tracks obligations (evidence: `README.md`)
- Fund access → Supabase data: validates sessions (evidence: `lib/supabase/server.ts`)
