searchxng-project/projects/shared/ARCHITECTURE.md

Shared Architecture

Request flow

1. User searches on SearXNG.
2. Custom engines query SethSearch API (json_engine).
3. SethSearch reads SQLite FTS5 index and applies source-specific scoring.
4. SearXNG merges with other web engines and renders response.

Data model

• DB: /opt/sethsearch/articles.db
• Main table: documents
• FTS table: documents_fts

Reliability pattern

• Source sync jobs run independently.
• Failures in one source do not block other source updates.
• systemd restart policy keeps service resilient.