# sashank321/a-7_dsa-3_g-7 architecture

> Architecture diagram of the GitHub repository sashank321/a-7_dsa-3_g-7, 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/sashank321/a-7_dsa-3_g-7
- Repository: https://github.com/sashank321/a-7_dsa-3_g-7

## Overview

StrataSearch is a document-search and analysis platform: users provide documents and queries, the backend stores corpus sessions, profiles the corpus, plans and runs searches, and returns results and analysis through a workspace UI. The documented capabilities also include similarity and duplicate analysis, citation graphs, algorithm visualization, and benchmarking. The excerpts establish the gateway, corpus, planner, search, and benchmark relationships; unsampled feature branches are represented from the README without asserting internal call paths.

Main entry points: [`stratasearch-backend/src/main/java/com/stratasearch/backend/engine/EngineGateway.java`](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/engine/EngineGateway.java) (Core gateway), [`stratasearch-frontend/src/pages/WorkspacePage.tsx`](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-frontend/src/pages/WorkspacePage.tsx) (Workspace), [`stratasearch-frontend/src/components/workspace`](https://github.com/sashank321/a-7_dsa-3_g-7/tree/main/stratasearch-frontend/src/components/workspace) (Visualization panels), [`stratasearch-backend/src/main/java/com/stratasearch/backend/service/CorpusService.java`](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/service/CorpusService.java) (Corpus service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_workspace["Workspace<br/>[WorkspacePage.tsx]"]
  node_queryui["Query panel<br/>[QueryPanel.tsx]"]
  node_visualui["Visualization panels"]
end

subgraph group_backend["Backend API"]
  node_backendapi["Backend API"]
  node_corpusctl["Corpus controller"]
  node_searchctl["Search controller"]
  node_plannerctl["Planner controller"]
  node_gateway["Core gateway<br/>[EngineGateway.java]"]
  node_searchservice["Search service<br/>[SearchService.java]"]
end

subgraph group_core["Search and analysis core"]
  node_planner["Query planner<br/>[QueryPlanner.java]"]
  node_explain["Plan explanations"]
  node_searchengine["Search engine<br/>[SearchEngine.java]"]
  node_algorithms["Match algorithms"]
end

subgraph group_insights["Analysis capabilities"]
  node_benchmark["Benchmark engine"]
  node_profiler["Corpus profiler"]
  node_similarity["Similarity analysis"]
  node_citation["Citation graph"]
  node_visualization["Algorithm visualization"]
end

subgraph group_state["Corpus and jobs"]
  node_corpus["Corpus service<br/>[CorpusService.java]"]
  node_sessions[("Corpus sessions<br/>[SessionStore.java]")]
  node_jobs["Job processing<br/>[JobExecutor.java]"]
end

node_user(("Research user"))

node_user -->|"uses"| node_workspace
node_workspace -.->|"offers queries"| node_queryui
node_queryui -.->|"submits search"| node_searchctl
node_corpusctl -.->|"uploads documents"| node_corpus
node_corpus -->|"profiles corpus"| node_gateway
node_corpus -->|"saves session"| node_sessions
node_searchctl -.->|"handles search"| node_searchservice
node_searchservice -->|"resolves corpus"| node_corpus
node_searchservice -->|"requests search"| node_gateway
node_plannerctl -.->|"serves planning"| node_backendapi
node_plannerctl -.->|"requests plan"| node_gateway
node_gateway -->|"plans queries"| node_planner
node_gateway -->|"executes search"| node_searchengine
node_searchengine -->|"dispatches search"| node_algorithms
node_gateway -->|"measures runs"| node_benchmark
node_gateway -->|"profiles documents"| node_profiler
node_planner -.->|"explains plan"| node_explain
node_workspace -.->|"shows analysis"| node_visualui
node_visualui -.->|"displays benchmarks"| node_benchmark
node_visualui -->|"shows relationships"| node_citation
node_visualui -->|"plays algorithm steps"| node_visualization
node_workspace -.->|"requests comparisons"| node_similarity

click node_workspace "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-frontend/src/pages/WorkspacePage.tsx"
click node_queryui "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-frontend/src/components/workspace/QueryPanel.tsx"
click node_visualui "https://github.com/sashank321/a-7_dsa-3_g-7/tree/main/stratasearch-frontend/src/components/workspace"
click node_backendapi "https://github.com/sashank321/a-7_dsa-3_g-7/tree/main/stratasearch-backend/src/main/java/com/stratasearch/backend/controller"
click node_corpusctl "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/controller/CorpusController.java"
click node_searchctl "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/controller/SearchController.java"
click node_plannerctl "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/controller/PlannerController.java"
click node_corpus "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/service/CorpusService.java"
click node_sessions "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/model/SessionStore.java"
click node_jobs "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/service/JobExecutor.java"
click node_gateway "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/engine/EngineGateway.java"
click node_searchservice "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/service/SearchService.java"
click node_planner "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/planner/QueryPlanner.java"
click node_explain "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/planner/ExplainabilityEngine.java"
click node_searchengine "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/engine/SearchEngine.java"
click node_algorithms "https://github.com/sashank321/a-7_dsa-3_g-7/tree/main/stratasearch-core/src/main/java/stratasearch/algorithms"
click node_benchmark "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/engine/BenchmarkEngine.java"
click node_profiler "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/profiler/CorpusProfiler.java"
click node_similarity "https://github.com/sashank321/a-7_dsa-3_g-7/tree/main/stratasearch-core/src/main/java/stratasearch"
click node_citation "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-frontend/src/components/workspace/CitationGraphPanel.tsx"
click node_visualization "https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-frontend/src/components/workspace/VisualizationPlayer.tsx"

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_workspace,node_queryui,node_visualui,node_user toneBlue
class node_backendapi,node_corpusctl,node_searchctl,node_plannerctl,node_gateway,node_searchservice toneAmber
class node_planner,node_explain,node_searchengine,node_algorithms toneMint
class node_benchmark,node_profiler,node_similarity,node_citation,node_visualization toneRose
class node_corpus,node_sessions,node_jobs toneIndigo
```

## Components

### User interface

- [Workspace](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-frontend/src/pages/WorkspacePage.tsx): `stratasearch-frontend/src/pages/WorkspacePage.tsx`
- [Query panel](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-frontend/src/components/workspace/QueryPanel.tsx): `stratasearch-frontend/src/components/workspace/QueryPanel.tsx`
- [Visualization panels](https://github.com/sashank321/a-7_dsa-3_g-7/tree/main/stratasearch-frontend/src/components/workspace): `stratasearch-frontend/src/components/workspace`

### Backend API

- [Backend API](https://github.com/sashank321/a-7_dsa-3_g-7/tree/main/stratasearch-backend/src/main/java/com/stratasearch/backend/controller): `stratasearch-backend/src/main/java/com/stratasearch/backend/controller`
- [Corpus controller](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/controller/CorpusController.java): `stratasearch-backend/src/main/java/com/stratasearch/backend/controller/CorpusController.java`
- [Search controller](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/controller/SearchController.java): `stratasearch-backend/src/main/java/com/stratasearch/backend/controller/SearchController.java`
- [Planner controller](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/controller/PlannerController.java): `stratasearch-backend/src/main/java/com/stratasearch/backend/controller/PlannerController.java`
- [Core gateway](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/engine/EngineGateway.java): `stratasearch-backend/src/main/java/com/stratasearch/backend/engine/EngineGateway.java`
- [Search service](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/service/SearchService.java): `stratasearch-backend/src/main/java/com/stratasearch/backend/service/SearchService.java`

### Search and analysis core

- [Query planner](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/planner/QueryPlanner.java): `stratasearch-core/src/main/java/stratasearch/planner/QueryPlanner.java`
- [Plan explanations](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/planner/ExplainabilityEngine.java): `stratasearch-core/src/main/java/stratasearch/planner/ExplainabilityEngine.java`
- [Search engine](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/engine/SearchEngine.java): `stratasearch-core/src/main/java/stratasearch/engine/SearchEngine.java`
- [Match algorithms](https://github.com/sashank321/a-7_dsa-3_g-7/tree/main/stratasearch-core/src/main/java/stratasearch/algorithms): `stratasearch-core/src/main/java/stratasearch/algorithms`

### Analysis capabilities

- [Benchmark engine](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/engine/BenchmarkEngine.java): `stratasearch-core/src/main/java/stratasearch/engine/BenchmarkEngine.java`
- [Corpus profiler](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-core/src/main/java/stratasearch/profiler/CorpusProfiler.java): `stratasearch-core/src/main/java/stratasearch/profiler/CorpusProfiler.java`
- [Similarity analysis](https://github.com/sashank321/a-7_dsa-3_g-7/tree/main/stratasearch-core/src/main/java/stratasearch): `stratasearch-core/src/main/java/stratasearch`
- [Citation graph](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-frontend/src/components/workspace/CitationGraphPanel.tsx): `stratasearch-frontend/src/components/workspace/CitationGraphPanel.tsx`
- [Algorithm visualization](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-frontend/src/components/workspace/VisualizationPlayer.tsx): `stratasearch-frontend/src/components/workspace/VisualizationPlayer.tsx`

### Corpus and jobs

- [Corpus service](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/service/CorpusService.java): `stratasearch-backend/src/main/java/com/stratasearch/backend/service/CorpusService.java`
- [Corpus sessions](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/model/SessionStore.java): `stratasearch-backend/src/main/java/com/stratasearch/backend/model/SessionStore.java`
- [Job processing](https://github.com/sashank321/a-7_dsa-3_g-7/blob/main/stratasearch-backend/src/main/java/com/stratasearch/backend/service/JobExecutor.java): `stratasearch-backend/src/main/java/com/stratasearch/backend/service/JobExecutor.java`

### Other components

- **Research user**

## Connections

- Research user → Workspace: uses (evidence: `README.md`)
- Workspace → Query panel: offers queries
- Query panel → Search controller: submits search
- Corpus controller → Corpus service: uploads documents
- Corpus service → Core gateway: profiles corpus (evidence: `stratasearch-backend/src/main/java/com/stratasearch/backend/service/CorpusService.java`)
- Corpus service → Corpus sessions: saves session (evidence: `stratasearch-backend/src/main/java/com/stratasearch/backend/service/CorpusService.java`)
- Search controller → Search service: handles search
- Search service → Corpus service: resolves corpus (evidence: `stratasearch-backend/src/main/java/com/stratasearch/backend/service/SearchService.java`)
- Search service → Core gateway: requests search (evidence: `stratasearch-backend/src/main/java/com/stratasearch/backend/service/SearchService.java`)
- Planner controller → Backend API: serves planning
- Planner controller → Core gateway: requests plan
- Core gateway → Query planner: plans queries (evidence: `stratasearch-backend/src/main/java/com/stratasearch/backend/engine/EngineGateway.java`)
- Core gateway → Search engine: executes search (evidence: `stratasearch-backend/src/main/java/com/stratasearch/backend/engine/EngineGateway.java`)
- Search engine → Match algorithms: dispatches search (evidence: `stratasearch-core/src/main/java/stratasearch/engine/SearchEngine.java`)
- Core gateway → Benchmark engine: measures runs (evidence: `stratasearch-backend/src/main/java/com/stratasearch/backend/engine/EngineGateway.java`)
- Core gateway → Corpus profiler: profiles documents (evidence: `stratasearch-backend/src/main/java/com/stratasearch/backend/engine/EngineGateway.java`)
- Query planner → Plan explanations: explains plan
- Workspace → Visualization panels: shows analysis
- Visualization panels → Benchmark engine: displays benchmarks
- Visualization panels → Citation graph: shows relationships (evidence: `README.md`)
- Visualization panels → Algorithm visualization: plays algorithm steps (evidence: `README.md`)
- Workspace → Similarity analysis: requests comparisons
