From c25a38346202df5774c5cdbcc3bc235fcaad9e4b Mon Sep 17 00:00:00 2001 From: Hermes Agent Date: Fri, 10 Apr 2026 15:30:15 +0200 Subject: [PATCH] docs: add next development proposal to README --- README.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/README.md b/README.md index d76e478..4597b18 100644 --- a/README.md +++ b/README.md @@ -84,3 +84,28 @@ $faker->text(20, 3, 10); // Sedev emeze evekem ez denebebekepep... ``` + +## Suggested next development + +A high-impact next step would be introducing a provider-based architecture with locale dictionaries. + +Why this is useful: +- easier to extend (e.g. company names, product names, job titles, UUIDs, IBAN, VAT IDs) +- locale support becomes clean and explicit (`en`, `hu`, `de`, etc.) +- avoids bloating the core `Faker` class with many domain-specific methods + +Proposed API direction: + +```php +$faker = Faker::init(['locale' => 'hu']); + +$faker->person()->fullName(); +$faker->company()->name(); +$faker->internet()->email(); +$faker->finance()->iban('HU'); +``` + +Implementation notes: +- keep current methods for backward compatibility +- add providers incrementally (`PersonProvider`, `CompanyProvider`, `InternetProvider`, `FinanceProvider`) +- add deterministic generation via optional seed support for repeatable tests