07 — Feature Source of Truth

07 — Feature Source of Truth

Generated: 2026-04-24 Status: Active

This document defines canonical feature ownership for ongoing work.

App-owned UI model

Dashboard screen ownership is app-local.

The rule:

Dashboard pages and route-facing composition belong in apps/dashboard/src/features/*.

Canonical path for new dashboard screens:

apps/dashboard/src/features/{domain}/pages/

Feature package policy

packages/feature-* packages are reusable logic layers, not screen owners.

Allowed in packages/feature-*:

• query key factories and query option helpers
• mutation helpers
• API transport wrappers
• feature types and schemas
• reusable feature UI components

Not allowed in packages/feature-*:

• dashboard page components
• route composition files
• route option bundles
• dashboard-screen orchestration

Current package decisions

Package	Decision	Notes
@legaciti/feature-activity	keep	Reusable activity logic and UI primitives across consumers
@legaciti/feature-people	reduce	Reusable people core only; page composition remains app-local
@legaciti/feature-publications	reduce	Reusable publications core only; page composition app-local

Current app-local features

These areas are canonical as app-local features:

• admin
• admin-users
• auth
• bug-reports
• dashboard
• email-templates
• integrations
• projects
• site-tools
• version-sync
• works
• workspace-settings
• workspace-users

Where new work goes

If you are adding…	Put it in…
New people page or screen	apps/dashboard/src/features/people/pages/
New people query/mutation/API wrapper	packages/feature-people/src/
New publications page or screen	apps/dashboard/src/features/publications/pages/
New publications query/mutation/API wrapper	packages/feature-publications/src/
New activity page or screen	apps/dashboard/src/features/activity/pages/
New activity query/mutation/API wrapper	packages/feature-activity/src/
New workspace settings API/query or page UI	apps/dashboard/src/features/workspace-settings/
New integrations page or component	apps/dashboard/src/features/integrations/
New workspace user-management logic or UI	apps/dashboard/src/features/workspace-users/
New superadmin user-access logic or UI	apps/dashboard/src/features/admin-users/

Source documents

• Detailed package audit: docs/architecture/17-feature-package-audit.md
• Placement rules: docs/architecture/01-code-placement.md
• Dependency rules: docs/architecture/03-dependency-rules.md