ADR-009: Shared Feature Pages for Cross-Role Workflows

Status: Accepted
Date: 2026-03-09
Deciders: CepatEdge maintainers

Context

Multiple roles use the same frontend workflows (users/system pages), but older structure mixed role folders and shared concerns.

Decision

Use shared feature pages (domains/shared/pages/*) by default for cross-role workflows, and gate access/actions by permissions. For multi-page shared features, standardize on folder-per-page (list/index.tsx, detail/index.tsx, create/index.tsx) and page-local skeleton files.

Consequences

Positive

• Less duplication across roles
• Clear permission-driven UI behavior
• Better maintainability and migration path to TanStack

Negative

• Role-specific differences must be carefully isolated by action-level gating

Related docs

• docs/frontend/features/shared-vs-role-pages.md
• docs/frontend/architecture/domains.md