zayef 0.1.1 → 0.2.0.1

data/lib/zayef/generator.rb

@@ -1,106 +1,49 @@
 # frozen_string_literal: true
 
+require_relative 'data_loader'
+
 module Zayef
   class Generator
-    # Moroccan first names (authentic and common) - EXTENDED LIST
-    MOROCCAN_FIRST_NAMES = %w[
-      Ayoub Youssef Mohamed Ahmed Omar Hassan Ali Khalid Rachid
-      Abdelkader Abdelmoumen Abdelhak Abdelaziz Abdelouahed
-      Mustapha Brahim Reda Karim Anas Adil Yassine Nabil
-      Said Ismail Jamal Saad Soufiane Hamza Bilal Mehdi
-      Younes Ilyas Zakaria Ilyesse Tarik Noureddine Abdelilah
-      Mohammed Brahim Idriss Abdeljalil Abdelghani Abdelmajid
-      Fatima Zahra Aicha Khadija Malika Noura Salma Imane
-      Amina Soukaina Kawtar Houda Naima Hanane Latifa Zineb
-      Jamila Zakia Samira Nadia Farida Rachida Hakima
-      Laila Leila Hind Sana Sanaa Leila Sabah Meryem
-      Karima Fatiha Najat Hayat Hayat Rabia Asmaa
-      Nouria Badia Bahia Faiza Widad Wafa Asma
-      Rahma Safia Halima Abla Basma Loubna Nouha
-      Safaa Najwa Najiba Mouna Mounia Raja Rajaa
-      Sabah Sabah Racha Racha Rima Rima Lina Lina
-      Sara Sarah Yasmina Yasmeen Lamia Lamya
-    ].freeze
-
-    # Moroccan last names (authentic family names) - EXTENDED LIST
-    MOROCCAN_LAST_NAMES = [
-      "Alaoui", "Bennani", "El Fassi", "Idrissi", "Kabbaj", "Lamrani", "Mansouri",
-      "Benjelloun", "Chakir", "El Idrissi", "Haddouchi", "Kettani", "Laraki",
-      "Belhaj", "Belkadi", "Benkirane", "Benchekroun", "Benabdellah",
-      "Cherkaoui", "El Moutawakil", "El Amrani", "El Ouafi", "El Bachiri",
-      "Benali", "Benmansour", "Benhassan", "Benbrahim", "Benmoussa",
-      "El Khadiri", "El Yousfi", "El Haddadi", "El Kabbaj", "El Mansouri",
-      "Chraibi", "Berrada", "El Amraoui", "El Haouzi", "El Ouazzani",
-      "Tazi", "Alaoui", "Bennouna", "El Glaoui", "Bouazza",
-      "Bouabid", "Bouazza", "El Azzouzi", "El Arrousi",
-      "El Malki", "El Mansouri", "El Ouardi", "El Ouazzani",
-      "Benabbou", "Benabdeljalil", "Benachour", "Benadada",
-      "Benallal", "Benamara", "Benamghar", "Benanou",
-      "Benbachir", "Benbarka", "Benbouazza", "Benbrahim",
-      "Benchekroun", "Bendaoud", "Bendriss", "Benfares",
-      "Benhaddou", "Benhamou", "Benharbit", "Benjelloun",
-      "Benkirane", "Benmoha", "Benmoussa", "Bennani",
-      "Bennouna", "Benomar", "Benouhoud", "Bensalem",
-      "Benslimane", "Bentaleb", "Berada", "Berrada",
-      "Bouachrine", "Bouazza", "Bouazzati", "Boudraa",
-      "Boufous", "Bouhaddou", "Bouhlal", "Boujemaa",
-      "Boukhalef", "Boukhris", "Boulaich", "Boulahfa",
-      "Boumakh", "Boumediene", "Bounaim", "Bououid",
-      "Boussaid", "Boussetta", "Boutaleb", "Bouyaghchi",
-      "Chahboun", "Chahine", "Chaoui", "Cherkaoui",
-      "Chraibi", "Dahbi", "Dahmani", "Darif",
-      "Dkhissi", "Doukkali", "Echkoun", "El Adraoui",
-      "El Alaoui", "El Amraoui", "El Amrani", "El Azzouzi",
-      "El Bachiri", "El Bakkali", "El Barkani", "El Bouhali",
-      "El Fadili", "El Fassi", "El Glaoui", "El Hachimi",
-      "El Idrissi", "El Kadiri", "El Khattabi", "El Malki",
-      "El Mansouri", "El Ouafi", "El Ouazzani", "El Yamani"
-    ].freeze
-
-    # Moroccan cities (all major and medium cities) - EXTENDED LIST
-    MOROCCAN_CITIES = [
-      "Casablanca", "Rabat", "Marrakech", "Fès", "Meknès", "Agadir", "Tanger",
-      "Oujda", "Kenitra", "Tétouan", "Safi", "Mohammedia", "El Jadida",
-      "Beni Mellal", "Khouribga", "Settat", "Larache", "Ksar El Kebir",
-      "Nador", "Berkane", "Errachidia", "Khemisset", "Ifrane", "Azrou",
-      "Chefchaouen", "Al Hoceima", "Taza", "Sidi Kacem", "El Kelaa",
-      "Ben Slimane", "Khémisset", "Sidi Bennour", "Youssoufia",
-      "Guelmim", "Taroudant", "Tinghir", "Zagora", "Sidi Ifni",
-      "Laâyoune", "Dakhla", "Boujdour", "Tan-Tan",
-      "Taourirt", "Ouarzazate", "Midelt", "Figuig", "Jerada",
-      "Sefrou", "Boulemane", "Taounate", "Guercif", "Imzouren",
-      "Fnideq", "Martil", "Saidia", "Ahfir", "Aklim",
-      "Tiznit", "Chtouka", "Ait Baha", "Biougra",
-      "Tata", "Foum Zguid", "Assa", "Zag",
-      "Smara", "Boukraa", "Bir Anzarane",
-      "Skhirat", "Temara", "Sale", "Skhirat",
-      "Bouskoura", "Mediouna", "Tit Mellil",
-      "Aïn Harrouda", "Harhoura", "Moulay Bousselham",
-      "Souk El Arbaa", "El Jadida", "Dar Bouazza",
-      "El Mansouria", "Bouskoura", "Mediouna",
-      "Nouaceur", "Berrechid", "Ben Ahmed",
-      "El Gara", "Bouknadel", "Skhirat", "Temara"
-    ].freeze
-
     # Moroccan phone prefixes
     MOROCCAN_PHONE_PREFIXES = %w[06 07].freeze
 
     class << self
