Alpha (platform kernel). Suitable for demos and custom modules. Not for production or regulated workloads.
Core DevAlpha

How the kernel runs

Sumeru is one Go process: PostgreSQL, XML metadata, and a SWC workspace inside a server-rendered shell. Addons register models. They do not fork core/.

Boot and install

  1. Config points at PostgreSQL and addons_path.
  2. The module loader reads each manifest.json and orders modules by depends.
  3. Schema sync adds columns for installed models. It does not drop columns.
  4. XML data loads security, views, and actions. View inherits (inherit_id) apply in a second pass.

Kernel modules and their depends are listed on Kernel addons. platform, currency, uom, geo, i18n, im, and audit auto-install with base.

Open and save a record

  1. The shell loads /static/swc/swc.js.
  2. GET /web/swc/workspace returns the merged view arch and rows.
  3. Reads and writes go through model ACL, field ACL, and record rules, then SQL.
  4. POST /api/rpc is the same path for the client and for API keys. There is no public REST API.

Diagram and package map: Architecture layers.

Subsystems

  • ORM — CRUD, domains, compute
  • SDK — the addon import surface
  • Event bus and cron — in-process events, sys.cron, PostgreSQL NOTIFY for the SWC socket
  • Web and render and SWC
  • Auth: password, OIDC providers, TOTP, trusted device. See sumeru/docs/sso.md in the kernel repo.
  • Ops: sumeru/docs/ops-runbook.md, sumeru/docs/ha-ops.md, sumeru/docs/ddl-policy.md

Change the kernel

From sumeru/, make runs lint, SWC, and Go tests. Go tests live under sumeru/test/. SWC tests live under sumeru/core/swc/tests/. Addon code should call sumeru/core/sdk rather than importing core/orm directly.

What is partial or absent: Limitations. Mail has outbound and in-app messages, not inbound IMAP. Portal is a shell and share links. Studio, a website CMS, and an offline client are not in the kernel.