[NEW] spp_registry_name_suffix

spp_registry_name_suffix/__init__.py

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

spp_registry_name_suffix/__manifest__.py

@@ -0,0 +1,28 @@
+# Part of OpenSPP. See LICENSE file for full copyright and licensing details.
+{
+    "name": "OpenSPP Registry Name Suffix",
+    "summary": "Adds a configurable suffix field (Jr., Sr., III, etc.) to Individual registrant names in OpenSPP.",
+    "category": "OpenSPP",
+    "version": "17.0.1.4.1",
+    "sequence": 1,
+    "author": "OpenSPP.org",
+    "website": "https://github.com/OpenSPP/openspp-modules",
+    "license": "LGPL-3",
+    "development_status": "Beta",
+    "maintainers": ["jeremi", "gonzalesedwin1123"],
+    "depends": [
+        "g2p_registry_individual",
+    ],
+    "data": [
+        "security/ir.model.access.csv",
+        "views/name_suffix_views.xml",
+        "views/res_partner_views.xml",
+        "data/name_suffix_data.xml",
+    ],
+    "assets": {},
+    "demo": [],
+    "images": [],
+    "application": False,
+    "installable": True,
+    "auto_install": False,
+}

spp_registry_name_suffix/data/name_suffix_data.xml

@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<odoo noupdate="1">
+
+    <!-- Generational Suffixes -->
+    <record id="suffix_jr" model="spp.name.suffix">
+        <field name="name">Jr.</field>
+        <field name="code">JR</field>
+        <field name="sequence">10</field>
+        <field name="description">Junior - typically used for a son named after his father</field>
+    </record>
+
+    <record id="suffix_sr" model="spp.name.suffix">
+        <field name="name">Sr.</field>
+        <field name="code">SR</field>
+        <field name="sequence">20</field>
+        <field name="description">Senior - typically used for a father when a son has the same name</field>
+    </record>
+
+    <record id="suffix_i" model="spp.name.suffix">
+        <field name="name">I</field>
+        <field name="code">I</field>
+        <field name="sequence">30</field>
+        <field name="description">The First</field>
+    </record>
+
+    <record id="suffix_ii" model="spp.name.suffix">
+        <field name="name">II</field>
+        <field name="code">II</field>
+        <field name="sequence">40</field>
+        <field name="description">The Second</field>
+    </record>
+
+    <record id="suffix_iii" model="spp.name.suffix">
+        <field name="name">III</field>
+        <field name="code">III</field>
+        <field name="sequence">50</field>
+        <field name="description">The Third</field>
+    </record>
+
+    <record id="suffix_iv" model="spp.name.suffix">
+        <field name="name">IV</field>
+        <field name="code">IV</field>
+        <field name="sequence">60</field>
+        <field name="description">The Fourth</field>
+    </record>
+
+    <record id="suffix_v" model="spp.name.suffix">
+        <field name="name">V</field>
+        <field name="code">V</field>
+        <field name="sequence">70</field>
+        <field name="description">The Fifth</field>
+    </record>
+
+</odoo>

spp_registry_name_suffix/models/__init__.py

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

spp_registry_name_suffix/models/name_suffix.py

@@ -0,0 +1,56 @@
+from odoo import fields, models
+
+
+class SPPNameSuffix(models.Model):
+    _name = "spp.name.suffix"
+    _description = "Name Suffix"
+    _order = "sequence, name"
+
+    name = fields.Char(
+        string="Suffix",
+        required=True,
+        help="The suffix value (e.g., Jr., Sr., III, PhD)",
+    )
+    code = fields.Char(
+        string="Code",
+        required=True,
+        help="Short code for the suffix",
+    )
+    sequence = fields.Integer(
+        string="Sequence",
+        default=10,
+        help="Used to order suffixes in dropdown lists",
+    )
+    active = fields.Boolean(
+        string="Active",
+        default=True,
+        help="If unchecked, the suffix will not be available for selection",
+    )
+    description = fields.Text(
+        string="Description",
+        help="Additional description or usage notes for this suffix",
+    )
+
+    _sql_constraints = [
+        (
+            "name_uniq",
+            "unique(name)",
+            "Suffix name must be unique!",
+        ),
+        (
+            "code_uniq",
+            "unique(code)",
+            "Suffix code must be unique!",
+        ),
+    ]
+
+    def name_get(self):
+        """Display suffix name with code if different."""
+        result = []
+        for record in self:
+            if record.code and record.code != record.name:
+                name = f"{record.name} ({record.code})"
+            else:
+                name = record.name
+            result.append((record.id, name))
+        return result