+      # Generic helper methods
+      def pick(list)
+        list.sample
+      end
+
+      def random_number(min:, max:)
+        rand(min..max)
+      end
+
+      def random_code(format:)
+        format.gsub(/\d/) { rand(0..9) }.gsub(/[A-Z]/) { ('A'..'Z').to_a.sample }
+      end
+
+      def city_and_district
+        city = pick(DataLoader.cities)
+        districts = DataLoader.districts_by_city[city] || []
+        district = pick(districts)
+        [city, district]
+      end
+
+      # Core data generation methods
       def name
         "#{first_name} #{last_name}"
       end
 
-      def first_name
-        MOROCCAN_FIRST_NAMES.sample
+      def first_name(gender = nil)
+        pick(DataLoader.first_names(gender))
       end
 
       def last_name
-        MOROCCAN_LAST_NAMES.sample
+        pick(DataLoader.last_names)
       end
 
       def email(first_name: nil, last_name: nil)
-        first = first_name || self.first_name.downcase
-        last = last_name || self.last_name.downcase
+        first = (first_name || self.first_name).downcase
+        last = (last_name || self.last_name).downcase
         
         # Moroccan domains and common international domains used in Morocco
         domains = %w[
@@ -108,20 +51,20 @@ module Zayef
           inwi.ma iam.ma orange.ma
         ]
         
-        "#{first}.#{last}@#{domains.sample}"
+        "#{first}.#{last}@#{pick(domains)}"
       end
 
       def phone
-        prefix = MOROCCAN_PHONE_PREFIXES.sample
-        number = rand(10000000..99999999)
+        prefix = pick(MOROCCAN_PHONE_PREFIXES)
+        number = random_number(min: 10000000, max: 99999999)
         "#{prefix}#{number}"
       end
 
       def city
-        MOROCCAN_CITIES.sample
+        pick(DataLoader.cities)
       end
 
