# 04rishabhgupta/incubatorportfoliohealth architecture

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

- Interactive diagram: https://gitdiagram.com/04rishabhgupta/incubatorportfoliohealth
- Repository: https://github.com/04rishabhgupta/incubatorportfoliohealth

## Overview

This is a demo portfolio-management application for an investment/incubation team and startup founders. Staff sign in, review portfolio health and individual startup records, then manage assessments, mentor matching, requests, and submissions; founders use token-based pages to submit requested information. The central workflow is backed by a persisted client store, seeded records, derived portfolio signals, and AI-style investibility analysis. The source index confirms several page-to-module dependencies, but unsampled page logic and external integrations are not inferred beyond those references.

Main entry points: [`src/store/index.ts`](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/store/index.ts) (Persisted App State), [`src/lib/rbac.ts`](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/lib/rbac.ts) (Role Permissions), [`src/app/(authenticated)/portfolio/page.tsx`](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/portfolio/page.tsx) (Portfolio Dashboard), [`src/app/(authenticated)/admin/managers/[id]/page.tsx`](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/admin/managers/%5Bid%5D/page.tsx) (Manager View)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Roles"]
  node_login["Login<br/>[page.tsx]"]
  node_auth["Auth Guard<br/>[AuthGuard.tsx]"]
  node_rbac["Role Permissions<br/>[rbac.ts]"]
  node_users["Demo Accounts<br/>[users.ts]"]
end

subgraph group_portfolio["Portfolio Operations"]
  node_portfolio_page["Portfolio Dashboard<br/>[page.tsx]"]
  node_admin["Administration<br/>[page.tsx]"]
  node_manager["Manager View<br/>[page.tsx]"]
  node_startup["Startup Profile<br/>[page.tsx]"]
  node_assessments["Assessments<br/>[page.tsx]"]
  node_mentor["Mentor Matching<br/>[page.tsx]"]
  node_submissions["Submission Review<br/>[page.tsx]"]
  node_founder_portal["Founder Portal<br/>[page.tsx]"]
  node_upload["Startup Import"]
  node_comparison["Startup Comparison"]
  node_excel["Excel Processing<br/>[excelService.ts]"]
end

subgraph group_fitt["Startup Support"]
  node_fitt["FITT Workspace"]
end

subgraph group_state["Application State"]
  node_ai["Investibility Analysis<br/>[aiAnalysis.ts]"]
  node_derived["Portfolio Signals<br/>[derived.ts]"]
  node_store["Persisted App State<br/>[index.ts]"]
end

subgraph group_shared["Shared UI"]
  node_ui["UI Components"]
end

node_staff(("Investment Staff"))
node_founder(("Startup Founder"))

node_staff -->|"signs in"| node_login
node_login -->|"checks credentials"| node_users
node_login -->|"sets session"| node_store
node_auth -->|"checks session"| node_store
node_portfolio_page -->|"reads portfolio"| node_store
node_portfolio_page -->|"checks roles"| node_rbac
node_portfolio_page -->|"uses signals"| node_derived
node_portfolio_page -->|"compares startups"| node_comparison
node_admin -->|"reads state"| node_store
node_manager -->|"reads state"| node_store
node_manager -->|"exports data"| node_excel
node_manager -->|"uses comparison"| node_comparison
node_assessments -->|"reads state"| node_store
node_assessments -->|"checks roles"| node_rbac
node_mentor -->|"reads state"| node_store
node_mentor -->|"checks roles"| node_rbac
node_submissions -->|"reads state"| node_store
node_submissions -->|"checks roles"| node_rbac
node_founder -->|"submits information"| node_founder_portal
node_founder_portal -->|"updates state"| node_store
node_startup -->|"reads state"| node_store
node_startup -->|"checks roles"| node_rbac
node_startup -->|"renders workspace"| node_fitt
node_upload -->|"updates startups"| node_store
node_upload -->|"parses workbook"| node_excel
node_upload -->|"requests analysis"| node_ai
node_store -->|"computes scores"| node_ai

