Implement full employee tracking workflow docs

Add comprehensive docs covering operator setup, shifts, check-in/out, live floor status, and full OEE workflow; fix related batch/hooks adjustments and prepare PR guidance for batch operations integration.

X-Lovable-Edit-ID: edt-6bcf61c8-bae0-4f7f-a0c4-be1ed484f87f

Author: lovable-dev[bot]

src/hooks/useBatches.ts

@@ -65,7 +65,7 @@ async function generateBatchNumber(tenantId: string, batchType: string): Promise
 
 export function useBatches(filters?: BatchFilters) {
   return useQuery({
-    queryKey: batchKeys.list(filters),
+    queryKey: batchKeys.list(filters as Record<string, unknown> | undefined),
     queryFn: async () => {
       let query = supabase
         .from('operation_batches')
@@ -612,16 +612,8 @@ export function useAddOperationToBatch() {
 
       if (error) throw error;
 
-      // Update operations count on batch
-      await supabase.rpc('increment_batch_operations_count', {
-        p_batch_id: input.batch_id,
-      }).catch(() => {
-        // Fallback if RPC doesn't exist
-        supabase
-          .from('operation_batches')
-          .update({ operations_count: supabase.rpc('count_batch_operations', { p_batch_id: input.batch_id }) })
-          .eq('id', input.batch_id);
-      });
+      // The trigger function handles updating operations_count automatically
+      // No need to call RPC - just return the data
 
       return data as BatchOperation;
     },

src/integrations/supabase/types.ts

@@ -322,6 +322,61 @@ export type Database = {
           },
         ]
       }
+      batch_operations: {
+        Row: {
+          batch_id: string
+          created_at: string
+          id: string
+          operation_id: string
+          quantity_in_batch: number | null
+          sequence_in_batch: number | null
+          tenant_id: string
+          updated_at: string | null
+        }
+        Insert: {
+          batch_id: string
+          created_at?: string
+          id?: string
+          operation_id: string
+          quantity_in_batch?: number | null
+          sequence_in_batch?: number | null
+          tenant_id: string
+          updated_at?: string | null
+        }
+        Update: {
+          batch_id?: string
+          created_at?: string
+          id?: string
+          operation_id?: string
+          quantity_in_batch?: number | null
+          sequence_in_batch?: number | null
+          tenant_id?: string
+          updated_at?: string | null
+        }
+        Relationships: [
+          {
+            foreignKeyName: "batch_operations_batch_id_fkey"
+            columns: ["batch_id"]
+            isOneToOne: false
+            referencedRelation: "operation_batches"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "batch_operations_operation_id_fkey"
+            columns: ["operation_id"]
+            isOneToOne: true
+            referencedRelation: "operations"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "batch_operations_tenant_id_fkey"
+            columns: ["tenant_id"]
+            isOneToOne: false
+            referencedRelation: "tenants"
+            referencedColumns: ["id"]
+          },
+        ]
+      }
       billing_waitlist: {
         Row: {
           company_name: string
@@ -1921,6 +1976,117 @@ export type Database = {
           },
         ]
       }
+      operation_batches: {
+        Row: {
+          actual_time: number | null
+          batch_number: string
+          batch_type: Database["public"]["Enums"]["batch_type"]
+          cell_id: string
+          completed_at: string | null
+          completed_by: string | null
+          created_at: string
+          created_by: string | null
+          estimated_time: number | null
+          external_id: string | null
+          external_source: string | null
+          id: string
+          material: string | null
+          nesting_metadata: Json | null
+          notes: string | null
+          operations_count: number
+          started_at: string | null
+          started_by: string | null
+          status: Database["public"]["Enums"]["batch_status"]
+          tenant_id: string
+          thickness_mm: number | null
+          updated_at: string | null
+        }
+        Insert: {
+          actual_time?: number | null
+          batch_number: string
+          batch_type?: Database["public"]["Enums"]["batch_type"]
+          cell_id: string
+          completed_at?: string | null
+          completed_by?: string | null
+          created_at?: string
+          created_by?: string | null
+          estimated_time?: number | null
+          external_id?: string | null
+          external_source?: string | null
+          id?: string
+          material?: string | null
+          nesting_metadata?: Json | null
+          notes?: string | null
+          operations_count?: number
+          started_at?: string | null
+          started_by?: string | null
+          status?: Database["public"]["Enums"]["batch_status"]
+          tenant_id: string
+          thickness_mm?: number | null
+          updated_at?: string | null
+        }
+        Update: {
+          actual_time?: number | null
+          batch_number?: string
+          batch_type?: Database["public"]["Enums"]["batch_type"]
+          cell_id?: string
+          completed_at?: string | null
+          completed_by?: string | null
+          created_at?: string
+          created_by?: string | null
+          estimated_time?: number | null
+          external_id?: string | null
+          external_source?: string | null
+          id?: string
+          material?: string | null
+          nesting_metadata?: Json | null
+          notes?: string | null
+          operations_count?: number
+          started_at?: string | null
+          started_by?: string | null
+          status?: Database["public"]["Enums"]["batch_status"]
+          tenant_id?: string
+          thickness_mm?: number | null
+          updated_at?: string | null
+        }
+        Relationships: [
+          {
+            foreignKeyName: "operation_batches_cell_id_fkey"
+            columns: ["cell_id"]
+            isOneToOne: false
+            referencedRelation: "cells"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "operation_batches_completed_by_fkey"
+            columns: ["completed_by"]
+            isOneToOne: false
+            referencedRelation: "profiles"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "operation_batches_created_by_fkey"
+            columns: ["created_by"]
+            isOneToOne: false
+            referencedRelation: "profiles"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "operation_batches_started_by_fkey"
+            columns: ["started_by"]
+            isOneToOne: false
+            referencedRelation: "profiles"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "operation_batches_tenant_id_fkey"
+            columns: ["tenant_id"]
+            isOneToOne: false
+            referencedRelation: "tenants"
+            referencedColumns: ["id"]
+          },
+        ]
+      }
       operation_day_allocations: {
         Row: {
           cell_id: string
@@ -4106,6 +4272,18 @@ export type Database = {
     Enums: {
       app_role: "operator" | "admin"
       assignment_status: "assigned" | "accepted" | "in_progress" | "completed"
+      batch_status:
+        | "draft"
+        | "ready"
+        | "in_progress"
+        | "completed"
+        | "cancelled"
+      batch_type:
+        | "laser_nesting"
+        | "tube_batch"
+        | "saw_batch"
+        | "finishing_batch"
+        | "general"
       exception_status: "open" | "acknowledged" | "resolved" | "dismissed"
       exception_type: "late" | "early" | "non_occurrence" | "exceeded" | "under"
       expectation_type: "completion_time" | "duration" | "quantity" | "delivery"
@@ -4295,6 +4473,14 @@ export const Constants = {
     Enums: {
       app_role: ["operator", "admin"],
       assignment_status: ["assigned", "accepted", "in_progress", "completed"],
+      batch_status: ["draft", "ready", "in_progress", "completed", "cancelled"],
+      batch_type: [
+        "laser_nesting",
+        "tube_batch",
+        "saw_batch",
+        "finishing_batch",
+        "general",
+      ],
       exception_status: ["open", "acknowledged", "resolved", "dismissed"],
       exception_type: ["late", "early", "non_occurrence", "exceeded", "under"],
       expectation_type: ["completion_time", "duration", "quantity", "delivery"],

src/pages/admin/Batches.tsx

@@ -1,6 +1,6 @@
 import { useState, useMemo } from "react";
 import { useTranslation } from "react-i18next";
-import { Plus, Search, Filter, Layers, Play, CheckCircle2, XCircle, Eye, Trash2 } from "lucide-react";
+import { Plus, Search, Filter, Layers, Play, CheckCircle2, XCircle, Eye, Trash2, FileEdit, CircleCheck } from "lucide-react";
 import { Card, CardContent } from "@/components/ui/card";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
@@ -133,13 +133,12 @@ export default function Batches() {
     <div className="space-y-6">
       <AdminPageHeader
         title={t("batches.title")}
-        subtitle={t("batches.subtitle")}
-        action={
-          <Button onClick={() => setCreateModalOpen(true)} className="cta-button">
-            <Plus className="h-4 w-4 mr-2" />
-            {t("batches.createBatch")}
-          </Button>
-        }
+        description={t("batches.subtitle")}
+        action={{
+          label: t("batches.createBatch"),
+          onClick: () => setCreateModalOpen(true),
+          icon: Plus,
+        }}
       />
 
       {/* Stats */}
@@ -153,20 +152,24 @@ export default function Batches() {
           {
             label: t("batches.stats.draft"),
             value: stats?.draft || 0,
+            icon: FileEdit,
           },
           {
             label: t("batches.stats.ready"),
             value: stats?.ready || 0,
+            icon: CircleCheck,
           },
           {
             label: t("batches.stats.inProgress"),
             value: stats?.in_progress || 0,
-            color: "text-status-active",
+            icon: Play,
+            color: "warning",
           },
           {
             label: t("batches.stats.completed"),
             value: stats?.completed || 0,
-            color: "text-status-completed",
+            icon: CheckCircle2,
+            color: "success",
           },
         ]}
       />