Skip to content

Architecture MODULE ARCHITECTURE

github-actions[bot] edited this page Sep 15, 2026 · 6 revisions

Navigation: Home > Architecture

Cross-Module Architecture Inventory

Scope

  • This document inventories all 72 top-level src/ module paths in the current repository clone.
  • Code-footprint counts come from colocated C/C++ files under src/<module>/; direct dependency counts come from module-prefix #include edges found under src/** and include/**.
  • The grouping below is a cross-module review aid; it does not replace module-local contracts in src/<module>/ARCHITECTURE.md and src/<module>/ROADMAP.md.

Layer Summary

Layer Modules Notes
Core Infrastructure 5 source-backed grouping for cross-module review
Storage & Persistence 7 source-backed grouping for cross-module review
Query & Processing 9 source-backed grouping for cross-module review
Index & Search 3 includes docs-only module paths
LLM & AI 18 includes docs-only module paths
Server & API 5 source-backed grouping for cross-module review
Security & Auth 4 source-backed grouping for cross-module review
Distributed Systems 9 source-backed grouping for cross-module review
Observability & Hardening 3 source-backed grouping for cross-module review
Data Integration 7 source-backed grouping for cross-module review
Extensibility & Lifecycle 1 source-backed grouping for cross-module review
Source-root Docs & Analysis 1 non-runtime support path under src/

Core Infrastructure

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
base 10 4 0 runtime code-bearing path src/base/ARCHITECTURE.md Β· src/base/ROADMAP.md Β· include/base/
config 6 1 5 runtime code-bearing path src/config/ARCHITECTURE.md Β· src/config/ROADMAP.md Β· include/config/
core 12 9 7 runtime code-bearing path src/core/ARCHITECTURE.md Β· src/core/ROADMAP.md Β· include/core/
themis 11 9 23 high-integration runtime hub src/themis/ARCHITECTURE.md Β· src/themis/ROADMAP.md Β· include/themis/
utils 48 8 51 high-integration runtime hub src/utils/ARCHITECTURE.md Β· src/utils/ROADMAP.md Β· include/utils/

Storage & Persistence

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
access_model 6 1 2 runtime code-bearing path src/access_model/ARCHITECTURE.md Β· src/access_model/ROADMAP.md Β· include/access_model/
cache 17 8 5 runtime code-bearing path src/cache/ARCHITECTURE.md Β· src/cache/ROADMAP.md Β· include/cache/
metadata 12 6 7 runtime code-bearing path src/metadata/ARCHITECTURE.md Β· src/metadata/ROADMAP.md Β· include/metadata/
storage 64 13 35 high-integration runtime hub src/storage/ARCHITECTURE.md Β· src/storage/ROADMAP.md Β· include/storage/
temporal 15 1 2 runtime code-bearing path src/temporal/ARCHITECTURE.md Β· src/temporal/ROADMAP.md Β· include/temporal/
timeseries 26 2 4 runtime code-bearing path src/timeseries/ARCHITECTURE.md Β· src/timeseries/ROADMAP.md Β· include/timeseries/
tensor 24 5 4 runtime code-bearing path src/tensor/ARCHITECTURE.md Β· src/tensor/ROADMAP.md Β· include/tensor/

Query & Processing

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
analytics 30 7 10 high-integration runtime hub src/analytics/ARCHITECTURE.md Β· src/analytics/ROADMAP.md Β· include/analytics/
aql 25 11 4 high-integration runtime hub src/aql/ARCHITECTURE.md Β· src/aql/ROADMAP.md Β· include/aql/
execution 2 0 0 thin code-bearing path src/execution/ARCHITECTURE.md Β· src/execution/ROADMAP.md Β· include/execution/
graph 17 10 4 high-integration runtime hub src/graph/ARCHITECTURE.md Β· src/graph/ROADMAP.md Β· include/graph/
process 25 5 0 runtime code-bearing path src/process/ARCHITECTURE.md Β· src/process/ROADMAP.md Β· include/process/
query 73 17 15 high-integration runtime hub src/query/ARCHITECTURE.md Β· src/query/ROADMAP.md Β· include/query/
retrieval 2 0 0 thin code-bearing path src/retrieval/ARCHITECTURE.md Β· src/retrieval/ROADMAP.md Β· include/retrieval/
scheduler 10 9 3 runtime code-bearing path src/scheduler/ARCHITECTURE.md Β· src/scheduler/ROADMAP.md Β· include/scheduler/
search 22 9 0 runtime code-bearing path src/search/ARCHITECTURE.md Β· src/search/ROADMAP.md Β· include/search/

