@hed-hog/operations 0.0.2

package/hedhog/frontend/app/_lib/hooks/use-operations-data.ts.ejs

@@ -0,0 +1,41 @@
+'use client';
+
+import { useMemo } from 'react';
+import { allocationsMock } from '../mocks/allocations.mock';
+import { operationsUsersMock } from '../mocks/users.mock';
+import { contractsService } from '../services/contracts.service';
+import { projectsService } from '../services/projects.service';
+import { tasksService } from '../services/tasks.service';
+import { timesheetsService } from '../services/timesheets.service';
+import {
+  getApprovalStatusData,
+  getDashboardMetrics,
+  getDailyTotals,
+  getHoursByProject,
+  getHoursByUser,
+  getPendingApprovalsSummary,
+  getRecentTimesheetEntries,
+  getWeeklyTrend,
+} from '../utils/metrics';
+
+export function useOperationsData() {
+  return useMemo(
+    () => ({
+      users: operationsUsersMock,
+      contracts: contractsService.list(),
+      projects: projectsService.list(),
+      tasks: tasksService.list(),
+      timesheets: timesheetsService.list(),
+      allocations: allocationsMock,
+      dashboardMetrics: getDashboardMetrics(),
+      hoursByProject: getHoursByProject(),
+      hoursByUser: getHoursByUser(),
+      approvalStatusData: getApprovalStatusData(),
+      weeklyTrendData: getWeeklyTrend(),
+      recentTimesheets: getRecentTimesheetEntries(),
+      dailyTotals: getDailyTotals(),
+      approvalSummary: getPendingApprovalsSummary(),
+    }),
+    []
+  );
+}

package/hedhog/frontend/app/_lib/mocks/allocations.mock.ts.ejs

@@ -0,0 +1,74 @@
+import type { Allocation } from '../types/operations';
+
+export const allocationsMock: Allocation[] = [
+  {
+    id: 'alloc-001',
+    userId: 'usr-ana',
+    role: 'Delivery Manager',
+    projectId: 'prj-zenith-cloud',
+    weeklyHours: 18,
+    allocationPercent: 45,
+    startDate: '2026-03-03',
+    endDate: '2026-06-30',
+  },
+  {
+    id: 'alloc-002',
+    userId: 'usr-bruno',
+    role: 'Technical Lead',
+    projectId: 'prj-orion-web',
+    weeklyHours: 22,
+    allocationPercent: 55,
+    startDate: '2026-02-10',
+    endDate: '2026-06-30',
+  },
+  {
+    id: 'alloc-003',
+    userId: 'usr-carla',
+    role: 'Project Manager',
+    projectId: 'prj-atlas-crm',
+    weeklyHours: 24,
+    allocationPercent: 60,
+    startDate: '2026-03-01',
+    endDate: '2026-08-31',
+  },
+  {
+    id: 'alloc-004',
+    userId: 'usr-diego',
+    role: 'Backend Engineer',
+    projectId: 'prj-orion-data',
+    weeklyHours: 20,
+    allocationPercent: 50,
+    startDate: '2026-02-03',
+    endDate: '2026-09-15',
+  },
+  {
+    id: 'alloc-005',
+    userId: 'usr-elisa',
+    role: 'Frontend Engineer',
+    projectId: 'prj-orion-web',
+    weeklyHours: 30,
+    allocationPercent: 75,
+    startDate: '2026-01-20',
+    endDate: '2026-06-30',
+  },
+  {
+    id: 'alloc-006',
+    userId: 'usr-fabio',
+    role: 'QA Analyst',
+    projectId: 'prj-orion-web',
+    weeklyHours: 16,
+    allocationPercent: 40,
+    startDate: '2026-02-17',
+    endDate: '2026-05-30',
+  },
+  {
+    id: 'alloc-007',
+    userId: 'usr-gabi',
+    role: 'UX Designer',
+    projectId: 'prj-orion-data',
+    weeklyHours: 14,
+    allocationPercent: 35,
+    startDate: '2026-02-12',
+    endDate: '2026-07-31',
+  },
+];

package/hedhog/frontend/app/_lib/mocks/contracts.mock.ts.ejs

