Scans

🎯 Overview

The Scans Page provides a comprehensive view and management interface for all scanning operations within projects. This interface displays scan records in a tabular format with advanced filtering, sorting, and pagination capabilities. It serves as the central hub for monitoring scanning activities, reviewing scan data, and managing scan records lifecycle including deletion/restoration.

🔐 Access Requirements

👥 Required Roles & Permissions

• View Scans: scans.get permission
• Create Scans: scans.insert permission
• Edit Scans: scans.update permission
• Delete/Restore Scans: Administrative access to project

🌐 Permission Scope

• Project-Based: Access limited to scans within user's assigned projects
• Role-Based Filtering: Different views based on user permissions
• Session Validation: Access tied to active zone sessions

💻 Interface Layout

📋 Main Table View

┌─────────────────────────────────────────────────────────────┐
│ 🔍 [Search] [Zone Filter] [Date Range] [Status] [Actions▼]  │
├─────────────────────────────────────────────────────────────┤
│ 📊 Match Code | Zone | User | Count | Price | Date | Status │
│ ├─────────────┼──────┼──────┼───────┼───────┼──────┼────────┤
│ │ ABC123      │ A1   │ John │  5    │ €12.50│ 14:30│ ✓      │
│ │ DEF456      │ B2   │ Mary │  3    │ €8.75 │ 14:25│ ⚠      │
│ │ GHI789      │ A1   │ John │  2    │ €5.00 │ 14:20│ ✗      │
├─────────────────────────────────────────────────────────────┤
│ 📄 [◀ Prev] Page 1 of 15 [Next ▶] | 📊 150 total scans      │
└─────────────────────────────────────────────────────────────┘

🗂️ Tab Navigation

• 📊 Active Scans: Current scan records
• 🗑️ Deleted Scans: Trashed scan records (if accessible)

🎛️ Filter Controls

• 🔍 Match Code Search: Real-time text filtering
• 🏢 Zone Selection: Filter by warehouse zones
• 👤 User Filter: Filter by scanning operators
• 📅 Date Range: Custom date filtering
• 💰 Price Range: Filter by value ranges
• ✅ Status Filter: Verified/Unverified scans

⭐ Key Features

📊 Data Display

• Dynamic Columns: Configurable based on ScanFlowConfig
• Real-time Updates: Live data synchronization
• Sortable Headers: Click to sort by any column
• Responsive Design: Adapts to mobile/tablet screens

🔍 Advanced Filtering

• Multi-criteria Search: Combine multiple filters
• Regex Support: Pattern matching in match codes
• Case-insensitive Search: Flexible text matching
• Persistent Filters: Maintains filter state during session

📄 Pagination & Performance

• Configurable Page Size: Adjust records per page
• Efficient Loading: Server-side pagination
• Progress Indicators: Loading states for operations
• Lazy Loading: Optimized for large datasets

🎯 Scan Operations

• Quick Edit: In-line editing capabilities
• Bulk Operations: Multi-select actions
• Verification Status: Track scan validation
• Revision History: View scan modification history

📘 Usage Guide

👀 Viewing Scans

1. Navigate to Scans page via main navigation
2. Select Project from project dropdown (if multiple)
3. Apply Filters to narrow down results:
   • Enter match code in search box
   • Select specific zones from dropdown
   • Choose date range using date pickers
   • Filter by verification status
4. Sort Data by clicking column headers
5. Navigate Pages using pagination controls

🔍 Searching & Filtering

1. Text Search:

   🔍 Search: "ABC" → Shows all scans with "ABC" in match code

2. Zone Filtering:

   🏢 Zone: "Warehouse A" → Shows scans from specific zone

3. Date Range:

   📅 From: 2024-01-01 To: 2024-01-31 → Shows January scans

4. Combined Filters:

   🔍 "PRD" + 🏢 "Zone A" + ✅ "Verified" → Specific subset

📊 Understanding Scan Data

