{
  "project": "Inventory Management System",
  "version": "1.0",
  "date": "2025-08-22",
  "team": ["Mohit Jawanjal", "Zach Richmond", "Josh Campbell"],
  
  "server_configuration": {
    "php_executable": "/opt/cpanel/ea-php84/root/bin/php",
    "composer_command": "/opt/cpanel/ea-php84/root/bin/php /usr/local/bin/composer",
    "important_note": "Always use the specified PHP path due to server compatibility issues"
  },
  
  "design_preferences": {
    "layout": "Compact and modern",
    "inspiration": "Amazon Seller Central",
    "key_principles": [
      "High readability",
      "Efficient use of space",
      "Clean data tables",
      "Clear navigation hierarchy",
      "Mobile-responsive design"
    ],
    "ui_components": {
      "tables": "Dense data grids with inline actions",
      "forms": "Compact form layouts with clear labels",
      "navigation": "Sidebar with collapsible sections",
      "dashboard": "Widget-based overview with key metrics",
      "color_scheme": "Professional with subtle accent colors"
    }
  },
  
  "database_schema": {
    "products": {
      "fields": [
        "id",
        "product_id",
        "supplier_part_number",
        "partslink",
        "supplier",
        "average_price",
        "created_at",
        "updated_at"
      ]
    },
    "stocks": {
      "fields": [
        "id",
        "product_id",
        "warehouse_id",
        "location_id (foreign key to locations table)",
        "sub_location",
        "quantity",
        "reserved_quantity",
        "available_quantity (virtual)",
        "is_selling",
        "average_price",
        "condition",
        "last_counted_at",
        "created_at",
        "updated_at"
      ]
    },
    "warehouses": {
      "fields": [
        "id",
        "name (e.g., Go-Parts GA)",
        "address",
        "city",
        "state",
        "zip",
        "country",
        "phone",
        "email",
        "is_active",
        "created_at",
        "updated_at"
      ]
    },
    "locations": {
      "fields": [
        "id",
        "warehouse_id",
        "location (e.g., 2.2 E, 3.1 F)",
        "description",
        "type (storage/receiving/shipping/quarantine)",
        "is_active",
        "created_at",
        "updated_at"
      ]
    },
    "purchase_orders": {
      "fields": [
        "id",
        "po_number",
        "supplier",
        "order_date",
        "expected_date",
        "status",
        "total_amount",
        "created_at",
        "updated_at"
      ]
    },
    "purchase_order_items": {
      "fields": [
        "id",
        "purchase_order_id",
        "product_id",
        "quantity",
        "unit_price",
        "total_price",
        "received_quantity",
        "created_at",
        "updated_at"
      ]
    },
    "return_imports": {
      "fields": [
        "id",
        "return_number",
        "return_date",
        "status",
        "total_items",
        "created_at",
        "updated_at"
      ]
    },
    "return_import_items": {
      "fields": [
        "id",
        "return_import_id",
        "product_id",
        "quantity",
        "condition",
        "unit_price",
        "location_id",
        "created_at",
        "updated_at"
      ]
    },
    "stock_transfers": {
      "fields": [
        "id",
        "transfer_number",
        "from_location_id",
        "to_location_id",
        "product_id",
        "quantity",
        "status",
        "transferred_by",
        "transferred_at",
        "created_at",
        "updated_at"
      ]
    },
    "stock_history": {
      "fields": [
        "id",
        "product_id",
        "location_id",
        "action_type",
        "quantity_change",
        "quantity_after",
        "reference_type",
        "reference_id",
        "user_id",
        "notes",
        "created_at"
      ]
    }
  },
  
  "user_roles": {
    "administrator": {
      "permissions": "all",
      "description": "Complete system access"
    },
    "warehouse_manager": {
      "permissions": ["inventory", "reports", "transfers", "orders"],
      "description": "Complete access with audit trail"
    },
    "operations": {
      "permissions": ["view_inventory", "view_reports", "view_products"],
      "description": "Read-only access"
    }
  },
  
  "features": {
    "auto_complete": {
      "implementation": "Filament Select component with searchable option",
      "targets": [
        "Product search by ID, part number, or partslink",
        "Supplier search by name or code",
        "Location search by warehouse, aisle, rack"
      ]
    },
    "bulk_operations": {
      "stock_transfer": "CSV upload for multiple transfers",
      "return_import": "Bulk import via CSV",
      "purchase_order": "Import from supplier systems"
    },
    "reporting": {
      "stock_history": "Detailed movement tracking",
      "valuation": "Real-time inventory value",
      "qoh": "Quantity on hand by location"
    }
  },
  
  "integration": {
    "go_parts": {
      "system": "partscan_inventory",
      "sync_method": "API or direct database",
      "frequency": "Real-time or scheduled"
    }
  },
  
  "performance_targets": {
    "max_skus": 50000,
    "page_load": "< 2 seconds",
    "search_response": "< 500ms",
    "report_generation": "< 5 seconds"
  },
  
  "development_commands": {
    "artisan": "/opt/cpanel/ea-php84/root/bin/php artisan",
    "composer_install": "/opt/cpanel/ea-php84/root/bin/php /usr/local/bin/composer install",
    "composer_update": "/opt/cpanel/ea-php84/root/bin/php /usr/local/bin/composer update",
    "migrate": "/opt/cpanel/ea-php84/root/bin/php artisan migrate",
    "seed": "/opt/cpanel/ea-php84/root/bin/php artisan db:seed",
    "cache_clear": "/opt/cpanel/ea-php84/root/bin/php artisan cache:clear",
    "create_filament_resource": "/opt/cpanel/ea-php84/root/bin/php artisan make:filament-resource",
    "create_model": "/opt/cpanel/ea-php84/root/bin/php artisan make:model",
    "create_migration": "/opt/cpanel/ea-php84/root/bin/php artisan make:migration"
  }
}