docs(spp_farmer_registry_demo,spp_mis_demo_v2): add generated READMEs

Include auto-generated README.rst and index.html from
oca-gen-addon-readme (Python 3.11) to match CI expectations.

Author: emjay0921

spp_farmer_registry_demo/README.rst

@@ -0,0 +1,161 @@
+.. image:: https://odoo-community.org/readme-banner-image
+   :target: https://odoo-community.org/get-involved?utm_source=readme
+   :alt: Odoo Community Association
+
+============================
+OpenSPP Farmer Registry Demo
+============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:dfca553e48db1d9dfc3054a44bbbd863e95bc030a1dc4d389285d1b660f043c1
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Production/Stable
+.. |badge2| image:: https://img.shields.io/badge/license-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-OpenSPP%2FOpenSPP2-lightgray.png?logo=github
+    :target: https://github.com/OpenSPP/OpenSPP2/tree/19.0/spp_farmer_registry_demo
+    :alt: OpenSPP/OpenSPP2
+
+|badge1| |badge2| |badge3|
+
+Demo data generator for the OpenSPP Farmer Registry. Creates 8 named
+farmer personas with complete Philippine farm profiles, 5 agricultural
+subsidy programs with CEL eligibility expressions, and optionally
+generates ~730 volume farms from deterministic blueprints using a seeded
+random generator (``seed=42``) for reproducible output.
+
+Key Capabilities
+~~~~~~~~~~~~~~~~
+
+- **8 Fixed Story Farms** with hardcoded profiles (Maria Santos, Juan
+  Dela Cruz, Rosa Garcia, Amir Mangudadatu, Sofia Martinez, Ramon dela
+  Cruz, Sittie Pangandaman, Danilo Villanueva)
+- **~730 Volume Farms** generated deterministically from 21 blueprints
+  via ``SeededFarmGenerator`` with ``random.Random(seed=42)`` — same
+  seed always produces identical farms, members, and activities
+- **5 Demo Programs** with CEL-based eligibility and benefit formulas
+  (Input Subsidy, Equipment Grant, Livestock Support, Climate
+  Resilience, Aquaculture Support)
+- **2 Farm Cooperatives** demonstrating group-of-groups hierarchy (Nueva
+  Ecija Rice Cooperative, BARMM Farmers Federation)
+- **3 Edge Case Personas** for testing eligibility boundaries (AgriCorp
+  Holdings, Idle Land Farm, New Farmer)
+- Install Logic Packs from ``spp_studio`` for eligibility rules
+- Create program cycles with entitlements and payments
+- Create change requests at various workflow stages
+- Geographic distribution across 8 Philippine provinces with GPS
+  coordinates and land parcel polygons
+
+Key Models
+~~~~~~~~~~
+
++-------------------------------+-------------------------------------+
+| Model                         | Description                         |
++===============================+=====================================+
+| ``spp.farmer.demo.generator`` | Core demo generator wizard with all |
+|                               | generation logic                    |
++-------------------------------+-------------------------------------+
+
+Configuration
+~~~~~~~~~~~~~
+
+After installing:
+
+1. Navigate to **Settings > Demo Data > Load Farmer Demo**
+2. Click "Load Demo Data" to generate
+
+Demo Programs
+~~~~~~~~~~~~~
+
+All programs use CEL expressions with activated registry variables:
+
+- **Input Subsidy Program**: Per-hectare scaling for smallholders with
+  productive land
+- **Equipment Grant Program**: Experience-based grant for farmers with
+  2+ years
+- **Livestock Support Program**: Per-head scaling for livestock owners
+- **Climate Resilience Program**: Targets farms with idle land
+- **Aquaculture Support Program**: Activity-specific support for
+  aquaculture farmers
+
+Seeded Volume Generation
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+The ``SeededFarmGenerator`` uses ``random.Random(seed=42)`` for all
+structural choices:
+
+- Farm names from Filipino last name pools
+- Member names (given + family) from locale-specific pools
+- Farm sizes, experience years, GPS coordinates
+- Activity quantities (crop areas, livestock counts, aquaculture)
+
+Running the generator twice with the same seed produces identical
+output.
+
+Security
+~~~~~~~~
+
+================================ =========
+Group                            Access
+================================ =========
+``spp_security.group_spp_admin`` Full CRUD
+================================ =========
+
+Dependencies
+~~~~~~~~~~~~
+
+``spp_starter_farmer_registry``, ``spp_demo``,
+``spp_farmer_registry_cr``, ``spp_studio``,
+``spp_registry_group_hierarchy``, ``spp_area``, ``spp_programs``
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OpenSPP/OpenSPP2/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/OpenSPP/OpenSPP2/issues/new?body=module:%20spp_farmer_registry_demo%0Aversion:%2019.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
+-------
+
+* OpenSPP.org
+
+Maintainers
+-----------
+
+.. |maintainer-jeremi| image:: https://github.com/jeremi.png?size=40px
+    :target: https://github.com/jeremi
+    :alt: jeremi
+.. |maintainer-gonzalesedwin1123| image:: https://github.com/gonzalesedwin1123.png?size=40px
+    :target: https://github.com/gonzalesedwin1123
+    :alt: gonzalesedwin1123
+.. |maintainer-emjay0921| image:: https://github.com/emjay0921.png?size=40px
+    :target: https://github.com/emjay0921
+    :alt: emjay0921
+
+Current maintainers:
+
+|maintainer-jeremi| |maintainer-gonzalesedwin1123| |maintainer-emjay0921| 
+
+This module is part of the `OpenSPP/OpenSPP2 <https://github.com/OpenSPP/OpenSPP2/tree/19.0/spp_farmer_registry_demo>`_ project on GitHub.
+
+You are welcome to contribute.