-      def address
+      def address(city: nil)
         # Authentic Moroccan street names
         streets = %w[
           Av. Hassan II Rue Mohammed V Bd. Zerktouni
@@ -133,266 +76,501 @@ module Zayef
           Rue Moulay Rachid Bd. Hassan I
           Rue Ahmed Chaouki Bd. Zerktouni
         ]
-        street = streets.sample
-        number = rand(1..500)
-        "#{number}, #{street}, #{city}"
+        street = pick(streets)
+        number = random_number(min: 1, max: 500)
+        city_name = city || self.city
+        "#{number}, #{street}, #{city_name}"
       end
 
       def cni_number
         # Moroccan CNI format: 2 letters + 6 digits (authentic format)
-        letters = ('A'..'Z').to_a.sample(2).join
-        numbers = rand(100000..999999)
-        "#{letters}#{numbers}"
+        random_code(format: 'AA######')
       end
 
       def bank_account
         # Moroccan bank account format (simplified)
-        "MA#{rand(100000000000000000..999999999999999999)}"
+        random_code(format: 'MA##################')
       end
 
       # Additional Moroccan-specific data generators
       
       def postal_code
         # Moroccan postal codes (5 digits)
-        rand(10000..99999).to_s
+        random_number(min: 10000, max: 99999).to_s
       end
 
-      def company_name
+      def company_name(city: nil)
         # Moroccan company name patterns
         prefixes = %w[Groupe Société Entreprise]
         suffixes = %w[Maroc Maghreb Atlas Rif]
         sectors = %w[Commerce Industrie Services Immobilier]
         
-        pattern = rand(3)
+        pattern = random_number(min: 0, max: 2)
         case pattern
         when 0
-          "#{prefixes.sample} #{suffixes.sample}"
+          "#{pick(prefixes)} #{pick(suffixes)}"
         when 1
-          "#{sectors.sample} #{city}"
+          "#{pick(sectors)} #{city || self.city}"
         else
-          "#{last_name} #{sectors.sample}"
+          "#{last_name} #{pick(sectors)}"
         end
       end
 
       def region
-        # Moroccan regions
-        regions = %w[
-          Casablanca-Settat Rabat-Salé-Kénitra
-          Fès-Meknès Marrakech-Safi
-          Tanger-Tétouan-Al Hoceïma
-          Oriental Béni Mellal-Khénifra
-          Drâa-Tafilalet Souss-Massa
-          Guelmim-Oued Noun Laâyoune-Sakia El Hamra
-          Dakhla-Oued Ed-Dahab
-        ]
-        regions.sample
+        pick(DataLoader.regions)
       end
 
       def university
-        # Moroccan universities
-        universities = %w[
-          "Université Mohammed V de Rabat" "Université Hassan II de Casablanca"
-          "Université Ibn Tofail de Kénitra" "Université Cadi Ayyad de Marrakech"
-          "Université Abdelmalek Essaâdi de Tanger" "Université Sidi Mohammed Ben Abdellah de Fès"
-          "Université Ibn Zohr d'Agadir" "Université Chouaib Doukkali d'El Jadida"
-          "Université Sultan Moulay Slimane de Beni Mellal" "Université Mohammed Premier d'Oujda"
-          "Université Hassan Ier de Settat" "École Polytechnique de l'Université Internationale de Rabat"
-        ]
-        universities.sample
+        pick(DataLoader.universities)
       end
 
       # Additional rich Moroccan data generators
 
       def neighborhood
-        # Famous Moroccan neighborhoods and districts
-        neighborhoods = %w[
-          Medina Gueliz Maarif Anfa Derb Sultan
-          Hay Hassani Sbata Lissasfa Ain Diab
-          Racine Bourgogne Palmier Californie
-          Ouasis Sidi Bernoussi Mers Sultan
-          Agdal Yacoub El Mansour Hassan
-          Souissi La Gironde El Oulfa
-          L'Hivernage Marjane Touarga
-          Massira Sidi Moumen Hay Mohammadi
-          Ben M'sick Sidi Othman El Harti
-          Tabriquet Les Princes Sidi Maârouf
-          Diour Jamaâ Hay El Hanaa
-          Errahma Hay El Farah
-        ]
-        neighborhoods.sample
+        pick(DataLoader.neighborhoods)
       end
 
       def medical_specialty
