01 — Architecture

System-level design of the p24-infra platform: how services relate, the element taxonomy used throughout the codebase, and the forward-looking modernisation roadmap.

The architecture follows a hub-and-spoke model: two VPS nodes (vps-i1 and vps-h1) plus four bare-metal OVH servers (bms-1 through bms-4), all observed by a Prometheus/Thanos stack on vps-i1. Application traffic is Pinbox24 on bms-1; the fleet platform (et-operational-platform) lives on Vercel backed by Supabase.

Key Documents

DocumentDescription
architecture.mdHigh-level system architecture diagram and component relationships
elements.mdCanonical element registry — VPSes, containers, SaaS, scripts
infrastructure-overview.mdFull infrastructure map across all projects, servers, and secrets
infrastructure-standard.mdCompliance requirements every new element must satisfy

Evaluation & Roadmap

DocumentDescription
README.mdIndex of all evaluation reports
00-documentation-audit.mdDocumentation coverage audit
01-service-distribution.mdService distribution analysis across servers
02-bms-modernization-plan.mdBMS server modernisation roadmap
03-nightly-ops-and-mongodb.mdMongoDB rs0 nightly operations analysis
04-pinbox24-map-dr-audit.mdPinbox24 disaster-recovery audit

Standards

DocumentDescription
project-standards.mdProject-level conventions and naming rules
element-spec-template.mdTemplate for registering new elements in dev_r_services
workbook-template.mdTemplate for audit-engine workbooks
README.mdImprovement proposals index

Cross-references

  • README — inventory of everything the architecture describes
  • README — naming and element-spec conventions