@@ -0,0 +1,74 @@
+import type { Contract } from '../types/operations';
+
+export const contractsMock: Contract[] = [
+  {
+    id: 'ctr-orion',
+    name: 'Orion Platform Expansion',
+    client: 'Orion Retail Group',
+    type: 'monthly',
+    startDate: '2026-01-01',
+    endDate: '2026-12-31',
+    hourlyRate: 195,
+    hourLimit: 640,
+    status: 'active',
+    billingRules: [
+      'Monthly invoicing on the fifth business day',
+      'Overage billed at blended rate above hour cap',
+      'Change requests approved by client PM',
+    ],
+    sla: 'P1 response in 2h, P2 in 6h, delivery governance weekly.',
+    revisions: ['Revision 1 - January scope uplift', 'Revision 2 - UX squad add-on'],
+    linkedProjectIds: ['prj-orion-web', 'prj-orion-data'],
+  },
+  {
+    id: 'ctr-zenith',
+    name: 'Zenith Support Retainer',
+    client: 'Zenith Health',
+    type: 'tm',
+    startDate: '2025-10-15',
+    endDate: '2026-10-14',
+    hourlyRate: 230,
+    hourLimit: 420,
+    status: 'active',
+    billingRules: [
+      'Time and material billing by approved entry',
+      'Emergency work charged at 1.25x after 8pm',
+    ],
+    sla: '24x7 on-call for critical incidents with monthly ops review.',
+    revisions: ['Revision 1 - Added cloud migration stream'],
+    linkedProjectIds: ['prj-zenith-cloud'],
+  },
+  {
+    id: 'ctr-atlas',
+    name: 'Atlas CRM Rollout',
+    client: 'Atlas Logistics',
+    type: 'fixed',
+    startDate: '2026-02-01',
+    endDate: '2026-08-31',
+    hourlyRate: 175,
+    hourLimit: 520,
+    status: 'renewal',
+    billingRules: [
+      'Milestone billing split in 30/40/30',
+      'Additional scope converted to change order',
+    ],
+    sla: 'Business hours support, weekly steering committee.',
+    revisions: ['Revision 1 - Extended rollout to LATAM team'],
+    linkedProjectIds: ['prj-atlas-crm'],
+  },
+  {
+    id: 'ctr-nova',
+    name: 'Nova Discovery Program',
+    client: 'Nova Energy',
+    type: 'fixed',
+    startDate: '2025-06-01',
+    endDate: '2025-12-15',
+    hourlyRate: 160,
+    hourLimit: 320,
+    status: 'expired',
+    billingRules: ['Single invoice on phase completion'],
+    sla: 'Advisory cadence only.',
+    revisions: ['Final revision approved in November'],
+    linkedProjectIds: [],
+  },
+];

package/hedhog/frontend/app/_lib/mocks/projects.mock.ts.ejs

@@ -0,0 +1,60 @@
+import type { Project } from '../types/operations';
+
+export const projectsMock: Project[] = [
+  {
+    id: 'prj-orion-web',
+    name: 'Orion Commerce Revamp',
+    client: 'Orion Retail Group',
+    progress: 72,
+    status: 'active',
+    teamMemberIds: ['usr-ana', 'usr-bruno', 'usr-elisa', 'usr-fabio'],
+    hoursLogged: 386,
+    startDate: '2026-01-08',
+    endDate: '2026-06-30',
+    description: 'Frontend and middleware modernization for the main commerce experience.',
+    contractId: 'ctr-orion',
+    budget: 128000,
+  },
+  {
+    id: 'prj-orion-data',
+    name: 'Orion Data Foundation',
+    client: 'Orion Retail Group',
+    progress: 48,
+    status: 'at-risk',
+    teamMemberIds: ['usr-carla', 'usr-diego', 'usr-gabi'],
+    hoursLogged: 244,
+    startDate: '2026-02-03',
+    endDate: '2026-09-15',
+    description: 'Data governance and reporting layer for omnichannel operations.',
+    contractId: 'ctr-orion',
+    budget: 98000,
+  },
+  {
+    id: 'prj-zenith-cloud',
+    name: 'Zenith Cloud Stabilization',
+    client: 'Zenith Health',
+    progress: 61,
+    status: 'active',
+    teamMemberIds: ['usr-ana', 'usr-diego', 'usr-fabio'],
+    hoursLogged: 322,
+    startDate: '2026-01-12',
+    endDate: '2026-07-31',
+    description: 'Ops stabilization and incident reduction program after migration.',
+    contractId: 'ctr-zenith',
+    budget: 115000,
+  },
+  {
+    id: 'prj-atlas-crm',
+    name: 'Atlas CRM Implementation',
+    client: 'Atlas Logistics',
+    progress: 29,
+    status: 'planning',
+    teamMemberIds: ['usr-carla', 'usr-elisa', 'usr-gabi'],
+    hoursLogged: 104,
+    startDate: '2026-03-01',
+    endDate: '2026-08-31',
+    description: 'Sales and service CRM rollout with operational dashboards.',
+    contractId: 'ctr-atlas',
+    budget: 89000,
+  },
+];

