Capabilities Layer

Intent

Deliver independent capabilities as bounded contexts that interact only via events and the workspace context.

Structure Rules

• Keep each capability cohesive: UI + application orchestration + domain model (if needed).
• Do not create cross-capability imports for business logic; communicate via events.

State Management

• Use @ngrx/signals stores as the source of truth for capability state.
• Derive view state via computed signals; avoid mutable arrays/objects and avoid .push().
• Async side effects run through rxMethod + tapResponse with explicit operator choice.

Event-Driven Interactions

• Publish domain/application events after persistence (append-before-publish).
• Subscribe to events in application stores/effects, not in presentation components.

UI Rules

• Standalone, zone-less components.
• Templates bind to signals only and use Angular control flow (@if, @for, @switch, @defer).
• Material Design 3 token usage only; no hardcoded colors.

Data Boundaries

• Infrastructure returns Observables/Promises; convert to signals before templates.
• Do not leak Firebase/DataConnect DTOs outside integration/infrastructure.

Testing Expectations

• Cover critical flows with unit tests for store transitions and Playwright for happy paths.
• Use stable selectors (data-testid, roles/labels).