[18.0][ADD] base_sequence_template

base_sequence_template/README.rst

@@ -0,0 +1,114 @@
+======================
+Base Sequence Template
+======================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:569cc0e4c7a9c546f6269203c966cd7cc1348847adfd34fd3b0063ce7bd070b8
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Fserver--tools-lightgray.png?logo=github
+    :target: https://github.com/OCA/server-tools/tree/18.0/base_sequence_template
+    :alt: OCA/server-tools
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/server-tools-18-0/server-tools-18-0-base_sequence_template
+    :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/server-tools&target_branch=18.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module provides a wizard to generate company-specific sequences
+from reusable sequence templates. It is designed for multi-company
+environments where each company requires its own ``ir.sequence`` records
+but shares a common configuration pattern. The wizard allows defining
+sequence templates that include dynamic placeholders referencing company
+fields.
+
+During generation, placeholders of the form ``%(company_id.<field>)s``
+are automatically replaced with the corresponding values from each
+company. Other placeholders (for example ``%(year)s``) are preserved and
+evaluated later by the standard sequence engine. The module also
+validates that all referenced company fields exist and checks that
+required company values are not empty.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Usage
+=====
+
+To use this module, follow these steps:
+
+1. Create one or more sequence templates and define the desired prefix
+   and suffix, with company placeholders if desired. You can use
+   placeholders like:
+
+   -  ``%(company_id.id)s``
+   -  ``%(company_id.name)s``
+   -  ``%(company_id.vat)s``
+
+2. Select the templates you want to use.
+3. Trigger the server action that opens the wizard to generate sequences
+   for companies.
+4. In the wizard, select the target companies.
+5. Confirm to generate the sequences.
+
+The wizard will:
+
+-  Read the required company fields used in the templates.
+-  Validate that those fields exist and are not empty.
+-  Create one ``ir.sequence`` per selected company and template with the
+   resolved values.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/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/server-tools/issues/new?body=module:%20base_sequence_template%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
+-------
+
+* ForgeFlow
+
+Contributors
+------------
+
+-  Laura Cazorla <laura.cazorla@forgeflow.com>
+
+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/server-tools <https://github.com/OCA/server-tools/tree/18.0/base_sequence_template>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

base_sequence_template/__init__.py

@@ -0,0 +1,5 @@
+# Copyright 2026 ForgeFlow S.L. (https://www.forgeflow.com)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+from . import models
+from . import wizard

base_sequence_template/__manifest__.py

@@ -0,0 +1,20 @@
+# Copyright 2026 ForgeFlow S.L. (https://www.forgeflow.com)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+{
+    "name": "Base Sequence Template",
+    "summary": "Create a sequence template that can generate sequences for companies",
+    "category": "Tools",
+    "version": "18.0.1.0.0",
+    "website": "https://github.com/OCA/server-tools",
+    "author": "ForgeFlow, Odoo Community Association (OCA)",
+    "license": "AGPL-3",
+    "depends": ["base_setup"],
+    "data": [
+        "views/ir_sequence_template_views.xml",
+        "wizard/generate_company_sequences.xml",
+        "security/ir.model.access.csv",
+    ],
+    "installable": True,
+    "auto_install": False,
+}

base_sequence_template/models/__init__.py

@@ -0,0 +1,5 @@
+# Copyright 2026 ForgeFlow S.L. (https://www.forgeflow.com)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+from . import ir_sequence
+from . import ir_sequence_template

base_sequence_template/models/ir_sequence.py

@@ -0,0 +1,10 @@
+# Copyright 2026 ForgeFlow S.L. (https://www.forgeflow.com)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+from odoo import fields, models
+
+
+class IrSequence(models.Model):
+    _inherit = "ir.sequence"
+
+    template_id = fields.Many2one("ir.sequence.template", ondelete="set null")

base_sequence_template/models/ir_sequence_template.py