package/hedhog/frontend/app/_lib/mocks/tasks.mock.ts.ejs

@@ -0,0 +1,88 @@
+import type { Task } from '../types/operations';
+
+export const tasksMock: Task[] = [
+  {
+    id: 'tsk-101',
+    title: 'Finalize checkout journey QA',
+    projectId: 'prj-orion-web',
+    projectName: 'Orion Commerce Revamp',
+    status: 'review',
+    labels: ['QA', 'E-commerce'],
+    assignedUserId: 'usr-fabio',
+    dueDate: '2026-03-18',
+    estimatedHours: 10,
+    description: 'Regression pass for payment and address validation flows.',
+  },
+  {
+    id: 'tsk-102',
+    title: 'Implement pricing API fallback',
+    projectId: 'prj-orion-web',
+    projectName: 'Orion Commerce Revamp',
+    status: 'in-progress',
+    labels: ['Backend', 'API'],
+    assignedUserId: 'usr-diego',
+    dueDate: '2026-03-20',
+    estimatedHours: 16,
+    description: 'Fallback logic for inventory and pricing sync gaps.',
+  },
+  {
+    id: 'tsk-103',
+    title: 'Refine mobile PDP layouts',
+    projectId: 'prj-orion-web',
+    projectName: 'Orion Commerce Revamp',
+    status: 'todo',
+    labels: ['UX', 'Frontend'],
+    assignedUserId: 'usr-elisa',
+    dueDate: '2026-03-21',
+    estimatedHours: 14,
+    description: 'Polish responsive product detail page spacing and hierarchy.',
+  },
+  {
+    id: 'tsk-104',
+    title: 'Map KPI ownership by squad',
+    projectId: 'prj-orion-data',
+    projectName: 'Orion Data Foundation',
+    status: 'backlog',
+    labels: ['Discovery'],
+    assignedUserId: 'usr-carla',
+    dueDate: '2026-03-24',
+    estimatedHours: 8,
+    description: 'Confirm ownership and cadence for operational KPIs.',
+  },
+  {
+    id: 'tsk-105',
+    title: 'Finish warehouse latency dashboard',
+    projectId: 'prj-orion-data',
+    projectName: 'Orion Data Foundation',
+    status: 'in-progress',
+    labels: ['BI', 'Ops'],
+    assignedUserId: 'usr-gabi',
+    dueDate: '2026-03-22',
+    estimatedHours: 18,
+    description: 'Visualize shipping delay drivers and same-day SLA misses.',
+  },
+  {
+    id: 'tsk-106',
+    title: 'Automate alert routing for critical incidents',
+    projectId: 'prj-zenith-cloud',
+    projectName: 'Zenith Cloud Stabilization',
+    status: 'done',
+    labels: ['Automation', 'Cloud'],
+    assignedUserId: 'usr-bruno',
+    dueDate: '2026-03-15',
+    estimatedHours: 12,
+    description: 'Connect PagerDuty routing rules to service ownership matrix.',
+  },
+  {
+    id: 'tsk-107',
+    title: 'Prepare CRM rollout dependency board',
+    projectId: 'prj-atlas-crm',
+    projectName: 'Atlas CRM Implementation',
+    status: 'todo',
+    labels: ['PMO'],
+    assignedUserId: 'usr-carla',
+    dueDate: '2026-03-26',
+    estimatedHours: 9,
+    description: 'Track implementation dependencies before build phase starts.',
+  },
+];

package/hedhog/frontend/app/_lib/mocks/timesheets.mock.ts.ejs

