@open-mercato/core 0.6.4-develop.4210.1.d412061cfe → 0.6.4-develop.4236.1.9fa6806b34

package/src/modules/staff/lib/timesheets-projects/computeProjectsKpis.ts

@@ -0,0 +1,311 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { StaffTimeProject, StaffTimeProjectMember } from '../../data/entities'
+import {
+  addUtcDays,
+  getFirstDayOfMonthUtc,
+  getFirstDayOfNextMonthUtc,
+  getMondayUtc,
+  toDateOnlyString,
+} from './dateBuckets'
+import { deltaPct, minutesToHours } from './kpiMath'
+
+type WeekRow = { bucket: 'current' | 'previous'; total_minutes: string | number }
+
+export type KpiScope = {
+  em: EntityManager
+  organizationId: string
+  tenantId: string
+  now?: Date
+}
+
+export type KpiDelta = {
+  current: number
+  previous: number
+  deltaPct: number | null
+}
+
+export type ProjectKpisPmResult = {
+  role: 'pm'
+  totals: { total: number; active: number; onHold: number; completed: number }
+  hoursWeek: KpiDelta
+  hoursMonth: KpiDelta
+  teamActive: { count: number }
+  assignedToMe: { total: number; active: number }
+}
+
+export type ProjectKpisCollabResult = {
+  role: 'collab'
+  myProjects: { total: number; active: number }
+  myHoursWeek: KpiDelta
+  myHoursMonth: KpiDelta
+}
+
+export async function computePmProjectsKpis(
+  scope: KpiScope & { callerStaffMemberId?: string | null },
+): Promise<ProjectKpisPmResult> {
+  const em = scope.em.fork()
+  const now = scope.now ?? new Date()
+
+  const projects = await em.find(StaffTimeProject, {
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    deletedAt: null,
+  })
+
+  const totals = {
+    total: projects.length,
+    active: 0,
+    onHold: 0,
+    completed: 0,
+  }
+  for (const p of projects) {
+    if (p.status === 'active') totals.active += 1
+    else if (p.status === 'on_hold') totals.onHold += 1
+    else if (p.status === 'completed') totals.completed += 1
+  }
+
+  const monthStart = getFirstDayOfMonthUtc(now)
+  const nextMonthStart = getFirstDayOfNextMonthUtc(now)
+  const prevMonthStart = getFirstDayOfMonthUtc(addUtcDays(monthStart, -1))
+  const weekMonday = getMondayUtc(now)
+  const nextMonday = addUtcDays(weekMonday, 7)
+  const prevMonday = addUtcDays(weekMonday, -7)
+
+  const hoursRows = (await em.getConnection().execute(
+    `
+      SELECT bucket, COALESCE(SUM(duration_minutes), 0)::bigint AS total_minutes
+      FROM (
+        SELECT
+          CASE
+            WHEN date >= ?::date AND date < ?::date THEN 'current'
+            WHEN date >= ?::date AND date < ?::date THEN 'previous'
+          END AS bucket,
+          duration_minutes
+        FROM staff_time_entries
+        WHERE organization_id = ?
+          AND tenant_id = ?
+          AND deleted_at IS NULL
+          AND date >= ?::date
+          AND date < ?::date
+      ) t
+      WHERE bucket IS NOT NULL
+      GROUP BY bucket
+    `,
+    [
+      toDateOnlyString(monthStart),
+      toDateOnlyString(nextMonthStart),
+      toDateOnlyString(prevMonthStart),
+      toDateOnlyString(monthStart),
+      scope.organizationId,
+      scope.tenantId,
+      toDateOnlyString(prevMonthStart),
+      toDateOnlyString(nextMonthStart),
+    ],
+  )) as WeekRow[]
+
+  const weekRows = (await em.getConnection().execute(
+    `
+      SELECT bucket, COALESCE(SUM(duration_minutes), 0)::bigint AS total_minutes
+      FROM (
+        SELECT
+          CASE
+            WHEN date >= ?::date AND date < ?::date THEN 'current'
+            WHEN date >= ?::date AND date < ?::date THEN 'previous'
+          END AS bucket,
+          duration_minutes
+        FROM staff_time_entries
+        WHERE organization_id = ?
+          AND tenant_id = ?
+          AND deleted_at IS NULL
+          AND date >= ?::date
+          AND date < ?::date
+      ) t
+      WHERE bucket IS NOT NULL
+      GROUP BY bucket
+    `,
+    [
+      toDateOnlyString(weekMonday),
+      toDateOnlyString(nextMonday),
+      toDateOnlyString(prevMonday),
+      toDateOnlyString(weekMonday),
+      scope.organizationId,
+      scope.tenantId,
+      toDateOnlyString(prevMonday),
+      toDateOnlyString(nextMonday),
+    ],
+  )) as WeekRow[]
+
+  let currentHours = 0
+  let previousHours = 0
+  for (const row of hoursRows) {
+    const minutes = typeof row.total_minutes === 'string' ? Number(row.total_minutes) : row.total_minutes
+    if (row.bucket === 'current') currentHours = minutesToHours(minutes)
+    else previousHours = minutesToHours(minutes)
+  }
+
+  let weekCurrentHours = 0
+  let weekPreviousHours = 0
+  for (const row of weekRows) {
+    const minutes = typeof row.total_minutes === 'string' ? Number(row.total_minutes) : row.total_minutes
+    if (row.bucket === 'current') weekCurrentHours = minutesToHours(minutes)
+    else weekPreviousHours = minutesToHours(minutes)
+  }
+
+  const teamRows = (await em.getConnection().execute(
+    `
+      SELECT COUNT(DISTINCT staff_member_id)::bigint AS count
+      FROM staff_time_entries
+      WHERE organization_id = ?
+        AND tenant_id = ?
+        AND deleted_at IS NULL
+        AND date >= ?::date
+        AND date < ?::date
+    `,
+    [
+      scope.organizationId,
+      scope.tenantId,
+      toDateOnlyString(monthStart),
+      toDateOnlyString(nextMonthStart),
+    ],
+  )) as Array<{ count: string | number }>
+  const teamCount = teamRows.length ? Number(teamRows[0].count) : 0
+
+  const assignedToMe = { total: 0, active: 0 }
+  if (scope.callerStaffMemberId) {
+    const memberships = await em.find(StaffTimeProjectMember, {
+      staffMemberId: scope.callerStaffMemberId,
+      tenantId: scope.tenantId,
+      organizationId: scope.organizationId,
+      status: 'active',
+      deletedAt: null,
+    })
+    const assignedProjectIds = memberships.map((m) => m.timeProjectId)
+    const assignedProjects = projects.filter((p) => assignedProjectIds.includes(p.id))
+    assignedToMe.total = assignedProjects.length
+    assignedToMe.active = assignedProjects.filter((p) => p.status === 'active').length
+  }
+
+  return {
+    role: 'pm',
+    totals,
+    hoursWeek: {
+      current: weekCurrentHours,
+      previous: weekPreviousHours,
+      deltaPct: deltaPct(weekCurrentHours, weekPreviousHours),
+    },
+    hoursMonth: {
+      current: currentHours,
+      previous: previousHours,
+      deltaPct: deltaPct(currentHours, previousHours),
+    },
+    teamActive: { count: teamCount },
+    assignedToMe,
+  }
+}
+
+export async function computeCollabProjectsKpis(
+  scope: KpiScope & { staffMemberId: string },
+): Promise<ProjectKpisCollabResult> {
+  const em = scope.em.fork()
+  const now = scope.now ?? new Date()
+
+  const memberships = await em.find(StaffTimeProjectMember, {
+    staffMemberId: scope.staffMemberId,
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    status: 'active',
+    deletedAt: null,
+  })
+
+  const projectIds = memberships.map((m) => m.timeProjectId)
+  const myProjects = { total: projectIds.length, active: 0 }
+
+  if (projectIds.length > 0) {
+    const projects = await em.find(StaffTimeProject, {
+      id: { $in: projectIds },
+      tenantId: scope.tenantId,
+      organizationId: scope.organizationId,
+      status: 'active',
+      deletedAt: null,
+    })
+    myProjects.active = projects.length
+  }
+
+  const weekMonday = getMondayUtc(now)
+  const nextMonday = addUtcDays(weekMonday, 7)
+  const prevMonday = addUtcDays(weekMonday, -7)
+
+  const monthStart = getFirstDayOfMonthUtc(now)
+  const nextMonthStart = getFirstDayOfNextMonthUtc(now)
+  const prevMonthStart = getFirstDayOfMonthUtc(addUtcDays(monthStart, -1))
+
+  const rows = (await em.getConnection().execute(
+    `
+      SELECT bucket, COALESCE(SUM(duration_minutes), 0)::bigint AS total_minutes
+      FROM (
+        SELECT
+          CASE
+            WHEN date >= ?::date AND date < ?::date THEN 'week_current'
+            WHEN date >= ?::date AND date < ?::date THEN 'week_previous'
+            WHEN date >= ?::date AND date < ?::date THEN 'month_current'
+            WHEN date >= ?::date AND date < ?::date THEN 'month_previous'
+          END AS bucket,
+          duration_minutes
+        FROM staff_time_entries
+        WHERE organization_id = ?
+          AND tenant_id = ?
+          AND staff_member_id = ?
+          AND deleted_at IS NULL
+          AND date >= LEAST(?::date, ?::date)
+          AND date < GREATEST(?::date, ?::date)
+      ) t
+      WHERE bucket IS NOT NULL
+      GROUP BY bucket
+    `,
+    [
+      toDateOnlyString(weekMonday),
+      toDateOnlyString(nextMonday),
+      toDateOnlyString(prevMonday),
+      toDateOnlyString(weekMonday),
+      toDateOnlyString(monthStart),
+      toDateOnlyString(nextMonthStart),
+      toDateOnlyString(prevMonthStart),
+      toDateOnlyString(monthStart),
+      scope.organizationId,
+      scope.tenantId,
+      scope.staffMemberId,
+      toDateOnlyString(prevMonday),
+      toDateOnlyString(prevMonthStart),
+      toDateOnlyString(nextMonday),
+      toDateOnlyString(nextMonthStart),
+    ],
+  )) as Array<{ bucket: string; total_minutes: string | number }>
+
+  let weekCurrent = 0
+  let weekPrevious = 0
+  let monthCurrent = 0
+  let monthPrevious = 0
+  for (const row of rows) {
+    const minutes = typeof row.total_minutes === 'string' ? Number(row.total_minutes) : row.total_minutes
+    const hours = minutesToHours(minutes)
+    if (row.bucket === 'week_current') weekCurrent = hours
+    else if (row.bucket === 'week_previous') weekPrevious = hours
+    else if (row.bucket === 'month_current') monthCurrent = hours
+    else if (row.bucket === 'month_previous') monthPrevious = hours
+  }
+
+  return {
+    role: 'collab',
+    myProjects,
+    myHoursWeek: {
+      current: weekCurrent,
+      previous: weekPrevious,
+      deltaPct: deltaPct(weekCurrent, weekPrevious),
+    },
+    myHoursMonth: {
+      current: monthCurrent,
+      previous: monthPrevious,
+      deltaPct: deltaPct(monthCurrent, monthPrevious),
+    },
+  }
+}

