# ayush-thakur-geek/neuroindexparserservice architecture

> Architecture diagram of the GitHub repository ayush-thakur-geek/neuroindexparserservice, 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/ayush-thakur-geek/neuroindexparserservice
- Repository: https://github.com/ayush-thakur-geek/neuroindexparserservice

## Overview

NeuroIndex Parser accepts user and conversation export files, resolves account/provider details, parses Claude conversations in batches, persists conversations and messages, then fragments message content for semantic indexing. The sampled code confirms this path and embedding-based text chunking; repository details for several other capabilities are visible only through the source index, so their runtime links are omitted where unverified.

Main entry points: [`src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java`](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java) (Export parser), [`src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java`](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java) (Claude ingestion), [`src/main/java/com/NeuroIndex/parser/service/impl/SemanticFragmentationServiceImpl.java`](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/SemanticFragmentationServiceImpl.java) (Semantic fragmentation), [`src/main/java/com/NeuroIndex/parser/controller/ExtractFileIngestionController.java`](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/controller/ExtractFileIngestionController.java) (Ingestion API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Export ingestion"]
  node_controller["Ingestion API"]
  node_export["Export parser"]
  node_filedto["Upload DTO"]
end

subgraph group_process["Conversation processing"]
  node_claudedto["Claude export DTO"]
  node_claude["Claude ingestion"]
end

subgraph group_index["Semantic indexing"]
  node_fragmentation["Semantic fragmentation"]
  node_embedding["Embedding service"]
  node_keyword["Keyword extraction"]
end

subgraph group_persistence["Persistence"]
  node_conversationrepo[("Conversation repository")]
  node_messagerepo[("Message repository<br/>[MessageRepo.java]")]
  node_affiliatedrepo[("Affiliated email repository")]
  node_llmrepo[("LLM repository<br/>[LlmsRepo.java]")]
  node_userrepo[("User repository<br/>[UserRepo.java]")]
  node_fragmentrepo[("Semantic fragment repository")]
end

node_uploader(("Export uploader"))

node_uploader -->|"uploads file"| node_controller
node_controller -->|"dispatches ingestion"| node_export
node_controller -->|"accepts upload"| node_filedto
node_export -->|"reads fields"| node_filedto
node_export -->|"looks up and saves user"| node_userrepo
node_export -->|"looks up account"| node_affiliatedrepo
node_export -->|"looks up provider"| node_llmrepo
node_export -->|"sends batches"| node_claude
node_export -->|"parses records"| node_claudedto
node_claude -->|"saves conversations"| node_conversationrepo
node_claude -->|"checks message hashes"| node_messagerepo
node_claude -->|"uses account data"| node_affiliatedrepo
node_claude -->|"reads conversation fields"| node_claudedto
node_claude -->|"queues messages for"| node_fragmentation
node_fragmentation -->|"requests embeddings"| node_embedding
node_fragmentation -->|"saves fragments"| node_fragmentrepo
node_fragmentation -.->|"may use extraction"| node_keyword

click node_controller "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/controller/ExtractFileIngestionController.java"
click node_export "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java"
click node_filedto "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/dtos/ExtractionFileDTO.java"
click node_claudedto "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/dtos/ClaudeConversationJsonDTO.java"
click node_claude "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java"
click node_conversationrepo "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/ConversationRepo.java"
click node_messagerepo "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/MessageRepo.java"
click node_affiliatedrepo "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/AffiliatedEmailsRepo.java"
click node_llmrepo "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/LlmsRepo.java"
click node_userrepo "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/UserRepo.java"
click node_fragmentation "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/SemanticFragmentationServiceImpl.java"
click node_embedding "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/EmbeddingServiceImpl.java"
click node_keyword "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/KeywordExtractionServiceImpl.java"
click node_fragmentrepo "https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/SemanticFragmentRepo.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_controller,node_export,node_filedto toneBlue
class node_claudedto,node_claude toneAmber
class node_fragmentation,node_embedding,node_keyword toneMint
class node_conversationrepo,node_messagerepo,node_affiliatedrepo,node_llmrepo,node_userrepo,node_fragmentrepo toneRose
class node_uploader toneIndigo
```

## Components

### Export ingestion

- [Ingestion API](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/controller/ExtractFileIngestionController.java): `src/main/java/com/NeuroIndex/parser/controller/ExtractFileIngestionController.java`
- [Export parser](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java): `src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java`
- [Upload DTO](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/dtos/ExtractionFileDTO.java): `src/main/java/com/NeuroIndex/parser/dtos/ExtractionFileDTO.java`

### Conversation processing

- [Claude export DTO](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/dtos/ClaudeConversationJsonDTO.java): `src/main/java/com/NeuroIndex/parser/dtos/ClaudeConversationJsonDTO.java`
- [Claude ingestion](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java): `src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java`

### Semantic indexing

- [Semantic fragmentation](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/SemanticFragmentationServiceImpl.java): `src/main/java/com/NeuroIndex/parser/service/impl/SemanticFragmentationServiceImpl.java`
- [Embedding service](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/EmbeddingServiceImpl.java): `src/main/java/com/NeuroIndex/parser/service/impl/EmbeddingServiceImpl.java`
- [Keyword extraction](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/service/impl/KeywordExtractionServiceImpl.java): `src/main/java/com/NeuroIndex/parser/service/impl/KeywordExtractionServiceImpl.java`

### Persistence

- [Conversation repository](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/ConversationRepo.java): `src/main/java/com/NeuroIndex/parser/repositories/ConversationRepo.java`
- [Message repository](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/MessageRepo.java): `src/main/java/com/NeuroIndex/parser/repositories/MessageRepo.java`
- [Affiliated email repository](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/AffiliatedEmailsRepo.java): `src/main/java/com/NeuroIndex/parser/repositories/AffiliatedEmailsRepo.java`
- [LLM repository](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/LlmsRepo.java): `src/main/java/com/NeuroIndex/parser/repositories/LlmsRepo.java`
- [User repository](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/UserRepo.java): `src/main/java/com/NeuroIndex/parser/repositories/UserRepo.java`
- [Semantic fragment repository](https://github.com/ayush-thakur-geek/neuroindexparserservice/blob/main/src/main/java/com/NeuroIndex/parser/repositories/SemanticFragmentRepo.java): `src/main/java/com/NeuroIndex/parser/repositories/SemanticFragmentRepo.java`

### Other components

- **Export uploader**

## Connections

- Export uploader → Ingestion API: uploads file (evidence: `src/main/java/com/NeuroIndex/parser/controller/ExtractFileIngestionController.java`)
- Ingestion API → Export parser: dispatches ingestion (evidence: `src/main/java/com/NeuroIndex/parser/controller/ExtractFileIngestionController.java`)
- Ingestion API → Upload DTO: accepts upload (evidence: `src/main/java/com/NeuroIndex/parser/controller/ExtractFileIngestionController.java`)
- Export parser → Upload DTO: reads fields (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java`)
- Export parser → User repository: looks up and saves user (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java`)
- Export parser → Affiliated email repository: looks up account (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java`)
- Export parser → LLM repository: looks up provider (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java`)
- Export parser → Claude ingestion: sends batches (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java`)
- Export parser → Claude export DTO: parses records (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ExportFileIngestionServiceImpl.java`)
- Claude ingestion → Conversation repository: saves conversations (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java`)
- Claude ingestion → Message repository: checks message hashes (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java`)
- Claude ingestion → Affiliated email repository: uses account data (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java`)
- Claude ingestion → Claude export DTO: reads conversation fields (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java`)
- Claude ingestion → Semantic fragmentation: queues messages for (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/ClaudeIngestionServiceImpl.java`)
- Semantic fragmentation → Embedding service: requests embeddings (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/SemanticFragmentationServiceImpl.java`)
- Semantic fragmentation → Semantic fragment repository: saves fragments (evidence: `src/main/java/com/NeuroIndex/parser/service/impl/SemanticFragmentationServiceImpl.java`)
- Semantic fragmentation → Keyword extraction: may use extraction