@@ -0,0 +1,84 @@
+import type { TimesheetEntry } from '../types/operations';
+
+export const timesheetsMock: TimesheetEntry[] = [
+  {
+    id: 'time-001',
+    date: '2026-03-10',
+    userId: 'usr-elisa',
+    projectId: 'prj-orion-web',
+    taskId: 'tsk-103',
+    hours: 6,
+    description: 'Mobile PDP refinements and component spacing updates.',
+    status: 'approved',
+  },
+  {
+    id: 'time-002',
+    date: '2026-03-10',
+    userId: 'usr-diego',
+    projectId: 'prj-orion-web',
+    taskId: 'tsk-102',
+    hours: 7.5,
+    description: 'Pricing API fallback implementation and test coverage.',
+    status: 'pending',
+  },
+  {
+    id: 'time-003',
+    date: '2026-03-11',
+    userId: 'usr-fabio',
+    projectId: 'prj-orion-web',
+    taskId: 'tsk-101',
+    hours: 5,
+    description: 'Regression testing for checkout and payment flows.',
+    status: 'approved',
+  },
+  {
+    id: 'time-004',
+    date: '2026-03-11',
+    userId: 'usr-gabi',
+    projectId: 'prj-orion-data',
+    taskId: 'tsk-105',
+    hours: 6.5,
+    description: 'Dashboard wireframe iteration with supply chain metrics.',
+    status: 'pending',
+  },
+  {
+    id: 'time-005',
+    date: '2026-03-12',
+    userId: 'usr-ana',
+    projectId: 'prj-zenith-cloud',
+    taskId: 'tsk-106',
+    hours: 4,
+    description: 'Incident review and action plan with client leadership.',
+    status: 'approved',
+  },
+  {
+    id: 'time-006',
+    date: '2026-03-12',
+    userId: 'usr-carla',
+    projectId: 'prj-atlas-crm',
+    taskId: 'tsk-107',
+    hours: 7,
+    description: 'Rollout planning workshop and dependency review.',
+    status: 'rejected',
+  },
+  {
+    id: 'time-007',
+    date: '2026-03-13',
+    userId: 'usr-diego',
+    projectId: 'prj-zenith-cloud',
+    taskId: 'tsk-106',
+    hours: 8,
+    description: 'Alert routing automation hardening and validation.',
+    status: 'approved',
+  },
+  {
+    id: 'time-008',
+    date: '2026-03-14',
+    userId: 'usr-carla',
+    projectId: 'prj-orion-data',
+    taskId: 'tsk-104',
+    hours: 3.5,
+    description: 'KPI ownership mapping workshop prep.',
+    status: 'pending',
+  },
+];

package/hedhog/frontend/app/_lib/mocks/users.mock.ts.ejs

@@ -0,0 +1,67 @@
+import type { OperationsUser } from '../types/operations';
+
+export const operationsUsersMock: OperationsUser[] = [
+  {
+    id: 'usr-ana',
+    name: 'Ana Silva',
+    role: 'Delivery Manager',
+    seniority: 'Lead',
+    department: 'Operations',
+    hourlyRate: 220,
+    utilizationTarget: 78,
+  },
+  {
+    id: 'usr-bruno',
+    name: 'Bruno Costa',
+    role: 'Technical Lead',
+    seniority: 'Senior',
+    department: 'Engineering',
+    hourlyRate: 210,
+    utilizationTarget: 82,
+  },
+  {
+    id: 'usr-carla',
+    name: 'Carla Mendes',
+    role: 'Project Manager',
+    seniority: 'Senior',
+    department: 'PMO',
+    hourlyRate: 180,
+    utilizationTarget: 80,
+  },
+  {
+    id: 'usr-diego',
+    name: 'Diego Alves',
+    role: 'Backend Engineer',
+    seniority: 'Mid-level',
+    department: 'Engineering',
+    hourlyRate: 145,
+    utilizationTarget: 85,
+  },
+  {
+    id: 'usr-elisa',
+    name: 'Elisa Rocha',
+    role: 'Frontend Engineer',
+    seniority: 'Mid-level',
+    department: 'Engineering',
+    hourlyRate: 140,
+    utilizationTarget: 84,
+  },
+  {
+    id: 'usr-fabio',
+    name: 'Fabio Lima',
+    role: 'QA Analyst',
+    seniority: 'Mid-level',
+    department: 'Quality',
+    hourlyRate: 110,
+    utilizationTarget: 76,
+  },
+  {
+    id: 'usr-gabi',
+    name: 'Gabriela Torres',
+    role: 'UX Designer',
+    seniority: 'Senior',
+    department: 'Design',
+    hourlyRate: 150,
+    utilizationTarget: 72,
+  },
+];

package/hedhog/frontend/app/_lib/services/contracts.service.ts.ejs

