# monika-kompal/instagram-search architecture

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

- Interactive diagram: https://gitdiagram.com/monika-kompal/instagram-search
- Repository: https://github.com/monika-kompal/instagram-search

## Overview

Instagram Search is a Spring-based API for importing Instagram-post data and finding posts through keyword, natural-language, semantic, and hybrid search, with autocomplete and analytics. The principal search flow runs from an API controller through query parsing or search services to Elasticsearch-backed post data and returns ranked results. Separate indexing and import endpoints support the search corpus. Source excerpts establish several service calls and Elasticsearch operations; other controller-to-service links are supported by the source index. The README is empty, so capability coverage is based on the tree and sampled sources.

Main entry points: [`instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java`](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java) (Semantic search), [`instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java`](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java) (Vector API), [`instagramsearch/src/main/java/com/monika/instagramsearch/service/InstagramPostService.java`](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/InstagramPostService.java) (Keyword search), [`instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java`](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java) (Natural query API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API endpoints"]
  node_search_api["Keyword search API"]
  node_ai_api["Natural query API"]
  node_hybrid_api["Hybrid search API"]
  node_vector_api["Vector API"]
  node_import_api["Import API"]
  node_autocomplete_api["Autocomplete API"]
  node_aggregation_api["Analytics API"]
end

subgraph group_search["Search and discovery"]
  node_post_search["Keyword search"]
  node_hybrid_search["Hybrid ranking"]
  node_autocomplete["Suggestions"]
  node_aggregation["Post analytics"]
end

subgraph group_ai["AI and vectors"]
  node_query_parser["Query parsing"]
  node_parsed_query["Parsed query fields"]
  node_embedding["Embedding generation"]
  node_vector_search["Semantic search"]
end

subgraph group_data["Post data and indexing"]
  node_import_service["Data import"]
  node_post_repository["Post repository"]
  node_post_document["Post document"]
  node_vector_document["Vector document"]
end

node_user(("API client"))
node_anthropic{{"Anthropic API"}}
node_embedding_api{{"Embedding API"}}
node_elasticsearch[("Elasticsearch")]

node_user -->|"searches"| node_search_api
node_user -->|"submits query"| node_ai_api
node_user -->|"searches"| node_hybrid_api
node_user -->|"searches"| node_vector_api
node_user -->|"imports data"| node_import_api
node_user -->|"requests suggestions"| node_autocomplete_api
node_user -->|"requests analytics"| node_aggregation_api
node_search_api -->|"calls"| node_post_search
node_ai_api -->|"parses query"| node_query_parser
node_ai_api -->|"searches posts"| node_post_search
node_query_parser -->|"produces"| node_parsed_query
node_query_parser -->|"requests parsing"| node_anthropic
node_hybrid_api -->|"calls"| node_hybrid_search
node_hybrid_search -->|"gets keyword results"| node_post_search
node_hybrid_search -->|"gets vector results"| node_vector_search
node_vector_api -->|"searches and indexes"| node_vector_search
node_vector_api -->|"loads posts"| node_post_repository
node_vector_api -->|"generates embeddings"| node_embedding
node_vector_search -->|"generates vectors"| node_embedding
node_embedding -->|"requests embeddings"| node_embedding_api
node_vector_search -->|"creates and searches"| node_vector_document
node_post_search -->|"searches posts"| node_elasticsearch
node_autocomplete_api -->|"calls"| node_autocomplete
node_autocomplete -->|"searches suggestions"| node_elasticsearch
node_aggregation_api -->|"calls"| node_aggregation
node_aggregation -->|"aggregates posts"| node_elasticsearch
node_vector_search -->|"queries and saves vectors"| node_elasticsearch
node_import_api -->|"calls"| node_import_service
node_import_service -->|"builds posts"| node_post_document
node_post_repository -->|"stores records"| node_post_document
node_post_repository -.->|"persists posts"| node_elasticsearch
node_vector_document -.->|"vector index"| node_elasticsearch

click node_search_api "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/InstagramPostController.java"
click node_ai_api "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java"
click node_hybrid_api "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/HybridSearchController.java"
click node_vector_api "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java"
click node_import_api "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/DataImportController.java"
click node_autocomplete_api "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/AutoCompleteController.java"
click node_aggregation_api "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/AggregationController.java"
click node_post_search "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/InstagramPostService.java"
click node_hybrid_search "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/HybridSearchService.java"
click node_autocomplete "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/AutoCompleteService.java"
click node_aggregation "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/AggregationService.java"
click node_query_parser "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/AiQueryParserService.java"
click node_parsed_query "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/dto/ParsedQueryDto.java"
click node_embedding "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/EmbeddingService.java"
click node_vector_search "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java"
click node_import_service "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/DataImportService.java"
click node_post_repository "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/repository/InstagramPostRepository.java"
click node_post_document "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/document/InstagramPostDocument.java"
click node_vector_document "https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/document/InstagramPostVectorDocument.java"

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_search_api,node_ai_api,node_hybrid_api,node_vector_api,node_import_api,node_autocomplete_api,node_aggregation_api,node_user toneBlue
class node_post_search,node_hybrid_search,node_autocomplete,node_aggregation,node_elasticsearch toneAmber
class node_query_parser,node_parsed_query,node_embedding,node_vector_search,node_anthropic,node_embedding_api toneMint
class node_import_service,node_post_repository,node_post_document,node_vector_document toneRose
```

## Components

### API endpoints

- [Keyword search API](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/InstagramPostController.java): `instagramsearch/src/main/java/com/monika/instagramsearch/controller/InstagramPostController.java`
- [Natural query API](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java): `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java`
- [Hybrid search API](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/HybridSearchController.java): `instagramsearch/src/main/java/com/monika/instagramsearch/controller/HybridSearchController.java`
- [Vector API](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java): `instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java`
- [Import API](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/DataImportController.java): `instagramsearch/src/main/java/com/monika/instagramsearch/controller/DataImportController.java`
- [Autocomplete API](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/AutoCompleteController.java): `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AutoCompleteController.java`
- [Analytics API](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/controller/AggregationController.java): `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AggregationController.java`

### Search and discovery

- [Keyword search](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/InstagramPostService.java): `instagramsearch/src/main/java/com/monika/instagramsearch/service/InstagramPostService.java`
- [Hybrid ranking](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/HybridSearchService.java): `instagramsearch/src/main/java/com/monika/instagramsearch/service/HybridSearchService.java`
- [Suggestions](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/AutoCompleteService.java): `instagramsearch/src/main/java/com/monika/instagramsearch/service/AutoCompleteService.java`
- [Post analytics](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/AggregationService.java): `instagramsearch/src/main/java/com/monika/instagramsearch/service/AggregationService.java`

### AI and vectors

- [Query parsing](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/AiQueryParserService.java): `instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/AiQueryParserService.java`
- [Parsed query fields](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/dto/ParsedQueryDto.java): `instagramsearch/src/main/java/com/monika/instagramsearch/dto/ParsedQueryDto.java`
- [Embedding generation](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/EmbeddingService.java): `instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/EmbeddingService.java`
- [Semantic search](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java): `instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java`

### Post data and indexing

- [Data import](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/service/DataImportService.java): `instagramsearch/src/main/java/com/monika/instagramsearch/service/DataImportService.java`
- [Post repository](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/repository/InstagramPostRepository.java): `instagramsearch/src/main/java/com/monika/instagramsearch/repository/InstagramPostRepository.java`
- [Post document](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/document/InstagramPostDocument.java): `instagramsearch/src/main/java/com/monika/instagramsearch/document/InstagramPostDocument.java`
- [Vector document](https://github.com/monika-kompal/instagram-search/blob/main/instagramsearch/src/main/java/com/monika/instagramsearch/document/InstagramPostVectorDocument.java): `instagramsearch/src/main/java/com/monika/instagramsearch/document/InstagramPostVectorDocument.java`

### Other components

- **API client**
- **Anthropic API**
- **Embedding API**
- **Elasticsearch**

## Connections

- API client → Keyword search API: searches (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/InstagramPostController.java`)
- API client → Natural query API: submits query (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java`)
- API client → Hybrid search API: searches (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/HybridSearchController.java`)
- API client → Vector API: searches (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java`)
- API client → Import API: imports data (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/DataImportController.java`)
- API client → Autocomplete API: requests suggestions (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AutoCompleteController.java`)
- API client → Analytics API: requests analytics (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AggregationController.java`)
- Keyword search API → Keyword search: calls (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/InstagramPostController.java`)
- Natural query API → Query parsing: parses query (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java`)
- Natural query API → Keyword search: searches posts (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AiSearchController.java`)
- Query parsing → Parsed query fields: produces (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/AiQueryParserService.java`)
- Query parsing → Anthropic API: requests parsing (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/AiQueryParserService.java`)
- Hybrid search API → Hybrid ranking: calls (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/HybridSearchController.java`)
- Hybrid ranking → Keyword search: gets keyword results (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/HybridSearchService.java`)
- Hybrid ranking → Semantic search: gets vector results (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/HybridSearchService.java`)
- Vector API → Semantic search: searches and indexes (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java`)
- Vector API → Post repository: loads posts (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java`)
- Vector API → Embedding generation: generates embeddings (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/VectorSearchController.java`)
- Semantic search → Embedding generation: generates vectors (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java`)
- Embedding generation → Embedding API: requests embeddings (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/EmbeddingService.java`)
- Semantic search → Vector document: creates and searches (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java`)
- Keyword search → Elasticsearch: searches posts (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/InstagramPostService.java`)
- Autocomplete API → Suggestions: calls (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AutoCompleteController.java`)
- Suggestions → Elasticsearch: searches suggestions (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/AutoCompleteService.java`)
- Analytics API → Post analytics: calls (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/AggregationController.java`)
- Post analytics → Elasticsearch: aggregates posts (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/AggregationService.java`)
- Semantic search → Elasticsearch: queries and saves vectors (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/ai/VectorSearchService.java`)
- Import API → Data import: calls (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/controller/DataImportController.java`)
- Data import → Post document: builds posts (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/service/DataImportService.java`)
- Post repository → Post document: stores records (evidence: `instagramsearch/src/main/java/com/monika/instagramsearch/repository/InstagramPostRepository.java`)
- Post repository → Elasticsearch: persists posts
- Vector document → Elasticsearch: vector index
