mirror of
https://github.com/inventree/InvenTree.git
synced 2025-06-30 02:30:52 +00:00
11ab0203b1
* Add builtin plugin for auto-issuing orders * Add plugin to auto-issue orders * Add placeholder documentation * Fix typo * Adds image macro - To replace img.html - includes checking if file exists * Fix tooltips * More docs * Adjust plugin settings filters * docs * More docs * More docs * Updates * Less restrictive URL checking * Refactor build order page * Fix typo * Allow 429 * Debug output * More debug * Construct assets dir * Cleanup * Update docs README * Refactoring more pages * Fix image link * Fix SSO settings * Add hook to check for missing settings - Ensure that all settings are documented! * Add missing user settings * Update docstring * Tweak SSO.md * Image updates * More updates * Tweaks * Exclude orders without a target_date * Fix for issuing build orders * Further refactoring * Fixes * Image refactoring * More refactoring * More refactoring * Refactor app images * Fix pathing issues * Suppress some openapidocs warnings in logs (much easier to debug docs build issues) * Fix image reference * Reduce error messages * Fix image links * Fix image links * Reduce docs log output * Ensure settings are loaded before displaying them * Fix for UI test * Fix unit test * Test tweaks
75 lines
3.3 KiB
Markdown
75 lines
3.3 KiB
Markdown
---
|
|
title: InvenTree Admin Interfaces
|
|
---
|
|
|
|
There are multiple administration interfaces available in InvenTree, which provide different levels of access to the underlying resources and different operational safety.
|
|
|
|
- Admin Center - Main interface for managing InvenTree - Robust verification and safety checks
|
|
- System Settings - Access to all settings - Robust verification, requires reading the documentation
|
|
- Backend Admin Interface - Low level access to the database - Few verification or safety checks
|
|
|
|
### Admin Center
|
|
|
|
The Admin Center is the main interface for managing InvenTree. It provides a user-friendly interface for managing all aspects of the system, including:
|
|
- Users / Groups
|
|
- Data import / export
|
|
- Customisation (e.g. project codes, custom states, parameters and units)
|
|
- Operational controls (e.g. background tasks, errors, currencies)
|
|
- Integration with external services (via machines and plugins)
|
|
- Reporting and statistics
|
|
|
|
It can be access via the *Admin Center* link in the top right user menu, the *Admin Center* quick-link in the command palette, or via the navigation menu.
|
|
|
|
#### Permissions
|
|
|
|
Some panes can only be accessed by users with specific permissions. For example, the *Stocktake* pane can only be accessed by users with the `stocktake` permission.
|
|
|
|
### System Settings
|
|
|
|
The System Settings interface provides ordered access to all global settings in InvenTree. Users need to have _staff_ privileges enabled or the _a:staff_ scope.
|
|
|
|
### Backend Admin Interface
|
|
|
|
Users which have *staff* privileges have access to an Admin interface which provides extremely low level control of the database. Every item in the database is available and this interface provides a unrestricted option for directly viewing and modifying database objects.
|
|
|
|
!!! warning "Caution"
|
|
Admin users should exercise extreme care when modifying data via the admin interface, as performing the wrong action may have unintended consequences!
|
|
|
|
The admin interface allows *staff* users the ability to directly view / add / edit / delete database entries according to their [user permissions](./permissions.md).
|
|
|
|
#### Access Backend Admin Interface
|
|
|
|
To access the admin interface, select the "Admin" option from the drop-down user menu in the top-right corner of the screen.
|
|
|
|
|
|
!!! info "Staff Only"
|
|
Only users with staff access will be able to see the "Admin" option
|
|
|
|
An administration panel will be presented as shown below:
|
|
|
|
{{ image("admin/admin.png", "Admin panel") }}
|
|
|
|
!!! info "Admin URL"
|
|
To directly access the admin interface, append /admin/ to the InvenTree site URL - e.g. http://localhost:8000/admin/
|
|
|
|
#### View Database Objects
|
|
|
|
Database objects can be listed and filtered directly. The image below shows an example of displaying existing part categories.
|
|
|
|
{{ image("admin/part_cats.png", "Part categories") }}
|
|
|
|
!!! info "Permissions"
|
|
A "staff" account does not necessarily provide access to all administration options, depending on the roles assigned to the user.
|
|
|
|
##### Filtering
|
|
|
|
Some admin views support filtering of results against specified criteria. For example, the list of Part objects can be filtered as follows:
|
|
|
|
{{ image("admin/filter.png", "Filter part list") }}
|
|
|
|
#### Edit Database Objects
|
|
|
|
Individual database objects can be edited directly in the admin interface. The image below shows an example of editing a Part object:
|
|
|
|
{{ image("admin/edit_part.png", "Edit part") }}
|