click node_login "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/login/page.tsx"
click node_auth "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/components/AuthGuard.tsx"
click node_rbac "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/lib/rbac.ts"
click node_portfolio_page "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/portfolio/page.tsx"
click node_admin "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/admin/page.tsx"
click node_manager "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/admin/managers/%5Bid%5D/page.tsx"
click node_startup "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/startups/%5Bid%5D/page.tsx"
click node_assessments "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/assessments/page.tsx"
click node_mentor "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/mentor-connect/page.tsx"
click node_submissions "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/submissions/page.tsx"
click node_founder_portal "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/founder/%5Btoken%5D/page.tsx"
click node_fitt "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/components/fitt/FittStartupPage.tsx"
click node_upload "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/components/portfolio/StartupUploadModal.tsx"
click node_comparison "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/components/portfolio/StartupComparison.tsx"
click node_excel "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/lib/excelService.ts"
click node_ai "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/lib/aiAnalysis.ts"
click node_derived "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/lib/derived.ts"
click node_store "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/store/index.ts"
click node_users "https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/data/seed/users.ts"
click node_ui "https://github.com/04rishabhgupta/incubatorportfoliohealth/tree/main/src/components/ui"

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_login,node_auth,node_rbac,node_users toneBlue
class node_portfolio_page,node_admin,node_manager,node_startup,node_assessments,node_mentor,node_submissions,node_founder_portal,node_upload,node_comparison,node_excel toneAmber
class node_fitt toneMint
class node_ai,node_derived,node_store toneRose
class node_ui,node_staff,node_founder toneIndigo
```

## Components

### Access and Roles

- [Login](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Auth Guard](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/components/AuthGuard.tsx): `src/components/AuthGuard.tsx`
- [Role Permissions](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/lib/rbac.ts): `src/lib/rbac.ts`
- [Demo Accounts](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/data/seed/users.ts): `src/data/seed/users.ts`

### Portfolio Operations

- [Portfolio Dashboard](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/portfolio/page.tsx): `src/app/(authenticated)/portfolio/page.tsx`
- [Administration](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/admin/page.tsx): `src/app/(authenticated)/admin/page.tsx`
- [Manager View](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/admin/managers/%5Bid%5D/page.tsx): `src/app/(authenticated)/admin/managers/[id]/page.tsx`
- [Startup Profile](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/startups/%5Bid%5D/page.tsx): `src/app/(authenticated)/startups/[id]/page.tsx`
- [Assessments](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/assessments/page.tsx): `src/app/(authenticated)/assessments/page.tsx`
- [Mentor Matching](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/mentor-connect/page.tsx): `src/app/(authenticated)/mentor-connect/page.tsx`
- [Submission Review](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/(authenticated)/submissions/page.tsx): `src/app/(authenticated)/submissions/page.tsx`
- [Founder Portal](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/app/founder/%5Btoken%5D/page.tsx): `src/app/founder/[token]/page.tsx`
- [Startup Import](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/components/portfolio/StartupUploadModal.tsx): `src/components/portfolio/StartupUploadModal.tsx`
- [Startup Comparison](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/components/portfolio/StartupComparison.tsx): `src/components/portfolio/StartupComparison.tsx`
- [Excel Processing](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/lib/excelService.ts): `src/lib/excelService.ts`

### Startup Support

- [FITT Workspace](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/components/fitt/FittStartupPage.tsx): `src/components/fitt/FittStartupPage.tsx`

### Application State

- [Investibility Analysis](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/lib/aiAnalysis.ts): `src/lib/aiAnalysis.ts`
- [Portfolio Signals](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/lib/derived.ts): `src/lib/derived.ts`
- [Persisted App State](https://github.com/04rishabhgupta/incubatorportfoliohealth/blob/main/src/store/index.ts): `src/store/index.ts`

### Shared UI

- [UI Components](https://github.com/04rishabhgupta/incubatorportfoliohealth/tree/main/src/components/ui): `src/components/ui`

### Other components

- **Investment Staff**
- **Startup Founder**

## Connections

- Investment Staff → Login: signs in (evidence: `src/app/login/page.tsx`)
- Login → Demo Accounts: checks credentials (evidence: `src/app/login/page.tsx`)
- Login → Persisted App State: sets session (evidence: `src/app/login/page.tsx`)
- Auth Guard → Persisted App State: checks session (evidence: `src/components/AuthGuard.tsx`)
- Portfolio Dashboard → Persisted App State: reads portfolio (evidence: `src/app/(authenticated)/portfolio/page.tsx`)
- Portfolio Dashboard → Role Permissions: checks roles (evidence: `src/app/(authenticated)/portfolio/page.tsx`)
- Portfolio Dashboard → Portfolio Signals: uses signals (evidence: `src/app/(authenticated)/portfolio/page.tsx`)
- Portfolio Dashboard → Startup Comparison: compares startups (evidence: `src/app/(authenticated)/portfolio/page.tsx`)
- Administration → Persisted App State: reads state (evidence: `src/app/(authenticated)/admin/page.tsx`)
- Manager View → Persisted App State: reads state (evidence: `src/app/(authenticated)/admin/managers/[id]/page.tsx`)
- Manager View → Excel Processing: exports data (evidence: `src/app/(authenticated)/admin/managers/[id]/page.tsx`)
- Manager View → Startup Comparison: uses comparison (evidence: `src/app/(authenticated)/admin/managers/[id]/page.tsx`)
- Assessments → Persisted App State: reads state (evidence: `src/app/(authenticated)/assessments/page.tsx`)
- Assessments → Role Permissions: checks roles (evidence: `src/app/(authenticated)/assessments/page.tsx`)
- Mentor Matching → Persisted App State: reads state (evidence: `src/app/(authenticated)/mentor-connect/page.tsx`)
- Mentor Matching → Role Permissions: checks roles (evidence: `src/app/(authenticated)/mentor-connect/page.tsx`)
- Submission Review → Persisted App State: reads state (evidence: `src/app/(authenticated)/submissions/page.tsx`)
- Submission Review → Role Permissions: checks roles (evidence: `src/app/(authenticated)/submissions/page.tsx`)
- Startup Founder → Founder Portal: submits information (evidence: `src/app/founder/[token]/page.tsx`)
- Founder Portal → Persisted App State: updates state (evidence: `src/app/founder/[token]/page.tsx`)
- Startup Profile → Persisted App State: reads state (evidence: `src/app/(authenticated)/startups/[id]/page.tsx`)
- Startup Profile → Role Permissions: checks roles (evidence: `src/app/(authenticated)/startups/[id]/page.tsx`)
- Startup Profile → FITT Workspace: renders workspace (evidence: `src/app/(authenticated)/startups/[id]/page.tsx`)
- Startup Import → Persisted App State: updates startups (evidence: `src/components/portfolio/StartupUploadModal.tsx`)
- Startup Import → Excel Processing: parses workbook (evidence: `src/components/portfolio/StartupUploadModal.tsx`)
- Startup Import → Investibility Analysis: requests analysis (evidence: `src/components/portfolio/StartupUploadModal.tsx`)
- Persisted App State → Investibility Analysis: computes scores (evidence: `src/store/index.ts`)
