Getting Started

Purpose

Orient developers who are joining the MKP Works Platform or starting a new integration.

Overview

MKP Works is a Django monolith that owns identity, billing, credits, forms, email, AI capabilities, and protected actions for portfolio products.

Where to go next

• Architecture overview — apps and identity chain
• Integrating a product — ClientSite, OIDC, SDKs
• API — Swagger and ReDoc
• Admin guide — staff back office

Documentation workflow

When you finish a meaningful feature, update or add a page in docs/ in the same change.

Examples:

• Authentication → docs/architecture/authentication.md
• Billing changes → docs/architecture/billing.md
• AI gateway changes → docs/architecture/ai.md

mkdocs serve   # live preview while editing
mkdocs build   # produces site/ served at /documentation/

Related Pages

• Decisions — architecture decision records
• Deployment