@hed-hog/contact 0.0.285 → 0.0.291

package/hedhog/frontend/app/person/_components/person-field-with-create.tsx.ejs

@@ -100,11 +100,25 @@ function usePersonFieldWithCreateTranslations() {
     values?: Record<string, string | number | boolean | null | undefined>
   ) => {
     const contactKey = `contact.PersonFieldWithCreate.${key}`;
+    // Filter values to only include types compatible with next-intl
+    const filteredValues = values
+      ? Object.fromEntries(
+          Object.entries(values).filter(
+            ([_, v]) => typeof v === 'string' || typeof v === 'number'
+          )
+        )
+      : undefined;
     if (tRoot.has(contactKey)) {
-      return tRoot(contactKey, values);
+      return tRoot(
+        contactKey,
+        filteredValues as Record<string, string | number> | undefined
+      );
     }
 
-    return tRoot(`finance.PersonFieldWithCreate.${key}`, values);
+    return tRoot(
+      `finance.PersonFieldWithCreate.${key}`,
+      filteredValues as Record<string, string | number> | undefined
+    );
   };
 }
 
@@ -643,20 +657,22 @@ export function PersonFieldWithCreate<TFieldValues extends FieldValues>({
           params.set('search', debouncedPersonSearch.trim());
         }
 
-        const response = await request<PaginatedResponse<PersonOption> | PersonOption[]>({
+        const response = await request<
+          PaginatedResponse<PersonOption> | PersonOption[]
+        >({
           url: `/person?${params.toString()}`,
           method: 'GET',
         });
 
         const payload = response?.data;
-        if (Array.isArray(payload?.data)) {
-          return payload.data as PersonOption[];
-        }
-
         if (Array.isArray(payload)) {
           return payload as PersonOption[];
         }
 
+        if (payload && 'data' in payload && Array.isArray(payload.data)) {
+          return payload.data as PersonOption[];
+        }
+
         return [];
       },
       placeholderData: (old) => old ?? [],
@@ -670,7 +686,10 @@ export function PersonFieldWithCreate<TFieldValues extends FieldValues>({
   return (
     <>
       <div className="grid gap-2">
-        <Label data-error={!!fieldState.error} className="data-[error=true]:text-destructive">
+        <Label
+          data-error={!!fieldState.error}
+          className="data-[error=true]:text-destructive"
+        >
           {label}
         </Label>
         <Controller
@@ -798,9 +817,7 @@ export function PersonFieldWithCreate<TFieldValues extends FieldValues>({
           }}
         />
         {fieldState.error?.message ? (
-          <p className="text-destructive text-sm">
-            {fieldState.error.message}
-          </p>
+          <p className="text-destructive text-sm">{fieldState.error.message}</p>
         ) : null}
       </div>
 

package/hedhog/frontend/app/person/page.tsx.ejs

@@ -8,7 +8,6 @@ import {
   PaginationFooter,
   SearchBar,
   type SearchBarControl,
-  StatsCards,
 } from '@/components/entity-list';
 import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar';
 import { Badge } from '@/components/ui/badge';
@@ -21,6 +20,7 @@ import {
   DropdownMenuSeparator,
   DropdownMenuTrigger,
 } from '@/components/ui/dropdown-menu';
+import { KpiCardsGrid } from '@/components/ui/kpi-cards-grid';
 import { Skeleton } from '@/components/ui/skeleton';
 import {
   Table,
@@ -714,32 +714,36 @@ export default function PeoplePage() {
 
   const statsCards = [
     {
+      key: 'total',
       title: t('statsTotal'),
       value: stats.total,
-      icon: <Users className="h-5 w-5" />,
-      iconBgColor: 'bg-slate-100',
-      iconColor: 'text-slate-700',
+      icon: Users,
+      accentClassName: 'from-slate-500/20 via-slate-400/10 to-transparent',
+      iconContainerClassName: 'bg-slate-100 text-slate-700',
     },
     {
+      key: 'active',
       title: t('statsActive'),
       value: stats.active,
-      icon: <CheckCircle2 className="h-5 w-5" />,
-      iconBgColor: 'bg-green-50',
-      iconColor: 'text-green-600',
+      icon: CheckCircle2,
+      accentClassName: 'from-green-500/20 via-emerald-500/10 to-transparent',
+      iconContainerClassName: 'bg-green-50 text-green-600',
     },
     {
+      key: 'individual',
       title: t('statsIndividual'),
       value: stats.individual,
-      icon: <UserCheck className="h-5 w-5" />,
-      iconBgColor: 'bg-blue-50',
-      iconColor: 'text-blue-600',
+      icon: UserCheck,
+      accentClassName: 'from-blue-500/20 via-cyan-500/10 to-transparent',
+      iconContainerClassName: 'bg-blue-50 text-blue-600',
     },
     {
+      key: 'company',
       title: t('statsCompany'),
       value: stats.company,
-      icon: <Building2 className="h-5 w-5" />,
-      iconBgColor: 'bg-amber-50',
-      iconColor: 'text-amber-600',
+      icon: Building2,
+      accentClassName: 'from-amber-500/20 via-orange-500/10 to-transparent',
+      iconContainerClassName: 'bg-amber-50 text-amber-600',
     },
   ];
 
@@ -807,7 +811,7 @@ export default function PeoplePage() {
         ]}
       />
 
-      <StatsCards stats={statsCards} />
+      <KpiCardsGrid items={statsCards} />
 
       <div className="flex flex-col gap-4 xl:flex-row xl:items-center">
         <div className="flex-1">

package/hedhog/frontend/app/pipeline/page.tsx.ejs

@@ -1,19 +1,5 @@
 'use client';
 
-import {
-  closestCenter,
-  DndContext,
-  DragOverlay,
-  PointerSensor,
-  useDraggable,
-  useDroppable,
-  useSensor,
-  useSensors,
-  type DragEndEvent,
-  type DragStartEvent,
-  type UniqueIdentifier,
-} from '@dnd-kit/core';
-import { CSS } from '@dnd-kit/utilities';
 import {
   Page,
   PageHeader,
@@ -21,7 +7,6 @@ import {
   type SearchBarControl,
 } from '@/components/entity-list';
 import { Badge } from '@/components/ui/badge';
-import { Button } from '@/components/ui/button';
 import {
   Card,
   CardContent,
@@ -34,6 +19,7 @@ import {
   CollapsibleContent,
   CollapsibleTrigger,
 } from '@/components/ui/collapsible';
+import { KpiCardsGrid } from '@/components/ui/kpi-cards-grid';
 import { ScrollArea } from '@/components/ui/scroll-area';
 import {
   Tooltip,
@@ -42,6 +28,20 @@ import {
 } from '@/components/ui/tooltip';
 import { useDebounce } from '@/hooks/use-debounce';
 import { cn } from '@/lib/utils';
+import {
+  closestCenter,
+  DndContext,
+  DragOverlay,
+  PointerSensor,
+  useDraggable,
+  useDroppable,
+  useSensor,
+  useSensors,
+  type DragEndEvent,
+  type DragStartEvent,
+  type UniqueIdentifier,
+} from '@dnd-kit/core';
+import { CSS } from '@dnd-kit/utilities';
 import { useApp, useQuery } from '@hed-hog/next-app-provider';
 import {
   CalendarCheck,
@@ -71,8 +71,9 @@ import {
   type ReactNode,
 } from 'react';
 import { toast } from 'sonner';
-import { crmImplementedSections } from '../_lib/crm-sections';
 import { crmStageOrder, type CrmLead } from '../_lib/crm-mocks';
+import { crmImplementedSections } from '../_lib/crm-sections';
+import { PersonFormSheet } from '../person/_components/person-form-sheet';
 import type {
   ContactTypeOption,
   DocumentTypeOption,
@@ -81,7 +82,6 @@ import type {
   PersonLifecycleStage,
   UserOption,
 } from '../person/_components/person-types';
-import { PersonFormSheet } from '../person/_components/person-form-sheet';
 import { LeadDetailSheet } from './_components/lead-detail-sheet';
 
 const PIPELINE_EXPANDED_KEY = 'contact:crm-pipeline:expanded-leads';
@@ -154,8 +154,6 @@ function DraggableLeadCard({
         'touch-none',
         isDragging && 'z-30 opacity-60 shadow-lg ring-1 ring-primary/30'
       )}
-      role="button"
-      tabIndex={0}
       onClick={onClick}
       onKeyDown={onKeyDown}
       {...listeners}
@@ -458,7 +456,24 @@ export default function CrmPipelinePage() {
       ),
       icon: CircleDollarSign,
     },
-  ] as const;
+  ].map((item, index) => {
+    const sectionStyle =
+      crmImplementedSections[index % crmImplementedSections.length] ??
+      crmImplementedSections[0];
+
+    return {
+      key: item.key,
+      title: t(`summary.${item.key}.title`),
+      value: item.value,
+      description: t(`summary.${item.key}.description`, {
+        count: nextActions,
+      }),
+      icon: item.icon,
+      accentClassName: sectionStyle?.colorClass ?? fallbackKpiAccentClass,
+      iconContainerClassName:
+        sectionStyle?.glowClass ?? 'bg-sky-500/10 text-sky-700',
+    };
+  });
 
   const allExpanded =
     visibleLeads.length > 0 && visibleLeads.every((l) => expandedIds.has(l.id));
@@ -549,7 +564,8 @@ export default function CrmPipelinePage() {
       const sourceLead = visibleLeadsById.get(sourceLeadId);
       if (!sourceLead || sourceLead.lifecycle_stage === targetStage) return;
 
-      const previousStage = sourceLead.lifecycle_stage;
+      const previousStage: PersonLifecycleStage =
+        sourceLead.lifecycle_stage ?? 'new';
 
       setStageOverrides((prev) => ({ ...prev, [sourceLeadId]: targetStage }));
       setSelectedLead((prev) =>
@@ -633,51 +649,8 @@ export default function CrmPipelinePage() {
         ]}
       />
 
-      <div className="min-w-0 space-y-6 overflow-x-hidden">
-        <div className="grid gap-4 md:grid-cols-2 xl:grid-cols-4">
-          {kpiCards.map((item, index) => {
-            const sectionStyle =
-              crmImplementedSections[index % crmImplementedSections.length] ??
-              crmImplementedSections[0];
-
-            return (
-              <Card
-                key={item.key}
-                className="min-w-0 overflow-hidden border-border/70 py-0"
-              >
-                <div
-                  className={cn(
-                    'h-1 w-full bg-linear-to-r',
-                    sectionStyle?.colorClass ?? fallbackKpiAccentClass
-                  )}
-                />
-                <CardContent className="flex items-start justify-between gap-3 px-6 py-5">
-                  <div className="min-w-0">
-                    <p className="text-xs uppercase tracking-[0.2em] text-muted-foreground">
-                      {t(`summary.${item.key}.title`)}
-                    </p>
-                    <p className="mt-2 text-3xl font-semibold tracking-tight">
-                      {item.value}
-                    </p>
-                    <p className="mt-1 text-sm text-muted-foreground">
-                      {t(`summary.${item.key}.description`, {
-                        count: nextActions,
-                      })}
-                    </p>
-                  </div>
-                  <div
-                    className={cn(
-                      'rounded-2xl p-3',
-                      sectionStyle?.glowClass ?? 'bg-sky-500/10 text-sky-700'
-                    )}
-                  >
-                    <item.icon className="size-5" />
-                  </div>
-                </CardContent>
-              </Card>
-            );
-          })}
-        </div>
+      <div className="min-w-0 space-y-4 overflow-x-hidden">
+        <KpiCardsGrid items={kpiCards} />
 
         <SearchBar
           searchQuery={searchTerm}

package/hedhog/frontend/messages/en.json

@@ -184,9 +184,43 @@
     "duplicateMergeError": "Failed to merge records.",
     "owner": "Owner",
     "unassigned": "Unassigned",
+    "source": "Source",
+    "sourceReferral": "Referral",
+    "sourceWebsite": "Website",
+    "sourceSocial": "Social",
+    "sourceInbound": "Inbound",
+    "sourceOutbound": "Outbound",
+    "sourceOther": "Other",
+    "lifecycleStage": "Stage",
+    "lifecycleNew": "New",
+    "lifecycleContacted": "Contacted",
+    "lifecycleQualified": "Qualified",
+    "lifecycleProposal": "Proposal",
+    "lifecycleNegotiation": "Negotiation",
+    "lifecycleCustomer": "Customer",
+    "lifecycleLost": "Lost",
+    "nextActionAt": "Next action",
+    "nextActionEmpty": "No follow-up",
     "registerInteraction": "Register Interaction",
+    "registerInteractionDescription": "Register the latest contact made with this person.",
     "scheduleFollowup": "Schedule Follow-up",
+    "scheduleFollowupDescription": "Set the date and owner for the next action.",
     "interactionType": "Interaction Type",
+    "interactionTypeCall": "Call",
+    "interactionTypeEmail": "Email",
+    "interactionTypeWhatsapp": "WhatsApp",
+    "interactionTypeMeeting": "Meeting",
+    "interactionTypeNote": "Note",
+    "interactionDate": "Interaction date",
+    "interactionOutcome": "Outcome",
+    "interactionOutcomePlaceholder": "E.g. Interested, asked for a proposal...",
+    "interactionNotesPlaceholder": "Write a quick summary...",
+    "interactionCreateSuccess": "Interaction recorded successfully.",
+    "interactionCreateError": "Failed to record interaction.",
+    "nextActionRequired": "The next action date is required.",
+    "schedule": "Schedule",
+    "saveAndNew": "Save and new",
+    "formShortcutsHint": "Shortcuts: Ctrl/Cmd+S to save, Esc to close.",
     "interactionType_call": "Call",
     "interactionType_email": "Email",
     "interactionType_whatsapp": "WhatsApp",
@@ -610,6 +644,133 @@
       "age": "Days since first contact with this lead."
     }
   },
+  "CrmFollowups": {
+    "title": "Follow-ups",
+    "description": "Track upcoming actions, overdue items, and owner commitments in one operational list.",
+    "newFollowup": "New Follow-up",
+    "reschedule": "Reschedule",
+    "unassigned": "Unassigned",
+    "stats": {
+      "total": "Total follow-ups",
+      "today": "Due today",
+      "overdue": "Overdue",
+      "upcoming": "Upcoming"
+    },
+    "filters": {
+      "searchPlaceholder": "Search by lead, contact, or account name...",
+      "statusPlaceholder": "Status",
+      "statusAll": "All statuses"
+    },
+    "status": {
+      "today": "Today",
+      "upcoming": "Upcoming",
+      "overdue": "Overdue"
+    },
+    "table": {
+      "person": "Person",
+      "owner": "Owner",
+      "nextAction": "Next action",
+      "lastInteraction": "Last interaction",
+      "status": "Status",
+      "actions": "Actions"
+    },
+    "empty": {
+      "title": "No follow-ups found",
+      "description": "Adjust your filters or create a new follow-up to start managing next actions."
+    },
+    "sheet": {
+      "title": "Schedule follow-up",
+      "description": "Define person, date, and notes for the next action.",
+      "submit": "Save follow-up"
+    },
+    "form": {
+      "person": "Person",
+      "personPlaceholder": "Select a person",
+      "date": "Follow-up date",
+      "notes": "Notes",
+      "notesPlaceholder": "Add context for the next interaction...",
+      "personRequired": "Select a person.",
+      "dateRequired": "Set a date and time."
+    },
+    "toasts": {
+      "scheduleSuccess": "Follow-up scheduled successfully",
+      "scheduleError": "Failed to schedule follow-up"
+    },
+    "errors": {
+      "invalidPerson": "Invalid person.",
+      "invalidDate": "Invalid date."
+    }
+  },
+  "CrmActivities": {
+    "title": "Activities",
+    "description": "Operational activity queue with calls, meetings, messages, and tasks tracked by owner and due date.",
+    "viewMode": "View",
+    "viewModeTable": "Table",
+    "viewModeTimeline": "Timeline",
+    "unassignedPerson": "Unassigned lead",
+    "unassignedOwner": "Unassigned",
+    "stats": {
+      "total": "Total activities",
+      "pending": "Pending",
+      "overdue": "Overdue",
+      "completed": "Completed"
+    },
+    "filters": {
+      "searchPlaceholder": "Search by subject, lead, owner, or notes...",
+      "statusPlaceholder": "Status",
+      "typePlaceholder": "Type",
+      "priorityPlaceholder": "Priority",
+      "allStatuses": "All statuses",
+      "allTypes": "All types",
+      "allPriorities": "All priorities"
+    },
+    "status": {
+      "pending": "Pending",
+      "overdue": "Overdue",
+      "completed": "Completed"
+    },
+    "type": {
+      "call": "Call",
+      "email": "Email",
+      "meeting": "Meeting",
+      "whatsapp": "WhatsApp",
+      "task": "Task",
+      "note": "Note"
+    },
+    "priority": {
+      "high": "High",
+      "medium": "Medium",
+      "low": "Low"
+    },
+    "table": {
+      "activity": "Activity",
+      "person": "Lead / Contact",
+      "owner": "Owner",
+      "dueAt": "Due at",
+      "createdAt": "Created",
+      "status": "Status",
+      "priority": "Priority",
+      "actions": "Actions"
+    },
+    "actions": {
+      "view": "View",
+      "complete": "Mark done"
+    },
+    "timeline": {
+      "description": "Chronological timeline view of activities in the current filter.",
+      "dueLabel": "Due",
+      "createdLabel": "Created"
+    },
+    "empty": {
+      "title": "No activities found",
+      "description": "Adjust filters to find activities or clear filters to return to the full queue.",
+      "resetFilters": "Clear filters"
+    },
+    "toasts": {
+      "markedAsCompleted": "Activity marked as completed.",
+      "openDetails": "Opening activity: {subject}"
+    }
+  },
   "CrmFuturePage": {
     "breadcrumbs": {
       "home": "Home",

package/hedhog/frontend/messages/pt.json

@@ -643,6 +643,133 @@
       "age": "Dias desde o primeiro contato com este lead."
     }
   },
+  "CrmFollowups": {
+    "title": "Follow-ups",
+    "description": "Acompanhe próximas ações, vencidos e compromissos por responsável em uma lista operacional.",
+    "newFollowup": "Novo Follow-up",
+    "reschedule": "Reagendar",
+    "unassigned": "Não atribuído",
+    "stats": {
+      "total": "Total de follow-ups",
+      "today": "Vencem hoje",
+      "overdue": "Vencidos",
+      "upcoming": "Próximos"
+    },
+    "filters": {
+      "searchPlaceholder": "Buscar por lead, contato ou conta...",
+      "statusPlaceholder": "Status",
+      "statusAll": "Todos os status"
+    },
+    "status": {
+      "today": "Hoje",
+      "upcoming": "Próximos",
+      "overdue": "Vencidos"
+    },
+    "table": {
+      "person": "Pessoa",
+      "owner": "Responsável",
+      "nextAction": "Próxima ação",
+      "lastInteraction": "Última interação",
+      "status": "Status",
+      "actions": "Ações"
+    },
+    "empty": {
+      "title": "Nenhum follow-up encontrado",
+      "description": "Ajuste os filtros ou crie um novo follow-up para começar a gerir as próximas ações."
+    },
+    "sheet": {
+      "title": "Agendar follow-up",
+      "description": "Defina pessoa, data e notas para a próxima ação.",
+      "submit": "Salvar follow-up"
+    },
+    "form": {
+      "person": "Pessoa",
+      "personPlaceholder": "Selecione uma pessoa",
+      "date": "Data do follow-up",
+      "notes": "Notas",
+      "notesPlaceholder": "Adicione contexto para a próxima interação...",
+      "personRequired": "Selecione uma pessoa.",
+      "dateRequired": "Defina data e hora."
+    },
+    "toasts": {
+      "scheduleSuccess": "Follow-up agendado com sucesso",
+      "scheduleError": "Falha ao agendar follow-up"
+    },
+    "errors": {
+      "invalidPerson": "Pessoa inválida.",
+      "invalidDate": "Data inválida."
+    }
+  },
+  "CrmActivities": {
+    "title": "Atividades",
+    "description": "Fila operacional de atividades com ligações, reuniões, mensagens e tarefas por responsável e prazo.",
+    "viewMode": "Visualização",
+    "viewModeTable": "Tabela",
+    "viewModeTimeline": "Timeline",
+    "unassignedPerson": "Lead não atribuído",
+    "unassignedOwner": "Não atribuído",
+    "stats": {
+      "total": "Total de atividades",
+      "pending": "Pendentes",
+      "overdue": "Atrasadas",
+      "completed": "Concluídas"
+    },
+    "filters": {
+      "searchPlaceholder": "Buscar por assunto, lead, responsável ou notas...",
+      "statusPlaceholder": "Status",
+      "typePlaceholder": "Tipo",
+      "priorityPlaceholder": "Prioridade",
+      "allStatuses": "Todos os status",
+      "allTypes": "Todos os tipos",
+      "allPriorities": "Todas as prioridades"
+    },
+    "status": {
+      "pending": "Pendente",
+      "overdue": "Atrasada",
+      "completed": "Concluída"
+    },
+    "type": {
+      "call": "Ligação",
+      "email": "E-mail",
+      "meeting": "Reunião",
+      "whatsapp": "WhatsApp",
+      "task": "Tarefa",
+      "note": "Anotação"
+    },
+    "priority": {
+      "high": "Alta",
+      "medium": "Média",
+      "low": "Baixa"
+    },
+    "table": {
+      "activity": "Atividade",
+      "person": "Lead / Contato",
+      "owner": "Responsável",
+      "dueAt": "Prazo",
+      "createdAt": "Criada em",
+      "status": "Status",
+      "priority": "Prioridade",
+      "actions": "Ações"
+    },
+    "actions": {
+      "view": "Ver",
+      "complete": "Concluir"
+    },
+    "timeline": {
+      "description": "Visão cronológica das atividades considerando os filtros atuais.",
+      "dueLabel": "Prazo",
+      "createdLabel": "Criada"
+    },
+    "empty": {
+      "title": "Nenhuma atividade encontrada",
+      "description": "Ajuste os filtros para encontrar atividades ou limpe os filtros para voltar à fila completa.",
+      "resetFilters": "Limpar filtros"
+    },
+    "toasts": {
+      "markedAsCompleted": "Atividade marcada como concluída.",
+      "openDetails": "Abrindo atividade: {subject}"
+    }
+  },
   "CrmFuturePage": {
     "breadcrumbs": {
       "home": "Home",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/contact",
-  "version": "0.0.285",
+  "version": "0.0.291",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,13 +9,13 @@
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
-    "@hed-hog/address": "0.0.285",
+    "@hed-hog/core": "0.0.291",
     "@hed-hog/api-mail": "0.0.8",
-    "@hed-hog/core": "0.0.285",
-    "@hed-hog/api": "0.0.4",
-    "@hed-hog/api-pagination": "0.0.6",
     "@hed-hog/api-prisma": "0.0.5",
-    "@hed-hog/api-locale": "0.0.13"
+    "@hed-hog/api-locale": "0.0.13",
+    "@hed-hog/address": "0.0.291",
+    "@hed-hog/api": "0.0.4",
+    "@hed-hog/api-pagination": "0.0.6"
   },
   "exports": {
     ".": {

package/src/contact.service.ts

@@ -16,7 +16,7 @@ export class ContactService {
     private readonly jwtService: JwtService,
   ) {}
 
-  async getPerson(personId: number) {
+  async getPerson(personId: number): Promise<any> {
     const person = await this.prismaService.person.findUnique({
       where: {
         id: personId,
@@ -52,7 +52,7 @@ export class ContactService {
     phone: string,
     cpf: string,
     cnpj: string,
-  ) {
+  ): Promise<any> {
     const findPersonByEmail = await this.prismaService.person.findFirst({
       where: {
         contact: {