package/src/modules/staff/lib/timesheets-projects/dateBuckets.ts

@@ -0,0 +1,37 @@
+export function getMondayUtc(input: Date): Date {
+  const d = new Date(Date.UTC(input.getUTCFullYear(), input.getUTCMonth(), input.getUTCDate()))
+  const day = d.getUTCDay()
+  const diff = day === 0 ? -6 : 1 - day
+  d.setUTCDate(d.getUTCDate() + diff)
+  return d
+}
+
+export function addUtcDays(input: Date, days: number): Date {
+  const d = new Date(input)
+  d.setUTCDate(d.getUTCDate() + days)
+  return d
+}
+
+export function getFirstDayOfMonthUtc(input: Date): Date {
+  return new Date(Date.UTC(input.getUTCFullYear(), input.getUTCMonth(), 1))
+}
+
+export function getFirstDayOfNextMonthUtc(input: Date): Date {
+  return new Date(Date.UTC(input.getUTCFullYear(), input.getUTCMonth() + 1, 1))
+}
+
+export function getLastNWeekStarts(n: number, now: Date = new Date()): Date[] {
+  const currentMonday = getMondayUtc(now)
+  const starts: Date[] = []
+  for (let i = n - 1; i >= 0; i--) {
+    starts.push(addUtcDays(currentMonday, -i * 7))
+  }
+  return starts
+}
+
+export function toDateOnlyString(date: Date): string {
+  const y = date.getUTCFullYear()
+  const m = String(date.getUTCMonth() + 1).padStart(2, '0')
+  const d = String(date.getUTCDate()).padStart(2, '0')
+  return `${y}-${m}-${d}`
+}

