---
title: Explanation
description: Understand the design, consistency, and search behavior of Omnio-js.
---

## About the explanation [#about-explanation]

Explanation describes how Omnio-js works and why it is designed this way. For procedures, see the [how-to guides](/omnio-js/en/how-to); for exact specifications, see the [reference](/omnio-js/en/reference).

## Sections [#sections]

**[Architecture](/omnio-js/en/explanation/architecture)**

The roles of entities, indexes, and embedders, and how data flows.

**[Consistency and lifecycle](/omnio-js/en/explanation/consistency-and-lifecycle)**

Locks, visibility, deletion, and crash recovery.

**[How semantic search works](/omnio-js/en/explanation/semantic-search)**

Embeddings, scoring, and reindexing.
