Unified contacts (Flutter mobile — shipped)

Cross-reference for React web (aldilaijanre) parity. Mobile Flutter is the reference implementation.

Routes (mobile)

Purpose	Path
Contacts list	/clients
Party 360 detail	/clients/:unifiedPersonId
Duplicate review (admin)	/admin/duplicate-review
Legacy party registry	/admin/party-registry → redirects to /clients?admin=1
Legacy CRM client id	/brokerage/crm/clients/:clientsTableId → redirects when unified_person_id set
Brokerage CRM list	/brokerage/crm/clients → unified list

Data spine

• Identity: unified_persons (individuals + organizations)
• CRM overlays: clients — max one row per (unified_person_id, system) (aldilaijan / khobara)
• Detail id: always unified_persons.id on /clients/:id

List UX

• Segmented People / Entities
• Server-side searchParties() — no fetch-all registry
• Khobara personas: same list with linkedSystem: khobara
• Nav label: People & entities (nav.clients)

Detail UX (360)

PartyDetailScreen tabs (persona-gated via PartyDetailVisibility):

1. Profile — individual or organization
2. Brokerage — deals, requests, properties, Aldilaijan CRM
3. Valuation — valuations, requests, tahdeed, Khobara CRM
4. Financial — invoices
5. Activity — interaction timeline

Web parity checklist

• [x] Single list over unified_persons (people + entities), not separate Party Registry browse — React /clients
• [x] Detail at party id with brokerage / valuation / finance sections — React /clients/:id (PartyDetail)
• [x] Legacy CRM client detail redirects to /clients/:unifiedPersonId when linked — CrmClientDetailGate
• [x] Persona-scoped tab visibility — partyDetailVisibility.ts
• [x] Bilingual names: name_ar + structured parts + name_en — list + detail display
• [x] Admin duplicate review + orphan relink tooling — /admin/duplicate-review
• [x] Organization edit on party 360 — Flutter OrganizationFormScreen + React OrganizationForm via /clients/:id/edit
• [x] Inline CRM actions on party tabs — Flutter showCrmActionPicker; React CrmActionMenu (note / contact / interaction)
• [x] Legacy pages retired — UnifiedPersons, BuyersList removed; routes redirect to /clients

Key Flutter files

• lib/features/individuals/screens/individuals_list_screen.dart
• lib/features/parties/screens/party_detail_screen.dart
• lib/data/repositories/party_registry_repository.dart
• lib/data/repositories/party_activity_repository.dart

Production ops — identity convergence

After bulk imports or duplicate merges, admins should verify Phase-5 monitor views trend toward zero:

View	Meaning	Resolve via
vw_potential_duplicate_parties (match_kind = civil_id)	Same civil ID on multiple unified_persons	Duplicate review → Parties tab → merge
vw_potential_duplicate_parties (match_kind = folded_name)	Folded-name collision	Duplicate review → Parties tab → merge
vw_duplicate_clients	Multiple clients rows per (unified_person_id, system)	Duplicate review → Clients tab → merge
vw_clients_without_party	CRM client with no unified_person_id	Duplicate review → Relink orphan clients
vw_identity_drift_watch	Snapshot name drift vs party registry	Data quality dashboard → review row

Where to watch

• Flutter: /clients admin KPI strip + Identity convergence row (admins only); app-bar merge badge when party dupes > 0.
• React: /clients (admin) — same summary + convergence tiles; /admin/duplicate-review for merge + orphan relink.
• Valuation data quality (both): full convergence card with deep links.

Weekly checklist

1. Open /clients?admin=1 — confirm convergence counts (or zero).
2. Run orphan relink once if clientsWithoutParty > 0.
3. Clear party/client duplicate queues before large imports.
4. After merge sessions, refresh list — vw_potential_duplicate_parties should drop for merged keys.

See migration supabase/migrations/20260622120000_phase5_dedup_drift_views.sql and lib/data/repositories/data_quality_repository.dart (fetchConvergenceHealth).