[ADD][18.0] base_iso7010

base_iso7010/README.rst

@@ -0,0 +1,191 @@
+===============================
+Base ISO 7010 Symbols Structure
+===============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:cb8eb8886d248b317c4c5bcac3835d77dd51b3da6597d74e1734455d5635e1a6
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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
+    :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
+    :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|
+
+This module provides the core data structure, views, security, and menus
+for managing ISO 7010 graphical symbols for safety signs within Odoo.
+
+**Important:** This module only provides the *structure*. It does
+**not** contain any actual symbol data records or image files. To load
+symbols, you must install separate data modules, such as
+``base_iso7010_data_mandatory``, ``base_iso7010_data_warning``, etc.
+
+This module serves as a base dependency for other modules that need to
+load or reference standard ISO 7010 symbols.
+
+Key Features
+------------
+
+-  Defines the ``iso7010.symbol`` model with fields for ISO code, name,
+   description, category (mandatory, warning, etc.), and image.
+-  Provides basic views (list, form, search) for managing these symbols.
+-  Adds a menu item under Settings > Technical > ISO Standards > ISO
+   7010 Symbols (visible to Administrators).
+-  Includes necessary access control rules.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Use Cases / Context
+===================
+
+In many industries, particularly manufacturing, logistics, and
+healthcare, clear and standardized visual communication of safety
+information is crucial for accident prevention and regulatory
+compliance. Using internationally recognized symbols, like those defined
+in the ISO 7010 standard, ensures immediate and universal understanding
+of hazards, prohibitions, and required actions (like wearing specific
+Personal Protective Equipment - PPE).
+
+The business requirement is to have a centralized, consistent, and
+easily accessible library of these standard safety symbols within the
+Odoo environment. This avoids redundant definitions across different
+applications (MRP, Inventory, Maintenance, Field Service) and ensures
+that the correct, standardized symbol is used whenever safety
+information needs to be displayed or referenced (e.g., on work
+instructions, product labels, workstation signage, reports).
+
+*Example Use Case:* A company wants to display the mandatory "Wear Eye
+Protection" symbol (M004) on work orders for specific machines and also
+on handling instructions for certain materials in the warehouse. This
+module provides the foundation to manage the M004 symbol record
+centrally.
+
+Installation
+============
+
+To install this module, you need to:
+
+1. Add this repository to your Odoo addons path.
+2. Install the module 'Base ISO 7010 Symbols Structure'
+   (``base_iso7010``).
+
+Configuration
+=============
+
+This module requires no specific configuration steps after installation.
+
+To access the symbols management area (requires data modules to be
+installed to see data):
+
+1. Ensure you are logged in as an Administrator.
+2. Navigate to Settings > Technical > ISO Standards > ISO 7010 Symbols.
+
+Note: Without installing data modules, the list view in this menu will
+be empty.
+
+Usage
+=====
+
+This module primarily provides the backend structure and is intended as
+a dependency for data-loading or integration modules.
+
+**Viewing Symbol Structure (Administrator):**
+
+1. Log in as an Administrator.
+2. Navigate to Settings > Technical > ISO Standards > ISO 7010 Symbols.
+3. You will see the list view defined for symbols. This list will be
+   empty until you install one or more data modules (e.g.,
+   ``base_iso7010_data_mandatory``).
+
+**Developer Usage:**
+
+-  Other modules should add ``base_iso7010`` to their dependencies.
+-  Use Many2one or Many2many fields in your custom models linking to the
+   ``iso7010.symbol`` model to reference safety symbols. Example:
+   .. code:: python
+
+      from odoo import fields, models
+
+      class MyModel(models.Model):
+          _name = 'my.model'
+
+          required_symbol_id = fields.Many2one('iso7010.symbol', string='Required Symbol')
+          applicable_symbols_ids = fields.Many2many('iso7010.symbol', string='Applicable Symbols')
+
+-  Ensure that appropriate ``base_iso7010_data_*`` modules are also
+   installed in the target database to provide the necessary symbol
+   records for selection in your custom fields.
+
+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%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>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

base_iso7010/__init__.py

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

base_iso7010/__manifest__.py

@@ -0,0 +1,26 @@
+{
+    "name": "Base ISO 7010 Symbols Structure",
+    "version": "18.0.1.0.0",
+    "summary": """
+        This module provides the core structure (model, views, security, menus)
+        for managing ISO 7010 safety symbols.
+
+        It does NOT contain any actual symbol data records. Install separate
+        'base_iso7010_data_*' modules to load symbol data for specific categories
+        (e.g., base_iso7010_data_mandatory).
+    """,
+    "author": "bosd, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/community-data-files",
+    "category": "Extra Tools",
+    "license": "LGPL-3",
+    "depends": [
+        "base",
+    ],
+    "data": [
+        "security/ir.model.access.csv",
+        "views/iso7010_symbol_views.xml",
+    ],
+    "installable": True,
+    "application": False,
+    "auto_install": False,
+}