Obelawium Module Development Skill (ium-developmint)

An AI agent and developer skill for architecting, scaffolding, building, testing, and maintaining headless domain modules within the Obelawium (IUM) ERP ecosystem (obelaw/ium).

Key Capabilities

• Fluent Gateway DSL: Unified domain entry and orchestration via ium()->[domain]()->[service]()->[method]().
• Core Engine Primitives: Detailed coverage of ObelawiumManager, Domain, ObelawConfigManager, GlobalConfigManager, IumConfigEnum, BaseDto, ModelBase, and MigrationBase.
• Automated Module Scaffolding: Turnkey PowerShell scaffolding script (scripts/scaffold-module.ps1) that generates a complete, test-ready module skeleton in seconds.
• Persistence & Multi-Tenancy Isolation: Automatic ium_<slug>_ table prefixing and dynamic database connection routing (obelawium.db.connection).
• Strict Domain Boundaries: Headless business engine architecture, immutable DTO contracts, DB::transaction() atomicity, polymorphic cross-domain references, and Anti-Corruption Layer (ACL) event ingestion.
• Orchestra Testbench & PestPHP Setup: Ready-to-use testing templates for isolated in-memory SQLite verification.

Quick Example

use Obelaw\Ium\Crm\Data\CreateLeadDto;

// 1. Check domain registration
if (ium()->hasDomain('crm')) {
    // 2. Execute domain mutation via fluent DSL
    $lead = ium()->crm()->leads()->create(CreateLeadDto::from([
        'code'     => 'LEAD-2026-001',
        'name'     => 'Acme Corporation',
        'actor_id' => 'user-01',
    ]));

    // 3. Query domain service
    $activeLeads = ium()->crm()->leads()->list();
}

Fast Scaffolding

Generate a complete, compliant module skeleton using the bundled script:

powershell -ExecutionPolicy Bypass -File scripts/scaffold-module.ps1 -Slug crm -ModuleName Crm -Entity Lead -BasePath packages

References & Documentation

License

Licensed under the MIT License.