Module
Configuration
Category Management
Configuration · CategoriesPlatforms
Android + Windows
Workspace
2 tabs
Access
Ctrl+F search
Category Management overview
Category Management is VauPrime's product-category master. It keeps category setup intentionally simple: create a unique category name, optionally add a description, search existing categories, edit them or delete them. Product Management loads these category masters for product assignment and category filtering.
What this manages
Category Management is VauPrime's product-category master. It keeps category setup intentionally simple: create a unique category name, optionally add a description, search existing categories, edit them or delete them. Product Management loads these category masters for product assignment and category filtering.
Product Center relationship
Product Management, Product Batches and Category Management work together as configuration masters used by inventory and transaction screens.
Screen workspace
Main areas exposed by the current Category Management implementation.
01
Add Category
Create a new category or update the category currently loaded into edit mode. The form contains Category Name and optional Category Description.
02
Category List
Search, refresh, edit and delete existing category masters. Android uses a mobile list and Windows uses a desktop table.
Categories fields
Visible fields and their current source-backed requirement/behavior.
| Field / message | Requirement / cause | Behavior / action |
|---|---|---|
| Category Name | Required | Primary category name. The form validator shows Enter category name when the field is blank. |
| Category Description | Optional | Free-text description. Category List search also matches this description. |
Category Name
RequiredPrimary category name. The form validator shows Enter category name when the field is blank.
Category Description
OptionalFree-text description. Category List search also matches this description.
Behavior and configurable controls
Additional behavior that matters when using Category Management.
Unique category names
Before create/update, VauPrime loads existing categories and compares Category Name case-insensitively. Edit mode excludes the category currently being edited from the duplicate check.
Product assignment
Product Management loads Category masters and uses them in its Category selection control and Product List category filter.
Android behavior
Category List uses a centralized Android list. Tapping a category or choosing Edit loads it into Add Category for editing.
Windows behavior
The desktop table shows Category Name, Description, Created At and Category ID with Edit/Delete row actions.
Recent activity
Category Management records a read activity when opened and records CRUD activity for category changes.
Save and validation flow
What VauPrime checks and updates when a record is created or edited.
01
Validate Category Name
The Add Category form requires a non-empty Category Name.
Expected result
Blank category names are rejected before any write is attempted.
02
Check duplicate name
Existing category names are compared case-insensitively with the entered Category Name.
Expected result
If a duplicate exists, the duplicate dialog is shown and save stops.
03
Create or update
Normal mode creates the new category; edit mode updates the original Category ID with the latest name/description.
Expected result
The category master reflects the latest saved values.
04
Refresh Category List
After a successful change, the categories future/list is reloaded and the form is reset as appropriate.
Expected result
The latest category is available to Product Management and Category List.
05
Record activity
The category change is recorded in recent activity using the active organization context.
Expected result
Category master maintenance appears in the product's activity history flows.
Existing records and maintenance
Search, list presentation and row actions available after records are created.
Search
Search matches Category Name or Category Description without case sensitivity.
Android list
Displays Category Name, description and created value in the mobile centralized list with Edit/Delete expanded actions.
Windows columns
Desktop Category List displays Category Name, Description, Created At and Category ID.
Edit
Loads the selected category into the form, enables edit mode and updates the existing Category ID on save.
Delete
Delete uses a confirmation sheet that warns the action cannot be undone.
Refresh
Both Android and desktop list controls can reload categories for the current organization.
Validation and troubleshooting
Messages or conditions confirmed from the current screen/service behavior.
| Field / message | Requirement / cause | Behavior / action |
|---|---|---|
| Enter category name | Category Name is empty. | Enter a category name and retry Save Category/Update Category. |
| Duplicate category | Another category has the same name ignoring letter case. | Use a unique name or edit the existing category. |
| Category list empty / load failure | The category service returned no usable categories or loading failed. | Refresh Category List and verify the active organization context. |
| Delete confirmation | A category is about to be permanently deleted. | Review the category name before confirming because the screen labels deletion as non-reversible. |
Enter category name
Category Name is empty.Enter a category name and retry Save Category/Update Category.
Duplicate category
Another category has the same name ignoring letter case.Use a unique name or edit the existing category.
Category list empty / load failure
The category service returned no usable categories or loading failed.Refresh Category List and verify the active organization context.
Delete confirmation
A category is about to be permanently deleted.Review the category name before confirming because the screen labels deletion as non-reversible.
Implementation-backed notes
Important distinctions preserved from the current Dart implementation.
The current Category Management form intentionally contains only Category Name and Category Description; no extra category fields should be assumed.
Duplicate checks are case-insensitive for both create and update.
Category List search matches both name and description.
Category Management is available as an app-wide Ctrl+F Global Search target under Configuration.
Product Management consumes these category masters for product classification.
Related documentation