-        # Moroccan medical specialties (since it's DabaDoc)
-        specialties = %w[
-          Médecine générale Pédiatrie Cardiologie
-          Dermatologie Ophtalmologie ORL
-          Gynécologie Obstétrique Chirurgie générale
-          Médecine interne Psychiatrie Radiologie
-          Anesthésie-réanimation Néphrologie
-          Hépatologie Gastro-entérologie Endocrinologie
-          Rhumatologie Neurologie Urologie
-          Traumatologie Orthopédie Chirurgie plastique
-          Chirurgie vasculaire Médecine du travail
-          Médecine légale Médecine nucléaire
-          Médecine physique Oncologie
-        ]
-        specialties.sample
+        pick(DataLoader.medical_specialties)
       end
 
       def profession
-        # Common Moroccan professions
-        professions = %w[
-          Médecin Ingénieur Enseignant
-          Avocat Notaire Architecte
-          Pharmacien Commerçant Artisan
-          Agriculteur Fonctionnaire Journaliste
-          Banquier Comptable Informaticien
-          Électricien Plombier Menuisier
-          Coiffeur Serveur Chauffeur
-          Garde-malade Secrétaire Traducteur
-          Guide touristique Vendeur
-        ]
-        professions.sample
+        pick(DataLoader.professions)
       end
 
       def traditional_dish
-        # Famous Moroccan traditional dishes
-        dishes = %w[
-          Couscous Tagine Pastilla Harira
-          Rfissa Tanjia Mechoui Briouates
-          Msemen Meloui Baghrir Khobz
-          Bissara Lentilles aux merguez
-          Khlia Merguez Sardines grillées
-          Daqous aux olives Kefta aux œufs
-          Poulet aux citrons confits
-          Tajine aux pruneaux Tajine aux abricots
-          Chorba frik Soupe de poisson
-          Maâqouda Zaalouk
-        ]
-        dishes.sample
+        pick(DataLoader.traditional_dishes)
       end
 
       def spice
-        # Moroccan spices and ingredients
-        spices = %w[
-          Ras-el-hanout Safran Cannelle
-          Curcuma Gingembre Paprika
-          Cumin Coriandre Cardamome
-          Muscade Poivre noir Piment
-          Fenouil Anis étoilé Clous de girofle
-          Laurier Citron confit Olives
-          Amandes Pistaches Noix
-          Miel d'oranger Fleur d'oranger
-          Huile d'argan Beurre clarifié
-        ]
-        spices.sample
+        pick(DataLoader.spices)
       end
 
       def souk
-        # Famous Moroccan markets/souks
-        souks = %w[
-          Souk Semmarine Souk El Kébir Souk El Attarine
-          Souk Zitoun El Jdid Souk El Hadadine
-          Souk El Bahia Souk Smarine Souk El Ghezel
-          Souk El Koutoubine Souk El Abid
-          Souk Sebbaghine Souk Cherratine
-          Souk Nejjarine Marché Central
-          Souk Al Fassia Souk El Joutia
-        ]
-        souks.sample
+        pick(DataLoader.souks)
       end
 
       def bank
-        # Moroccan banks
-        banks = %w[
-          "Attijariwafa Bank" "Banque Centrale Populaire"
-          "BMCI" "Banque Marocaine pour le Commerce et l'Industrie"
-          "Société Générale Maroc" "Crédit du Maroc"
-          "Banque Marocaine du Commerce Extérieur" "CIH Bank"
-          "Crédit Immobilier et Hôtelier" "Al Barid Bank"
-          "Bank Al Maghrib" "CFG Bank"
-          "Crédit Agricole du Maroc" "Umnia Bank"
-        ]
-        banks.sample
+        pick(DataLoader.banks)
       end
 
       def restaurant
-        # Moroccan restaurant/café names
-        restaurants = %w[
-          "Café Clock" "Nomad" "Le Jardin"
-          "Café Bousafsaf" "Dar Moha" "Al Fassia"
-          "Café de France" "Le Jardin d'Essai"
-          "Café Hafa" "Nomad Café" "Dar Essalam"
-          "Café Central" "Le Jardin Secret"
-          "Café Arabe" "Dar El Hana"
-        ]
-        restaurants.sample
+        pick(DataLoader.restaurants)
       end
 
       def hotel
