Mykad Laravel Package

Product Decisions This Supports

• Regulatory Compliance: Enables strict validation of Malaysian MyKad numbers for government-mandated identity verification (e.g., KYC, age verification, or state-based services).
• Data Integrity: Reduces errors in user input by parsing/validating MyKad formats (e.g., 990101-01-1234 → 990101011234), improving downstream system reliability.
• Localization: Supports state/city extraction (e.g., 01 → "Johor") for region-specific features (e.g., targeted marketing, regional policies).
• Roadmap Efficiency: Avoids reinventing validation logic, accelerating development for Malaysian-focused products (e.g., fintech, healthcare, or e-commerce).
• Build vs. Buy: Justifies outsourcing validation logic to a maintained package (MIT license) over custom code, especially for non-core features.
• Use Cases:
  • Authentication: Validate MyKad during user registration/login.
  • Age/Gender Checks: Extract birthdates/genders (encoded in MyKad) for age-restricted services (e.g., alcohol sales, voting).
  • Form Validation: Integrate with Laravel’s FormRequest for real-time MyKad validation.
  • Data Migration: Cleanse existing MyKad datasets (e.g., normalize formats for analytics).

When to Consider This Package

• Adopt if:
  • Your product serves Malaysian users and requires MyKad validation/parsing (e.g., government services, local e-commerce).
  • You need state/city extraction from MyKad numbers for regional logic.
  • Your team lacks expertise in MyKad’s Luhn algorithm or format rules (e.g., 990101-01-1234 vs. 990101011234).
  • You prioritize maintainability over custom solutions (package is actively updated, MIT-licensed).
• Look elsewhere if:
  • Your use case is global (package is Malaysia-specific).
  • You need advanced features (e.g., biometric verification, MyKad e-services integration).
  • The package’s low adoption (0 stars, 2.6 score) raises concerns about long-term support (mitigate by vetting the maintainer’s responsiveness).
  • Your stack isn’t Laravel/PHP (though the logic could be adapted).

How to Pitch It (Stakeholders)

Executives: "This lightweight Laravel package solves a critical pain point for our Malaysian market: accurate, compliant MyKad validation—without building custom logic. It’s a drop-in solution for KYC, age verification, or regional targeting, reducing errors and development time. With an MIT license and active updates, it’s a low-risk way to ensure data integrity while focusing resources on core features."

Engineering: *"The fikrimastor/mykad package handles MyKad validation, parsing, and state extraction in ~50 lines of code (vs. hours of custom work). Key benefits:

• Validation: Checks Luhn algorithm + format (e.g., rejects 123456789012).
• Parsing: Extracts birthdate, gender, and state (e.g., 990101-01-1234 → 1999-01-01, Male, Johor).
• Integration: Works with Laravel’s Validator or FormRequest (e.g., Rule::mykad()).
• Configurable: Publishable config for state codes (customizable for future needs). Tradeoff: Low community traction (0 stars), but the code is simple to audit/replace if needed. Recommend a trial in one feature (e.g., user registration) before full adoption."*

Legal/Compliance: *"This package aligns with Malaysian regulatory requirements for MyKad validation, including:

• Format compliance (e.g., rejecting invalid Luhn checks).
• State extraction (useful for regional policies). Risk: No active community, but the MIT license and open code allow us to verify logic. Suggest pairing with a custom audit of the validation rules."*