Skip to content

Architecture

Purpose

MKP Works Platform is a modular Django monolith that owns identity, credentials, billing, credits, communication, authorization, and usage accounting for portfolio products.

Overview

Layout

  • accounts — custom user model and session login
  • sites_registry — portfolio ClientSite registry
  • capabilities — capability + SiteCapability enablement
  • forms_gateway / leads / email_gateway — forms and mail
  • billing / wallets / actions — Stripe, ledger, reservations, protected actions
  • ai_gateway — named AI capabilities
  • api — DRF public + server APIs
  • dashboard — customer UI
  • sdk — JS hosting + Python client + generator
  • landing — public developer portal and Platform Control Center

Identity chain

Email/password → MKP User → Django OAuth Toolkit OIDC → portfolio product

Configuration

Environment variables in .env.example. Settings split under mkpworks/settings/.

Security

Staff tools live under /admin/ with Django session auth. Portfolio clients never receive AI/Stripe secrets. Ledger is append-only.