Index & Search

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
geo 25 5 6 runtime code-bearing path src/geo/ARCHITECTURE.md Β· src/geo/ROADMAP.md Β· include/geo/
index 44 11 25 high-integration runtime hub src/index/ARCHITECTURE.md Β· src/index/ROADMAP.md Β· include/index/
vector_search 0 0 0 docs-only module path; no colocated C/C++ implementation files src/vector_search/ARCHITECTURE.md Β· src/vector_search/ROADMAP.md

LLM & AI

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
acceleration 29 6 8 runtime code-bearing path src/acceleration/ARCHITECTURE.md Β· src/acceleration/ROADMAP.md Β· include/acceleration/
ai 2 4 0 thin code-bearing path src/ai/ARCHITECTURE.md Β· src/ai/ROADMAP.md Β· include/ai/
distributed_tensor 37 3 0 runtime code-bearing path src/distributed_tensor/ARCHITECTURE.md Β· src/distributed_tensor/ROADMAP.md Β· include/distributed_tensor/
ethics_ai 30 4 3 runtime code-bearing path src/ethics_ai/ARCHITECTURE.md Β· src/ethics_ai/ROADMAP.md Β· include/ethics_ai/
evaluation 14 0 0 runtime code-bearing path src/evaluation/ARCHITECTURE.md Β· src/evaluation/ROADMAP.md Β· include/evaluation/
gpu 44 3 1 runtime code-bearing path src/gpu/ARCHITECTURE.md Β· src/gpu/ROADMAP.md Β· include/gpu/
image_analysis 2 1 0 thin code-bearing path src/image_analysis/ARCHITECTURE.md Β· src/image_analysis/ROADMAP.md Β· src/image_analysis/
llama_cpp 8 3 1 runtime code-bearing path src/llama_cpp/ARCHITECTURE.md Β· src/llama_cpp/ROADMAP.md Β· include/llama_cpp/
llm 189 22 18 high-integration runtime hub src/llm/ARCHITECTURE.md Β· src/llm/ROADMAP.md Β· include/llm/
llm_streaming 0 0 0 docs-only module path; no colocated C/C++ implementation files src/llm_streaming/ARCHITECTURE.md Β· src/llm_streaming/ROADMAP.md
llm_wiki 9 4 0 runtime code-bearing path src/llm_wiki/ARCHITECTURE.md Β· src/llm_wiki/ROADMAP.md Β· include/llm_wiki/
onnx_clip 2 1 0 thin code-bearing path src/onnx_clip/ARCHITECTURE.md Β· src/onnx_clip/ROADMAP.md Β· include/onnx_clip/
prompt_engineering 36 6 3 runtime code-bearing path src/prompt_engineering/ARCHITECTURE.md Β· src/prompt_engineering/ROADMAP.md Β· include/prompt_engineering/
rag 71 16 7 high-integration runtime hub src/rag/ARCHITECTURE.md Β· src/rag/ROADMAP.md Β· include/rag/
stable_diffusion 7 2 0 runtime code-bearing path src/stable_diffusion/ARCHITECTURE.md Β· src/stable_diffusion/ROADMAP.md Β· include/stable_diffusion/
training 16 8 1 runtime code-bearing path src/training/ARCHITECTURE.md Β· src/training/ROADMAP.md Β· include/training/
voice 24 3 1 runtime code-bearing path src/voice/ARCHITECTURE.md Β· src/voice/ROADMAP.md Β· include/voice/
whisper 7 1 0 runtime code-bearing path src/whisper/ARCHITECTURE.md Β· src/whisper/ROADMAP.md Β· include/whisper/

Server & API

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
api 11 9 3 runtime code-bearing path src/api/ARCHITECTURE.md Β· src/api/ROADMAP.md Β· include/api/
network 30 9 2 runtime code-bearing path src/network/ARCHITECTURE.md Β· src/network/ROADMAP.md Β· include/network/
rpc_grpc 4 1 0 runtime code-bearing path src/rpc_grpc/ARCHITECTURE.md Β· src/rpc_grpc/ROADMAP.md Β· include/rpc_grpc/
scraper 10 1 0 runtime code-bearing path src/scraper/ARCHITECTURE.md Β· src/scraper/ROADMAP.md Β· include/scraper/
server 123 35 4 high-integration runtime hub src/server/ARCHITECTURE.md Β· src/server/ROADMAP.md Β· include/server/