-        # Moroccan hotels/riads
-        hotels = %w[
-          "Riad Kniza" "Palmeraie Palace"
-          "Hotel Sahrai" "Riad Al Fassia"
-          "Hotel El Andalous" "Riad El Cadi"
-          "Hotel Atlas Medina" "Riad Dar Anika"
-          "Hotel Nomade" "Riad Zitouna"
-          "Hotel Al Fassia" "Riad Les Jardin"
-        ]
-        hotels.sample
+        pick(DataLoader.hotels)
       end
 
       def mosque
-        # Famous Moroccan mosques
-        mosques = %w[
-          "Mosquée Hassan II" "Mosquée Koutoubia"
-          "Mosquée Al Quaraouiyine" "Mosquée Bahia"
-          "Mosquée Saadian" "Mosquée Moulay Idriss"
-          "Mosquée El Badi" "Mosquée Lalla Aouda"
-          "Mosquée Tin Mal" "Mosquée Nejjarine"
-          "Mosquée Cherratine" "Mosquée El Glaoui"
-        ]
-        mosques.sample
+        pick(DataLoader.mosques)
       end
 
       def school
-        # Moroccan schools and educational institutions
-        schools = %w[
-          "Lycée Descartes" "Lycée Lyautey"
-          "Lycée Moulay Youssef" "Lycée Mohammed V"
-          "École Américaine" "Lycée Français"
-          "École Mission La Sallle" "Lycée Victor Hugo"
-          "École Sainte Marie" "Lycée Ibn Khaldoun"
-          "École Al Khansaa" "Lycée Ibn Sina"
-        ]
-        schools.sample
+        pick(DataLoader.schools)
       end
 
       def newspaper
-        # Moroccan newspapers and media
-        newspapers = %w[
-          "Le Matin" "L'Économiste"
-          "Libération" "Aujourd'hui le Maroc"
-          "Al Alam" "Assabah"
-          "Bayane Al Yaoum" "Al Akhbar"
-          "Al Massae" "Al Ahdath Al Maghribia"
-          "Al Ittihad Al Ichtiraki" "Rissalat Al Oumma"
-        ]
-        newspapers.sample
+        pick(DataLoader.newspapers)
       end
 
       def festival
