@open-mercato/core 0.6.7 → 0.6.8-develop.6874.1.982d6097d8

package/src/modules/customers/components/detail/ConfirmDealLostDialog.tsx

@@ -151,7 +151,7 @@ export function ConfirmDealLostDialog({
           </DialogHeader>
 
           <div className="space-y-6 px-7 py-6">
-            <Alert variant="warning" className="rounded-md">
+            <Alert status="warning" className="rounded-md">
               <AlertTitle>
                 {t('customers.deals.detail.lost.warningTitle', 'This action closes the deal')}
               </AlertTitle>
@@ -253,7 +253,7 @@ export function ConfirmDealLostDialog({
             </Button>
             <Button
               type="button"
-              variant="destructive"
+              variant="destructive-solid"
               disabled={confirmDisabled}
               onClick={() => { void handleConfirm() }}
             >

package/src/modules/customers/components/detail/DealDetailTabs.tsx

@@ -3,6 +3,8 @@
 import * as React from 'react'
 import { Activity, Building2, History, NotebookPen, Paperclip, Users } from 'lucide-react'
 import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { registerComponent } from '@open-mercato/shared/modules/widgets/component-registry'
+import { useRegisteredComponent } from '@open-mercato/ui/backend/injection/useRegisteredComponent'
 import { Tabs, TabsList, TabsTrigger } from '@open-mercato/ui/primitives/tabs'
 
 export type DealTabId =
@@ -21,10 +23,13 @@ type TabDef = {
   count?: React.ReactNode
 }
 
-type DealDetailTabsProps = {
+export const DEAL_DETAIL_TABS_COMPONENT_ID = 'section:customers.deals.detailTabs'
+
+export type DealDetailTabsProps = {
   activeTab: DealTabId
   onTabChange: (tab: DealTabId) => void
   injectedTabs?: Array<{ id: string; label: string }>
+  hiddenTabIds?: string[]
   peopleCount?: number
   companiesCount?: number
   children: React.ReactNode
@@ -32,9 +37,11 @@ type DealDetailTabsProps = {
 
 const SUPPORTED_TAB_IDS = new Set<DealTabId>(['activities', 'people', 'companies', 'notes', 'files', 'changelog'])
 
-export function resolveLegacyTab(tab: string | null | undefined): DealTabId {
+export function resolveLegacyTab(tab: string | null | undefined, knownTabIds?: Iterable<string>): DealTabId {
   if (!tab) return 'activities'
-  return SUPPORTED_TAB_IDS.has(tab as DealTabId) ? (tab as DealTabId) : 'activities'
+  if (SUPPORTED_TAB_IDS.has(tab as DealTabId)) return tab as DealTabId
+  if (knownTabIds && new Set(knownTabIds).has(tab)) return tab
+  return 'activities'
 }
 
 function formatTabCount(count: number): string | number | undefined {
@@ -42,10 +49,11 @@ function formatTabCount(count: number): string | number | undefined {
   return count > 999 ? '999+' : count
 }
 
-export function DealDetailTabs({
+function DefaultDealDetailTabs({
   activeTab,
   onTabChange,
   injectedTabs = [],
+  hiddenTabIds = [],
   peopleCount = 0,
   companiesCount = 0,
   children,
@@ -91,16 +99,16 @@ export function DealDetailTabs({
     [companiesCount, peopleCount, t],
   )
 
-  const allTabs = React.useMemo<TabDef[]>(
-    () => [
+  const allTabs = React.useMemo<TabDef[]>(() => {
+    const hidden = new Set(hiddenTabIds)
+    return [
       ...builtInTabs,
       ...injectedTabs.map((tab) => ({
         id: tab.id as DealTabId,
         label: tab.label,
       })),
-    ],
-    [builtInTabs, injectedTabs],
-  )
+    ].filter((tab) => !hidden.has(tab.id))
+  }, [builtInTabs, hiddenTabIds, injectedTabs])
 
   return (
     <div>
@@ -127,3 +135,20 @@ export function DealDetailTabs({
     </div>
   )
 }
+
+registerComponent<DealDetailTabsProps>({
+  id: DEAL_DETAIL_TABS_COMPONENT_ID,
+  component: DefaultDealDetailTabs,
+  metadata: {
+    module: 'customers',
+    description: 'Deal detail tab navigation and content.',
+  },
+})
+
+export function DealDetailTabs(props: DealDetailTabsProps) {
+  const ResolvedTabs = useRegisteredComponent<DealDetailTabsProps>(
+    DEAL_DETAIL_TABS_COMPONENT_ID,
+    DefaultDealDetailTabs,
+  )
+  return <ResolvedTabs {...props} />
+}

package/src/modules/customers/components/detail/DealForm.tsx

@@ -15,6 +15,7 @@ import {
 } from '@open-mercato/ui/primitives/select'
 import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
 import { createCrudFormError } from '@open-mercato/ui/backend/utils/serverErrors'
+import { DEAL_DESCRIPTION_MAX_LENGTH } from '../../data/validators'
 import { DictionarySelectField } from '../formConfig'
 import { createDictionarySelectLabels } from './utils'
 import { E } from '#generated/entities.ids.generated'
@@ -263,7 +264,10 @@ const schema = z.object({
       'customers.people.detail.deals.expectedCloseInvalid',
     )
     .optional(),
-  description: z.string().max(4000, 'customers.people.detail.deals.descriptionTooLong').optional(),
+  description: z
+    .string()
+    .max(DEAL_DESCRIPTION_MAX_LENGTH, 'customers.people.detail.deals.descriptionTooLong')
+    .optional(),
   personIds: z.array(z.string().trim().min(1)).optional(),
   companyIds: z.array(z.string().trim().min(1)).optional(),
 }).passthrough()

package/src/modules/customers/components/detail/DealsSection.tsx

@@ -988,7 +988,7 @@ export function DealsSection({
                     {deal.title || emptyLabel}
                   </Link>
                   {deal.description ? (
-                    <p className="mt-1 text-sm text-muted-foreground whitespace-pre-wrap">{deal.description}</p>
+                    <p className="mt-1 line-clamp-3 text-sm text-muted-foreground whitespace-pre-wrap">{deal.description}</p>
                   ) : null}
                 </div>
                 <div className="flex items-center gap-2">

package/src/modules/customers/components/detail/MiniWeekCalendar.tsx

@@ -7,7 +7,8 @@ import { useT } from '@open-mercato/shared/lib/i18n/context'
 import { readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
 import { Button } from '@open-mercato/ui/primitives/button'
 import { IconButton } from '@open-mercato/ui/primitives/icon-button'
-import type { InteractionSummary, ActivitySummary } from './types'
+import type { InteractionSummary } from './types'
+import { loadLegacyActivitiesInRange } from './legacyActivities'
 
 interface MiniWeekCalendarProps {
   entityId: string
@@ -132,61 +133,6 @@ export function MiniWeekCalendar({ entityId, useCanonicalInteractions = true, re
       return items.filter(isWithinRange)
     }
 
-    async function loadLegacyActivities(): Promise<InteractionSummary[]> {
-      const items: InteractionSummary[] = []
-      let page = 1
-      let totalPages = 1
-      do {
-        const payload = await readApiResultOrThrow<{
-          items?: ActivitySummary[]
-          totalPages?: number
-        }>(
-          `/api/customers/activities?entityId=${encodeURIComponent(entityId)}&page=${page}&pageSize=100&sortField=occurredAt&sortDir=desc`,
-          { signal: controller.signal },
-        )
-        const pageItems = Array.isArray(payload?.items) ? payload.items : []
-        const mappedItems: InteractionSummary[] = pageItems.map((activity) => ({
-          id: activity.id,
-          interactionType: activity.activityType,
-          title: activity.subject ?? null,
-          body: activity.body ?? null,
-          status: 'done',
-          scheduledAt: null,
-          occurredAt: activity.occurredAt ?? null,
-          priority: null,
-          authorUserId: activity.authorUserId ?? null,
-          ownerUserId: null,
-          appearanceIcon: activity.appearanceIcon ?? null,
-          appearanceColor: activity.appearanceColor ?? null,
-          source: 'legacy-activity',
-          entityId: activity.entityId ?? null,
-          dealId: activity.dealId ?? null,
-          organizationId: null,
-          tenantId: null,
-          authorName: activity.authorName ?? null,
-          authorEmail: activity.authorEmail ?? null,
-          dealTitle: activity.dealTitle ?? null,
-          customValues: null,
-          createdAt: activity.createdAt,
-          updatedAt: activity.createdAt,
-        }))
-        items.push(...mappedItems.filter(isWithinRange))
-        totalPages = typeof payload?.totalPages === 'number' ? payload.totalPages : totalPages
-        if (!pageItems.length) break
-        const oldestPageTimestamp = pageItems.reduce<number>((oldest, activity) => {
-          const rawDate = activity.occurredAt ?? activity.createdAt
-          const timestamp = rawDate ? new Date(rawDate).getTime() : Number.NaN
-          if (!Number.isFinite(timestamp)) return oldest
-          return Math.min(oldest, timestamp)
-        }, Number.POSITIVE_INFINITY)
-        if (Number.isFinite(oldestPageTimestamp) && oldestPageTimestamp < rangeStart.getTime()) {
-          break
-        }
-        page += 1
-      } while (page <= totalPages)
-      return items
-    }
-
     void (async () => {
       try {
         const canonicalItems = await loadCanonicalInteractions()
@@ -194,7 +140,12 @@ export function MiniWeekCalendar({ entityId, useCanonicalInteractions = true, re
           setEvents(canonicalItems)
           return
         }
-        const legacyItems = await loadLegacyActivities()
+        const legacyItems = await loadLegacyActivitiesInRange({
+          entityId,
+          rangeStart,
+          isWithinRange,
+          signal: controller.signal,
+        })
         const seen = new Set<string>()
         const merged: InteractionSummary[] = []
         for (const item of [...canonicalItems, ...legacyItems]) {

package/src/modules/customers/components/detail/PersonDetailTabs.tsx

@@ -16,6 +16,8 @@ import {
   MapPin,
 } from 'lucide-react'
 import type { SectionAction } from '@open-mercato/ui/backend/detail'
+import { registerComponent } from '@open-mercato/shared/modules/widgets/component-registry'
+import { useRegisteredComponent } from '@open-mercato/ui/backend/injection/useRegisteredComponent'
 
 export type PersonTabId =
   | 'activities'
@@ -35,10 +37,13 @@ type TabDef = {
   count?: React.ReactNode
 }
 
-type PersonDetailTabsProps = {
+export const PERSON_DETAIL_TABS_COMPONENT_ID = 'section:customers.people.detailTabs'
+
+export type PersonDetailTabsProps = {
   activeTab: PersonTabId
   onTabChange: (tab: PersonTabId) => void
   injectedTabs?: Array<{ id: string; label: string }>
+  hiddenTabIds?: string[]
   activitiesCount?: number
   dealsCount?: number
   companiesCount?: number
@@ -51,9 +56,11 @@ type PersonDetailTabsProps = {
 
 const SUPPORTED_TAB_IDS = new Set<PersonTabId>(['activities', 'emails', 'deals', 'companies', 'addresses', 'tasks', 'changelog', 'files'])
 
-export function resolveLegacyTab(tab: string | null | undefined): PersonTabId {
+export function resolveLegacyTab(tab: string | null | undefined, knownTabIds?: Iterable<string>): PersonTabId {
   if (!tab) return 'activities'
-  return SUPPORTED_TAB_IDS.has(tab as PersonTabId) ? (tab as PersonTabId) : 'activities'
+  if (SUPPORTED_TAB_IDS.has(tab as PersonTabId)) return tab as PersonTabId
+  if (knownTabIds && new Set(knownTabIds).has(tab)) return tab
+  return 'activities'
 }
 
 function formatTabCount(count: number): string | number | undefined {
@@ -61,10 +68,11 @@ function formatTabCount(count: number): string | number | undefined {
   return count > 999 ? '999+' : count
 }
 
-export function PersonDetailTabs({
+function DefaultPersonDetailTabs({
   activeTab,
   onTabChange,
   injectedTabs = [],
+  hiddenTabIds = [],
   activitiesCount = 0,
   dealsCount = 0,
   companiesCount = 0,
@@ -129,16 +137,16 @@ export function PersonDetailTabs({
     [t, activitiesCount, dealsCount, companiesCount, addressesCount, tasksCount, filesCount],
   )
 
-  const allTabs: TabDef[] = React.useMemo(
-    () => [
+  const allTabs: TabDef[] = React.useMemo(() => {
+    const hidden = new Set(hiddenTabIds)
+    return [
       ...builtInTabs,
       ...injectedTabs.map((tab) => ({
         id: tab.id as PersonTabId,
         label: tab.label,
       })),
-    ],
-    [builtInTabs, injectedTabs],
-  )
+    ].filter((tab) => !hidden.has(tab.id))
+  }, [builtInTabs, hiddenTabIds, injectedTabs])
 
   return (
     <div>
@@ -182,3 +190,20 @@ export function PersonDetailTabs({
     </div>
   )
 }
+
+registerComponent<PersonDetailTabsProps>({
+  id: PERSON_DETAIL_TABS_COMPONENT_ID,
+  component: DefaultPersonDetailTabs,
+  metadata: {
+    module: 'customers',
+    description: 'Person detail tab navigation and content.',
+  },
+})
+
+export function PersonDetailTabs(props: PersonDetailTabsProps) {
+  const ResolvedTabs = useRegisteredComponent<PersonDetailTabsProps>(
+    PERSON_DETAIL_TABS_COMPONENT_ID,
+    DefaultPersonDetailTabs,
+  )
+  return <ResolvedTabs {...props} />
+}

package/src/modules/customers/components/detail/ScheduleActivityDialog.tsx

@@ -99,6 +99,8 @@ interface ScheduleActivityDialogProps {
   onActivityCreated?: () => void
   /** When provided, dialog opens in edit mode with pre-filled data */
   editData?: ScheduleActivityEditData | null
+  /** Default country ISO2 code for phone number input when value is empty/unparsed */
+  defaultCountryIso2?: string
 }
 
 export function ScheduleActivityDialog({
@@ -111,6 +113,7 @@ export function ScheduleActivityDialog({
   entityType,
   onActivityCreated,
   editData,
+  defaultCountryIso2,
 }: ScheduleActivityDialogProps) {
   const t = useT()
   const state = useScheduleFormState({ open, editData: editData ?? null })
@@ -204,6 +207,7 @@ export function ScheduleActivityDialog({
   const initialSnapshotRef = React.useRef<string | null>(null)
   const snapshotOpenKeyRef = React.useRef<string | null>(null)
   const snapshotSettleCountRef = React.useRef(0)
+  const closeConfirmPendingRef = React.useRef(false)
   const openKey = open ? `${editData?.id ?? 'new'}` : null
   React.useEffect(() => {
     if (!open) {
@@ -229,21 +233,27 @@ export function ScheduleActivityDialog({
   }, [formSnapshot])
 
   const guardedClose = React.useCallback(async () => {
+    if (closeConfirmPendingRef.current) return
     if (!isDirty()) {
       onClose()
       return
     }
-    const ok = await confirm({
-      title: t('customers.schedule.discardConfirm.title', 'Discard unsaved changes?'),
-      description: t(
-        'customers.schedule.discardConfirm.description',
-        'You have unsaved edits in this activity. Save them first or continue to discard them.',
-      ),
-      confirmText: t('customers.schedule.discardConfirm.confirm', 'Discard'),
-      cancelText: t('customers.schedule.discardConfirm.cancel', 'Keep editing'),
-      variant: 'destructive',
-    })
-    if (ok) onClose()
+    closeConfirmPendingRef.current = true
+    try {
+      const ok = await confirm({
+        title: t('customers.schedule.discardConfirm.title', 'Discard unsaved changes?'),
+        description: t(
+          'customers.schedule.discardConfirm.description',
+          'You have unsaved edits in this activity. Save them first or continue to discard them.',
+        ),
+        confirmText: t('customers.schedule.discardConfirm.confirm', 'Discard'),
+        cancelText: t('customers.schedule.discardConfirm.cancel', 'Keep editing'),
+        variant: 'destructive',
+      })
+      if (ok) onClose()
+    } finally {
+      closeConfirmPendingRef.current = false
+    }
   }, [confirm, isDirty, onClose, t])
 
   const mutationContextId = React.useMemo(
@@ -465,8 +475,12 @@ export function ScheduleActivityDialog({
 
   return (
     <Dialog open={open} onOpenChange={(o) => { if (!o) void guardedClose() }}>
-      {ConfirmDialogElement}
-      <DialogContent className="flex max-h-[90vh] flex-col overflow-hidden border-border p-0 shadow-xl sm:max-w-[760px] sm:rounded-xl [&>[data-dialog-close]]:hidden" onKeyDown={handleKeyDown} aria-describedby={undefined}>
+      <DialogContent
+        className="flex max-h-[90vh] flex-col overflow-hidden border-border p-0 shadow-xl sm:max-w-[760px] sm:rounded-xl [&>[data-dialog-close]]:hidden"
+        onKeyDown={handleKeyDown}
+        aria-describedby={undefined}
+      >
+        {ConfirmDialogElement}
         <VisuallyHidden>
           <DialogTitle>{isEditing ? t('customers.schedule.editTitle', 'Edit activity') : t(chrome.titleKey, chrome.titleFallback)}</DialogTitle>
         </VisuallyHidden>
@@ -497,7 +511,7 @@ export function ScheduleActivityDialog({
 
         {/* Conflict warning */}
         {state.conflict && (
-          <Alert variant="warning" className="rounded-lg">
+          <Alert status="warning" className="rounded-lg">
             <AlertTitle>
               {t('customers.schedule.conflict.title', 'Calendar conflict')}
             </AlertTitle>
@@ -689,6 +703,7 @@ export function ScheduleActivityDialog({
               externalError={callPhoneError}
               invalidLabel={callPhoneInvalidMessage}
               minDigits={7}
+              defaultCountryIso2={defaultCountryIso2}
             />
           </div>
         ) : (

package/src/modules/customers/components/detail/dashboard/helpers.ts

@@ -1,9 +1,10 @@
 import type { KpiTrend } from '@open-mercato/ui/backend/charts/KpiCard'
+import { isOpenDealStatus } from '../../../lib/dealStatus'
 import type { DealSummary, InteractionSummary, TodoLinkSummary } from '../../formConfig'
 
 export function sumActiveDeals(deals: DealSummary[]): number {
   return deals
-    .filter((d) => d.status !== 'won' && d.status !== 'lost' && d.status !== 'closed')
+    .filter((d) => isOpenDealStatus(d.status))
     .reduce((sum, d) => {
       const amount = typeof d.valueAmount === 'number' ? d.valueAmount : parseFloat(String(d.valueAmount ?? '0'))
       return sum + (Number.isFinite(amount) ? amount : 0)
@@ -11,7 +12,7 @@ export function sumActiveDeals(deals: DealSummary[]): number {
 }
 
 export function getActiveDeals(deals: DealSummary[]): DealSummary[] {
-  return deals.filter((d) => d.status !== 'won' && d.status !== 'lost' && d.status !== 'closed')
+  return deals.filter((d) => isOpenDealStatus(d.status))
 }
 
 export function getOpenTasks(todos: TodoLinkSummary[]): TodoLinkSummary[] {
@@ -68,7 +69,7 @@ export function computeActivityTrend(interactions: InteractionSummary[]): KpiTre
 }
 
 export function computeDealTrend(deals: DealSummary[]): KpiTrend | undefined {
-  const active = deals.filter((d) => d.status !== 'won' && d.status !== 'lost' && d.status !== 'closed')
+  const active = deals.filter((d) => isOpenDealStatus(d.status))
   if (active.length === 0) return undefined
   const now = Date.now()
   const monthMs = 30 * 86_400_000

package/src/modules/customers/components/detail/legacyActivities.ts

@@ -0,0 +1,79 @@
+import { readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
+import type { ActivitySummary, InteractionSummary } from './types'
+
+export const LEGACY_ACTIVITIES_PAGE_SIZE = 100
+export const LEGACY_ACTIVITIES_MAX_PAGES = 1000
+
+function mapActivityToInteraction(activity: ActivitySummary): InteractionSummary {
+  return {
+    id: activity.id,
+    interactionType: activity.activityType,
+    title: activity.subject ?? null,
+    body: activity.body ?? null,
+    status: 'done',
+    scheduledAt: null,
+    occurredAt: activity.occurredAt ?? null,
+    priority: null,
+    authorUserId: activity.authorUserId ?? null,
+    ownerUserId: null,
+    appearanceIcon: activity.appearanceIcon ?? null,
+    appearanceColor: activity.appearanceColor ?? null,
+    source: 'legacy-activity',
+    entityId: activity.entityId ?? null,
+    dealId: activity.dealId ?? null,
+    organizationId: null,
+    tenantId: null,
+    authorName: activity.authorName ?? null,
+    authorEmail: activity.authorEmail ?? null,
+    dealTitle: activity.dealTitle ?? null,
+    customValues: null,
+    createdAt: activity.createdAt,
+    updatedAt: activity.createdAt,
+  }
+}
+
+export async function loadLegacyActivitiesInRange({
+  entityId,
+  rangeStart,
+  isWithinRange,
+  signal,
+}: {
+  entityId: string
+  rangeStart: Date
+  isWithinRange: (item: InteractionSummary) => boolean
+  signal?: AbortSignal
+}): Promise<InteractionSummary[]> {
+  const items: InteractionSummary[] = []
+  let page = 1
+  // Short-page termination: server-reported `totalPages` is a display value, not a loop
+  // bound — it can under-report (capped counts) or drift mid-enumeration. Pages are sorted
+  // by `occurredAt` desc, so the scan also stops once a page reaches past the requested
+  // range. Fail closed at the page ceiling rather than rendering a partial week silently.
+  for (;;) {
+    const payload = await readApiResultOrThrow<{
+      items?: ActivitySummary[]
+      totalPages?: number
+    }>(
+      `/api/customers/activities?entityId=${encodeURIComponent(entityId)}&page=${page}&pageSize=${LEGACY_ACTIVITIES_PAGE_SIZE}&sortField=occurredAt&sortDir=desc`,
+      { signal },
+    )
+    const pageItems = Array.isArray(payload?.items) ? payload.items : []
+    items.push(...pageItems.map(mapActivityToInteraction).filter(isWithinRange))
+    if (!pageItems.length) break
+    const oldestPageTimestamp = pageItems.reduce<number>((oldest, activity) => {
+      const rawDate = activity.occurredAt ?? activity.createdAt
+      const timestamp = rawDate ? new Date(rawDate).getTime() : Number.NaN
+      if (!Number.isFinite(timestamp)) return oldest
+      return Math.min(oldest, timestamp)
+    }, Number.POSITIVE_INFINITY)
+    if (Number.isFinite(oldestPageTimestamp) && oldestPageTimestamp < rangeStart.getTime()) {
+      break
+    }
+    if (pageItems.length < LEGACY_ACTIVITIES_PAGE_SIZE) break
+    if (page >= LEGACY_ACTIVITIES_MAX_PAGES) {
+      throw new Error(`[internal] legacy activity enumeration exceeded ${LEGACY_ACTIVITIES_MAX_PAGES} pages; refusing to render a partial set`)
+    }
+    page += 1
+  }
+  return items
+}

package/src/modules/customers/components/formConfig.tsx

@@ -418,7 +418,7 @@ const companyDictionaryFieldDefinitions: DictionaryFieldDefinition[] = [
   },
 ]
 
-const createPrimaryPhoneField = (t: Translator): CrudField => ({
+const createPrimaryPhoneField = (t: Translator, defaultCountryIso2?: string): CrudField => ({
   id: 'primaryPhone',
   label: t('customers.people.form.primaryPhone'),
   type: 'custom',
@@ -447,6 +447,7 @@ const createPrimaryPhoneField = (t: Translator): CrudField => ({
         invalidLabel={t('customers.people.form.primaryPhone.invalid', 'Enter a valid phone number with country code (e.g. +1 212 555 1234)')}
         minDigits={7}
         onDuplicateLookup={!disabled && !error ? duplicateLookup : undefined}
+        defaultCountryIso2={defaultCountryIso2}
       />
     )
   },
@@ -869,7 +870,8 @@ export const createDisplayNameSection = (t: Translator) =>
     )
   }
 
-export const createPersonFormFields = (t: Translator): CrudField[] => {
+export const createPersonFormFields = (t: Translator, options?: { defaultCountryIso2?: string }): CrudField[] => {
+  const defaultCountryIso2 = options?.defaultCountryIso2
   const contactSection = createSectionHeadingField('__contactInformationSection', t('customers.people.form.sections.contactInformation'))
   const companySection = createSectionHeadingField('__companyInformationSection', t('customers.people.form.sections.companyInformation'))
   const dictionaryFields: CrudField[] = dictionaryFieldDefinitions.map((definition) => ({
@@ -930,7 +932,7 @@ export const createPersonFormFields = (t: Translator): CrudField[] => {
     },
     contactSection,
     createPrimaryEmailField(t),
-    createPrimaryPhoneField(t),
+    createPrimaryPhoneField(t, defaultCountryIso2),
     companySection,
     {
       id: 'companyEntityId',
@@ -1225,7 +1227,8 @@ export const createCompanyFormSchema = () =>
     })
     .passthrough()
 
-export const createCompanyFormFields = (t: Translator): CrudField[] => {
+export const createCompanyFormFields = (t: Translator, options?: { defaultCountryIso2?: string }): CrudField[] => {
+  const defaultCountryIso2 = options?.defaultCountryIso2
   const dictionaryFields: CrudField[] = companyDictionaryFieldDefinitions.map((definition) => ({
     id: definition.id,
     label: t(definition.labelKey),
@@ -1270,6 +1273,7 @@ export const createCompanyFormFields = (t: Translator): CrudField[] => {
           placeholder={t('customers.companies.form.primaryPhonePlaceholder', '+1 555 123 4567')}
           invalidLabel={t('customers.people.form.primaryPhone.invalid', 'Enter a valid phone number with country code (e.g. +1 212 555 1234)')}
           minDigits={7}
+          defaultCountryIso2={defaultCountryIso2}
         />
       ),
     } as CrudField,
@@ -1651,8 +1655,8 @@ const buildIndustryLabels = (t: Translator): DictionarySelectLabels => ({
   manageTitle: t('customers.people.form.dictionary.manage'),
 })
 
-export const createCompanyEditFields = (t: Translator): CrudField[] => {
-  const baseFields = createCompanyFormFields(t)
+export const createCompanyEditFields = (t: Translator, options?: { defaultCountryIso2?: string }): CrudField[] => {
+  const baseFields = createCompanyFormFields(t, options)
   const industryLabels = buildIndustryLabels(t)
 
   return baseFields.map((field) => {
@@ -1676,8 +1680,8 @@ export const createCompanyEditFields = (t: Translator): CrudField[] => {
   })
 }
 
-export const createPersonEditFields = (t: Translator): CrudField[] => {
-  const baseFields = createPersonFormFields(t)
+export const createPersonEditFields = (t: Translator, options?: { defaultCountryIso2?: string }): CrudField[] => {
+  const baseFields = createPersonFormFields(t, options)
   return [
     ...baseFields,
     {

package/src/modules/customers/data/entities.ts

@@ -439,9 +439,14 @@ export class CustomerDealStageTransition {
 @Entity({ tableName: 'customer_deal_people' })
 @Index({ name: 'customer_deal_people_deal_idx', properties: ['deal'] })
 @Index({ name: 'customer_deal_people_person_idx', properties: ['person'] })
+@Index({
+  name: 'customer_deal_people_primary_uq',
+  expression:
+    `create unique index "customer_deal_people_primary_uq" on "customer_deal_people" ("deal_id") where "is_primary"`,
+})
 @Unique({ name: 'customer_deal_people_unique', properties: ['deal', 'person'] })
 export class CustomerDealPersonLink {
-  [OptionalProps]?: 'createdAt'
+  [OptionalProps]?: 'isPrimary' | 'createdAt'
 
   @PrimaryKey({ type: 'uuid', defaultRaw: 'gen_random_uuid()' })
   id!: string
@@ -449,6 +454,9 @@ export class CustomerDealPersonLink {
   @Property({ name: 'role', type: 'text', nullable: true })
   participantRole?: string | null
 
+  @Property({ name: 'is_primary', type: 'boolean', default: false })
+  isPrimary: boolean = false
+
   @Property({ name: 'created_at', type: Date, onCreate: () => new Date() })
   createdAt: Date = new Date()
 

package/src/modules/customers/data/validators.ts

@@ -11,6 +11,10 @@ export const ACTIVITY_TIME_REQUIRED_MESSAGE_KEY = 'customers.activities.errors.t
 export const ACTIVITY_PHONE_REQUIRED_MESSAGE_KEY = 'customers.activities.errors.phoneRequired'
 export const ACTIVITY_PHONE_INVALID_MESSAGE_KEY = 'customers.activities.errors.phoneInvalid'
 
+// customer_deals.description is an unbounded `text` column; this cap only exists to keep
+// request bodies, fulltext search documents and query-index documents from growing without limit.
+export const DEAL_DESCRIPTION_MAX_LENGTH = 50_000
+
 const emptyStringToNull = (value: unknown): unknown => {
   if (typeof value !== 'string') return value
   const trimmed = value.trim()
@@ -161,7 +165,7 @@ export const companyUpdateSchema = z
 
 export const dealCreateSchema = scopedSchema.extend({
   title: z.string().min(1).max(200),
-  description: z.string().max(4000).optional(),
+  description: z.string().max(DEAL_DESCRIPTION_MAX_LENGTH).optional(),
   status: z.string().max(50).optional(),
   pipelineStage: z.string().max(100).optional(),
   pipelineId: uuid().optional(),
@@ -180,6 +184,7 @@ export const dealCreateSchema = scopedSchema.extend({
   lossNotes: z.string().max(4000).optional(),
   companyIds: z.array(uuid()).optional(),
   personIds: z.array(uuid()).optional(),
+  primaryPersonEntityId: uuid().nullable().optional(),
 })
 
 export const dealUpdateSchema = z