Orazaka
Documentation
GitHub
Pour les développeurs

Orazaka is one GitHub repository per component — users, notifications, billing, the AI engine, the UI kit… This map, generated from the workspace manifest, shows what each repository holds and what it depends on, so you can reuse only what your application needs.

Repositories

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

Orazaka is published as 20 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.—
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.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.—

Domain services — reusable by any application

RepositoryKindWhat it holdsDepends on
orazaka-usersmavenReusable user management for any Krizaka application: registration, e-mail verification, login (password + Google/GitHub OAuth), forgot/reset password, profile & preferences, API keys, RBAC and JWT issuance. Modules: orazaka-persistence-identity, orazaka-identity, orazaka-identity-service. Owns 10-identity.sql.orazaka-build
orazaka-notificationsmavenChannel-based notification delivery for any Krizaka application: e-mail (SMTP), SMS (Twilio) and webhooks behind one DeliveryClient port, driven by platform events (user registered, password reset) or explicit notification requests over AMQP. Modules: orazaka-notification-service.orazaka-build
orazaka-billingmavenCredits, wallets, plans, subscriptions, pricebook and metering (hold → settle → release) as a reusable billing service, with its contract (billing-api) and a typed HTTP client (billing-client). Modules: orazaka-billing-client, orazaka-billing-service. Owns 70-billing.sql.orazaka-build

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-client, orazaka-studio-service. Owns 80-studio.sql.orazaka-build, orazaka-contracts, orazaka-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-persistence-app, orazaka-core, orazaka-interceptors, orazaka-business, orazaka-tools. Owns 60-governance.sql.orazaka-build, orazaka-contracts, orazaka-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, orazaka-users, orazaka-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, orazaka-users, orazaka-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, orazaka-billing

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-web-adminnpmNext.js SecOps & administration console of the Orazaka platform. Modules: orazaka-web-admin.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.