-        # Moroccan festivals and cultural events
-        festivals = %w[
-          "Festival de Marrakech" "Festival de Fès"
-          "Festival de Tan-Tan" "Festival de Rabat"
-          "Festival Mawazine" "Festival Jazzablanca"
-          "Festival de Taroudant" "Festival de Meknès"
-          "Festival de Ouarzazate" "Festival de Tanger"
-          "Festival de Chefchaouen" "Festival de Asilah"
+        pick(DataLoader.festivals)
+      end
+
+      # NEW: Personal Data Generators with parameterization
+      
+      def age(min: 18, max: 80)
+        # Generate realistic ages for different contexts
+        random_number(min: min, max: max)
+      end
+
+      def birth_date(min_age: 18, max_age: 80)
+        # Generate birth date (18-80 years ago)
+        years_ago = random_number(min: min_age, max: max_age)
+        days_ago = random_number(min: 0, max: 365)
+        Date.today - (years_ago * 365 + days_ago)
+      end
+
+      def gender
+        # Moroccan gender distribution
+        pick(%w[Male Female])
+      end
+
+      def marital_status
+        pick(DataLoader.marital_statuses)
+      end
+
+      def blood_type
+        pick(DataLoader.blood_types)
+      end
+
+      def height(min: 150, max: 190)
+        # Height in cm (realistic for Moroccan population)
+        random_number(min: min, max: max)
+      end
+
+      def weight(min: 50, max: 100)
+        # Weight in kg (realistic for Moroccan population)
+        random_number(min: min, max: max)
+      end
+
+      def eye_color
+        pick(DataLoader.eye_colors)
+      end
+
+      def hair_color
+        pick(DataLoader.hair_colors)
+      end
+
+      def religion
+        pick(DataLoader.religions)
+      end
+
+      def nationality
+        # Use weighted sampling for realistic nationality distribution
+        weighted_pick(DataLoader.nationality_weights)
+      end
+
+      def language
+        pick(DataLoader.languages)
+      end
+
+      def education_level
+        pick(DataLoader.education_levels)
+      end
+
+      def income_range
+        pick(DataLoader.income_ranges)
+      end
+
+      # NEW: Business and Professional Data
+      
+      def company_size
+        pick(DataLoader.company_sizes)
+      end
+
+      def industry
+        pick(DataLoader.industries)
+      end
+
+      def job_title
+        pick(DataLoader.job_titles)
+      end
+
+      def work_experience
+        # Years of work experience
+        random_number(min: 0, max: 40)
+      end
+
+      def salary
+        # Monthly salary in MAD
+        random_number(min: 3000, max: 50000)
+      end
+
+      def work_schedule
+        pick(DataLoader.work_schedules)
+      end
+
+      def business_type
+        pick(DataLoader.business_types)
+      end
+
+      def tax_id
+        # Moroccan tax identification number
+        random_code(format: 'RC######')
+      end
+
+      def trade_register
+        # Trade register number
+        random_code(format: 'TR######')
+      end
+
+      # NEW: Cultural and Lifestyle Data
+      
+      def hobby
+        pick(DataLoader.hobbies)
+      end
+
+      def sport
+        pick(DataLoader.sports)
+      end
+
+      def music_genre
+        pick(DataLoader.music_genres)
+      end
+
+      def movie_genre
+        pick(DataLoader.movie_genres)
+      end
+
+      def social_media
+        pick(DataLoader.social_media)
+      end
+
+      def transportation
+        pick(DataLoader.transportation)
+      end
+
+      def pet
+        pick(DataLoader.pets)
+      end
+
+      def favorite_color
+        pick(DataLoader.colors)
+      end
+
+      # NEW: Geographic and Location Data
+      
+      def province
+        pick(DataLoader.provinces)
+      end      
+
+      def district(city: nil)
+        # Moroccan districts / prefectural arrondissements
+        districts_by_city = DataLoader.districts_by_city
+      
+        if city && districts_by_city[city]
+          pick(districts_by_city[city])
+        else
+          pick(districts_by_city.values.flatten)
+        end
+      end      
+
+      def landmark
+        pick(DataLoader.landmarks)
+      end      
+
+      def climate
+        # Climate types in Morocco
+        climates = [
+          "Méditerranéen", "Atlantique", "Continental", "Désertique", 
+          "Montagnard", "Semi-aride", "Tropical"
         ]
-        festivals.sample
+        pick(climates)
+      end
+
+      def timezone
+        # Moroccan timezone
+        "GMT+1"
+      end
+
+      def currency
+        # Moroccan currency
+        "MAD (Dirham Marocain)"
+      end
+
+      # NEW: Utility Methods and Helper Functions
+      
+      def profile(age_min: 18, age_max: 80, city: nil, gender: nil)
+        # Generate a complete Moroccan person profile with consistency
+        city_name, district = city ? [city, district(city: city)] : city_and_district
+        person_gender = gender || self.gender
+        person_age = age(min: age_min, max: age_max)
+        first = first_name(person_gender)
+        last = last_name
+        
+        {
+          name: "#{first} #{last}",
+          first_name: first,
+          last_name: last,
+          age: person_age,
+          gender: person_gender,
+          email: email(first_name: first, last_name: last),
+          phone: phone,
+          address: address(city: city_name),
+          city: city_name,
+          district: district,
+          region: region,
+          postal_code: postal_code,
+          cni_number: cni_number,
+          birth_date: birth_date(min_age: age_min, max_age: age_max),
+          marital_status: marital_status,
+          profession: profession,
+          company_name: company_name(city: city_name),
+          education_level: education_level,
+          income_range: income_range,
+          blood_type: blood_type,
+          height: height,
+          weight: weight,
+          eye_color: eye_color,
+          hair_color: hair_color,
+          religion: religion,
+          nationality: nationality,
+          language: language,
+          hobby: hobby,
+          sport: sport,
+          favorite_color: favorite_color,
+          transportation: transportation,
+          pet: pet
+        }
+      end
+
+      def business_profile(city: nil)
+        # Generate a complete business profile with consistency
+        city_name = city || self.city
+        company = company_name(city: city_name)
+        
+        {
+          company_name: company,
+          industry: industry,
+          company_size: company_size,
+          business_type: business_type,
+          tax_id: tax_id,
+          trade_register: trade_register,
+          address: address(city: city_name),
+          city: city_name,
+          region: region,
+          postal_code: postal_code,
+          phone: phone,
+          email: email,
+          bank: bank,
+          bank_account: bank_account
+        }
+      end
+
+      def medical_profile(age_min: 18, age_max: 80, city: nil)
+        # Generate a medical profile (perfect for DabaDoc) with consistency
+        city_name = city || self.city
+        patient_name = name
+        patient_age = age(min: age_min, max: age_max)
+        
+        {
+          patient_name: patient_name,
+          age: patient_age,
+          gender: gender,
+          blood_type: blood_type,
+          height: height,
+          weight: weight,
+          phone: phone,
+          email: email,
+          address: address(city: city_name),
+          city: city_name,
+          region: region,
+          postal_code: postal_code,
+          emergency_contact: patient_name,
+          emergency_phone: phone,
+          medical_specialty: medical_specialty,
+          doctor_name: patient_name,
+          clinic_address: address(city: city_name),
+          insurance_company: bank,
+          insurance_number: bank_account
+        }
+      end
+
+      def cultural_profile(city: nil)
+        # Generate a cultural profile with consistency
+        city_name = city || self.city
+        
+        {
+          name: name,
+          city: city_name,
+          region: region,
+          university: university,
+          neighborhood: neighborhood,
+          traditional_dish: traditional_dish,
+          spice: spice,
+          souk: souk,
+          restaurant: restaurant,
+          hotel: hotel,
+          mosque: mosque,
+          school: school,
+          newspaper: newspaper,
+          festival: festival,
+          landmark: landmark,
+          music_genre: music_genre,
+          movie_genre: movie_genre,
+          hobby: hobby,
+          sport: sport,
+          social_media: social_media
+        }
+      end
+
+      def random_data(category = nil, **options)
+        # Generate random data from any category with options
+        category = 'personal' if category.nil? # Default to personal profiles
+        case category&.downcase
+        when 'personal'
+          profile(**options)
+        when 'business'
+          business_profile(**options)
+        when 'medical'
+          medical_profile(**options)
+        when 'cultural'
+          cultural_profile(**options)
+        else
+          # Return a random method result
+          methods = public_methods(false) - [:random_data, :profile, :business_profile, :medical_profile, :cultural_profile, :bulk_data, :export_to_json, :export_to_csv]
+          method_name = methods.sample
+          send(method_name)
+        end
+      end
+
+      def bulk_data(count = 10, category = nil, **options)
+        # Generate multiple records of data with consistent options
+        Array.new(count) { random_data(category, **options) }
+      end
+
+      # Additional utility methods for weighted sampling
+      def weighted_pick(weights_hash)
+        # Pick from a hash where keys are items and values are weights
+        total_weight = weights_hash.values.sum
+        random_value = random_number(min: 1, max: total_weight)
+        
+        current_weight = 0
+        weights_hash.each do |item, weight|
+          current_weight += weight
+          return item if random_value <= current_weight
+        end
+        
+        weights_hash.keys.last
+      end
+
+
+      def export_to_json(count = 10, category = nil, **options)
+        # Export data to JSON format with options
+        require 'json'
+        bulk_data(count, category, **options).to_json
+      end
+
+      def export_to_csv(count = 10, category = nil, **options)
+        # Export data to CSV format with options
+        require 'csv'
+        data = bulk_data(count, category, **options)
+        return "" if data.empty?
+
+        headers = data.first.keys
+        CSV.generate do |csv|
+          csv << headers
+          data.each { |row| csv << headers.map { |header| row[header] } }
+        end
+      end
+
+      # Streaming methods for large datasets
+      def stream_json(count = 1000, category = nil, **options, &block)
+        # Stream JSON data for large datasets without loading all in memory
+        require 'json'
+        yield "["
+        count.times do |i|
+          yield "," if i > 0
+          yield random_data(category, **options).to_json
+        end
+        yield "]"
+      end
+
+      def stream_csv(count = 1000, category = nil, **options, &block)
+        # Stream CSV data for large datasets
+        require 'csv'
+        first_record = random_data(category, **options)
+        headers = first_record.keys
+        
+        yield CSV.generate_line(headers)
+        yield CSV.generate_line(headers.map { |header| first_record[header] })
+        
+        (count - 1).times do
+          record = random_data(category, **options)
+          yield CSV.generate_line(headers.map { |header| record[header] })
+        end
       end
     end
   end