package/src/modules/staff/lib/timesheets-projects/initials.ts

@@ -0,0 +1,6 @@
+export function computeInitials(displayName: string): string {
+  const parts = displayName.trim().split(/\s+/).filter(Boolean)
+  if (parts.length === 0) return '?'
+  if (parts.length === 1) return parts[0].slice(0, 2).toUpperCase()
+  return `${parts[0][0]}${parts[parts.length - 1][0]}`.toUpperCase()
+}

package/src/modules/staff/lib/timesheets-projects/kpiMath.ts

@@ -0,0 +1,8 @@
+export function deltaPct(current: number, previous: number): number | null {
+  if (previous <= 0) return null
+  return Math.round(((current - previous) / previous) * 100 * 10) / 10
+}
+
+export function minutesToHours(minutes: number): number {
+  return Math.round((minutes / 60) * 10) / 10
+}

package/src/modules/staff/lib/timesheets-projects/listProjectMembersPreview.ts

@@ -0,0 +1,83 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { StaffTeamMember, StaffTimeProjectMember } from '../../data/entities'
+import { computeInitials } from './initials'
+
+export { computeInitials }
+
+export type MembersPreviewScope = {
+  em: EntityManager
+  organizationId: string
+  tenantId: string
+  projectIds: string[]
+  maxPerProject?: number
+}
+
+export type MemberPreview = {
+  id: string
+  name: string
+  initials: string
+  avatarUrl: string | null
+}
+
+export type ProjectMembersPreview = {
+  total: number
+  preview: MemberPreview[]
+  myRole: string | null
+}
+
+const DEFAULT_MAX = 4
+
+export async function listProjectMembersPreview(
+  scope: MembersPreviewScope & { callerStaffMemberId?: string | null },
+): Promise<Map<string, ProjectMembersPreview>> {
+  const maxPerProject = scope.maxPerProject ?? DEFAULT_MAX
+  const result = new Map<string, ProjectMembersPreview>()
+  for (const id of scope.projectIds) {
+    result.set(id, { total: 0, preview: [], myRole: null })
+  }
+  if (scope.projectIds.length === 0) return result
+
+  const em = scope.em.fork()
+  const memberships = await em.find(
+    StaffTimeProjectMember,
+    {
+      timeProjectId: { $in: scope.projectIds },
+      tenantId: scope.tenantId,
+      organizationId: scope.organizationId,
+      status: 'active',
+      deletedAt: null,
+    },
+    { orderBy: { createdAt: 'asc' } },
+  )
+
+  const staffMemberIds = Array.from(new Set(memberships.map((m) => m.staffMemberId)))
+  if (staffMemberIds.length === 0) return result
+
+  const teamMembers = await em.find(StaffTeamMember, {
+    id: { $in: staffMemberIds },
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    deletedAt: null,
+  })
+  const teamById = new Map(teamMembers.map((tm) => [tm.id, tm]))
+
+  for (const membership of memberships) {
+    const bucket = result.get(membership.timeProjectId)
+    if (!bucket) continue
+    bucket.total += 1
+    if (scope.callerStaffMemberId && membership.staffMemberId === scope.callerStaffMemberId) {
+      bucket.myRole = membership.role ?? null
+    }
+    if (bucket.preview.length >= maxPerProject) continue
+    const team = teamById.get(membership.staffMemberId)
+    if (!team) continue
+    bucket.preview.push({
+      id: team.id,
+      name: team.displayName,
+      initials: computeInitials(team.displayName),
+      avatarUrl: null,
+    })
+  }
+
+  return result
+}

