feat: Rename POS employee role 'Waiter/Server' to 'Server', add module documentation, and include a .gitignore file.

This commit is contained in:
Suherdy Yacob 2026-03-13 10:53:04 +07:00
parent 1616f6735e
commit aff682dab4
4 changed files with 61 additions and 2 deletions

17
.gitignore vendored Normal file
View File

@ -0,0 +1,17 @@
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class
# IDE configurations
.vscode/
.idea/
# OS generated files
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
ehthumbs.db
Thumbs.db

42
README.md Normal file
View File

@ -0,0 +1,42 @@
# POS Employee Role for Odoo 19
This custom Odoo module extends the Point of Sale application to allow managing employee roles when using the "Log in with Employees" feature.
## Features
It adds a **POS Role** selector to the Employee profile under the `HR Settings -> Attendance/Point of Sale` tab.
The module provides four distinct roles to restrict UI elements:
1. **Server** (formerly Waiter/Server):
- Can only take orders.
- **Cannot** access the Payment screen.
- **Cannot** issue Refunds.
- **Cannot** Print Reports or Close the Register.
- **Cannot** access the Odoo Backend.
2. **Cashier**:
- Can take orders and process payments.
- **Cannot** issue Refunds.
- **Cannot** Print Reports.
- **Cannot** access the Odoo Backend.
3. **Outlet Manager**:
- Has full access to order management.
- **Can** issue Refunds.
- **Can** Print Reports and Close the Register.
- **Can** access the Odoo Backend.
4. **Area Manager**:
- Has all access (same as Outlet Manager).
## Installation
1. Ensure the `point_of_sale` and `pos_hr` modules are installed.
2. Place the `pos_employee_role` directory into your Odoo custom addons directory.
3. Update the App List and install the "POS Employee Role" module.
## Configuration
1. Go to **Employees** -> Select an Employee.
2. Navigate to the **HR Settings** tab.
3. Under the **Attendance/Point of Sale** section, select the desired **POS Role**.
4. Ensure the employee has a **PIN Code** assigned for POS Login.
5. In your POS configuration, make sure the employee is added to the "Employees with access" list.
## Dependencies
- `point_of_sale`
- `pos_hr`

View File

@ -6,7 +6,7 @@
'summary': 'Add roles to employees for POS permissions', 'summary': 'Add roles to employees for POS permissions',
'description': """ 'description': """
This module adds a role to employees for Point of Sale. This module adds a role to employees for Point of Sale.
Roles: Waiter/Server, Cashier, Outlet Manager, Area Manager. Roles: Server, Cashier, Outlet Manager, Area Manager.
These roles are used to restrict POS UI features dynamically. These roles are used to restrict POS UI features dynamically.
""", """,
'depends': ['point_of_sale', 'pos_hr'], 'depends': ['point_of_sale', 'pos_hr'],

View File

@ -6,7 +6,7 @@ class HrEmployee(models.Model):
_inherit = 'hr.employee' _inherit = 'hr.employee'
pos_role = fields.Selection([ pos_role = fields.Selection([
('waiter', 'Waiter/Server'), ('waiter', 'Server'),
('cashier', 'Cashier'), ('cashier', 'Cashier'),
('outlet_manager', 'Outlet Manager'), ('outlet_manager', 'Outlet Manager'),
('area_manager', 'Area Manager') ('area_manager', 'Area Manager')