@@ -0,0 +1,62 @@
+# Copyright 2026 ForgeFlow S.L. (https://www.forgeflow.com)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+from odoo import api, fields, models
+
+
+class IrSequenceTemplate(models.Model):
+    _name = "ir.sequence.template"
+    _description = "Sequence Template"
+    _order = "name"
+    _allow_sudo_commands = False
+
+    active = fields.Boolean(default=True)
+
+    name = fields.Char(required=True)
+    code = fields.Char(string="Sequence Code")
+    implementation = fields.Selection(
+        [("standard", "Standard"), ("no_gap", "No gap")],
+        required=True,
+        default="standard",
+    )
+    prefix = fields.Char(help="Prefix value of the record for the sequence", trim=False)
+    suffix = fields.Char(help="Suffix value of the record for the sequence", trim=False)
+    number_increment = fields.Integer(string="Step", required=True, default=1)
+    padding = fields.Integer(string="Sequence Size", required=True, default=0)
+
+    sequence_ids = fields.One2many("ir.sequence", "template_id")
+    sequence_count = fields.Integer(compute="_compute_sequence_count")
+
+    @api.depends("sequence_ids")
+    def _compute_sequence_count(self):
+        for record in self:
+            record.sequence_count = len(record.sequence_ids)
+
+    def action_view_sequences(self):
+        self.ensure_one()
+        return {
+            "name": "Sequences",
+            "type": "ir.actions.act_window",
+            "res_model": "ir.sequence",
+            "view_mode": "list,form",
+            "domain": [("template_id", "=", self.id)],
+            "context": {"default_template_id": self.id},
+        }
+
+    def action_generate_sequences(self):
+        return self.open_generate_sequences_wizard()
+
+    def open_generate_sequences_wizard(self):
+        return {
+            "name": "Generate Sequences",
+            "type": "ir.actions.act_window",
+            "view_mode": "form",
+            "res_model": "generate.company.sequences.wizard",
+            "target": "new",
+            "view_id": self.env.ref(
+                "base_sequence_template.view_generate_company_sequences_wizard_form"
+            ).id,
+            "context": {
+                "default_template_ids": self.ids,
+            },
+        }

base_sequence_template/pyproject.toml

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

base_sequence_template/readme/CONTRIBUTORS.md

@@ -0,0 +1 @@
+- Laura Cazorla \<<laura.cazorla@forgeflow.com>\>

base_sequence_template/readme/DESCRIPTION.md

@@ -0,0 +1,12 @@
+This module provides a wizard to generate company-specific sequences from
+reusable sequence templates. It is designed for multi-company environments
+where each company requires its own `ir.sequence` records but shares a common
+configuration pattern. The wizard allows defining sequence templates that
+include dynamic placeholders referencing company fields.
+
+During generation, placeholders of the form `%(company_id.<field>)s` are
+automatically replaced with the corresponding values from each company. Other
+placeholders (for example `%(year)s`) are preserved and evaluated later by the
+standard sequence engine. The module also validates that all referenced company
+fields exist and checks that required company values are not empty.
+

base_sequence_template/readme/USAGE.md

@@ -0,0 +1,19 @@
+To use this module, follow these steps:
+
+1. Create one or more sequence templates and define the desired prefix and
+   suffix, with company placeholders if desired. You can use placeholders like:
+   * `%(company_id.id)s`
+   * `%(company_id.name)s`
+   * `%(company_id.vat)s`
+2. Select the templates you want to use.
+3. Trigger the server action that opens the wizard to generate sequences for
+   companies.
+4. In the wizard, select the target companies.
+5. Confirm to generate the sequences.
+
+The wizard will:
+- Read the required company fields used in the templates.
+- Validate that those fields exist and are not empty.
+- Create one `ir.sequence` per selected company and template with the resolved
+  values.
+

base_sequence_template/security/ir.model.access.csv

@@ -0,0 +1,4 @@
+id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
+access_ir_sequence_template,access_ir_sequence_template,model_ir_sequence_template,base.group_user,1,0,0,0
+access_ir_sequence_template_system,access_ir_sequence_template_system,model_ir_sequence_template,base.group_system,1,1,1,1
+access_generate_company_sequences_wizard,access_generate_company_sequences_wizard,model_generate_company_sequences_wizard,base.group_system,1,1,1,1