Developer documentation

Quanta Workspaces Developer Docs

Architecture, APIs, local development, Helm packaging, and operations notes for engineers.

Design Principles

The architecture philosophy behind the current Quanta Workspaces MVP.

Architecture

The control, workspace, edge, and integration planes.

Local Development

Compose smokes and the local MVP workflow.

Helm And Kind

MVP 10 Kubernetes packaging and local chart proof.

API

Control-plane API schema and regeneration workflow.

Operations

Recovery, upgrades, backup targets, and remaining hardening work.

These docs are the developer entrypoint for the current Quanta Workspaces MVP. They explain the design principles behind the implementation, then connect those principles to local development, APIs, packaging, and operations.

The deeper Markdown files under docs/ remain the canonical implementation references. This Hugo site is the shorter conceptual path through the same system.

Current Implementation

The app now includes:

FastAPI/SQLAlchemy control plane with Alembic migrations.
LDAP-backed workspace and SSH identity lookup.
OpenResty public routing for workspace previews, sites, aliases, CDN, CGI, and services.
Forgejo-style deployment hooks.
Nextcloud integration proof.
Matomo log-based analytics.
App-local Helm chart with Kind smoke coverage.

Source References

The canonical repo docs still live under docs/, and the app-local Helm chart lives under deploy/helm/workspace-app.