# mrnkim/brand-integration-assistant-public architecture

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

- Interactive diagram: https://gitdiagram.com/mrnkim/brand-integration-assistant-public
- Repository: https://github.com/mrnkim/brand-integration-assistant-public

## Overview

This is a web-based brand-integration assistant for exploring tagged ad videos, finding contextually relevant footage, and previewing AI-suggested ad placements. Users can browse and filter the ad library, search footage, or select an ad and explore similar videos; the app also exposes video, analysis, chapter, and vector-indexing capabilities. The sampled code confirms the text-search and Pinecone vector paths, but does not show most page-to-API wiring, so those connections are omitted.

Main entry points: [`src/app/contextual-analysis/page.tsx`](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/contextual-analysis/page.tsx) (Contextual analysis), [`src/components/SearchResultList.tsx`](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchResultList.tsx) (Result list), [`src/utils/pinecone.ts`](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/utils/pinecone.ts) (Pinecone client), [`src/app/ads-library/page.tsx`](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/ads-library/page.tsx) (Ad library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_ads["Ad library<br/>[page.tsx]"]
  node_content["Content library<br/>[page.tsx]"]
  node_contextual["Contextual analysis<br/>[page.tsx]"]
  node_searchbar["Search input<br/>[SearchBar.tsx]"]
  node_searchresults["Search results<br/>[SearchResults.tsx]"]
  node_resultlist["Result list"]
  node_resultitem["Result item"]
  node_resultmodal["Result preview"]
  node_similar["Similar videos"]
  node_video["Video player<br/>[Video.tsx]"]
  node_dropdown["Video selector<br/>[VideosDropdown.tsx]"]
end

subgraph group_api["Application API"]
  node_hooks["API hooks<br/>[apiHooks.ts]"]
  node_videoapi["Video API"]
  node_indexapi["Index API<br/>[route.ts]"]
  node_analyzeapi["Analysis API<br/>[route.ts]"]
  node_chaptersapi["Chapter API<br/>[route.tsx]"]
end

subgraph group_search["Search and analysis"]
  node_searchapi["Text search API<br/>[route.ts]"]
  node_embedapi["Video similarity API<br/>[route.ts]"]
end

subgraph group_vectors["Vector storage"]
  node_pineconeapi["Vector API"]
  node_storeapi["Vector ingestion<br/>[route.ts]"]
  node_pineconeutil["Pinecone client<br/>[pinecone.ts]"]
end

node_visitor(("User"))
node_twelvelabs{{"Twelve Labs"}}
node_pineconedb[("Pinecone index")]

node_visitor -->|"browses ads"| node_ads
node_visitor -->|"selects ad"| node_contextual
node_ads -->|"renders"| node_searchbar
node_ads -->|"renders"| node_searchresults
node_searchresults -->|"searches via"| node_hooks
node_searchresults -->|"renders"| node_resultlist
node_resultlist -->|"fetches details"| node_hooks
node_resultlist -->|"renders"| node_resultitem
node_resultlist -->|"opens preview"| node_resultmodal
node_contextual -->|"renders"| node_dropdown
node_contextual -->|"renders"| node_video
node_contextual -->|"renders"| node_similar
node_searchapi -->|"queries"| node_twelvelabs
node_embedapi -->|"gets index"| node_pineconeutil
node_pineconeapi -.->|"uses client"| node_pineconeutil
node_storeapi -->|"gets index"| node_pineconeutil
node_pineconeutil -->|"accesses"| node_pineconedb

click node_ads "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/ads-library/page.tsx"
click node_content "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/content-library/page.tsx"
click node_contextual "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/contextual-analysis/page.tsx"
click node_searchbar "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchBar.tsx"
click node_searchresults "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchResults.tsx"
click node_resultlist "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchResultList.tsx"
click node_resultitem "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchResultItem.tsx"
click node_resultmodal "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchResultModal.tsx"
click node_similar "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SimilarVideoResults.tsx"
click node_video "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/Video.tsx"
click node_dropdown "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/VideosDropdown.tsx"
click node_hooks "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/hooks/apiHooks.ts"
click node_videoapi "https://github.com/mrnkim/brand-integration-assistant-public/tree/main/src/app/api/videos"
click node_indexapi "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/indexes/%5BindexId%5D/route.ts"
click node_analyzeapi "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/analyze/route.ts"
click node_chaptersapi "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/generateChapters/route.tsx"
click node_searchapi "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/search/route.ts"
click node_embedapi "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/embeddingSearch/videoToVideo/route.ts"
click node_pineconeapi "https://github.com/mrnkim/brand-integration-assistant-public/tree/main/src/app/api/vectors"
click node_storeapi "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/vectors/store/route.ts"
click node_pineconeutil "https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/utils/pinecone.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_ads,node_content,node_contextual,node_searchbar,node_searchresults,node_resultlist,node_resultitem,node_resultmodal,node_similar,node_video,node_dropdown,node_visitor toneBlue
class node_hooks,node_videoapi,node_indexapi,node_analyzeapi,node_chaptersapi,node_pineconedb toneAmber
class node_searchapi,node_embedapi toneMint
class node_pineconeapi,node_storeapi,node_pineconeutil toneRose
class node_twelvelabs toneIndigo
```

## Components

### User experience

- [Ad library](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/ads-library/page.tsx): `src/app/ads-library/page.tsx`
- [Content library](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/content-library/page.tsx): `src/app/content-library/page.tsx`
- [Contextual analysis](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/contextual-analysis/page.tsx): `src/app/contextual-analysis/page.tsx`
- [Search input](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchBar.tsx): `src/components/SearchBar.tsx`
- [Search results](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchResults.tsx): `src/components/SearchResults.tsx`
- [Result list](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchResultList.tsx): `src/components/SearchResultList.tsx`
- [Result item](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchResultItem.tsx): `src/components/SearchResultItem.tsx`
- [Result preview](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SearchResultModal.tsx): `src/components/SearchResultModal.tsx`
- [Similar videos](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/SimilarVideoResults.tsx): `src/components/SimilarVideoResults.tsx`
- [Video player](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/Video.tsx): `src/components/Video.tsx`
- [Video selector](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/components/VideosDropdown.tsx): `src/components/VideosDropdown.tsx`

### Application API

- [API hooks](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/hooks/apiHooks.ts): `src/hooks/apiHooks.ts`
- [Video API](https://github.com/mrnkim/brand-integration-assistant-public/tree/main/src/app/api/videos): `src/app/api/videos`
- [Index API](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/indexes/%5BindexId%5D/route.ts): `src/app/api/indexes/[indexId]/route.ts`
- [Analysis API](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/analyze/route.ts): `src/app/api/analyze/route.ts`
- [Chapter API](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/generateChapters/route.tsx): `src/app/api/generateChapters/route.tsx`

### Search and analysis

- [Text search API](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/search/route.ts): `src/app/api/search/route.ts`
- [Video similarity API](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/embeddingSearch/videoToVideo/route.ts): `src/app/api/embeddingSearch/videoToVideo/route.ts`

### Vector storage

- [Vector API](https://github.com/mrnkim/brand-integration-assistant-public/tree/main/src/app/api/vectors): `src/app/api/vectors`
- [Vector ingestion](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/app/api/vectors/store/route.ts): `src/app/api/vectors/store/route.ts`
- [Pinecone client](https://github.com/mrnkim/brand-integration-assistant-public/blob/main/src/utils/pinecone.ts): `src/utils/pinecone.ts`

### Other components

- **User**
- **Twelve Labs**
- **Pinecone index**

## Connections

- User → Ad library: browses ads (evidence: `README.md`)
- User → Contextual analysis: selects ad (evidence: `README.md`)
- Ad library → Search input: renders (evidence: `src/app/ads-library/page.tsx`)
- Ad library → Search results: renders (evidence: `src/app/ads-library/page.tsx`)
- Search results → API hooks: searches via (evidence: `src/components/SearchResults.tsx`)
- Search results → Result list: renders (evidence: `src/components/SearchResults.tsx`)
- Result list → API hooks: fetches details (evidence: `src/components/SearchResultList.tsx`)
- Result list → Result item: renders (evidence: `src/components/SearchResultList.tsx`)
- Result list → Result preview: opens preview (evidence: `src/components/SearchResultList.tsx`)
- Contextual analysis → Video selector: renders (evidence: `src/app/contextual-analysis/page.tsx`)
- Contextual analysis → Video player: renders (evidence: `src/app/contextual-analysis/page.tsx`)
- Contextual analysis → Similar videos: renders (evidence: `src/app/contextual-analysis/page.tsx`)
- Text search API → Twelve Labs: queries (evidence: `src/app/api/search/route.ts`)
- Video similarity API → Pinecone client: gets index (evidence: `src/app/api/embeddingSearch/videoToVideo/route.ts`)
- Vector API → Pinecone client: uses client (evidence: `src/app/api/vectors/store/route.ts`)
- Vector ingestion → Pinecone client: gets index (evidence: `src/app/api/vectors/store/route.ts`)
- Pinecone client → Pinecone index: accesses (evidence: `src/utils/pinecone.ts`)
