Aller au contenu

Operator Console (OP) — Architecture

Module: OP — operator-console · Plane: Application · Target: V1 (V0 envelope active) · Story prefix: OP-NNN API namespace: /api/operator/... · Frontend app: frontend/operator/ · Spring module: com.altarys.papillon.pcs.operator

This architecture is split into two files for readability. Read them in order.

Index

Part File Sections
Part 1 — Domain & API part1-domain-and-api.md §0 V0 Envelope · §1 System Context · §2 Data Model · §3 API Design · §4 Multi-Tenant Strategy · §5 Connectivity & Operator Minimum Offline · §6 Core Domain Logic & Async Processing · §7 Transaction Management & Failure Modes · §8 Sequence Diagrams · §9 Security · §10 Performance & Bandwidth Budget · §11 Migration Strategy
Part 2 — Integrations, Build & Ops part2-integrations-build-ops.md §12 Integration Points · §13 Frontend Architecture · §14 Deployment & Configuration · §15 Monitoring, Observability & SLOs · §16 Vertical Slice Decomposition · §17 Technical Risks · §18 Test Infrastructure · §19 Local Dev Environment · §20 Known Technical Debt · §21 References · Appendix A — ADRs (OP-ADR-01..06) · Appendix B — Open Questions (OQ-OP-01..05 + forward-look)

Cross-part table of contents

Part 1 — Domain & API - §0 V0 Envelope — Module Scope by Sub-Version - §1 System Context - §2 Data Model - §3 API Design - §4 Multi-Tenant Strategy - §5 Connectivity & Operator Minimum Offline - §6 Core Domain Logic & Async Processing - §7 Transaction Management & Failure Modes - §8 Sequence Diagrams - §9 Security - §10 Performance & Bandwidth Budget - §11 Migration Strategy

Part 2 — Integrations, Build & Ops - §12 Integration Points - §13 Frontend Architecture (React 19.2) - §14 Deployment & Configuration - §15 Monitoring, Observability & SLOs - §16 Vertical Slice Decomposition - §17 Technical Risks - §18 Test Infrastructure - §19 Local Dev Environment - §20 Known Technical Debt & Forward-Compat Markers - §21 References - Appendix A — Architecture Decision Records (OP-ADR-01..06) - Appendix B — Open Questions (OQ-OP-01..05 + OQ-OP-F1..F5)

Status

Draft — awaiting founder approval (workflow stage 4). Document version 1.1 (2026-05-23 review pass against prd-v0.md).