• Match Code: Product/item identifier from scanning
• Zone Code: Location where scan was performed
• Warehouse Code: Facility identifier
• Count: Quantity scanned
• Price: Unit value (if configured)
• Created By: Original scanning operator
• Modified By: Last user to edit scan
• Verified By: User who performed verification
• Status Indicators:
  • ✅ Verified: Scan confirmed accurate
  • ⚠️ Unverified: Awaiting verification
  • 🔄 Modified: Scan has been edited
  • 📝 Revision: Shows revision number

🗑️ Managing Deleted Scans

1. Switch to Deleted Tab to view trashed scans
2. Review deleted scan records
3. Restore scans if needed (admin only)
4. Permanent Deletion (admin only, if configured)

⚠️ Troubleshooting

🚫 Common Issues

❌ "No scans found"

• ✅ Check filters: Clear or adjust filter criteria
• ✅ Verify project: Ensure correct project selected
• ✅ Check permissions: Confirm scans.get permission

❌ "Loading forever"

• ✅ Network connection: Check internet connectivity
• ✅ Server status: Verify server accessibility
• ✅ Browser cache: Clear cache and refresh

❌ "Filter not working"

• ✅ Syntax check: Ensure proper search syntax
• ✅ Case sensitivity: Verify case-insensitive matching
• ✅ Data availability: Confirm data exists for criteria

❌ "Permission denied"

• ✅ Role assignment: Contact admin for proper roles
• ✅ Project access: Verify project membership
• ✅ Session validity: Re-login if session expired

📱 Mobile/Responsive Issues

• Horizontal Scrolling: Normal for tables on small screens
• Touch Gestures: Swipe to scroll table content
• Filter Collapse: Filters may collapse on mobile
• Pagination Controls: May stack vertically on small screens

🔄 Performance Optimization

• Use Specific Filters: Narrow down large datasets
• Date Range Limits: Avoid querying entire history
• Page Size Adjustment: Reduce if loading slowly
• Clear Cache: Refresh browser if data seems stale

🛠️ Technical Details

📊 Data Structure

// Scan Record Structure
{
  _id: "scanId123",
  sessionId: "session456",
  originalSessionId: "originalSession789",
  order: 1,
  matchCode: "ABC123",
  count: 5,
  match: {
    code: "ABC123",
    description: "Product ABC",
    price: 12.50,
    // ... additional match fields
  },
  isVerified: true,
  verifyReason: "Quality check passed",
  addMarkerBelow: false,
  modifiedAt: new Date(),
  projectId: "project123",
  qmChecked: false,
  source: "Web",
  deleted: false,
  // Computed fields
  createdBy: { username: "john.doe" },
  modifiedBy: { username: "jane.smith" },
  verifiedBy: { username: "supervisor" },
  warehouseCode: "WH001",
  zoneCode: "A1",
  revision: 1
}

🔧 Configuration Dependencies

• ScanFlowConfig: Defines visible columns and validation rules
• VerifyReasons: Configures required verification reasons
• Project Settings: Controls access and functionality
• Role Permissions: Determines available operations

📡 Real-time Features

• Reactive Subscriptions: Auto-updates when data changes
• Live Filters: Instant search results
• Session Monitoring: Tracks user session state
• Progress Indicators: Shows operation status

🎛️ Filter Implementation

// Filter Structure
{
  matchCode: "ABC",           // Text search
  match: {                    // Match field filtering
    description: "Product",
    price: 12.50
  },
  zoneId: "zone123",         // Zone filtering
  userId: "user456",         // User filtering
  startDate: "2024-01-01",   // Date range start
  endDate: "2024-01-31",     // Date range end
  isVerified: true,          // Verification status
  deleted: false             // Deletion status
}

🔐 Security Features

• Role-based Access: Enforced at method level
• Project Isolation: Users see only assigned projects
• Session Validation: Active session required for operations
• Input Validation: All parameters validated
• Audit Trail: Revision history maintained

📈 Performance Considerations

• Server-side Pagination: Efficient for large datasets
• Indexed Queries: Optimized database access
• Selective Field Loading: Minimizes data transfer
• Caching Strategy: Reduces redundant queries
• Bulk Operations: Efficient multi-record updates

---

This documentation covers the comprehensive scan management interface. For additional assistance or advanced configuration options, consult with your system administrator.