[ADD][18.0] base_iso7010_data_mandatory

base_iso7010_data_mandatory/README.rst

@@ -0,0 +1,188 @@
+======================================
+Base ISO 7010 Symbols - Mandatory Data
+======================================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:1a34bd72abdeb61af023489d7ec5f6508f03ad2f07a4a4228dda35ca61a7d135
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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-OCA%2Fcommunity--data--files-lightgray.png?logo=github
+    :target: https://github.com/OCA/community-data-files/tree/18.0/base_iso7010_data_mandatory
+    :alt: OCA/community-data-files
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/community-data-files-18-0/community-data-files-18-0-base_iso7010_data_mandatory
+    :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/community-data-files&target_branch=18.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Base ISO 7010 Symbols - Mandatory Data
+======================================
+
+This module loads data records and corresponding SVG images for the
+**Mandatory Action** category (blue circle signs) of the ISO 7010
+standard into the ``iso7010.symbol`` model (provided by the
+``base_iso7010`` module).
+
+Overview
+--------
+
+This module populates the database with standard Mandatory Action safety
+symbols.
+
+Included Symbols (Examples):
+
+-  M001: General mandatory action
+-  M002: Refer to instruction manual/booklet
+-  M003: Wear hearing protection
+-  M004: Wear eye protection
+-  ... (includes a comprehensive set based on common availability and
+   CC0 license)
+
+Symbol Source & License:
+
+-  The symbol data (names, codes) are based on the ISO 7010 standard.
+-  The SVG image files expected in ``static/img/symbols/`` are typically
+   sourced from Wikimedia Commons
+   (`Category:ISO_7010_mandatory_action_signs <https://commons.wikimedia.org/wiki/Category:ISO_7010_mandatory_action_signs>`__)
+   and are assumed to be under the **CC0 (Public Domain Dedication)**
+   license. Please verify the license for each file if necessary.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Use Cases / Context
+===================
+
+While the ``base_iso7010`` module provides the structure to manage
+safety symbols, it doesn't contain any actual symbols by default. A
+common business need is to have the standard set of ISO 7010 "Mandatory
+Action" symbols (the blue circle signs indicating required actions,
+often related to PPE) readily available within Odoo without requiring
+manual data entry for each one. These are frequently used symbols for
+indicating requirements like wearing gloves, eye protection, hearing
+protection, safety footwear, etc.
+
+This module fulfills the need for readily available, standard mandatory
+symbols for selection and use in various Odoo processes.
+
+*Example Use Case:* After installing ``base_iso7010``, a user wants to
+link the "Wear Protective Gloves" symbol (M009) to a specific Work
+Center using the ``mrp_workcenter_safety_symbol`` module. Installing
+``base_iso7010_data_mandatory`` makes the M009 record available for
+selection.
+
+Installation
+============
+
+To install this module, you need to:
+
+1. Ensure the base module ``base_iso7010`` is installed.
+2. Add this repository to your Odoo addons path.
+3. **Crucially:** Download the required SVG files (e.g.,
+   ``ISO_7010_M001.svg``, etc.) ensuring they are CC0 licensed, and
+   place them into the
+   ``base_iso7010_data_mandatory/static/img/symbols/`` directory within
+   this module. The installation will fail if the files referenced in
+   the data XML are missing.
+4. Install the module 'Base ISO 7010 Symbols - Mandatory Data'
+   (``base_iso7010_data_mandatory``).
+
+Configuration
+=============
+
+This module requires no specific configuration after installation. The
+symbol data is loaded automatically when the module is installed.
+
+Usage
+=====
+
+Installing this module performs the following actions:
+
+1. Creates records in the ``iso7010.symbol`` model for numerous ISO 7010
+   Mandatory Action symbols (M001, M002, etc.).
+2. Loads the corresponding SVG image data (from the files you placed in
+   ``static/img/symbols/``) into the ``image`` field of these records
+   using Odoo's ``file=`` attribute mechanism during installation.
+
+Accessing the Loaded Symbols:
+
+-  **As Administrator:** Navigate to Settings > Technical > ISO
+   Standards > ISO 7010 Symbols. You will now see the loaded mandatory
+   symbols populated in the list view.
+-  **In Other Modules:** These symbol records are now available for
+   selection in any module that uses a Many2one or Many2many field
+   linking to ``iso7010.symbol`` (e.g.,
+   ``mrp_workcenter_safety_symbol``).
+
+There are no other direct user actions associated with this data-loading
+module.
+
+Known issues / Roadmap
+======================
+
+
+
+Changelog
+=========
+
+
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/community-data-files/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/community-data-files/issues/new?body=module:%20base_iso7010_data_mandatory%0Aversion:%2018.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
+-------
+
+* bosd
+
+Contributors
+------------
+
+-  bosd
+
+Other credits
+-------------
+
+
+
+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.
+
+This module is part of the `OCA/community-data-files <https://github.com/OCA/community-data-files/tree/18.0/base_iso7010_data_mandatory>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

base_iso7010_data_mandatory/__manifest__.py

@@ -0,0 +1,21 @@
+{
+    "name": "Base ISO 7010 Symbols - Mandatory Data",
+    "version": "18.0.1.0.0",
+    "summary": """
+        This module depends on 'base_iso7010' and loads the data records
+        and SVG images for the 'Mandatory Action' category of ISO 7010 symbols.
+    """,
+    "author": "bosd, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/community-data-files",
+    "category": "Extra Tools",
+    "license": "LGPL-3",
+    "depends": [
+        "base_iso7010",
+    ],
+    "data": [
+        "data/iso7010_mandatory_symbol_data.xml",
+    ],
+    "installable": True,
+    "application": False,
+    "auto_install": False,
+}