ArchitectureSubdomain Plan

Subdomain Plan

Septimius follows the canonical Kennis Capital subdomain architecture. As the ecosystem orchestrator, Septimius hosts more surfaces than most portfolio products because it owns the shared platform layer.

Active Subdomains

SubdomainStatusPurpose
septimius.ioLiveMarketing site
app.septimius.ioLiveEcosystem dashboard, KORA AI, portfolio management
docs.septimius.ioLiveDocumentation wiki (this site)
api.septimius.ioLivePlatform API on Fly.io

Planned Subdomains

SubdomainPhasePurpose
admin.septimius.ioPhase 2Platform admin — feature flags, user support, audit log
cms.septimius.ioPhase 2Manuscr CMS for ecosystem-wide editorial content
console.septimius.ioPhase 2Developer portal — API keys, SDK docs, webhook config
staging.septimius.ioActiveStaging application for QA
api-staging.septimius.ioActiveStaging API on Fly.io

DNS Configuration

All subdomains use Cloudflare DNS:

RecordTargetProxied
septimius.iocname.vercel-dns.comYes
app.septimius.iocname.vercel-dns.comYes
docs.septimius.iocname.vercel-dns.comYes
api.septimius.ioFly.io anycast IPsNo (Fly manages TLS)

The api.septimius.io record is DNS-only (no Cloudflare proxy) because Cloudflare proxying conflicts with Fly’s ALPN negotiation.

Platform API Surface

The Septimius Platform API (/api/platform/v1) is the shared API that all portfolio products consume. It provides:

  • Tenant resolution from JWT authentication context
  • User management — CRUD for users, teams, and organisations
  • Cross-product SSO — session validation across product boundaries
  • KORA routing — AI request routing to the Assembler with product-specific config
  • Analytics — cross-product usage telemetry and dashboards

Products call the Platform API using the X-Kennis-Product header to identify themselves. See the Kennis OS KORA integration guide for the full request contract.