fix(spp_demo,spp_mis_demo_v2): convert stories to households, locale-aware names, sync docs

spp

@@ -22,7 +22,14 @@ import shutil
 import subprocess
 import sys
 import time
-import tomllib
+
+try:
+    import tomllib
+except ModuleNotFoundError:
+    try:
+        import tomli as tomllib
+    except ModuleNotFoundError:
+        tomllib = None
 from pathlib import Path
 
 try:
@@ -99,13 +106,15 @@ DEFAULT_CONFIG = {
 def load_config() -> dict:
     """Load config from ~/.spp.toml, returning defaults if not found."""
     config = DEFAULT_CONFIG.copy()
-    if CONFIG_PATH.exists():
+    if CONFIG_PATH.exists() and tomllib is not None:
         try:
             with open(CONFIG_PATH, "rb") as f:
                 user_config = tomllib.load(f)
                 config.update(user_config)
         except (tomllib.TOMLDecodeError, OSError) as e:
             warn(f"Could not load config from {CONFIG_PATH}: {e}")
+    elif CONFIG_PATH.exists() and tomllib is None:
+        warn("tomllib not available (Python < 3.11). Install 'tomli' or upgrade Python to load ~/.spp.toml config.")
     return config
 
 
@@ -131,7 +140,7 @@ DEMO_PROFILES = {
 }
 
 
-def run(cmd: str | list, check: bool = True, capture: bool = False, **kwargs) -> subprocess.CompletedProcess:
+def run(cmd, check: bool = True, capture: bool = False, **kwargs) -> subprocess.CompletedProcess:
     """Run a command with nice defaults."""
     if isinstance(cmd, str):
         kwargs.setdefault("shell", True)
@@ -909,7 +918,7 @@ def cmd_sql(args):
         run(docker_compose("exec", "db", "psql", "-U", "odoo", "-d", db_name))
 
 
-def _show_url(open_browser: bool = False) -> str | None:
+def _show_url(open_browser: bool = False):
     """Get the running Odoo server URL."""
     service, profile = _find_running_odoo()
     if not service:

spp_case_demo/README.rst

@@ -7,7 +7,7 @@ OpenSPP Case Management Demo Data
    !! This file is generated by oca-gen-addon-readme !!
    !! changes will be overwritten.                   !!
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-   !! source digest: sha256:39196739031b49c0d69e329806b940da071ca49472f130cd28ffd45eda6459e7
+   !! source digest: sha256:force_regen
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 
 .. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
@@ -24,16 +24,20 @@ OpenSPP Case Management Demo Data
 
 Demo data generator for Case Management system. Creates realistic cases
 with intervention plans, home visits, progress notes, and service
-referrals. Includes 9 fixed demo stories for training and sales demos,
-plus configurable random case generation for volume testing.
+referrals. Includes 9 fixed demo stories plus 3 background cases for
+training and sales demos, and configurable volume case generation using
+Faker for locale-aware random data (non-deterministic — each run
+produces different results).
 
 Key Capabilities
 ~~~~~~~~~~~~~~~~
 
 - Generate 9 fixed demo stories with predictable personas and case
-  progressions for consistent training scenarios
-- Create random volume cases with configurable distribution percentages
-  for plans, visits, notes, and closures
+  progressions for consistent training scenarios, plus 3 background
+  cases (Fernandez Intake Pending, Johnson Assessment, Kim Case Closed)
+  for variety
+- Create random volume cases using Faker (non-seeded) with configurable
+  distribution percentages for plans, visits, notes, and closures
 - Link generated cases to existing registrants or create standalone
   cases
 - Backdate case records and related activities to simulate realistic

spp_case_demo/readme/DESCRIPTION.md

@@ -1,9 +1,9 @@
-Demo data generator for Case Management system. Creates realistic cases with intervention plans, home visits, progress notes, and service referrals. Includes 9 fixed demo stories for training and sales demos, plus configurable random case generation for volume testing.
+Demo data generator for Case Management system. Creates realistic cases with intervention plans, home visits, progress notes, and service referrals. Includes 9 fixed demo stories plus 3 background cases for training and sales demos, and configurable volume case generation using Faker for locale-aware random data (non-deterministic — each run produces different results).
 
 ### Key Capabilities
 
-- Generate 9 fixed demo stories with predictable personas and case progressions for consistent training scenarios
-- Create random volume cases with configurable distribution percentages for plans, visits, notes, and closures
+- Generate 9 fixed demo stories with predictable personas and case progressions for consistent training scenarios, plus 3 background cases (Fernandez Intake Pending, Johnson Assessment, Kim Case Closed) for variety
+- Create random volume cases using Faker (non-seeded) with configurable distribution percentages for plans, visits, notes, and closures
 - Link generated cases to existing registrants or create standalone cases
 - Backdate case records and related activities to simulate realistic timelines over configurable day ranges
 - Create intervention plans with multiple interventions across case lifecycle stages

spp_case_demo/static/description/index.html

@@ -367,20 +367,24 @@ <h1 class="title">OpenSPP Case Management Demo Data</h1>
 !! This file is generated by oca-gen-addon-readme !!
 !! changes will be overwritten.                   !!
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-!! source digest: sha256:39196739031b49c0d69e329806b940da071ca49472f130cd28ffd45eda6459e7
+!! source digest: sha256:force_regen
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
 <p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Production/Stable" src="https://img.shields.io/badge/maturity-Production%2FStable-green.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/lgpl-3.0-standalone.html"><img alt="License: LGPL-3" src="https://img.shields.io/badge/license-LGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OpenSPP/OpenSPP2/tree/19.0/spp_case_demo"><img alt="OpenSPP/OpenSPP2" src="https://img.shields.io/badge/github-OpenSPP%2FOpenSPP2-lightgray.png?logo=github" /></a></p>
 <p>Demo data generator for Case Management system. Creates realistic cases
 with intervention plans, home visits, progress notes, and service
-referrals. Includes 9 fixed demo stories for training and sales demos,
-plus configurable random case generation for volume testing.</p>
+referrals. Includes 9 fixed demo stories plus 3 background cases for
+training and sales demos, and configurable volume case generation using
+Faker for locale-aware random data (non-deterministic — each run
+produces different results).</p>
 <div class="section" id="key-capabilities">
 <h1>Key Capabilities</h1>
 <ul class="simple">
 <li>Generate 9 fixed demo stories with predictable personas and case
-progressions for consistent training scenarios</li>
-<li>Create random volume cases with configurable distribution percentages
-for plans, visits, notes, and closures</li>
+progressions for consistent training scenarios, plus 3 background
+cases (Fernandez Intake Pending, Johnson Assessment, Kim Case Closed)
+for variety</li>
+<li>Create random volume cases using Faker (non-seeded) with configurable
+distribution percentages for plans, visits, notes, and closures</li>
 <li>Link generated cases to existing registrants or create standalone
 cases</li>
 <li>Backdate case records and related activities to simulate realistic