package/src/modules/staff/lib/timesheets-projects-ui/HoursSparkline.tsx

@@ -0,0 +1,75 @@
+"use client"
+
+import * as React from 'react'
+
+export type HoursSparklineProps = {
+  values: number[]
+  color?: string
+  width?: number
+  height?: number
+  ariaLabel: string
+  className?: string
+}
+
+const DEFAULT_COLOR = '#6366f1'
+
+export function HoursSparkline({
+  values,
+  color = DEFAULT_COLOR,
+  width = 54,
+  height = 14,
+  ariaLabel,
+  className,
+}: HoursSparklineProps) {
+  const nonEmpty = values.length > 0
+  const max = nonEmpty ? Math.max(...values, 0) : 0
+  const allZero = !nonEmpty || max === 0
+
+  if (allZero) {
+    return (
+      <svg
+        role="img"
+        aria-label={ariaLabel}
+        width={width}
+        height={height}
+        viewBox={`0 0 ${width} ${height}`}
+        className={className}
+      >
+        <line
+          x1={0}
+          x2={width}
+          y1={height / 2}
+          y2={height / 2}
+          className="stroke-border"
+          strokeWidth={1}
+        />
+      </svg>
+    )
+  }
+
+  const stepX = values.length === 1 ? 0 : width / (values.length - 1)
+  const points = values.map((value, idx) => {
+    const x = values.length === 1 ? width / 2 : idx * stepX
+    const y = height - (value / max) * (height - 2) - 1
+    return { x, y }
+  })
+
+  const linePath = points
+    .map((p, idx) => (idx === 0 ? `M${p.x},${p.y}` : `L${p.x},${p.y}`))
+    .join(' ')
+  const areaPath = `${linePath} L${points[points.length - 1].x},${height} L${points[0].x},${height} Z`
+
+  return (
+    <svg
+      role="img"
+      aria-label={ariaLabel}
+      width={width}
+      height={height}
+      viewBox={`0 0 ${width} ${height}`}
+      className={className}
+    >
+      <path d={areaPath} fill={color} opacity={0.15} />
+      <path d={linePath} fill="none" stroke={color} strokeWidth={1.25} strokeLinecap="round" strokeLinejoin="round" />
+    </svg>
+  )
+}