spp_registry_name_suffix/models/res_partner.py

@@ -0,0 +1,19 @@
+from odoo import api, fields, models
+
+
+class ResPartner(models.Model):
+    _inherit = "res.partner"
+
+    suffix_id = fields.Many2one(
+        comodel_name="spp.name.suffix",
+        string="Suffix",
+        ondelete="restrict",
+        help="Name suffix such as Jr., Sr., III, IV, PhD, MD, etc.",
+    )
+
+    @api.onchange("is_group", "family_name", "given_name", "addl_name", "suffix_id")
+    def name_change(self):
+        """Extend name change to include suffix for individuals."""
+        super().name_change()
+        if not self.is_group and self.suffix_id:
+            self.name = f"{self.name}, {self.suffix_id.name.upper()}"

spp_registry_name_suffix/pyproject.toml

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

spp_registry_name_suffix/readme/DESCRIPTION.md

@@ -0,0 +1,59 @@
+# OpenSPP Registry Name Suffix
+
+The `spp_registry_name_suffix` module adds a configurable suffix field to Individual registrant names in OpenSPP, enabling proper recording of name suffixes such as Jr., Sr., III, IV, PhD, MD, etc.
+
+## Purpose
+
+This module enhances individual registrant data by:
+
+* **Providing configurable suffixes**: Administrators can manage available suffixes through the Registry Configuration menu.
+* **Adding suffix support**: Record name suffixes using a standardized Many2one field reference.
+* **Extending name generation**: Automatically includes the suffix in the generated full name.
+* **Maintaining data integrity**: The suffix is stored as a reference to a configurable suffix record.
+
+## Features
+
+### Suffix Configuration
+A new "Name Suffixes" menu is available under Registry > Configuration, allowing administrators to:
+- Create, edit, and archive name suffixes
+- Define suffix codes for data integration
+- Set display order using sequence numbers
+- Add descriptions for suffix usage guidance
+
+### Pre-configured Suffixes
+The module comes with commonly used suffixes:
+- **Generational**: Jr., Sr., I, II, III, IV, V
+- **Academic/Professional**: PhD, MD, Esq.
+
+### Individual Registrant Integration
+The suffix field appears on the Individual registrant form after the "Additional Name" field. It uses a dropdown selection with the following features:
+- Quick search by suffix name or code
+- No inline creation (to maintain data quality)
+- Optional display in the registrant list view
+
+### Automatic Name Generation
+The suffix is automatically appended to the registrant's name when using the form. The module extends the `name_change` method from `g2p_registry_individual` to include the suffix in the generated name format:
+`FAMILY_NAME, GIVEN_NAME ADDL_NAME, SUFFIX`
+
+For example: "SMITH, JOHN MICHAEL, JR."
+
+## Dependencies
+
+This module depends on:
+- **g2p_registry_individual**: Provides the individual registrant views, model, and the base `name_change` method.
+
+## Configuration
+
+1. Navigate to Registry > Configuration > Name Suffixes
+2. Create additional suffixes as needed for your implementation
+3. Set the sequence to control display order in dropdowns
+
+## Usage
+
+1. Navigate to an Individual registrant form
+2. Select a suffix from the "Suffix" dropdown field
+3. The full name will automatically update to include the suffix
+
+## References
+
+- OpenG2P Registry Individual: https://github.com/OpenSPP/openg2p-registry/tree/17.0-develop-openspp/g2p_registry_individual

spp_registry_name_suffix/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
+
+spp_name_suffix_registrar,SPP Name Suffix Registrar Access,spp_registry_name_suffix.model_spp_name_suffix,g2p_registry_base.group_g2p_registrar,1,1,1,1
+spp_name_suffix_admin,SPP Name Suffix Admin Access,spp_registry_name_suffix.model_spp_name_suffix,g2p_registry_base.group_g2p_admin,1,1,1,1