BC
Brad CodyAdministrator
Current productShared components and patterns
Reverse spec drafted

Enterprise data grid

Reusable table with selection, sorting, filtering, export, configurable columns, states and row actions.

Observed routeShared componentFuture Spec 16
Current maturityWidely reused grid with inconsistent domain controls
Evidence confidenceVerified
Last reviewedAugust 4, 2026
Visual evidenceDeferred during UI updates

Current-state summary

A shared enterprise grid pattern appears across Teammates, Teams, Role Labels, Tasks and Files. It consistently supports headers, sorting, Export and Columns, with optional search, filters, selection and bulk actions. Domain coverage varies: some grids have rich metrics and filters while others expose only a basic zero state, and shared taxonomies are not always synchronized with builder options.

Interface inventory

Anatomy and verified behavior

Verification states separate observed behavior from requirements or assumptions.

ElementCurrent behaviorVerification
Query controlsSearch, filters and sort appear by domain, but availability and labels vary.Verified across live grids
ColumnsColumn selector is common; persistence and per-user saved views are unverified.Visible
Selection and bulk actionsTasks supports row selection and bulk State change; other domains vary.Verified without mutation
ExportCommon action; output, permission redaction and audit were not exercised.Visible only
StatesLoading, populated and empty states exist but do not always preserve stable layout or explain unavailable functionality.Verified

User journeys

Current flows

01

Find and act on records

  1. Open directory
  2. Resolve authorized dataset
  3. Search/filter/sort
  4. Configure columns
  5. Select permitted records
  6. Preview bulk action
  7. Execute with per-record validation
  8. Audit/export result
Observed result

Discovery pattern works; saved views, export proof and bulk auditing remain incomplete.

State model

Current and expected states

Loading

Some metrics flash zero while records resolve.

Empty

Tables render with domain-specific quality.

Populated

Core row and action patterns are present.

Selected

Bulk controls appear where supported.

Permission redacted

Not explicitly represented.

Product rules

Non-negotiable boundaries

  • All query, count, export and bulk operations use the same permission-scoped dataset.
  • Columns and filters use canonical field definitions.
  • Bulk actions validate each record and return partial-failure detail.
  • Exports never bypass field permissions.
  • Table keyboard and screen-reader semantics are mandatory.
Dependencies
Shared query servicePermissions and RLSField registryExport jobsSaved viewsAudit

Known current limitations · 5 mapped

What is missing, broken or unverified

Future Spec 16 owns closure →
  1. No saved views.
  2. Column persistence unverified.
  3. Export output/audit unverified.
  4. Taxonomy conflicts can make valid records unfilterable.
  5. Loading metrics may briefly misrepresent zero.

Future alignment

Required evolution

  • 01Make the grid a documented shared component with domain adapters.
  • 02Add saved views, URL state, server-side query, accessible virtualization and export jobs.
  • 03Standardize empty, error, redacted and partial-failure states.

Current baseline

Acceptance record

  • Counts and rows reconcile.
  • All visible columns and filters share canonical fields.
  • Export and bulk actions honor permissions.
  • Every state is accessible and explicit.

Reverse-spec completeness

Documentation coverage

The interface is still changing, so visual evidence and repository tracing remain intentionally incomplete.

Purpose and user outcome

Documented

Roles and access

Documented

Routes and entry points

Documented

Page and component anatomy

Documented

Fields and displayed data

Documented

Primary actions

Documented

Forms and validation

Documented

States and transitions

Documented

Empty, loading and error states

Documented

Responsive behavior

Partial

Accessibility behavior

Partial

Activity and audit events

Partial

Data sources and persistence

Documented

Notifications and automation

Partial

Known defects and limitations

Documented

Reusable component dependencies

Documented

Future-spec conflicts

Partial

Visual and repository evidence

Deferred

Acceptance of current baseline

Documented