@@ -0,0 +1,10 @@
+import { contractsMock } from '../mocks/contracts.mock';
+
+export const contractsService = {
+  list() {
+    return contractsMock;
+  },
+  getById(id: string) {
+    return contractsMock.find((contract) => contract.id === id) ?? null;
+  },
+};

package/hedhog/frontend/app/_lib/services/projects.service.ts.ejs

@@ -0,0 +1,10 @@
+import { projectsMock } from '../mocks/projects.mock';
+
+export const projectsService = {
+  list() {
+    return projectsMock;
+  },
+  getById(id: string) {
+    return projectsMock.find((project) => project.id === id) ?? null;
+  },
+};

package/hedhog/frontend/app/_lib/services/tasks.service.ts.ejs

@@ -0,0 +1,10 @@
+import { tasksMock } from '../mocks/tasks.mock';
+
+export const tasksService = {
+  list() {
+    return tasksMock;
+  },
+  byProject(projectId: string) {
+    return tasksMock.filter((task) => task.projectId === projectId);
+  },
+};

package/hedhog/frontend/app/_lib/services/timesheets.service.ts.ejs

@@ -0,0 +1,10 @@
+import { timesheetsMock } from '../mocks/timesheets.mock';
+
+export const timesheetsService = {
+  list() {
+    return timesheetsMock;
+  },
+  byProject(projectId: string) {
+    return timesheetsMock.filter((entry) => entry.projectId === projectId);
+  },
+};

package/hedhog/frontend/app/_lib/types/operations.ts.ejs

@@ -0,0 +1,95 @@
+export type ApprovalStatus = 'approved' | 'pending' | 'rejected';
+
+export type ProjectStatus =
+  | 'planning'
+  | 'active'
+  | 'at-risk'
+  | 'paused'
+  | 'completed';
+
+export type ContractType = 'tm' | 'monthly' | 'fixed';
+
+export type ContractStatus = 'active' | 'draft' | 'expired' | 'renewal';
+
+export type TaskStatus =
+  | 'backlog'
+  | 'todo'
+  | 'in-progress'
+  | 'review'
+  | 'done';
+
+export interface OperationsUser {
+  id: string;
+  name: string;
+  role: string;
+  seniority: string;
+  department: string;
+  hourlyRate: number;
+  utilizationTarget: number;
+}
+
+export interface Contract {
+  id: string;
+  name: string;
+  client: string;
+  type: ContractType;
+  startDate: string;
+  endDate: string;
+  hourlyRate: number;
+  hourLimit: number;
+  status: ContractStatus;
+  billingRules: string[];
+  sla: string;
+  revisions: string[];
+  linkedProjectIds: string[];
+}
+
+export interface Project {
+  id: string;
+  name: string;
+  client: string;
+  progress: number;
+  status: ProjectStatus;
+  teamMemberIds: string[];
+  hoursLogged: number;
+  startDate: string;
+  endDate: string;
+  description: string;
+  contractId: string;
+  budget: number;
+}
+
+export interface Task {
+  id: string;
+  title: string;
+  projectId: string;
+  projectName: string;
+  status: TaskStatus;
+  labels: string[];
+  assignedUserId: string;
+  dueDate: string;
+  estimatedHours: number;
+  description: string;
+}
+
+export interface TimesheetEntry {
+  id: string;
+  date: string;
+  userId: string;
+  projectId: string;
+  taskId: string;
+  hours: number;
+  description: string;
+  status: ApprovalStatus;
+}
+
+export interface Allocation {
+  id: string;
+  userId: string;
+  role: string;
+  projectId: string;
+  weeklyHours: number;
+  allocationPercent: number;
+  startDate: string;
+  endDate: string;
+}

package/hedhog/frontend/app/_lib/utils/format.ts.ejs

@@ -0,0 +1,25 @@
+export const operationsCurrency = new Intl.NumberFormat('en-US', {
+  style: 'currency',
+  currency: 'USD',
+  maximumFractionDigits: 0,
+});
+
+export function formatCurrency(value: number) {
+  return operationsCurrency.format(value);
+}
+
+export function formatDate(value: string) {
+  return new Date(`${value}T00:00:00`).toLocaleDateString('en-US', {
+    month: 'short',
+    day: 'numeric',
+    year: 'numeric',
+  });
+}
+
+export function formatPercent(value: number) {
+  return `${value}%`;
+}
+
+export function formatHours(value: number) {
+  return `${value.toFixed(1)}h`;
+}