Initial commit: OCA Technical packages (595 packages)

This commit is contained in:
Ernad Husremovic 2025-08-29 15:43:03 +02:00
commit 2cc02aac6e
24950 changed files with 2318079 additions and 0 deletions

View file

@ -0,0 +1,46 @@
# Point of Sale - Cashier Comment
Odoo addon: pos_customer_comment
## Installation
```bash
pip install odoo-bringout-oca-pos-pos_customer_comment
```
## Dependencies
This addon depends on:
- point_of_sale
## Manifest Information
- **Name**: Point of Sale - Cashier Comment
- **Version**: 16.0.1.0.3
- **Category**: Point of Sale
- **License**: AGPL-3
- **Installable**: True
## Source
Based on [OCA/pos](https://github.com/OCA/pos) branch 16.0, addon `pos_customer_comment`.
## License
This package maintains the original AGPL-3 license from the upstream Odoo project.
## Documentation
- Overview: doc/OVERVIEW.md
- Architecture: doc/ARCHITECTURE.md
- Models: doc/MODELS.md
- Controllers: doc/CONTROLLERS.md
- Wizards: doc/WIZARDS.md
- Reports: doc/REPORTS.md
- Security: doc/SECURITY.md
- Install: doc/INSTALL.md
- Usage: doc/USAGE.md
- Configuration: doc/CONFIGURATION.md
- Dependencies: doc/DEPENDENCIES.md
- Troubleshooting: doc/TROUBLESHOOTING.md
- FAQ: doc/FAQ.md

View file

@ -0,0 +1,32 @@
# Architecture
```mermaid
flowchart TD
U[Users] -->|HTTP| V[Views and QWeb Templates]
V --> C[Controllers]
V --> W[Wizards Transient Models]
C --> M[Models and ORM]
W --> M
M --> R[Reports]
DX[Data XML] --> M
S[Security ACLs and Groups] -. enforces .-> M
subgraph Pos_customer_comment Module - pos_customer_comment
direction LR
M:::layer
W:::layer
C:::layer
V:::layer
R:::layer
S:::layer
DX:::layer
end
classDef layer fill:#eef8ff,stroke:#6ea8fe,stroke-width:1px
```
Notes
- Views include tree/form/kanban templates and report templates.
- Controllers provide website/portal routes when present.
- Wizards are UI flows implemented with `models.TransientModel`.
- Data XML loads data/demo records; Security defines groups and access.

View file

@ -0,0 +1,3 @@
# Configuration
Refer to Odoo settings for pos_customer_comment. Configure related models, access rights, and options as needed.

View file

@ -0,0 +1,3 @@
# Controllers
This module does not define custom HTTP controllers.

View file

@ -0,0 +1,5 @@
# Dependencies
This addon depends on:
- [point_of_sale](../../odoo-bringout-oca-ocb-point_of_sale)

View file

@ -0,0 +1,4 @@
# FAQ
- Q: Which Odoo version? A: 16.0 (OCA/OCB packaged).
- Q: How to enable? A: Start server with --addon pos_customer_comment or install in UI.

View file

@ -0,0 +1,7 @@
# Install
```bash
pip install odoo-bringout-oca-pos-pos_customer_comment"
# or
uv pip install odoo-bringout-oca-pos-pos_customer_comment"
```

View file

@ -0,0 +1,13 @@
# Models
Detected core models and extensions in pos_customer_comment.
```mermaid
classDiagram
class pos_session
class res_partner
```
Notes
- Classes show model technical names; fields omitted for brevity.
- Items listed under _inherit are extensions of existing models.

View file

@ -0,0 +1,6 @@
# Overview
Packaged Odoo addon: pos_customer_comment. Provides features documented in upstream Odoo 16 under this addon.
- Source: OCA/OCB 16.0, addon pos_customer_comment
- License: LGPL-3

View file

@ -0,0 +1,3 @@
# Reports
This module does not define custom reports.

View file

@ -0,0 +1,8 @@
# Security
This module does not define custom security rules or access controls beyond Odoo defaults.
Default Odoo security applies:
- Base user access through standard groups
- Model access inherited from dependencies
- No custom row-level security rules

View file

@ -0,0 +1,5 @@
# Troubleshooting
- Ensure Python and Odoo environment matches repo guidance.
- Check database connectivity and logs if startup fails.
- Validate that dependent addons listed in DEPENDENCIES.md are installed.

View file

@ -0,0 +1,7 @@
# Usage
Start Odoo including this addon (from repo root):
```bash
python3 scripts/nix_odoo_web_server.py --db-name mydb --addon pos_customer_comment
```

View file

@ -0,0 +1,3 @@
# Wizards
This module does not include UI wizards.

View file

@ -0,0 +1,118 @@
===============================
Point of Sale - Cashier Comment
===============================
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:4fdce9773e5d7b56fcdad47f1d9d5e8beb3fd5dc302b49c4540dbc3292eba623
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github
:target: https://github.com/OCA/pos/tree/16.0/pos_customer_comment
:alt: OCA/pos
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/pos-16-0/pos-16-0-pos_customer_comment
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/pos&target_branch=16.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
This module extends the functionality of point of sale module, to allow display and edit
customer note field in the point of sale UI for the cashier.
**Table of contents**
.. contents::
:local:
Usage
=====
* Go to your partner view and write or edit new PoS comments
.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_customer_comment/static/description/res_partner_form.png
* Then Open your Point of sale
in the customer tree view, a new icon is available to mention that the customer
has a PoS Comment to read:
.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_customer_comment/static/description/pos_customer_tree.png
It is possible to see or edit the comment in the customer form view:
.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_customer_comment/static/description/pos_customer_form.png
Known issues / Roadmap
======================
For the time being, there is no HTML widget available in the point of sale.
For that reason, the Cashier comment (``pos_comment``) is a simple Text field.
If a widget is available in odoo, it could be great to switch to a HTML field text.
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/pos/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/pos/issues/new?body=module:%20pos_customer_comment%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
Do not contact contributors directly about support or help with technical issues.
Credits
=======
Authors
~~~~~~~
* GRAP
Contributors
~~~~~~~~~~~~
* Sylvain LE GAL (https://twitter.com/legalsylvain)
* Juan Carlos Bonilla <juancarlos.bonilla@factorlibre.com>
Other credits
~~~~~~~~~~~~~
The development of this module has been financially supported by:
* UGESS, Union Nationale des Groupements des épiceries Sociales et Solidaires (https://ugess.org/)
Maintainers
~~~~~~~~~~~
This module is maintained by the OCA.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.
.. |maintainer-legalsylvain| image:: https://github.com/legalsylvain.png?size=40px
:target: https://github.com/legalsylvain
:alt: legalsylvain
Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
|maintainer-legalsylvain|
This module is part of the `OCA/pos <https://github.com/OCA/pos/tree/16.0/pos_customer_comment>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

View file

@ -0,0 +1 @@
from . import models

View file

@ -0,0 +1,34 @@
# Copyright (C) 2022-Today GRAP (http://www.grap.coop)
# @author Sylvain LE GAL (https://twitter.com/legalsylvain)
# License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
{
"name": "Point of Sale - Cashier Comment",
"summary": "Display Customer comment in the PoS front office and allow"
" to edit and save it by the cashier",
"version": "16.0.1.0.3",
"category": "Point of Sale",
"maintainers": ["legalsylvain"],
"author": "GRAP,Odoo Community Association (OCA)",
"website": "https://github.com/OCA/pos",
"license": "AGPL-3",
"depends": ["point_of_sale"],
"data": [
"views/view_res_partner.xml",
],
"assets": {
"point_of_sale.assets": [
"pos_customer_comment/static/src/css/pos_customer_comment.scss",
"pos_customer_comment/static/src/xml/PartnerDetailsEdit.xml",
"pos_customer_comment/static/src/xml/PartnerLine.xml",
"pos_customer_comment/static/src/js/PartnerDetailsEdit.esm.js",
],
"web.assets_tests": [
"pos_customer_comment/tests/tours/PosCustomerComment.tour.js",
],
},
"demo": [
"demo/res_partner.xml",
],
"installable": True,
}

View file

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="utf-8" ?>
<!--
Copyright (C) 2022-Today GRAP (http://www.grap.coop)
@author Sylvain LE GAL (https://twitter.com/legalsylvain)
License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
-->
<odoo>
<record id="base.res_partner_address_31" model="res.partner">
<field
name="pos_comment"
>Important information to display in Point of Sale</field>
</record>
</odoo>

View file

@ -0,0 +1,62 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * pos_customer_comment
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"
#. module: pos_customer_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_users__pos_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid "Cashier Comment"
msgstr "Cashier Comment"
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerDetailsEdit.xml:0
#: code:addons/pos_customer_comment/static/src/xml/PartnerDetailsEdit.xml:0
#, python-format
msgid "Comment"
msgstr "Komentar"
#. module: pos_customer_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_users__pos_comment
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr ""
#. module: pos_customer_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr ""
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_res_partner
msgid "Contact"
msgstr "Kontakt"
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerLine.xml:0
#: code:addons/pos_customer_comment/static/src/xml/PartnerLine.xml:0
#, python-format
msgid "Has PoS Comment"
msgstr "Has PoS Comment"
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_pos_session
msgid "Point of Sale Session"
msgstr "Sesija POS-a"

View file

@ -0,0 +1,65 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * pos_customer_comment
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"PO-Revision-Date: 2023-03-02 16:30+0000\n"
"Last-Translator: Patricia Lorenzo Bartolomé <lb.patri@gmail.com>\n"
"Language-Team: none\n"
"Language: es\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: nplurals=2; plural=n != 1;\n"
"X-Generator: Weblate 4.14.1\n"
#. module: pos_customer_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_users__pos_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid "Cashier Comment"
msgstr "Comentario del cajero"
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerDetailsEdit.xml:0
#, python-format
msgid "Comment"
msgstr "Comentario"
#. module: pos_customer_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_users__pos_comment
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr ""
"Comentario que será visible y editable en el punto de venta para los cajeros"
#. module: pos_customer_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr ""
"Comentario que será visible y editable en el punto de venta para los cajeros"
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_res_partner
msgid "Contact"
msgstr "Contacto"
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerLine.xml:0
#, python-format
msgid "Has PoS Comment"
msgstr "Tiene comentarios en el punto de venta"
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_pos_session
msgid "Point of Sale Session"
msgstr "Sesión TPV"

View file

@ -0,0 +1,65 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * pos_customer_comment
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"PO-Revision-Date: 2023-11-10 12:38+0000\n"
"Last-Translator: LESTRAT21 <elodie@comptoirdecampagne.fr>\n"
"Language-Team: none\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: nplurals=2; plural=n > 1;\n"
"X-Generator: Weblate 4.17\n"
#. module: pos_customer_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_users__pos_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid "Cashier Comment"
msgstr "Commentaire visible en caisse"
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerDetailsEdit.xml:0
#: code:addons/pos_customer_comment/static/src/xml/PartnerDetailsEdit.xml:0
#, python-format
msgid "Comment"
msgstr "Commentaire"
#. module: pos_customer_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_users__pos_comment
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr "Commentaire visible et modifiable par la personne en caisse"
#. module: pos_customer_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr "Commentaire visible et modifiable par la personne en caisse"
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_res_partner
msgid "Contact"
msgstr "Contact"
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerLine.xml:0
#: code:addons/pos_customer_comment/static/src/xml/PartnerLine.xml:0
#, python-format
msgid "Has PoS Comment"
msgstr "Il existe un commentaire pour ce client"
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_pos_session
msgid "Point of Sale Session"
msgstr "Session de caisse"

View file

@ -0,0 +1,67 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * pos_customer_comment
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"PO-Revision-Date: 2023-03-09 13:22+0000\n"
"Last-Translator: mymage <stefano.consolaro@mymage.it>\n"
"Language-Team: none\n"
"Language: it\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: nplurals=2; plural=n != 1;\n"
"X-Generator: Weblate 4.14.1\n"
#. module: pos_customer_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_users__pos_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid "Cashier Comment"
msgstr "Commento cassiere"
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerDetailsEdit.xml:0
#, python-format
msgid "Comment"
msgstr "Commento"
#. module: pos_customer_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_users__pos_comment
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr ""
"Commento per il cassiere che può essere visibile e mdificabile nel punto "
"vendita"
#. module: pos_customer_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr ""
"Commento per il cassiere che può essere visibile e mdificabile nel punto "
"vendita"
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_res_partner
msgid "Contact"
msgstr "Contatto"
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerLine.xml:0
#, python-format
msgid "Has PoS Comment"
msgstr "Ha commento PoS"
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_pos_session
msgid "Point of Sale Session"
msgstr "Sessione punto vendita"

View file

@ -0,0 +1,62 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * pos_customer_comment
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"
#. module: pos_customer_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,field_description:pos_customer_comment.field_res_users__pos_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid "Cashier Comment"
msgstr ""
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerDetailsEdit.xml:0
#: code:addons/pos_customer_comment/static/src/xml/PartnerDetailsEdit.xml:0
#, python-format
msgid "Comment"
msgstr ""
#. module: pos_customer_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_partner__pos_comment
#: model:ir.model.fields,help:pos_customer_comment.field_res_users__pos_comment
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr ""
#. module: pos_customer_comment
#: model_terms:ir.ui.view,arch_db:pos_customer_comment.view_res_partner_form
msgid ""
"Comment that will be visible and editable in the Point of Sale for the "
"cashiers"
msgstr ""
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_res_partner
msgid "Contact"
msgstr ""
#. module: pos_customer_comment
#. odoo-javascript
#: code:addons/pos_customer_comment/static/src/xml/PartnerLine.xml:0
#: code:addons/pos_customer_comment/static/src/xml/PartnerLine.xml:0
#, python-format
msgid "Has PoS Comment"
msgstr ""
#. module: pos_customer_comment
#: model:ir.model,name:pos_customer_comment.model_pos_session
msgid "Point of Sale Session"
msgstr ""

View file

@ -0,0 +1,2 @@
from . import pos_session
from . import res_partner

View file

@ -0,0 +1,14 @@
# Copyright (C) 2022-Today GRAP (http://www.grap.coop)
# @author Sylvain LE GAL (https://twitter.com/legalsylvain)
# License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
from odoo import models
class PosSession(models.Model):
_inherit = "pos.session"
def _loader_params_res_partner(self):
res = super()._loader_params_res_partner()
res["search_params"]["fields"].append("pos_comment")
return res

View file

@ -0,0 +1,15 @@
# Copyright (C) 2022-Today GRAP (http://www.grap.coop)
# @author Sylvain LE GAL (https://twitter.com/legalsylvain)
# License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
from odoo import fields, models
class ResPartner(models.Model):
_inherit = "res.partner"
pos_comment = fields.Text(
string="Cashier Comment",
help="Comment that will be visible and editable in the"
" Point of Sale for the cashiers",
)

View file

@ -0,0 +1,2 @@
* Sylvain LE GAL (https://twitter.com/legalsylvain)
* Juan Carlos Bonilla <juancarlos.bonilla@factorlibre.com>

View file

@ -0,0 +1,3 @@
The development of this module has been financially supported by:
* UGESS, Union Nationale des Groupements des épiceries Sociales et Solidaires (https://ugess.org/)

View file

@ -0,0 +1,2 @@
This module extends the functionality of point of sale module, to allow display and edit
customer note field in the point of sale UI for the cashier.

View file

@ -0,0 +1,3 @@
For the time being, there is no HTML widget available in the point of sale.
For that reason, the Cashier comment (``pos_comment``) is a simple Text field.
If a widget is available in odoo, it could be great to switch to a HTML field text.

View file

@ -0,0 +1,14 @@
* Go to your partner view and write or edit new PoS comments
.. figure:: ../static/description/res_partner_form.png
* Then Open your Point of sale
in the customer tree view, a new icon is available to mention that the customer
has a PoS Comment to read:
.. figure:: ../static/description/pos_customer_tree.png
It is possible to see or edit the comment in the customer form view:
.. figure:: ../static/description/pos_customer_form.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.2 KiB

View file

@ -0,0 +1,464 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils: https://docutils.sourceforge.io/" />
<title>Point of Sale - Cashier Comment</title>
<style type="text/css">
/*
:Author: David Goodger (goodger@python.org)
:Id: $Id: html4css1.css 9511 2024-01-13 09:50:07Z milde $
:Copyright: This stylesheet has been placed in the public domain.
Default cascading style sheet for the HTML output of Docutils.
Despite the name, some widely supported CSS2 features are used.
See https://docutils.sourceforge.io/docs/howto/html-stylesheets.html for how to
customize this style sheet.
*/
/* used to remove borders from tables and images */
.borderless, table.borderless td, table.borderless th {
border: 0 }
table.borderless td, table.borderless th {
/* Override padding for "table.docutils td" with "! important".
The right padding separates the table cells. */
padding: 0 0.5em 0 0 ! important }
.first {
/* Override more specific margin styles with "! important". */
margin-top: 0 ! important }
.last, .with-subtitle {
margin-bottom: 0 ! important }
.hidden {
display: none }
.subscript {
vertical-align: sub;
font-size: smaller }
.superscript {
vertical-align: super;
font-size: smaller }
a.toc-backref {
text-decoration: none ;
color: black }
blockquote.epigraph {
margin: 2em 5em ; }
dl.docutils dd {
margin-bottom: 0.5em }
object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
overflow: hidden;
}
/* Uncomment (and remove this text!) to get bold-faced definition list terms
dl.docutils dt {
font-weight: bold }
*/
div.abstract {
margin: 2em 5em }
div.abstract p.topic-title {
font-weight: bold ;
text-align: center }
div.admonition, div.attention, div.caution, div.danger, div.error,
div.hint, div.important, div.note, div.tip, div.warning {
margin: 2em ;
border: medium outset ;
padding: 1em }
div.admonition p.admonition-title, div.hint p.admonition-title,
div.important p.admonition-title, div.note p.admonition-title,
div.tip p.admonition-title {
font-weight: bold ;
font-family: sans-serif }
div.attention p.admonition-title, div.caution p.admonition-title,
div.danger p.admonition-title, div.error p.admonition-title,
div.warning p.admonition-title, .code .error {
color: red ;
font-weight: bold ;
font-family: sans-serif }
/* Uncomment (and remove this text!) to get reduced vertical space in
compound paragraphs.
div.compound .compound-first, div.compound .compound-middle {
margin-bottom: 0.5em }
div.compound .compound-last, div.compound .compound-middle {
margin-top: 0.5em }
*/
div.dedication {
margin: 2em 5em ;
text-align: center ;
font-style: italic }
div.dedication p.topic-title {
font-weight: bold ;
font-style: normal }
div.figure {
margin-left: 2em ;
margin-right: 2em }
div.footer, div.header {
clear: both;
font-size: smaller }
div.line-block {
display: block ;
margin-top: 1em ;
margin-bottom: 1em }
div.line-block div.line-block {
margin-top: 0 ;
margin-bottom: 0 ;
margin-left: 1.5em }
div.sidebar {
margin: 0 0 0.5em 1em ;
border: medium outset ;
padding: 1em ;
background-color: #ffffee ;
width: 40% ;
float: right ;
clear: right }
div.sidebar p.rubric {
font-family: sans-serif ;
font-size: medium }
div.system-messages {
margin: 5em }
div.system-messages h1 {
color: red }
div.system-message {
border: medium outset ;
padding: 1em }
div.system-message p.system-message-title {
color: red ;
font-weight: bold }
div.topic {
margin: 2em }
h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
margin-top: 0.4em }
h1.title {
text-align: center }
h2.subtitle {
text-align: center }
hr.docutils {
width: 75% }
img.align-left, .figure.align-left, object.align-left, table.align-left {
clear: left ;
float: left ;
margin-right: 1em }
img.align-right, .figure.align-right, object.align-right, table.align-right {
clear: right ;
float: right ;
margin-left: 1em }
img.align-center, .figure.align-center, object.align-center {
display: block;
margin-left: auto;
margin-right: auto;
}
table.align-center {
margin-left: auto;
margin-right: auto;
}
.align-left {
text-align: left }
.align-center {
clear: both ;
text-align: center }
.align-right {
text-align: right }
/* reset inner alignment in figures */
div.align-right {
text-align: inherit }
/* div.align-center * { */
/* text-align: left } */
.align-top {
vertical-align: top }
.align-middle {
vertical-align: middle }
.align-bottom {
vertical-align: bottom }
ol.simple, ul.simple {
margin-bottom: 1em }
ol.arabic {
list-style: decimal }
ol.loweralpha {
list-style: lower-alpha }
ol.upperalpha {
list-style: upper-alpha }
ol.lowerroman {
list-style: lower-roman }
ol.upperroman {
list-style: upper-roman }
p.attribution {
text-align: right ;
margin-left: 50% }
p.caption {
font-style: italic }
p.credits {
font-style: italic ;
font-size: smaller }
p.label {
white-space: nowrap }
p.rubric {
font-weight: bold ;
font-size: larger ;
color: maroon ;
text-align: center }
p.sidebar-title {
font-family: sans-serif ;
font-weight: bold ;
font-size: larger }
p.sidebar-subtitle {
font-family: sans-serif ;
font-weight: bold }
p.topic-title {
font-weight: bold }
pre.address {
margin-bottom: 0 ;
margin-top: 0 ;
font: inherit }
pre.literal-block, pre.doctest-block, pre.math, pre.code {
margin-left: 2em ;
margin-right: 2em }
pre.code .ln { color: gray; } /* line numbers */
pre.code, code { background-color: #eeeeee }
pre.code .comment, code .comment { color: #5C6576 }
pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
pre.code .literal.string, code .literal.string { color: #0C5404 }
pre.code .name.builtin, code .name.builtin { color: #352B84 }
pre.code .deleted, code .deleted { background-color: #DEB0A1}
pre.code .inserted, code .inserted { background-color: #A3D289}
span.classifier {
font-family: sans-serif ;
font-style: oblique }
span.classifier-delimiter {
font-family: sans-serif ;
font-weight: bold }
span.interpreted {
font-family: sans-serif }
span.option {
white-space: nowrap }
span.pre {
white-space: pre }
span.problematic, pre.problematic {
color: red }
span.section-subtitle {
/* font-size relative to parent (h1..h6 element) */
font-size: 80% }
table.citation {
border-left: solid 1px gray;
margin-left: 1px }
table.docinfo {
margin: 2em 4em }
table.docutils {
margin-top: 0.5em ;
margin-bottom: 0.5em }
table.footnote {
border-left: solid 1px black;
margin-left: 1px }
table.docutils td, table.docutils th,
table.docinfo td, table.docinfo th {
padding-left: 0.5em ;
padding-right: 0.5em ;
vertical-align: top }
table.docutils th.field-name, table.docinfo th.docinfo-name {
font-weight: bold ;
text-align: left ;
white-space: nowrap ;
padding-left: 0 }
/* "booktabs" style (no vertical lines) */
table.docutils.booktabs {
border: 0px;
border-top: 2px solid;
border-bottom: 2px solid;
border-collapse: collapse;
}
table.docutils.booktabs * {
border: 0px;
}
table.docutils.booktabs th {
border-bottom: thin solid;
text-align: left;
}
h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
font-size: 100% }
ul.auto-toc {
list-style-type: none }
</style>
</head>
<body>
<div class="document" id="point-of-sale-cashier-comment">
<h1 class="title">Point of Sale - Cashier Comment</h1>
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:4fdce9773e5d7b56fcdad47f1d9d5e8beb3fd5dc302b49c4540dbc3292eba623
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/pos/tree/16.0/pos_customer_comment"><img alt="OCA/pos" src="https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/pos-16-0/pos-16-0-pos_customer_comment"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external image-reference" href="https://runboat.odoo-community.org/builds?repo=OCA/pos&amp;target_branch=16.0"><img alt="Try me on Runboat" src="https://img.shields.io/badge/runboat-Try%20me-875A7B.png" /></a></p>
<p>This module extends the functionality of point of sale module, to allow display and edit
customer note field in the point of sale UI for the cashier.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#usage" id="toc-entry-1">Usage</a></li>
<li><a class="reference internal" href="#known-issues-roadmap" id="toc-entry-2">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="toc-entry-3">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="toc-entry-4">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="toc-entry-5">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="toc-entry-6">Contributors</a></li>
<li><a class="reference internal" href="#other-credits" id="toc-entry-7">Other credits</a></li>
<li><a class="reference internal" href="#maintainers" id="toc-entry-8">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<div class="section" id="usage">
<h1><a class="toc-backref" href="#toc-entry-1">Usage</a></h1>
<ul class="simple">
<li>Go to your partner view and write or edit new PoS comments</li>
</ul>
<div class="figure">
<img alt="https://raw.githubusercontent.com/OCA/pos/16.0/pos_customer_comment/static/description/res_partner_form.png" src="https://raw.githubusercontent.com/OCA/pos/16.0/pos_customer_comment/static/description/res_partner_form.png" />
</div>
<ul class="simple">
<li>Then Open your Point of sale</li>
</ul>
<p>in the customer tree view, a new icon is available to mention that the customer
has a PoS Comment to read:</p>
<div class="figure">
<img alt="https://raw.githubusercontent.com/OCA/pos/16.0/pos_customer_comment/static/description/pos_customer_tree.png" src="https://raw.githubusercontent.com/OCA/pos/16.0/pos_customer_comment/static/description/pos_customer_tree.png" />
</div>
<p>It is possible to see or edit the comment in the customer form view:</p>
<div class="figure">
<img alt="https://raw.githubusercontent.com/OCA/pos/16.0/pos_customer_comment/static/description/pos_customer_form.png" src="https://raw.githubusercontent.com/OCA/pos/16.0/pos_customer_comment/static/description/pos_customer_form.png" />
</div>
</div>
<div class="section" id="known-issues-roadmap">
<h1><a class="toc-backref" href="#toc-entry-2">Known issues / Roadmap</a></h1>
<p>For the time being, there is no HTML widget available in the point of sale.
For that reason, the Cashier comment (<tt class="docutils literal">pos_comment</tt>) is a simple Text field.
If a widget is available in odoo, it could be great to switch to a HTML field text.</p>
</div>
<div class="section" id="bug-tracker">
<h1><a class="toc-backref" href="#toc-entry-3">Bug Tracker</a></h1>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/pos/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/pos/issues/new?body=module:%20pos_customer_comment%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
</div>
<div class="section" id="credits">
<h1><a class="toc-backref" href="#toc-entry-4">Credits</a></h1>
<div class="section" id="authors">
<h2><a class="toc-backref" href="#toc-entry-5">Authors</a></h2>
<ul class="simple">
<li>GRAP</li>
</ul>
</div>
<div class="section" id="contributors">
<h2><a class="toc-backref" href="#toc-entry-6">Contributors</a></h2>
<ul class="simple">
<li>Sylvain LE GAL (<a class="reference external" href="https://twitter.com/legalsylvain">https://twitter.com/legalsylvain</a>)</li>
<li>Juan Carlos Bonilla &lt;<a class="reference external" href="mailto:juancarlos.bonilla&#64;factorlibre.com">juancarlos.bonilla&#64;factorlibre.com</a>&gt;</li>
</ul>
</div>
<div class="section" id="other-credits">
<h2><a class="toc-backref" href="#toc-entry-7">Other credits</a></h2>
<p>The development of this module has been financially supported by:</p>
<ul class="simple">
<li>UGESS, Union Nationale des Groupements des épiceries Sociales et Solidaires (<a class="reference external" href="https://ugess.org/">https://ugess.org/</a>)</li>
</ul>
</div>
<div class="section" id="maintainers">
<h2><a class="toc-backref" href="#toc-entry-8">Maintainers</a></h2>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org">
<img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" />
</a>
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.</p>
<p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p>
<p><a class="reference external image-reference" href="https://github.com/legalsylvain"><img alt="legalsylvain" src="https://github.com/legalsylvain.png?size=40px" /></a></p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/pos/tree/16.0/pos_customer_comment">OCA/pos</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>
</div>
</div>
</div>
</body>
</html>

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

View file

@ -0,0 +1,22 @@
/*
Copyright (C) 2022-Today GRAP (http://www.grap.coop)
@author Sylvain LE GAL (https://twitter.com/legalsylvain)
License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
*/
.pos .partnerlist-screen .partner-details textarea {
padding: 4px;
border-radius: 3px;
border: solid 1px #cecbcb;
margin-bottom: 4px;
background: white;
font-family: "Lato", "Lucida Grande", Helvetica, Verdana, Arial;
color: #555555;
width: 340px;
font-size: 14px;
box-sizing: border-box;
}
.pos .partnerlist-screen .partner-details span.label {
vertical-align: top;
}

View file

@ -0,0 +1,16 @@
/** @odoo-module **/
import PartnerDetailsEdit from "point_of_sale.PartnerDetailsEdit";
import Registries from "point_of_sale.Registries";
const PartnerDetailsEditComment = (OriginalPartnerDetailsEdit) =>
class extends OriginalPartnerDetailsEdit {
setup() {
super.setup();
this.changes = {
...this.changes,
pos_comment: this.props.partner.pos_comment || "",
};
}
};
Registries.Component.extend(PartnerDetailsEdit, PartnerDetailsEditComment);

View file

@ -0,0 +1,30 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!--
Copyright (C) 2022-Today GRAP (http://www.grap.coop)
@author Sylvain LE GAL (https://twitter.com/legalsylvain)
License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
-->
<templates id="template" xml:space="preserve">
<t
t-name="PartnerDetailsEdit"
t-inherit="point_of_sale.PartnerDetailsEdit"
t-inherit-mode="extension"
owl="1"
>
<xpath expr="//select[@name='country_id']/.." position="after">
<div class="partner-detail partner-detail-pos-comment">
<span class="label">Comment</span>
<textarea
class="detail"
name="pos_comment"
style="height: 100px;"
t-model="changes.pos_comment"
t-on-change="captureChange"
placeholder="Comment"
/>
</div>
</xpath>
</t>
</templates>

View file

@ -0,0 +1,27 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!--
Copyright (C) 2022-Today GRAP (http://www.grap.coop)
@author Sylvain LE GAL (https://twitter.com/legalsylvain)
License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
-->
<templates id="template" xml:space="preserve">
<t
t-name="PartnerLine"
t-inherit="point_of_sale.PartnerLine"
t-inherit-mode="extension"
owl="1"
>
<xpath expr="//button[hasclass('edit-partner-button')]" position="after">
<div t-if="props.partner.pos_comment != ''">
<i
class="fa fa-comment"
role="img"
aria-label="Has PoS Comment"
title="Has PoS Comment"
/>
</div>
</xpath>
</t>
</templates>

View file

@ -0,0 +1 @@
from . import test_module

View file

@ -0,0 +1,23 @@
# Copyright (C) 2022-Today GRAP (http://www.grap.coop)
# @author Sylvain LE GAL (https://twitter.com/legalsylvain)
# License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
from odoo.tests import tagged
from odoo.addons.point_of_sale.tests.test_frontend import TestPointOfSaleHttpCommon
@tagged("post_install", "-at_install")
class TestUi(TestPointOfSaleHttpCommon):
def test_pos_customer_comment(self):
self.main_pos_config.open_ui()
self.main_pos_config.current_session_id.set_cashbox_pos(0, None)
self.start_tour(
f"/pos/ui?config_id={self.main_pos_config.id}",
"PosCustomerCommentTour",
login="accountman",
)
customer = self.env.ref("base.res_partner_address_31")
self.assertEqual(customer.pos_comment, "New Comment")

View file

@ -0,0 +1,56 @@
/*
Copyright (C) 2022-Today GRAP (http://www.grap.coop)
@author Sylvain LE GAL (https://twitter.com/legalsylvain)
License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
*/
odoo.define("pos_customer_comment.tour.PosCustomerComment", function (require) {
"use strict";
const Tour = require("web_tour.tour");
var steps = [
{
content: "Test pos_customer_content: Waiting for loading to finish",
trigger: "body:not(:has(.loader))",
},
{
content: "Test pos_customer_content: open customer list",
trigger: "button.set-partner",
},
{
content: "Test pos_customer_content: select 'Addison Olson' Customer",
trigger: ".partner-line:contains('Addison Olson') .edit-partner-button",
},
{
content: "Test pos_customer_content: Check if value is correctly loaded",
trigger: "textarea[name='pos_comment']",
run: () => {
var content = $("textarea[name='pos_comment']");
if (!content.val().includes("Important")) {
throw new Error("the PoS comment was not loaded in the frontend");
}
},
},
{
content: "Test pos_customer_content: Write new text in PoS Comment field",
trigger: "textarea[name='pos_comment']",
run: "text New Comment",
},
{
content: "Test pos_customer_content: Save Customer changes",
trigger: ".partnerlist-screen .button.highlight",
},
{
content: "Test pos_customer_content: Close the Point of Sale frontend",
trigger: ".header-button",
},
{
content: "Test pos_customer_content: Confirm closing the frontend",
trigger: ".header-button",
},
];
Tour.register("PosCustomerCommentTour", {test: true, url: "/pos/ui"}, steps);
});
/* */

View file

@ -0,0 +1,22 @@
<?xml version="1.0" encoding="utf-8" ?>
<!--
Copyright (C) 2022-Today GRAP (http://www.grap.coop)
@author Sylvain LE GAL (https://twitter.com/legalsylvain)
License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
-->
<odoo>
<record id="view_res_partner_form" model="ir.ui.view">
<field name="model">res.partner</field>
<field name="inherit_id" ref="base.view_partner_form" />
<field name="arch" type="xml">
<xpath expr="//notebook" position="inside">
<page name="page_pos_comment" string="Cashier Comment">
<field
name="pos_comment"
placeholder="Comment that will be visible and editable in the Point of Sale for the cashiers"
/>
</page>
</xpath>
</field>
</record>
</odoo>

View file

@ -0,0 +1,42 @@
[project]
name = "odoo-bringout-oca-pos-pos_customer_comment"
version = "16.0.0"
description = "Point of Sale - Cashier Comment - Display Customer comment in the PoS front office and allow to edit and save it by the cashier"
authors = [
{ name = "Ernad Husremovic", email = "hernad@bring.out.ba" }
]
dependencies = [
"odoo-bringout-oca-ocb-point_of_sale>=16.0.0",
"requests>=2.25.1"
]
readme = "README.md"
requires-python = ">= 3.11"
classifiers = [
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Topic :: Office/Business",
]
[project.urls]
homepage = "https://github.com/bringout/0"
repository = "https://github.com/bringout/0"
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[tool.hatch.metadata]
allow-direct-references = true
[tool.hatch.build.targets.wheel]
packages = ["pos_customer_comment"]
[tool.rye]
managed = true
dev-dependencies = [
"pytest>=8.4.1",
]