Security & Auth

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
auth 37 3 3 runtime code-bearing path src/auth/ARCHITECTURE.md Β· src/auth/ROADMAP.md Β· include/auth/
governance 35 4 5 runtime code-bearing path src/governance/ARCHITECTURE.md Β· src/governance/ROADMAP.md Β· include/governance/
security 52 7 20 high-integration runtime hub src/security/ARCHITECTURE.md Β· src/security/ROADMAP.md Β· include/security/
user_storage_encrypted 5 1 0 runtime code-bearing path src/user_storage_encrypted/ARCHITECTURE.md Β· src/user_storage_encrypted/ROADMAP.md Β· include/user_storage_encrypted/

Distributed Systems

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
cdc 13 3 9 runtime code-bearing path src/cdc/ARCHITECTURE.md Β· src/cdc/ROADMAP.md Β· include/cdc/
distributed_knowledge 5 2 8 runtime code-bearing path src/distributed_knowledge/ARCHITECTURE.md Β· src/distributed_knowledge/ROADMAP.md Β· include/distributed_knowledge/
failover 4 3 0 runtime code-bearing path src/failover/ARCHITECTURE.md Β· src/failover/ROADMAP.md Β· include/failover/
maintenance 3 6 1 thin code-bearing path src/maintenance/ARCHITECTURE.md Β· src/maintenance/ROADMAP.md Β· include/maintenance/
projects 7 2 1 runtime code-bearing path src/projects/ARCHITECTURE.md Β· src/projects/ROADMAP.md Β· include/projects/
replication 13 2 2 runtime code-bearing path src/replication/ARCHITECTURE.md Β· src/replication/ROADMAP.md Β· include/replication/
sharding 95 6 14 high-integration runtime hub src/sharding/ARCHITECTURE.md Β· src/sharding/ROADMAP.md Β· include/sharding/
transaction 20 8 6 runtime code-bearing path src/transaction/ARCHITECTURE.md Β· src/transaction/ROADMAP.md Β· include/transaction/
updates 25 5 1 runtime code-bearing path src/updates/ARCHITECTURE.md Β· src/updates/ROADMAP.md Β· include/updates/

Observability & Hardening

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
chaos 1 0 0 thin code-bearing path src/chaos/ARCHITECTURE.md Β· src/chaos/ROADMAP.md Β· include/chaos/
observability 31 5 17 high-integration runtime hub src/observability/ARCHITECTURE.md Β· src/observability/ROADMAP.md Β· include/observability/
performance 31 3 8 runtime code-bearing path src/performance/ARCHITECTURE.md Β· src/performance/ROADMAP.md Β· include/performance/

Data Integration

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
chimera 7 3 0 runtime code-bearing path src/chimera/ARCHITECTURE.md Β· src/chimera/ROADMAP.md Β· include/chimera/
content 47 8 5 runtime code-bearing path src/content/ARCHITECTURE.md Β· src/content/ROADMAP.md Β· include/content/
document 2 3 2 thin code-bearing path src/document/ARCHITECTURE.md Β· src/document/ROADMAP.md Β· include/document/
exporters 16 6 2 runtime code-bearing path src/exporters/ARCHITECTURE.md Β· src/exporters/ROADMAP.md Β· include/exporters/
importers 48 3 2 runtime code-bearing path src/importers/ARCHITECTURE.md Β· src/importers/ROADMAP.md Β· include/importers/
ingestion 38 6 6 runtime code-bearing path src/ingestion/ARCHITECTURE.md Β· src/ingestion/ROADMAP.md Β· include/ingestion/
toolbox 11 5 2 runtime code-bearing path src/toolbox/ARCHITECTURE.md Β· src/toolbox/ROADMAP.md Β· include/toolbox/

Extensibility & Lifecycle

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
plugins 10 5 14 high-integration runtime hub src/plugins/ARCHITECTURE.md Β· src/plugins/ROADMAP.md Β· include/plugins/

Source-root Docs & Analysis

Module C/C++ files Direct module deps Direct consumers Current footprint signal Primary anchors
ai_working 0 0 0 source-root evidence and working-notes path src/ai_working/

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

ThemisDB Wiki

🏠 Overview

πŸš€ Getting Started

πŸ“– Tutorials

πŸ“— User Guide

βš™οΈ Operations & Security

πŸ“Ÿ Ops Runbooks

πŸ—οΈ Architecture

πŸ“ ADRs

πŸ”§ Contributing

πŸ“‹ Governance

πŸ” Audit

🧩 Plugins

πŸ”Œ Adapters

πŸ’‘ Examples

πŸ“¦ Client SDKs

πŸŽ“ Training

πŸ› οΈ Tools

πŸ€– Developer LLM Wiki

Clone this wiki locally