In our platform, the Unit module is essential for defining how product quantities are measured. Whether it’s kilograms, liters, pieces, or another measurement, a unit is used throughout the system to ensure accurate inventory tracking and cost calculations. This guide explains the requirements and processes involved in managing units.

1. Overview of the Unit Module

Purpose:

The Unit module allows you to create and manage the units of measurement used for your products. Proper unit definitions are crucial for:

• Inventory Accuracy: Ensuring that the quantities of products are recorded correctly.

• Cost Calculation: Accurate unit measurements are necessary for calculating raw material consumption and overall production costs.

• Reporting: Clear unit information supports consistent reporting and analysis across your business operations.

Access Control:

Only authenticated users can add, edit, or delete units. This is enforced by our platform’s authentication system.

2. Creating a New Unit

What You Need to Provide

When adding a new unit, there are two key fields:

• Name:

• Requirement: This field is mandatory.

• Validation: You must enter a unit name using up to 50 characters.

• Purpose: The unit name is a short identifier (e.g., Kg, L, Piece) that is used throughout the system to record product quantities.

• Tip: Use concise, standard abbreviations to ensure clarity across your inventory and production reports.

• Description:

• Requirement: This field is optional.

• Validation: If provided, the description should be no longer than 250 characters.

• Purpose: The description helps clarify the context or usage of the unit. For example, if your unit is “Pcs” (pieces), you might add that it represents individual items.

• Tip: Include any details that might be helpful for users who reference these units later.

Data Processing and Security

• Sanitization:

Both the name and description are passed through a sanitization function before being stored. This ensures that the data is clean and secure, protecting against potential security risks like cross-site scripting (XSS).

• Storage:

Once you submit the form, the new unit record is saved to the database. The system stores your input along with additional metadata (like creation and update timestamps).

3. Editing an Existing Unit

How It Works

• Pre-populated Form:

When you edit a unit, the system retrieves the existing record (using a secure, decrypted identifier) and pre-populates the form with its current details. This allows you to see the current name and description before making any changes.

• Making Updates:

You can update the name and/or description. The same validation rules apply as when creating a new unit.

• Saving Changes:

Once updated, the system sanitizes your inputs and saves the changes. The updated information will then appear in your list of active units.

4. Viewing Units

List of Active Units

• Display:

The units list displays only those records that are active (with del_status set to “Live”) and sorts them in descending order by their unique ID.

• Purpose:

This ensures that you only see current, usable units when you’re managing products, keeping your interface clean and focused.

5. How Units Are Used in the System

Units play a vital role across your platform:

• Inventory Management:

Every product is measured in a specific unit, ensuring that quantities are recorded consistently.

• Cost Calculations:

Accurate units ensure that raw material consumption and production costs are calculated correctly.

• Reporting:

Units help maintain clarity in financial and inventory reports, which supports better decision-making and efficient operations.

Conclusion

The Unit module is a foundational element in our production and inventory management system. By following the requirements outlined above—entering a clear, concise unit name and an optional, informative description—you help ensure that all products are measured accurately. This in turn supports reliable cost calculations, efficient inventory tracking, and consistent reporting across your business.

Remember, if you need to add or update units, always adhere to the character limits and guidelines provided. This ensures that the data remains consistent and useful across the platform.

If you have further questions or need additional support regarding units, please refer to our help documentation or contact our support team.