System modules
Objective
Maintain the catalog of system modules. Each module groups submodules and appears as a block in the dynamic sidebar.
How the screen is organized
p-table table with the columns:
| Column | Description |
|---|---|
| Drag handle | To reorder (move up or down). |
| Checkbox | Selection for bulk delete. |
| Name | Module name. |
| Icon | Representative icon. |
| Status | Active or inactive switch. |
| Actions | Edit, delete. |
Available actions
- Create module: high dialog.
- Edit module: adjust name, icon or status.
- Reorder modules: drag rows to change the order of appearance.
- Activate or deactivate: the module and its associated submodules stop showing in the sidebar when deactivated.
- Delete: asks for confirmation; requires
MODULES: ADMIN.
Permissions
MODULES: WRITEto create, edit, reorder.MODULES: ADMINto delete.
Before starting
- Have clear the purpose of the module and which submodules it will group.
- Validate that the icon to use is available in the icon system.
Step by step - Create
- Go to Catalogs -> Modules.
- Click New module.
- Enter: name, key, icon, display order.
- Confirm.
Expected result
- The module is registered and appears as a block in the sidebar (if active).
- The system shows a success message.
Pending: add screenshot of
catalogos-modulos-01-listado.pngandcatalogos-modulos-02-dialogo.png.
Common errors
| Situation | What to do |
|---|---|
| The module does not appear in the sidebar | Verify that it is active and that the session reloaded permissions. |
| The reordering is not saved | Check the connection; the system saves the order automatically. |
Suggested permissions
MODULES: WRITE.
Operational recommendations
- Avoid creating modules with redundant names.
- Document internally which submodules belong to each module.
- Before deactivating, validate that no user depends exclusively on that module.
Relation with other modules
- Submodules: each submodule belongs to a module.
- Sidebar: the active modules and their submodules visible according to permissions feed the dynamic side menu.