Skip to main content

Products

The Products module in Flux CRM handles the creation, management, and tracking of products. Products can be created during contract creation or on the dedicated products page. This section provides a detailed look at how products are managed within the system, including filtering, editing, and tracking features. Currently, product-related pages are built using Blade templates.

Structural Overview​

Frontend (Blade.php)​

Product-related views are handled using Blade templates and include the following pages:

  • Products List Page: Displays a list of all products in the system. This page allows users to filter products based on product type, properties, location, and other criteria.
  • Create Product Page: Users can create new products either during contract creation or directly on the products page.
  • Product Details Page: Shows detailed information about a specific product, including stock status, location, delivery history, and order tracking.

These views are built using Laravel's Blade templating engine and rely on form submissions for data input.

Web Routes​

Web routes that serve the product-related views are defined in web.php. Key routes include:

  • GET /products: Fetches the products list view.
  • GET /products/create: Opens the form to create a new product.
  • GET /products/{id}: Displays details of a specific product.
  • GET /products/edit/{id}: Opens the form to edit an existing product.

Flow of Products​

Products List​

The Products List page shows all available products and offers advanced filtering options:

  • Product Type: Filter by type (e.g., electronics, furniture).
  • Properties: Filter by specific product attributes like size, color, or model.
  • Location: Filter by the product's current storage or warehouse location.

Quick Filters are also available:

  • Everything: Displays all products in the system.
  • Stock: Displays products that are currently in stock.
  • Returns: Displays products that have been returned.

Users can use these filters to quickly navigate and locate products based on their needs.

Creating a Product​

Products can be created in two main ways:

  1. During Contract Creation: When creating a contract, users can add products directly to the contract, and they are stored in the system as part of that contract.
  2. Products Page: Users can navigate to the products page and create a new product independently of a contract.

When creating a product, users enter details such as:

  • Product name, description, and type.
  • Specific properties such as color, size, and model.
  • Location.

Editing a Product​

Users can edit product information via the Edit Product form, including:

  • Updating product properties (e.g., name, description, stock levels).
  • Changing the product's location (e.g., moving it to another warehouse).

Marking a Product as Delivered​

Products associated with a contract can be marked as delivered once they are shipped to the customer. This updates the product's status and moves it from the warehouse to a "delivered" state in the system.

Moving Products to Another Location​

Users can move products between different storage or warehouse locations. This is tracked in the system to ensure accurate inventory management across multiple locations.

Product Tracking and History​

Returns​

For products that need to be sent back to the manufacturer, the system tracks returns by opening a Returns Case. This process involves initiating a return request, sending the product back to the manufacturer, and updating the system with the return status. The Returns Case is monitored through the product's lifecycle, and users can track the product's status as it is processed by the manufacturer.

Order Tracking​

For products ordered from external manufacturers, the system tracks the order status and provides details on:

  • Order Placement: When the product was ordered from the manufacturer.
  • Shipping Status: Whether the product has been shipped and its estimated delivery date.
  • Received Status: Whether the product has arrived at the warehouse or is still in transit.

This information is displayed on the Product Details page and helps the business track the product from order placement to delivery.

Product History​

Every product has a Product History section, which tracks all changes made to the product, including:

  • Creation and edits (e.g., property changes, stock adjustments).
  • Location changes (e.g., moved between warehouses).
  • Delivery status updates.
  • Returns and restocking actions.

This allows for complete traceability of the product lifecycle within the system.