# angular2guy/aidocumentlibrarychat architecture

> Architecture diagram of the GitHub repository angular2guy/aidocumentlibrarychat, 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/angular2guy/aidocumentlibrarychat
- Repository: https://github.com/angular2guy/aidocumentlibrarychat

## Overview

AIDocumentLibraryChat is an Angular and Spring AI application centered on document-grounded chat: users upload documents, the backend extracts and chunks content, stores embeddings, retrieves related content for questions, and returns answers with source links. The product also supports image search, natural-language relational-data queries, book/API search, code generation, summaries, and MCP tools. The README documents these capabilities; sampled source confirms document ingestion/retrieval and table-query steps, but not every feature’s wiring.

Main entry points: [`frontend/src/angular/src/app/app.routes.ts`](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/frontend/src/angular/src/app/app.routes.ts) (Angular app), [`backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java`](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java) (Document service), [`backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/DocumentController.java`](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/DocumentController.java) (Document API), [`backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/TableService.java`](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/TableService.java) (Table search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_angular_app["Angular app<br/>[app.routes.ts]"]
end

subgraph group_documents["Document library"]
  node_document_api["Document API"]
  node_document_service["Document service"]
  node_summary_service["Book summaries"]
end

subgraph group_ai_search["AI search features"]
  node_table_api["Table API"]
  node_table_service["Table search<br/>[TableService.java]"]
  node_image_api["Image API"]
  node_image_service["Image search<br/>[ImageService.java]"]
end

subgraph group_integrations["AI integrations"]
  node_function_api["Function API"]
  node_function_service["Book lookup"]
  node_code_api["Code API"]
  node_code_service["Test generation"]
  node_mcp_api["MCP client API"]
  node_mcp_client["MCP client"]
  node_mcp_server["MCP server"]
end

subgraph group_persistence["Data access"]
  node_document_store[("Document records<br/>[Document.java]")]
  node_vector_store[("Vector repository")]
  node_metadata["Search metadata<br/>[MetaData.java]"]
end

node_user(("User"))
node_github["GitHub"]

node_user -->|"uses"| node_angular_app
node_angular_app -.->|"uploads and searches"| node_document_api
node_document_api -->|"delegates to"| node_document_service
node_document_service -->|"saves and loads"| node_document_store
node_document_service -->|"adds and retrieves"| node_vector_store
node_document_service -->|"tags chunks"| node_metadata
node_angular_app -.->|"asks questions"| node_table_api
node_table_api -.->|"delegates to"| node_table_service
node_table_service -->|"retrieves metadata"| node_vector_store
node_table_service -->|"filters by type"| node_metadata
node_angular_app -.->|"searches images"| node_image_api
node_image_api -.->|"delegates to"| node_image_service
node_image_service -.->|"queries embeddings"| node_vector_store
node_angular_app -.->|"requests book lookup"| node_function_api
node_function_api -.->|"delegates to"| node_function_service
node_angular_app -.->|"requests test draft"| node_code_api
node_code_api -->|"delegates to"| node_code_service
node_code_service -->|"reads source"| node_github
node_angular_app -.->|"requests tools"| node_mcp_api
node_mcp_api -.->|"delegates to"| node_mcp_client
node_mcp_client -.->|"calls tools"| node_mcp_server
node_document_api -->|"requests summaries"| node_summary_service

click node_angular_app "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/frontend/src/angular/src/app/app.routes.ts"
click node_document_api "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/DocumentController.java"
click node_document_service "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java"
click node_document_store "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/domain/model/entity/Document.java"
click node_vector_store "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/domain/model/entity/DocumentVsRepository.java"
click node_metadata "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/domain/common/MetaData.java"
click node_table_api "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/TableController.java"
click node_table_service "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/TableService.java"
click node_image_api "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/ImageController.java"
click node_image_service "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/ImageService.java"
click node_function_api "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/FunctionController.java"
click node_function_service "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/FunctionService.java"
click node_code_api "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/CodeGenerationController.java"
click node_code_service "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/CodeGenerationService.java"
click node_mcp_api "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/McpClientController.java"
click node_mcp_client "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/LocalMcpClient.java"
click node_mcp_server "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/mcp-server/src/main/java/ch/xxx/mcpserver/McpServerApplication.java"
click node_summary_service "https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.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_angular_app,node_user toneBlue
class node_document_api,node_document_service,node_summary_service toneAmber
class node_table_api,node_table_service,node_image_api,node_image_service toneMint
class node_function_api,node_function_service,node_code_api,node_code_service,node_mcp_api,node_mcp_client,node_mcp_server toneRose
class node_document_store,node_vector_store,node_metadata,node_github toneIndigo
```

## Components

### Web client

- [Angular app](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/frontend/src/angular/src/app/app.routes.ts): `frontend/src/angular/src/app/app.routes.ts`

### Document library

- [Document API](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/DocumentController.java): `backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/DocumentController.java`
- [Document service](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java): `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java`
- [Book summaries](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java): `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java`

### AI search features

- [Table API](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/TableController.java): `backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/TableController.java`
- [Table search](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/TableService.java): `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/TableService.java`
- [Image API](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/ImageController.java): `backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/ImageController.java`
- [Image search](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/ImageService.java): `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/ImageService.java`

### AI integrations

- [Function API](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/FunctionController.java): `backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/FunctionController.java`
- [Book lookup](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/FunctionService.java): `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/FunctionService.java`
- [Code API](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/CodeGenerationController.java): `backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/CodeGenerationController.java`
- [Test generation](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/CodeGenerationService.java): `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/CodeGenerationService.java`
- [MCP client API](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/McpClientController.java): `backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/McpClientController.java`
- [MCP client](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/LocalMcpClient.java): `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/LocalMcpClient.java`
- [MCP server](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/mcp-server/src/main/java/ch/xxx/mcpserver/McpServerApplication.java): `mcp-server/src/main/java/ch/xxx/mcpserver/McpServerApplication.java`

### Data access

- [Document records](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/domain/model/entity/Document.java): `backend/src/main/java/ch/xxx/aidoclibchat/domain/model/entity/Document.java`
- [Vector repository](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/domain/model/entity/DocumentVsRepository.java): `backend/src/main/java/ch/xxx/aidoclibchat/domain/model/entity/DocumentVsRepository.java`
- [Search metadata](https://github.com/angular2guy/aidocumentlibrarychat/blob/master/backend/src/main/java/ch/xxx/aidoclibchat/domain/common/MetaData.java): `backend/src/main/java/ch/xxx/aidoclibchat/domain/common/MetaData.java`

### Other components

- **User**
- **GitHub**

## Connections

- User → Angular app: uses
- Angular app → Document API: uploads and searches
- Document API → Document service: delegates to (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/DocumentController.java`)
- Document service → Document records: saves and loads (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java`)
- Document service → Vector repository: adds and retrieves (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java`)
- Document service → Search metadata: tags chunks (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/DocumentService.java`)
- Angular app → Table API: asks questions
- Table API → Table search: delegates to
- Table search → Vector repository: retrieves metadata (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/TableService.java`)
- Table search → Search metadata: filters by type (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/TableService.java`)
- Angular app → Image API: searches images
- Image API → Image search: delegates to
- Image search → Vector repository: queries embeddings (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/ImageService.java`)
- Angular app → Function API: requests book lookup
- Function API → Book lookup: delegates to
- Angular app → Code API: requests test draft
- Code API → Test generation: delegates to (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/CodeGenerationController.java`)
- Test generation → GitHub: reads source (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/usecase/service/CodeGenerationService.java`)
- Angular app → MCP client API: requests tools
- MCP client API → MCP client: delegates to
- MCP client → MCP server: calls tools
- Document API → Book summaries: requests summaries (evidence: `backend/src/main/java/ch/xxx/aidoclibchat/adapter/controller/DocumentController.java`)
