Orazaka
Pages of the documentation

Repositories

One GitHub repository per component, what each holds and what it depends on.

🤖 Generated from code by scripts/generate-docs.mjs — do not hand-edit. Run orazaka docs build to refresh.

Orazaka is published as 21 repositories in the krizaka organisation: one per component, plus the workspace orazaka that assembles them (governance contract, orazaka.workspace.json, local infrastructure, end-to-end tests, these docs).

bash
git clone https://github.com/krizaka/orazaka.git && cd orazaka
node scripts/workspace.mjs clone   # every repository at its workspace path
./mvnw install                     # the whole platform, in one reactor

Foundation — reusable by any application

RepositoryKindWhat it holdsDepends on
orazaka-buildmavenParent POM (Spring Boot / Spring AI BOMs, plugin management, Orazaka BOM) and the shared governance test kit (ArchUnit rules, Testcontainers base) for every Orazaka JVM repository.krizaka-build
orazaka-contractsmavenTier-1 platform contracts shared by every Orazaka service: the job plane (jobs-api) and the application-persistence ports (persistence-app-api). Pure interfaces and records, zero implementation. Modules: orazaka-jobs-api, orazaka-persistence-app-api.orazaka-build
orazaka-edgemavenTransparent HTTP edge in front of every Orazaka service: routing, API-key → JWT exchange, CORS and tracing. Spring MVC + virtual threads. Modules: orazaka-edge.orazaka-build
orazaka-ui-kitnpm@krizaka/orazaka-shared (TypeScript types, Zod schemas, design tokens) and @krizaka/orazaka-design-system (React components, Tailwind preset, theme, icon registry) for Next.js and React Native apps.—

Orazaka AI engine

RepositoryKindWhat it holdsDepends on
orazaka-studiomavenStudio & pack marketplace: pack catalogue, studio blueprints, installations and saga-driven runs, with its contract (studio-api) and HTTP client (studio-client). Modules: orazaka-studio-service, orazaka-studio-client, orazaka-studio-api. Owns 80-studio.sql.orazaka-build, orazaka-contracts, krizaka-billing
orazaka-ai-enginemavenThe Orazaka cognitive SDK: AiClient & provider mesh (core), the interceptor pipeline, tools (MCP · RAG · sandbox), use-case orchestration (business), application persistence and asset encryption. Modules: orazaka-assets, orazaka-persistence-app, orazaka-persistence-bridge, orazaka-business, orazaka-interceptors, orazaka-tools, orazaka-core. Owns 60-governance.sql.orazaka-build, orazaka-contracts, krizaka-billing, orazaka-studio
orazaka-conversation-servicemavenInteractive ingress of the Orazaka engine: chat (SSE streaming), intents, models, pipeline, MCP and job APIs — translates transport into Intentions, never business logic. Modules: orazaka-conversation-service. Owns 20-conversation.sql.orazaka-build, orazaka-contracts, krizaka-users, krizaka-billing, orazaka-ai-engine
orazaka-job-servicemavenAsynchronous job executor of the Orazaka engine: drains the interactive and batch lanes, owns the capability registry and the worker registry. Modules: orazaka-job-service. Owns 30-jobs-config.sql.orazaka-build, orazaka-contracts, krizaka-users, krizaka-billing, orazaka-ai-engine
orazaka-knowledge-servicemavenKnowledge & RAG retrieval service (pgvector) with asynchronous indexing. Modules: orazaka-knowledge-service. Owns 40-knowledge.sql.orazaka-build
orazaka-automation-servicemavenConnector automation (Jira, Slack, WhatsApp, Messenger, CLI agents) with Quartz scheduling and execution telemetry. Modules: orazaka-automation-service. Owns 50-automation.sql.orazaka-build, krizaka-billing, orazaka-ai-engine

Native workers

RepositoryKindWhat it holdsDepends on
orazaka-worker-mediapythonNative (Metal) Python worker for image/video generation and media composition, speaking the Orazaka AMQP worker protocol. Modules: orazaka-worker-media.—

Applications

RepositoryKindWhat it holdsDepends on
orazaka-web-clientnpmNext.js (App Router) client of the Orazaka platform with its mandatory BFF. Modules: orazaka-web-client.orazaka-ui-kit
orazaka-mobile-clientnpmExpo / React Native client of the Orazaka platform (talks to the edge with Bearer tokens). Modules: orazaka-mobile-client.orazaka-ui-kit
orazaka-clinpmThe orazaka developer CLI: install, start, dev, test, docs and pack tooling for the Orazaka workspace, with an offline SQLite queue. Modules: orazaka-cli.—

Content

RepositoryKindWhat it holdsDepends on
orazaka-packspacksReference packs for the Orazaka Studio marketplace (document validation, media, prospection, real-estate, wellbeing…) and the pack manifest schema.—

Rules

  • A repository depends only on repositories listed before it in orazaka.workspace.json — the graph has no cycle.
  • A domain repository holds its contract, its client and its service together; other repositories depend on the contract or the client, never on the implementation.
  • A repository owns its context's bootstrap SQL (infra/initdb/NN-*.sql).
  • Cross-repository governance rules run inside the workspace and are reported as skipped — never as passed — in a standalone clone.

View the source on GitHub