package/src/modules/staff/lib/timesheets-projects-ui/ProjectCard.tsx

@@ -0,0 +1,110 @@
+"use client"
+
+import * as React from 'react'
+import Link from 'next/link'
+import { ProjectColorDot } from '../timesheets-ui/ProjectColorDot'
+import { resolveProjectColorHex } from '../timesheets-ui/colors'
+import { HoursSparkline } from './HoursSparkline'
+import { ProjectMembersAvatarStack, type AvatarMember } from './ProjectMembersAvatarStack'
+
+export type ProjectCardData = {
+  id: string
+  name: string
+  code: string | null
+  customerName: string | null
+  color: string | null
+  status: string
+  hoursWeek: number
+  hoursTrend: number[]
+  members: AvatarMember[]
+  memberCount: number
+  myRole: string | null
+  updatedAt: string | null
+}
+
+export type ProjectCardLabels = {
+  hoursPanelPm: string
+  hoursPanelCollab: string
+  sparklineAria: string
+  peopleCount: (count: number) => string
+  role: string
+  noCustomer: string
+  statuses: Record<string, string>
+}
+
+export type ProjectCardProps = {
+  data: ProjectCardData
+  labels: ProjectCardLabels
+  showTeam: boolean
+  href: string
+}
+
+const STATUS_BADGE_CLASSES: Record<string, string> = {
+  active: 'bg-lime-100 text-lime-800 dark:bg-lime-900/30 dark:text-lime-300',
+  on_hold: 'bg-amber-100 text-amber-800 dark:bg-amber-900/30 dark:text-amber-300',
+  completed: 'bg-muted text-muted-foreground',
+}
+
+export function ProjectCard({ data, labels, showTeam, href }: ProjectCardProps) {
+  const badgeClass = STATUS_BADGE_CLASSES[data.status] ?? 'bg-muted text-muted-foreground'
+  const statusLabel = labels.statuses[data.status] ?? data.status
+  const stripeColor = resolveProjectColorHex(data.color, data.name)
+  const hoursPanelLabel = showTeam ? labels.hoursPanelPm : labels.hoursPanelCollab
+
+  return (
+    <Link
+      href={href}
+      className="group relative flex flex-col overflow-hidden rounded-lg border border-border bg-card transition-colors hover:border-foreground/30"
+    >
+      <div className="h-[3px] w-full" style={{ backgroundColor: stripeColor }} aria-hidden="true" />
+      <div className="flex flex-1 flex-col gap-3 p-4">
+        <div className="flex items-center justify-between gap-2">
+          <span
+            className={`inline-flex items-center rounded-full px-2 py-0.5 text-[11px] font-medium ${badgeClass}`}
+          >
+            {statusLabel}
+          </span>
+          <ProjectColorDot colorKey={data.color} projectName={data.name} size="sm" />
+        </div>
+        <div className="flex flex-col gap-0.5">
+          <h3 className="truncate text-sm font-semibold text-foreground" title={data.name}>
+            {data.name}
+          </h3>
+          <p className="truncate font-mono text-[11px] text-muted-foreground">
+            {data.code ?? '—'}
+            {data.customerName ? ` · ${data.customerName}` : ''}
+          </p>
+        </div>
+        <div className="rounded-md border border-border/50 bg-muted/40 p-3">
+          <p className="text-[10px] uppercase tracking-wide text-muted-foreground">{hoursPanelLabel}</p>
+          <div className="mt-1 flex items-end justify-between gap-3">
+            <p className="text-xl font-semibold tabular-nums text-foreground">
+              {data.hoursWeek > 0 ? `${data.hoursWeek}h` : '—'}
+            </p>
+            <HoursSparkline
+              values={data.hoursTrend}
+              color={stripeColor}
+              width={80}
+              height={26}
+              ariaLabel={labels.sparklineAria}
+            />
+          </div>
+        </div>
+        <div className="mt-auto flex items-center justify-between pt-1">
+          {showTeam ? (
+            <ProjectMembersAvatarStack
+              members={data.members}
+              total={data.memberCount}
+              peopleCountLabel={labels.peopleCount(data.memberCount)}
+            />
+          ) : (
+            <p className="text-xs text-muted-foreground">
+              <span className="text-muted-foreground/70">{labels.role}: </span>
+              {data.myRole ?? '—'}
+            </p>
+          )}
+        </div>
+      </div>
+    </Link>
+  )
+}