index

Architecture (shared, effect-app)

This folder holds cross-project effect-app architecture that is synced between multiple effect-app applications. Changes here may affect other repos.

For app-specific architecture, see ../app-architecture/index.md. Entry point for both: ../architecture.md.

Technical architecture

• Database query guidelines
• Import / Naming rules
• Resource and Controller Layout
• Query Shape: List vs Get
• Command Pattern for Mutations
• Command Input Validation
• Durable Workflows & DurableDeferred — idempotency keys, resume vs restart, write-once deferred slots, token routing, compensation vs ensuring, replay-safe activities.
• Streams and Realtime Progress
• List Layout: per-item Actions
• Vue Conventions
• OmegaForm
• Playwright POM design