fix(spp_mis_demo_v2): adapt demo data to re-landed spp_demo/spp_gis_report schemas (#277, #280)

[kneckinator]

Summary

Adapts spp_mis_demo_v2 demo data to two schema changes introduced by the re-lands in #277 and #280. Without this, installing spp_mis_demo_v2 on top of those PRs breaks:

• feat(spp_demo): curated PHL geodata + spp_demo_phl_luzon demo module (re-land from #76) #277 renames the Philippine area external IDs in spp_demo to curated PSGC p-codes. STORY_AREA_MAP still referenced the old named IDs (area_phl_calamba, area_phl_quezon_city, …), which resolve with raise_if_not_found=False — so every PHL story registrant silently lost its area assignment.
• feat(spp_gis_report): metric disaggregation in GIS reports (re-land from #76) #280 removes the boolean disaggregate_by_gender / disaggregate_by_age fields on spp.gis.report in favor of dimension_ids. data/demo_gis_reports.xml still set the removed booleans, causing a hard ParseError on install/update.

Changes

• STORY_AREA_MAP remapped to the new PSGC p-code IDs. Ten stories map 1:1 to the same city; four whose original barangay/city is absent from the curated dataset (Bacoor, and the Commonwealth/Poblacion/Real barangays) are reassigned to distinct municipalities so the 14 stories still light up 14 distinct areas on the demo map. Each entry carries a comment naming the city, since the raw p-codes are opaque.
• demo_gis_reports.xml switched from the removed booleans to dimension_ids referencing the gender and age_group demographic dimensions. The two group-filtered reports also set member_expansion="expand" so demographic dimensions are read off individual members rather than the groups.
• Explicit spp_metric_service dependency added for the demographic dimension records referenced above (previously only transitive via spp_gis_report).
• Version bump 19.0.2.0.1 → 19.0.2.0.2 + HISTORY entry.

⚠️ Merge order

This PR depends on the new schemas from #277 and #280 and cannot build on 19.0 until both have merged. Please merge those first (and rebase this branch onto the result).

Verification

• Manifest / generator parse; demo_gis_reports.xml well-formed; all 14 referenced area IDs exist as records in feat(spp_demo): curated PHL geodata + spp_demo_phl_luzon demo module (re-land from #76) #277; both dimension XML IDs exist in spp_metric_service; all 14 fil_PH targets distinct.
• ⚠️ Not yet install-tested end-to-end — that requires feat(spp_demo): curated PHL geodata + spp_demo_phl_luzon demo module (re-land from #76) #277 + feat(spp_gis_report): metric disaggregation in GIS reports (re-land from #76) #280 present in the same tree. Before merging, install spp_mis_demo_v2 (ideally the misluzon profile) on top of both re-lands and confirm the demo loads clean and the GIS reports render disaggregation.

[gemini-code-assist]

Code Review

This pull request updates the demo GIS reports to use the new disaggregation model by replacing the deprecated boolean flags (disaggregate_by_gender and disaggregate_by_age) with dimension_ids referencing demographic dimensions from spp_metric_service. It also adds spp_metric_service as a dependency in the manifest. Additionally, the Philippine story areas in STORY_AREA_MAP are remapped to curated PSGC p-code area external IDs, and the module version is bumped to 19.0.2.0.2 with corresponding history notes. There are no review comments, so I have no feedback to provide.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 74.28%. Comparing base (9f7dd29) to head (1caf794).

Additional details and impacted files

@@           Coverage Diff           @@
##             19.0     #295   +/-   ##
=======================================
  Coverage   74.28%   74.28%           
=======================================
  Files         372      372           
  Lines       25385    25385           
=======================================
  Hits        18857    18857           
  Misses       6528     6528           

Flag	Coverage Δ
spp_base_common	90.26% <ø> (ø)
spp_dci_demo	93.39% <ø> (ø)
spp_mis_demo_v2	70.96% <ø> (ø)
spp_programs	65.27% <ø> (ø)
spp_registry	86.83% <ø> (ø)
spp_security	66.66% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
spp_mis_demo_v2/__manifest__.py	0.00% <ø> (ø)
spp_mis_demo_v2/models/mis_demo_generator.py	64.02% <ø> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[gonzalesedwin1123]

Heads-up: with the maintainer's agreement, the demo_gis_reports.xml portion of this draft has been folded into #280 (verbatim, Co-authored-by you) so #280 can merge atomically — its merge ref was hard-failing test (spp_dci_demo) exactly as your #280 review predicted, and this draft couldn't go green before #280 by construction. After #280 merges, this PR rebases down to the STORY_AREA_MAP p-code remap (the #277 fallout), which is independent and mergeable anytime.

[gonzalesedwin1123]

Rebased onto 19.0 now that #280 is merged (with the maintainer's go-ahead), pushed as f43a533f:

• The demo_gis_reports.xml patch dropped away automatically during rebase (byte-identical to what feat(spp_gis_report): metric disaggregation in GIS reports (re-land from #76) #280 folded in — your authorship preserved there via Co-authored-by).
• Remaining scope, as planned: the STORY_AREA_MAP PSGC p-code remap + the explicit spp_metric_service dependency you added.
• Version-bump collision resolved: mainline took 19.0.2.1.2 for the folded piece, so this PR is 19.0.2.1.3 with a scope-corrected HISTORY entry; README rendered.

CI should now run green against the real base — once it settles, this is independent and ready whenever you flip it from draft. It closes the silent PHL story-area gap that's been live since #277 merged.

[gonzalesedwin1123]

Added test_story_area_map.py — a regression guard asserting every STORY_AREA_MAP external ID resolves after loading each country's areas (suite 273/0). Rationale: the map's raise_if_not_found=False consumption is what made the original breakage silent; this makes any future area-ID rename fail loudly, closing the test gap noted in the #277 review.

Also marked ready-for-review with the maintainer's agreement — CI is green on the rebased base and the remaining scope is exactly the p-code remap + explicit dependency. Merge at your convenience.