17.0 mig pos esign request

.eslintrc.yml

@@ -8,6 +8,8 @@ parserOptions:
 
 overrides:
   - files:
+      - "**/app/**/*.js"
+      - "**/overrides/**/*.js"
       - "**/*.esm.js"
     parserOptions:
       sourceType: module

pos_esign_request/README.rst

@@ -0,0 +1,111 @@
+==================
+POS E-Sign Request
+==================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:c6d26a36e39022c69278b6527be417b36f959e55405bb515b89f706bcfff2f38
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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-LGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
+    :alt: License: LGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-it--projects--llc%2Fpos--addons-lightgray.png?logo=github
+    :target: https://github.com/it-projects-llc/pos-addons/tree/17.0/pos_esign_request
+    :alt: it-projects-llc/pos-addons
+
+|badge1| |badge2| |badge3|
+
+Asks Customer For E-Sign
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+To create a multi-session follow the steps:
+
+-  Open menu ``[[ Point of Sale ]] >> Configuration >> Point of Sale``
+-  Select a POS
+-  Click ``[Edit]``
+-  Activate **Ask To Sign** field
+-  Set **Terms & Conditions**
+-  If **E-Sign** is required for each purchase then activate **Mandatory
+   Ask To Sign** field
+-  Click ``[Save]``
+
+Usage
+=====
+
+You need two devices: one for POS, another one for taking signs
+
+-  Open a POS on a first device
+
+-  Open E-Sign Kiosk on the second device
+
+   -  Open menu ``[[ Point of Sale ]] >> Dashboard``
+   -  Click three dots on the same POS as opened on the first device
+   -  Click ``E-Sign``
+
+-  On the first device click ``Customer`` button
+
+-  Select a Customer
+
+-  Click ``E-Sign`` button
+
+-  On the second device the form for signing appears
+
+-  Let the customer to draw a sign
+
+-  Click ``Submit Sign``
+
+-  On the first device for the customer in the **E-Sign** column ✔ sign
+   appears
+
+Known issues / Roadmap
+======================
+
+Current implementation technically depends on ``pos_self_order`` module.
+Meanwhile no functional feature are used, only technical feature of self
+order screen.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/it-projects-llc/pos-addons/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/it-projects-llc/pos-addons/issues/new?body=module:%20pos_esign_request%0Aversion:%2017.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
+-------
+
+* IT-Projects LLC
+
+Contributors
+------------
+
+-  Alexandr Kolusov (https://github.com/KolushovAlexandr)
+-  Victor Bykov (https://github.com/BykovVik)
+-  Eugene Molotov (https://github.com/em230418)
+
+Maintainers
+-----------
+
+This module is part of the `it-projects-llc/pos-addons <https://github.com/it-projects-llc/pos-addons/tree/17.0/pos_esign_request>`_ project on GitHub.
+
+You are welcome to contribute.

pos_esign_request/__init__.py

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

pos_esign_request/__manifest__.py

@@ -0,0 +1,33 @@
+{
+    "name": """POS E-Sign Request""",
+    "summary": """Asks Customer For E-Sign""",
+    "category": "Point of Sale",
+    "images": [],
+    "version": "17.0.1.0.0",
+    "application": False,
+    "author": "IT-Projects LLC",
+    "support": "apps@it-projects.info",
+    "website": "https://github.com/it-projects-llc/pos-addons",
+    "license": "LGPL-3",
+    "depends": [
+        "pos_self_order",
+    ],
+    "assets": {
+        "pos_self_order.assets": [
+            "pos_esign_request/static/src/app/**/*",
+            "web/static/lib/jquery/jquery.js",
+            "web/static/src/core/signature/name_and_signature.scss",
+            "web/static/src/core/signature/name_and_signature.xml",
+            "web/static/src/core/signature/name_and_signature.js",
+        ],
+        "point_of_sale._assets_pos": [
+            "pos_esign_request/static/src/overrides/**/*",
+        ],
+    },
+    "data": [
+        "views/partner_views.xml",
+        "views/pos_config_views.xml",
+        "views/res_config_settings_views.xml",
+    ],
+    "demo": [],
+}

pos_esign_request/controllers/__init__.py

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

pos_esign_request/controllers/main.py

@@ -0,0 +1,63 @@
+from werkzeug.exceptions import Unauthorized
+
+from odoo import http
+from odoo.http import request, route
+
+
+class PosESignExtension(http.Controller):
+    def _verify_pos_config(self, access_token):
+        pos_config_sudo = (
+            request.env["pos.config"]
+            .sudo()
+            .search([("access_token", "=", access_token)], limit=1)
+        )
+        if not pos_config_sudo or not pos_config_sudo.has_active_session:
+            raise Unauthorized("Invalid access token")
+        return pos_config_sudo
+
+    @route("/pos_esign_request/sign_response", type="json", auth="public")
+    def submit_kiosk_sign(self, access_token, vals):
+        config = self._verify_pos_config(access_token)
+        res = self.update_partner_sign(vals)
+
+        if res and config.current_session_id:
+            session = config.current_session_id
+            request.env["bus.bus"]._sendone(
+                session._get_bus_channel_name(), "ESIGN_RESPONSE", res
+            )
+
+        return True
+
+    def update_partner_sign(self, vals):
+        partner_id = vals.get("partner_id", False)
+        sign = vals.get("sign", False)
+        if not (partner_id and sign):
+            return False
+
+        Partners = request.env["res.partner"].sudo()
+        partner_id = Partners.browse(int(partner_id))
+
+        Attachments = request.env["ir.attachment"].sudo()
+        attachment = Attachments.create(
+            {
+                "type": "binary",
+                "name": partner_id.name + "E-Sign",
+                "datas": sign,
+                "res_id": partner_id.id,
+                "res_model": "res.partner",
+            }
+        )
+
+        partner_id.write(
+            {
+                "sign_attachment_id": attachment.id,
+            }
+        )
+
+        return {
+            "partner_id": partner_id.id,
+            "attachment_id": [
+                partner_id.sign_attachment_id.id,
+                partner_id.sign_attachment_id.name,
+            ],
+        }

pos_esign_request/models/__init__.py

@@ -0,0 +1,4 @@
+from . import pos_config
+from . import pos_session
+from . import res_config_settings
+from . import res_partner

pos_esign_request/models/pos_config.py

@@ -0,0 +1,45 @@
+from odoo import api, fields, models
+
+
+class PosConfig(models.Model):
+    _inherit = "pos.config"
+
+    ask_for_sign = fields.Boolean(string="Ask To Sign", default=False)
+    mandatory_ask_for_sign = fields.Boolean(
+        string="Mandatory Ask To Sign", default=False
+    )
+    terms_to_sign = fields.Char(string="Terms & Conditions (ESign)")
+
+    def _get_esign_route(self):
+        self.ensure_one()
+        base_route = f"/pos-self/{self.id}/esign_kiosk"
+        return f"{base_route}?access_token={self.access_token}"
+
+    def preview_esign_app(self):
+        self.ensure_one()
+        return {
+            "type": "ir.actions.act_url",
+            "url": self._get_esign_route(),
+            "target": "new",
+        }
+
+    @api.depends("ask_for_sign")
+    @api.onchange("ask_for_sign")
+    def _onchange_ask_for_sign(self):
+        if not self.ask_for_sign:
+            self.mandatory_ask_for_sign = False
+
+    def sign_request(self, **kw):
+        for config in self:
+            if config.current_session_id and config.access_token:
+                self.env["bus.bus"]._sendone(
+                    f"pos_config-{config.access_token}", "ESIGN_REQUEST", kw
+                )
+
+    def _get_self_ordering_data(self):
+        res = super()._get_self_ordering_data()
+        res["config"].update(
+            name=self.name,
+            terms_to_sign=self.terms_to_sign,
+        )
+        return res

pos_esign_request/models/pos_session.py

@@ -0,0 +1,10 @@
+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("sign_attachment_id")
+        return res

pos_esign_request/models/res_config_settings.py

@@ -0,0 +1,22 @@
+from odoo import api, fields, models
+
+
+class ResConfigSettings(models.TransientModel):
+    _inherit = "res.config.settings"
+
+    pos_ask_for_sign = fields.Boolean(
+        related="pos_config_id.ask_for_sign", readonly=False
+    )
+    pos_mandatory_ask_for_sign = fields.Boolean(
+        related="pos_config_id.mandatory_ask_for_sign", readonly=False
+    )
+    pos_terms_to_sign = fields.Char(
+        related="pos_config_id.terms_to_sign", readonly=False
+    )
+
+    @api.onchange("pos_ask_for_sign", "pos_self_ordering_mode")
+    def _onchange_ask_for_sign(self):
+        if self.pos_ask_for_sign:
+            self.pos_self_ordering_mode = "mobile"
+        else:
+            self.pos_mandatory_ask_for_sign = False

pos_esign_request/models/res_partner.py

@@ -0,0 +1,7 @@
+from odoo import fields, models
+
+
+class Partner(models.Model):
+    _inherit = "res.partner"
+
+    sign_attachment_id = fields.Many2one("ir.attachment", "E-Sign")

pos_esign_request/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["whool"]
+build-backend = "whool.buildapi"

pos_esign_request/readme/CONFIGURE.md

@@ -0,0 +1,9 @@
+To create a multi-session follow the steps:
+
+* Open menu `[[ Point of Sale ]] >> Configuration >> Point of Sale`
+* Select a POS
+* Click `[Edit]`
+* Activate **Ask To Sign** field
+* Set **Terms & Conditions**
+* If **E-Sign** is required for each purchase then activate **Mandatory Ask To Sign** field
+* Click `[Save]`

pos_esign_request/readme/CONTRIBUTORS.md

@@ -0,0 +1,3 @@
+- Alexandr Kolusov (https://github.com/KolushovAlexandr)
+- Victor Bykov (https://github.com/BykovVik)
+- Eugene Molotov (https://github.com/em230418)

pos_esign_request/readme/DESCRIPTION.md

@@ -0,0 +1 @@
+Asks Customer For E-Sign

pos_esign_request/readme/ROADMAP.md

@@ -0,0 +1,2 @@
+Current implementation technically depends on `pos_self_order` module.
+Meanwhile no functional feature are used, only technical feature of self order screen.

pos_esign_request/readme/USAGE.md

@@ -0,0 +1,18 @@
+You need two devices: one for POS, another one for taking signs
+
+* Open a POS on a first device
+* Open E-Sign Kiosk on the second device
+
+    * Open menu `[[ Point of Sale ]] >> Dashboard`
+    * Click three dots on the same POS as opened on the first device
+    * Click `E-Sign`
+
+* On the first device click `Customer` button
+* Select a Customer
+* Click `E-Sign` button
+
+* On the second device the form for signing appears
+* Let the customer to draw a sign
+* Click `Submit Sign`
+
+* On the first device for the customer in the **E-Sign** column ✔ sign appears