feat: add module summaries to manifests for remaining modules

Updates __manifest__.py files with concise 2-sentence summaries for:
- spp_farmer_registry_default_ui
- spp_hide_menus
- spp_hide_menus_base
- spp_pos_id_redemption
- spp_qr_scanner
- spp_registry_approval
- spp_registry_approval_group
- spp_registry_approval_individual
- spp_registry_base

Also updates existing DESCRIPTION.md files with higher quality documentation content.

Author: jeremi

spp_farmer_registry_default_ui/__manifest__.py

@@ -3,7 +3,7 @@
 
 {
     "name": "OpenSPP Farmer Registry Default UI",
-    "summary": "Provides UI for Farmer Registry Base.",
+    "summary": "This module delivers the essential user interface components for managing OpenSPP farmer and farm registry data. It enables streamlined farmer registration, efficient farm management, and accessible entry of agricultural activity and asset information.",
     "category": "OpenSPP",
     "version": "17.0.1.3.1",
     "sequence": 1,

spp_farmer_registry_default_ui/readme/DESCRIPTION.md

@@ -1,43 +1,41 @@
+# OpenSPP Farmer Registry Default Ui
 
-# Farmer Registry Default UI
-
-The `spp_farmer_registry_default_ui` module provides the essential user interface (UI) for interacting with the OpenSPP Farmer Registry. It translates the underlying data structures and business logic of the farmer registry into intuitive screens and forms, enabling users to efficiently manage farmer, farm, and agricultural activity information.
+The OpenSPP Farmer Registry Default UI module provides the essential user interface (UI) components for interacting with the core farmer registry data. It translates the robust backend structures of the farmer registry into intuitive, accessible screens, enabling users to efficiently manage farmer and farm-related information within OpenSPP.
 
 ## Purpose
 
-This module serves as the primary gateway for users to access and manage all aspects of the OpenSPP Farmer Registry. It streamlines data entry, viewing, and modification processes, making the comprehensive farmer and farm data models usable by program staff and field officers.
+This module delivers the front-end experience for the OpenSPP Farmer Registry, making complex data management accessible and user-friendly. It accomplishes this by:
 
-*   **Manage Individual Farmer Profiles**: Users can create, view, and update detailed profiles for individual farmers, including personal information, contact details, and farmer-specific attributes.
-*   **Organize Farmer Groups**: The module enables the establishment and management of farmer groups, cooperatives, or associations, facilitating collective data management and reporting.
-*   **Administer Farm Details**: It provides interfaces to define and manage individual farms, allowing users to record farm types, sizes, legal status, and their association with specific farmers and land parcels.
-*   **Track Agricultural Activities**: Users can record and monitor agricultural activities, such as crop cultivation, livestock rearing, and aquaculture, along with associated inputs and assets.
+*   **Streamlined Farmer Registration**: Offers an intuitive interface to easily create, view, and update detailed profiles for individual farmers, including their demographics and agricultural experience.
+*   **Efficient Farm Management**: Provides user-friendly screens for registering and managing various farm types (e.g., crop, livestock), detailing their characteristics and associated agricultural practices.
+*   **Visualizing Farmer-Farm Links**: Enables clear viewing and management of the relationships between individual farmers and the farms they operate or are members of.
+*   **Accessible Agricultural Data Entry**: Gives users a direct way to input and review data related to land records, agricultural activities, and farm assets, such as machinery.
+*   **Simplified Data Navigation**: Organizes comprehensive farmer and farm data into accessible views, facilitating quick information retrieval and updates for program staff.
 
 ## Dependencies and Integration
 
-The `spp_farmer_registry_default_ui` module directly builds upon the core functionalities of the [OpenSPP Farmer Registry Base](spp_farmer_registry_base) module. The base module defines the foundational data models and business logic for farmers, farms, and agricultural activities. This UI module then provides the visual components—forms, list views, and action buttons—that allow users to interact with those underlying data structures.
-
-This module is crucial for making the rich data and features of the OpenSPP Farmer Registry accessible and actionable for non-technical users. Without it, the extensive data models defined in the base module would not have a direct user interface for data input and management.
+The `spp_farmer_registry_default_ui` module is a crucial front-end component that relies entirely on the backend data models and business logic provided by its core dependency.
 
-## Additional Functionality
+*   **[Farmer Registry Base](spp_farmer_registry_base)**: This module depends on `spp_farmer_registry_base` to provide the underlying data structures for farmers, farms, land records, and agricultural activities. `spp_farmer_registry_default_ui` then builds the visual interface on top of these foundational elements, allowing users to interact with the data defined by the base module.
 
-This module delivers a comprehensive set of user interfaces designed for efficient management of farmer-related data:
+Essentially, `spp_farmer_registry_default_ui` serves as the window through which users access and manipulate the rich farmer registry data managed by the `spp_farmer_registry_base` module, ensuring a cohesive and functional system.
 
-### Individual Farmer Profile Management
+## Additional Functionality
 
-Users can easily create, view, and update individual farmer profiles. This includes capturing personal identification details, contact information, and specific attributes relevant to their farming practices, such as years of experience, formal agricultural training, and household size. The interface ensures all farmer-specific data defined in the base module is readily accessible and manageable.
+This module provides the necessary screens and forms for comprehensive management of farmer and farm data, making the information stored in the `spp_farmer_registry_base` accessible and actionable.
 
-### Farmer Group and Cooperative Management
+### Managing Individual Farmer Profiles
 
-The module provides dedicated interfaces for managing farmer groups, cooperatives, or other collective organizations. Users can establish new groups, define their characteristics, and manage the membership of individual farmers within these groups. This functionality supports the organization and aggregation of data for collective entities within the social protection program.
+Users can easily create, view, and modify individual farmer profiles through dedicated UI forms. This includes managing personal details, contact information, and linking farmers to specific farms where they hold roles like "Head Member." The interface supports the capture of diverse demographic and agricultural experience data.
 
-### Comprehensive Farm and Land Record Administration
+### Registering and Overseeing Farm Records
 
-Users gain access to detailed screens for managing individual farms. This includes recording essential information such as farm types, sizes, and legal status. The module facilitates linking farms to specific land records, allowing for a clear overview of land parcels associated with each farm and their geospatial information.
+The module offers a clear interface for registering new farms and managing existing farm records. Users can input details about the farm's type, size, legal status, and specific agricultural practices. This also includes the ability to associate multiple individuals with a farm, defining their roles and contributions.
 
-### Agricultural Activity and Asset Tracking
+### Accessing Related Agricultural Data
 
-Interfaces are available to define and track various agricultural activities undertaken on each farm, including crop cultivation, livestock rearing, and aquaculture. Users can also record information about farm assets and inputs, such as fertilizers or equipment, linking them directly to specific activities or land parcels. This provides a granular view of agricultural practices and resource utilization.
+While `spp_farmer_registry_default_ui` focuses on the primary farmer and farm records, it provides direct navigation and views to related information managed by the base module. This allows users to seamlessly access and update linked land records, track agricultural activities within defined seasons, and document farm assets or extension services provided, all through intuitive screens.
 
 ## Conclusion
 
-The `spp_farmer_registry_default_ui` module provides the essential user interface for managing all aspects of farmer and farm data within OpenSPP, making the underlying registry functionalities fully accessible and actionable for program users.
+The `spp_farmer_registry_default_ui` module is the user-facing gateway to OpenSPP's farmer registry, providing the essential interface for efficient and comprehensive management of farmer and farm data.

spp_grm/__manifest__.py

@@ -2,8 +2,7 @@
 
 {
     "name": "OpenSPP - Grievance Redress Mechanism",
-    "summary": "Provides a centralized Grievance Redress Mechanism for receiving, tracking, and resolving beneficiary complaints and feedback. It supports multi-channel submission, manages resolution workflows through customizable stages, and links grievances directly to individual or group registrants."
-        Grievance redress mechanism module for OpenSPP""",
+    "summary": "Provides a centralized Grievance Redress Mechanism for receiving, tracking, and resolving beneficiary complaints and feedback. It supports multi-channel submission, manages resolution workflows through customizable stages, and links grievances directly to individual or group registrants.",
     "version": "17.0.1.3.1",
     "sequence": 1,
     "author": "OpenSPP.org",

spp_hide_menus/__manifest__.py

@@ -5,6 +5,7 @@
     "name": "Hide Non-OpenSPP Menus",
     "category": "OpenSPP",
     "version": "17.0.1.3.1",
+    "summary": "The module automatically hides non-core OpenSPP menus to streamline the user interface. It removes Calendar, Contacts, Accounting, Event, Stock, and UTM from the main navigation, focusing users on social protection program management.",
     "sequence": 1,
     "author": "OpenSPP.org",
     "website": "https://github.com/OpenSPP/openspp-modules",

spp_hide_menus/readme/DESCRIPTION.md

@@ -1,38 +1,34 @@
+# OpenSPP Hide Menus
 
-# Hide Non-OpenSPP Menus
-
-The OpenSPP Hide Menus module streamlines the OpenSPP platform by automatically hiding standard Odoo menu items that are not typically essential for core social protection program management. This creates a focused user interface, ensuring users primarily interact with functionalities relevant to their specific roles and program objectives.
+The OpenSPP Hide Menus module streamlines the OpenSPP user interface by automatically hiding specific menus not directly related to core social protection program management or farmer registries. This ensures users encounter a cleaner, more focused environment tailored for their primary responsibilities.
 
 ## Purpose
 
-This module is designed to declutter the OpenSPP interface by pre-configuring the visibility of common Odoo menus. It establishes a more focused and efficient working environment, particularly beneficial for OpenSPP users involved in field operations or specialized program tasks.
+This module optimizes the OpenSPP user experience by removing visual clutter and directing attention to essential program functionalities. It simplifies navigation and enhances operational efficiency for users.
 
-*   **Streamline User Experience:** Automatically hides menus from modules like Calendar, Contacts, Accounting, and Inventory, providing a cleaner, OpenSPP-centric interface. This ensures field agents or case workers see only relevant program functions.
-*   **Enhance Operational Focus:** Reduces distractions and simplifies navigation, allowing users to quickly access the tools they need for managing beneficiaries, programs, or farmer registries without sifting through unrelated options.
-*   **Improve System Adoption:** A less cluttered interface is easier to learn and navigate, which helps increase user comfort and reduces the training overhead for new OpenSPP users.
-*   **Tailor for Specific Deployments:** While [OpenSPP Hide Menus Base](spp_hide_menus_base) offers granular control, this module provides an immediate, default simplification, making OpenSPP more ready-to-use for typical social protection deployments.
+*   **Streamline User Interface:** Presents a focused OpenSPP experience by hiding general-purpose modules, ensuring users see only what is relevant to their social protection program work.
+*   **Reduce Menu Clutter:** Automatically removes menus such as Calendar, Contacts, Accounting, Event, Stock, and UTM from the main navigation, preventing distractions and improving clarity.
+*   **Enhance User Focus:** Guides users directly to program-specific functionalities, allowing them to quickly access tools for beneficiary management, payment processing, or farmer data.
+*   **Optimize Workflow:** Ensures that field agents, program managers, and data entry specialists can efficiently navigate the platform without sifting through irrelevant options.
 
 ## Dependencies and Integration
 
-The `spp_hide_menus` module leverages the foundational capabilities of the [OpenSPP Hide Menus Base](spp_hide_menus_base) module to manage menu visibility.
+The `spp_hide_menus` module integrates with the core OpenSPP framework to manage interface elements, building upon the capabilities of its base module.
 
-*   It directly depends on [OpenSPP Hide Menus Base](spp_hide_menus_base), which provides the core mechanism for administrators to define and control menu visibility. This module builds upon that foundation by applying a specific set of predefined visibility rules.
-*   This module interacts with standard Odoo modules such as Calendar, Contacts, Account, Event, Stock, and UTM. Its primary function is to hide the default menu items provided by these modules, thereby creating a more focused OpenSPP environment.
-*   By pre-hiding these menus, `spp_hide_menus` ensures that users primarily interact with modules central to social protection, like beneficiary management or program enrollment, immediately upon system deployment.
+*   This module depends on the foundational [Hide Non-OpenSPP Menus: Base](spp_hide_menus_base) module, which provides the underlying mechanism for controlling menu visibility. `spp_hide_menus` leverages this base functionality to apply specific hiding configurations.
+*   It interacts with standard Odoo modules like `Calendar`, `Contacts`, `Account`, `Event`, `Stock`, and `UTM` by setting their main menu items to be hidden by default. This ensures that a typical OpenSPP deployment starts with a user interface optimized for social protection programs.
+*   While `spp_hide_menus` itself does not provide services to other modules, it sets a default, cleaner interface that benefits all users interacting with other OpenSPP modules by reducing cognitive load and simplifying navigation.
 
 ## Additional Functionality
 
-This module's core functionality is to apply a predefined set of menu visibility rules to simplify the OpenSPP interface.
+### Default OpenSPP Interface Optimization
 
-### Default Menu Simplification
-Upon installation, this module automatically sets common Odoo menu items to be hidden from most OpenSPP users. This includes menus typically found in areas like general accounting, inventory management, and broad contact lists, which are often not directly relevant to the daily tasks of social protection program staff. This immediate simplification helps focus users on core program activities.
+This module comes pre-configured to hide several common Odoo modules that are often not central to social protection program operations. By default, menus for **Calendar**, **Contacts**, **Accounting**, **Events**, **Stock**, and **UTM (marketing tools)** are hidden. This configuration ensures that users immediately experience an interface focused on beneficiary management, program enrollment, and other core OpenSPP functions, reducing the need for manual setup.
 
-### Enhanced User Focus
-By default, the module configures the system so that users will primarily see menus related to OpenSPP's core functions. This ensures a streamlined experience, reducing the time users spend searching for specific features and minimizing cognitive load. For instance, a field agent will directly access beneficiary registration or case management without navigating through unrelated business modules.
+### Administrator Control and Flexibility
 
-### Administrator Override
-While this module provides a default simplified view, administrators retain full control. They can use the underlying [OpenSPP Hide Menus Base](spp_hide_menus_base) module to unhide any of these menus if a specific deployment requires access to, for example, the Calendar or Contacts module for certain user groups. This flexibility ensures the system can adapt to evolving program needs without losing the initial benefit of a focused interface.
+While `spp_hide_menus` applies a default set of hidden menus, administrators retain full control over their visibility. Leveraging the capabilities of the [Hide Non-OpenSPP Menus: Base](spp_hide_menus_base) module, administrators can easily unhide any of these menus if they become necessary for specific program requirements or user roles. This flexibility allows organizations to tailor the interface precisely to their operational needs.
 
 ## Conclusion
 
-The `spp_hide_menus` module delivers a focused and efficient OpenSPP user experience by strategically hiding non-essential standard Odoo menus, thus optimizing the platform for social protection program management.
+The OpenSPP Hide Menus module plays a crucial role in delivering a focused and efficient user experience by pre-configuring the visibility of non-core menus, thereby streamlining navigation for all OpenSPP users.

spp_hide_menus_base/__manifest__.py

@@ -5,6 +5,7 @@
     "name": "Hide Non-OpenSPP Menus: Base",
     "category": "OpenSPP",
     "version": "17.0.1.3.1",
+    "summary": "Administrators can manage the visibility of OpenSPP navigation menus, streamlining the user interface for specific user groups. The module modifies ir.ui.menu records to control menu visibility, providing a foundation for other modules to selectively hide non-essential navigation items.",
     "sequence": 1,
     "author": "OpenSPP.org",
     "website": "https://github.com/OpenSPP/openspp-modules",