Standardize Record Status Indicators (Source-Check + Coverage Dots)

[OAGr]

Standardize Record Status Indicators — Implementation Plan

TL;DR

Source-check dots (RecordVerificationDot) are inconsistently placed across 12+ tables — sometimes inline-left in the name cell, sometimes as a dedicated 2nd column, only once on the right. Coverage dots (data completeness indicators) only exist on the /organizations list page. This plan creates a unified RecordStatusCell component that places both indicators as the rightmost column in all record tables, with coverage dots added where useful.

Problem

Users see source-check verification dots in different positions across different tables, making them hard to scan consistently. The dot position should be standardized to always appear on the right side of tables. Additionally, data completeness indicators (coverage dots) should be shown alongside source-check dots where records have meaningful variation in metadata completeness.

Current State

Table	File	Dot Position	Coverage
People tab (org page)	people-section.tsx	LEFT inline in Name cell	None
Divisions section (org page)	divisions-section.tsx	LEFT inline in Name cell + card	None
Programs section (org page)	programs-section.tsx	LEFT inline in Program cell	None
Funding rounds (org page)	main-content-sections.tsx	LEFT inline in Round cell	None
Investments (org page)	main-content-sections.tsx	LEFT inline in Investor cell	None
Equity section (org page)	equity-section.tsx	LEFT inline in Holder cell	None
Grants table (org page)	interactive-grants-table.tsx	2nd column "✓"	None
Career history (person page)	career-history.tsx	LEFT inline in card	None
Divisions page (/divisions)	divisions-table.tsx	LEFT inline in Division cell	None
Funding programs (/funding-programs)	funding-programs-table.tsx	LEFT inline in Program cell	None
Funding rounds (/funding-rounds)	funding-rounds-table.tsx	LEFT inline in Round cell	None
Entity DB page	entity-profile-viewer.tsx	RIGHT last column ✓	None
Organizations list	organizations-table.tsx	None	CompletionDots column ✓

Proposed Approach

Create a unified RecordStatusCell component combining:

• Source-check dot (reuses RecordVerificationDot with variant="dot") — colored dot indicating verification status
• Coverage dots (1-4 filled/empty circles) — optional data completeness indicator

Always rendered as the rightmost column in tables. Two layout modes: as="td" for tables, as="inline" for card/flex layouts.

Coverage dots included where records have meaningful variation in completeness:

Table	Source-check	Coverage	Rationale
People tab	✓	✓	Records vary from name-only to full career data
Grants table	✓	✓	Grants vary significantly in metadata completeness
Divisions section (org)	✓	✓	Some have lead/spending, some name-only
Programs section (org)	✓	✓	Budget/deadline/description vary
Funding programs page	✓	✓	Same data, full page view
Funding rounds (org)	✓	—	Most rounds have similar fields
Investments (org)	✓	—	Simple records
Equity (org)	✓	—	Simple records
Career history (person)	✓	—	Compact card layout
Divisions page	✓	—	Row data too minimal for scoring
Funding rounds page	✓	—	Uniform completeness
Resources/Announcements	—	—	These ARE sources, not verifiable records

Architecture

File	Action	Purpose
components/verification/RecordStatusCell.tsx	create	Unified source-check + coverage component
components/verification/coverage-scoring.ts	create	Per-record-type coverage scoring functions
organizations/[slug]/people-section.tsx	modify	Move dot to right, add coverage
organizations/[slug]/divisions-section.tsx	modify	Move dot to right (table + card), add coverage
organizations/[slug]/programs-section.tsx	modify	Move dot to right, add coverage
organizations/[slug]/main-content-sections.tsx	modify	Move dots to right (rounds + investments)
organizations/[slug]/equity-section.tsx	modify	Move dot to right
organizations/[slug]/interactive-grants-table.tsx	modify	Move verified column to last, add coverage
people/[slug]/career-history.tsx	modify	Move dot to right side of card
divisions/divisions-table.tsx	modify	Move dot to right
funding-programs/funding-programs-table.tsx	modify	Move dot to right, add coverage
funding-rounds/funding-rounds-table.tsx	modify	Move dot to right
organizations/organizations-table.tsx	modify	Extract local CompletionDots to shared import

Implementation Phases

Phase 1: Shared components

• Create coverage-scoring.ts with per-record-type scoring functions
• Create RecordStatusCell.tsx with unified component + exported CoverageDots

Phase 2: Server-component HTML tables (mechanical migration)

• people-section.tsx, divisions-section.tsx, programs-section.tsx, main-content-sections.tsx, equity-section.tsx
• Pattern: remove dot from left cell → add <th> + <td> as last column

Phase 3: Client-component tables

• divisions-table.tsx, funding-programs-table.tsx, funding-rounds-table.tsx

Phase 4: Complex table

• interactive-grants-table.tsx — move column in ALL_COLUMNS array, update cell rendering

Phase 5: Card layouts

• career-history.tsx — move to right with ml-auto

Phase 6: Extract shared CompletionDots

• organizations-table.tsx — replace local function with shared import

Risks & Mitigations

Risk	Severity	Mitigation
Equity section has dynamic columns (hasCategories, hasValuation, hasPledges)	Medium	Status td/th must be after ALL conditional columns; check tfoot
Grants table has column picker system	Medium	Move column in ALL_COLUMNS array; column picker respects array order
Funding rounds has conditional display (hasAnyVerdict)	Low	Remove conditional — always show column (unverified = hollow dot)
colSpan values in empty/loading states	Low	No hardcoded colSpan found; dynamic ones auto-adjust

Scope Cuts

• Entity DB page (entity-profile-viewer.tsx): Left as-is — different purpose, uses VerdictBadge with confidence scores
• Organizations list page: Keep existing CompletionDots column unchanged, only extract shared component
• Resources/Announcements/Press tables: No dots added — these are sources, not records to verify

[OAGr]

Superseded by Discussion #3993 (Source-Check → Sourcing Rename — Implementation Plan).

The architecture and naming decisions in this discussion have been consolidated into the 7-phase sourcing rename plan. Key changes: routes become /sourcing, tables rename to record_sources/source_verdicts, components standardize on SourcingDot/SourcingBadge.

Phase 0: #4001 | Phase 1: #4002

[OAGr]

Branch: claude/deploy-tasks-verify-cmd

Closing as superseded — already marked superseded by #3993. Verification dots tracked in #3802; data-completeness dots tracked separately in #3901. — Discussion review 2026-04-08.