Architecture MODULE ARCHITECTURE INDEX

ThemisDB Module Architecture Index

Version: 1.0
Last Updated: 2026-04-06
Status: Complete

---

Overview

Each src/<module>/ directory contains an ARCHITECTURE.md file that documents its design, components, data flows, integration points, configuration, and security considerations. This file is the index of those per-module guides.

For the overall system architecture see the root ARCHITECTURE.md. For the source directory inventory see [[SOURCE_DIRECTORY_GUIDE.md|Architecture-SOURCE-DIRECTORY-GUIDE]].

---

Module Architecture Guides

Core Infrastructure

Module	Guide	Status
src/base/	[[ARCHITECTURE.md	Module-base-Architecture]]
src/utils/	[[ARCHITECTURE.md	Module-utils-Architecture]]
src/core/	[[ARCHITECTURE.md	Module-core-Architecture]]
src/config/	[[ARCHITECTURE.md	Module-config-Architecture]]
src/themis/	[[ARCHITECTURE.md	Module-themis-Architecture]]

Storage & Persistence

Module	Guide	Status
src/storage/	[[ARCHITECTURE.md	Module-storage-Architecture]]
src/cache/	[[ARCHITECTURE.md	Module-cache-Architecture]]
src/transaction/	[[ARCHITECTURE.md	Module-transaction-Architecture]]
src/temporal/	[[ARCHITECTURE.md	Module-temporal-Architecture]]
src/timeseries/	[[ARCHITECTURE.md	Module-timeseries-Architecture]]

Query & Processing

Module	Guide	Status
src/query/	[[ARCHITECTURE.md	Module-query-Architecture]]
src/aql/	[[ARCHITECTURE.md	Module-aql-Architecture]]
src/analytics/	[[ARCHITECTURE.md	Module-analytics-Architecture]]
src/metadata/	[[ARCHITECTURE.md	Module-metadata-Architecture]]

Index & Search

Module	Guide	Status
src/index/	[[ARCHITECTURE.md	Module-index-Architecture]]
src/search/	[[ARCHITECTURE.md	Module-search-Architecture]]
src/geo/	[[ARCHITECTURE.md	Module-geo-Architecture]]
src/graph/	[[ARCHITECTURE.md	Module-graph-Architecture]]

LLM & AI

Module	Guide	Status
src/llm/	[[ARCHITECTURE.md	Module-llm-Architecture]]
src/rag/	[[ARCHITECTURE.md	Module-rag-Architecture]]
src/prompt_engineering/	[[ARCHITECTURE.md	Module-prompt-engineering-Architecture]]
src/training/	[[ARCHITECTURE.md	Module-training-Architecture]]
src/acceleration/	[[ARCHITECTURE.md	Module-acceleration-Architecture]]
src/gpu/	[[ARCHITECTURE.md	Module-gpu-Architecture]]

Server & API

Module	Guide	Status
src/server/	[[ARCHITECTURE.md	Module-server-Architecture]]
src/api/	[[ARCHITECTURE.md	Module-api-Architecture]]
src/network/	[[ARCHITECTURE.md	Module-network-Architecture]]
src/voice/	[[ARCHITECTURE.md	Module-voice-Architecture]]

Security & Auth

Module	Guide	Status
src/auth/	[[ARCHITECTURE.md	Module-auth-Architecture]]
src/security/	[[ARCHITECTURE.md	Module-security-Architecture]]
src/governance/	[[ARCHITECTURE.md	Module-governance-Architecture]]

Distributed Systems

Module	Guide	Status
src/sharding/	[[ARCHITECTURE.md	Module-sharding-Architecture]]
src/replication/	[[ARCHITECTURE.md	Module-replication-Architecture]]
src/cdc/	[[ARCHITECTURE.md	Module-cdc-Architecture]]

Observability

Module	Guide	Status
src/observability/	[[ARCHITECTURE.md	Module-observability-Architecture]]
src/performance/	[[ARCHITECTURE.md	Module-performance-Architecture]]

Data Integration

Module	Guide	Status
src/ingestion/	[[ARCHITECTURE.md	Module-ingestion-Architecture]]
src/importers/	[[ARCHITECTURE.md	Module-importers-Architecture]]
src/exporters/	[[ARCHITECTURE.md	Module-exporters-Architecture]]
src/content/	[[ARCHITECTURE.md	Module-content-Architecture]]

Extensibility & Lifecycle

Module	Guide	Status
src/plugins/	[[ARCHITECTURE.md	Module-plugins-Architecture]]
src/scheduler/	[[ARCHITECTURE.md	Module-scheduler-Architecture]]
src/updates/	[[ARCHITECTURE.md	Module-updates-Architecture]]
src/chimera/	[[ARCHITECTURE.md	Module-chimera-Architecture]]

---

How to Use These Guides

1. New contributors – start with ARCHITECTURE.md (root), then read the guides for the modules you are working on.
2. Feature development – check the module guide for the target module to understand how the component fits in, what interfaces to implement against, and how to test.
3. Bug investigation – the Data Flow section of each guide traces the path of a request; use it to identify which component handles a given operation.
4. Cross-module changes – the Integration Points table in each guide lists what a module depends on and what consumes it.

---

Guide Conventions

Each ARCHITECTURE.md follows this structure:

1. Overview – what the module does
2. Design Principles – key architectural decisions
3. Component Architecture – key files and a component diagram
4. Data Flow – how data moves through the module
5. Integration Points – what the module depends on and exposes
6. Threading & Concurrency Model – how concurrency is handled
7. Performance Architecture – key optimization techniques
8. Security Considerations – security properties and threats
9. Configuration – key configuration parameters
10. Error Handling – how errors are handled
11. Known Limitations & Future Work – open items
12. References – links to READMEs, docs, papers

---

Last updated automatically by the architecture guide generation process.

---

ThemisDB 1.9.0-beta · Home · Module-Index · GitHub · Issues