feat(spp_mis_demo_v2,spp_demo): replace random volume gen with deterministic blueprints

- Add household blueprints with ~730 deterministic households
- Add SeededVolumeGenerator for reproducible demo data
- Add locale-aware Filipino/Togolese name providers in spp_demo
- Populate cycle beneficiaries and entitlements
- Improve demo data realism (enrollment dates, payment history)
- Add blueprint reproducibility tests

Author: emjay0921

spp_demo/data/res_country.xml

@@ -1,6 +1,8 @@
 from faker import Faker
 from faker.config import AVAILABLE_LOCALES
 from .en_KE import Provider as EnKeProvider
+from .fil_PH import Provider as FilPhProvider
+from .fr_TG import Provider as FrTgProvider
 from .lo_LA import Provider as LoLaProvider
 from .si_LK import Provider as SiLkProvider
 from .sw_KE import Provider as SwKeProvider
@@ -21,6 +23,10 @@ def get_faker_provider(lang):
     """
     if lang == "en_KE":
         return EnKeProvider
+    if lang == "fil_PH":
+        return FilPhProvider
+    if lang == "fr_TG":
+        return FrTgProvider
     if lang == "lo_LA":
         return LoLaProvider
     if lang == "si_LK":

spp_demo/locale_providers/__init__.py

@@ -0,0 +1,316 @@
+from faker.providers.person import Provider as PersonProvider
+
+
+class Provider(PersonProvider):
+    formats = ["{{first_name}} {{last_name}}"]
+
+    first_names_male = [
+        "Juan",
+        "Jose",
+        "Pedro",
+        "Carlos",
+        "Miguel",
+        "Ramon",
+        "Antonio",
+        "Roberto",
+        "Eduardo",
+        "Francisco",
+        "Ricardo",
+        "Fernando",
+        "Andres",
+        "Ernesto",
+        "Arturo",
+        "Leonardo",
+        "Gabriel",
+        "Rafael",
+        "Manuel",
+        "Alejandro",
+        "Marco",
+        "Paolo",
+        "Angelo",
+        "Benedict",
+        "Christian",
+        "Daniel",
+        "Enrique",
+        "Federico",
+        "Gregorio",
+        "Hector",
+        "Ignacio",
+        "Joaquin",
+        "Kevin",
+        "Lorenzo",
+        "Mariano",
+        "Nathaniel",
+        "Orlando",
+        "Patrick",
+        "Quirino",
+        "Reynaldo",
+        "Salvador",
+        "Teodoro",
+        "Ulysses",
+        "Vicente",
+        "William",
+        "Xander",
+        "Yohan",
+        "Zandro",
+        "Arjay",
+        "Bryan",
+        "Cedric",
+        "Darwin",
+        "Elmer",
+        "Francis",
+        "Gerald",
+        "Harold",
+        "Ivan",
+        "Jerome",
+        "Kenneth",
+        "Lester",
+        "Mark",
+        "Neil",
+        "Oliver",
+        "Philip",
+        "Rodel",
+        "Samuel",
+        "Tomas",
+        "Virgilio",
+        "Wesley",
+        "Ariel",
+        "Benigno",
+        "Crisanto",
+        "Dionisio",
+        "Emilio",
+        "Feliciano",
+        "Gaudencio",
+        "Herminio",
+        "Isidro",
+        "Juanito",
+        "Lauro",
+        "Macario",
+        "Norberto",
+        "Olimpio",
+        "Placido",
+        "Renato",
+        "Sergio",
+        "Teofilo",
+        "Urbano",
+        "Venancio",
+        "Wilfredo",
+        "Abelardo",
+        "Bayani",
+        "Cornelio",
+        "Delfin",
+        "Efren",
+        "Florencio",
+        "Geronimo",
+        "Hilario",
+        "Ireneo",
+        "Jovito",
+    ]
+
+    first_names_female = [
+        "Maria",
+        "Ana",
+        "Rosa",
+        "Elena",
+        "Sofia",
+        "Carmen",
+        "Isabel",
+        "Teresa",
+        "Luz",
+        "Gloria",
+        "Corazon",
+        "Remedios",
+        "Lourdes",
+        "Milagros",
+        "Rosario",
+        "Esperanza",
+        "Carmelita",
+        "Josefina",
+        "Magdalena",
+        "Concepcion",
+        "Angela",
+        "Beatriz",
+        "Catalina",
+        "Diana",
+        "Evangeline",
+        "Felicidad",
+        "Gemma",
+        "Helen",
+        "Imelda",
+        "Jocelyn",
+        "Kristine",
+        "Luisa",
+        "Marilou",
+        "Nora",
+        "Olivia",
+        "Patricia",
+        "Rosalinda",
+        "Sarah",
+        "Trinidad",
+        "Urduja",
+        "Virginia",
+        "Wanda",
+        "Yolanda",
+        "Zenaida",
+        "Aida",
+        "Bella",
+        "Cynthia",
+        "Dolores",
+        "Erlinda",
+        "Fe",
+        "Gracia",
+        "Herminia",
+        "Irene",
+        "Jasmine",
+        "Karen",
+        "Linda",
+        "Michelle",
+        "Nancy",
+        "Ofelia",
+        "Perla",
+        "Queen",
+        "Riza",
+        "Susan",
+        "Teresita",
+        "Vilma",
+        "Wilma",
+        "Yvonne",
+        "Zara",
+        "Aileen",
+        "Beverly",
+        "Cherry",
+        "Divina",
+        "Edith",
+        "Florencia",
+        "Gina",
+        "Hazel",
+        "Ivy",
+        "Joy",
+        "Kathleen",
+        "Lorna",
+        "Myrna",
+        "Nimfa",
+        "Pacita",
+        "Rizalina",
+        "Soledad",
+        "Thelma",
+        "Ursula",
+        "Violeta",
+        "Winona",
+        "Alma",
+        "Benilda",
+        "Clarita",
+        "Delia",
+        "Estela",
+        "Fidela",
+        "Glenda",
+        "Heidi",
+        "Inday",
+        "Julieta",
+    ]
+
+    first_names = first_names_female + first_names_male
+
+    last_names = [
+        "Santos",
+        "Dela Cruz",
+        "Garcia",
+        "Reyes",
+        "Mendoza",
+        "Gonzales",
+        "Bautista",
+        "Villanueva",
+        "Aquino",
+        "Cruz",
+        "Torres",
+        "Ramos",
+        "Rivera",
+        "Flores",
+        "Lopez",
+        "Hernandez",
+        "Perez",
+        "Rodriguez",
+        "Martinez",
+        "Castillo",
+        "Diaz",
+        "Fernandez",
+        "Soriano",
+        "Tolentino",
+        "Manalo",
+        "Pascual",
+        "Navarro",
+        "Aguilar",
+        "Santiago",
+        "Castro",
+        "Salvador",
+        "Mercado",
+        "Jimenez",
+        "Rosales",
+        "Magno",
+        "De Leon",
+        "Valdez",
+        "Estrada",
+        "Villegas",
+        "Lim",
+        "Tan",
+        "Chua",
+        "Ong",
+        "Go",
+        "Sy",
+        "Co",
+        "Ang",
+        "Yu",
+        "Chan",
+        "Uy",
+        "Dimaculangan",
+        "Macaraig",
+        "Pangilinan",
+        "Lacsamana",
+        "Bayani",
+        "Malabanan",
+        "De Guzman",
+        "Del Rosario",
+        "De Jesus",
+        "Dela Pena",
+        "De Castro",
+        "Dela Rosa",
+        "Del Valle",
+        "De Vera",
+        "Delos Santos",
+        "Delos Reyes",
+        "Del Mundo",
+        "De Ocampo",
+        "Enriquez",
+        "Espiritu",
+        "Galang",
+        "Gutierrez",
+        "Ignacio",
+        "Joaquin",
+        "Lazaro",
+        "Legaspi",
+        "Luna",
+        "Magsaysay",
+        "Ocampo",
+        "Palma",
+        "Quizon",
+        "Rizal",
+        "Salazar",
+        "Tinio",
+        "Urbano",
+        "Vega",
+        "Zamora",
+        "Arevalo",
+        "Buenaventura",
+        "Corpus",
+        "Datu",
+        "Evangelista",
+        "Felipe",
+        "Gorospe",
+        "Hidalgo",
+        "Ilagan",
+        "Jalandoni",
+        "Katigbak",
+        "Laurel",
+        "Manalang",
+        "Natividad",
+    ]