Skip to content

PMP-001 Architecture Specification

PMP-001 is the authoritative architecture specification for PotatoLabs.

It defines how the PotatoLabs Developer Platform supports the full product lifecycle:

Create Product -> GitLab repository -> code-server -> git branch -> development -> validation -> build -> release -> deployment -> monitoring

Purpose

PMP-001 provides a stable reference for how PotatoLabs designs, builds, deploys, and operates products on the PotatoLabs platform.

Scope

This specification covers:

  • Architecture principles
  • PotatoLabs platform architecture
  • PDP architecture
  • Product architecture
  • System architecture
  • Service boundaries
  • Data and storage architecture
  • Communication and API boundaries
  • Deployment architecture
  • Security architecture
  • Observability and operational architecture
  • Architecture Decision Records
  • Rules for architectural exceptions

Authoritative rule

Where any other documentation conflicts with PMP-001, PMP-001 wins unless an approved architectural exception says otherwise.