MarginaliaSearch/code/services-core/query-service
Viktor Lofgren 2ad0bfda1e (*) Fix boot orchestration for the services
This corrects an annoying bug that had the system crash and burn on first start-up due to a race condition in service initialization, where the services were attempting to access the database before it was properly migrated.

A fix was in principle already in place, but it was running too late and did not prevent attempts to access the as-yet uninitialized database.  Move the first boot check into the MainClass instead of the Service constructor.

The change also adds more appropriate docker dependencies to the services to fix rare errors resolving the hostname of the database.
2024-05-01 12:39:48 +02:00
..
java/nu/marginalia/query (*) Fix boot orchestration for the services 2024-05-01 12:39:48 +02:00
resources (qs) Additional info in query debug UI 2024-04-24 14:44:39 +02:00
build.gradle (build) Java 22 and its consequences has been a disaster for Marginalia Search 2024-04-24 14:44:39 +02:00
readme.md (docs) Begin un-fucking the docs after refactoring 2024-02-27 21:22:21 +01:00

The query service parses search queries and delegates work to the index services.

The index-service speaks a lower level query specification language that is difficult to build an application out of. The query service exists as an interpreter to that format.

Web Interface

The query service also offers a basic web interface for testing queries, or running the search engine as a white-label service without all the Marginalia Search specific stuff. This mode of operations is available through a barebones install.

The web interface also offers a JSON API for machine-based queries.

Central Classes

This module is almost entirely boilerplate, except the QueryBasicInterface class, which offers a REST API for querying the index.

Much of the guts of the query service are in the query-service module; which offers query parsing and an interface to the index service partitions.