# geekychris/local_log_search architecture

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

- Interactive diagram: https://gitdiagram.com/geekychris/local_log_search
- Repository: https://github.com/geekychris/local_log_search

## Overview

Little Log Peep is a local log search and analysis application, with a desktop-file indexing mode. Users configure sources, ingest and parse files into Lucene indices, search across indices, refine results with facets or pipe commands, and export or query saved tables. The README documents the principal log-ingestion and search flow; the source index confirms several core implementations. Other feature branches are retained from README/tree evidence, but their internal call paths are not inferred where source was not sampled.

Main entry points: [`log-search-service/src/main/java/com/locallogsearch/service/LocalLogSearchApplication.java`](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/LocalLogSearchApplication.java) (Spring application), [`log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java`](https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java) (Search and facets), [`log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java`](https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java) (Desktop indexing), [`log-search-core/src/main/java/com/locallogsearch/core/tailer/TailerManager.java`](https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/tailer/TailerManager.java) (File tailing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_service["Service API"]
  node_application["Spring application"]
  node_sources["Source management"]
  node_search_api["Search endpoint"]
  node_index_api["Index management"]
end

subgraph group_ingestion["Log Ingestion"]
  node_tailer["File tailing<br/>[TailerManager.java]"]
  node_log_parser["Log parsers"]
  node_index_manager["Lucene indexing<br/>[IndexManager.java]"]
  node_lucene[("Lucene indices")]
end

subgraph group_desktop["Desktop Files"]
  node_desktop_api["Desktop source API"]
  node_desktop_manager["Desktop indexing"]
  node_file_parsers["Document parsers"]
end

subgraph group_search["Search Analysis"]
  node_search_service["Search and facets<br/>[SearchService.java]"]
  node_pipe_parser["Pipe query parser"]
  node_pipe_commands["Pipe operations"]
end

subgraph group_data["Exports and AI"]
  node_export_api["Export endpoint"]
  node_export_service["Table export<br/>[ExportService.java]"]
  node_table_store[("Exported tables")]
  node_sql_api["SQL query UI"]
  node_ai_api["Query assistance"]
  node_ai_services["AI helpers"]
end

node_user(("Web or API user"))
node_ollama["Ollama model"]
node_log_files["Local log files"]

node_user -->|"uses UI/API"| node_application
node_application -->|"routes source requests"| node_sources
node_application -->|"routes searches"| node_search_api
node_application -->|"routes index requests"| node_index_api
node_log_files -->|"new entries"| node_tailer
node_tailer -->|"parses lines"| node_log_parser
node_log_parser -->|"adds documents"| node_index_manager
node_index_manager -->|"commits index"| node_lucene
node_sources -->|"manages sources"| node_tailer
node_user -->|"configures files"| node_desktop_api
node_desktop_api -.->|"requests indexing"| node_desktop_manager
node_desktop_manager -.->|"parses files"| node_file_parsers
node_desktop_manager -->|"indexes documents"| node_index_manager
node_search_api -->|"submits query"| node_search_service
node_search_service -->|"queries indices"| node_lucene
node_search_service -->|"parses pipe syntax"| node_pipe_parser
node_search_service -->|"executes operations"| node_pipe_commands
node_user -->|"requests export"| node_export_api
node_export_api -.->|"exports results"| node_export_service
node_export_service -->|"persists tables"| node_table_store
node_user -->|"queries exported data"| node_sql_api
node_user -.->|"requests assistance"| node_ai_api
node_ai_api -->|"delegates requests"| node_ai_services
node_ai_services -->|"prompts model"| node_ollama

click node_application "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/LocalLogSearchApplication.java"
click node_sources "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/LogSourceController.java"
click node_search_api "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/SearchController.java"
click node_index_api "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/IndexController.java"
click node_tailer "https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/tailer/TailerManager.java"
click node_log_parser "https://github.com/geekychris/local_log_search/tree/main/log-search-core/src/main/java/com/locallogsearch/core/parser"
click node_index_manager "https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/index/IndexManager.java"
click node_desktop_api "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/DesktopSourceController.java"
click node_desktop_manager "https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java"
click node_file_parsers "https://github.com/geekychris/local_log_search/tree/main/log-search-core/src/main/java/com/locallogsearch/core/desktop/parser"
click node_search_service "https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java"
click node_pipe_parser "https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/pipe/PipeQueryParser.java"
click node_pipe_commands "https://github.com/geekychris/local_log_search/tree/main/log-search-core/src/main/java/com/locallogsearch/core/pipe/commands"
click node_export_api "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/ExportController.java"
click node_export_service "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/export/ExportService.java"
click node_table_store "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/repository/ExportedTableRepository.java"
click node_sql_api "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/SqlQueryController.java"
click node_ai_api "https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/QueryHelperController.java"
click node_ai_services "https://github.com/geekychris/local_log_search/tree/main/log-search-service/src/main/java/com/locallogsearch/service/ai"

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_application,node_sources,node_search_api,node_index_api,node_user toneBlue
class node_tailer,node_log_parser,node_index_manager,node_lucene toneAmber
class node_desktop_api,node_desktop_manager,node_file_parsers toneMint
class node_search_service,node_pipe_parser,node_pipe_commands toneRose
class node_export_api,node_export_service,node_table_store,node_sql_api,node_ai_api,node_ai_services,node_ollama,node_log_files toneIndigo
```

## Components

### Service API

- [Spring application](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/LocalLogSearchApplication.java): `log-search-service/src/main/java/com/locallogsearch/service/LocalLogSearchApplication.java`
- [Source management](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/LogSourceController.java): `log-search-service/src/main/java/com/locallogsearch/service/controller/LogSourceController.java`
- [Search endpoint](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/SearchController.java): `log-search-service/src/main/java/com/locallogsearch/service/controller/SearchController.java`
- [Index management](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/IndexController.java): `log-search-service/src/main/java/com/locallogsearch/service/controller/IndexController.java`

### Log Ingestion

- [File tailing](https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/tailer/TailerManager.java): `log-search-core/src/main/java/com/locallogsearch/core/tailer/TailerManager.java`
- [Log parsers](https://github.com/geekychris/local_log_search/tree/main/log-search-core/src/main/java/com/locallogsearch/core/parser): `log-search-core/src/main/java/com/locallogsearch/core/parser`
- [Lucene indexing](https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/index/IndexManager.java): `log-search-core/src/main/java/com/locallogsearch/core/index/IndexManager.java`
- **Lucene indices**

### Desktop Files

- [Desktop source API](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/DesktopSourceController.java): `log-search-service/src/main/java/com/locallogsearch/service/controller/DesktopSourceController.java`
- [Desktop indexing](https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java): `log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java`
- [Document parsers](https://github.com/geekychris/local_log_search/tree/main/log-search-core/src/main/java/com/locallogsearch/core/desktop/parser): `log-search-core/src/main/java/com/locallogsearch/core/desktop/parser`

### Search Analysis

- [Search and facets](https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java): `log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java`
- [Pipe query parser](https://github.com/geekychris/local_log_search/blob/main/log-search-core/src/main/java/com/locallogsearch/core/pipe/PipeQueryParser.java): `log-search-core/src/main/java/com/locallogsearch/core/pipe/PipeQueryParser.java`
- [Pipe operations](https://github.com/geekychris/local_log_search/tree/main/log-search-core/src/main/java/com/locallogsearch/core/pipe/commands): `log-search-core/src/main/java/com/locallogsearch/core/pipe/commands`

### Exports and AI

- [Export endpoint](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/ExportController.java): `log-search-service/src/main/java/com/locallogsearch/service/controller/ExportController.java`
- [Table export](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/export/ExportService.java): `log-search-service/src/main/java/com/locallogsearch/service/export/ExportService.java`
- [Exported tables](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/repository/ExportedTableRepository.java): `log-search-service/src/main/java/com/locallogsearch/service/repository/ExportedTableRepository.java`
- [SQL query UI](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/SqlQueryController.java): `log-search-service/src/main/java/com/locallogsearch/service/controller/SqlQueryController.java`
- [Query assistance](https://github.com/geekychris/local_log_search/blob/main/log-search-service/src/main/java/com/locallogsearch/service/controller/QueryHelperController.java): `log-search-service/src/main/java/com/locallogsearch/service/controller/QueryHelperController.java`
- [AI helpers](https://github.com/geekychris/local_log_search/tree/main/log-search-service/src/main/java/com/locallogsearch/service/ai): `log-search-service/src/main/java/com/locallogsearch/service/ai`

### Other components

- **Web or API user**
- **Ollama model**
- **Local log files**

## Connections

- Web or API user → Spring application: uses UI/API
- Spring application → Source management: routes source requests
- Spring application → Search endpoint: routes searches
- Spring application → Index management: routes index requests
- Local log files → File tailing: new entries
- File tailing → Log parsers: parses lines
- Log parsers → Lucene indexing: adds documents
- Lucene indexing → Lucene indices: commits index
- Source management → File tailing: manages sources
- Web or API user → Desktop source API: configures files
- Desktop source API → Desktop indexing: requests indexing
- Desktop indexing → Document parsers: parses files (evidence: `log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java`)
- Desktop indexing → Lucene indexing: indexes documents (evidence: `log-search-core/src/main/java/com/locallogsearch/core/desktop/DesktopIndexerManager.java`)
- Search endpoint → Search and facets: submits query
- Search and facets → Lucene indices: queries indices
- Search and facets → Pipe query parser: parses pipe syntax (evidence: `log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java`)
- Search and facets → Pipe operations: executes operations (evidence: `log-search-core/src/main/java/com/locallogsearch/core/search/SearchService.java`)
- Web or API user → Export endpoint: requests export
- Export endpoint → Table export: exports results
- Table export → Exported tables: persists tables (evidence: `log-search-service/src/main/java/com/locallogsearch/service/export/ExportService.java`)
- Web or API user → SQL query UI: queries exported data
- Web or API user → Query assistance: requests assistance
- Query assistance → AI helpers: delegates requests (evidence: `log-search-service/src/main/java/com/locallogsearch/service/controller/QueryHelperController.java`)
- AI helpers → Ollama model: prompts model (evidence: `log-search-service/src/main/java/com/locallogsearch/service/ai/QueryHelperService.java`)
